Esta página se ha traducido con Cloud Translation API.

Ver, cancelar o eliminar solicitudes de cambio de tamaño en un MIG

En este documento se describe cómo hacer lo siguiente después de crear una solicitud de cambio de tamaño en un grupo de instancias gestionado (MIG):

Después de crear solicitudes de cambio de tamaño en un MIG, puede hacer lo siguiente:

Consulta las solicitudes de cambio de tamaño para monitorizar su estado o solucionar problemas.
Cancela las solicitudes de cambio de tamaño para evitar que el MIG cree el número solicitado de instancias de máquina virtual (VM).
Elimina las solicitudes de cambio de tamaño cuando ya no las necesites.

Antes de empezar

Si aún no lo has hecho, consulta cómo funcionan las solicitudes de cambio de tamaño.
Si aún no lo has hecho, configura la autenticación. La autenticación verifica tu identidad para acceder a Google Cloud servicios y APIs. Para ejecutar código o ejemplos desde un entorno de desarrollo local, puedes autenticarte en Compute Engine seleccionando una de las siguientes opciones:
Select the tab for how you plan to use the samples on this page:
Console

When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
1. Instala Google Cloud CLI. Después de la instalación, inicializa la CLI de Google Cloud ejecutando el siguiente comando:
  gcloud init
  Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.
  
  Nota: Si ya has instalado la CLI de gcloud, asegúrate de que tienes la versión más reciente ejecutando gcloud components update.
2. Set a default region and zone.
REST

Para usar las muestras de la API REST de esta página en un entorno de desarrollo local, debes usar las credenciales que proporciones a la CLI de gcloud.
Para obtener más información, consulta el artículo Autenticarse para usar REST de la documentación sobre autenticación de Google Cloud .

Roles obligatorios

Para obtener los permisos que necesitas para ver, cancelar o eliminar solicitudes de cambio de tamaño en un MIG, pide a tu administrador que te conceda el rol de gestión de identidades y accesos Administrador de instancias de Compute (v. 1) (roles/compute.instanceAdmin.v1) en el proyecto. Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene los permisos necesarios para ver, cancelar o eliminar solicitudes de cambio de tamaño en un MIG. Para ver los permisos exactos que se necesitan, despliega la sección Permisos necesarios:

Permisos obligatorios

Para ver, cancelar o eliminar solicitudes de cambio de tamaño en un MIG, se necesitan los siguientes permisos:

Para cancelar o eliminar solicitudes de cambio de tamaño en un MIG, sigue estos pasos: compute.instanceGroupManagers.update
Para ver una lista de solicitudes de cambio de tamaño en un MIG, sigue estos pasos: compute.instanceGroupManagers.list
Para ver los detalles de una solicitud de cambio de tamaño, sigue estos pasos: compute.instanceGroupManagers.get

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

Ver tus solicitudes de cambio de tamaño

Para ver información sobre las solicitudes de cambio de tamaño de un MIG, utiliza uno de los siguientes métodos:

Para ver un resumen de todas las solicitudes de un MIG, consulta la lista de solicitudes de cambio de tamaño de un MIG.
Para ver todos los detalles de una solicitud concreta, consulte los detalles de una solicitud de cambio de tamaño.

Ver una lista de solicitudes de cambio de tamaño en un MIG

Para ver una lista de todas las solicitudes de cambio de tamaño de un MIG, selecciona una de las siguientes opciones:

Para ver una lista de todas las solicitudes de cambio de tamaño de un MIG regional, usa la CLI de gcloud o la API REST. De lo contrario, para ver una lista de todas las solicitudes de cambio de tamaño de un MIG zonal, seleccione una de las siguientes opciones:

Consola

En la consola, ve a la página Grupos de instancias. Google Cloud

Ir a Grupos de instancias
En la columna Nombre, haga clic en el nombre del MIG que contiene solicitudes de cambio de tamaño.

Se abrirá la página de vista general del MIG.
En la fila Solicitudes de cambio de tamaño, haz clic en Editar solicitudes de cambio de tamaño.

Aparecerá el panel Solicitudes de cambio de tamaño. Si en la columna Detalles de una solicitud de cambio de tamaño se muestra el valor Cuota superada o Tiempo estimado: indefinido, significa que se ha producido un error en la solicitud. Puedes hacer clic en estos valores para obtener más información.

Para obtener más información sobre cómo solucionar errores, consulta el artículo Ver los detalles de una solicitud de cambio de tamaño de este documento.

gcloud

Para ver una lista de solicitudes de cambio de tamaño en un MIG zonal, usa el comando instance-groups managed resize-requests list.
```
gcloud compute instance-groups managed resize-requests list INSTANCE_GROUP_NAME \
    --zone=ZONE
```
Para ver una lista de solicitudes de cambio de tamaño de un MIG regional, usa el comando beta instance-groups managed resize-requests list.
```
gcloud beta compute instance-groups managed resize-requests list INSTANCE_GROUP_NAME \
    --region=REGION
```

Haz los cambios siguientes:

INSTANCE_GROUP_NAME: el nombre de un MIG con solicitudes de cambio de tamaño aceptadas, correctas, canceladas o fallidas.
ZONE: la zona en la que se encuentra el MIG.
REGION: la región en la que se encuentra el MIG.

La salida es similar a la siguiente en el caso de un MIG zonal:

NAME: rr-01
LOCATION: us-central1-a
SCOPE: zone
RESIZE_BY: 5
STATE: SUCCEEDED
REQUESTED_RUN_DURATION: P1D

NAME: rr-02
LOCATION: us-central1-a
SCOPE: zone
RESIZE_BY: 10
STATE: ACCEPTED
REQUESTED_RUN_DURATION: P3D

REST

Para ver una lista de solicitudes de cambio de tamaño de un MIG zonal, envía una solicitud GET con el método instanceGroupManagerResizeRequests.list.
```
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME/resizeRequests
```
Para ver una lista de solicitudes de cambio de tamaño en un MIG regional, envía una solicitud GET con el método beta.regionInstanceGroupManagerResizeRequests.list.
```
GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/regionInstanceGroupManagers/INSTANCE_GROUP_NAME/resizeRequests
```

Haz los cambios siguientes:

PROJECT_ID: el ID del proyecto en el que se encuentra un MIG con solicitudes de cambio de tamaño aceptadas, correctas, canceladas o fallidas.
ZONE: la zona en la que se encuentra el MIG.
REGION: la región en la que se encuentra el MIG.
INSTANCE_GROUP_NAME: el nombre de un MIG con solicitudes de cambio de tamaño aceptadas, completadas, canceladas o fallidas.

La salida de un MIG zonal es similar a la siguiente:

{
  "kind": "compute#instanceGroupManagerResizeRequestList",
  "id": "projects/example-project/zones/us-central1-a/instanceGroupManagers/example-mig/resizeRequests",
  "items": [
    {
      "kind": "compute#instanceGroupManagerResizeRequest",
      "id": "4247139565532196982",
      "creationTimestamp": "2024-01-08T07:51:53.034-08:00",
      "name": "rr-01",
      "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a",
      "count": 5,
      "resizeBy": 5,
      "requestedRunDuration": {
        "seconds": "86400",
        "nanos": 0
      },
      "state": "SUCCEEDED",
      "status": {},
      "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instanceGroupManagers/example-mig/resizeRequests/rr-01",
      "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instanceGroupManagers/example-mig/resizeRequests/4247139565532196982"
    },
    {
      "kind": "compute#instanceGroupManagerResizeRequest",
      "id": "8095866098849525652",
      "creationTimestamp": "2024-01-11T08:04:11.851-08:00",
      "name": "rr-02",
      "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a",
      "count": 10,
      "resizeBy": 10,
      "requestedRunDuration": {
        "seconds": "259200",
        "nanos": 0
      },
      "state": "ACCEPTED",
      "status": {},
      "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instanceGroupManagers/example-mig/resizeRequests/rr-02",
      "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instanceGroupManagers/example-mig/resizeRequests/8095866098849525652"
    }
  ],
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instanceGroupManagers/example-mig/resizeRequests"
}

Ver los detalles de una solicitud de cambio de tamaño

Puedes ver los detalles de una solicitud de cambio de tamaño para revisar su configuración y, si quieres, solucionar los problemas si la solicitud aún no se ha completado.

Si no se aplica un cambio de tamaño aceptado, puedes solucionar el problema comprobando el campo status.lastAttempt.error.errors.code en los detalles de la solicitud. Los posibles códigos de error son los siguientes:

QUOTA_EXCEEDED: tu proyecto no tiene cuota para los recursos solicitados. Para aumentar la cuota de tu proyecto, consulta Solicitar un ajuste de cuota.
ZONE_RESOURCE_POOL_EXHAUSTED_WITH_DETAILS: los recursos solicitados no están disponibles temporalmente. Compute Engine ha programado la creación de los recursos solicitados y tiene previsto crearlos cuando estén disponibles. Si el campo message contiene Expected time is indefinite, Google recomienda cancelar la solicitud y probar una o varias de las siguientes opciones:
- Crea una nueva solicitud de cambio de tamaño con un número inferior de VMs solicitadas.
- Usa otro tipo de máquina en el MIG y, a continuación, crea una nueva solicitud de cambio de tamaño. Para usar otro tipo de máquina, crea una plantilla de instancia y, a continuación, úsala para crear o actualizar un MIG.
- Crea una solicitud de cambio de tamaño en un MIG ubicado en otra región o zona.

Para ver los detalles de una solicitud de cambio de tamaño, selecciona una de las siguientes opciones:

gcloud

Para ver los detalles de una solicitud de cambio de tamaño en un MIG zonal, usa el comando instance-groups managed resize-requests describe.

gcloud compute instance-groups managed resize-requests describe INSTANCE_GROUP_NAME \
    --resize-request=RESIZE_REQUEST_NAME \
    --zone=ZONE

Para ver los detalles de una solicitud de cambio de tamaño en un MIG regional, usa el comando beta instance-groups managed resize-requests describe.

gcloud beta compute instance-groups managed resize-requests describe INSTANCE_GROUP_NAME \
    --resize-request=RESIZE_REQUEST_NAME \
    --region=REGION

Haz los cambios siguientes:

INSTANCE_GROUP_NAME: el nombre de un MIG.
RESIZE_REQUEST_NAME: el nombre de una solicitud de cambio de tamaño de la que quieras ver los detalles.
ZONE: la zona en la que se encuentra el MIG.
REGION: la región en la que se encuentra el MIG.

La salida es similar a la siguiente en el caso de un MIG zonal:

creationTimestamp: '2024-09-23T02:27:09.575-07:00'
id: '6386622402379156098'
kind: compute#instanceGroupManagerResizeRequest
name: example-request
requestedRunDuration:
  nanos: 0
  seconds: '86400'
resizeBy: 10
selfLink: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instanceGroupManagers/example-mig/resizeRequests/example-request
selfLinkWithId: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instanceGroupManagers/example-mig/resizeRequests/6386622402379156098
state: ACCEPTED
status:
  lastAttempt:
    error:
      errors:
      - code: QUOTA_EXCEEDED
        message: Quota 'NVIDIA_A100_GPUS' exceeded. Limit: 1500 in region us-central1.
      - code: ZONE_RESOURCE_POOL_EXHAUSTED_WITH_DETAILS
        message: There are currently not enough resources available to fulfill the request. Expected time is indefinite.
        - errorDetails:
          - errorInfo:
            - metadatas:
              - estimatedAvailabilityTime: '9999-12-31T23:59:59.999999999Z'
zone: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a

REST

Para ver los detalles de una solicitud de cambio de tamaño en un MIG zonal, envía una solicitud GET con el método instanceGroupManagerResizeRequests.get.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME/resizeRequests/RESIZE_REQUEST_NAME

Para ver los detalles de una solicitud de cambio de tamaño en un MIG regional, envía una solicitud GET con el método beta.regionInstanceGroupManagerResizeRequests.get.

GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/regionInstanceGroupManagers/INSTANCE_GROUP_NAME/resizeRequests/RESIZE_REQUEST_NAME

Haz los cambios siguientes:

PROJECT_ID: el ID del proyecto en el que se encuentra el MIG zonal.
ZONE: la zona en la que se encuentra el MIG.
REGION: la región en la que se encuentra el MIG.
INSTANCE_GROUP_NAME: el nombre de un MIG en el que se encuentra la solicitud de cambio de tamaño.
RESIZE_REQUEST_NAME: el nombre de una solicitud de cambio de tamaño que quieras consultar.

El resultado debería ser similar al siguiente:

{
  "kind": "compute#instanceGroupManagerResizeRequest",
  "id": "6386622402379156098",
  "creationTimestamp": "2024-09-23T02:27:09.575-07:00",
  "name": "example-request",
  "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a",
  "resizeBy": 10,
  "requestedRunDuration": {
    "seconds": "86400",
    "nanos": 0
  },
  "state": "SUCCEEDED",
  "status": {
    "lastAttempt": {
      "error": {
        "errors": [
          {
            "code": "QUOTA_EXCEEDED",
            "message": "Quota 'NVIDIA_A100_GPUS' exceeded. Limit: 1500 in region us-central1."
          },
          {
            "code": "ZONE_RESOURCE_POOL_EXHAUSTED_WITH_DETAILS",
            "message": "There are currently not enough resources available to fulfill the request. Expected time is indefinite.",
            "errorDetails": [
              {
                "errorInfo":{
                  "metadatas":{
                    "estimatedAvailabilityTime": "9999-12-31T23:59:59.999999999Z"
                  }
                }
              }
            ]
          }
        ]
      }
    }
  },
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instanceGroupManagers/example-mig/resizeRequests/example-request",
  "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instanceGroupManagers/example-mig/resizeRequests/6386622402379156098"
}

Cancelar solicitudes de cambio de tamaño en un MIG

Puedes cancelar solicitudes de cambio de tamaño en un MIG para evitar que intente crear el número de VMs solicitado. Solo puedes cancelar las solicitudes de cambio de tamaño aceptadas (ACCEPTED). Después de cancelar una solicitud de cambio de tamaño, puedes eliminarla o dejar que Compute Engine la elimine automáticamente al cabo de 14 días.

Para cancelar varias solicitudes de cambio de tamaño simultáneamente, usa laGoogle Cloud consola o la CLI de Google Cloud. De lo contrario, para cancelar una sola solicitud de cambio de tamaño, seleccione una de las siguientes opciones:

Consola

En la consola, ve a la página Grupos de instancias. Google Cloud

Ir a Grupos de instancias
En la columna Nombre, haga clic en el nombre del MIG que contiene solicitudes de cambio de tamaño.

Se abrirá la página de vista general del MIG.
En la fila Solicitudes de cambio de tamaño, haz clic en Editar solicitudes de cambio de tamaño.

Aparecerá el panel Solicitudes de cambio de tamaño.
Selecciona las solicitudes de cambio de tamaño que quieras cancelar.
Haz clic en Cancelar y, a continuación, en Confirmar.

gcloud

Para cancelar solicitudes de cambio de tamaño en un MIG zonal, usa el comando instance-groups managed resize-requests cancel.

gcloud compute instance-groups managed resize-requests cancel INSTANCE_GROUP_NAME \
    --resize-requests=RESIZE_REQUEST_NAMES \
    --zone=ZONE

Para cancelar solicitudes de cambio de tamaño en un MIG regional, usa el comando beta instance-groups managed resize-requests cancel.

gcloud beta compute instance-groups managed resize-requests cancel INSTANCE_GROUP_NAME \
    --resize-requests=RESIZE_REQUEST_NAMES \
    --region=REGION

Haz los cambios siguientes:

INSTANCE_GROUP_NAME: el nombre de un MIG con solicitudes de cambio de tamaño aceptadas.
RESIZE_REQUEST_NAMES: lista de nombres separados por comas de las solicitudes de cambio de tamaño aceptadas en el MIG zonal especificado. Por ejemplo, especifica request-1,request-2.
ZONE: la zona en la que se encuentra el MIG.
REGION: la región en la que se encuentra el MIG.

REST

Para cancelar una solicitud de cambio de tamaño en un MIG zonal, envía una solicitud POST mediante el método instanceGroupManagerResizeRequests.cancel.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME/resizeRequests/RESIZE_REQUEST_NAME/cancel

Para cancelar una solicitud de cambio de tamaño en un MIG regional, envía una solicitud POST mediante el método beta.regionInstanceGroupManagerResizeRequests.cancel.

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/regionInstanceGroupManagers/INSTANCE_GROUP_NAME/resizeRequests/RESIZE_REQUEST_NAME/cancel

Haz los cambios siguientes:

PROJECT_ID: el ID del proyecto en el que se encuentra un MIG zonal con una solicitud de cambio de tamaño aceptada.
ZONE: la zona en la que se encuentra el MIG.
REGION: la región en la que se encuentra el MIG.
INSTANCE_GROUP_NAME: el nombre del MIG.
RESIZE_REQUEST_NAME: nombre de la solicitud de cambio de tamaño que se va a cancelar.

Eliminar solicitudes de cambio de tamaño en un MIG

De forma predeterminada, Compute Engine elimina automáticamente una solicitud de cambio de tamaño 14 días después de definir el estado de la solicitud en uno de los siguientes:

Completadas (SUCCEEDED)
Fallido (FAILED)
Cancelada (CANCELLED)

Sin embargo, puedes eliminar inmediatamente una solicitud de cambio de tamaño antes de que se cumpla, tal como se describe en esta sección.

Si eliminas una solicitud de cambio de tamaño que se ha completado correctamente, no se eliminarán las VMs creadas a través de la solicitud. La MIG elimina automáticamente esas VMs al final de la duración de ejecución solicitada. Sin embargo, si el trabajo ya se ha completado y ya no necesitas las VMs, elimínalas.

Para eliminar varias solicitudes de cambio de tamaño simultáneamente, usa laGoogle Cloud consola o gcloud CLI. De lo contrario, para eliminar una sola solicitud de cambio de tamaño, selecciona una de las siguientes opciones:

Consola

En la consola, ve a la página Grupos de instancias. Google Cloud

Ir a Grupos de instancias
En la columna Nombre, haga clic en el nombre del MIG que contiene solicitudes de cambio de tamaño.

Se abrirá la página de vista general del MIG.
En la fila Solicitudes de cambio de tamaño, haz clic en Editar solicitudes de cambio de tamaño.

Aparecerá el panel Solicitudes de cambio de tamaño.
Selecciona las solicitudes de cambio de tamaño que quieras eliminar.
Haz clic en Eliminar y, a continuación, en Confirmar.

gcloud

Para eliminar solicitudes de cambio de tamaño en un MIG zonal, usa el comando instance-groups managed resize-requests delete.

gcloud compute instance-groups managed resize-requests delete INSTANCE_GROUP_NAME \
    --resize-requests=RESIZE_REQUEST_NAMES \
    --zone=ZONE

Para eliminar solicitudes de cambio de tamaño en un MIG regional, usa el comando beta instance-groups managed resize-requests delete.

gcloud beta compute instance-groups managed resize-requests delete INSTANCE_GROUP_NAME \
    --resize-requests=RESIZE_REQUEST_NAMES \
    --region=REGION

Haz los cambios siguientes:

INSTANCE_GROUP_NAME: el nombre de un MIG con solicitudes de cambio de tamaño correctas, fallidas o canceladas.
RESIZE_REQUEST_NAMES: lista de nombres de solicitudes de cambio de tamaño separada por comas que se van a eliminar en el MIG. Por ejemplo, especifica request-1,request-2.
ZONE: la zona en la que se encuentra el MIG.
REGION: la región en la que se encuentra el MIG.

REST

Para eliminar una solicitud de cambio de tamaño en un MIG zonal, envía una solicitud DELETE mediante el método instanceGroupManagerResizeRequests.delete.

DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME/resizeRequests/RESIZE_REQUEST_NAME

Para eliminar una solicitud de cambio de tamaño en un MIG regional, envía una solicitud DELETE con el método beta.regionInstanceGroupManagerResizeRequests.delete.

DELETE https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/regionInstanceGroupManagers/INSTANCE_GROUP_NAME/resizeRequests/RESIZE_REQUEST_NAME

Haz los cambios siguientes:

PROJECT_ID: el ID del proyecto en el que se encuentra un MIG zonal con solicitudes de cambio de tamaño correctas, fallidas o canceladas.
ZONE: la zona en la que se encuentra el MIG.
REGION: la región en la que se encuentra el MIG.
INSTANCE_GROUP_NAME: el nombre del MIG.
RESIZE_REQUEST_NAME: nombre de la solicitud de cambio de tamaño que se va a eliminar.

Siguientes pasos

Consulta cómo ver información sobre las VMs gestionadas de un MIG.

Ver, cancelar o eliminar solicitudes de cambio de tamaño en un MIG Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.

Antes de empezar

Console

gcloud

REST

Roles obligatorios

Permisos obligatorios

Ver tus solicitudes de cambio de tamaño

Ver una lista de solicitudes de cambio de tamaño en un MIG

Consola

gcloud

REST

Ver los detalles de una solicitud de cambio de tamaño

gcloud

REST

Cancelar solicitudes de cambio de tamaño en un MIG

Consola

gcloud

REST

Eliminar solicitudes de cambio de tamaño en un MIG

Consola

gcloud

REST

Siguientes pasos

Ver, cancelar o eliminar solicitudes de cambio de tamaño en un MIG