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 V3/ VPC/ Consulta de los detalles acerca de una VPC

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

Ver PDF

Consulta de los detalles acerca de una VPC

Función

Esta API se utiliza para consultar los detalles sobre una VPC.

URI

GET /v3/{project_id}/vpc/vpcs/{vpc_id}

**Tabla 1** Descripción del parámetro
Parámetro	Obligatorio	Tipo	Descripción
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.
vpc_id	Sí	String	ID de la VPC

Parámetro de solicitud

No hay

Ejemplo de la solicitud

Consulta de los detalles acerca de una VPC

"GET https://{Endpoint}/v3/{project_id}/vpc/vpcs/99d9d709-8478-4b46-9f3f-2206b1023fd3"

Parámetro de respuesta

**Tabla 2** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
request_id	String	ID de solicitud
vpc	Vpc object	Cuerpo de respuesta de VPC

**Tabla 3** Vpc
Parámetro	Tipo	Descripción
id	String	El ID de VPC, que identifica de forma única la VPC El valor está en formato UUID con guiones (-).
name	String	Nombre de la VPC 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 la VPC. El valor no puede contener más de 255 caracteres y no puede contener corchetes angulares (< o >).
cidr	String	Bloques CIDR de VPC disponibles Rango de valores: 10.0.0.0/8-10.255.255.240/28 172.16.0.0/12-172.31.255.240/28 192.168.0.0/16-192.168.255.240/28 Si cidr no se especifica, el valor predeterminado es "". El valor debe estar en formato CIDR IPv4, por ejemplo 192.168.0.0/16.
extend_cidrs	Array of strings	Bloques de CIDR secundarios de las VPC Actualmente, solo se admiten bloques CIDR IPv4.
status	String	Estado de la VPC Rango de valores: PENDING: Se está creando la VPC. ACTIVE: La VPC se ha creado correctamente.
project_id	String	ID del proyecto al que pertenece la VPC
enterprise_project_id	String	ID del proyecto de empresa al que pertenece la VPC El valor es 0 o una string que contiene un máximo de 36 caracteres en formato UUID con guiones (-). El valor 0 indica el proyecto de empresa predeterminado.
created_at	String	Hora en que se crea la VPC Tiempo de UTC en el formato de aaaa-MM-ddTHH:mmss
updated_at	String	Hora en que se actualiza la VPC Tiempo de UTC en el formato de aaaa-MM-ddTHH:mmss
cloud_resources	Array of CloudResource objects	Tipo y número de recursos asociados con la VPC Actualmente, solo se devuelven tabla de rutas y subredes de la VPC. El número de virsubnets es el número total de subredes IPv4 e IPv6.
tags	Array of Tag objects	Etiquetas de VPC. Para obtener más información, consulte los objetos de etiqueta. Rango de valores: 0 a 10 pares clave-valor de etiqueta

**Tabla 4** CloudResource
Parámetro	Tipo	Descripción
resource_type	String	Tipo de recurso
resource_count	Integer	Número de recursos

**Tabla 5** Etiqueta
Parámetro	Tipo	Descripción
key	String	Clave de la etiqueta Rango de valores: Una clave de etiqueta contiene un máximo de 36 caracteres de Unicode. Una clave de etiqueta no se puede dejar en blanco. No puede contener caracteres de ASCII no imprimibles (0–31) o los siguientes caracteres especiales: *,<,>,,=
value	String	Valor de la etiqueta Rango de valores: Un valor de etiqueta contiene un máximo de 43 caracteres de Unicode y se puede dejar en blanco. Un valor de etiqueta no puede contener caracteres de ASCII no imprimibles (0–31) o los siguientes caracteres especiales: *,<,>,,=

Ejemplo de la respuesta

{
    "request_id": "84eb4f775d66dd916db121768ec55626", 
    "vpc": {
        "id": "0552091e-b83a-49dd-88a7-4a5c86fd9ec3", 
        "name": "name-test", 
        "description": "description-test", 
        "cidr": "192.168.0.0/16", 
        "extend_cidrs": [
            "21.8.0.0/16"
        ], 
        "enterprise_project_id": "0", 
        "tags": [
            {
                "key": "key", 
                "value": "value"
            }
        ], 
        "cloud_resources": [
            {
                "resource_type": "routetable", 
                "resource_count": 1
            }
        ], 
        "status": "ACTIVE", 
        "project_id": "060576782980d5762f9ec014dd2f1148", 
        "created_at": "2018-03-23T09:26:08", 
        "updated_at": "2018-08-24T08:49:53"
    }
}