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 2023-02-03 GMT+08:00

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

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

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"
    }
}

Código de estado

Véase Códigos de estado.

Código de error

Véase Códigos de error.