DescribeLocationHdfs - 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á.

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 KerberosKeytab aquele 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 KerberosKeytab aquele 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 AuthenticationType for definido como KERBEROS.

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 KerberosKeytab aquele 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 Manager

Tipo: 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 AuthenticationType for definido como SIMPLE.

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: