Labels für Projekte erstellen und aktualisieren

In diesem Dokument erfahren Sie, wie Sie mit der gcloud CLI, der Cloud Resource Manager API und der Cloud de Confiance Console Labels für Projekte erstellen und aktualisieren.

Labels für Projekte erstellen

Console

So fügen Sie Labels zu einem Projekt hinzu:

  1. Öffnen Sie in der Cloud de Confiance 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 Labelschlüssel und 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 Cloud de Confiance 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 Labelschlü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

Verwenden Sie den Befehl gcloud projects create mit dem Flag --labels, um ein neues Projekt mit Labels mit der gcloud CLI zu erstellen:

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

Verwenden Sie den Befehl gcloud projects update mit dem Flag --update-labels, um einem vorhandenen Projekt Labels hinzuzufügen:

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

Wobei:

  • PROJECT_ID die ID des Projekts ist, das Sie erstellen oder aktualisieren möchten.
  • KEY1=VALUE1 ein Schlüssel/Wert-Paar für das Label ist, 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"

Verwenden Sie die Methode projects.patch, um einem vorhandenen Projekt Labels hinzuzufügen:

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 Cloud de Confiance 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 Cloud de Confiance 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 Labels Tab 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

Verwenden Sie den Befehl gcloud projects update mit dem Flag --update-labels, --remove-labels oder --clear-labels, um Labels für ein Projekt mit der gcloud CLI zu aktualisieren.

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

Senden Sie eine PATCH-Anfrage an die Methode projects.patch, um die Labels eines Projekts mit der API zu aktualisieren:

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.