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](https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html#create-fsx-location-access). ## 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](CommonParameters.md). A solicitação aceita os dados a seguir no formato JSON. ** [CmkSecretConfig](#API_CreateLocationFsxWindows_RequestSyntax) ** 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 `CreateLocationFsxWindows` solicitação, você fornece somente o ARN da chave KMS. DataSync usa essa chave KMS junto com a `Password` que 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](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#service-secret-custom-key). AWS KMS key Você pode usar `CmkSecretConfig` (com `Password`) ou `CustomSecretConfig` (sem `Password`) para fornecer credenciais para uma solicitação `CreateLocationFsxWindows`. Não forneça os dois parâmetros para a mesma solicitação. Tipo: objeto [CmkSecretConfig](API_CmkSecretConfig.md) Obrigatório: não ** [CustomSecretConfig](#API_CreateLocationFsxWindows_RequestSyntax) ** 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](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#custom-secret-custom-key). Você pode usar `CmkSecretConfig` (com `Password`) ou `CustomSecretConfig` (sem `Password`) para fornecer credenciais para uma solicitação `CreateLocationFsxWindows`. Não forneça os dois parâmetros para a mesma solicitação. Tipo: objeto [CustomSecretConfig](API_CustomSecretConfig.md) Obrigatório: não ** [Domain](#API_CreateLocationFsxWindows_RequestSyntax) ** 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](#API_CreateLocationFsxWindows_RequestSyntax) ** 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](#API_CreateLocationFsxWindows_RequestSyntax) ** 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](#API_CreateLocationFsxWindows_RequestSyntax) ** 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 [https://docs.aws.amazon.com/fsx/latest/WindowsGuide/limit-access-security-groups.html](https://docs.aws.amazon.com/fsx/latest/WindowsGuide/limit-access-security-groups.html). 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](#API_CreateLocationFsxWindows_RequestSyntax) ** 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](#API_CreateLocationFsxWindows_RequestSyntax) ** 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](API_TagListEntry.md) Membros da Matriz: número mínimo de 0 itens. Número máximo de 50 itens. Obrigatório: não ** [User](#API_CreateLocationFsxWindows_RequestSyntax) ** 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](https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html#create-fsx-windows-location-permissions) 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](#API_CreateLocationFsxWindows_ResponseSyntax) ** 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](CommonErrors.md). ** 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: + [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationFsxWindows) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationFsxWindows)