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 una posizione di trasferimento per un Hadoop Distributed File System (HDFS). AWS DataSync può utilizzare questa posizione come origine o destinazione per il trasferimento di dati.
Prima di iniziare, assicurati di aver compreso come DataSync accede ai cluster 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 per tutte le azioni, consulta Parametri comuni.
La richiesta accetta i seguenti dati in formato JSON.
- AgentArns
-
Gli Amazon Resource Names (ARNs) degli DataSync agenti che possono connettersi al tuo cluster HDFS.
Tipo: matrice di stringhe
Membri dell’array: numero minimo di 1 elemento. Numero massimo di 4 articoli.
Limitazioni di lunghezza: lunghezza massima di 128.
Modello:
^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: stringa
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 di 1073741824.
Campo obbligatorio: 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.
Nota
Questo parametro è obbligatorio se
KERBEROS
viene specificato perAuthenticationType
.Tipo: oggetto dati binari con codifica Base64
Vincoli di lunghezza: lunghezza massima di 65536.
Campo obbligatorio: no
- KerberosKrb5Conf
-
Il file
krb5.conf
che contiene le informazioni di configurazione di Kerberos. È possibile caricare ilkrb5.conf
file fornendo l'indirizzo del file. Se stai usando AWS CLI, esegue la codifica base64 per te. Altrimenti, fornisci il testo con codifica base64.Nota
Questo parametro è obbligatorio se
KERBEROS
viene specificato perAuthenticationType
.Tipo: oggetto dati binari con codifica Base64
Vincoli di lunghezza: lunghezza massima di 131072.
Campo obbligatorio: no
- KerberosPrincipal
-
Il principale Kerberos con accesso ai file e alle cartelle sul cluster HDFS.
Nota
Questo parametro è obbligatorio se
KERBEROS
viene specificato perAuthenticationType
.Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.
Modello:
^.+$
Campo obbligatorio: no
- KmsKeyProviderUri
-
L'URI del Key Management Server (KMS) del cluster HDFS.
Tipo: stringa
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$
Campo obbligatorio: no
- NameNodes
-
Il NameNode che gestisce lo spazio dei nomi HDFS. NameNode Esegue operazioni come l'apertura, la chiusura e la ridenominazione di file e directory. NameNode Contiene le informazioni per mappare blocchi di dati su. DataNodes È possibile utilizzarne solo uno NameNode.
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 diRpcProtection
eDataTransferProtection
saràPRIVACY
. Se si impostaRpcProtection
oDataTransferProtection
, l'altro parametro assume lo stesso valore.Tipo: oggetto QopConfiguration
Campo obbligatorio: no
- ReplicationFactor
-
Il numero DataNodes su cui replicare i dati durante la scrittura sul cluster HDFS. Per impostazione predefinita, i dati vengono replicati fino a tre. DataNodes
Tipo: integer
Intervallo valido: valore minimo di 1. Valore massimo di 512.
Campo obbligatorio: no
- SimpleUser
-
Il nome utente utilizzato per identificare il client sul sistema operativo host.
Nota
Questo parametro è obbligatorio se
SIMPLE
viene specificato perAuthenticationType
.Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.
Modello:
^[_.A-Za-z0-9][-_.A-Za-z0-9]*$
Campo obbligatorio: 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: stringa
Vincoli di lunghezza: lunghezza massima di 4096.
Modello:
^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$
Campo obbligatorio: 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.
Campo obbligatorio: 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 della posizione del cluster HDFS di origine che crei.
Tipo: stringa
Limitazioni di lunghezza: lunghezza massima di 128.
Modello:
^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 servizio. AWS DataSync
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 una delle lingue AWS SDKs specifiche, consulta quanto segue: