Hyperdisk-Pool erstellen

In diesem Dokument wird beschrieben, wie Sie Hyperdisk-Pools erstellen. Hyperdisk-Pools sind Blockspeicherressourcen, mit denen Sie Ihre Hyperdisk-Blockspeicherressourcen insgesamt verwalten können. Hyperdisk-Pools sind in den folgenden Varianten verfügbar:

  • Hyperdisk-Speicherpools: für die meisten Arbeitslasten empfohlen
  • Hyperdisk-Exapools: Empfohlen für sehr große Arbeitslasten, die mehr als 100 GiB/s gleichzeitige Leistung erfordern

Informationen zu den verschiedenen Arten von Hyperdisk-Pools finden Sie unter Hyperdisk-Pools – Übersicht.

Hinweise

  • Richten Sie die Authentifizierung ein, falls Sie dies noch nicht getan haben. Bei der Authentifizierung wird Ihre Identität für den Zugriff auf Google Cloud Dienste und APIs überprüft. Zum Ausführen von Code oder Beispielen aus einer lokalen Entwicklungsumgebung können Sie sich so bei der Compute Engine authentifizieren:

    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. Installieren Sie die Google Cloud CLI. Initialisieren Sie die Google Cloud CLI nach der Installation mit dem folgenden Befehl: 

      gcloud init

      Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

    2. Set a default region and zone.

    Go

    Wenn Sie die Go -Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung verwenden möchten, installieren und initialisieren Sie die gcloud CLI und richten Sie dann die Standardanmeldedaten für Anwendungen mit Ihren Nutzeranmeldedaten ein.

      Installieren Sie die Google Cloud CLI.

      Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

      If you're using a local shell, then create local authentication credentials for your user account: 

      gcloud auth application-default login

      You don't need to do this if you're using Cloud Shell.

      If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

    Weitere Informationen finden Sie unter Set up authentication for a local development environment.

    Java

    Wenn Sie die Java -Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung verwenden möchten, installieren und initialisieren Sie die gcloud CLI und richten Sie dann die Standardanmeldedaten für Anwendungen mit Ihren Nutzeranmeldedaten ein.

      Installieren Sie die Google Cloud CLI.

      Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

      If you're using a local shell, then create local authentication credentials for your user account: 

      gcloud auth application-default login

      You don't need to do this if you're using Cloud Shell.

      If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

    Weitere Informationen finden Sie unter Set up authentication for a local development environment.

    Node.js

    Wenn Sie die Node.js -Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung verwenden möchten, installieren und initialisieren Sie die gcloud CLI und richten Sie dann die Standardanmeldedaten für Anwendungen mit Ihren Nutzeranmeldedaten ein.

      Installieren Sie die Google Cloud CLI.

      Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

      If you're using a local shell, then create local authentication credentials for your user account: 

      gcloud auth application-default login

      You don't need to do this if you're using Cloud Shell.

      If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

    Weitere Informationen finden Sie unter Set up authentication for a local development environment.

    REST

    Wenn Sie die REST API-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung verwenden möchten, verwenden Sie die Anmeldedaten, die Sie der gcloud CLI bereitstellen.

      Installieren Sie die Google Cloud CLI.

      Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

    Weitere Informationen finden Sie in der Dokumentation zur Google Cloud -Authentifizierung unter Für die Verwendung von REST authentifizieren.

Erforderliche Rollen und Berechtigungen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für das Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Erstellen eines Hyperdisk-Pools benötigen:

  • Compute-Instanzadministrator (Version 1) (roles/compute.instanceAdmin.v1)
  • Verbindung zu einer VM-Instanz herstellen, die als Dienstkonto ausgeführt werden kann: Dienstkontonutzer (v1) (roles/iam.serviceAccountUser-Rolle)

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierten Rollen enthalten die Berechtigungen, die zum Erstellen eines Hyperdisk-Pools erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind zum Erstellen eines Hyperdisk-Pools erforderlich:

  • compute.storagePools.create für das Projekt
  • compute.storagePools.setLabels für das Projekt

Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

Beschränkungen

Beim Erstellen von Hyperdisk Storage Pools gelten die folgenden Einschränkungen:

Ressourcenlimits:

  • Sie können einen Hyperdisk Storage Pool mit bis zu 5 PiB an bereitgestellter Kapazität erstellen.
  • Sie können maximal 5 Speicherpools pro Stunde erstellen.
  • Sie können maximal 10 Speicherpools pro Tag erstellen.
  • Sie können maximal 10 Speicherpools pro Projekt erstellen.
  • Sie können das Bereitstellungsmodell für einen Pool nicht ändern. Sie können beispielsweise einen Speicherpool mit Standardkapazität nicht in einen Speicherpool mit erweiterter Kapazität oder einen Speicherpool mit erweiterter Leistung in einen Speicherpool mit Standardleistung ändern.
  • Pools sind eine zonale Ressource.
  • Sie können bis zu 10.000 Laufwerke in einem Speicherpool erstellen.
  • Sie können Hyperdisk Storage Pools nur mit Compute Engine verwenden. Cloud SQL-Instanzen können keine Hyperdisk Storage Pools verwenden.
  • Sie können die bereitgestellte Kapazität oder Leistung eines Speicherpools innerhalb von 24 Stunden höchstens zweimal ändern.
  • Sie können nur Hyperdisk Balanced-Laufwerke in einem Hyperdisk Balanced-Pool und nur Hyperdisk Throughput-Laufwerke in einem Hyperdisk Throughput-Pool erstellen.
  • Wenn Sie die bereitgestellte Kapazität, IOPS oder den Durchsatz eines Exapools ändern möchten, müssen Sie sich an Ihr Accountteam wenden.
  • Wenden Sie sich an Ihr Accountteam, um einen Exapool zu löschen.

Limits für Laufwerke in einem Speicherpool:

  • In einem Pool können nur neue Laufwerke im selben Projekt und in derselben Zone erstellt werden.
  • Sie können keine Laufwerke in einen oder aus einem Pool verschieben. Wenn Sie ein Laufwerk in einen oder aus einem Pool verschieben möchten, müssen Sie das Laufwerk aus einem Snapshot neu erstellen. Weitere Informationen finden Sie unter Laufwerkstyp ändern.
  • Wenn Sie Bootlaufwerke in einem Pool erstellen möchten, müssen Sie einen Hyperdisk Balanced Storage Pool oder einen Hyperdisk Balanced Exapool verwenden.
  • Pools unterstützen keine regionalen Laufwerke.
  • Folgendes ist nicht möglich für Laufwerke in einem Pool: Klonen ,Instant Snapshots erstellen oderAsynchrone Replikation konfigurieren.

Kapazitätsbereiche und bereitgestellte Leistungsgrenzen

Beim Erstellen eines Speicherpools dürfen die bereitgestellte Kapazität, die IOPS und der Durchsatz die in Limits für Pools beschriebenen Limits nicht überschreiten.

Hyperdisk Storage Pool erstellen

Verwenden Sie zum Erstellen eines neuen Hyperdisk Storage Pools die Google Cloud Console, die Google Cloud CLI oder REST. Beim Erstellen eines Speicherpools müssen Sie die folgenden Attribute angeben:

  • Zone
  • Speicherpooltyp
  • Modell für die Kapazitätsbereitstellung
  • Bereitgestellte Poolkapazität
  • Leistungsbereitstellungstyp

  • Vom Pool bereitgestellte IOPS und Durchsatz

Console

  1. Rufen Sie in der Google Cloud Console die Seite Speicherpool erstellen auf.
    Zur Seite „Storage Pool erstellen“
  2. Geben Sie im Feld Name einen eindeutigen Namen für den Speicherpool ein.
  3. Optional: Geben Sie im Feld Beschreibung eine Beschreibung für den Speicherpool ein.
  4. Wählen Sie die Region und die Zone aus, in der der Speicherpool erstellt werden soll.
  5. Wählen Sie einen Wert für den Storage Pool-Typ aus.

  6. Wählen Sie im Feld Kapazitätstyp einen Bereitstellungstyp aus und geben Sie die Kapazität an, die für den Speicherpool bereitgestellt werden soll. Sie können eine Größe von 10 TiB bis 1 PiB angeben.

    Zum Erstellen eines Speicherpools mit großer Kapazität müssen Sie möglicherweise eine Kontingentanpassung anfordern.

  7. Wählen Sie im Feld Leistungstyp einen Bereitstellungstyp aus. Sie können die folgenden Bereitstellungstypen mit Hyperdisk Storage Pools verwenden:

    • Standardkapazität: Die für jedes im Speicherpool erstellte Laufwerk bereitgestellte Kapazität wird von der insgesamt bereitgestellten Kapazität des Speicherpools abgezogen.
    • Erweiterte Kapazität: Der Speicherpool profitiert von Thin Provisioning und Datenreduzierung. Nur die Menge der tatsächlich geschriebenen Daten wird von der insgesamt bereitgestellten Kapazität des Speicherpools abgezogen.
    • Standardleistung: Die für jedes im Speicherpool erstellte Laufwerk bereitgestellte Leistung wird von der insgesamt bereitgestellten Leistung des Speicherpools abgezogen.
    • Erweiterte Leistung: Die für jede Festplatte bereitgestellte Leistung profitiert von Thin Provisioning. Nur die von einem Laufwerk genutzte Leistung wird von der insgesamt bereitgestellten Leistung des Speicherpools abgezogen.

  8. Geben Sie bei Hyperdisk Balanced Storage Pools im Feld Bereitgestellte IOPS die IOPS ein, die für den Speicherpool bereitgestellt werden sollen.

  9. Geben Sie für einen Hyperdisk Throughput Storage Pool oder einen Hyperdisk Balanced Storage Pool im Feld Bereitgestellter Durchsatz den Durchsatz ein, der für den Speicherpool bereitgestellt werden soll.

  10. Klicken Sie auf Senden, um den Speicherpool zu erstellen.

gcloud

Verwenden Sie zum Erstellen eines Hyperdisk Storage Pools den Befehl gcloud compute storage-pools create.

gcloud compute storage-pools create NAME  \
    --zone=ZONE   \
    --storage-pool-type=STORAGE_POOL_TYPE   \
    --capacity-provisioning-type=CAPACITY_TYPE \
    --provisioned-capacity=POOL_CAPACITY   \
    --performance-provisioning-type=PERFORMANCE_TYPE \
    --provisioned-iops=IOPS   \
    --provisioned-throughput=THROUGHPUT   \
    --description=DESCRIPTION

Ersetzen Sie Folgendes:

  • NAME: der eindeutige Name des Speicherpools.
  • ZONE: die Zone, in der der Speicherpool erstellt werden soll, z. B. us-central1-a.
  • STORAGE_POOL_TYPE: der Typ des Laufwerks, das im Speicherpool gespeichert werden soll. Die zulässigen Werte sind hyperdisk-throughput und hyperdisk-balanced.
  • CAPACITY_TYPE: Optional: der Typ der Kapazitätsbereitstellung des Speicherpools. Die zulässigen Werte sind advanced, standard und . Wenn keine Angabe erfolgt, wird der Wert advanced verwendet.
  • POOL_CAPACITY: die Gesamtkapazität, die für den neuen Speicherpool bereitgestellt werden soll, standardmäßig in GiB angegeben.
  • PERFORMANCE_TYPE: Optional: der Typ der Leistungsbereitstellung des Speicherpools. Die zulässigen Werte sind advanced, standard und . Wenn keine Angabe erfolgt, wird der Wert advanced verwendet.
  • IOPS: die IOPS, die für den Speicherpool bereitgestellt werden sollen. Sie können dieses Flag nur mit Hyperdisk Balanced Storage Pools verwenden.
  • THROUGHPUT: der Durchsatz in MB/s, der für den Speicherpool bereitgestellt werden soll.
  • DESCRIPTION: Optional: ein Textstring, der den Speicherpool beschreibt.

REST

Erstellen Sie eine POST-Anfrage, um einen Hyperdisk Storage Pool mit der Methode storagePools.insert zu erstellen.

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

{
    "name": "NAME",
    "description": "DESCRIPTION",
    "poolProvisionedCapacityGb": "POOL_CAPACITY",
    "storagePoolType": "projects/PROJECT_ID/zones/ZONE/storagePoolTypes/STORAGE_POOL_TYPE",
    "poolProvisionedIops": "IOPS",
    "poolProvisionedThroughput": "THROUGHPUT",
    "capacityProvisioningType": "CAPACITY_TYPE",
    "performanceProvisioningType": "PERFORMANCE_TYPE"
}

Ersetzen Sie Folgendes:

  • PROJECT_ID: die Projekt-ID
  • ZONE: die Zone, in der der Speicherpool erstellt werden soll, z. B. us-central1-a.
  • NAME: ein eindeutiger Name für den Speicherpool .
  • DESCRIPTION: Optional: ein Textstring, der den Speicherpool beschreibt.
  • POOL_CAPACITY: die Gesamtkapazität, die für den neuen Speicherpool bereitgestellt werden soll, standardmäßig in GiB angegeben.
  • STORAGE_POOL_TYPE: der Typ des Laufwerks, das im Speicherpool gespeichert werden soll. Die zulässigen Werte sind hyperdisk-throughput und hyperdisk-balanced.
  • IOPS: Optional: die IOPS, die für den Speicherpool bereitgestellt werden sollen. Sie können dieses Flag nur mit Hyperdisk Balanced Storage Pools verwenden.
  • THROUGHPUT: Optional: Der Durchsatz in MB/s, der für den Speicherpool bereitgestellt werden soll.
  • CAPACITY_TYPE: Optional: der Typ der Kapazitätsbereitstellung des Speicherpools. Die zulässigen Werte sind advanced, standard und . Wenn keine Angabe erfolgt, wird der Wert advanced verwendet.
  • PERFORMANCE_TYPE: Optional: der Typ der Leistungsbereitstellung des Speicherpools. Die zulässigen Werte sind advanced, standard und . Wenn keine Angabe erfolgt, wird der Wert advanced verwendet.

Go


// createHyperdiskStoragePool creates a new Hyperdisk storage pool in the specified project and zone.
func createHyperdiskStoragePool(w io.Writer, projectId, zone, storagePoolName, storagePoolType string) error {
	// projectID := "your_project_id"
	// zone := "europe-west4-b"
	// storagePoolName := "your_storage_pool_name"
	// storagePoolType := "projects/**your_project_id**/zones/europe-west4-b/diskTypes/hyperdisk-balanced"

	ctx := context.Background()
	client, err := compute.NewStoragePoolsRESTClient(ctx)
	if err != nil {
		return fmt.Errorf("NewStoragePoolsRESTClient: %v", err)
	}
	defer client.Close()

	// Create the storage pool resource
	resource := &computepb.StoragePool{
		Name:                        proto.String(storagePoolName),
		Zone:                        proto.String(zone),
		StoragePoolType:             proto.String(storagePoolType),
		CapacityProvisioningType:    proto.String("advanced"),
		PerformanceProvisioningType: proto.String("advanced"),
		PoolProvisionedCapacityGb:   proto.Int64(10240),
		PoolProvisionedIops:         proto.Int64(10000),
		PoolProvisionedThroughput:   proto.Int64(1024),
	}

	// Create the insert storage pool request
	req := &computepb.InsertStoragePoolRequest{
		Project:             projectId,
		Zone:                zone,
		StoragePoolResource: resource,
	}

	// Send the insert storage pool request
	op, err := client.Insert(ctx, req)
	if err != nil {
		return fmt.Errorf("Insert storage pool request failed: %v", err)
	}

	// Wait for the insert storage pool operation to complete
	if err = op.Wait(ctx); err != nil {
		return fmt.Errorf("unable to wait for the operation: %w", err)
	}

	// Retrieve and return the created storage pool
	storagePool, err := client.Get(ctx, &computepb.GetStoragePoolRequest{
		Project:     projectId,
		Zone:        zone,
		StoragePool: storagePoolName,
	})
	if err != nil {
		return fmt.Errorf("Get storage pool request failed: %v", err)
	}

	fmt.Fprintf(w, "Hyperdisk Storage Pool created: %v\n", storagePool.GetName())
	return nil
}

