Actualización más reciente 2025-08-25 GMT+08:00

Actualiza un grupo de direcciones IP

Función

Esta API se utiliza para actualizar un grupo de direcciones IP.

URI

PUT /v3/{project_id}/vpc/address-groups/{address_group_id}

**Tabla 1** Descripción del parámetro
Parámetro	Obligatorio	Tipo	Descripción
address_group_id	Sí	String	ID de grupo de direcciones IP, que identifica de forma exclusiva al grupo de direcciones IP.
project_id	Sí	String	ID del proyecto. Para obtener más información sobre cómo obtener el ID del proyecto, consulte Obtención de un ID de proyecto.

Parámetro de solicitud

**Tabla 2** Parámetro del cuerpo de la solicitud
Parámetro	Obligatorio	Tipo	Descripción
dry_run	No	Boolean	Si solo se debe comprobar la solicitud. El valor puede ser: true: Se enviará una solicitud de comprobación y no se actualizará ningún grupo de direcciones IP. Los elementos de comprobación incluyen parámetros obligatorios, formato de solicitud y restricciones. Si la comprobación falla, se devolverá un error. Si la comprobación tiene éxito, se devolverá el código de respuesta 202. false (el valor predeterminado): Se enviará una solicitud y se actualizará un grupo de direcciones IP.
address_group	Sí	UpdateAddressGroupOption object	Cuerpo de solicitud para actualizar un grupo de direcciones IP

**Tabla 3** UpdateAddressGroupOption
Parámetro	Obligatorio	Tipo	Descripción
name	No	String	Nombre del grupo de direcciones IP El valor no puede contener más de 64 caracteres, incluidos letras, dígitos, guiones bajos (_), guiones (-) y puntos (.).
description	No	String	Proporciona información adicional sobre el grupo de direcciones IP. El valor no puede contener más de 255 caracteres. El valor no puede contener los corchetes angulares (< o >).
ip_set	No	Array of strings	Conjuntos de direcciones IP en un grupo de direcciones IP Intervalo de valores: una única dirección IP, intervalo de direcciones IP o bloque CIDR El número máximo predeterminado de conjuntos de direcciones IP, incluidas las direcciones IP, los intervalos de direcciones IP y los bloques CIDR, en un grupo de direcciones IP es 20.

Ejemplo de la solicitud

Actualización de un grupo de direcciones IP

"PUT https://{endpoint}/v3/b2782e6708b8475c993e6064bc456bf8/vpc/address-groups/dd18a501-fcd5-4adc-acfe-b0e2384baf08"

{
    "address_group": {
        "name": "vkvgykvsvhjaaaa1", 
        "ip_set": [
            "192.168.3.2", 
            "192.168.3.40", 
            "192.168.3.41", 
            "192.168.3.42", 
            "192.168.3.43", 
            "192.168.3.20-192.168.3.100", 
            "192.168.5.0/24"
        ], 
        "description": "xxxxxxxxxx"
    }
}

Parámetro de respuesta

Cuando el código de estado es de 200, los parámetros de respuesta son los siguientes:

**Tabla 4** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
request_id	String	ID de solicitud
address_group	AddressGroup object	Cuerpo de respuesta para actualizar un grupo de direcciones IP

**Tabla 5** AddressGroup
Parámetro	Tipo	Descripción
id	String	ID de grupo de direcciones IP, que identifica de forma única al grupo de direcciones IP El valor es una string en formato UUID.
name	String	Nombre del grupo de direcciones IP El valor no puede contener más de 64 caracteres, incluidos letras, dígitos, guiones bajos (_), guiones (-) y puntos (.).
description	String	Proporciona información adicional sobre el grupo de direcciones IP. El valor no puede contener más de 255 caracteres. El valor no puede contener los corchetes angulares (< o >).
ip_set	Array of strings	Conjuntos de direcciones IP en un grupo de direcciones IP Intervalo de valores: una única dirección IP, intervalo de direcciones IP o bloque CIDR El número máximo predeterminado de conjuntos de direcciones IP, incluidas las direcciones IP, los intervalos de direcciones IP y los bloques CIDR, en un grupo de direcciones IP es 20.
ip_version	Integer	Si se trata de un grupo de direcciones IPv4 o IPv6 El valor puede ser: 4: grupo de direcciones IPv4 6: grupo de direcciones IPv6
created_at	String	Hora en que se crea el grupo de direcciones IP Tiempo de UTC en el formato de aaaa-MM-ddTHH:mmss El tiempo se genera automáticamente.
updated_at	String	Hora en la que se actualizó por última vez el grupo de direcciones IP Tiempo de UTC en el formato de aaaa-MM-ddTHH:mmss El tiempo se genera automáticamente.
tenant_id	String	ID del proyecto al que pertenece el grupo de direcciones IP

Ejemplo de la respuesta

Cuando el código de estado es de 200, los parámetros de respuesta son los siguientes:

Respuesta normal para la operación PUT de la API para actualizar un grupo de direcciones IP

{
    "address_group": {
        "id": "dd18a501-fcd5-4adc-acfe-b0e2384baf08", 
        "name": "vkvgykvsvhjaaaa1", 
        "tenant_id": "b2782e6708b8475c993e6064bc456bf8", 
        "ip_version": 4, 
        "ip_set": [
            "192.168.5.0/24", 
            "192.168.3.20-192.168.3.100", 
            "192.168.3.43", 
            "192.168.3.42", 
            "192.168.3.41", 
            "192.168.3.40", 
            "192.168.3.2"
        ], 
        "created_at": "2019-06-28T02:06:38", 
        "updated_at": "2019-06-28T02:14:01", 
        "description": "xxxxxxxxxx"
    }, 
    "request_id": "5bbd1640-fa68-4362-9a5c-30c4809958e0"
}

Código de estado

Véase Códigos de estado.

Código de error

Véase Códigos de error.

Tema principal: Grupo de direcciones IP