Creación de una red
Función
Esta API se utiliza para crear una red.
URI
POST /v2.0/networks
Mensaje de solicitud
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| network | network object | Sí | Especifica la red. Para obtener más información, véase Tabla 2. |
| Atributo | Obligatorio | Tipo | Descripción |
|---|---|---|---|
| name | No | String | Especifica el nombre de red. El nombre no puede ser el mismo que el valor admin_external_net. |
| admin_state_up | No | Boolean | Especifica el estado administrativo. El valor solo puede ser true. |
| shared | No | Boolean | Especifica si la regla del firewall puede ser compartida por diferentes tenants. |
| provider:network_type | No | String | Especifica el tipo de red. Solo se admiten las redes VXLAN y GENEVE. Este es un atributo extendido. Los tenants solo pueden crear redes cuyo tipo sea geneve. |
| port_security_enabled | No | 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. |
Ejemplo de la solicitud
POST https://{Endpoint}/v2.0/networks
{
"network": {
"name": "network-test",
"shared": false,
"admin_state_up": true
}
} Mensaje de la respuesta
| Parámetro | Tipo | Descripción |
|---|---|---|
| network | network object | Especifica la red. Para obtener más información, véase Tabla 4. |
| 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 identificadores 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 tenants. |
| 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 tenants solo pueden crear redes cuyo tipo sea geneve. |
| availability_zone_hints | Array of 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 | Array of 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 la respuesta
{
"network": {
"id": "c360322d-5315-45d7-b7d2-481f98c56edb",
"name": "network-test",
"status": "ACTIVE",
"shared": false,
"subnets": [],
"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-09-20T01:53:18",
"updated_at": "2018-09-20T01:53:20"
}
} Código de estado
Véase Códigos de estado.
Código de error
Véase Códigos de error.
