

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

# DescribeLocationHdfs
<a name="API_DescribeLocationHdfs"></a>

Fornisce dettagli su come è configurata una posizione di AWS DataSync trasferimento per un Hadoop Distributed File System (HDFS).

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

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

## Parametri della richiesta
<a name="API_DescribeLocationHdfs_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.

 ** [LocationArn](#API_DescribeLocationHdfs_RequestSyntax) **   <a name="DataSync-DescribeLocationHdfs-request-LocationArn"></a>
Speciifica l'Amazon Resource Name (ARN) della posizione HDFS.  
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}$`   
Obbligatorio: sì

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

```
{
   "AgentArns": [ "string" ],
   "AuthenticationType": "string",
   "BlockSize": number,
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "CreationTime": number,
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "KerberosPrincipal": "string",
   "KmsKeyProviderUri": "string",
   "LocationArn": "string",
   "LocationUri": "string",
   "ManagedSecretConfig": { 
      "SecretArn": "string"
   },
   "NameNodes": [ 
      { 
         "Hostname": "string",
         "Port": number
      }
   ],
   "QopConfiguration": { 
      "DataTransferProtection": "string",
      "RpcProtection": "string"
   },
   "ReplicationFactor": number,
   "SimpleUser": "string"
}
```

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

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

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

 ** [AgentArns](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-AgentArns"></a>
Gli DataSync agenti che possono connettersi al tuo cluster HDFS. ARNs   
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}$` 

 ** [AuthenticationType](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-AuthenticationType"></a>
Il tipo di autenticazione utilizzato per determinare l'identità dell'utente.   
Tipo: String  
Valori validi: `SIMPLE | KERBEROS` 

 ** [BlockSize](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-BlockSize"></a>
La dimensione dei blocchi di dati da scrivere nel cluster HDFS.   
Tipo: numero intero  
Intervallo valido: valore minimo di 1048576. Valore massimo di 1073741824.

 ** [CmkSecretConfig](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-CmkSecretConfig"></a>
Descrive le informazioni di configurazione per un segreto DataSync gestito, ad esempio uno `KerberosKeytab` che DataSync consente di accedere a una posizione di archiviazione specifica, con un segreto gestito dal cliente. AWS KMS key  
Tipo: oggetto [CmkSecretConfig](API_CmkSecretConfig.md)

 ** [CreationTime](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-CreationTime"></a>
L'ora in cui è stata creata la posizione HDFS.  
Tipo: Timestamp

 ** [CustomSecretConfig](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-CustomSecretConfig"></a>
Descrive le informazioni di configurazione per un segreto gestito dal cliente, ad esempio un `KerberosKeytab` segreto DataSync utilizzato per accedere a una posizione di archiviazione specifica, con un ruolo gestito dal cliente AWS Identity and Access Management (IAM) che fornisce l'accesso al segreto.  
Tipo: oggetto [CustomSecretConfig](API_CustomSecretConfig.md)

 ** [KerberosPrincipal](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-KerberosPrincipal"></a>
Il principale Kerberos con accesso ai file e alle cartelle sul cluster HDFS. Questo parametro viene utilizzato se è definito come. `AuthenticationType` `KERBEROS`  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.  
Modello: `^.+$` 

 ** [KmsKeyProviderUri](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-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$` 

 ** [LocationArn](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-LocationArn"></a>
L'ARN della posizione HDFS.  
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}$` 

 ** [LocationUri](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-LocationUri"></a>
L'URI della posizione HDFS.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 4360.  
Modello: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` 

 ** [ManagedSecretConfig](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-ManagedSecretConfig"></a>
Descrive le informazioni di configurazione per un segreto DataSync gestito, ad esempio un segreto DataSync utilizzato per accedere a una `KerberosKeytab` posizione di archiviazione specifica. DataSync utilizza la chiave KMS AWS gestita di default per crittografare questo segreto. Gestione dei segreti AWS  
Tipo: oggetto [ManagedSecretConfig](API_ManagedSecretConfig.md)

 ** [NameNodes](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-NameNodes"></a>
Il NameNode che gestisce lo spazio dei nomi HDFS.   
Tipo: matrice di oggetti [HdfsNameNode](API_HdfsNameNode.md)  
Membri dell’array: numero minimo di 1 elemento.

 ** [QopConfiguration](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-QopConfiguration"></a>
La configurazione Quality of Protection (QOP), che specifica la Remote Procedure Call (RPC) e le impostazioni di protezione del trasferimento dati configurate sul cluster HDFS.   
Tipo: oggetto [QopConfiguration](API_QopConfiguration.md)

 ** [ReplicationFactor](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-ReplicationFactor"></a>
Il numero DataNodes su cui replicare i dati durante la scrittura sul cluster HDFS.   
Tipo: numero intero  
Intervallo valido: valore minimo di 1. Valore massimo di 512.

 ** [SimpleUser](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-SimpleUser"></a>
Il nome utente per identificare il client sul sistema operativo host. Questo parametro viene utilizzato se `AuthenticationType` è definito come`SIMPLE`.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.  
Modello: `^[_.A-Za-z0-9][-_.A-Za-z0-9]*$` 

## Errori
<a name="API_DescribeLocationHdfs_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 AWS DataSync servizio.  
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_DescribeLocationHdfs_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/DescribeLocationHdfs) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationHdfs) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationHdfs) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationHdfs) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationHdfs) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationHdfs) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationHdfs) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationHdfs) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationHdfs) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationHdfs) 