Consulta de detalles de subred
Función
Esta API se utiliza para consultar detalles sobre una subred.
URI
GET /v1/{project_id}/subnets/{subnet_id}
Nombre |
Obligatorio |
Descripción |
---|---|---|
project_id |
Sí |
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. |
subnet_id |
Sí |
Especifica el ID de subred, que identifica de forma exclusiva a la subred. Si utiliza la consola de gestión, el valor de este parámetro es el valor Network ID. |
Mensaje de solicitud
Mensaje de la respuesta
- Parámetro de respuesta
Tabla 2 Parámetro de respuesta Nombre
Tipo
Descripción
subnet
subnet object
Especifica los objetos de subnet.
Tabla 3 Objetos de subnet Nombre
Tipo
Descripción
id
String
Especifica un ID de recurso en formato UUID.
name
String
- Especifica el nombre de la subred.
- El valor puede contener de 1 a 64 caracteres, incluidos letras, dígitos, guiones bajos (_), guiones (-) y puntos (.).
description
String
- Proporciona la información adicional sobre la subred.
- El valor no puede contener más de 255 caracteres y no puede contener los corchetes angulares (< o >).
cidr
String
Especifica el bloque CIDR de subred.
gateway_ip
String
Especifica la dirección de gateway de subred.
ipv6_enable
Boolean
Especifica si se puede crear una subred IPv6.
cidr_v6
String
Especifica el bloque CIDR de subred IPv6. Si la subred es una subred IPv4, este parámetro no se devuelve.
gateway_ip_v6
String
Especifica el gateway de subred IPv6. Si la subred es una subred IPv4, este parámetro no se devuelve.
dhcp_enable
Boolean
Especifica si DHCP está habilitado para la subred.
primary_dns
String
Especifica la dirección IP del servidor DNS 1 en la subred.
secondary_dns
String
Especifica la dirección IP del servidor DNS 2 en la subred.
dnsList
Array of strings
Especifica la lista de direcciones IP de los servidores DNS de la subred.
availability_zone
String
Identifica la AZ a la que pertenece la subred.
vpc_id
String
Especifica el ID de la VPC a la que pertenece la subred.
status
String
- Especifica el estado de la subred.
- El valor puede ser ACTIVE, UNKNOWN o ERROR.
- ACTIVE: indica que la subred se ha asociado a una VPC.
- UNKNOWN: indica que la subred no se ha asociado con una VPC.
- ERROR indica que la subred es anormal.
neutron_network_id
String
Especifica el ID de la red correspondiente (API de OpenStack Neutron).
neutron_subnet_id
String
Especifica el ID de la subred correspondiente (API de OpenStack Neutron).
neutron_subnet_id_v6
String
Especifica el ID de la subred IPv6 (API de OpenStack Neutron). Si la subred es una subred IPv4, este parámetro no se devuelve.
extra_dhcp_opts
Array of extra_dhcp_opt objects
Especifica la dirección del servidor NTP o el tiempo de concesión DHCP configurado para la subred. Para obtener más información, véase Tabla 4.
scope
String
Especifica dónde se utiliza la subred.
Valores:
- center: La subred se utiliza en una AZ central.
- {azId}: La subred se utiliza en una AZ de borde.
tenant_id
String
Especifica el ID del proyecto de empresa.
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) en la que se crea la subred.
- Formato: aaaa-MM-ddTHH:mm:ss
- Ejemplo de la respuesta
{ "subnet": { "id": "4779ab1c-7c1a-44b1-a02e-93dfc361b32d", "name": "subnet", "description": "", "cidr": "192.168.20.0/24", "dnsList": [ "114.xx.xx.114", "114.xx.xx.115" ], "status": "ACTIVE", "vpc_id": "3ec3b33f-ac1c-4630-ad1c-7dba1ed79d85", "gateway_ip": "192.168.20.1", "dhcp_enable": true, "primary_dns": "114.xx.xx.114", "secondary_dns": "114.xx.xx.115", "availability_zone": "aa-bb-cc", "neutron_network_id": "4779ab1c-7c1a-44b1-a02e-93dfc361b32d", "neutron_subnet_id": "213cb9d-3122-2ac1-1a29-91ffc1231a12" , "tenant_id": "087679f0aa80d32a2f4ec0172f5e902b", "created_at": "2022-12-15T02:42:07", "updated_at": "2022-12-15T02:42:07" } }
Código de estado
Véase Códigos de estado.
Código de error
Véase Códigos de error.