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á.
DescribeLocationHdfs
Fornece detalhes sobre como um local de AWS DataSync transferência para um Hadoop Distributed File System (HDFS) é configurado.
Sintaxe da solicitação
{
"LocationArn": "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.
- LocationArn
-
Especifica o nome do recurso da Amazon (ARN) do local do HDFS.
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
Sintaxe da resposta
{
"AgentArns": [ "string" ],
"AuthenticationType": "string",
"BlockSize": number,
"CmkSecretConfig": {
"KmsKeyArn": "string",
"SecretArn": "string"
},
"CreationTime": number,
"CustomSecretConfig": {
"SecretAccessRoleArn": "string",
"SecretArn": "string"
},
"KerberosPrincipal": "string",
"KmsKeyProviderUri": "string",
"LocationArn": "string",
"LocationUri": "string",
"ManagedSecretConfig": {
"SecretArn": "string"
},
"NameNodes": [
{
"Hostname": "string",
"Port": number
}
],
"QopConfiguration": {
"DataTransferProtection": "string",
"RpcProtection": "string"
},
"ReplicationFactor": number,
"SimpleUser": "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.
- AgentArns
-
O 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}$ - AuthenticationType
-
O tipo de autenticação usado para determinar a identidade do usuário.
Tipo: string
Valores válidos:
SIMPLE | KERBEROS - 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
- CmkSecretConfig
-
Descreve as informações de configuração DataSync de um segredo gerenciado, como
KerberosKeytabaquele DataSync usado para acessar um local de armazenamento específico, com um segredo gerenciado pelo cliente AWS KMS key.Tipo: objeto CmkSecretConfig
- CreationTime
-
O horário em que a localização do HDFS foi criada.
Tipo: Timestamp
- CustomSecretConfig
-
Descreve as informações de configuração de um segredo gerenciado pelo cliente, como
KerberosKeytabaquele DataSync usado para acessar um local de armazenamento específico, com uma função gerenciada pelo cliente AWS Identity and Access Management (IAM) que fornece acesso ao segredo.Tipo: objeto CustomSecretConfig
- KerberosPrincipal
-
A entidade principal do Kerberos com acesso aos arquivos e pastas no cluster do HDFS. Esse parâmetro é usado se o
AuthenticationTypefor definido comoKERBEROS.Tipo: string
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 256.
Padrã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$ - LocationArn
-
O ARN do local do HDFS.
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}$ - LocationUri
-
O URI do local do HDFS.
Tipo: string
Restrições de tamanho: tamanho máximo de 4.360.
Padrão:
^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$ - ManagedSecretConfig
-
Descreve as informações de configuração DataSync de um segredo gerenciado, como
KerberosKeytabaquele DataSync usado para acessar um local de armazenamento específico. DataSync usa a chave KMS AWS gerenciada padrão para criptografar esse segredo. AWS Secrets ManagerTipo: objeto ManagedSecretConfig
- NameNodes
-
O NameNode que gerencia o namespace HDFS.
Tipo: matriz de objetos HdfsNameNode
Membros da matriz: número mínimo de 1 item.
- QopConfiguration
-
A configuração de Qualidade de Proteção (QOP), que especifica as configurações de Chamada de Procedimento Remoto (RPC) e de proteção de transferência de dados definidas no cluster do HDFS.
Tipo: objeto QopConfiguration
- 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.
- SimpleUser
-
O nome de usuário para identificar o cliente no sistema operacional do host. Esse parâmetro é usado se o
AuthenticationTypefor definido comoSIMPLE.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]*$
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 uma das linguagens específicas AWS SDKs, consulte o seguinte: