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á. # CreateLocationFsxOntap Cria um *local* de transferência para um sistema de arquivos Amazon FSx for NetApp ONTAP. 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 ONTAP.](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html#create-ontap-location-access) ## Sintaxe da solicitação ``` { "Protocol": { "NFS": { "MountOptions": { "Version": "string" } }, "SMB": { "CmkSecretConfig": { "KmsKeyArn": "string", "SecretArn": "string" }, "CustomSecretConfig": { "SecretAccessRoleArn": "string", "SecretArn": "string" }, "Domain": "string", "ManagedSecretConfig": { "SecretArn": "string" }, "MountOptions": { "Version": "string" }, "Password": "string", "User": "string" } }, "SecurityGroupArns": [ "string" ], "StorageVirtualMachineArn": "string", "Subdirectory": "string", "Tags": [ { "Key": "string", "Value": "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. ** [Protocol](#API_CreateLocationFsxOntap_RequestSyntax) ** Especifica o protocolo de transferência de dados AWS DataSync usado para acessar seu sistema de FSx arquivos da Amazon. Tipo: objeto [FsxProtocol](API_FsxProtocol.md) Obrigatório: Sim ** [SecurityGroupArns](#API_CreateLocationFsxOntap_RequestSyntax) ** Especifica os grupos de segurança do Amazon EC2 que fornecem acesso à sub-rede preferencial do seu sistema de arquivos. Os grupos de segurança devem permitir tráfego de saída nas seguintes portas (dependendo do protocolo em uso): + **Sistema de arquivos de rede (NFS)**: portas TCP 111, 635 e 2049 + **Server Message Block (SMB)**: porta TCP 445 Os grupos de segurança do seu sistema de arquivos também devem permitir tráfego de entrada na mesma porta. 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 ** [StorageVirtualMachineArn](#API_CreateLocationFsxOntap_RequestSyntax) ** Especifica o ARN da máquina virtual de armazenamento (SVM) no sistema de arquivos para o qual e do qual você copia dados. Tipo: string Restrições de tamanho: tamanho máximo de 162. Padrão: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):fsx:[a-z\-0-9]+:[0-9]{12}:storage-virtual-machine/fs-[0-9a-f]+/svm-[0-9a-f]{17,}$` Obrigatório: Sim ** [Subdirectory](#API_CreateLocationFsxOntap_RequestSyntax) ** Especifica um caminho para o compartilhamento de arquivos na SVM de/para o qual você deseja transferir dados. Você pode especificar um caminho de união (também conhecido como ponto de montagem), caminho qtree (para compartilhamentos de arquivos NFS) ou nome de compartilhamento (para compartilhamentos de arquivos SMB). Por exemplo, seu caminho de montagem pode ser `/vol1`, `/vol1/tree1` ou `/share1`. Não especifique um caminho de junção no volume raiz do SVM. Para obter mais informações, consulte [Gerenciamento FSx de máquinas virtuais de armazenamento ONTAP no Guia](https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/managing-svms.html) do *usuário do Amazon FSx for NetApp ONTAP*. Tipo: string Restrições de tamanho: tamanho máximo de 255. Padrão: `^[^\u0000\u0085\u2028\u2029\r\n]{1,255}$` Obrigatório: Não ** [Tags](#API_CreateLocationFsxOntap_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 ## 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_CreateLocationFsxOntap_ResponseSyntax) ** Especifica o ARN da localização FSx do sistema de arquivos for ONTAP que você cria. 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 linguagem específica AWS SDKs, consulte o seguinte: + [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationFsxOntap) + [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationFsxOntap) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationFsxOntap) + [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationFsxOntap) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationFsxOntap) + [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationFsxOntap) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationFsxOntap) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationFsxOntap) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationFsxOntap) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationFsxOntap)