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á.
DescribeLocationFsxWindows
Fornece detalhes sobre como um local AWS DataSync de transferência para um sistema de arquivos Amazon FSx para Windows File Server é 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 de recurso da Amazon (ARN) da localização FSx do servidor de arquivos para Windows.
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
{
"CmkSecretConfig": {
"KmsKeyArn": "string",
"SecretArn": "string"
},
"CreationTime": number,
"CustomSecretConfig": {
"SecretAccessRoleArn": "string",
"SecretArn": "string"
},
"Domain": "string",
"LocationArn": "string",
"LocationUri": "string",
"ManagedSecretConfig": {
"SecretArn": "string"
},
"SecurityGroupArns": [ "string" ],
"User": "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.
- CmkSecretConfig
-
Descreve as informações de configuração DataSync de um segredo gerenciado, como
Passwordaquele DataSync usado para acessar um local de armazenamento específico, com um segredo gerenciado pelo cliente AWS KMS key.Tipo: objeto CmkSecretConfig
- CreationTime
-
A hora em que o FSx local do servidor de arquivos do Windows foi criado.
Tipo: Timestamp
- CustomSecretConfig
-
Descreve as informações de configuração de um segredo gerenciado pelo cliente, como
Passwordaquele 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
- Domain
-
O nome do domínio do Microsoft Active Directory ao qual pertence o FSx sistema de arquivos do Windows File Server.
Tipo: string
Restrições de tamanho: tamanho máximo de 253.
Padrão:
^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$ - LocationArn
-
O ARN da localização do servidor FSx de arquivos do Windows.
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 identificador uniforme de recursos (URI) do FSx local do Windows File Server.
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
Passwordaquele 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
- SecurityGroupArns
-
Os ARNs dos grupos de segurança do Amazon EC2 que fornecem acesso à sub-rede preferencial do sistema de arquivos.
Para obter informações sobre a configuração de grupos de segurança para acesso ao sistema de arquivos, consulte o Guia do usuário do Amazon FSx para Windows File Server.
Tipo: matriz de strings
Membros da Matriz: número mínimo de 1 item. Número máximo de 5 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):ec2:[a-z\-0-9]*:[0-9]{12}:security-group/sg-[a-f0-9]+$ - User
-
O usuário com as permissões para montar e acessar o sistema FSx de arquivos do Windows File Server.
Tipo: string
Restrições de tamanho: tamanho máximo de 104.
Padrão:
^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$
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:
