Labels für Projekte erstellen und aktualisieren

In diesem Dokument erfahren Sie, wie Sie mit der Resource Manager API und der Google Cloud Console Labels für Projekte erstellen und aktualisieren. Dort finden Sie Details dazu, wie Sie mithilfe von Labels Kosten nachvollziehen können und welche Dienste Labels unterstützen.

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.

REST

Wenn Sie ein neues Projekt mit einem Label einrichten möchten, legen Sie beim Erstellen das Feld labels fest.

Anfrage

POST https://cloudresourcemanager.googleapis.com/v3/projects

{
 "labels": {
  "color": "red"
 },
 "name": "myproject",
 "projectId": "our-project-123"
}

Antwort

{
 "projectNumber": "333197460082",
 "projectId": "our-project-123",
 "lifecycleState": "ACTIVE",
 "name": "myproject",
 "labels": {
  "color": "red"
 },
 "createTime": "2016-01-12T22:18:28.633Z",
}

So fügen Sie bestehenden Projekten Labels hinzu:

Nachdem Sie Labels hinzugefügt haben, können Sie Projekte anhand von Labels filtern. Weitere Informationen zur Verwendung von Labels zum Filtern von Projekten finden Sie unter Projekte auflisten.

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. Um ein Label zu bearbeiten, klicken Sie auf den entsprechenden Wert und dann auf die gewünschten Änderungen vornehmen.
    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. Um ein Label zu bearbeiten, klicken Sie auf den entsprechenden Wert und dann auf die gewünschten Änderungen vornehmen.
    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.

REST

So aktualisieren Sie die Labels eines Projekts:

  • Rufen Sie das Objekt project mit der Methode projects.get() ab.

  • Ändern Sie die Labels, die Sie aktualisieren möchten.

  • Rufen Sie die Methode projects.patch auf.

Im folgenden Beispiel wird das Label color:blue aktualisiert:

Das folgende Code-Snippet ändert den Wert des Labels color von blue in red.

Anfrage

PATCH https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_NAME
{
  updateMask=labels
}

Dabei ist PROJECT_NAME der Name des Projekts, das Sie aktualisieren möchten.

JSON-Text anfordern:

{
    "labels":
      {
        "color": "red"
      }
}

Response:

{
    "projects": [
    {
        "name": "projects/123456789012",
        "parent": "folders/123456789012",
        "projectId": "my-project",
        "state": "ACTIVE",
        "displayName": "PROJECT_NAME"
        "createTime": "2013-11-13T20:31:53.308Z"
        "updateTime": "2013-11-13T20:35:42.308Z"
        "etag": "BwWUlZ6XEfY="
        "labels": {
            "color": "red"
        },
    }
    ]
}