Java 

import com.google.cloud.compute.v1.InsertStoragePoolRequest;
import com.google.cloud.compute.v1.Operation;
import com.google.cloud.compute.v1.StoragePool;
import com.google.cloud.compute.v1.StoragePoolsClient;
import java.io.IOException;
import java.util.concurrent.ExecutionException;
import java.util.concurrent.TimeUnit;
import java.util.concurrent.TimeoutException;

public class CreateHyperdiskStoragePool {
  public static void main(String[] args)
          throws IOException, ExecutionException, InterruptedException, TimeoutException {
    // TODO(developer): Replace these variables before running the sample.
    // Project ID or project number of the Google Cloud project you want to use.
    String projectId = "YOUR_PROJECT_ID";
    // Name of the zone in which you want to create the storagePool.
    String zone = "us-central1-a";
    // Name of the storagePool you want to create.
    String storagePoolName = "YOUR_STORAGE_POOL_NAME";
    // The type of disk you want to create.
    // Storage types can be "hyperdisk-throughput" or "hyperdisk-balanced"
    String storagePoolType = String.format(
        "projects/%s/zones/%s/storagePoolTypes/hyperdisk-balanced", projectId, zone);
    // Optional: the capacity provisioning type of the storage pool.
    // The allowed values are advanced and standard. If not specified, the value advanced is used.
    String capacityProvisioningType = "advanced";
    // The total capacity to provision for the new storage pool, specified in GiB by default.
    long provisionedCapacity = 128;
    // the IOPS to provision for the storage pool.
    // You can use this flag only with Hyperdisk Balanced Storage Pools.
    long provisionedIops = 3000;
    // the throughput in MBps to provision for the storage pool.
    long provisionedThroughput = 140;
    // The allowed values are low-casing strings "advanced" and "standard".
    // If not specified, "advanced" is used.
    String performanceProvisioningType = "advanced";

    createHyperdiskStoragePool(projectId, zone, storagePoolName, storagePoolType,
            capacityProvisioningType, provisionedCapacity, provisionedIops,
        provisionedThroughput, performanceProvisioningType);
  }

