As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# CreateLocationHdfs
<a name="API_CreateLocationHdfs"></a>

Cria um *local* de transferência para um Hadoop Distributed File System (HDFS). AWS DataSync pode usar esse local como origem ou destino para transferir dados.

Antes de começar, certifique-se de entender como DataSync [acessa os clusters do HDFS](https://docs.aws.amazon.com/datasync/latest/userguide/create-hdfs-location.html#accessing-hdfs).

## Sintaxe da solicitação
<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"
      }
   ]
}
```

## Parâmetros da solicitação
<a name="API_CreateLocationHdfs_RequestParameters"></a>

Para obter informações sobre os parâmetros que são comuns em todas as ações, consulte [Parâmetros comuns](CommonParameters.md).

A solicitação aceita os dados a seguir no formato JSON.

 ** [AgentArns](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-AgentArns"></a>
Os nomes de recursos da Amazon (ARNs) dos DataSync agentes que podem se conectar ao seu cluster HDFS.  
Tipo: matriz de strings  
Membros da matriz: número mínimo de 1 item. Número máximo de 8 itens.  
Restrições de Tamanho: Tamanho máximo de 128.  
Padrão: `^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}$`   
Obrigatório: Sim

 ** [AuthenticationType](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-AuthenticationType"></a>
O tipo de autenticação usado para determinar a identidade do usuário.   
Tipo: string  
Valores válidos: `SIMPLE | KERBEROS`   
Obrigatório: Sim

 ** [BlockSize](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-BlockSize"></a>
O tamanho dos blocos de dados a serem gravados no cluster do HDFS. O tamanho deve ser um múltiplo de 512 bytes. O tamanho padrão do bloco é 128 mebibytes (MiB).  
Tipo: inteiro  
Intervalo válido: valor mínimo de 1.048.576. Valor máximo de 1.073.741.824  
Obrigatório: não

 ** [CmkSecretConfig](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-CmkSecretConfig"></a>
Especifica as informações de configuração de um segredo DataSync gerenciado, que inclui a tecla Kerberos DataSync usada para acessar um local de armazenamento específico do Hadoop Distributed File System (HDFS), com um local gerenciado pelo cliente. AWS KMS key  
Ao incluir esse parâmetro como parte de uma `CreateLocationHdfs` solicitação, você fornece somente o ARN da chave KMS. DataSync usa essa chave KMS junto com a `KerberosKeytab` que você especificou para criar um segredo DataSync gerenciado para armazenar as credenciais de acesso à localização.  
Verifique se ele DataSync tem permissão para acessar a chave KMS que você especificou. Para obter mais informações, consulte [Usando um segredo gerenciado pelo serviço criptografado com um personalizado](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#service-secret-custom-key). AWS KMS key  
Você pode usar `CmkSecretConfig` (com `KerberosKeytab`) ou `CustomSecretConfig` (sem `KerberosKeytab`) para fornecer credenciais para uma solicitação `CreateLocationHdfs`. Não forneça os dois parâmetros para a mesma solicitação.
Tipo: objeto [CmkSecretConfig](API_CmkSecretConfig.md)  
Obrigatório: não

 ** [CustomSecretConfig](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-CustomSecretConfig"></a>
Especifica as informações de configuração para um segredo do Secrets Manager gerenciado pelo cliente, em que a tecla Kerberos do local de armazenamento do HDFS é armazenada em binário, no Secrets Manager. Essa configuração inclui o ARN secreto e o ARN de um perfil do IAM que fornece acesso ao segredo. Para obter mais informações, consulte [Usando um segredo que você gerencia](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#custom-secret-custom-key).  
Você pode usar `CmkSecretConfig` (com `KerberosKeytab`) ou `CustomSecretConfig` (sem `KerberosKeytab`) para fornecer credenciais para uma solicitação `CreateLocationHdfs`. Não forneça os dois parâmetros para a mesma solicitação.
Tipo: objeto [CustomSecretConfig](API_CustomSecretConfig.md)  
Obrigatório: não

 ** [KerberosKeytab](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-KerberosKeytab"></a>
A tabela de chaves Kerberos (keytab) que contém mapeamentos entre a entidade principal Kerberos definida e as chaves criptografadas. Você pode carregar o keytab de um arquivo fornecendo o endereço do arquivo.  
Se `KERBEROS` for especificado para `AuthenticationType`, esse parâmetro será obrigatório. 
Tipo: objeto de dados binários codificado pelo Base64  
Restrições de tamanho: tamanho máximo de 65536.  
Obrigatório: não

 ** [KerberosKrb5Conf](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-KerberosKrb5Conf"></a>
O arquivo `krb5.conf` que contém as informações de configuração do Kerberos. Você pode carregar o arquivo `krb5.conf` fornecendo o endereço do arquivo. Se você estiver usando o AWS CLI, ele executa a codificação base64 para você. Caso contrário, você deve fornecer o texto codificado em base64.   
Se `KERBEROS` for especificado para `AuthenticationType`, esse parâmetro será obrigatório.
Tipo: objeto de dados binários codificado pelo Base64  
Restrições de tamanho: tamanho máximo de 131.072.  
Obrigatório: não

 ** [KerberosPrincipal](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-KerberosPrincipal"></a>
A entidade principal do Kerberos com acesso aos arquivos e pastas no cluster do HDFS.   
Se `KERBEROS` for especificado para `AuthenticationType`, esse parâmetro será obrigatório.
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 256.  
Padrão: `^.+$`   
Obrigatório: não

 ** [KmsKeyProviderUri](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-KmsKeyProviderUri"></a>
O URI do Key Management Server (KMS) do cluster do HDFS.   
Tipo: string  
Restrições de comprimento: tamanho mínimo de 1. Comprimento máximo de 255.  
Padrão: `^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$`   
Obrigatório: não

 ** [NameNodes](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-NameNodes"></a>
O NameNode que gerencia o namespace HDFS. O NameNode executa operações como abrir, fechar e renomear arquivos e diretórios. O NameNode contém as informações para mapear blocos de dados para DataNodes o. Você pode usar apenas um NameNode.  
Tipo: matriz de objetos [HdfsNameNode](API_HdfsNameNode.md)  
Membros da matriz: número mínimo de 1 item.  
Obrigatório: Sim

 ** [QopConfiguration](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-QopConfiguration"></a>
A configuração da Qualidade da Proteção (QOP) especifica as configurações de privacidade da Chamada de Procedimento Remoto (RPC) e das configurações de proteção de transferência de dados definidas no cluster do Hadoop Distributed File System (HDFS). Se `QopConfiguration` não for especificado, `RpcProtection` e `DataTransferProtection` assumirão `PRIVACY` como padrão. Se você definir `RpcProtection` ou `DataTransferProtection`, o outro parâmetro assumirá o mesmo valor.   
Tipo: objeto [QopConfiguration](API_QopConfiguration.md)  
Obrigatório: não

 ** [ReplicationFactor](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-ReplicationFactor"></a>
O número de DataNodes para os quais replicar os dados ao gravar no cluster HDFS. Por padrão, os dados são replicados para três DataNodes.  
Tipo: inteiro  
Intervalo válido: valor mínimo de 1. Valor máximo de 512.  
Obrigatório: não

 ** [SimpleUser](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-SimpleUser"></a>
O nome de usuário utilizado para identificar o cliente no sistema operacional host.   
Se `SIMPLE` for especificado para `AuthenticationType`, esse parâmetro será obrigatório. 
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 256.  
Padrão: `^[_.A-Za-z0-9][-_.A-Za-z0-9]*$`   
Obrigatório: não

 ** [Subdirectory](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-Subdirectory"></a>
Um subdiretório no cluster do HDFS. Esse subdiretório é utilizado para ler ou gravar dados no cluster do HDFS. Se o subdiretório não for especificado, o padrão será `/`.  
Tipo: string  
Restrições de tamanho: tamanho máximo de 4.096.  
Padrão: `^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$`   
Obrigatório: não

 ** [Tags](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-Tags"></a>
O par de chave-valor que representa a tag que você deseja adicionar ao local. O valor pode ser uma string vazia. Recomendamos usar tags para nomear os recursos.   
Tipo: matriz de objetos [TagListEntry](API_TagListEntry.md)  
Membros da Matriz: número mínimo de 0 itens. Número máximo de 50 itens.  
Obrigatório: Não

## Sintaxe da resposta
<a name="API_CreateLocationHdfs_ResponseSyntax"></a>

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

## Elementos de resposta
<a name="API_CreateLocationHdfs_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

 ** [LocationArn](#API_CreateLocationHdfs_ResponseSyntax) **   <a name="DataSync-CreateLocationHdfs-response-LocationArn"></a>
O ARN do local do cluster de origem do HDFS que você criou.  
Tipo: string  
Restrições de tamanho: tamanho máximo de 128.  
Padrão: `^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}$` 

## Erros
<a name="API_CreateLocationHdfs_Errors"></a>

Para obter informações sobre os erros comuns que todas as ações retornam, consulte [Erros comuns](CommonErrors.md).

 ** InternalException **   
Essa exceção é lançada quando ocorre um erro no serviço AWS DataSync .  
Código de status HTTP: 500

 ** InvalidRequestException **   
Essa exceção é lançada quando o cliente envia uma solicitação malformada.  
Código de Status HTTP: 400

## Consulte também
<a name="API_CreateLocationHdfs_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationHdfs) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationHdfs) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationHdfs) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationHdfs) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationHdfs) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationHdfs) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationHdfs) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationHdfs) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationHdfs) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationHdfs)