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. 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 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: