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á.
CreateGateway
Cria um gateway de backup. Depois de criar um gateway, você poderá associá-lo a um servidor usando a operação AssociateGatewayToServer
.
Sintaxe da Solicitação
{
"ActivationKey": "string
",
"GatewayDisplayName": "string
",
"GatewayType": "string
",
"Tags": [
{
"Key": "string
",
"Value": "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.
A solicitação aceita os dados a seguir no formato JSON.
- ActivationKey
-
A chave de ativação do gateway criado.
Tipo: sequência
Restrições de Tamanho: Tamanho Mínimo 1. Tamanho máximo de 50.
Padrão:
^[0-9a-zA-Z\-]+$
Exigido: Sim
- GatewayDisplayName
-
O nome de exibição do gateway criado.
Tipo: sequência
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.
Padrão:
^[a-zA-Z0-9-]*$
Exigido: Sim
- GatewayType
-
O tipo de gateway criado.
Tipo: sequências
Valores Válidos:
BACKUP_VM
Obrigatório: Sim
- Tags
-
Uma lista de até 50 tags a serem atribuídas ao gateway. Cada tag é um par de chave/valor.
Tipo: matriz de objetos Tag
Obrigatório: Não
Sintaxe da Resposta
{
"GatewayArn": "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.
- GatewayArn
-
O Nome do recurso da Amazon (ARN) do gateway criado.
Tipo: sequência
Restrições de tamanho: tamanho mínimo de 50. Comprimento máximo de 180.
Padrão:
^arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+$
Erros
Para obter informações sobre os erros comuns a todas as ações, consulte Erros comuns.
- InternalServerException
-
A operação não teve êxito porque ocorreu um erro interno. Tente novamente mais tarde.
Código de Status HTTP: 500
- ThrottlingException
-
O TPS foi limitado para proteger contra altos volumes de solicitações intencionais ou não intencionais.
Código de Status HTTP: 400
- ValidationException
-
A operação não teve êxito porque ocorreu um erro de validação.
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 da linguagem, consulte o seguinte: