CreateLocationHdfs - AWS DataSync
Sintassi della richiestaParametri della richiestaSintassi della rispostaElementi di rispostaErroriVedi anche

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

CreateLocationHdfs

Crea un file di sistema distribuito Hadoop (HDFS).

Sintassi della richiesta

{
   "AgentArns": [ "string" ],
   "AuthenticationType": "string",
   "BlockSize": number,
   "KerberosKeytab": blob,
   "KerberosKrb5Conf": blob,
   "KerberosPrincipal": "string",
   "KmsKeyProviderUri": "string",
   "NameNodes": [ 
      { 
         "Hostname": "string",
         "Port": number
      }
   ],
   "QopConfiguration": { 
      "DataTransferProtection": "string",
      "RpcProtection": "string"
   },
   "ReplicationFactor": number,
   "SimpleUser": "string",
   "Subdirectory": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}

Parametri della richiesta

Per informazioni sui parametri comuni a tutte le azioni, vedere Parametri comuni.

La richiesta accetta i seguenti dati in formato JSON.

AgentArns

I nomi della risorsa Amazon (ARN) degli agenti utilizzati per connettersi al cluster HDFS.

Tipo: matrice di stringhe

Membri dell’array: numero minimo di 1 elemento. Numero massimo di 4 4 4 elementi.

Limitazioni di lunghezza: lunghezza massima di 128.

Pattern: ^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:agent/agent-[0-9a-z]{17}$

Campo obbligatorio: sì

AuthenticationType

Il tipo di autenticazione utilizzato per determinare l'identità dell'utente.

Tipo: String

Valori validi: SIMPLE | KERBEROS

Campo obbligatorio: sì

BlockSize

La dimensione dei blocchi di dati da scrivere nel cluster HDFS. La dimensione del blocco deve essere un multiplo di 512 byte. La dimensione predefinita del blocco è 128 mebibyte (MiB).

Tipo: integer

Intervallo valido: valore minimo di 1048576. Valore massimo pari a 1073741824.

Required: No

KerberosKeytab

La tabella delle chiavi Kerberos (keytab) che contiene le mappature tra il principali Kerberos definiti e le chiavi crittografate. È possibile caricare il keytab da un file fornendo l'indirizzo del file. Se stai usando ilAWS CLI, esegue la codifica base64 per te. In caso contrario, fornisci il testo con codifica base64.

Nota

Questo parametro è obbligatorio se KERBEROS viene specificato per AuthenticationType.

Tipo: oggetto dati binari con codifica Base64

Limitazioni di lunghezza: lunghezza massimo di 65536.

Required: No

KerberosKrb5Conf

Il file krb5.conf che contiene le informazioni di configurazione di Kerberos. È possibile caricare il krb5.conf file fornendo l'indirizzo del file. Se stai usando ilAWS CLI, esegue la codifica base64 per te. In caso contrario, fornisci il testo con codifica base64.

Nota

Questo parametro è obbligatorio se KERBEROS viene specificato per AuthenticationType.

Tipo: oggetto dati binari con codifica Base64

Limitazioni di lunghezza: lunghezza massimo di 131072.

Required: No

KerberosPrincipal

Il principale Kerberos con accesso ai file e alle cartelle sul cluster HDFS.

Nota

Questo parametro è obbligatorio se KERBEROS viene specificato per AuthenticationType.

Tipo: String

Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 256 caratteri.

Modello: ^.+$

Required: No

KmsKeyProviderUri

L'URI del Key Management Server (KMS) del cluster HDFS.

Tipo: String

Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 255.

Modello: ^kms:\/\/http[s]?@(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9])(;(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9]))*:[0-9]{1,5}\/kms$

Required: No

NameNodes

Questa proprietà gestisce NameNode lo spazio dei nomi HDFS. NameNodeEsegue diverse operazioni come l'apertura, la chiusura e la ridenominazione di file e directory. NameNodeContiene le informazioni per mappare blocchi di dati suDataNodes. Puoi usarne solo unoNameNode.

Tipo: matrice di oggetti HdfsNameNode

Membri dell’array: numero minimo di 1 elemento.

Campo obbligatorio: sì

QopConfiguration

La configurazione QOP (Quality of Protection) specifica le impostazioni di protezione per le chiamate di procedura remota (RPC, Remote Procedure Call) e per il trasferimento dati configurate nel cluster del file system distribuito Hadoop (HDFS). Se non si specifica QopConfiguration, il valore predefinito di RpcProtection e DataTransferProtection sarà PRIVACY. Se si imposta RpcProtection o DataTransferProtection, l'altro parametro assume lo stesso valore.

Tipo: QopConfiguration oggetto

Required: No

ReplicationFactor

Il numero di DataNodes su cui replicare i dati durante la scrittura nel cluster HDFS. Per impostazione predefinita, i dati vengono replicati su treDataNodes.

Tipo: integer

Intervallo valido: valore minimo di 1. Valore massimo pari a 512.

Required: No

SimpleUser

Il nome utente utilizzato per identificare il client sul sistema operativo host.

Nota

Questo parametro è obbligatorio se SIMPLE viene specificato per AuthenticationType.

Tipo: String

Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 256 caratteri.

Modello: ^[_.A-Za-z0-9][-_.A-Za-z0-9]*$

Required: No

Subdirectory

Una sottodirectory nel cluster HDFS. Questa sottodirectory viene utilizzata per leggere i dati da o scrivere i dati sul cluster HDFS. Se la sottodirectory non viene specificata, il valore predefinito sarà impostato su /.

Tipo: String

Limitazioni di lunghezza: lunghezza massimo di 4096.

Modello: ^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$

Required: No

Tags

La coppia chiave-valore che rappresenta il tag che si desidera aggiungere alla posizione. Il valore può essere una stringa vuota. Si consiglia di utilizzare tag per assegnare un nome alle risorse.

Tipo: matrice di oggetti TagListEntry

Membri dell'array: numero minimo di 0 elementi. Numero massimo di 50 item.

Required: No

Sintassi della risposta

{
   "LocationArn": "string"
}

Elementi di risposta

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

LocationArn

L'ARN dell'ubicazione del cluster HDFS di origine che è stato creato.

Tipo: String

Limitazioni di lunghezza: lunghezza massima di 128.

Pattern: ^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:location/loc-[0-9a-z]{17}$

Errori

Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.

InternalException

Questa eccezione viene generata quando si verifica un errore nel AWS DataSync servizio.

Codice di stato HTTP: 500

InvalidRequestException

Questa eccezione viene generata quando il client invia una richiesta non valida.

Codice di stato HTTP: 400

Vedi anche

Per ulteriori informazioni sull'utilizzo di questa API in uno degli SDK AWS specifici della lingua, consulta quanto segue: