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á. # CreateLocationSmb Cria um *local* de transferência para um servidor de arquivos do Server Message Block (SMB). AWS DataSync pode usar esse local como origem ou destino para transferir dados. Antes de começar, certifique-se de entender como DataSync acessa os servidores de arquivos SMB. Para obter mais informações, consulte [Fornecendo DataSync acesso a servidores de arquivos SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions). ## Sintaxe da solicitação ``` { "AgentArns": [ "string" ], "AuthenticationType": "string", "CmkSecretConfig": { "KmsKeyArn": "string", "SecretArn": "string" }, "CustomSecretConfig": { "SecretAccessRoleArn": "string", "SecretArn": "string" }, "DnsIpAddresses": [ "string" ], "Domain": "string", "KerberosKeytab": blob, "KerberosKrb5Conf": blob, "KerberosPrincipal": "string", "MountOptions": { "Version": "string" }, "Password": "string", "ServerHostname": "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. ** [AgentArns](#API_CreateLocationSmb_RequestSyntax) ** Especifica o DataSync agente (ou agentes) que podem se conectar ao seu servidor de arquivos SMB. Você especifica um agente usando seu nome do recurso da Amazon (ARN). Tipo: matriz de strings Membros da matriz: número mínimo de 1 item. Número máximo de 8 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):datasync:[a-z\-0-9]+:[0-9]{12}:agent/agent-[0-9a-z]{17}$` Obrigatório: Sim ** [AuthenticationType](#API_CreateLocationSmb_RequestSyntax) ** Especifica o protocolo de autenticação DataSync usado para se conectar ao seu servidor de arquivos SMB. DataSync suporte `NTLM` (padrão) e `KERBEROS` autenticação. Para obter mais informações, consulte [Fornecendo DataSync acesso a servidores de arquivos SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions). Tipo: string Valores válidos: `NTLM | KERBEROS` Obrigatório: não ** [CmkSecretConfig](#API_CreateLocationSmb_RequestSyntax) ** Especifica as informações de configuração DataSync de um segredo gerenciado, um `Password` ou `KerberosKeytab` (para tipos `NTLM` (padrão) e de `KERBEROS` autenticação, respectivamente) DataSync usado para acessar um local de armazenamento SMB específico, com um gerenciado pelo cliente. AWS KMS key Ao incluir esse parâmetro como parte de uma `CreateLocationSmbRequest` solicitação, você fornece somente o ARN da chave KMS. DataSync usa essa chave KMS junto com a `Password` ou `KerberosKeytab` 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 um `Password` ou`KerberosKeytab`) ou `CustomSecretConfig` (sem nenhum `Password` e`KerberosKeytab`) para fornecer credenciais para uma `CreateLocationSmbRequest` solicitação. Não forneça ambos `CmkSecretConfig` e `CustomSecretConfig` parâmetros para a mesma solicitação. Tipo: objeto [CmkSecretConfig](API_CmkSecretConfig.md) Obrigatório: não ** [CustomSecretConfig](#API_CreateLocationSmb_RequestSyntax) ** Especifica as informações de configuração para um segredo do Secrets Manager gerenciado pelo cliente em que as credenciais do local de armazenamento SMB são armazenadas no Secrets Manager como texto simples (para`Password`) ou binário (para). `KerberosKeytab` 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 `SasConfiguration`) ou `CustomSecretConfig` (sem `SasConfiguration`) para fornecer credenciais para uma solicitação `CreateLocationSmbRequest`. Não forneça os dois parâmetros para a mesma solicitação. Tipo: objeto [CustomSecretConfig](API_CustomSecretConfig.md) Obrigatório: não ** [DnsIpAddresses](#API_CreateLocationSmb_RequestSyntax) ** Especifica os IPv6 endereços IPv4 ou dos servidores DNS aos quais seu servidor de arquivos SMB pertence. Esse parâmetro será aplicado somente se `AuthenticationType` estiver definido como `KERBEROS`. Se você tiver vários domínios em seu ambiente, a configuração desse parâmetro garante que ele se DataSync conecte ao servidor de arquivos SMB correto. Tipo: matriz de strings Membros da matriz: número máximo de 2 itens. Restrições de comprimento: comprimento mínimo de 7. Comprimento máximo de 39. Padrão: `\A((25[0-5]|2[0-4]\d|[0-1]?\d?\d)(\.(25[0-5]|2[0-4]\d|[0-1]?\d?\d)){3}|([0-9a-fA-F]{1,4}:){7,7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6}))\z` Obrigatório: não ** [Domain](#API_CreateLocationSmb_RequestSyntax) ** Especifica o nome de domínio do Windows ao qual o servidor de arquivos SMB pertence. Esse parâmetro será aplicado somente se `AuthenticationType` estiver definido como `NTLM`. Se você tiver vários domínios em seu ambiente, a configuração desse parâmetro garante que ele se DataSync conecte ao servidor 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 ** [KerberosKeytab](#API_CreateLocationSmb_RequestSyntax) ** Especifica o arquivo da tabela de chaves Kerberos (keytab), que inclui mapeamentos entre a entidade principal Kerberos e as chaves de criptografia. Para evitar erros de execução de tarefas, confira se a entidade principal Kerberos usada para criar o arquivo keytab corresponde exatamente ao que você especificou para `KerberosPrincipal`. Tipo: objeto de dados binários codificado pelo Base64 Restrições de tamanho: tamanho máximo de 65536. Obrigatório: não ** [KerberosKrb5Conf](#API_CreateLocationSmb_RequestSyntax) ** Especifica um arquivo de configuração Kerberos (`krb5.conf`) que define a configuração do realm Kerberos. O arquivo deve ser codificado em base64. Se você estiver usando o AWS CLI, a codificação é feita para você. Tipo: Objeto de dados binários codificado em Base64 Restrições de tamanho: tamanho máximo de 131.072. Obrigatório: não ** [KerberosPrincipal](#API_CreateLocationSmb_RequestSyntax) ** Especifica uma entidade principal Kerberos, que é uma identidade no realm Kerberos que tem permissão para acessar os arquivos, pastas e metadados de arquivos no servidor de arquivos SMB. Uma entidade principal Kerberos pode ter a aparência de `HOST/kerberosuser@MYDOMAIN.ORG`. Os nomes de entidade principal diferenciam letras maiúsculas de minúsculas A execução da DataSync tarefa falhará se o principal que você especificar para esse parâmetro não corresponder exatamente ao principal usado para criar o arquivo keytab. Tipo: string Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 256. Padrão: `^.+$` Obrigatório: não ** [MountOptions](#API_CreateLocationSmb_RequestSyntax) ** Especifica a versão do protocolo SMB DataSync usada para acessar seu servidor de arquivos SMB. Tipo: objeto [SmbMountOptions](API_SmbMountOptions.md) Obrigatório: não ** [Password](#API_CreateLocationSmb_RequestSyntax) ** Especifica a senha do usuário que pode montar o servidor de arquivos SMB e tenha permissão para acessar os arquivos e pastas envolvidos na sua transferência. Esse parâmetro será aplicado somente se `AuthenticationType` estiver definido como `NTLM`. Tipo: string Restrições de tamanho: tamanho máximo de 104. Padrão: `^.{0,104}$` Obrigatório: não ** [ServerHostname](#API_CreateLocationSmb_RequestSyntax) ** Especifica o nome de domínio ou endereço IP (IPv4 ou IPv6) do servidor de arquivos SMB ao qual seu DataSync agente se conecta. Se você estiver usando a autenticação Kerberos, deverá especificar um nome de domínio. Tipo: string Restrições de tamanho: tamanho máximo de 255. Padrão: `^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-:]*[A-Za-z0-9])$` Obrigatório: Sim ** [Subdirectory](#API_CreateLocationSmb_RequestSyntax) ** Especifica o nome do compartilhamento exportado pelo seu servidor de arquivos SMB onde DataSync lerá ou gravará dados. Você pode incluir um subdiretório no caminho de compartilhamento (por exemplo, `/path/to/subdirectory`). Certifique-se de que outros clientes do SMB em sua rede também possam montar este caminho. Para copiar todos os dados no subdiretório, DataSync deve ser capaz de montar o compartilhamento SMB e acessar todos os seus dados. Para obter mais informações, consulte [Fornecendo DataSync acesso a servidores de arquivos SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions). Tipo: string Restrições de tamanho: tamanho máximo de 4.096. Padrão: `^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$` Obrigatório: Sim ** [Tags](#API_CreateLocationSmb_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_CreateLocationSmb_RequestSyntax) ** Especifica o usuário que pode montar e acessar os arquivos, pastas e metadados de arquivos no servidor de arquivos SMB. Esse parâmetro será aplicado somente se `AuthenticationType` estiver definido como `NTLM`. Para obter informações sobre como escolher um usuário com o nível certo de acesso para sua transferência, consulte [Fornecendo DataSync acesso a servidores de arquivos SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions). Tipo: string Restrições de tamanho: tamanho máximo de 104. Padrão: `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$` 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_CreateLocationSmb_ResponseSyntax) ** O ARN do local no SMB criado por você. 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 ## Exemplos ### Exemplo de solicitação O exemplo a seguir cria um local para um servidor de arquivos SMB. ``` { "AgentArns":[ "arn:aws:datasync:us-east-2:111222333444:agent/agent-0b0addbeef44b3nfs", "arn:aws:datasync:us-east-2:111222333444:agent/agent-2345noo35nnee1123ovo3" ], "Domain":"AMAZON", "MountOptions":{ "Version":"SMB3" }, "Password":"string", "ServerHostname":"MyServer.amazon.com", "Subdirectory":"share", "Tags":[ { "Key":"department", "Value":"finance" } ], "User":"user-1" } ``` ### Resposta da amostra Uma resposta retorna o ARN do local do seu servidor de arquivos do SMB. ``` { "LocationArn": "arn:aws:datasync:us-east-1:111222333444:location/loc-0f01451b140b2af49" } ``` ## 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/CreateLocationSmb) + [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationSmb) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationSmb) + [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationSmb) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationSmb) + [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationSmb) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationSmb) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationSmb) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationSmb) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationSmb)