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á. # UpdateLocationSmb Modifica os seguintes parâmetros de configuração do local de transferência do Server Message Block (SMB) com o qual você está usando. AWS DataSync Para obter mais informações, consulte [Configurando DataSync transferências com um servidor de arquivos SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html). ## 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", "LocationArn": "string", "MountOptions": { "Version": "string" }, "Password": "string", "ServerHostname": "string", "Subdirectory": "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_UpdateLocationSmb_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: não ** [AuthenticationType](#API_UpdateLocationSmb_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_UpdateLocationSmb_RequestSyntax) ** Especifica as informações de configuração DataSync de um segredo gerenciado, como um `Password` ou `KerberosKeytab` ou um conjunto de credenciais DataSync usado para acessar um local de transferência específico e um gerenciado pelo cliente. AWS KMS key Tipo: objeto [CmkSecretConfig](API_CmkSecretConfig.md) Obrigatório: não ** [CustomSecretConfig](#API_UpdateLocationSmb_RequestSyntax) ** Especifica as informações de configuração de um segredo gerenciado pelo cliente, como um `Password` ou `KerberosKeytab` ou um conjunto de credenciais DataSync usado para acessar um local de transferência específico e uma função gerenciada pelo cliente AWS Identity and Access Management (IAM) que fornece acesso ao segredo. Tipo: objeto [CustomSecretConfig](API_CustomSecretConfig.md) Obrigatório: não ** [DnsIpAddresses](#API_UpdateLocationSmb_RequestSyntax) ** Especifica os endereços IP (IPv4 ou IPv6) 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_UpdateLocationSmb_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_UpdateLocationSmb_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_UpdateLocationSmb_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_UpdateLocationSmb_RequestSyntax) ** Especifica uma entidade principal Kerberos, que é uma identidade no realm Kerberos com 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 ** [LocationArn](#API_UpdateLocationSmb_RequestSyntax) ** Especifica o ARN do local do SMB que você deseja atualizar. 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}$` Obrigatório: Sim ** [MountOptions](#API_UpdateLocationSmb_RequestSyntax) ** Especifica a versão do protocolo Server Message Block (SMB) AWS DataSync usada para acessar um servidor de arquivos SMB. Tipo: objeto [SmbMountOptions](API_SmbMountOptions.md) Obrigatório: não ** [Password](#API_UpdateLocationSmb_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_UpdateLocationSmb_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: não ** [Subdirectory](#API_UpdateLocationSmb_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 especificado, 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: não ** [User](#API_UpdateLocationSmb_RequestSyntax) ** Especifica o nome de usuário que pode montar seu servidor de arquivos SMB e tem 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`. 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 ## Elementos de resposta Se a ação for bem-sucedida, o serviço reenviará uma resposta 200 HTTP com um corpo HTTP vazio. ## 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/UpdateLocationSmb) + [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationSmb) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationSmb) + [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationSmb) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationSmb) + [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationSmb) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationSmb) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationSmb) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationSmb) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationSmb)