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

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"
  }
}