Ejemplo 1: Creación de una VPC y una subred para un ECS

Escenarios

Esta sección describe cómo crear una VPC y una subred para un ECS invocando a las API.

Prerrequisitos

Ha planificado la región donde desea crear la VPC y ha obtenido el punto de conexión necesario para invocar a las API. Para obtener más información, véase Puntos de conexión.

Si utiliza un token para la autenticación, debe obtener el token y agregar X-Auth-Token al encabezado de solicitud cuando realice una llamada a la API. Obtenga el token haciendo referencia a Autenticación.

Procedimiento

1. Crear una VPC.
   1. Envía a POST https://VPC endpoint/v1/{project_id}/vpcs. El parámetro project_id indica el ID del proyecto.
   2. Agregue X-Auth-Token al encabezado de solicitud.
   3. Establezca los siguientes parámetros en el cuerpo de la solicitud. Planifique el valor del campo cidr por adelantado.

      {
          "vpc": {
              "name": "vpc", //VPC name
              "cidr": "192.168.0.0/16" //Available subnet in the VPC
          }
      }

   4. Compruebe el mensaje de respuesta.
      • La solicitud se realiza correctamente si se muestra la siguiente respuesta. En la respuesta, el id indica el ID de VPC.

        {
            "vpc": {
                "id": "b6684a27-b049-407d-90b4-c9551f2390e1",
                "name": "vpc",
                "cidr": "192.168.0.0/16",
                "status": "CREATING",
                "routes": []
            }
        }

      • Para obtener más información sobre los códigos de error que se muestran si la solicitud falla, consulte la sección Códigos de error.

2. Ver detalles de la VPC.
   1. Envía a GET https://VPC endpoint/v1/{project_id}/vpcs/{vpc_id}. El parámetro project_id indica el ID del proyecto.
   2. Agregue X-Auth-Token al encabezado de solicitud.
   3. Compruebe el mensaje de respuesta.
      • La solicitud se realiza correctamente si se muestra la siguiente respuesta. En la respuesta, el id indica el ID de VPC.

        {
            "vpc": {
                "id": "b6684a27-b049-407d-90b4-c9551f2390e1",
                "name": "vpc",
                "description": "",
                "cidr": "192.168.0.0/16",
                "status": "OK",
                "enterprise_project_id": "0" ,
                "routes": []
            }
        }

      • Para obtener más información sobre los códigos de error que se muestran si la solicitud falla, consulte la sección Códigos de error.
3. Cree una subred en la VPC.
   1. Envía a POST https://VPC endpoint/v1/{project_id}/subnets. El parámetro project_id indica el ID del proyecto.
   2. Agregue X-Auth-Token al encabezado de solicitud.
   3. Establezca los siguientes parámetros en el cuerpo de la solicitud. Para obtener más información acerca de los valores de dnsList, consulte ¿Cuáles son las direcciones de servidor DNS privado proporcionadas por el servicio DNS? Para obtener más información sobre los valores de availability_zone, consulte Regiones y puntos de conexión.

   4. {
      	"subnet": {
      		"name": "subnet",
      		"description": "",
      		"cidr": "192.168.0.0/24",
      		"gateway_ip": "192.168.0.1",
      		"dhcp_enable": true,
      		"dnsList": ["114.xx.xx.114", "114.xx.xx.115"],
      		"availability_zone": "aa-bb-cc",
      		"vpc_id": "b6684a27-b049-407d-90b4-c9551f2390e1"
      	}
      }

   5. Compruebe el mensaje de respuesta.
      • La solicitud se realiza correctamente si se muestra la siguiente respuesta.

        {
        	"subnet": {
        		"id": "4779ab1c-7c1a-44b1-a02e-93dfc361b32d",
        		"name": "subnet",
        		"description": "",
        		"cidr": "192.168.0.0/24",
        		"dnsList": ["114.xx.xx.114", "1114.xx.xx.115"],
        		"status": "UNKNOWN",
        		"vpc_id": "b6684a27-b049-407d-90b4-c9551f2390e1",
        		"gateway_ip": "192.168.0.1",
        		"dhcp_enable": true,
        		"primary_dns": "114.xx.xx.114",
        		"secondary_dns": "114.xx.xx.115",
        		"availability_zone": "aa-bb-cc",
        		"neutron_network_id": "4779ab1c-7c1a-44b1-a02e-93dfc361b32d",
        		"neutron_subnet_id": "213cb9d-3122-2ac1-1a29-91ffc1231a12",
        		"extra_dhcp_opts": []
        	}
        }

      • Para obtener más información sobre los códigos de error que se muestran si la solicitud falla, consulte la sección Códigos de error.

4. Ver detalles de la subred.
   1. Envía a GET https://VPC endpoint/v1/{project_id}/subnets/{subnet_id}. El parámetro project_id indica el ID del proyecto.
   2. Agregue X-Auth-Token al encabezado de solicitud.
   3. Compruebe el mensaje de respuesta.

      {
      	"subnet": {
      		"id": "4779ab1c-7c1a-44b1-a02e-93dfc361b32d",
      		"name": "subnet",
      		"description": "",
      		"cidr": "192.168.20.0/24",
      		"dnsList": ["114.xx.xx.114", "114.xx.xx.115"],
      		"status": "ACTIVE",
      		"vpc_id": "b6684a27-b049-407d-90b4-c9551f2390e1",
      		"gateway_ip": "192.168.20.1",
      		"ipv6_enable": false,
      		"dhcp_enable": true,
      		"primary_dns": "114.xx.xx.114",
      		"secondary_dns": "114.xx.xx.115",
      		"availability_zone": "aa-bb-cc",
      		"neutron_network_id": "4779ab1c-7c1a-44b1-a02e-93dfc361b32d",
      		"neutron_subnet_id": "213cb9d-3122-2ac1-1a29-91ffc1231a12",
      		"extra_dhcp_opts": []
      	}
      }