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 Managed Lustre, 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:

Google Cloud Consola de

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

    Ir a Managed Lustre

    Se enumeran las instancias de tu proyecto.

gcloud CLI

Usa el gcloud lustre instances list comando:

gcloud lustre instances list --location=LOCATION

Reemplaza LOCATION por una zona específica para enumerar todas las instancias de esa ubicación. Para ver 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]

Se deben especificar los siguientes valores:

  • PROJECT_ID es tu Google Cloud ID del proyecto.

  • 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.

Obtener una instancia

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

Google Cloud Consola de

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

    Ir a Managed Lustre

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

gcloud CLI

Usa el gcloud lustre instances describe comando:

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]

Se deben especificar los siguientes valores:

  • PROJECT_ID es tu Google Cloud ID del proyecto.

  • ZONE debe ser una zona válida que admita Managed Lustre. Google Cloud Consulta Ubicaciones admitidas para obtener una lista completa.

  • INSTANCE_NAME es el nombre de la instancia de Managed Lustre que se mostrará.

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, haz lo siguiente:

Google Cloud Consola de

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

    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 gcloud lustre instances update comando:

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 exceder la capacidad máxima permitida y debe ser un múltiplo del tamaño del paso. Consulta Aumenta la capacidad de una instancia para obtener más detalles.
  • NEW_DESCRIPTION es un valor nuevo para el campo de descripción, que anula 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"
  }
}

Se deben especificar los siguientes valores:

  • PROJECT_ID es tu Google Cloud ID del proyecto.
  • ZONE es la zona de la instancia Google Cloud .
  • INSTANCE_NAME es el nombre de la instancia de Managed Lustre que se actualizará.
  • UPDATE_MASK es una lista de campos separados por comas para actualizar. Un campo solo se anulará 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 exceder la capacidad máxima permitida y debe ser un múltiplo del tamaño del paso. Consulta Aumenta 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:

Google Cloud Consola de

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

    Ir a Managed Lustre

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

  3. Selecciona Borrar instancia. Para confirmar la eliminación, haz clic en Borrar nuevamente.

gcloud CLI

Usa el gcloud lustre instances delete comando:

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]

Se deben especificar los siguientes valores:

  • PROJECT_ID es tu Google Cloud ID del proyecto.

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

  • INSTANCE_NAME es el nombre de la instancia de Managed Lustre 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 obtener el estado de la operación. Consulta la referencia de operations.get para obtener más detalles.