CreateLocationFsxWindows
Cria um local de transferência de um sistema de arquivos Amazon FSx para Windows File Server. O AWS DataSync pode usar esse local como fonte ou destino para transferir dados.
Antes de começar, certifique-se de que você entende como o DataSync acessa um sistema de arquivos FSx para Windows File Server.
Sintaxe da Solicitação
{
"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.
- Domain
-
Especifica o nome do domínio do Windows ao qual o FSx para 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 o 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 nome do recurso da Amazon (ARN) para o sistema de arquivos FSx for Windows File Server.
Tipo: String
Restrições de tamanho: tamanho máximo de 128.
Padrão: :
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):fsx:[a-z\-0-9]*:[0-9]{12}:file-system/fs-.*$Exigido: Sim
- Password
-
Especifica a senha do usuário com permissões para montar e acessar os arquivos, pastas e metadados de arquivos no sistema de arquivos FSx para Windows File Server.
Tipo: String
Restrições de tamanho: tamanho máximo de 104.
Padrão: :
^.{0,104}$Exigido: Sim
- 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 como configurar grupos de segurança para acesso ao sistema de arquivos, consulte o Amazon FSx for Windows File Server User Guide.
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-iso|aws-iso-b):ec2:[a-z\-0-9]*:[0-9]{12}:security-group/sg-[a-f0-9]+$Exigido: Sim
-
- Subdirectory
-
Especifica um caminho de montagem para seu sistema de arquivos usando barras. É aqui que o DataSync lê ou grava dados (dependendo de ser 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 permissões para montar e acessar os arquivos, pastas e metadados de arquivos no sistema de arquivos FSx para 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 para locais do FSx para Windows File Server.
Tipo: String
Restrições de tamanho: tamanho máximo de 104.
Padrão: :
^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$Exigido: 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 do local especificado do sistema de arquivos FSx para Windows 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-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 um dos SDKs específicos de linguagem AWS, consulte:
