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 endpoint para um servidor de arquivos do Server Message Block (SMB) que o AWS DataSync pode acessar para uma transferência. Para obter mais informações, consulte Como criar um local do SMB.
Sintaxe da solicitação
{
"AgentArns": [ "string" ],
"Domain": "string",
"MountOptions": {
"Version": "string"
},
"Password": "string",
"ServerHostname": "string",
"Subdirectory": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
],
"User": "string"
}Parâmetros de solicitação
Para obter informações sobre os parâmetros que são comuns a todas as ações, consulte Parâmetros comuns.
A solicitação aceita os dados a seguir no formato JSON.
- AgentArns
-
Especifica o DataSync agente (ou agentes) que você deseja conectar ao seu servidor de arquivos SMB. Você especifica um agente usando o 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 4 itens.
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}:agent/agent-[0-9a-z]{17}$Obrigatório: Sim
- Domain
-
Especifica o nome de domínio do Windows ao qual o servidor de arquivos SMB pertence.
Para obter mais informações, consulte required permissions (permissões necessárias) para locais SMB.
Tipo: String
Restrições de comprimento: comprimento máximo de 253.
Padrão:
^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$Obrigatório: não
- MountOptions
-
Especifica a versão do protocolo SMB que o DataSync usa para acessar o servidor de arquivos SMB.
Tipo: objeto SmbMountOptions
Obrigatório: não
- Password
-
Especifica a senha do usuário que pode montar o servidor de arquivos SMB e tem as permissões para acessar arquivos e pastas envolvidos na transferência.
Para obter mais informações, consulte required permissions (permissões necessárias) para locais SMB.
Tipo: String
Restrições de comprimento: comprimento máximo de 104.
Padrão:
^.{0,104}$Obrigatório: Sim
- ServerHostname
-
Especifica o nome do Domain Name Service (DNS) ou o endereço IP do servidor de arquivos SMB que o DataSync agente montará.
nota
Você não pode especificar um endereço IP versão 6 (IPv6).
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
-
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 SMB na rede também possam montar esse 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 required permissions (permissões necessárias) para locais SMB.
Tipo: String
Restrições de comprimento: comprimento máximo de 4096.
Padrão:
^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$Obrigatório: Sim
- 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 nome de usuário que pode montar seu servidor de arquivos SMB e tem permissão para acessar os arquivos e pastas envolvidos na transferência.
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 de pequenas e médias empresas.
Tipo: String
Restrições de comprimento: comprimento máximo de 104.
Padrão:
^[^\x5B\x5D\\/:;|=,+*?]{1,104}$Obrigatório: Sim
Sintaxe da resposta
{
"LocationArn": "string"
}Elementos de resposta
Se a ação for bem-sucedida, o serviço reenviará uma resposta HTTP 200.
Os dados a seguir são retornados no formato JSON pelo serviço.
- LocationArn
-
O ARN do local SMB 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 a todas as ações, consulteErros comuns.
- InternalException
-
Essa exceção é lançada quando ocorre um erro no AWS DataSync serviço.
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" }
Exemplo de resposta
Uma resposta retorna o ARN da localização do seu servidor de arquivos 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 um dos AWS SDKs específicos de linguagem, consulte o seguinte:
