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 un puerto (descartado)

Función

Esta API se utiliza para actualizar un puerto.

URI

PUT /v1/ports/{port_id}

Tabla 1 describe los parámetros.
Tabla 1 Descripción del parámetro

Nombre

Obligatorio

Descripción

port_id

Especifica el ID de puerto, que identifica el puerto de forma exclusiva.

Mensaje de solicitud

  • Parámetro de solicitud
    Tabla 2 Parámetro de solicitud

    Nombre

    Obligatorio

    Tipo

    Descripción

    port

    port object

    Especifica los objetos del puerto. Para obtener más información, véase Tabla 3.

    Tabla 3 Descripción del campo port

    Nombre

    Obligatorio

    Tipo

    Descripción

    name

    No

    String

    • Especifica el nombre del puerto.
    • El valor no puede contener más de 255 caracteres. Este parámetro se deja en blanco por defecto.

    security_groups

    No

    Array of strings

    Especifica el UUID del grupo de seguridad.

    allowed_address_pairs

    No

    Array of allow_address_pair objects

    • Especifica un conjunto de cero o más pares de direcciones permitidos. Un par de direcciones consiste en una dirección IP y una dirección de MAC. Para obtener más información, consulte el parámetro allow_address_pair en Tabla 4.
    • Restricciones:
      • La dirección IP no puede ser 0.0.0.0.
      • Configure un grupo de seguridad dedicado para el puerto si el parámetro allowed_address_pairs tiene un bloque CIDR grande (máscara de subred menor que 24).
      • Si el valor de allowed_address_pairs es de 1.1.1.1/0 la comprobación de origen/destino está deshabilitada.
      • Para asignar una dirección IP virtual a un ECS, la dirección IP configurada en allowed_address_pairs debe ser una dirección IP NIC ECS existente. De lo contrario, la dirección IP virtual no se puede utilizar para la comunicación.

    extra_dhcp_opts

    No

    Array of extra_dhcp_opt objects

    Especifica la opción extendida (atributo extendido) de DHCP. Para obtener más información, véase Tabla 5.

    Tabla 4 Objeto de allow_address_pair

    Nombre

    Tipo

    Descripción

    ip_address

    String

    • Especifica la dirección IP.
    • No se puede establecer en 0.0.0.0.
    • Configure un grupo de seguridad dedicado para el puerto si el parámetro allowed_address_pairs tiene un bloque CIDR grande (máscara de subred menor que 24).

    mac_address

    String

    Especifica la dirección de MAC.

    Tabla 5 Objeto de extra_dhcp_opt

    Nombre

    Obligatorio

    Tipo

    Descripción

    opt_name

    No

    String

    Especifica el nombre de la opción.

    opt_value

    No

    String

    Especifica el valor de la opción.

  • Ejemplo de la solicitud
    {
        "port": {
            "name": "adc"
        }
    }

