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á.
UpdateLocationHdfs
Modifica os seguintes parâmetros de configuração do local de transferência do Hadoop Distributed File System (HDFS) com o qual você está usando. AWS DataSync
Para obter mais informações, consulte Configurando DataSync transferências com um cluster HDFS.
Sintaxe da solicitação
{
"AgentArns": [ "string" ],
"AuthenticationType": "string",
"BlockSize": number,
"CmkSecretConfig": {
"KmsKeyArn": "string",
"SecretArn": "string"
},
"CustomSecretConfig": {
"SecretAccessRoleArn": "string",
"SecretArn": "string"
},
"KerberosKeytab": blob,
"KerberosKrb5Conf": blob,
"KerberosPrincipal": "string",
"KmsKeyProviderUri": "string",
"LocationArn": "string",
"NameNodes": [
{
"Hostname": "string",
"Port": number
}
],
"QopConfiguration": {
"DataTransferProtection": "string",
"RpcProtection": "string"
},
"ReplicationFactor": number,
"SimpleUser": "string",
"Subdirectory": "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 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: não
- AuthenticationType
-
O tipo de autenticação usado para determinar a identidade do usuário.
Tipo: string
Valores válidos:
SIMPLE | KERBEROSObrigatório: não
- BlockSize
-
O tamanho dos blocos de dados a serem gravados no cluster do HDFS.
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
-
Especifica as informações de configuração DataSync de um segredo gerenciado, como um
KerberosKeytabou conjunto de credenciais DataSync usado para acessar um local de transferência específico e um gerenciado pelo cliente. AWS KMS keyTipo: objeto CmkSecretConfig
Obrigatório: não
- CustomSecretConfig
-
Especifica as informações de configuração de um segredo gerenciado pelo cliente, como um
KerberosKeytabconjunto de credenciais DataSync usado para acessar um local de transferência específico e uma função gerenciada pelo cliente AWS Identity and Access Management (IAM) que fornece acesso ao segredo.Tipo: objeto CustomSecretConfig
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.
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.confque contém as informações de configuração do Kerberos. Você pode carregar o arquivokrb5.conffornecendo 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.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.
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
- LocationArn
-
O nome do recurso da Amazon (ARN) do local do cluster do HDFS de origem.
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}$Obrigatório: Sim
- NameNodes
-
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
Membros da matriz: número mínimo de 1 item.
Obrigatório: não
- QopConfiguration
-
A configuração da Qualidade da Proteção (QOP) especifica as configurações de privacidade da Chamada de Procedimento Remoto (RPC) e da transferência de dados definidas no cluster do Sistema de Arquivos Distribuído do Hadoop (HDFS).
Tipo: objeto QopConfiguration
Obrigatório: não
- ReplicationFactor
-
O número de DataNodes para os quais replicar os dados ao gravar no cluster HDFS.
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.
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.
Tipo: string
Restrições de tamanho: tamanho máximo de 4.096.
Padrão:
^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$Obrigatório: Não
Elementos de resposta
Se a ação for bem-sucedida, o serviço reenviará uma resposta 200 HTTP com um corpo HTTP vazio.
Erros
Para obter informações sobre os erros comuns que todas as ações retornam, consulte Tipos de erro 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 uma das linguagens específicas AWS SDKs, consulte o seguinte:
