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.