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> Virtual Private Cloud> Referencia de la API> API fuera de fecha> Puerto (descartado)> Actualización de un puerto (descartado)

Actualización más reciente 2023-02-03 GMT+08:00

Ver PDF

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	Sí	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	Sí	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
    }
}