CreateLocationHdfs - AWS DataSync

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

Cria um Hadoop Distributed File System (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 de solicitação

Para obter informações sobre os parâmetros que são comuns a 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 que são utilizados para 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}$

Obrigatório: 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

Faixa válida: valor mínimo de 1048576. Valor máximo de 1073741824.

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. Se você estiver usando oAWS CLI, ele executa a codificação base64 para você. Caso contrário, forneça 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 comprimento: comprimento 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 krb5.conf arquivo fornecendo o endereço do arquivo. Se você estiver usando oAWS CLI, ele executará a codificação base64 para você. Caso contrário, forneça 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 131072.

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 tamanho: tamanho mínimo 1. Tamanho 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 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. Apenas é possível utilizar umNameNode.

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êsDataNodes.

Tipo: inteiro

Faixa válida: 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 comprimento: comprimento máximo de 4096.

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 reenviará uma resposta HTTP 200.

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

LocationArn

O ARN do local de origem do cluster do HDFS que foi criado.

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 a todas as ações, consulteErros comuns.

InternalException

Essa exceção é lançada quando ocorre um erro no AWS DataSync serviço.

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 AWS SDKs específicos de linguagem, consulte o seguinte: