Administra instancias de Google Cloud Managed Lustre

Una vez que creaste una instancia, Google Cloud Managed Lustre te permite enumerar, obtener, actualizar y borrar instancias.

Cuando actualizas instancias de Lustre administradas, solo se pueden modificar la descripción y las etiquetas.

Mostrar lista de instancias

Para enumerar todas las instancias de un proyecto, haz lo siguiente:

Consola de Google Cloud

  1. Ve a la página Lustre administrado en la consola de Google Cloud .

    Ir a Managed Lustre

    Se enumeran las instancias de tu proyecto.

gcloud CLI

Usa el comando gcloud lustre instances list:

gcloud lustre instances list --location=LOCATION

Reemplaza LOCATION por una zona específica para enumerar todas las instancias en esa ubicación. Para ver los proyectos en todas las ubicaciones, ingresa - como valor. Por ejemplo:

gcloud lustre instances list --location=-

REST

Para enumerar instancias con la API de REST, envía una solicitud al siguiente extremo:

GET https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances
Authorization: Bearer [YOUR_ACCESS_TOKEN]

Donde se deben especificar los siguientes valores:

  • PROJECT_ID es el ID de tu proyecto de Google Cloud .

  • ZONE es la zona para la que se enumerarán todas las instancias. Para enumerar instancias de todas las zonas, usa - como valor.

Consulta la referencia de la API de instances.list para obtener más detalles.

Obtén una instancia

Para obtener los detalles de una instancia, haz lo siguiente:

Consola de Google Cloud

  1. Ve a la página Lustre administrado en la consola de Google Cloud .

    Ir a Managed Lustre

  2. Haz clic en el nombre de la instancia para ver los detalles de una instancia específica.

gcloud CLI

Usa el comando gcloud lustre instances describe:

gcloud lustre instances describe INSTANCE_NAME --location=LOCATION

REST

Para obtener detalles sobre una instancia en particular con la API de REST, envía una solicitud al siguiente extremo:

GET https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/INSTANCE_NAME
Authorization: Bearer [YOUR_ACCESS_TOKEN]

Donde se deben especificar los siguientes valores:

  • PROJECT_ID es el ID de tu proyecto de Google Cloud .

  • ZONE debe ser una Google Cloud zona válida compatible con Lustre administrado. Consulta Ubicaciones admitidas para obtener una lista completa.

  • INSTANCE_NAME es el nombre de la instancia de Lustre administrada que se devolverá.

Consulta la referencia de la API de instances.get para obtener más detalles.

Actualizar una instancia

Puedes actualizar las siguientes propiedades de una instancia existente:

  • descripción
  • etiquetas
  • capacidad de almacenamiento

Para obtener información sobre cómo aumentar la capacidad de almacenamiento de una instancia, consulta Aumenta la capacidad de una instancia.

Para actualizar una instancia, sigue estos pasos:

Consola de Google Cloud

  1. Ve a la página Lustre administrado en la consola de Google Cloud .

    Ir a Managed Lustre

  2. Haz clic en el nombre de la instancia que deseas actualizar. Se mostrará la página de descripción general de la instancia.

  3. Haz clic en Editar.

  4. Ingresa los valores nuevos.

  5. Haz clic en Enviar.

Google Cloud CLI

Usa el comando gcloud lustre instances update:

gcloud lustre instances update INSTANCE_NAME \
  --location=LOCATION \
  --capacity-gib=NEW_CAPACITY \
  --description=NEW_DESCRIPTION

Aquí:

  • INSTANCE_NAME es la instancia que se actualizará.
  • LOCATION es la zona en la que reside la instancia.
  • NEW_CAPACITY es la nueva capacidad de almacenamiento de esta instancia en gibibytes (GiB). El valor no puede superar la capacidad máxima permitida y debe ser un múltiplo del tamaño del paso. Consulta Cómo aumentar la capacidad de una instancia para obtener más detalles.
  • NEW_DESCRIPTION es un valor nuevo para el campo de descripción, que reemplaza cualquier descripción existente.

Para actualizar etiquetas, consulta los comandos disponibles en la documentación de gcloud lustre instances update.

REST

Para actualizar una instancia con la API de REST, envía una solicitud PATCH a su extremo específico:

PATCH https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/INSTANCE_NAME?updateMask=UPDATE_MASK
Authorization: Bearer [YOUR_ACCESS_TOKEN]

{
  "capacityGib": 72000,
  "description": "updated description",
  "labels": {
    "key1": "value1"
  }
}

Donde se deben especificar los siguientes valores:

  • PROJECT_ID es el ID de tu proyecto de Google Cloud .
  • ZONE es la Google Cloud zona de la instancia.
  • INSTANCE_NAME es el nombre de la instancia de Lustre administrada que se actualizará.
  • UPDATE_MASK es una lista de campos separados por comas que se deben actualizar. Un campo solo se reemplazará si está en la máscara.

El cuerpo de la solicitud debe contener uno o más de los siguientes campos:

  • capacityGiB es la nueva capacidad de almacenamiento de esta instancia en gibibytes (GiB). El valor no puede superar la capacidad máxima permitida y debe ser un múltiplo del tamaño del paso. Consulta Cómo aumentar la capacidad de una instancia para obtener más detalles.
  • description es la nueva descripción de esta instancia.
  • labels es el nuevo conjunto de etiquetas para esta instancia. El valor de labels es un objeto JSON que contiene uno o más pares clave:valor.

Consulta la referencia de la API de instances.patch para obtener más detalles.

Borrar una instancia

Para borrar una instancia, haz lo siguiente:

Consola de Google Cloud

  1. Ve a la página Lustre administrado en la consola de Google Cloud .

    Ir a Managed Lustre

  2. Selecciona el menú de tres puntos junto a la instancia que deseas borrar.

  3. Selecciona Borrar instancia. Vuelve a hacer clic en Borrar para confirmar la eliminación.

gcloud CLI

Usa el comando gcloud lustre instances delete:

gcloud lustre instances delete INSTANCE_NAME --location=LOCATION

Se te solicitará que confirmes la eliminación. Escribe Y o presiona Intro para continuar.

REST

Para borrar una instancia con la API de REST, envía una solicitud al siguiente extremo:

DELETE https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/INSTANCE_NAME
Authorization: Bearer [YOUR_ACCESS_TOKEN]

Donde se deben especificar los siguientes valores:

  • PROJECT_ID es el ID de tu proyecto de Google Cloud .

  • ZONE es la Google Cloud zona en la que se encuentra la instancia.

  • INSTANCE_NAME es el nombre de la instancia de Lustre administrada que se borrará.

Consulta la referencia de la API de instances.delete para obtener más detalles.

Las solicitudes de eliminación son solicitudes de larga duración y muestran un ID de operación que se puede consultar para conocer el estado de la operación. Consulta la referencia de operations.get para obtener más detalles.