Mensaje de la respuesta

  • Parámetro de respuesta
    Tabla 6 Parámetro de respuesta

    Nombre

    Tipo

    Descripción

    port

    port object

    Especifica los objetos del puerto. Para obtener más información, véase Tabla 7.

    Tabla 7 Descripción del campo port

    Nombre

    Tipo

    Descripción

    id

    String

    Especifica el ID de puerto, que identifica el puerto de forma exclusiva.

    name

    String

    • Especifica el nombre del puerto.
    • El valor no puede contener más de 255 caracteres. Este parámetro se deja en blanco por defecto.

    network_id

    String

    • Especifica el ID de la red a la que pertenece el puerto.
    • El ID de red debe ser real en el entorno de red.

    admin_state_up

    Boolean

    • Especifica el estado administrativo del puerto.
    • El valor solo puede ser true y el valor predeterminado es true.

    mac_address

    String

    • Especifica la dirección de MAC del puerto.
    • El sistema establece automáticamente este parámetro y no se le permite configurar el valor del parámetro.

    fixed_ips

    Array of fixed_ip objects

    • Especifica la dirección IP del puerto. Por ejemplo, el valor es "fixed_ips": [{"subnet_id": "4dc70db6-cb7f-4200-9790-a6a910776bba", "ip_address": "192.169.25.79"}].
    • Un puerto solo admite una dirección IP fija que no se puede cambiar.

    device_id

    String

    • Especifica el ID del dispositivo al que pertenece el puerto.
    • El sistema establece automáticamente este parámetro y no se le permite configurar ni cambiar el valor del parámetro.

    device_owner

    String

    • Especifica el dispositivo perteneciente, que puede ser el servidor DHCP, el router, el balanceador de carga o Nova.
    • El sistema establece automáticamente este parámetro y no se le permite configurar ni cambiar el valor del parámetro.

    tenant_id

    String

    Especifica el ID del proyecto.

    status

    String

    • Especifica el estado del puerto. El estado de un puerto HANA SR-IOV VM siempre es DOWN.
    • El valor puede ser ACTIVE, BUILD o DOWN.

    security_groups

    Array of strings

    Especifica el UUID del grupo de seguridad (atributo extendido).

    allowed_address_pairs

    Array of allow_address_pairobjects

    • Especifica un conjunto de cero o más pares de direcciones permitidos. Un par de direcciones consiste en una dirección IP y una dirección de MAC. Este atributo se extiende. Para obtener más información, consulte el parámetro allow_address_pair en Tabla 9.
    • La dirección IP no puede ser 0.0.0.0.
    • Configure un grupo de seguridad dedicado para el puerto si el parámetro allowed_address_pairs tiene un bloque CIDR grande (máscara de subred menor que 24).
    • Si el valor de allowed_address_pairs es de 1.1.1.1/0 la comprobación de origen/destino está deshabilitada.

    extra_dhcp_opts

    Array of extra_dhcp_opt objects

    Especifica la opción extendida (atributo extendido) de DHCP. Para obtener más información, véase Tabla 10.

    binding:vif_details

    Object

    Especifica los detalles de VIF. El parámetro ovs_hybrid_plug especifica si se utiliza el modo híbrido OVS/puente.

    binding:profile

    Object

    Especifica la configuración definida por el usuario. Este es un atributo extendido.

    Instrucciones:

    • El campo internal_elb es de tipo boolean y está disponible para tenants comunes. Establezca el valor de este parámetro en true solo cuando asigne una dirección IP virtual a un balanceador de carga de red interno. Los tenants comunes no tienen permiso para cambiar el valor de este campo, que es mantenido por el sistema.

      Por ejemplo:

      {"internal_elb": true}

    • El campo disable_security_groups es de tipo boolean y está disponible para tenants comunes. El valor predeterminado es false. En escenarios de comunicación de alto rendimiento, puede establecer el valor del parámetro en true, lo que hace que este parámetro esté disponible para los tenants comunes. Puede especificar este parámetro al crear un puerto. Actualmente, el valor de este parámetro solo se puede establecer en true.

      Por ejemplo:

      {"disable_security_groups": true },

      Actualmente, el valor solo se puede establecer en true. Cuando el valor se establece en true, la función FWaaS no tiene efecto.

    binding:vnic_type

    String

    • Especifica el tipo de vNIC enlazado.
    • El valor puede ser normal o direct. El parámetro normal indica la conmutación de software. El parámetro direct indica el paso a través de SR-IOV PCIe, que no es compatible.

    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 indagación DHCP no tienen efecto. El valor predeterminado es true.

    Tabla 8 Objeto de fixed_ip

    Nombre

    Tipo

    Descripción

    subnet_id

    String

    • Especifica el ID de subred.
    • No se puede cambiar el valor del parámetro.

    ip_address

    String

    Especifica la dirección IP del puerto.

    Tabla 9 Objeto de allow_address_pair

    Nombre

    Tipo

    Descripción

    ip_address

    String

    • Especifica la dirección IP.
    • No se puede establecer en 0.0.0.0.
    • Configure un grupo de seguridad dedicado para el puerto si el parámetro allowed_address_pairs tiene un bloque CIDR grande (máscara de subred menor que 24).

    mac_address

    String

    Especifica la dirección de MAC.

    Tabla 10 Objeto de extra_dhcp_opt

    Nombre

    Tipo

    Descripción

    opt_name

    String

    Especifica el nombre de la opción.

    opt_value

    String

    Especifica el valor de la opción.

  • Ejemplo de la respuesta
    {
        "port": {
            "id": "7204e0da-40de-4207-a536-6f59b84f6f0e",
            "name": "adc",
            "status": "DOWN",
            "admin_state_up": "true",
            "fixed_ips": [
                {
                    "subnet_id": "689156ca-038f-4478-b265-fd26aa8bbe31",
                    "ip_address": "192.168.0.9"
                }
            ],
            "mac_address": "fa:16:3e:d7:f2:6c",
            "network_id": "b4152e98-e3af-4e49-bb7f-7766e2b5ec63",
            "tenant_id": "caa6cf4337ea47fb823b15709ebe8591",
            "device_id": "",
            "device_owner": "",
            "security_groups": [
                "59b39002-e79b-4bac-8e27-aa884ab1beb6"
            ],
            "extra_dhcp_opts": [],
            "allowed_address_pairs": [],
            "binding:vnic_type": "normal",
            "binding:vif_details": {},
            "binding:profile": {},
            "port_security_enabled":true
        }
    }

Código de estado

Véase Códigos de estado.

Código de error

Véase Códigos de error.