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
Parámetro |
Tipo |
Descripción |
---|---|---|
subnet |
subnet object |
Especifica la subred. Para más detalles, consulte Tabla 2. |
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 |
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" } }
Código de estado
Consulte Códigos de estado.
Código de error
Consulte Códigos de error.