CreateLocationHdfs - DataSync AWS
Sintaxe da SolicitaçãoParâmetros da solicitaçãoSintaxe da RespostaElementos de RespostaErrosConsulte Também

CreateLocationHdfs

Cria um local de transferência para um Sistema de Arquivos Distribuído do Hadoop (HDFS). O AWS DataSync pode usar esse local como origem ou destino para transferência de dados.

Antes de começar, certifique-se de entender como o DataSync acessa os clusters do HDFS.

Sintaxe da Solicitação

{
   "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"
      }
   ]
}

Parâmetros da solicitação

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

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

AgentArns

Os nomes de recursos da Amazon (ARNs) dos agentes do DataSync que podem se conectar ao cluster do HDFS.

Tipo: matriz de strings

Membros da matriz: número mínimo de 1 item. Número máximo de 4 itens.

Restrições de Tamanho: Tamanho máximo de 128.

Padrão: : ^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}$

Exigido: Sim

AuthenticationType

O tipo de autenticação usado para determinar a identidade do usuário.

Tipo: String

Valores Válidos: SIMPLE | KERBEROS

Obrigatório: Sim

BlockSize

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

KerberosKeytab

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.

nota

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

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.

nota

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

A entidade principal do Kerberos com acesso aos arquivos e pastas no cluster do HDFS.

nota

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

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

O NameNode que gerencia o namespace do HDFS. O NameNode realiza operações como abrir, fechar e renomear arquivos e diretórios. O NameNode contém as informações para mapear blocos de dados para os DataNodes. Apenas é possível utilizar um NameNode.

Tipo: Matriz de objetos HdfsNameNode

Membros da matriz: número mínimo de 1 item.

Obrigatório: Sim

QopConfiguration

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

Obrigatório: Não

ReplicationFactor

O número de DataNodes para os quais replicar os dados ao gravar no cluster do HDFS. Por padrão, dados são replicados em três DataNodes.

Tipo: inteiro

Intervalo válido: valor mínimo de 1. Valor máximo de 512.

Obrigatório: Não

SimpleUser

O nome de usuário utilizado para identificar o cliente no sistema operacional host.

nota

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

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

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

Membros da Matriz: número mínimo de 0 itens. Número máximo de 50 itens.

Obrigatório: Não

Sintaxe da Resposta

{
   "LocationArn": "string"
}

Elementos de Resposta

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

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-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:location/loc-[0-9a-z]{17}$

Erros

Para obter informações sobre os erros comuns que todas as ações retornam, consulte Erros comuns.

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

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte: