Mit Unified Access Policies (UAPs) können Sie Hauptkonten Zugriff aufGoogle Cloud -Ressourcen gewähren oder verweigern. In diesem Dokument wird beschrieben, wie Sie UAPs erstellen und anwenden.
Hinweis
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.
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.
-
Prüfen Sie, ob die Abrechnung für Ihr Google Cloud -Projekt aktiviert ist.
Optional: Lesen Sie die Übersicht über UAPs.
Erforderliche Rollen zum Erstellen von Unified Access Policies
Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Access Policy Admin (roles/iam.accessPolicyAdmin) für das Projekt, den Ordner oder die Organisation zuzuweisen, in der Sie die Richtlinie erstellen möchten, um die Berechtigungen zu erhalten, die Sie zum Erstellen 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 Erstellen von UAPs erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:
Erforderliche Berechtigungen
Die folgenden Berechtigungen sind zum Erstellen von UAPs erforderlich:
-
iam.accesspolicies.create -
UAPs in der Google Cloud Console erstellen:
iam.accesspolicies.list
Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.
Rollen, die zum Anwenden von Unified Access Policies erforderlich sind
Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Binden einer UAP an eine Ressource benötigen:
- Access Policy Admin (
roles/iam.accessPolicyAdmin) für die Ressource, die Eigentümer der UAP ist. Diese Rolle enthält die Berechtigungiam.accesspolicies.bind, die zum Erstellen von Bindungen erforderlich ist. Eine Rolle, die die Berechtigung
SERVICE.RESOURCE.createPolicyBindingenthält, wobeiRESOURCEder Ressourcentyp ist, an den Sie die Richtlinie binden möchten, undSERVICEder Dienst ist, zu dem die Ressource gehört.Wenn Sie eine Rolle mit der erforderlichen Berechtigung finden möchten, suchen Sie in der Rollen- und Berechtigungsreferenz nach der Berechtigung, klicken Sie auf den Namen der Berechtigung und sehen Sie sich dann die Rollen an, die die Berechtigung enthalten.
Sie benötigen diese Rolle für die Ressource oder eine ihrer übergeordneten Ressourcen.
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Unified Access Policy erstellen
Sie können UAPs mit der Google Cloud Console, der gcloud CLI oder der IAM REST API erstellen.
Console
-
Rufen Sie in der Google Cloud Console die Seite Einheitliche Zugriffsrichtlinien auf.
Zu „Unified Access Policies“ - Wählen Sie das Projekt, den Ordner oder die Organisation aus, in dem bzw. der Sie die UAP erstellen möchten. Informationen dazu, wo Sie eine UAP erstellen sollten, finden Sie unter Wo UAPs erstellt werden.
- Klicken Sie auf Richtlinie erstellen.
-
Geben Sie im Feld Richtlinienname einen Namen für die UAP ein, z. B.
Example policy. Der Name darf maximal 63 Zeichen lang sein. - Optional: Passen Sie im Feld Richtlinien-ID die ID für die UAP an.
-
Fügen Sie der Richtlinie Regeln hinzu. Führen Sie für jede Regel die folgenden Schritte aus:
- Optional: Geben Sie im Feld Beschreibung eine Beschreibung für die Regel ein.
- Geben Sie im Feld Hauptkonten die Hauptkonten ein, die Sie in die Regel aufnehmen möchten.
- Optional: Geben Sie im Feld Ausgeschlossene Hauptkonten die Hauptkonten ein, die Sie nicht in die Regel aufnehmen möchten. Diese Hauptkonten werden nicht berücksichtigt, auch wenn sie Teil einer Gruppe im Feld Hauptkonten sind.
-
Wählen Sie den gewünschten Effekt der Regel aus:
- Wählen Sie den Effekt Zulassen aus, um den angegebenen Hauptkonten die angegebenen Berechtigungen zu gewähren.
- Wählen Sie den Effekt Ablehnen aus, um zu verhindern, dass die angegebenen Hauptkonten die angegebenen Berechtigungen verwenden.
-
Wählen Sie die Berechtigungen aus, die in die Regel aufgenommen werden sollen:
- Bei Regeln mit dem Effekt Zulassen können Sie Rollen und Berechtigungen angeben, die in die Regel aufgenommen oder von ihr ausgeschlossen werden sollen. Weitere Informationen zu den Rollen und Berechtigungen, die Sie einbeziehen können, finden Sie unter Rollen und Berechtigungen in UAP-Regeln.
- Geben Sie für Regeln mit dem Effekt Ablehnen die Berechtigungen an, die Sie in die Regel aufnehmen oder daraus ausschließen möchten. Weitere Informationen zu den Berechtigungen, die Sie einbeziehen können, finden Sie unter Rollen und Berechtigungen in UAP-Regeln.
-
Optional: Fügen Sie Bedingungen hinzu, unter denen die Regel gilt. Weitere Informationen zu den unterstützten Bedingungsattributen finden Sie unter Bedingungen in UAPs.
- Wenn Sie mit der Bearbeitung der Regel fertig sind, klicken Sie auf Fertig.
- Wenn Sie eine weitere Regel hinzufügen möchten, klicken Sie auf Regel hinzufügen und geben Sie die Regeldetails ein.
- Wenn Sie alle Regeln hinzugefügt haben, klicken Sie auf Richtlinie erstellen.
gcloud
Mit dem Befehl gcloud iam access-policies create wird eine UAP erstellt.
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
-
UAP_ID: Eine eindeutige ID für die UAP, z. B.example-policy. -
UAP_PARENT_RESOURCE_TYPE: Der Typ der Resource Manager-Ressource (Projekt, Ordner oder Organisation), in der Sie die UAP erstellen möchten. Verwenden Sie den Wertproject,folderoderorganization. -
UAP_PARENT_RESOURCE_ID: Die ID des Projekts, Ordners oder der Organisation, in der Sie die UAP erstellen möchten. Projekt-IDs sind alphanumerische Strings, wiemy-project. Ordner- und Organisations-IDs sind numerisch, z. B.123456789012. DISPLAY_NAME: Optional. Eine menschenlesbare Beschreibung der UAP, z. B.Example policy. Der Anzeigename darf maximal 63 Zeichen lang sein.-
FILE_PATH: Der Pfad zu einer JSON-Datei mit den UAP-Regeldetails. Jede Regel sollte 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 sindALLOWundDENY:-
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 alstrueausgewertet wird, gilt die Regel für den Zugriffsversuch. Wenn sie alsfalseausgewertet wird, gilt die Regel nicht für den Zugriffsversuch.
Eine Liste der unterstützten Attribute und ihrer Dienste finden Sie unter Unterstützte Bedingungsattribute.
-
-
Führen Sie folgenden Befehl aus:
Linux, macOS oder Cloud Shell
gcloud iam access-policies create UAP_ID \ --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID \ --location=global --display-name=DISPLAY_NAME \ --details-rules=FILE_PATH
Windows (PowerShell)
gcloud iam access-policies create UAP_ID ` --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID ` --location=global --display-name=DISPLAY_NAME ` --details-rules=FILE_PATH
Windows (cmd.exe)
gcloud iam access-policies create UAP_ID ^ --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID ^ --location=global --display-name=DISPLAY_NAME ^ --details-rules=FILE_PATH
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.
Create request issued for: [example-policy] Waiting for operation [organizations/123456789012/locations/global/operations/operation-1715373988044-6181fa136df85-3b06a30a-4816d25b] to complete...done. Created accessPolicy [example-policy].
REST
Mit der Methode accessPolicies.create wird eine UAP erstellt.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
-
UAP_PARENT_RESOURCE_TYPE: Der Typ der Resource Manager-Ressource (Projekt, Ordner oder Organisation), in der Sie die UAP erstellen möchten. Verwenden Sie den Wertprojects,foldersoderorganizations. -
UAP_PARENT_RESOURCE_ID: Die ID des Projekts, Ordners oder der Organisation, in der Sie die UAP erstellen möchten. Projekt-IDs sind alphanumerische Strings, wiemy-project. Ordner- und Organisations-IDs sind numerisch, z. B.123456789012. -
UAP_ID: Eine eindeutige ID für die UAP, 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 sindALLOWundDENY:-
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 alstrueausgewertet wird, gilt die Regel für den Zugriffsversuch. Wenn sie alsfalseausgewertet 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:
POST https://iam.googleapis.com/v3/UAP_PARENT_RESOURCE_TYPE/UAP_PARENT_RESOURCE_ID/locations/global/accessPolicies?accessPolicyId=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-1715373120647-6181f6d8371d2-83309b71-2b8a7532",
"metadata": {
"@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
"createTime": "2026-05-10T20:32:00.898809495Z",
"target": "organizations/123456789012/locations/global/accessPolicies/example-policy",
"verb": "create",
"requestedCancellation": false,
"apiVersion": "v3"
},
"done": false
}
Unified Access Policy auf eine Ressource anwenden
Wenn Sie eine UAP auf eine Ressource anwenden möchten, erstellen Sie eine Bindung. Nachdem Sie eine Bindung für eine Richtlinie erstellt haben, werden die Regeln in dieser Richtlinie für die angegebene Ressource sowie für alle Nachfolgerelemente dieser Ressource wirksam.
Bevor Sie eine Bindung erstellen, muss die Einschränkung iam.managed.disableAccessPolicyBinding der Organisationsrichtlinie deaktiviert sein. Informationen zum Aktivieren oder Deaktivieren dieser Einschränkung finden Sie unter Verwaltete Einschränkungen in einer Organisationsrichtlinie verwenden.
Sie können UAPs auf Projekte, Ordner und Organisationen anwenden, indem Sie die Google Cloud Console, die gcloud CLI oder die IAM REST API verwenden. Wenn Sie UAPs auf andere Ressourcen anwenden möchten, müssen Sie die gcloud CLI oder die IAM REST API verwenden.
Console
-
Rufen Sie in der Google Cloud Console die Seite Einheitliche Zugriffsrichtlinien auf.
Zu „Unified Access Policies“ - Wählen Sie das Projekt, den Ordner oder die Organisation aus, zu dem die UAP gehört, die Sie anwenden möchten.
- Klicken Sie auf die ID der UAP, die Sie anwenden möchten.
- Wählen Sie den Tab Bindungen aus und klicken Sie dann auf Bindung hinzufügen.
-
Bearbeiten Sie im Bereich Bindung hinzufügen die Bindungsdetails:
- Wählen Sie im Menü Bindungsort die Ressource aus, auf die Sie die UAP anwenden möchten.
-
Optional: Geben Sie im Feld Anzeigename der Bindung eine menschenlesbare Beschreibung der Bindung ein, z. B.
Example binding. Der Anzeigename darf maximal 63 Zeichen lang sein. -
Geben Sie im Feld Bindungs-ID einen eindeutigen Namen für die Bindung ein, z. B.
example-binding.
- Klicken Sie auf Bindung hinzufügen.
gcloud
Mit dem Befehl gcloud iam policy-bindings create wird eine Bindung erstellt.
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
-
BINDING_ID: Ein eindeutiger Name für die Bindung, z. B.example-binding. -
BINDING_PARENT_RESOURCE_TYPE: Der Typ der Resource Manager-Ressource (Projekt, Ordner oder Organisation), der die Bindung untergeordnet ist. Verwenden Sie den Wertproject,folderoderorganization.Die übergeordnete Ressource der Bindung hängt von der Zielressource in der Bindung ab. Weitere Informationen finden Sie unter Unterstützte Ressourcen.
-
BINDING_PARENT_RESOURCE_ID: Die ID des Projekts, Ordners oder der Organisation, dem die Richtlinienbindung untergeordnet ist. Projekt-IDs sind alphanumerische Strings, wiemy-project. Ordner- und Organisations-IDs sind numerisch, z. B.123456789012. -
POLICY_PARENT_RESOURCE: Die Ressource, in der die UAP erstellt wurde, im FormatRESOURCE_TYPE/RESOURCE_ID. Beispiel:organizations/0123456789012. UAPs können in Projekten, Ordnern oder Organisationen erstellt werden. Ordner- und Organisations-IDs müssen numerisch sein. Projekt-IDs können numerisch oder alphanumerisch sein. -
UAP_ID: Die ID der UAP, die Sie an die Ressource binden möchten, z. B.example-uap. Sie können diesen Wert nicht mehr ändern, nachdem Sie die Bindung erstellt haben. -
TARGET_RESOURCE: Die Ressource, an die Sie die UAP binden möchten. Eine Liste der gültigen Ressourcen finden Sie unter Unterstützte Ressourcen. Sie können diesen Wert nach dem Erstellen der Bindung nicht mehr ändern. DISPLAY_NAME: Optional. Eine menschenlesbare Beschreibung der Bindung, z. B.Example binding. Der Anzeigename darf maximal 63 Zeichen lang sein.
Führen Sie folgenden Befehl aus:
Linux, macOS oder Cloud Shell
gcloud iam policy-bindings create BINDING_ID \ --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID --location=global \ --policy="POLICY_PARENT_RESOURCE/locations/global/accessPolicies/UAP_ID" \ --target-resource=TARGET_RESOURCE \ --display-name=DISPLAY_NAME
Windows (PowerShell)
gcloud iam policy-bindings create BINDING_ID ` --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID --location=global ` --policy="POLICY_PARENT_RESOURCE/locations/global/accessPolicies/UAP_ID" ` --target-resource=TARGET_RESOURCE ` --display-name=DISPLAY_NAME
Windows (cmd.exe)
gcloud iam policy-bindings create BINDING_ID ^ --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID --location=global ^ --policy="POLICY_PARENT_RESOURCE/locations/global/accessPolicies/UAP_ID" ^ --target-resource=TARGET_RESOURCE ^ --display-name=DISPLAY_NAME
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.
Create request issued for: [example-binding] Waiting for operation [organizations/123456789012/locations/global/operations/operation-1715374545618-6181fc272c6f9-55ff07f4-97d0ac76] to complete...done. Created policyBinding [example-binding].
REST
Mit der Methode policyBindings.create wird eine Bindung erstellt.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
-
BINDING_PARENT_RESOURCE_TYPE: Der Typ der Resource Manager-Ressource (Projekt, Ordner oder Organisation), der die Bindung untergeordnet ist. Verwenden Sie den Wertprojects,foldersoderorganizations.Die übergeordnete Ressource der Bindung hängt von der Zielressource in der Bindung ab. Weitere Informationen finden Sie unter Unterstützte Ressourcen.
-
BINDING_PARENT_RESOURCE_ID: Die ID des Projekts, Ordners oder der Organisation, dem die Richtlinienbindung untergeordnet ist. Projekt-IDs sind alphanumerische Strings, wiemy-project. Ordner- und Organisations-IDs sind numerisch, z. B.123456789012. -
BINDING_ID: Ein eindeutiger Name für die Bindung, z. B.example-binding. DISPLAY_NAME: Optional. Eine menschenlesbare Beschreibung der Bindung, z. B.Example binding. Der Anzeigename darf maximal 63 Zeichen lang sein.-
TARGET_RESOURCE: Die Ressource, an die Sie die UAP binden möchten. Eine Liste der gültigen Ressourcen finden Sie unter Unterstützte Ressourcen. Sie können diesen Wert nach dem Erstellen der Bindung nicht mehr ändern. -
POLICY_PARENT_RESOURCE: Die Ressource, in der die UAP erstellt wurde, im FormatRESOURCE_TYPE/RESOURCE_ID. Beispiel:organizations/0123456789012. UAPs können in Projekten, Ordnern oder Organisationen erstellt werden. Ordner- und Organisations-IDs müssen numerisch sein. Projekt-IDs können numerisch oder alphanumerisch sein. -
UAP_ID: Die ID der UAP, die Sie an die Ressource binden möchten, z. B.example-uap. Sie können diesen Wert nicht mehr ändern, nachdem Sie die Bindung erstellt haben.
HTTP-Methode und URL:
POST https://iam.googleapis.com/v3/BINDING_PARENT_RESOURCE_TYPE/BINDING_PARENT_RESOURCE_ID/locations/global/policyBindings?policyBindingId=BINDING_ID
JSON-Text anfordern:
{
"displayName": "DISPLAY_NAME",
"target": {
"resource": "TARGET_RESOURCE"
},
"policyKind": "ACCESS",
"policy": "POLICY_PARENT_RESOURCE/locations/global/accessPolicies/UAP_ID"
}
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-1715373120647-6181f6d8371d2-83309b71-2b8a7532",
"metadata": {
"@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
"createTime": "2026-05-10T20:32:00.898809495Z",
"target": "organizations/123456789012/locations/global/policyBindings/example-binding",
"verb": "create",
"requestedCancellation": false,
"apiVersion": "v3"
},
"done": false
}
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.