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á.
CreateLocationNfs
Define um sistema de arquivos em um servidor NFS (Network File System) que pode ser lido ou gravado.
Sintaxe da solicitação
{
"MountOptions": {
"Version": "string"
},
"OnPremConfig": {
"AgentArns": [ "string" ]
},
"ServerHostname": "string",
"Subdirectory": "string",
"Tags": [
{
"Key": "string",
"Value": "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.
- MountOptions
-
As opções de montagem do NFS queDataSync podem ser usadas para montar o compartilhamento do NFS.
Tipo: objeto NfsMountOptions
Obrigatório: não
- OnPremConfig
-
Contém uma lista de nomes de recursos da Amazon (ARNs) de agentes que são usados para se conectar a um servidor NFS.
Se você estiver copiando dados de ou para seu dispositivo AWS Snowcone, consulte Servidor NFS no AWS Snowcone para obter mais informações.
Tipo: objeto OnPremConfig
Obrigatório: Sim
- ServerHostname
-
O nome do servidor NFS. Esse valor é o endereço IP ou o nome do Sistema de Nomes de Domínio (DNS) do servidor NFS. Um agente que é instalado on-premises usa esse nome de host para montar o servidor NFS em uma rede.
Se você estiver copiando dados de ou para seu dispositivo AWS Snowcone, consulte Servidor NFS no AWS Snowcone para obter mais informações.
nota
Este nome deve ser compatível com o DNS ou deve ser um endereço IP versão 4 (IPv4).
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
-
O subdiretório no sistema de arquivos NFS que é usado para ler dados do local de origem do NFS ou gravar dados no destino NFS. O caminho NFS deve ser um caminho exportado pelo servidor NFS ou um subdiretório desse caminho. O caminho deve poder ser montado por outros clientes NFS em sua rede.
Para ver todos os caminhos exportados pelo seu servidor NFS, execute "
showmount -e nfs-server-name" de um cliente NFS que tenha acesso ao seu servidor. Você pode especificar qualquer diretório exibido nos resultados e qualquer subdiretório desse diretório. Certifique-se de que a exportação NFS seja acessível sem a autenticação Kerberos.Para transferir todos os dados na pasta que você especificou, o DataSync precisa ter permissões para ler todos os dados. Para garantir isso, configure a exportação do NFS com
no_root_squash,ou verifique as permissões para todos os arquivos para os quais você desejaDataSync que todos os usuários. Isso permite que o agente leia os arquivos. Para que o agente acesse diretórios, você também deverá ativar todo o acesso de execução.Se você estiver copiando dados de ou para seu dispositivo AWS Snowcone, consulte Servidor NFS no AWS Snowcone para obter mais informações.
Para obter mais informações sobre a configuração de exportação do NFS, consulte 18.7. O arquivo de configuração /etc/exports
na documentação do Red Hat Enterprise Linux. Tipo: String
Restride tamanho máximo de: comprimento máximo de: comprimento máximo de: comprimento máximo de: comprimento máximo de:
Padrão:
^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]+$Obrigatório: Sim
- Tags
-
O par de chave-valor que representa a tag que você deseja adicionar ao local. O valor pode ser uma string vazia. Recomendamos usar tags para nomear os recursos.
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
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 nome de recurso da Amazon (ARN) do local do sistema de arquivos NFS de origem criado.
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 noAWS DataSync serviço.
Código de status HTTP: 500
- InvalidRequestException
-
Essa exceção é gerada quando o cliente envia uma solicitação mal formada.
Código de status HTTP: 400
Exemplos
Exemplo
O exemplo a seguir cria um endpoint para um sistema de arquivos NFS usando a versão NFS especificada como opção de montagem.
Exemplo de solicitação
{
"MountOptions": {
"Version": : "NFS4_0"
},
"OnPremConfig": {
"AgentArn": [ "arn:aws:datasync:us-east-2:111222333444:agent/agent-0b0addbeef44b3nfs" ]
},
"ServerHostname": "MyServer@amazon.com",
"Subdirectory": "/MyFolder",
"Tags": [
{
"Key": "Name",
"Value": "ElasticFileSystem-1"
}
]
}Exemplo
A resposta retorna o nome de recurso da Amazon (ARN) do local do NFS.
Exemplo de resposta
{
"LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50aa"
}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:
