Consulta de detalles de red
Función
Esta API se utiliza para consultar detalles sobre una red.
Mensaje de solicitud
Ninguno
Ejemplo de solicitud
GET https://{Endpoint}/v2.0/networks/0133cd73-34d4-4d4c-bf1f-e65b24603206
Mensaje de respuesta
|
Parámetro |
Tipo |
Descripción |
|---|---|---|
|
network |
network object |
Especifica la red. Para más detalles, consulte Tabla 3. |
|
Atributo |
Tipo |
Descripción |
|---|---|---|
|
status |
String |
Especifica el estado de la red. El valor puede ser ACTIVE, BUILD, DOWN, o ERROR. |
|
subnets |
Array of strings |
Especifica los ID de las subredes asociadas a esta red. Los ID están en una lista. Solo se puede asociar una subred a cada red. |
|
name |
String |
Especifica el nombre de red. El nombre no puede ser el mismo que el valor admin_external_net. |
|
router:external |
Boolean |
Especifica si la red es una red externa. Este es un atributo extendido. |
|
admin_state_up |
Boolean |
Especifica el estado administrativo. El valor solo puede ser true. |
|
tenant_id |
String |
Especifica el ID del proyecto. |
|
shared |
Boolean |
Especifica si la regla del firewall puede ser compartida por diferentes inquilinos. |
|
id |
String |
Especifica el ID de red. Este parámetro no es obligatorio cuando consulta redes. |
|
provider:network_type |
String |
Especifica el tipo de red. Solo se admiten las redes VXLAN y GENEVE. Este es un atributo extendido. Los tenant solo pueden crear redes cuyo tipo es geneve. |
|
availability_zone_hints |
Matriz de strings |
Especifica las zonas de disponibilidad disponibles para esta red. La versión actual no admite la programación de red entre zonas de disponibilidad. |
|
availability_zones |
Matriz de strings |
Especifica la zona de disponibilidad de esta red. |
|
port_security_enabled |
Boolean |
Especifica si la opción de seguridad está habilitada para el puerto. Si la opción no está habilitada, el grupo de seguridad y la configuración de indagación DHCP de todas las máquinas virtuales de la red no tienen efecto. |
|
dns_domain |
String |
Especifica la dirección de dominio DNS de red privada predeterminada. El sistema establece automáticamente este parámetro y no se le permite configurar ni cambiar el valor del parámetro. |
|
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 red. Formato: aaaa-MM-ddTHH:mm:ss |
|
updated_at |
String |
Especifica la hora (UTC) cuando se actualiza la red. Formato: aaaa-MM-ddTHH:mm:ss |
Ejemplo de respuesta
{
"network": {
"id": "0133cd73-34d4-4d4c-bf1f-e65b24603206",
"name": "3804f26c-7862-43b6-ad3c-48445f42de89",
"status": "ACTIVE",
"shared": false,
"subnets": [
"423796f5-e02f-476f-bf02-2b88c8ddac8b"
],
"availability_zone_hints": [],
"availability_zones": [
"az2.dc2",
"az5.dc5"
],
"admin_state_up": true,
"tenant_id": "bbfe8c41dd034a07bebd592bf03b4b0c",
"project_id": "bbfe8c41dd034a07bebd592bf03b4b0c",
"provider:network_type": "vxlan",
"router:external": false,
"port_security_enabled": true,
"created_at": "2018-03-23T03:51:58",
"updated_at": "2018-03-23T03:51:58"
}
}
Código de estado
Consulte Códigos de estado.
Código de error
Consulte Códigos de error.