Unified Access Policies bearbeiten

Mit Unified Access Policies (UAPs) können Sie Hauptkonten Zugriff aufGoogle Cloud -Ressourcen gewähren oder verweigern. In diesem Dokument wird erläutert, wie Sie vorhandene UAPs bearbeiten und ändern, für welche Ressourcen ein UAP gilt.

Hinweis

  1. Richten Sie die Authentifizierung ein.

    Wählen Sie den Tab für die gewünschte Verwendung der Beispiele auf dieser Seite aus:

    Console

    Wenn Sie über die Google Cloud Console auf Dienste und APIs von Google Cloud zugreifen, müssen Sie die Authentifizierung nicht einrichten.

    gcloud

    Aktivieren Sie Cloud Shell in der Google Cloud Console.

    Cloud Shell aktivieren

    Unten in der Google Cloud Console wird eine Cloud Shell-Sitzung gestartet und eine Eingabeaufforderung angezeigt. Cloud Shell ist eine Shell-Umgebung, in der das Google Cloud CLI bereits installiert ist und Werte für Ihr aktuelles Projekt bereits festgelegt sind. Das Initialisieren der Sitzung kann einige Sekunden dauern.

    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.

  2. Prüfen Sie, ob die Abrechnung für Ihr Google Cloud -Projekt aktiviert ist.

  3. Optional. Übersicht über UAPs

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Access Policy Admin (roles/iam.accessPolicyAdmin) für das Projekt, den Ordner oder die Organisation zuzuweisen, die Eigentümer der UAP ist, die Sie bearbeiten möchten. Damit erhalten Sie die Berechtigungen, die Sie zum Bearbeiten von UAPs benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigungen, die zum Bearbeiten von UAPs erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind zum Bearbeiten von UAPs erforderlich:

  • iam.accesspolicies.update
  • Bearbeiten Sie UAPs in der Google Cloud -Konsole:
    • iam.accesspolicies.get
    • iam.accessPolicies.list

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

Vorhandene Unified Access Policy bearbeiten

Sie können eine UAP bearbeiten, um ihren Anzeigenamen oder ihre Regeln zu aktualisieren.

Sie können eine UAP mit der Google Cloud Console, der gcloud CLI oder der IAM REST API bearbeiten.

Console

  1. Rufen Sie in der Google Cloud Console die Seite Einheitliche Zugriffsrichtlinien auf.

    Zu „Unified Access Policies“
  2. Wählen Sie das Projekt, den Ordner oder die Organisation aus, zu dem bzw. der die zu bearbeitende UAP gehört.
  3. Klicken Sie auf die Richtlinien-ID der UAP, die Sie bearbeiten möchten.
  4. Klicken Sie auf Regel hinzufügen und geben Sie die Details der Regel ein. Klicken Sie auf Regel hinzufügen, um die Regel zu speichern.

    Weitere Informationen zu den Feldern einer Regel finden Sie unter UAP erstellen.

  5. Wenn Sie andere Felder der UAP bearbeiten möchten, klicken Sie auf Richtlinie bearbeiten.
  6. Bearbeiten Sie eines der folgenden Felder:

    • Richtlinienname: Geben Sie einen neuen Anzeigenamen für die UAP ein.
    • Regeln: Regeln in der UAP aktualisieren, hinzufügen oder entfernen.
  7. Wenn Sie mit der Bearbeitung der UAP fertig sind, klicken Sie auf Richtlinie aktualisieren.

gcloud

Mit dem Befehl gcloud iam access-policies update wird ein vorhandenes UAP aktualisiert.

Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

  • UAP_ID: Die ID der UAP, die Sie aktualisieren möchten, z. B. example-policy.
  • UAP_PARENT_RESOURCE_TYPE: Der Typ der Resource Manager-Ressource (Projekt, Ordner oder Organisation), zu der die UAP gehört, die Sie aktualisieren möchten. Verwenden Sie den Wert project, folder oder organization.
  • UAP_PARENT_RESOURCE_ID: Die ID des Projekts, Ordners oder der Organisation, zu der die UAP gehört, die Sie aktualisieren möchten. Projekt-IDs sind alphanumerische Strings, wie my-project. Ordner- und Organisations-IDs sind numerisch, z. B. 123456789012.
  • FIELD_TO_UPDATE=UPDATED_VALUE: Die Felder, die Sie aktualisieren möchten, und der entsprechende aktualisierte Wert.

    Im Folgenden finden Sie Beispiele für Flags, mit denen Sie die Felder in der Richtlinie aktualisieren können:

    • --display-name=DISPLAY_NAME: Ersetzen Sie den Anzeigenamen der UAP durch den angegebenen Namen.
    • --details-rules=RULES_FILE: Ersetzen Sie die UAP-Regeln durch die Regeln in der angegebenen Datei. Jede Regel in der Datei muss das folgende Format haben:

      {
        "description": "DESCRIPTION",
        "effect": "EFFECT",
        "principals": [
          INCLUDED_PRINCIPALS
        ],
        "excludedPrincipals": [
          EXCLUDED_PRINCIPALS
        ],
        "operation": {
          "permissions": [
            INCLUDED_PERMISSIONS
          ],
          "excludedPermissions": [
            EXCLUDED_PERMISSIONS
          ]
        },
        CONDITIONS
      }

      Ersetzen Sie die folgenden Werte:

      • DESCRIPTION: Eine menschenlesbare Beschreibung der Regel.
      • EFFECT: Wie sich die Regel auf den Zugriff auswirkt. Die unterstützten Werte sind ALLOW und DENY:

        • ALLOW: Gewährt den angegebenen Hauptkonten die angegebenen Berechtigungen.
        • DENY: Verhindern, dass die angegebenen Hauptkonten die angegebenen Berechtigungen verwenden.
      • Ersetzen Sie die folgenden Werte, um die in der Regel enthaltenen Hauptkonten anzugeben:

        • INCLUDED_PRINCIPALS: Die Hauptkonten, die in die Regel aufgenommen werden sollen.
        • EXCLUDED_PRINCIPALS: Optional. Die Hauptkonten, die von der Regel ausgeschlossen werden sollen, auch wenn sie in der Liste der eingeschlossenen Hauptkonten enthalten sind. Sie können beispielsweise eine Google-Gruppe zur Liste der eingeschlossenen Hauptkonten hinzufügen und dann bestimmte Nutzer ausschließen, die zu dieser Gruppe gehören.

        Eine Liste der unterstützten Hauptkonto-IDs finden Sie unter Hauptkontotypen für UAPs.

      • Ersetzen Sie die folgenden Werte, um die Berechtigungen anzugeben, die in die Regel aufgenommen werden sollen:

        • INCLUDED_PERMISSIONS: Die Berechtigungen, die in die Regel aufgenommen werden sollen.
        • EXCLUDED_PERMISSIONS: Optional. Die Berechtigungen, die von der Regel ausgeschlossen werden sollen, auch wenn sie in der Liste der eingeschlossenen Berechtigungen enthalten sind. Sie können beispielsweise eine Rolle zur Liste der enthaltenen Berechtigungen hinzufügen und dann bestimmte Berechtigungen in dieser Rolle ausschließen.

        Beim Erstellen dieser Berechtigungslisten können Sie auf Berechtigungsnamen, Rollennamen und Berechtigungsgruppen verweisen. Weitere Informationen finden Sie unter Rollen und Berechtigungen in UAP-Regeln.

      • CONDITIONS: Optional. Die Bedingungen, unter denen die Regel gilt. Verwenden Sie das folgende Format:

        "conditions": {
          "SERVICE": {
            "title": "CONDITION_TITLE",
            "description": "CONDITION_DESCRIPTION",
            "expression": "CONDITION_EXPRESSION"
          }
        }
            

        Ersetzen Sie die folgenden Werte:

        • SERVICE: Der Dienst, der die im Bedingungsausdruck verwendeten Attribute bereitstellt.
        • CONDITION_TITLE: Optional. Eine kurze Zusammenfassung des Zwecks der Bedingung.
        • CONDITION_DESCRIPTION: Optional. Eine längere Beschreibung der Bedingung.
        • CONDITION_EXPRESSION: Ein boolescher Ausdruck, der auf Attribute des Zugriffsversuchs verweist, z. B. die Tags, die der Ressource im Zugriffsversuch angehängt sind. Wenn der Ausdruck als true ausgewertet wird, gilt die Regel für den Zugriffsversuch. Wenn sie als false ausgewertet wird, gilt die Regel nicht für den Zugriffsversuch.

        Eine Liste der unterstützten Attribute und ihrer Dienste finden Sie unter Unterstützte Bedingungsattribute.

    • --add-details-rules=RULES_FILE: Die Regeln in der angegebenen Datei werden an die vorhandenen Regeln in der UAP angehängt.

    • --remove-details-rules=RULES_FILE: Entfernt die Regeln in der angegebenen Datei aus den vorhandenen Regeln in der UAP. Es werden nur Regeln entfernt, die genau mit einer der Regeln in der angegebenen Datei übereinstimmen.

    • --clear-details-rules: Alle Regeln aus der UAP löschen.

    Eine vollständige Liste der Flags, die Sie zum Aktualisieren einer UAP verwenden können, finden Sie in der Referenz zum Befehl gcloud iam access-policies update. Einige Flags schließen sich gegenseitig aus.

  • FORMAT: Das Format für die Antwort. Verwenden Sie json oder yaml.

Führen Sie folgenden Befehl aus:

Linux, macOS oder Cloud Shell

gcloud iam access-policies update UAP_ID \
    --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID \
    --location=global --FIELD_TO_UPDATE=UPDATED_VALUE \
    --format=FORMAT

Windows (PowerShell)

gcloud iam access-policies update UAP_ID `
    --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID `
    --location=global --FIELD_TO_UPDATE=UPDATED_VALUE `
    --format=FORMAT

Windows (cmd.exe)

gcloud iam access-policies update UAP_ID ^
    --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID ^
    --location=global --FIELD_TO_UPDATE=UPDATED_VALUE ^
    --format=FORMAT

Die Antwort enthält einen Vorgang mit langer Ausführungszeit, der Ihre Anfrage darstellt. Nach Abschluss des Vorgangs wird in der Antwort die aktualisierte UAP ausgegeben.

Request issued for: [example-policy]
Waiting for operation [organizations/123456789012/locations/global/operations/operation-1715374208720-6181fae5e2034-2d8a712b-5c92e5b9] to complete...done.
Updated accessPolicy [example-policy].
{
  "createTime": "2026-08-31T21:43:39.822441Z",
  "details": {
    "rules": [
      {
        "conditions": {
          "iam.googleapis.com": {
            "expression": "resource.matchTag('environment', 'prod')"
          }
        },
        "description": "Grant non-delete compute permissions to compute admins in prod",
        "effect": "ALLOW",
        "excludedPrincipals": [
          "principal://goog/subject/access-restricted@example.com"
        ],
        "operation": {
          "excludedPermissions": [
            "*/*.delete"
          ],
          "permissions": [
            "role:roles/compute.admin"
          ]
        },
        "principals": [
          "principalSet://goog/group/compute-admins@example.com"
        ]
      }
    ]
  },
  "displayName": "Updated display name",
  "etag": "W/\"YZtdQgtulCVzvTwlBTFjPQ==\"",
  "name": "projects/0123456789012/locations/global/accessPolicies/example-policy",
  "uid": "puid_0123456789012345678",
  "updateTime": "2026-08-31T21:43:39.822441Z"
}

REST

Mit der Methode accessPolicies.patch wird eine vorhandene UAP aktualisiert.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • UAP_PARENT_RESOURCE_TYPE: Der Typ der Resource Manager-Ressource (Projekt, Ordner oder Organisation), zu der die UAP gehört, die Sie aktualisieren möchten. Verwenden Sie den Wert projects, folders oder organizations.
  • UAP_PARENT_RESOURCE_ID: Die ID des Projekts, Ordners oder der Organisation, zu der die UAP gehört, die Sie aktualisieren möchten. Projekt-IDs sind alphanumerische Strings, wie my-project. Ordner- und Organisations-IDs sind numerisch, z. B. 123456789012.
  • UAP_ID: Die ID der UAP, die Sie aktualisieren möchten, z. B. example-policy.
  • DISPLAY_NAME: Optional. Eine menschenlesbare Beschreibung der UAP, z. B. Example policy. Der Anzeigename darf maximal 63 Zeichen lang sein.
  • UAP_RULES: Eine Liste von UAP-Regeln, die den zu gewährenden oder zu verweigernden Zugriff und die Hauptkonten definieren, denen der Zugriff gewährt oder verweigert werden soll. Eine UAP kann bis zu 100 Regeln enthalten. Jede Regel hat das folgende Format:

    {
      "description": "DESCRIPTION",
      "effect": "EFFECT",
      "principals": [
        INCLUDED_PRINCIPALS
      ],
      "excludedPrincipals": [
        EXCLUDED_PRINCIPALS
      ],
      "operation": {
        "permissions": [
          INCLUDED_PERMISSIONS
        ],
        "excludedPermissions": [
          EXCLUDED_PERMISSIONS
        ]
      },
      CONDITIONS
    }

    Ersetzen Sie die folgenden Werte:

    • DESCRIPTION: Eine menschenlesbare Beschreibung der Regel.
    • EFFECT: Wie sich die Regel auf den Zugriff auswirkt. Die unterstützten Werte sind ALLOW und DENY:

      • ALLOW: Gewährt den angegebenen Hauptkonten die angegebenen Berechtigungen.
      • DENY: Verhindern, dass die angegebenen Hauptkonten die angegebenen Berechtigungen verwenden.
    • Ersetzen Sie die folgenden Werte, um die in der Regel enthaltenen Hauptkonten anzugeben:

      • INCLUDED_PRINCIPALS: Die Hauptkonten, die in die Regel aufgenommen werden sollen.
      • EXCLUDED_PRINCIPALS: Optional. Die Hauptkonten, die von der Regel ausgeschlossen werden sollen, auch wenn sie in der Liste der eingeschlossenen Hauptkonten enthalten sind. Sie können beispielsweise eine Google-Gruppe zur Liste der eingeschlossenen Hauptkonten hinzufügen und dann bestimmte Nutzer ausschließen, die zu dieser Gruppe gehören.

      Eine Liste der unterstützten Hauptkonto-IDs finden Sie unter Hauptkontotypen für UAPs.

    • Ersetzen Sie die folgenden Werte, um die Berechtigungen anzugeben, die in die Regel aufgenommen werden sollen:

      • INCLUDED_PERMISSIONS: Die Berechtigungen, die in die Regel aufgenommen werden sollen.
      • EXCLUDED_PERMISSIONS: Optional. Die Berechtigungen, die von der Regel ausgeschlossen werden sollen, auch wenn sie in der Liste der eingeschlossenen Berechtigungen enthalten sind. Sie können beispielsweise eine Rolle zur Liste der enthaltenen Berechtigungen hinzufügen und dann bestimmte Berechtigungen in dieser Rolle ausschließen.

      Beim Erstellen dieser Berechtigungslisten können Sie auf Berechtigungsnamen, Rollennamen und Berechtigungsgruppen verweisen. Weitere Informationen finden Sie unter Rollen und Berechtigungen in UAP-Regeln.

    • CONDITIONS: Optional. Die Bedingungen, unter denen die Regel gilt. Verwenden Sie das folgende Format:

      "conditions": {
        "SERVICE": {
          "title": "CONDITION_TITLE",
          "description": "CONDITION_DESCRIPTION",
          "expression": "CONDITION_EXPRESSION"
        }
      }
          

      Ersetzen Sie die folgenden Werte:

      • SERVICE: Der Dienst, der die im Bedingungsausdruck verwendeten Attribute bereitstellt.
      • CONDITION_TITLE: Optional. Eine kurze Zusammenfassung des Zwecks der Bedingung.
      • CONDITION_DESCRIPTION: Optional. Eine längere Beschreibung der Bedingung.
      • CONDITION_EXPRESSION: Ein boolescher Ausdruck, der auf Attribute des Zugriffsversuchs verweist, z. B. die Tags, die der Ressource im Zugriffsversuch angehängt sind. Wenn der Ausdruck als true ausgewertet wird, gilt die Regel für den Zugriffsversuch. Wenn sie als false ausgewertet wird, gilt die Regel nicht für den Zugriffsversuch.

      Eine Liste der unterstützten Attribute und ihrer Dienste finden Sie unter Unterstützte Bedingungsattribute.

HTTP-Methode und URL:

PATCH https://iam.googleapis.com/v3/UAP_PARENT_RESOURCE_TYPE/UAP_PARENT_RESOURCE_ID/locations/global/accessPolicies/UAP_ID

JSON-Text anfordern:

{
  "displayName": "DISPLAY_NAME",
  "details": {
    "rules": [
      UAP_RULES
    ]
  }
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Die Antwort enthält einen Vorgang mit langer Ausführungszeit, der Ihre Anfrage darstellt. Informationen zum Abrufen des Status eines Vorgangs mit langer Ausführungszeit finden Sie auf dieser Seite unter Status eines Vorgangs mit langer Ausführungszeit prüfen.

{
  "name": "organizations/123456789012/locations/global/operations/operation-1715626721931-6185a7953ef76-76f80ee4-19cd1bf7",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
    "createTime": "2026-05-13T18:58:43.721277235Z",
    "target": "organizations/123456789012/locations/global/accessPolicies/example-policy",
    "verb": "update",
    "requestedCancellation": false,
    "apiVersion": "v3"
  },
  "done": false
}

Ressourcen ändern, für die die Richtlinie gilt

Nachdem Sie eine Bindung für eine UAP erstellt haben, können Sie die Richtlinien-ID oder die Ressource in der Bindung nicht mehr ändern. Wenn Sie also die Ressource ändern möchten, auf die eine UAP angewendet wird, müssen Sie eine der folgenden Aktionen ausführen:

Status eines Vorgangs mit langer Ausführungszeit prüfen

Wenn Sie die REST API oder die Clientbibliotheken verwenden, gibt jede Methode, die eine Richtlinie oder Bindung ändert, einen Vorgang mit langer Ausführungszeit zurück. Der Vorgang mit langer Ausführungszeit verfolgt den Status der Anfrage und gibt an, ob die Änderung der Richtlinie oder Bindung abgeschlossen ist.

REST

Die Methode operations.get gibt den Status eines Vorgang mit langer Ausführungszeit zurück.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • OPERATION_NAME: Der vollständige Name des Vorgangs. Sie erhalten diesen Namen in der Antwort auf Ihre ursprüngliche Anfrage.

    Der Vorgangsname hat das folgende Format:

    RESOURCE_TYPE/RESOURCE_ID/locations/global/operations/OPERATION_ID
        

HTTP-Methode und URL:

GET https://iam.googleapis.com/v3/OPERATION_NAME

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "name": "organizations/314340013352/locations/global/operations/operation-1732752311821-627edd607a3df-9a62cdea-2a7d9f07",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
    "createTime": "2024-11-28T00:05:12.006289686Z",
    "endTime": "2024-11-28T00:05:12.192141801Z",
    "target": "organizations/314340013352/locations/global/POLICY_TYPE/POLICY_ID",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v3"
  },
  "done": true,
  "response": {
    POLICY
  }
}

Wenn das Feld done des Vorgangs nicht vorhanden ist, rufen Sie den Vorgang wiederholt ab, um den Status weiter zu beobachten. Verwenden Sie einen abgeschnittenen exponentiellen Backoff, um eine Verzögerung zwischen den einzelnen Anfragen einzuführen. Wenn das Feld done auf true gesetzt ist, ist der Vorgang abgeschlossen und Sie können den Vorgang beenden.

Nächste Schritte