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á.
CreateLocationObjectStorage
Cria um endpoint para um sistema de armazenamento de objetos que AWS DataSync pode ser acessado para uma transferência. Para obter mais informações, consulte Criação de um local para armazenamento de objetos.
Sintaxe da solicitação
{
"AccessKey": "string",
"AgentArns": [ "string" ],
"BucketName": "string",
"SecretKey": "string",
"ServerCertificate": blob,
"ServerHostname": "string",
"ServerPort": number,
"ServerProtocol": "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.
- AccessKey
-
Especifica a chave de acesso (por exemplo, um nome de usuário) se as credenciais forem necessárias para autenticação no servidor de armazenamento de objetos.
Tipo: String
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 200.
Padrão:
^.+$Obrigatório: não
- AgentArns
-
Especifica os nomes de recursos da Amazon (ARNs) dos DataSync agentes que podem se conectar com segurança ao seu local.
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
- BucketName
-
Especifica o nome do bucket de armazenamento de objetos envolvido na transferência.
Tipo: String
Restrições de tamanho: comprimento mínimo de 3. Tamanho máximo de 63.
Padrão:
^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$Obrigatório: Sim
- SecretKey
-
Especifica a chave secreta (por exemplo, uma senha) se as credenciais forem necessárias para autenticação no servidor de armazenamento de objetos.
Tipo: String
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 200.
Padrão:
^.+$Obrigatório: não
- ServerCertificate
-
Especifica um arquivo com os certificados usados para assinar o certificado do servidor de armazenamento de objetos (por exemplo,
file:///home/user/.ssh/storage_sys_certificate.pem). O arquivo que você especificar deve incluir o seguinte:-
O certificado da autoridade de certificação (CA - certificate authority)
-
Qualquer certificado intermediário
-
codificação base64
-
Uma
.pemextensão
O arquivo pode ter até 32768 bytes (antes da codificação base64).
Para usar esse parâmetro, configure
ServerProtocolparaHTTPS.Tipo: Objeto de dados binários codificado pelo Base64
Restrições de tamanho: tamanho máximo de 32768.
Obrigatório: não
-
- ServerHostname
-
Especifica o nome do domínio ou o endereço IP do servidor de armazenamento de objetos. Um DataSync agente usa esse nome de host para montar o servidor de armazenamento de objetos em uma rede.
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
- ServerPort
-
Especifica a porta em que o servidor de armazenamento de objetos aceita o tráfego de rede de entrada (por exemplo, a porta 443).
Tipo: inteiro
Faixa válida: valor mínimo de 1. Valor máximo de 65536.
Obrigatório: não
- ServerProtocol
-
Especifica o protocolo que o servidor de armazenamento de objetos utiliza para se comunicar.
Tipo: String
Valores válidos:
HTTPS | HTTPObrigatório: não
- Subdirectory
-
Especifica o prefixo de objeto do servidor de armazenamento de objetos. Se for um local de origem, DataSync apenas copiará objetos com esse prefixo. Se for um local de destino, DataSync gravará todos os objetos do com esse prefixo.
Tipo: String
Restrições de tamanho: tamanho máximo de 4096.
Padrão:
^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$Obrigatório: não
- Tags
-
Especifica o par de chave-valor que representa uma etiqueta que você deseja adicionar ao recurso. Tags ajudam a gerenciar, filtrar e procurar recursos. Recomendamos criar 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
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
-
Especifica o ARN da localização do sistema de armazenamento de objetos que você cria.
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
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:
