Criação de uma conexão hospedada
Função
Essa API é usada por parceiros para criar conexões hospedadas. O parceiro deve ter uma conexão de operações disponível.
URI
POST /v3/{project_id}/dcaas/hosted-connects
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
project_id |
Sim |
String |
Especifica o ID do projeto. |
Parâmetros de solicitação
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
X-Auth-Token |
Sim |
String |
Especifica o token do usuário. Para obter o token, consulte a seção "Obtenção do token do usuário" na Referência de API do Identity and Access Management. O token é o valor de X-Subject-Token no cabeçalho de resposta. Mínimo: 0 Máximo: 10240 |
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
hosted_connect |
Sim |
CreateHostedDirectConnect object |
Especifica os parâmetros para criar uma conexão hospedada. |
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
name |
Não |
String |
Especifica o nome da conexão hospedada. Mínimo: 0 Máximo: 64 |
description |
Não |
String |
Fornece informações complementares sobre a conexão hospedada. Mínimo: 0 Máximo: 128 |
bandwidth |
Não |
Integer |
Especifica o tamanho da largura de banda da conexão hospedada em Mbit/s. Mínimo: 2 Máximo: 400000 |
hosting_id |
Sim |
String |
Especifica o ID da conexão de operações na qual a conexão hospedada é criada. |
vlan |
Sim |
Integer |
Especifica a VLAN pré-alocada à conexão hospedada. Mínimo: 0 Máximo: 3999 |
resource_tenant_id |
Sim |
String |
Especifica o ID do projeto do locatário especificado para o qual uma conexão hospedada deve ser criada. Mínimo: 0 Máximo: 32 |
peer_location |
Não |
String |
Especifica o local do recurso local na outra extremidade da conexão, específico para o nome da rua ou do data center. Mínimo: 0 Máximo: 255 |
Parâmetros de resposta
Código de status: 201
Parâmetro |
Tipo |
Descrição |
---|---|---|
request_id |
String |
Especifica o ID da solicitação. |
hosted_connect |
HostedDirectConnect object |
Especifica os parâmetros para criar uma conexão hospedada. |
Parâmetro |
Tipo |
Descrição |
---|---|---|
id |
String |
Especifica o ID da conexão hospedada. Mínimo: 36 Máximo: 36 |
tenant_id |
String |
Especifica o ID do projeto ao qual a instância pertence. |
name |
String |
Especifica o nome da conexão. Mínimo: 0 Máximo: 64 |
description |
String |
Fornece informações suplementares sobre a conexão. Mínimo: 0 Máximo: 128 |
bandwidth |
Integer |
Especifica a largura de banda da conexão em Mbit/s. Mínimo: 2 Máximo: 400000 |
location |
String |
Especifica informações sobre o local do Direct Connect. Mínimo: 0 Máximo: 255 |
peer_location |
String |
Especifica o local do recurso local na outra extremidade da conexão, específico para o nome da rua ou do data center. Mínimo: 0 Máximo: 255 |
hosting_id |
String |
Especifica o ID da conexão de operações na qual a conexão hospedada é criada. |
provider |
String |
Especifica o provedor da linha alugada. |
admin_state_up |
Boolean |
Especifica o status administrativo, que pode ser true ou false. Padrão: true |
vlan |
Integer |
Especifica a VLAN pré-alocada à conexão hospedada. Mínimo: 0 Máximo: 3999 |
status |
String |
Especifica o status do gateway virtual. O valor pode ser ACTIVE, ERROR, PENDING_CREATE ou PENDING_UPDATE ACTIVE: o gateway virtual é normal. ERROR: o gateway virtual é anormal. PENDING_CREATE: o gateway virtual está sendo criado. PENDING_UPDATE: o gateway virtual está sendo atualizado. Valores de enumeração:
|
apply_time |
String |
Especifica quando a conexão foi solicitada. |
create_time |
String |
Especifica quando a conexão foi criada. |
provider_status |
String |
Especifica o status da linha alugada da transportadora. O status pode ser ACTIVE ou DOWN. Valores de enumeração:
|
Exemplos de solicitações
Criação de uma conexão hospedada
POST https://{dc_endpoint}/v3/6fbe9263116a4b68818cf1edce16bc4f/dcaas/hosted-connects { "hosted_connect" : { "name" : "client-dc-faf1", "description" : "connect to beijing", "resource_tenant_id" : "0605768a3300d5762f82c01180692873", "hosting_id" : "2cfb53be-b05f-40d5-a2f8-3a59ac383836", "vlan" : 441, "bandwidth" : 10 } }
Exemplo de respostas
Código de status: 201
CREATED
{ "hosted_connect" : { "id" : "0278b472-ffa5-4eb3-8c0d-979d479f8ef6", "name" : "client-dc-faf1", "description" : "connect to beijing", "tenant_id" : "0605768a3300d5762f82c01180692873", "hosting_id" : "2cfb53be-b05f-40d5-a2f8-3a59ac383836", "vlan" : 441, "bandwidth" : 10, "location" : "hangzhou", "peer_location" : "", "provider" : "client-dc-faf1%20\n\n", "provider_status" : "ACTIVE", "status" : "ACTIVE", "apply_time" : "2022-07-13T08:25:38.000Z", "admin_state_up" : true, "create_time" : "2022-07-13T08:25:38.000Z" }, "request_id" : "a59a3776faa1d055f8124dc7b0977a90" }
Códigos de status
Código de status |
Descrição |
---|---|
201 |
CREATED |
Códigos de erro
Consulte Códigos de erro.