Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.
Centro de ayuda/ Cloud Connect/ Referencia de la API/ API/ Instancia de red/ Creación de una instancia de red
Actualización más reciente 2023-03-06 GMT+08:00
Ver PDF
Compartir

Creación de una instancia de red

Función

Esta API se utiliza para crear una instancia de red.

URI

POST /v3/{domain_id}/ccaas/network-instances

Tabla 1 Parámetros de ruta

Parámetro

Obligatorio

Tipo

Descripción

domain_id

Sí

String

ID de cuenta.

Mínimo: 10

Máximo: 32

Parámetros de solicitud

Tabla 2 Parámetros de cabecera de solicitud

Parámetro

Obligatorio

Tipo

Descripción

X-Auth-Token

Sí

String

Token de usuario.

Mínimo: 0

Máximo: 102400
Tabla 3 Parámetros del cuerpo de solicitud

Parámetro

Obligatorio

Tipo

Descripción

network_instance

Sí

CreateNetworkInstance object

Detalles sobre la instancia de red que se va a crear.
Tabla 4 CreateNetworkInstance

Parámetro

Obligatorio

Tipo

Descripción

name

No

String

Nombre de la instancia de red. El nombre solo puede contener letras, dígitos, guiones bajos (_), guiones (-) y puntos (.).

Mínimo: 0

Máximo: 64

description

No

String

Descripción de la instancia de red. No se admiten los siguientes caracteres especiales: <>

Mínimo: 0

Máximo: 85

type

Sí

String

Tipo de la instancia de red que se va a cargar en la conexión en la nube.

  • vpc: nube privada virtual
  • vgw: gateway virtual

Mínimo: 0

Máximo: 36

instance_id

Sí

String

ID de la VPC o del gateway virtual que se va a cargar en la conexión a la nube.

Mínimo: 0

Máximo: 36

instance_domain_id

No

String

ID de proyecto de la instancia de red. Este parámetro es obligatorio si la instancia de red se carga con otra cuenta.

Mínimo: 0

Máximo: 36

project_id

Sí

String

ID de proyecto de la instancia de red.

Mínimo: 0

Máximo: 36

region_id

Sí

String

ID de región de la instancia de red.

Mínimo: 0

Máximo: 36

cloud_connection_id

Sí

String

ID de conexión en la nube.

Mínimo: 0

Máximo: 36

cidrs

Sí

Array of strings

Lista de rutas anunciadas por la instancia de red.

Mínimo: 0

Máximo: 64

Parámetros de respuesta

Código de estado: 201

Tabla 5 Parámetros del cuerpo de respuesta

Parámetro

Tipo

Descripción

network_instance

NetworkInstance object

Instancia de red.

request_id

String

ID de solicitud.

Mínimo: 0

Máximo: 36
Tabla 6 NetworkInstance

Parámetro

Tipo

Descripción

id

String

ID de instancia de red.

Mínimo: 0

Máximo: 36

name

String

Nombre de instancia de red.

Mínimo: 0

Máximo: 64

description

String

Descripción de la instancia de red.

Mínimo: 0

Máximo: 85

domain_id

String

ID de cuenta.

Mínimo: 10

Máximo: 32

status

String

Estado de la instancia de red.

  • ACTIVE: La operación se ha realizado correctamente
  • PENDING: Pendiente de procesamiento
  • ERROR: Error en la operación

Mínimo: 0

Máximo: 36

created_at

String

Tiempo en el que se creó la instancia de red. Es una hora UTC en el formato aaaa-MM-ddTHH:mm:ss.

updated_at

String

Tiempo en el que se actualizó la instancia de red. Es una hora UTC en el formato aaaa-MM-ddTHH:mm:ss.

type

String

Tipo de instancia de red.

  • vpc: nube privada virtual
  • vgw: gateway virtual

Mínimo: 0

Máximo: 36

cloud_connection_id

String

ID de conexión en la nube.

Mínimo: 0

Máximo: 36

instance_id

String

ID de instancia de red.

Mínimo: 0

Máximo: 36

instance_domain_id

String

ID de cuenta al que pertenece la instancia de red.

Mínimo: 0

Máximo: 36

region_id

String

ID de región al que pertenece la instancia de red.

Mínimo: 0

Máximo: 36

project_id

String

ID de proyecto del tenant al que pertenece la instancia de red.

Mínimo: 0

Máximo: 36

cidrs

Array of strings

Lista de rutas anunciadas por la instancia de red.

Mínimo: 0

Máximo: 64

Ejemplo de las solicitudes

Creación de una instancia de red.

POST https://{cc_endpoint}/v3/{domain_id}/ccaas/network-instances

{
  "network_instance" : {
    "type" : "vpc",
    "region_id" : "br-iaas-odin1",
    "project_id" : "XXX",
    "cloud_connection_id" : "XXX",
    "instance_id" : "XXX",
    "cidrs" : [ "192.168.1.0/24" ]
  }
}

Ejemplo de las respuestas

Código de estado: 201

Se ha creado la instancia de red.

{
  "request_id" : "c8fe3d71352e273915bfbd74ce58368a",
  "network_instance" : {
    "id" : "XXX",
    "name" : "",
    "description" : "",
    "domain_id" : "XXX",
    "created_at" : "2022-06-24T09:33:15Z",
    "updated_at" : "2022-06-24T09:33:16Z",
    "project_id" : "XXX",
    "instance_domain_id" : "",
    "cloud_connection_id" : "XXX",
    "region_id" : "br-iaas-odin1",
    "type" : "vpc",
    "instance_id" : "XXX",
    "cidrs" : [ "192.168.1.0/24" ],
    "status" : "ACTIVE"
  }
}

Códigos de estado

Código de estado

Descripción

201

Se ha creado la instancia de red.

Códigos de error

Consulte Códigos de error.

Tema principal: Instancia de red