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á.
CreateLocationFsxWindows
Cria um local de transferência para um sistema de arquivos Amazon FSx for Windows File Server. AWS DataSync pode usar esse local como origem ou destino para transferir dados.
Antes de começar, certifique-se de entender como DataSync acessar os sistemas FSx de arquivos do Windows File Server.
Sintaxe da solicitação
{
"CmkSecretConfig": {
"KmsKeyArn": "string",
"SecretArn": "string"
},
"CustomSecretConfig": {
"SecretAccessRoleArn": "string",
"SecretArn": "string"
},
"Domain": "string",
"FsxFilesystemArn": "string",
"Password": "string",
"SecurityGroupArns": [ "string" ],
"Subdirectory": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
],
"User": "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.
- CmkSecretConfig
-
Especifica as informações de configuração DataSync de um segredo gerenciado, que inclui a senha DataSync usada para acessar um local de armazenamento específico FSx do Windows, com um gerenciado pelo cliente. AWS KMS key
Ao incluir esse parâmetro como parte de uma
CreateLocationFsxWindowssolicitação, você fornece somente o ARN da chave KMS. DataSync usa essa chave KMS junto com aPasswordque você especificou para criar um segredo DataSync gerenciado para armazenar as credenciais de acesso à localização.Verifique se ele DataSync tem permissão para acessar a chave KMS que você especificou. Para obter mais informações, consulte Usando um segredo gerenciado pelo serviço criptografado com um personalizado. AWS KMS key
nota
Você pode usar
CmkSecretConfig(comPassword) ouCustomSecretConfig(semPassword) para fornecer credenciais para uma solicitaçãoCreateLocationFsxWindows. Não forneça os dois parâmetros para a mesma solicitação.Tipo: objeto CmkSecretConfig
Obrigatório: não
- CustomSecretConfig
-
Especifica as informações de configuração para um segredo do Secrets Manager gerenciado pelo cliente, em que a senha de um local FSx de armazenamento do Windows File Server é armazenada em texto simples, no Secrets Manager. Essa configuração inclui o ARN secreto e o ARN de um perfil do IAM que fornece acesso ao segredo. Para obter mais informações, consulte Usando um segredo que você gerencia.
nota
Você pode usar
CmkSecretConfig(comPassword) ouCustomSecretConfig(semPassword) para fornecer credenciais para uma solicitaçãoCreateLocationFsxWindows. Não forneça os dois parâmetros para a mesma solicitação.Tipo: objeto CustomSecretConfig
Obrigatório: não
- Domain
-
Especifica o nome do domínio do Windows ao qual o sistema FSx de arquivos do Windows File Server pertence.
Se você tiver vários domínios do Active Directory em seu ambiente, a configuração desse parâmetro garante que ele DataSync se conecte ao sistema de arquivos correto.
Tipo: string
Restrições de tamanho: tamanho máximo de 253.
Padrão:
^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$Obrigatório: não
- FsxFilesystemArn
-
Especifica o Amazon Resource Name (ARN) para FSx o sistema de arquivos do Windows File Server.
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):fsx:[a-z\-0-9]+:[0-9]{12}:file-system/fs-[0-9a-f]+$Obrigatório: Sim
- Password
-
Especifica a senha do usuário com as permissões para montar e acessar os arquivos, pastas e metadados de arquivos no seu FSx sistema de arquivos do Windows File Server.
Tipo: string
Restrições de tamanho: tamanho máximo de 104.
Padrão:
^.{0,104}$Obrigatório: não
- SecurityGroupArns
-
Especifica os ARNs dos grupos de segurança do Amazon EC2 que fornecem acesso à sub-rede preferencial do seu sistema de arquivos.
Os grupos de segurança que você especificar devem ser capazes de se comunicar com os grupos de segurança do seu 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.
nota
Se você escolher um grupo de segurança que não permite conexões de dentro de si mesmo, siga um destes procedimentos:
-
Configure o grupo de segurança para permitir que ele se comunique dentro de si próprio.
-
Escolha outro grupo de segurança diferente que possa se comunicar com o grupo de segurança do destino de montagem.
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]+$Obrigatório: Sim
-
- Subdirectory
-
Especifica um caminho de montagem para seu sistema de arquivos usando barras. É aqui que DataSync lê ou grava dados (dependendo se esse é um local de origem ou destino).
Tipo: string
Restrições de tamanho: tamanho máximo de 4.096.
Padrão:
^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$Obrigatório: Não
- Tags
-
Especifica rótulos que ajudam você a categorizar, filtrar e pesquisar seus recursos da AWS . Recomendamos criar pelo menos uma etiqueta de nome para a sua localização.
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
- User
-
Especifica o usuário com as permissões para montar e acessar os arquivos, pastas e metadados de arquivos no seu FSx sistema de arquivos do Windows File Server.
Para obter informações sobre como escolher um usuário com o nível certo de acesso para sua transferência, consulte as permissões necessárias FSx para locais do Windows File Server.
Tipo: string
Restrições de tamanho: tamanho máximo de 104.
Padrão:
^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$Obrigatório: sim
Sintaxe da resposta
{
"LocationArn": "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.
- LocationArn
-
O ARN da localização do sistema FSx de arquivos do Windows File Server que você criou.
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}$
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:
