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, "CmkSecretConfig": { "KmsKeyArn": "string", "SecretArn": "string" }, "CustomSecretConfig": { "SecretAccessRoleArn": "string", "SecretArn": "string" }, "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: array di stringhe

Membri dell’array: numero minimo di 1 elemento. Numero massimo di 8 articoli.

Limitazioni di lunghezza: lunghezza massima di 128.

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

Obbligatorio: sì

AuthenticationType

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

Tipo: String

Valori validi: SIMPLE | KERBEROS

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: numero intero

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

Obbligatorio: no

CmkSecretConfig

Specifica le informazioni di configurazione per un segreto DataSync gestito, che include il keytab Kerberos DataSync utilizzato per accedere a una specifica posizione di archiviazione Hadoop Distributed File System (HDFS), con una posizione gestita dal cliente. AWS KMS key

Quando includi questo parametro come parte di una CreateLocationHdfs richiesta, fornisci solo l'ARN della chiave KMS. DataSync utilizza questa chiave KMS insieme a quella KerberosKeytab specificata per creare un segreto DataSync gestito per archiviare le credenziali di accesso alla posizione.

Assicurati di disporre DataSync dell'autorizzazione per accedere alla chiave KMS specificata. Per ulteriori informazioni, consulta Utilizzo di un segreto gestito dal servizio crittografato con un codice personalizzato. AWS KMS key

Nota

È possibile utilizzare CmkSecretConfig (conKerberosKeytab) o CustomSecretConfig (senzaKerberosKeytab) per fornire le credenziali per una richiesta. CreateLocationHdfs Non fornire entrambi i parametri per la stessa richiesta.

Tipo: oggetto CmkSecretConfig

Obbligatorio: no

CustomSecretConfig

Specifica le informazioni di configurazione per un segreto di Secrets Manager gestito dal cliente in cui il keytab Kerberos per la posizione di archiviazione HDFS è archiviato in formato binario, in Secrets Manager. Questa configurazione include l'ARN segreto e l'ARN per un ruolo IAM che fornisce l'accesso al segreto. Per ulteriori informazioni, consulta Usare un segreto che gestisci tu.

Nota

Puoi utilizzare CmkSecretConfig (conKerberosKeytab) o CustomSecretConfig (senzaKerberosKeytab) per fornire le credenziali per una CreateLocationHdfs richiesta. Non fornire entrambi i parametri per la stessa richiesta.

Tipo: oggetto CustomSecretConfig

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.

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.

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

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

Modello: ^.+$

Obbligatorio: 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$

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.

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

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: numero intero

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

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

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

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

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

Vincoli di lunghezza: lunghezza massima di 4096.

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

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.

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

Limitazioni di lunghezza: lunghezza massima di 128.

Modello: ^arn:(aws|aws-cn|aws-us-gov|aws-eusc|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: