CreateLocationHdfs - AWS DataSync

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 per AuthenticationType.

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 il krb5.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 per AuthenticationType.

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 per AuthenticationType.

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 di RpcProtection e DataTransferProtection sarà PRIVACY. Se si imposta RpcProtection o DataTransferProtection, 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 per AuthenticationType.

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: