Labels für Projekte erstellen und aktualisieren

Mit Labels können Sie Ihre Google Cloud -Projekte organisieren und die Kosten team- oder umgebungsübergreifend im Blick behalten. Sie können Projektlabels mit derGoogle Cloud Console, der Google Cloud CLI oder der Cloud Resource Manager API verwalten.

Labels gelten nur für Projekte. Ordner und Organisationsressourcen unterstützen keine Labels. Labels, die Sie an ein Projekt anhängen, werden nicht automatisch an untergeordnete Ressourcen weitergegeben. Informationen zum Anwenden oder Aktualisieren von Labels für bestimmte Dienstressourcen wie Compute Engine-Instanzen oder Cloud Storage-Buckets finden Sie in der Dokumentation zur Ressource oder unter Dienste, die Labels unterstützen. Pub/Sub unterstützt beispielsweise Labels für die Abrechnung des Durchsatzes von Themen und Abos, aber SKUs für die Abrechnung von ausgehendem Traffic unterstützen keine Labels.

Labels für Projekte erstellen

Console

So fügen Sie Labels zu einem Projekt hinzu:

  1. Öffnen Sie in der Google Cloud Console die Seite Labels.

    Seite "Labels" öffnen

  2. Wählen Sie ein Projekt aus dem Drop-down-Menü Projekt auswählen aus.

  3. Klicken Sie auf + Label hinzufügen, um einen neuen Labeleintrag hinzuzufügen. Geben Sie für jedes Label einen Schlüssel und einen Wert ein.

  4. Wenn Sie keine weiteren Labels hinzufügen möchten, klicken Sie auf Speichern.

So fügen Sie Labels für mehrere Projekte gleichzeitig hinzu:

  1. Öffnen Sie in der Google Cloud Console die Seite Ressourcen verwalten.

    Zur Seite "Ressourcen verwalten"

  2. Wählen Sie auf der Seite Ressourcen verwalten die Projekte aus, für die Sie Labels hinzufügen möchten.

  3. Klicken Sie im Infofeld auf dem Tab Labels auf + Labels hinzufügen und geben Sie einen Schlüssel und einen Wert für jedes hinzuzufügende Label ein.

  4. Wenn Sie keine weiteren Labels hinzufügen möchten, klicken Sie auf Speichern.

Nachdem Sie Labels hinzugefügt haben, können Sie Projekte filtern, indem Sie einen Label-Schlüssel oder -Wert in das Filterfeld über der Projektliste eingeben. Im Filterfeld werden Schlüssel und Werte vorgeschlagen, damit Sie eine Vorschau der Ergebnisse anzeigen lassen können.

gcloud

Wenn Sie ein neues Projekt mit Labels über die gcloud CLI erstellen möchten, verwenden Sie den Befehl gcloud projects create mit dem Flag --labels:

gcloud projects create PROJECT_ID \
    --labels=KEY1=VALUE1,KEY2=VALUE2

Wenn Sie einem vorhandenen Projekt Labels hinzufügen möchten, verwenden Sie den Befehl gcloud projects update mit dem Flag --update-labels:

gcloud projects update PROJECT_ID \
    --update-labels=KEY1=VALUE1,KEY2=VALUE2

Wobei:

  • PROJECT_ID ist die ID des Projekts, das Sie erstellen oder aktualisieren möchten.
  • KEY1=VALUE1 ist ein Schlüssel/Wert-Paar für das Label, das Sie hinzufügen möchten.

REST

Wenn Sie ein neues Projekt mit einem Label erstellen möchten, fügen Sie das Feld labels ein, wenn Sie eine POST-Anfrage an die Methode projects.create senden:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "PROJECT_ID",
    "displayName": "PROJECT_NAME",
    "labels": {
      "environment": "development"
    }
  }' \
  "https://cloudresourcemanager.googleapis.com/v3/projects"

Wenn Sie einem vorhandenen Projekt Labels hinzufügen möchten, verwenden Sie die Methode projects.patch:

curl -X PATCH \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "labels": {
      "environment": "development"
    }
  }' \
  "https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_ID?updateMask=labels"

Labels für Projekte aktualisieren

Console

So aktualisieren Sie Labels für ein einzelnes Projekt:

  1. Öffnen Sie in der Google Cloud Console die Seite Labels.

    Seite "Labels" öffnen

  2. Wählen Sie ein Projekt aus dem Drop-down-Menü Projekt auswählen.

  3. Aktualisieren Sie die Labels für Ihr Projekt:

    1. Wenn Sie ein Label bearbeiten möchten, klicken Sie auf den Wert, den Sie bearbeiten möchten, und nehmen Sie die gewünschten Änderungen vor.
    2. Um ein Label zu löschen, halten Sie den Mauszeiger über den Schlüssel oder Wert und klicken Sie dann auf .

  4. Wenn Sie keine weiteren Labels aktualisieren möchten, klicken Sie auf Speichern.

So aktualisieren Sie Labels für mehrere Projekte gleichzeitig:

  1. Öffnen Sie in der Google Cloud Console die Seite Ressourcen verwalten.

    Zur Seite "Ressourcen verwalten"

  2. Wählen Sie auf der Seite Ressourcen verwalten die Projekte aus, für die Sie Labels aktualisieren möchten.

  3. Klicken Sie im Infofeld auf den Tab Labels und aktualisieren Sie Labels für die ausgewählten Projekte:

    1. Wenn Sie ein Label bearbeiten möchten, klicken Sie auf den Wert, den Sie bearbeiten möchten, und nehmen Sie die gewünschten Änderungen vor.
    2. Um ein Label zu löschen, halten Sie den Mauszeiger über den Schlüssel oder Wert und klicken Sie dann auf .

  4. Wenn Sie keine weiteren Labels aktualisieren möchten, klicken Sie auf Speichern.

gcloud

Wenn Sie Labels für ein Projekt mit der gcloud CLI aktualisieren möchten, verwenden Sie den Befehl gcloud projects update mit dem Flag --update-labels, --remove-labels oder --clear-labels.

So fügen Sie Labels hinzu oder aktualisieren sie:

gcloud projects update PROJECT_ID \
    --update-labels=KEY1=VALUE1,KEY2=VALUE2

So entfernen Sie bestimmte Labels:

gcloud projects update PROJECT_ID \
    --remove-labels=KEY1,KEY2

So entfernen Sie alle Labels aus einem Projekt:

gcloud projects update PROJECT_ID \
    --clear-labels

REST

Wenn Sie die Labels eines Projekts über die API aktualisieren möchten, senden Sie eine PATCH-Anfrage an die Methode projects.patch:

curl -X PATCH \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "labels": {
      "color": "red"
    }
  }' \
  "https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_ID?updateMask=labels"

Dabei ist PROJECT_ID die ID des Projekts, das Sie aktualisieren möchten.