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 paraAuthenticationType
, 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 okrb5.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 paraAuthenticationType
, 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 paraAuthenticationType
, 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
eDataTransferProtection
assumirãoPRIVACY
como padrão. Se você definirRpcProtection
ouDataTransferProtection
, 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 paraAuthenticationType
, 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: