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 nativa de OpenStack Neutron (V2.0)/ Subred/ Consulta de una subred

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

Ver PDF

Consulta de una subred

Función

Esta API se utiliza para consultar detalles sobre una subred.

URI

GET /v2.0/subnets/{subnet_id}

Mensaje de solicitud

Ninguno

Ejemplo de solicitud

GET https://{Endpoint}/v2.0/subnets/011fc878-5521-4654-a1ad-f5b0b5820302

Mensaje de respuesta

**Tabla 1** Parámetro de respuesta
Parámetro	Tipo	Descripción
subnet	subnet object	Especifica la subred. Para más detalles, consulte Tabla 2.

**Tabla 2** Objetos de **subnet**
Atributo	Tipo	Descripción
id	String	Especifica el ID de subred. Este parámetro no es obligatorio cuando consulta subredes.
name	String	Especifica el nombre de subred.
ip_version	Integer	Especifica la versión de la dirección IP. Versiones compatibles: IPv4
ipv6_address_mode	String	Especifica el modo de direccionamiento IPv6. Solo se admite dhcpv6-stateful.
ipv6_ra_mode	String	Especifica el modo de difusión de ruta IPv6. Solo se admite dhcpv6-stateful.
network_id	String	Especifica el ID de la red a la que pertenece la subred.
cidr	String	Especifica el formato CIDR. Sólo se admiten las direcciones IPv4 de los rangos 10.0.0.0/8, 172.16.0.0/12 y 192.168.0.0/16. La máscara de subred no puede ser mayor que 28. Este parámetro no se puede establecer si el valor de ip_version es 6.
gateway_ip	String	La dirección IP del gateway no puede entrar en conflicto con las direcciones IP configuradas para allocation_pools. Este atributo no se puede modificar.
allocation_pools	Matriz de objetos de allocation_pool	Especifica el grupo de direcciones IP disponible. Para más detalles, consulte Tabla 3. Ejemplo: [ { "start": "10.0.0.2", "end": "10.0.0.251"} ] Las tres últimas y las primeras direcciones IP en cada subred son las reservadas por el sistema. Por ejemplo, en la subred 192.168.1.0/24, el sistema reserva las direcciones IP 192.168.1.0, 192.168.1.253, 192.168.1.254, y 192.168.1.255. [{"start": "2001:db8:a583:9::2", "end": "2001:db8:a583:9:ffff:ffff:ffff:fffc"}] En la subred IPv6 2001:db8:a583:9::/64, direcciones IP 2001:db8:a583:9::1, 2001:db8:a583:9:ffff:ffff:ffff:fffd, 2001:db8:a583:9:ffff:ffff:ffff:fffe, y 2001:db8:a583:9:ffff:ffff:ffff:ffff están reservados por el sistema. De forma predeterminada, las direcciones IP reservadas por el sistema no se encuentran en el grupo de direcciones IP especificado por allocation_pool. Al actualizar un grupo de direcciones IP, el valor de allocation_pool no puede contener direcciones IP de gateway ni de difusión.
dns_nameservers	Matriz de strings	Especifica la dirección del servidor DNS. Ejemplo: "dns_nameservers": ["8.xx.xx.8","8.xx.xx.4"]
host_routes	Matriz de objetos de host_route	Especifica las rutas de VM estáticas. Para más detalles, consulte Tabla 4. No se admiten rutas estáticas y la información introducida se ignorará.
tenant_id	String	Especifica el ID del proyecto.
enable_dhcp	Boolean	Especifica si se va a habilitar la función DHCP. El valor false indica que la función DHCP no está habilitada. El valor solo puede ser true.
project_id	String	Especifica el ID del proyecto. Para obtener más información sobre cómo obtener un ID de proyecto, consulte Obtención de un ID de proyecto.
created_at	String	Especifica la hora (UTC) en la que se crea la subred. Formato: aaaa-MM-ddTHH:mm:ss
updated_at	String	Especifica la hora (UTC) cuando se actualiza la subred. Formato: aaaa-MM-ddTHH:mm:ss

**Tabla 3** Objetos de **allocation_pool**
Parámetro	Tipo	Observaciones
start	String	Especifica la dirección IP inicial de un grupo de red.
end	String	Especifica la dirección IP final de un grupo de red.

**Tabla 4** Objetos de **host_route**
Parámetro	Tipo	Observaciones
destination	String	Especifica la subred de destino de una ruta.
nexthop	String	Especifica la dirección IP del salto siguiente de una ruta.

Ejemplo de respuesta

{
    "subnet": {
        "name": "kesmdemeet",
        "cidr": "172.16.236.0/24",
        "id": "011fc878-5521-4654-a1ad-f5b0b5820302",
        "enable_dhcp": true,
        "network_id": "48efad0c-079d-4cc8-ace0-dce35d584124",
        "tenant_id": "bbfe8c41dd034a07bebd592bf03b4b0c",
        "project_id": "bbfe8c41dd034a07bebd592bf03b4b0c",
        "dns_nameservers": [],
        "allocation_pools": [
            {
                "start": "172.16.236.2",
                "end": "172.16.236.251"
            }
        ],
        "host_routes": [],
        "ip_version": 4,
        "gateway_ip": "172.16.236.1",
        "created_at": "2018-03-26T08:23:43",
        "updated_at": "2018-03-26T08:23:44"
    }
}