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
<a name="API_CreateLocationHdfs"></a>

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.](https://docs.aws.amazon.com/datasync/latest/userguide/create-hdfs-location.html#accessing-hdfs)

## Sintassi della richiesta
<a name="API_CreateLocationHdfs_RequestSyntax"></a>

```
{
   "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
<a name="API_CreateLocationHdfs_RequestParameters"></a>

Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

La richiesta accetta i seguenti dati in formato JSON.

 ** [AgentArns](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-AgentArns"></a>
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](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-AuthenticationType"></a>
Il tipo di autenticazione utilizzato per determinare l'identità dell'utente.   
Tipo: String  
Valori validi: `SIMPLE | KERBEROS`   
Obbligatorio: sì

 ** [BlockSize](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-BlockSize"></a>
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](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-CmkSecretConfig"></a>
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](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#service-secret-custom-key) un codice personalizzato. AWS KMS key  
È possibile utilizzare `CmkSecretConfig` (con`KerberosKeytab`) o `CustomSecretConfig` (senza`KerberosKeytab`) per fornire le credenziali per una richiesta. `CreateLocationHdfs` Non fornire entrambi i parametri per la stessa richiesta.
Tipo: oggetto [CmkSecretConfig](API_CmkSecretConfig.md)  
Obbligatorio: no

 ** [CustomSecretConfig](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-CustomSecretConfig"></a>
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](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#custom-secret-custom-key).  
Puoi utilizzare `CmkSecretConfig` (con`KerberosKeytab`) o `CustomSecretConfig` (senza`KerberosKeytab`) per fornire le credenziali per una `CreateLocationHdfs` richiesta. Non fornire entrambi i parametri per la stessa richiesta.
Tipo: oggetto [CustomSecretConfig](API_CustomSecretConfig.md)  
Obbligatorio: no

 ** [KerberosKeytab](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-KerberosKeytab"></a>
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.  
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](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-KerberosKrb5Conf"></a>
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.   
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](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-KerberosPrincipal"></a>
Il principale Kerberos con accesso ai file e alle cartelle sul cluster HDFS.   
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](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-KmsKeyProviderUri"></a>
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](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-NameNodes"></a>
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](API_HdfsNameNode.md)  
Membri dell’array: numero minimo di 1 elemento.  
Obbligatorio: sì

 ** [QopConfiguration](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-QopConfiguration"></a>
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](API_QopConfiguration.md)  
Obbligatorio: no

 ** [ReplicationFactor](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-ReplicationFactor"></a>
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](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-SimpleUser"></a>
Il nome utente utilizzato per identificare il client sul sistema operativo host.   
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](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-Subdirectory"></a>
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](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-Tags"></a>
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](API_TagListEntry.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 50 item.  
Obbligatorio: no

## Sintassi della risposta
<a name="API_CreateLocationHdfs_ResponseSyntax"></a>

```
{
   "LocationArn": "string"
}
```

## Elementi di risposta
<a name="API_CreateLocationHdfs_ResponseElements"></a>

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

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

 ** [LocationArn](#API_CreateLocationHdfs_ResponseSyntax) **   <a name="DataSync-CreateLocationHdfs-response-LocationArn"></a>
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
<a name="API_CreateLocationHdfs_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** 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
<a name="API_CreateLocationHdfs_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationHdfs) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationHdfs) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationHdfs) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationHdfs) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationHdfs) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationHdfs) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationHdfs) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationHdfs) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationHdfs) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationHdfs)