Administrar el grupo de almacenamiento de hiperdisco

Este documento explica cómo enumerar, describir, modificar y eliminar grupos de almacenamiento.

Antes de comenzar

  • Si aún no lo has hecho, configura la autenticación. La autenticación es el proceso mediante el cual se verifica su identidad para acceder a Google Cloud servicios y API. Para ejecutar código o muestras 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. After installing the Google Cloud CLI, initialize it by running the following command: 

      gcloud init

      If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

    2. Set a default region and zone.

      3. REST

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

        After installing the Google Cloud CLI, initialize it by running the following command: 

        gcloud init

        If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

      Para obtener más información, consulta Autentica para usar REST en la documentación de autenticación de Google Cloud .

Roles y permisos necesarios

Para obtener los permisos que necesita para administrar un grupo de almacenamiento, solicite a su administrador que le otorgue las siguientes funciones de IAM en el proyecto:

  • Administrador de instancias informáticas (v1) ( roles/compute.instanceAdmin.v1 )
  • Para conectarse a una instancia de VM que se puede ejecutar como una cuenta de servicio: Usuario de cuenta de servicio (v1) (rol roles/iam.serviceAccountUser )

Para obtener más información sobre cómo otorgar roles, consulte Administrar el acceso a proyectos, carpetas y organizaciones .

Estos roles predefinidos contienen los permisos necesarios para administrar un grupo de almacenamiento. Para ver los permisos exactos que se requieren, expanda la sección Permisos requeridos :

Permisos requeridos

Se requieren los siguientes permisos para administrar un grupo de almacenamiento:

  • Para enumerar los grupos de almacenamiento para un proyecto y una zona: compute.storagePools.list
  • Para enumerar los discos dentro de un grupo de almacenamiento: compute.storagePools.get
  • Para ver las propiedades de un grupo de almacenamiento: compute.storagePools.get
  • Para actualizar la capacidad aprovisionada o el rendimiento de un grupo de almacenamiento:
    • compute.storagePools.get
    • compute.storagePools.update
  • Para eliminar un grupo de almacenamiento: compute.storagePools.delete

Es posible que también pueda obtener estos permisos con roles personalizados u otros roles predefinidos .

Limitaciones

Tome nota de las siguientes limitaciones al administrar grupos de almacenamiento de hiperdisco:

  • Puede cambiar la capacidad aprovisionada o el rendimiento de un grupo de almacenamiento como máximo dos veces en un período de 24 horas.
  • No puede cambiar el modelo de aprovisionamiento de un grupo; no puede cambiar un grupo de almacenamiento de capacidad estándar a un grupo de almacenamiento de capacidad avanzada o un grupo de almacenamiento de rendimiento avanzado a un grupo de almacenamiento de rendimiento estándar.
  • No se permite mover discos dentro o fuera de un grupo de almacenamiento. Para mover un disco dentro o fuera de un grupo de almacenamiento, debe volver a crear el disco a partir de una instantánea. Para obtener más información, consulte Cambiar el tipo de disco .
  • No puede clonar , crear instantáneas instantáneas ni configurar la replicación asincrónica para discos en un grupo de almacenamiento.
  • Puede eliminar como máximo 5 grupos de almacenamiento por hora.
  • El comando de administración del grupo de almacenamiento tiene éxito o falla inmediatamente, pero la acción puede tardar hasta 5 minutos en completarse y hasta 30 minutos hasta que aparezcan los cambios.

Para obtener la lista completa de limitaciones del grupo de almacenamiento de Hyperdisk, consulte Limitaciones de los grupos de almacenamiento .

Rangos de valores al modificar grupos de almacenamiento

Al crear un grupo de almacenamiento, los nuevos valores de tamaño, IOPS y rendimiento deben estar dentro de los límites del tipo de grupo de almacenamiento que está modificando. Además, solo puede especificar valores nuevos utilizando valores incrementales admitidos.

Para conocer los límites detallados del aprovisionamiento de rendimiento, consulte Límites para grupos de almacenamiento .

Enumerar los grupos de almacenamiento para un proyecto

Para ver los grupos de almacenamiento que se crearon en un proyecto, use la consola de Google Cloud, la CLI de Google Cloud o REST.

Consola

  1. Vaya a la página Grupos de almacenamiento en la consola de Google Cloud.
    Vaya a la página de grupos de almacenamiento

    La página muestra los grupos de almacenamiento creados dentro del proyecto seleccionado.

  2. Opcional: utilice la barra de filtro para mostrar solo los grupos de almacenamiento que coincidan con los parámetros del filtro, como Ubicación, Tipo, Nombre y Capacidad restante del grupo.

nube de gcloud

Para enumerar todos los grupos de almacenamiento creados dentro del proyecto actual, usa el comando gcloud compute storage-pools list .

gcloud compute storage-pools list

Para limitar los resultados a una región o zona específica, puede utilizar el indicador --filter , por ejemplo:

  • --filter="zone ~ us
  • --filter="zone=us-east4-c"

DESCANSAR

Para mostrar los grupos de almacenamiento creados dentro de un proyecto y una zona, cree una solicitud GET utilizando el método storagePools.list .

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/storagePools

Reemplace lo siguiente:

  • PROJECT_ID : el ID del proyecto que contiene el grupo de almacenamiento
  • ZONE : la zona donde se encuentra el grupo de almacenamiento, por ejemplo, us-central1-a .

Enumerar los discos en un grupo de almacenamiento

Para obtener una lista de los discos creados en un grupo de almacenamiento, use la consola de Google Cloud, la CLI de Google Cloud o REST.

Consola

  1. Vaya a la página Grupos de almacenamiento en la consola de Google Cloud.
    Vaya a la página de grupos de almacenamiento

    La página muestra los grupos de almacenamiento creados dentro del proyecto seleccionado.

  2. En el campo Nombre , haga clic en el nombre del grupo de almacenamiento que desea ver.

    Se abre la página Administrar grupo de almacenamiento .

  3. En la sección Discos del grupo de almacenamiento , puede ver los discos que se crearon en el grupo de almacenamiento.

nube de gcloud

Para enumerar los discos que se crearon en un grupo de almacenamiento, usa el comando gcloud compute storage-pools list-disks .

gcloud compute storage-pools list-disks STORAGE_POOL_NAME  \
    [--zone=ZONE]

Reemplace lo siguiente:

  • STORAGE_POOL_NAME : el nombre del grupo de almacenamiento.
  • ZONE : Opcional. La zona en la que se encuentra el grupo de almacenamiento, por ejemplo, us-central1-a .

DESCANSAR

Para enumerar los discos que utilizan un grupo de almacenamiento, cree una solicitud GET utilizando el método storagePools.listDisks .

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/storagePools/STORAGE_POOL_NAME/listDisks

Reemplace lo siguiente:

  • PROJECT_ID : el ID del proyecto que contiene el grupo de almacenamiento
  • ZONE : la zona donde se encuentra el grupo de almacenamiento, por ejemplo, us-central1-a .
  • STORAGE_POOL_NAME : el nombre del grupo de almacenamiento.

Describir un grupo de almacenamiento

Para ver los detalles de un grupo de almacenamiento, puede utilizar la consola de Google Cloud, la CLI de Google Cloud o REST.

Consola

  1. Vaya a la página Grupos de almacenamiento en la consola de Google Cloud.
    Vaya a la página de grupos de almacenamiento

  2. Para cada grupo de almacenamiento enumerado en la página, puede ver la siguiente información:

    • Estado
    • Nombre
    • Ubicación
    • tipo de piscina
    • Capacidad de la piscina
    • Capacidad restante de la piscina
    • IOPS de grupo
    • IOPS restantes del grupo
    • Número de discos creados en el grupo

  3. En el campo Nombre , haga clic en el nombre del grupo de almacenamiento que desea ver.

    Se abre la página Administrar grupo de almacenamiento .

  4. En los mosaicos de la parte superior de la página puede ver la capacidad aprovisionada y utilizada, y el rendimiento y los IOPS aprovisionados y utilizados para el grupo de almacenamiento.

  5. En la sección Configuración del grupo de almacenamiento , puede ver propiedades adicionales del grupo de almacenamiento, como la hora de creación, el tipo de aprovisionamiento de capacidad, el tipo de aprovisionamiento de rendimiento, la cantidad total de discos en el grupo de almacenamiento y los porcentajes de utilización de capacidad, rendimiento e IOPS.

  6. En la sección Discos del grupo de almacenamiento , puede ver información sobre los discos creados en el grupo de almacenamiento.

  7. Opcional: para obtener información adicional sobre el uso del grupo de almacenamiento, puede hacer clic en la pestaña Monitoreo para ver gráficos de varias métricas del grupo de almacenamiento. Para obtener más información, consulte Supervisar grupos de almacenamiento de hiperdisco .

nube de gcloud

Usa el comando gcloud compute storage-pools describe para ver los detalles de un grupo de almacenamiento.

gcloud compute storage-pools describe STORAGE_POOL_NAME  \
    [--zone=ZONE]

Reemplace lo siguiente:

  • STORAGE_POOL_NAME : el nombre único del grupo de almacenamiento.
  • ZONE : Opcional. La zona en la que se encuentra el grupo de almacenamiento, por ejemplo, us-central1-a .

DESCANSAR

Para recuperar detalles sobre un grupo de almacenamiento, cree una solicitud GET utilizando el método storagePools.get .

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/storagePools/STORAGE_POOL_NAME

Reemplace lo siguiente:

  • PROJECT_ID : el ID del proyecto que contiene el grupo de almacenamiento
  • ZONE : la zona donde se encuentra el grupo de almacenamiento, por ejemplo, us-central1-a
  • STORAGE_POOL_NAME : el nombre del grupo de almacenamiento

Actualizar la capacidad aprovisionada, IOPS o rendimiento de un grupo de almacenamiento

Puede aumentar o disminuir la capacidad aprovisionada, IOPS o rendimiento de un grupo de almacenamiento. Para aumentar la capacidad, IOPS o rendimiento de un grupo de almacenamiento, debe tener una cuota disponible para el proyecto y la región.

Consola

  1. Vaya a la página Grupos de almacenamiento en la consola de Google Cloud.
    Vaya a la página de grupos de almacenamiento

  2. En el campo Nombre , haga clic en el nombre del grupo de almacenamiento que desea modificar.

    Se abre la página Administrar grupo de almacenamiento .

  3. Haga clic en Editar .

    Se abre la página Editar grupo de almacenamiento .

  4. Opcional: en el campo Capacidad del grupo de almacenamiento , ingrese el nuevo valor para la capacidad aprovisionada del grupo. El nuevo valor debe ser al menos 1 TiB y como máximo 100 TiB más o menos que el valor actual. El tamaño mínimo no puede ser inferior a 10 TiB y el tamaño máximo no puede ser superior a 1024 TiB.

  5. Opcional: en el campo Rendimiento aprovisionado , ingrese el nuevo valor para el rendimiento aprovisionado.

  6. Opcional: para grupos de almacenamiento de tipo Hiperdisco equilibrado, en el campo IOPS aprovisionadas , ingrese el nuevo valor para las IOPS aprovisionadas.

  7. Haga clic en Guardar para actualizar el grupo de almacenamiento.

nube de gcloud

Usa el comando gcloud compute storage-pools update para modificar un grupo de almacenamiento.

gcloud compute storage-pools update STORAGE_POOL_NAME  \
    --zone=ZONE   \
    --provisioned-capacity=POOL_SIZETiB   \
    --provisioned-iops=IOPS   \
    --provisioned-throughput=THROUGHPUT   \
    --description=DESCRIPTION

Reemplace lo siguiente:

  • STORAGE_POOL_NAME : el nombre del grupo de almacenamiento.
  • ZONE : Opcional: la zona en la que se encuentra el grupo de almacenamiento, por ejemplo, us-central1-a .
  • POOL_SIZE : Opcional: la capacidad aprovisionada del grupo de almacenamiento, en TiB.
  • IOPS : Opcional: el grupo de almacenamiento aprovisionó IOPS. Puede utilizar esta marca solo con grupos de almacenamiento equilibrados de Hyperdisk.
  • THROUGHPUT : Opcional: el rendimiento aprovisionado del grupo de almacenamiento, en MBps.
  • DESCRIPTION : Opcional: una cadena descriptiva para el grupo de almacenamiento.

DESCANSAR

Para actualizar un grupo de almacenamiento, cree una solicitud PATCH utilizando el método storagePools.update .

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/storagePools/STORAGE_POOL_NAME

{
    "description": "DESCRIPTION",
    "poolProvisionedCapacityGb": "SIZE",
    "poolProvisionedIops": "IOPS",
    "poolProvisionedThroughput": "THROUGHPUT"
}

Reemplace lo siguiente:

  • PROJECT_ID : el ID del proyecto
  • ZONE : la zona donde se encuentra el grupo de almacenamiento, por ejemplo, us-central1-a .
  • STORAGE_POOL_NAME : el nombre del grupo de almacenamiento.
  • DESCRIPTION : Opcional: un campo de texto para describir el grupo de almacenamiento.
  • SIZE : Opcional: la nueva capacidad aprovisionada del grupo de almacenamiento, en GiB.
  • IOPS : Opcional: el nuevo valor para las IOPS aprovisionadas del grupo de almacenamiento. Solo puede especificar esta propiedad cuando el grupo de almacenamiento contiene discos de tipo hyperdisk-balanced .
  • THROUGHPUT : Opcional: el nuevo valor para el rendimiento aprovisionado del grupo de almacenamiento, especificado en MBps.

Eliminar un grupo de almacenamiento

Para eliminar o eliminar un grupo de almacenamiento, primero debe eliminar todos los discos dentro del grupo de almacenamiento. Luego puede usar la consola de Google Cloud, la CLI de Google Cloud o REST para eliminar el grupo de almacenamiento.

La eliminación de un grupo de almacenamiento es irreversible. Sin embargo, eliminar un grupo de almacenamiento no elimina ninguna instantánea realizada a partir de discos que se crearon en el grupo de almacenamiento. Debe eliminar las instantáneas por separado.

Consola

  1. Vaya a la página del grupo de almacenamiento en la consola de Google Cloud.
    Vaya a la página del grupo de almacenamiento

  2. En el campo Nombre , haga clic en el nombre del grupo de almacenamiento que desea eliminar.

    Se abre la página Administrar grupo de almacenamiento .

  3. En la sección Discos del grupo de almacenamiento , verifique que no haya ningún disco en la lista para el grupo de almacenamiento.

  4. Haga clic en Eliminar grupo .

nube de gcloud

Usa el comando gcloud compute storage-pools delete para eliminar un grupo de almacenamiento.

gcloud compute storage-pools delete STORAGE_POOL_NAME  \
    --zone=ZONE   \

Reemplace lo siguiente:

  • STORAGE_POOL_NAME : el nombre único del grupo de almacenamiento.
  • ZONE : Opcional: la zona en la que se encuentra el grupo de almacenamiento, por ejemplo, us-central1-a .

DESCANSAR

Para eliminar un grupo de almacenamiento, cree una solicitud DELETE para el método storagePools.delete . 

DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/storagePools/STORAGE_POOL_NAME

Reemplace lo siguiente:

  • PROJECT_ID : el ID del proyecto
  • ZONE : la zona donde se encuentra el grupo de almacenamiento, por ejemplo, us-central1-a .
  • STORAGE_POOL_NAME : el nombre único del grupo de almacenamiento.

¿Qué sigue?