  // Creates a hyperdisk storagePool in a project
  public static StoragePool createHyperdiskStoragePool(String projectId, String zone,
        String storagePoolName, String storagePoolType, String capacityProvisioningType,
        long capacity, long iops, long throughput, String performanceProvisioningType)
          throws IOException, ExecutionException, InterruptedException, TimeoutException {
    // Initialize client that will be used to send requests. This client only needs to be created
    // once, and can be reused for multiple requests.
    try (StoragePoolsClient client = StoragePoolsClient.create()) {
      // Create a storagePool.
      StoragePool resource = StoragePool.newBuilder()
              .setZone(zone)
              .setName(storagePoolName)
              .setStoragePoolType(storagePoolType)
              .setCapacityProvisioningType(capacityProvisioningType)
              .setPoolProvisionedCapacityGb(capacity)
              .setPoolProvisionedIops(iops)
              .setPoolProvisionedThroughput(throughput)
              .setPerformanceProvisioningType(performanceProvisioningType)
              .build();

      InsertStoragePoolRequest request = InsertStoragePoolRequest.newBuilder()
              .setProject(projectId)
              .setZone(zone)
              .setStoragePoolResource(resource)
              .build();

      // Wait for the insert disk operation to complete.
      Operation operation = client.insertAsync(request).get(1, TimeUnit.MINUTES);

      if (operation.hasError()) {
        System.out.println("StoragePool creation failed!");
        throw new Error(operation.getError().toString());
      }

      // Wait for server update
      TimeUnit.SECONDS.sleep(10);

      StoragePool storagePool = client.get(projectId, zone, storagePoolName);

      System.out.printf("Storage pool '%s' has been created successfully", storagePool.getName());

      return storagePool;
    }
  }
}

Node.js 

// Import the Compute library
const computeLib = require('@google-cloud/compute');
const compute = computeLib.protos.google.cloud.compute.v1;

// Instantiate a storagePoolClient
const storagePoolClient = new computeLib.StoragePoolsClient();
// Instantiate a zoneOperationsClient
const zoneOperationsClient = new computeLib.ZoneOperationsClient();

/**
 * TODO(developer): Update/uncomment these variables before running the sample.
 */
// Project ID or project number of the Google Cloud project you want to use.
const projectId = await storagePoolClient.getProjectId();
// Name of the zone in which you want to create the storagePool.
const zone = 'us-central1-a';
// Name of the storagePool you want to create.
// storagePoolName = 'storage-pool-name';
// The type of disk you want to create. This value uses the following format:
// "projects/{projectId}/zones/{zone}/storagePoolTypes/(hyperdisk-throughput|hyperdisk-balanced)"
const storagePoolType = `projects/${projectId}/zones/${zone}/storagePoolTypes/hyperdisk-balanced`;
// Optional: The capacity provisioning type of the storage pool.
// The allowed values are advanced and standard. If not specified, the value advanced is used.
const capacityProvisioningType = 'advanced';
// The total capacity to provision for the new storage pool, specified in GiB by default.
const provisionedCapacity = 10240;
// The IOPS to provision for the storage pool.
// You can use this flag only with Hyperdisk Balanced Storage Pools.
const provisionedIops = 10000;
// The throughput in MBps to provision for the storage pool.
const provisionedThroughput = 1024;
// Optional: The performance provisioning type of the storage pool.
// The allowed values are advanced and standard. If not specified, the value advanced is used.
const performanceProvisioningType = 'advanced';

async function callCreateComputeHyperdiskPool() {
  // Create a storagePool.
  const storagePool = new compute.StoragePool({
    name: storagePoolName,
    poolProvisionedCapacityGb: provisionedCapacity,
    poolProvisionedIops: provisionedIops,
    poolProvisionedThroughput: provisionedThroughput,
    storagePoolType,
    performanceProvisioningType,
    capacityProvisioningType,
    zone,
  });

  const [response] = await storagePoolClient.insert({
    project: projectId,
    storagePoolResource: storagePool,
    zone,
  });

  let operation = response.latestResponse;

  // Wait for the create storage pool operation to complete.
  while (operation.status !== 'DONE') {
    [operation] = await zoneOperationsClient.wait({
      operation: operation.name,
      project: projectId,
      zone: operation.zone.split('/').pop(),
    });
  }

  console.log(`Storage pool: ${storagePoolName} created.`);
}

await callCreateComputeHyperdiskPool();

Hyperdisk-Exapool erstellen

Hyperdisk Exapools sind allgemein über eine Zulassungsliste verfügbar. Wenn Sie einen Hyperdisk-Exapool erstellen möchten, wenden Sie sich an Ihr Account-Management-Team.

Nächste Schritte