Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Central de ajuda/ Direct Connect/ Referência de API/ API/ Conexão/ Criação de uma conexão hospedada
Atualizado em 2023-02-20 GMT+08:00

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

Tabela 1 Parâmetros de caminho

Parâmetro

Obrigatório

Tipo

Descrição

project_id

Sim

String

Especifica o ID do projeto.

Parâmetros de solicitação

Tabela 2 Parâmetros do cabeçalho 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

Tabela 3 Parâmetros de corpo de solicitação

Parâmetro

Obrigatório

Tipo

Descrição

hosted_connect

Sim

CreateHostedDirectConnect object

Especifica os parâmetros para criar uma conexão hospedada.

Tabela 4 CreateHostedDirectConnect

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

Tabela 5 Parâmetros de corpo de resposta

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.

Tabela 6 HostedDirectConnect

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:

  • BUILD
  • PAID
  • APPLY
  • PENDING_SURVEY
  • ACTIVE
  • DOWN
  • ERROR
  • PENDING_DELETE
  • DELETED
  • DENY
  • PENDING_PAY
  • ORDERING
  • ACCEPT
  • REJECTED

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:

  • ACTIVE
  • DOWN

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.