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.
Actualización más reciente 2023-02-03 GMT+08:00

Actualización de una red

Función

Esta API se utiliza para actualizar una red.

URI

PUT /v2.0/networks/{network_id}

Tabla 1 describe los parámetros.

Tabla 1 Descripción de parámetros

Nombre

Obligatorio

Descripción

network_id

Especifica el ID de red.

Mensaje de solicitud

Tabla 2 Parámetro de solicitud

Parámetro

Tipo

Obligatorio

Descripción

network

network object

Especifica la red. Para más detalles, consulte Tabla 3.

Debe especificar al menos un atributo al actualizar una red.

Tabla 3 Objetos de network

Atributo

Obligatorio

Tipo

Descripción

name

No

String

Especifica el nombre de red.

El nombre no puede ser el mismo que el valor admin_external_net.

admin_state_up

No

Boolean

Especifica el estado administrativo.

El valor solo puede ser true.

port_security_enabled

No

Boolean

Especifica si la opción de seguridad está habilitada para el puerto. Si la opción no está habilitada, el grupo de seguridad y la configuración de indagación DHCP de todas las máquinas virtuales de la red no tienen efecto.

Ejemplo de solicitud

PUT https://{Endpoint}/v2.0/networks/c360322d-5315-45d7-b7d2-481f98c56edb
{
  "network": {
    "name": "network-test02"
  }
}

Mensaje de respuesta

Tabla 4 Parámetro de respuesta

Parámetro

Tipo

Descripción

network

network object

Especifica la red. Para más detalles, consulte Tabla 5.

Tabla 5 Objetos de network

Atributo

Tipo

Descripción

status

String

Especifica el estado de la red. El valor puede ser ACTIVE, BUILD, DOWN, o ERROR.

subnets

Array of strings

Especifica los ID de las subredes asociadas a esta red. Los ID están en una lista.

Solo se puede asociar una subred a cada red.

name

String

Especifica el nombre de red.

El nombre no puede ser el mismo que el valor admin_external_net.

router:external

Boolean

Especifica si la red es una red externa. Este es un atributo extendido.

admin_state_up

Boolean

Especifica el estado administrativo.

El valor solo puede ser true.

tenant_id

String

Especifica el ID del proyecto.

shared

Boolean

Especifica si la regla del firewall puede ser compartida por diferentes inquilinos.

id

String

Especifica el ID de red.

Este parámetro no es obligatorio cuando consulta redes.

provider:network_type

String

Especifica el tipo de red. Solo se admiten las redes VXLAN y GENEVE. Este es un atributo extendido.

Los inquilinos solo pueden crear redes cuyo tipo es geneve.

availability_zone_hints

Array of strings

Especifica las zonas de disponibilidad disponibles para esta red. La versión actual no admite la programación de red entre zonas de disponibilidad.

availability_zones

Array of strings

Especifica la zona de disponibilidad de esta red.

port_security_enabled

Boolean

Especifica si la opción de seguridad está habilitada para el puerto. Si la opción no está habilitada, el grupo de seguridad y la configuración de indagación DHCP de todas las máquinas virtuales de la red no tienen efecto.

dns_domain

String

Especifica la dirección de dominio DNS de red privada predeterminada. El sistema establece automáticamente este parámetro y no se le permite configurar ni cambiar el valor del parámetro.

project_id

String

Especifica el ID del proyecto. Para obtener más información sobre cómo obtener un ID de proyecto, consulte Obtención de un ID de proyecto.

created_at

String

Especifica la hora (UTC) en la que se crea la red.

Formato: aaaa-MM-ddTHH:mm:ss

updated_at

String

Especifica la hora (UTC) cuando se actualiza la red.

Formato: aaaa-MM-ddTHH:mm:ss

Ejemplo de respuesta

{
    "network": {
        "id": "c360322d-5315-45d7-b7d2-481f98c56edb",
        "name": "network-test02",
        "status": "ACTIVE",
        "shared": false,
        "subnets": [],
        "availability_zone_hints": [],
        "availability_zones": [
            "az2.dc2",
            "az5.dc5"
        ],
        "admin_state_up": true,
        "tenant_id": "bbfe8c41dd034a07bebd592bf03b4b0c",
        "project_id": "bbfe8c41dd034a07bebd592bf03b4b0c",
        "provider:network_type": "vxlan",
        "router:external": false,
        "port_security_enabled": true,
        "created_at": "2018-09-20T01:53:18",
        "updated_at": "2018-09-20T01:55:47"
    }
}

Código de estado

Consulte Códigos de estado.

Código de error

Consulte Códigos de error.