Es posible que parte de la información de esta página (o toda) no se aplique a Cloud de Confiance de S3NS. Consulta Diferencias con Google Cloud para obtener más información.

Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

Crea una instancia que use Cloud RDMA

En este documento, se explica cómo crear instancias de procesamiento con interfaces de red de RDMA de Cloud (IRDMA) para lograr una comunicación de baja latencia y alto rendimiento entre instancias.

Para crear una instancia habilitada para RDMA de Cloud, sigue estos pasos:

Crea una política de posición compacta.
Crea las redes de nube privada virtual, incluida una red de VPC estándar (GVNIC o IDPF) y una red de VPC de Falcon (IRDMA).
Crea la instancia con las interfaces de red y la política de posición.

Para obtener instrucciones sobre cómo crear instancias optimizadas para aceleradores (como A4X Max, A4X, A4 o A3 Ultra) que usan RDMA, consulta Crea una instancia optimizada para IA.

Antes de comenzar

Si aún no lo hiciste, configura la autenticación. La autenticación verifica tu identidad para acceder a los servicios y las APIs de Cloud de Confiance by S3NS . Para ejecutar código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine seleccionando una de las siguientes opciones:
Selecciona la pestaña que corresponda a la forma en que planeas usar las muestras de esta página:
Console

Cuando usas la consola de Cloud de Confiance para acceder a los servicios y las APIs de Cloud de Confiance by S3NS , no necesitas configurar la autenticación.
gcloud
1. Instala Google Cloud CLI y, luego, accede a gcloud CLI con tu identidad federada. Después de acceder, inicializa Google Cloud CLI con el siguiente comando:
  gcloud init
  Nota: Si ya instalaste gcloud CLI antes, asegúrate de tener la versión más reciente ejecutando gcloud components update.
Configura una región y una zona predeterminadas.

REST

Para usar las muestras de la API de REST incluidas en esta página en un entorno de desarrollo local, debes usar las credenciales que proporciones a la gcloud CLI.

Instala Google Cloud CLI y, luego, accede a gcloud CLI con tu identidad federada.

Para obtener más información, consulta Autentícate para usar REST en la documentación de autenticación de Cloud de Confiance .

Roles obligatorios

Para obtener los permisos que necesitas para crear una instancia que admita Cloud RDMA, pídele al administrador que te otorgue el rol de IAM Administrador de instancias de Compute (v1) (roles/compute.instanceAdmin.v1) en el proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene los permisos necesarios para crear una instancia que admita Cloud RDMA. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para crear una instancia que admita Cloud RDMA:

compute.instances.create en el proyecto
Si deseas usar una imagen personalizada para crear la VM, sigue estos pasos: compute.images.useReadOnly en la imagen
Para usar una instantánea a fin de crear la VM, haz lo siguiente: compute.snapshots.useReadOnly en la instantánea
Si quieres usar una plantilla de instancias para crear la VM, sigue estos pasos: compute.instanceTemplates.useReadOnly en la plantilla de instancias
A fin de especificar una subred para tu VM: compute.subnetworks.use en el proyecto o en la subred elegida
Si deseas especificar una dirección IP estática para la VM: compute.addresses.use en el proyecto
Para asignar una dirección IP externa a la VM cuando se usa una red de VPC, compute.subnetworks.useExternalIp en el proyecto o en la subred elegida.
Para configurar los metadatos de la instancia de VM para la VM, compute.instances.setMetadata en el proyecto.
Para configurar etiquetas en la VM, haz lo siguiente: compute.instances.setTags en la VM
Para configurar etiquetas en la VM, haz lo siguiente: compute.instances.setLabels en la VM
A fin de configurar una cuenta de servicio para que la VM use: compute.instances.setServiceAccount en la VM
Crear un disco nuevo para la VM: compute.disks.create en el proyecto
Para conectar un disco existente en modo de solo lectura o de lectura y escritura, usa compute.disks.use en el disco.
Para conectar un disco existente en modo de solo lectura, haz lo siguiente: compute.disks.useReadOnly en el disco

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Requisitos

Revisa las siguientes reglas para configurar una interfaz de red para una instancia:

Para configurar una interfaz de red de IRDMA, primero debes crear una red de VPC con el perfil de red de Falcon RDMA en la misma región y zona que la instancia.
Para la interfaz de red gVNIC o IDPF, debes usar una VPC normal. Si no especificas una red o una subred, Compute Engine usa la red de VPC predeterminada y la subred automática que se encuentra en la misma región que la instancia.
Si especificas una subred, pero no una red, Compute Engine infiere la red a partir de la subred especificada.
Si especificas una red, debes especificar una subred y esta debe pertenecer a la misma red. De lo contrario, la creación de la instancia fallará.

Limitaciones

No puedes usar la migración en vivo con máquinas virtuales (VMs) que usen Cloud RDMA. Debes configurar la instancia para que finalice durante los eventos de mantenimiento.
No puedes usar Cloud RDMA con grupos de instancias administrados (MIG) (administrados o no administrados).
Solo puedes usar tipos de pila de red IPv4_ONLY con una instancia habilitada para RDMA de Cloud.
Solo puedes usar series de máquinas que admitan Cloud RDMA, como la serie de máquinas H4D o la serie de máquinas Z4M.
La instancia debe usar una imagen de SO que admita IRDMA.

Crea una instancia habilitada para Cloud RDMA

Las instancias que usan Cloud RDMA requieren al menos dos interfaces de red virtuales (vNIC) por NIC física, configuradas con los siguientes tipos de interfaz de red:

Tipo de interfaz de red GVNIC: Las VMs usan el controlador gve para el tráfico de TCP/IP y de Internet para la comunicación normal de VM a VM y de VM a Internet
Tipo de interfaz de red IDPF: Las instancias de Bare Metal usan un tipo de interfaz de red de IDPF en lugar de GVNIC para la comunicación normal de instancia a instancia y de instancia a Internet.
Tipo de interfaz de red IRDMA: Usa controladores IDPF/iRDMA para la comunicación basada en RDMA entre instancias de procesamiento. Esta interfaz debe usar un perfil de red de RDMA Falcon.

La cantidad de interfaces de red de cada tipo que puedes configurar para una instancia depende de la serie de máquinas, como se explica en la siguiente tabla:

Series de máquinas	Tipos de interfaces de red	Número a configurar
H4D	Solo GVNIC	GVNIC: 1 a 10
H4D	GVNIC e IRDMA	GVNIC: de 1 a 9 IRDMA: 1
VMs Z4M	Solo GVNIC	GVNIC: De 1 a 10
VMs Z4M (< 192 CPUs virtuales)	GVNIC e IRDMA	GVNIC: De 1 a 9 IRDMA: 1
VMs Z4M (192 CPUs virtuales)	GVNIC y IRDMA	GVNIC: De 1 a 9 IRDMA: De 1 a 2
Z4M (bare metal)	Solo IDPF	IDPF: de 1 a 2
Z4M (bare metal)	IDPF e IRDMA	1 IDPF y 1 IRDMA, o bien 2 IDPF y 1 o 2 IRDMA

La cantidad de interfaces de red IRDMA para instancias de equipos físicos no puede exceder la cantidad de interfaces de red IDPF. Además, para las instancias con varias NIC, debes definir una interfaz de gVNIC o IDPF antes de cada interfaz de IRDMA para asignar correctamente los tipos de interfaz de red a cada NIC física. En los siguientes ejemplos, se describen las configuraciones posibles:

Una VM con varias NIC que tiene 1 interfaz de red IRDMA y 4 interfaces de red gVNIC: Configura las interfaces de red en este orden: gVNIC, IRDMA, gVNIC, gVNIC, gVNIC. Esto genera las siguientes asignaciones:
- NIC 0: GVNIC, IRDMA, GVNIC
- NIC 1: GVNIC, GVNIC
Una VM con varias NIC que tiene 2 interfaces de red IRDMA y 5 interfaces de red gVNIC: Configura las interfaces de red en este orden: gVNIC, IRDMA, gVNIC, IRDMA, gVNIC, gVNIC, gVNIC. Esto genera las siguientes asignaciones:
- NIC 0: GVNIC, IRDMA, GVNIC, GVNIC
- NIC 1: GVNIC, IRDMA, GVNIC

Para obtener una descripción general de las interfaces de red múltiples en Cloud de Confiance by S3NS, consulta Interfaces de red múltiples.

Para crear una instancia que use IRDMA, completa los pasos de las siguientes secciones:

Crea una política de posición si no existe una adecuada.
Crea una red de VPC nueva o usa una red de VPC de Falcon existente.
Crea una instancia habilitada para Cloud RDMA que tenga al menos una interfaz de red GVNIC o IDPF, al menos una interfaz de red IRDMA y que use una política de posición compacta.

Crea una política de posición para las instancias de Cloud RDMA

Las instancias que se comunican con Cloud RDMA deben estar ubicadas en una sola zona y, de forma más estricta, dentro de una sola estructura de clúster. Puedes crear una política de posición compacta y especificar un valor de distancia máxima para establecer la compacidad mínima dentro de una zona. Hay un límite en la cantidad de instancias a las que puedes asignar la política de posición compacta cuando especificas un valor de distancia máxima, y el límite cambia según el valor que elijas.

Para crear una política de posición compacta que se use con tus instancias de Cloud RDMA, sigue los pasos que se indican en Crea una política de posición compacta y especifica un valor de distancia máxima de 3 o menos.

Crear redes de nube privada virtual

Para configurar las redes, puedes seguir las instrucciones documentadas o usar la secuencia de comandos proporcionada.

Guías de instrucciones

Para crear las redes, puedes usar las siguientes instrucciones:

Para crear las redes de host para las interfaces de red GVNIC o IDPF, consulta Crea y administra redes de VPC.

Si solo configuras una interfaz de red GVNIC o IDPF, puedes usar la red de VPC predeterminada y la subred automática que se encuentra en la misma región que la instancia.
Para crear una red para la interfaz de red IRDMA, consulta Crea una red de VPC para las NIC de RDMA y usa un perfil de red de RDMA de Falcon. Establece la unidad de transmisión máxima (MTU) en 8896 para la red de VPC de Falcon.

Secuencia de comandos

Para crear las redes, puedes usar la siguiente secuencia de comandos.

Opcional: Antes de ejecutar la secuencia de comandos, enumera los perfiles de red de RDMA de Falcon para verificar que estén disponibles.
```
gcloud compute network-profiles list --filter=falcon
```
Copia el siguiente código y ejecútalo en una ventana de shell de Linux.

#!/bin/bash

# Create standard VPC (network and subnet) for the GVNIC or IDPF interface
  gcloud compute networks create GVNIC_NAME_PREFIX-net-0 \
    --subnet-mode=custom

  gcloud compute networks subnets create GVNIC_NAME_PREFIX-sub-0 \
    --network=GVNIC_NAME_PREFIX-net-0 \
    --region=REGION \
    --range=10.0.0.0/16

  gcloud compute firewall-rules create GVNIC_NAME_PREFIX-internal-0 \
    --network=GVNIC_NAME_PREFIX-net-0 \
    --action=ALLOW \
    --rules=tcp:0-65535,udp:0-65535,icmp \
    --source-ranges=10.0.0.0/8

# Create SSH firewall rules
gcloud compute firewall-rules create GVNIC_NAME_PREFIX-ssh \
  --network=GVNIC_NAME_PREFIX-net-0 \
  --action=ALLOW \
  --rules=tcp:22 \
  --source-ranges=IP_RANGE

# Optional: Create an external IP for only the GVNIC or IDPF interface
gcloud compute firewall-rules create GVNIC_NAME_PREFIX-allow-ping-net-0 \
  --network=GVNIC_NAME_PREFIX-net-0 \
  --action=ALLOW \
  --rules=icmp \
  --source-ranges=IP_RANGE

# Create network for Cloud RDMA over Falcon transport
gcloud compute networks create RDMA_NAME_PREFIX-irdma \
  --network-profile=ZONE-vpc-falcon \
  --subnet-mode custom

# Create subnet for Cloud RDMA
gcloud compute networks subnets create RDMA_NAME_PREFIX-irdma-sub \
    --network=RDMA_NAME_PREFIX-irdma \
    --region=REGION \
    --range=10.1.0.0/16  # offset to avoid overlap with GVNIC or IDPF network

Reemplaza lo siguiente:

GVNIC_NAME_PREFIX: el prefijo del nombre que se usará para la red de nube privada virtual normal y la subred que usa un tipo de NIC de GVNIC o IDPF.
RDMA_NAME_PREFIX: Es el prefijo del nombre que se usará para la red y la subred de nube privada virtual que usa el tipo de NIC de IRDMA.
ZONE: Es la zona en la que deseas crear las redes y las instancias de procesamiento. Usa us-central1-a o europe-west4-b.
REGION: la región en la que deseas crear la política. Debe corresponder a la zona especificada. Por ejemplo, si tu zona es europe-west4-b, tu región es europe-west4.
IP_RANGE: Es el rango de direcciones IP fuera de la red de VPC que se usará para las reglas de firewall de SSH. Como práctica recomendada, especifica los rangos de direcciones IP específicos desde los que necesitas permitir el acceso, en lugar de todas las fuentes IPv4 o IPv6. No uses 0.0.0.0/0 ni ::/0 como rango de origen, ya que esto permite el tráfico de todas las fuentes IPv4 o IPv6, incluidas las fuentes fuera de Cloud de Confiance by S3NS.

Crea una instancia con Cloud RDMA habilitado

En los siguientes pasos, se muestra cómo crear una instancia con la primera interfaz de red configurada como una interfaz gVNIC o IDPF, y la segunda interfaz de red configurada como una interfaz de red IRDMA:

Console

En la consola de Cloud de Confiance , ve a la página Crear una instancia.

Ir a Crear una instancia

Si se te solicita, selecciona el proyecto y haz clic en Continuar.

Aparecerá la página Crear una instancia y se mostrará el panel Configuración de la máquina.
En el panel Configuración de la máquina, haz lo siguiente:
1. En el campo Nombre, especifica un nombre para la instancia. Para obtener más información, consulta Convención de asignación de nombres de recursos.
2. Opcional: En el campo Zona, selecciona una zona para esta instancia.
  
  Elige la zona que usaste para configurar la red de VPC de Falcon.
3. Elige una familia de máquinas y una serie de máquinas compatibles.
4. En la sección Tipo de máquina, selecciona el tipo de máquina para tu instancia.
En el menú de navegación de la izquierda, haz clic en SO y almacenamiento. En el panel Sistema operativo y almacenamiento que aparece, haz lo siguiente:
1. En la parte inferior de la sección Sistema operativo y almacenamiento, haz clic en Cambiar.
2. En las listas Sistema operativo y Versión, selecciona un tipo y una versión de SO que ofrezcan compatibilidad con RDMA de Cloud.
3. Asegúrate de que el tipo de disco de arranque esté configurado como Hyperdisk Balanced.
4. Haz clic en Seleccionar en la parte inferior del panel para guardar los cambios.
En el menú de navegación de la izquierda, haz clic en Herramientas de redes. En el panel Herramientas de redes que aparece, haz lo siguiente:
1. Ve a la sección Interfaces de red. Ya debería haber una interfaz de red, etiquetada como default.
2. Haz clic en Agregar una interfaz de red. En la sección Nueva interfaz de red que aparece, haz lo siguiente:
  1. En la lista Tarjeta de interfaz de red, selecciona IRDMA.
  2. En el campo Red, selecciona la red de VPC de Falcon.
  3. Opcional: En la lista Subred, selecciona la subred que usará la instancia.
  4. En el campo Tipo de pila de IP, asegúrate de que esté configurado como Solo IPv4.
  5. En la lista Dirección IPv4 externa, selecciona Ninguna.
  6. Para confirmar los detalles de la interfaz de red, haz clic en Listo.
Opcional: Especifica otros parámetros de configuración para la instancia. Para obtener más información, consulta Opciones de configuración durante la creación de instancias.
Para crear y, luego, iniciar la instancia, haz clic en Crear.

gcloud

En la consola de Cloud de Confiance , activa Cloud Shell.

Activa Cloud Shell

En la parte inferior de la consola de Cloud de Confiance , se inicia una sesión de Cloud Shell en la que se muestra una ventana de línea de comandos. Cloud Shell es un entorno de shell con Google Cloud CLI ya instalada y con valores ya establecidos para el proyecto actual. La sesión puede tardar unos segundos en inicializarse.
Usa el comando gcloud compute instances create con al menos dos marcas --network-interface, una para la interfaz de gVNIC o IDPF y otra para la interfaz de IRDMA. Puedes personalizar el resto de las opciones del comando según sea necesario.

Nota: La interfaz de red gVNIC o IDPF solo puede tener una dirección IPv6, ya sea interna o externa, pero no ambas. La interfaz de red de IRDMA solo puede usar direcciones IPv4.
```
gcloud compute instances create INSTANCE_NAME \
    --zone=ZONE \
    --machine-type=MACHINE_TYPE \
    --create-disk=boot=yes, \
        image=projects/IMAGE_PROJECT/global/images/IMAGE, \
        size=SIZE \
    --maintenance-policy=TERMINATE \
    --network-interface \
        nic-type=GVNIC, \
        network=NETWORK_NAME,subnet=SUBNET_NAME, \
        stack-type=STACK_TYPE, \
        private-network-ip=INTERNAL_IPV4_ADDRESS, \
        address=EXTERNAL_IPV4_ADDRESS \
    --network-interface \
        nic-type=IRDMA, \
        network=RDMA_NETWORK_NAME,subnet=RDMA_SUBNET_NAME, \
        stack-type=IPV4_ONLY, \
        no-address \
```
Reemplaza lo siguiente:
- INSTANCE_NAME: Es el nombre de la instancia de procesamiento.
- ZONE: Es la zona en la que se crea la instancia, como europe-west1-b. La región de la instancia se infiere de la zona.
- MACHINE_TYPE: un tipo de máquina compatible que se usará para la instancia.
- IMAGE_PROJECT: Opcional: Es el proyecto de imagen que contiene la imagen.
- IMAGE: Opcional: Especifica una de las siguientes opciones:
  - una versión específica de la imagen de SO; por ejemplo, hpc-rocky-linux-8-v20250721.
  - Una familia de imágenes, que debe tener el formato family/IMAGE_FAMILY. Esto crea la instancia a partir de la imagen de SO no obsoleta más reciente. Por ejemplo, si especificas family/hpc-rocky-linux-8, Compute Engine crea una instancia con la última versión de la imagen de SO en la familia de imágenes de HPC Rocky Linux 8. Para obtener más información sobre el uso de las familias de imágenes, consulta Prácticas recomendadas para las familias de imágenes.
- SIZE: Opcional: Es el tamaño del disco nuevo. El valor debe ser un número entero. La unidad de medida predeterminada es GiB.
- NETWORK_NAME: Nombre de la red (opcional)
- SUBNET_NAME: Es el nombre de la subred que se usará para la interfaz de red. Para ver una lista de las subredes de la red, usa el comando gcloud compute networks subnets list.
  
  Para la interfaz de red de GVNIC o IDPF, puedes omitir las marcas network y subnet, y usar la red default en su lugar.
- STACK_TYPE: Es opcional y se refiere al tipo de pila para la interfaz de red de gVNIC o IDPF. STACK_TYPE debe ser uno de los siguientes valores: IPV4_ONLY, IPV4_IPV6 o IPV6_ONLY. El valor predeterminado es IPV4_ONLY.
- INTERNAL_IPV4_ADDRESS: Es la dirección IPv4 interna que deseas que use la instancia de procesamiento en la subred de destino (opcional). Omite esta marca si no necesitas una dirección IP específica.
  
  Para especificar una dirección IPv6 interna, usa la marca --internal-ipv6-address en su lugar.
- EXTERNAL_IPV4_ADDRESS: Opcional. Es la dirección IPv4 externa estática que se usará con la interfaz de red. Debes haber reservado una dirección IPv4 externa con anterioridad. Realiza una de las siguientes acciones:
  - Especifica una dirección IPv4 válida de la subred.
  - En su lugar, usa la marca no-address si no deseas que la interfaz de red tenga una dirección IP externa.
  - Especifica address='' si deseas que la interfaz reciba una dirección IP externa efímera.
  Para especificar una dirección IPv6 externa, usa la marca --external-ipv6-address en su lugar.
- RDMA_NETWORK_NAME: Es el nombre de la red de VPC que creaste con un perfil de red de RDMA de Falcon.
- RDMA_SUBNET_NAME: Es el nombre de una subred en la red de VPC de Falcon.

REST

Para crear una instancia configurada para usar Cloud RDMA, realiza una solicitud POST al método instances.insert. Incluye el objeto networkInterfaces con al menos dos configuraciones de red, una para la interfaz gVNIC o IDPF y otra para la interfaz IRDMA. Puedes personalizar el resto de las propiedades de la instancia según sea necesario.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

PROJECT_ID: ID del proyecto en el que se creará la instancia
ZONE: Es la zona en la que se creará la instancia.
MACHINE_TYPE: un tipo de máquina compatible, por ejemplo, h4d-highmem-192-lssd
INSTANCE_NAME: Es un nombre para la instancia nueva.
IMAGE_PROJECT: Es el proyecto de imagen que contiene la imagen (opcional).
IMAGE: Opcional. Especifica una de las siguientes opciones:
- Una versión específica de la imagen de SO; por ejemplo, debian-12-bookworm-v20250415
- Una familia de imágenes, que debe tener el formato family/IMAGE_FAMILY. Esto crea la instancia a partir de la imagen de SO no obsoleta más reciente. Por ejemplo, si especificas family/debian-12, Compute Engine crea una instancia con la versión más reciente de la imagen de SO en la familia de imágenes de Debian 12. Para obtener más información sobre el uso de las familias de imágenes, consulta Prácticas recomendadas para las familias de imágenes.
NETWORK_NAME: Es el nombre opcional de la red que se usará con la interfaz de red de gVNIC o IDPF.
SUBNET_NAME: Nombre de la subred que se usará con la interfaz de red gVNIC o IDPF

Para la interfaz de red de gVNIC o IDPF, puedes omitir las propiedades network y subnet, y usar la red default en su lugar.
INTERNAL_IPV4_ADDRESS: Opcional: Es la dirección IPv4 interna que deseas que use la instancia de procesamiento en la subred de destino. Omite esta marca si no necesitas una dirección IP específica.
EXTERNAL_IPV4_ADDRESS: Opcional: Es una dirección IPv4 externa estática para usar con la interfaz de red. Debes haber reservado con anterioridad una dirección IPv4 externa.
RDMA_NETWORK_NAME: Es el nombre de la red que creaste con un perfil de red de RDMA.
RDMA_SUBNET_NAME: Es el nombre de una subred en la red de RDMA.

Método HTTP y URL:

POST https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/instances

Cuerpo JSON de la solicitud:

{
    "machineType": "zones/ZONE/machineTypes/MACHINE_TYPE",
    "name": "INSTANCE_NAME",
    "disks": [
      {
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        },
        "boot": true
      }
    ],
    "networkInterfaces": [
      {
        "network": "NETWORK_NAME",
        "subnetwork": "SUBNET_NAME",
        "networkIP": "INTERNAL_IPV4_ADDRESS",
        "accessConfigs": [
          {
            "type": "ONE_TO_ONE_NAT",
            "name": "External IP",
            "natIP": "EXTERNAL_IPV4_ADDRESS"
          }
        ],
        "stackType": "IPV4_ONLY",
        "nicType": "GVNIC",
      },
      {
        "network": "RDMA_NETWORK_NAME",
        "subnetwork": "RDMA_SUBNET_NAME",
        "stackType": "IPV4_ONLY",
        "nicType": "IRDMA",
      }
    ]
}

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login , o a través del uso de Cloud Shell, que accede de forma automática a gcloud CLI . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/instances"

PowerShell (Windows)

Nota: El siguiente comando supone que accediste a gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/instances" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "kind": "compute#operation",
  "id": "9216044482154695709",
  "name": "operation-1739207409646-62dccc7d7bc58-d1350b42-64fdb7f7",
  "zone": "https://www.s3nsapis.fr/compute/v1/projects/`PROJECT_ID`/zones/`ZONE`",
  "operationType": "insert",
  "targetLink": "https://www.s3nsapis.fr/compute/v1/projects/`PROJECT_ID`/zones/`ZONE`/instances/`INSTANCE_NAME`",
  "targetId": "2679381553616227357",
  "status": "RUNNING",
  "user": "USER_ID",
  "progress": 0,
  "insertTime": "2025-02-10T09:10:10.551-08:00",
  "startTime": "2025-02-10T09:10:10.551-08:00",
  "selfLink": "https://www.s3nsapis.fr/compute/v1/projects/`PROJECT_ID`/zones/`ZONE`/operations/operation-1565289606387-58f9f62f5989c-e582f586-6d22f38"
 "kind": "compute#operation"
}

Próximos pasos

Obtén información para verificar el estado de una instancia y saber cuándo está lista para usar.
Aprende a conectarte a tu instancia.
Obtén información sobre las direcciones IP que se asignan cuando creas una instancia.
Obtén más información para crear una instancia de pila doble o solo IPv6.