Creación de una subred
Función
Esta API se utiliza para crear una subred.
URI
POST /v2.0/subnets
Parámetros de solicitud
Parámetro |
Tipo |
Obligatorio |
Descripción |
---|---|---|---|
subnet |
subnet object |
Sí |
Especifica la subred. Para obtener más información, véase Tabla 2. |
Atributo |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
name |
No |
String |
Especifica el nombre de la subred. |
ip_version |
No |
Integer |
Especifica la versión de la dirección IP. Versiones compatibles: IPv4 |
ipv6_address_mode |
No |
String |
Especifica el modo de direccionamiento IPv6. Solo se admite dhcpv6-stateful. |
ipv6_ra_mode |
No |
String |
Especifica el modo de difusión de ruta IPv6. Solo se admite dhcpv6-stateful. |
network_id |
Sí |
String |
Especifica el ID de la red a la que pertenece la subred. |
cidr |
Sí |
String |
Especifica el formato de 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. La máscara IPv6 no puede ser mayor que 128. |
gateway_ip |
No |
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 |
No |
Array of allocation_pool objects |
Especifica el grupo de direcciones IP disponible. Para obtener más información, véase 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 IPv4 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 están en el grupo de direcciones IP especificado por allocation_pool. Al actualizar un grupo de direcciones IP, el valor allocation_pool no puede contener ni gateway ni direcciones IP de difusión. |
dns_nameservers |
No |
Array of strings |
Especifica la dirección del servidor DNS. Instrucciones: Ejemplo: "dns_nameservers": ["8.xx.xx.8","8.xx.xx.4"] Se admite un máximo de cinco direcciones de servidor DNS. Si este parámetro se deja vacío, el valor predeterminado es null. Para obtener instrucciones acerca de cómo obtener una dirección de servidor DNS privado, vea ¿Cuáles son las direcciones de servidor DNS privado proporcionadas por el servicio DNS? |
host_routes |
No |
Array of host_route objects |
Especifica las rutas de VM estáticas. Para obtener más información, véase Tabla 4. No se admiten las rutas estáticas y la información introducida se ignorará. |
enable_dhcp |
No |
Boolean |
Especifica si se va a habilitar la función de DHCP. El valor false indica que la función DHCP no está habilitada. El valor solo puede ser true. |
Ejemplo de la solicitud
POST https://{Endpoint}/v2.0/subnets { "subnet": { "name": "subnet-test", "network_id": "0133cd73-34d4-4d4c-bf1f-e65b24603206", "cidr": "172.16.2.0/24", "enable_dhcp": true } }
Parámetros de respuesta
Parámetro |
Tipo |
Descripción |
---|---|---|
subnet |
subnet object |
Especifica la subred. Para obtener más información, véase Tabla 6. |
Atributo |
Tipo |
Descripción |
---|---|---|
id |
String |
Especifica el ID de subred. Este parámetro no es obligatorio cuando consulta las subredes. |
name |
String |
Especifica el nombre de la subred. |
ip_version |
Integer |
Especifica la versión de la dirección IP. Versiones compatibles: IPv4 e IPv6 |
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 de CIDR. Solo se admiten las direcciones de los segmentos de red 10.0.0.0/8, 172.16.0.0/12 y 192.168.0.0/16. Además, la máscara de subred no puede ser mayor que 28. |
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 |
Array of allocation_pool objects |
Especifica el grupo de direcciones IP disponible. Para obtener más información, consulte los objetos allocation_pool. 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, las direcciones IP 192.168.1.0, 192.168.1.253, 192.168.1.254, y 192.168.1.255 están reservadas por el sistema. De forma predeterminada, las direcciones IP reservadas por el sistema no están en el grupo de direcciones IP especificado por allocation_pool. Al actualizar un grupo de direcciones IP, el valor allocation_pool no puede contener ni gateway ni direcciones IP de difusión. |
dns_nameservers |
Array of strings |
Especifica la dirección del servidor DNS. Ejemplo: "dns_nameservers": ["8.xx.xx.8","8.xx.xx.4"] |
host_routes |
Array of host_route objects |
Especifica las rutas de VM estáticas. Para obtener más información, véase Tabla 8. No se admiten las 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 de 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 la respuesta
{ "subnet": { "name": "subnet-test", "cidr": "172.16.2.0/24", "id": "98bac90c-0ba7-4a63-8995-097da9bead1c", "enable_dhcp": true, "network_id": "0133cd73-34d4-4d4c-bf1f-e65b24603206", "tenant_id": "bbfe8c41dd034a07bebd592bf03b4b0c", "project_id": "bbfe8c41dd034a07bebd592bf03b4b0c", "dns_nameservers": [], "allocation_pools": [ { "start": "172.16.2.2", "end": "172.16.2.251" } ], "host_routes": [], "ip_version": 4, "gateway_ip": "172.16.2.1", "created_at": "2018-09-20T02:02:16", "updated_at": "2018-09-20T02:02:16" } }
Código de estado
Véase Códigos de estado.
Código de error
Consulte Códigos de error.