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 UAPs und Bindungen aufrufen.
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 Aufrufen von Unified Access Policies
Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Access Policy Viewer (roles/iam.accessPolicyViewer) für das Projekt, den Ordner oder die Organisation zuzuweisen, die Inhaber der UAP ist, die Sie aufrufen möchten, um die Berechtigungen zu erhalten, die Sie zum Aufrufen 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 Aufrufen von UAPs erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:
Erforderliche Berechtigungen
Die folgenden Berechtigungen sind erforderlich, um UAPs aufzurufen:
-
iam.accesspolicies.get -
iam.accessPolicies.list
Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.
Rollen, die zum Aufrufen von Unified Access Policy-Bindungen erforderlich sind
Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für die übergeordnete Ressource der Bindungen zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Aufrufen von Bindungen benötigen:
-
Bindungen in einem Projekt ansehen:
Projekt-IAM-Administrator (
roles/resourcemanager.projectIamAdmin) -
Bindungen in einem Ordner ansehen:
Folder IAM Admin (
roles/resourcemanager.folderIamAdmin) -
Bindungen in einer Organisation ansehen: Organization Administrator (
roles/resourcemanager.organizationAdmin)
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Diese vordefinierten Rollen enthalten die Berechtigungen, die zum Aufrufen von Bindungen erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:
Erforderliche Berechtigungen
Die folgenden Berechtigungen sind zum Aufrufen von Bindungen erforderlich:
-
Einzelne Bindung ansehen:
iam.policybindings.get -
Bindungen auflisten, die einem Projekt, Ordner oder einer Organisation untergeordnet sind:
iam.policybindings.list
Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.
Rollen, die zum Aufrufen aller Bindungen für eine Unified Access Policy erforderlich sind
Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Access Policy Viewer (roles/iam.accessPolicyViewer) für die Ressource zuzuweisen, die Eigentümer der UAP ist, um die Berechtigung zu erhalten, die Sie zum Aufrufen aller Bindungen für eine UAP benötigen.
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Diese vordefinierte Rolle enthält die Berechtigung iam.accesspolicies.searchPolicyBindings, die zum Aufrufen aller Bindungen für eine UAP erforderlich ist.
Sie können diese Berechtigung auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.
Rollen zum Aufrufen aller Bindungen für eine Ressource
Bitten Sie Ihren Administrator, Ihnen eine Rolle zuzuweisen, mit der Sie Bindungen für diese Ressource auflisten können, um die Berechtigungen zu erhalten, die Sie zum Aufrufen aller Bindungen benötigen, die eine bestimmte Zielressource enthalten. Diese Rolle muss die Berechtigung SERVICE.RESOURCE.searchPolicyBindings enthalten, wobei RESOURCE der Zielressourcentyp und SERVICE der 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 Zielressource oder eine ihrer übergeordneten Ressourcen.
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Unified Access Policies in einem Projekt, Ordner oder einer Organisation auflisten
Sie können alle UAPs, die einem bestimmten Projekt, Ordner oder einer bestimmten Organisation untergeordnet sind, mit der Google Cloud Console, der gcloud CLI oder der IAM REST API auflisten.
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 bzw. der die UAPs gehören, die Sie aufrufen möchten.
In der Google Cloud Console werden die UAPs angezeigt, die der ausgewählten Ressource übergeordnet oder an sie gebunden sind.
gcloud
Mit dem Befehl gcloud iam access-policies list werden alle UAPs aufgelistet, die einer bestimmten Ressource untergeordnet sind.
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
-
UAP_PARENT_RESOURCE_TYPE: Der Typ der Resource Manager-Ressource (Projekt, Ordner oder Organisation), zu der die UAPs gehören, die Sie auflisten möchten. Verwenden Sie den Wertproject,folderoderorganization. -
UAP_PARENT_RESOURCE_ID: Die ID des Projekts, des Ordners oder der Organisation, zu der die UAPs gehören, die Sie auflisten möchten. Projekt-IDs sind alphanumerische Strings, wiemy-project. Ordner- und Organisations-IDs sind numerisch, z. B.123456789012. FORMAT: Das Format für die Antwort. Verwenden Siejsonoderyaml.
Führen Sie folgenden Befehl aus:
Linux, macOS oder Cloud Shell
gcloud iam access-policies list --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID \ --location=global --format=FORMAT
Windows (PowerShell)
gcloud iam access-policies list --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID ` --location=global --format=FORMAT
Windows (cmd.exe)
gcloud iam access-policies list --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID ^ --location=global --format=FORMAT
Die Antwort enthält die UAPs, die der Ressource in der Anfrage untergeordnet sind.
{
"accessPolicies": [
{
"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": "Example policy 1",
"etag": "W/\"YZtdQgtulCVzvTwlBTFjPQ==\"",
"name": "projects/0123456789012/locations/global/accessPolicies/example-policy",
"uid": "puid_0123456789012345678",
"updateTime": "2026-08-31T21:43:39.822441Z"
},
{
"createTime": "2026-05-29T23:25:01.606730Z",
"details": {
"rules": [
{
"description": "Deny group from publishing to message buses",
"effect": "DENY",
"operation": {
"permissions": [
"eventarc.googleapis.com/messageBuses.publish"
]
},
"principals": [
"principalSet://goog/group/example-group@example.com"
]
}
]
},
"displayName": "Example policy 2",
"etag": "d6BJBTsk2+oDCygmr5ANxA==",
"name": "organizations/123456789012/locations/global/accessPolicies/example-policy-2",
"uid": "puid_13064942519001808897",
"updateTime": "2026-05-29T23:25:01.606730Z"
}
]
}
REST
Mit der Methode accessPolicies.list werden alle UAPs aufgelistet, die einer bestimmten Ressource untergeordnet sind.
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 UAPs gehören, die Sie auflisten möchten. Verwenden Sie den Wertprojects,foldersoderorganizations. -
UAP_PARENT_RESOURCE_ID: Die ID des Projekts, des Ordners oder der Organisation, zu der die UAPs gehören, die Sie auflisten möchten. Projekt-IDs sind alphanumerische Strings, wiemy-project. Ordner- und Organisations-IDs sind numerisch, z. B.123456789012.
HTTP-Methode und URL:
GET https://iam.googleapis.com/v3/UAP_PARENT_RESOURCE_TYPE/UAP_PARENT_RESOURCE_ID/locations/global/accessPolicies
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Die Antwort enthält die UAPs, die der Ressource in der Anfrage untergeordnet sind.
{
"accessPolicies": [
{
"name": "projects/0123456789012/locations/global/accessPolicies/example-policy",
"uid": "puid_0123456789012345678",
"etag": "W/\"YZtdQgtulCVzvTwlBTFjPQ==\"",
"displayName": "Example policy",
"createTime": "2026-08-31T21:43:39.822441Z",
"updateTime": "2026-08-31T21:43:39.822441Z",
"details": {
"rules": [
{
"principals": [
"principalSet://goog/group/compute-admins@example.com"
],
"excludedPrincipals": [
"principal://goog/subject/access-restricted@example.com"
],
"operation": {
"permissions": [
"role:roles/compute.admin"
],
"excludedPermissions": [
"*/*.delete"
]
},
"conditions": {
"iam.googleapis.com": {
"expression": "resource.matchTag('environment', 'prod')"
}
},
"description": "Grant non-delete compute permissions to compute admins in prod",
"effect": "ALLOW"
}
]
}
},
{
"name": "organizations/123456789012/locations/global/accessPolicies/example-policy-2",
"uid": "puid_13064942519001808897",
"etag": "d6BJBTsk2+oDCygmr5ANxA==",
"displayName": "Example policy 2",
"createTime": "2026-05-29T23:25:01.606730Z",
"updateTime": "2026-05-29T23:25:01.606730Z",
"details": {
"rules": [
{
"description": "Deny group from publishing to message buses",
"principals": [
"principalSet://goog/group/example-group@example.com"
],
"operation": {
"permissions": [
"eventarc.googleapis.com/messageBuses.publish"
]
},
"effect": "DENY"
}
]
}
}
]
}
Einzelne Unified Access Policy abrufen
Sie können die Details einer einzelnen UAP über dieGoogle Cloud Console, die gcloud CLI oder die IAM REST API abrufen.
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, deren Details Sie aufrufen möchten.
- Klicken Sie auf die Richtlinien-ID der UAP, deren Details Sie aufrufen möchten.
In der Google Cloud Console werden die Details der UAP angezeigt, einschließlich ID, Erstellungszeit, Zeitpunkt der letzten Aktualisierung und Liste der Regeln.
gcloud
Mit dem Befehl gcloud iam access-policies describe wird eine einzelne UAP abgerufen.
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
-
UAP_ID: Die ID der UAP, die Sie abrufen 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 abrufen möchten. Verwenden Sie den Wertproject,folderoderorganization -
UAP_PARENT_RESOURCE_ID: Die ID des Projekts, Ordners oder der Organisation, zu der die UAP gehört, die Sie abrufen möchten. Projekt-IDs sind alphanumerische Strings, wiemy-project. Ordner- und Organisations-IDs sind numerisch, z. B.123456789012. FORMAT: Das Format für die Antwort. Verwenden Siejsonoderyaml.
Führen Sie folgenden Befehl aus:
Linux, macOS oder Cloud Shell
gcloud iam access-policies describe UAP_ID \ --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID \ --location=global --format=FORMAT
Windows (PowerShell)
gcloud iam access-policies describe UAP_ID ` --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID ` --location=global --format=FORMAT
Windows (cmd.exe)
gcloud iam access-policies describe UAP_ID ^ --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID ^ --location=global --format=FORMAT
Die Antwort enthält die in der Anfrage angegebene UAP.
{
"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": "Example policy",
"etag": "W/\"YZtdQgtulCVzvTwlBTFjPQ==\"",
"name": "projects/0123456789012/locations/global/accessPolicies/example-policy",
"uid": "puid_0123456789012345678",
"updateTime": "2026-08-31T21:43:39.822441Z"
}
REST
Die Methode accessPolicies.get ruft eine einzelne UAP ab.
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 abrufen möchten. Verwenden Sie den Wertprojects,foldersoderorganizations -
UAP_PARENT_RESOURCE_ID: Die ID des Projekts, Ordners oder der Organisation, zu der die UAP gehört, die Sie abrufen möchten. Projekt-IDs sind alphanumerische Strings, wiemy-project. Ordner- und Organisations-IDs sind numerisch, z. B.123456789012. -
UAP_ID: Die ID der UAP, die Sie abrufen möchten, z. B.example-policy.
HTTP-Methode und URL:
GET https://iam.googleapis.com/v3/UAP_PARENT_RESOURCE_TYPE/UAP_PARENT_RESOURCE_ID/locations/global/accessPolicies/UAP_ID
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Die Antwort enthält die in der Anfrage angegebene UAP.
{
"name": "projects/0123456789012/locations/global/accessPolicies/example-policy",
"uid": "puid_0123456789012345678",
"etag": "W/\"YZtdQgtulCVzvTwlBTFjPQ==\"",
"displayName": "Example policy",
"createTime": "2026-08-31T21:43:39.822441Z",
"updateTime": "2026-08-31T21:43:39.822441Z",
"details": {
"rules": [
{
"principals": [
"principalSet://goog/group/compute-admins@example.com"
],
"excludedPrincipals": [
"principal://goog/subject/access-restricted@example.com"
],
"operation": {
"permissions": [
"role:roles/compute.admin"
],
"excludedPermissions": [
"*/*.delete"
]
},
"conditions": {
"iam.googleapis.com": {
"expression": "resource.matchTag('environment', 'prod')"
}
},
"description": "Grant non-delete compute permissions to compute admins in prod",
"effect": "ALLOW"
}
]
}
}
Bindungen für Unified Access Policies auflisten
Sie können Bindungen für UAPs auf verschiedene Arten auflisten:
- Bindungen für ein UAP auflisten: Alle Bindungen aufrufen, die ein bestimmtes UAP enthalten.
- Bindungen für eine Ressource auflisten: Alle Bindungen ansehen, die eine bestimmte Zielressource enthalten.
- Alle Bindungen in einem Projekt, Ordner oder einer Organisation auflisten: Alle Bindungen ansehen, die einem bestimmten Projekt, Ordner oder einer bestimmten Organisation untergeordnet sind.
Bindungen für eine Unified Access Policy auflisten
Wenn Sie alle Bindungen mit einem bestimmten UAP aufrufen möchten, suchen Sie in den Bindungen nach dem UAP.
Sie können alle Bindungen für eine UAP über dieGoogle Cloud Console, die gcloud CLI oder die IAM REST API aufrufen.
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 bzw. der die UAP gehört, deren Bindungen Sie aufrufen möchten.
- Klicken Sie auf die Richtlinien-ID der UAP, deren Bindungen Sie aufrufen möchten.
- Wählen Sie den Tab Bindungen aus.
In der Google Cloud Console wird eine Liste der Bindungen für die UAP angezeigt, zusammen mit dem Anzeigenamen und der Zielressource jeder Bindung.
gcloud
Mit dem Befehl gcloud iam access-policies search-policy-bindings werden alle Bindungen für die angegebene UAP aufgelistet.
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
-
UAP_ID: Die ID der UAP, für die Sie Bindungen auflisten 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, für die Sie Bindungen auflisten möchten. Verwenden Sie den Wertproject,folderoderorganization. -
UAP_PARENT_RESOURCE_ID: Die ID des Projekts, Ordners oder der Organisation, zu der die UAP gehört, für die Sie Bindungen auflisten möchten. Projekt-IDs sind alphanumerische Strings, wiemy-project. Ordner- und Organisations-IDs sind numerisch, z. B.123456789012. FORMAT: Das Format für die Antwort. Verwenden Siejsonoderyaml.
Führen Sie folgenden Befehl aus:
Linux, macOS oder Cloud Shell
gcloud iam access-policies search-policy-bindings UAP_ID \ --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID \ --location=global --format=FORMAT
Windows (PowerShell)
gcloud iam access-policies search-policy-bindings UAP_ID ` --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID ` --location=global --format=FORMAT
Windows (cmd.exe)
gcloud iam access-policies search-policy-bindings UAP_ID ^ --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID ^ --location=global --format=FORMAT
Die Antwort enthält die Bindungen für die angegebene UAP.
{
"policyBindings": [
{
"createTime": "2026-05-06T18:08:24.729843Z",
"displayName": "Example binding 1",
"etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
"name": "organizations/123456789012/locations/global/policyBindings/example-binding1",
"policy": "organizations/123456789012/locations/global/accessPolicies/example-policy",
"policyKind": "ACCESS",
"policyUid": "puid_9519202237377675265",
"target": {
"resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"uid": "buid_9904260005517852673",
"updateTime": "2026-05-06T18:08:24.729843Z"
},
{
"createTime": "2026-05-07T07:05:06.203861Z",
"displayName": "Example binding 2",
"etag": "W/\"cRMdDXbT82aLuZlvoL9Gqg==\"",
"name": "organizations/123456789012/locations/global/policyBindings/example-binding2",
"policy": "organizations/123456789012/locations/global/accessPolicies/example-policy",
"policyKind": "ACCESS",
"policyUid": "puid_9519202237377675265",
"target": {
"resource": "//cloudresourcemanager.googleapis.com/projects/example-project"
},
"uid": "buid_4331055466646863873",
"updateTime": "2026-05-07T07:05:06.203861Z"
}
]
}
REST
Mit der Methode accessPolicies.searchPolicyBindings werden alle Bindungen für die angegebene UAP aufgelistet.
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, für die Sie Bindungen auflisten möchten. Verwenden Sie den Wertprojects,foldersoderorganizations. -
UAP_PARENT_RESOURCE_ID: Die ID des Projekts, Ordners oder der Organisation, zu der die UAP gehört, für die Sie Bindungen auflisten möchten. Projekt-IDs sind alphanumerische Strings, wiemy-project. Ordner- und Organisations-IDs sind numerisch, z. B.123456789012. -
UAP_ID: Die ID der UAP, für die Sie Bindungen auflisten möchten, z. B.example-policy.
HTTP-Methode und URL:
GET https://iam.googleapis.com/v3/UAP_PARENT_RESOURCE_TYPE/UAP_PARENT_RESOURCE_ID/locations/global/accessPolicies/UAP_ID:searchPolicyBindings
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Die Antwort enthält die Bindungen für die angegebene UAP.
{
"policyBindings": [
{
"name": "organizations/123456789012/locations/global/policyBindings/example-binding1",
"uid": "buid_9904260005517852673",
"etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
"displayName": "Example binding 1",
"target": {
"resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"policyKind": "ACCESS",
"policy": "organizations/123456789012/locations/global/accessPolicies/example-policy",
"policyUid": "puid_9519202237377675265",
"createTime": "2026-05-06T18:08:24.729843Z",
"updateTime": "2026-05-06T18:08:24.729843Z"
},
{
"name": "organizations/123456789012/locations/global/policyBindings/example-binding2",
"uid": "buid_4331055466646863873",
"etag": "W/\"cRMdDXbT82aLuZlvoL9Gqg==\"",
"displayName": "Example binding 2",
"target": {
"resource": "//cloudresourcemanager.googleapis.com/projects/example-project"
},
"policyKind": "ACCESS",
"policy": "organizations/123456789012/locations/global/accessPolicies/example-policy",
"policyUid": "puid_9519202237377675265",
"createTime": "2026-05-07T07:05:06.203861Z",
"updateTime": "2026-05-07T07:05:06.203861Z"
}
]
}
Alle Bindungen für eine Ressource auflisten
Wenn Sie alle Bindungen aufrufen möchten, die eine bestimmte Zielressource enthalten, suchen Sie in den Bindungen nach dieser Ressource.
Jede Bindung enthält die ID der UAP, die an die Ressource gebunden ist. Wenn Sie die Details einer Richtlinie aufrufen möchten, verwenden Sie die Richtlinien-ID, um die Richtliniendetails abzurufen.
Sie können alle Bindungen für eine Ressource mit derGoogle Cloud Console, der gcloud CLI oder der IAM REST API aufrufen.
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, deren Bindungen Sie aufrufen möchten.
- Geben Sie im Feld Filter den Filter Erzwingung: Erzwungen ein.
In der Tabelle werden alle UAPs angezeigt, die an die Ressource gebunden sind.
gcloud
Mit dem Befehl gcloud iam policy-bindings search-target-policy-bindings werden alle UAP-Bindungen abgerufen, die die Ressource enthalten.
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
-
BINDING_PARENT_RESOURCE_TYPE: Der Typ der Resource Manager-Ressource (Projekt, Ordner oder Organisation), die Bindungen für die Zielressource übergeordnet ist. Verwenden Sie den Wertproject,folderoderorganization.Informationen dazu, welche Ressourcen übergeordnete Ressourcen für welche Bindungen sind, finden Sie unter Unterstützte Ressourcen.
-
BINDING_PARENT_RESOURCE_ID: Die ID des Projekts, Ordners oder der Organisation, die Bindungen für die Zielressource übergeordnet ist. Projekt-IDs sind alphanumerische Strings, wiemy-project. Ordner- und Organisations-IDs sind numerisch, z. B.123456789012. -
TARGET_RESOURCE: Die Ressource, deren Bindungen Sie auflisten möchten. Eine Liste der gültigen Ressourcen finden Sie unter Unterstützte Ressourcen. FORMAT: Das Format für die Antwort. Verwenden Siejsonoderyaml.
Führen Sie folgenden Befehl aus:
Linux, macOS oder Cloud Shell
gcloud iam policy-bindings search-target-policy-bindings \ --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID \ --target=TARGET_RESOURCE \ --format=FORMAT
Windows (PowerShell)
gcloud iam policy-bindings search-target-policy-bindings ` --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID ` --target=TARGET_RESOURCE ` --format=FORMAT
Windows (cmd.exe)
gcloud iam policy-bindings search-target-policy-bindings ^ --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID ^ --target=TARGET_RESOURCE ^ --format=FORMAT
Die Antwort enthält alle UAP-Bindungen, die die Zielressource enthalten.
{
"policyBindings": [
{
"createTime": "2026-05-06T18:08:24.729843Z",
"displayName": "Example binding 1",
"etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
"name": "organizations/123456789012/locations/global/policyBindings/example-binding1",
"policy": "organizations/123456789012/locations/global/accessPolicies/example-uap-policy-1",
"policyKind": "ACCESS",
"policyUid": "puid_9519202237377675265",
"target": {
"resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"uid": "buid_9904260005517852673",
"updateTime": "2026-05-06T18:11:16.798841Z"
},
{
"createTime": "2026-05-06T18:08:24.729843Z",
"displayName": "Example binding 2",
"etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
"name": "organizations/123456789012/locations/global/policyBindings/example-binding2",
"policy": "organizations/123456789012/locations/global/accessPolicies/example-uap-policy-2",
"policyKind": "ACCESS",
"policyUid": "puid_10358560617928851457",
"target": {
"resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"uid": "buid_4331055466646863873",
"updateTime": "2026-05-06T18:11:16.798841Z"
}
]
}
REST
Die Methode SearchTargetPolicyBindings.search ruft alle UAP-Bindungen ab, die die Ressource enthalten.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
-
BINDING_PARENT_RESOURCE_TYPE: Der Typ der Resource Manager-Ressource (Projekt, Ordner oder Organisation), die Bindungen für die Zielressource übergeordnet ist. Verwenden Sie den Wertprojects,foldersoderorganizations.Informationen dazu, welche Ressourcen übergeordnete Ressourcen für welche Bindungen sind, finden Sie unter Unterstützte Ressourcen.
-
BINDING_PARENT_RESOURCE_ID: Die ID des Projekts, Ordners oder der Organisation, die Bindungen für die Zielressource übergeordnet ist. Projekt-IDs sind alphanumerische Strings, wiemy-project. Ordner- und Organisations-IDs sind numerisch, z. B.123456789012. -
TARGET_RESOURCE: Die Ressource, deren Bindungen Sie auflisten möchten. Eine Liste der gültigen Ressourcen finden Sie unter Unterstützte Ressourcen.
HTTP-Methode und URL:
GET https://iam.googleapis.com/v3/BINDING_PARENT_RESOURCE_TYPE/BINDING_PARENT_RESOURCE_ID/locations/global/policyBindings:searchTargetPolicyBindings?target=TARGET_RESOURCE
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Die Antwort enthält alle UAP-Bindungen, die die Zielressource enthalten.
{
"policyBindings": [
{
"name": "organizations/123456789012/locations/global/policyBindings/example-binding1",
"uid": "buid_9904260005517852673",
"etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
"displayName": "Example binding 1",
"target": {
"resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"policy": "organizations/123456789012/locations/global/accessPolicies/example-uap-policy-1",
"createTime": "2026-05-06T18:08:24.729843Z",
"updateTime": "2026-05-06T18:11:16.798841Z",
"policyKind": "ACCESS",
"policyUid": "puid_9519202237377675265"
},
{
"name": "organizations/123456789012/locations/global/policyBindings/example-binding2",
"uid": "buid_4331055466646863873",
"etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
"displayName": "Example binding 2",
"target": {
"resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"policy": "organizations/123456789012/locations/global/accessPolicies/example-uap-policy-2",
"createTime": "2026-05-06T18:08:24.729843Z",
"updateTime": "2026-05-06T18:11:16.798841Z",
"policyKind": "ACCESS",
"policyUid": "puid_10358560617928851457"
}
]
}
Alle Bindungen in einem Projekt, Ordner oder einer Organisation auflisten
Wenn Sie die gcloud CLI oder die IAM REST API verwenden, um Bindungen aufzurufen, können Sie auch alle Bindungen auflisten, die einem bestimmten Projekt, Ordner oder einer bestimmten Organisation untergeordnet sind.
Das Auflisten von Bindungen für ein Projekt, einen Ordner oder eine Organisation ähnelt dem Suchen nach Bindungen für diese Ressource. Im Gegensatz zur Suche nach Bindungen werden beim Auflisten von Bindungen für eine Ressource jedoch auch alle Bindungen berücksichtigt, die direkte untergeordnete Elemente dieser Ressource sind.
Angenommen, Sie haben eine Bindung, die eine Richtlinie an ein Agent-Gateway der Network Services API anhängt. Die übergeordnete Ressource dieser Bindung ist das übergeordnete Projekt des Agent-Gateways. Mit anderen Worten: Die Bindung ist ein direktes untergeordnetes Element des Projekts. Wenn Sie Bindungen für dieses Projekt auflisten, enthält die Antwort die Bindung für das Agent-Gateway. Wenn Sie jedoch Bindungen für die übergeordnete Organisation des Projekts auflisten, enthält die Antwort die Bindung nicht. Das liegt daran, dass die Bindung zwar ein Nachfolger der Organisation, aber kein direktes untergeordnetes Element der Organisation ist.
Die übergeordnete Ressource einer Bindung hängt von der Zielressource in der Bindung ab. Weitere Informationen finden Sie unter Unterstützte Ressourcen.
Jede Bindung enthält die ID der UAP, die an die Ressource gebunden ist. Wenn Sie die Details einer Richtlinie aufrufen möchten, verwenden Sie die Richtlinien-ID, um die Richtliniendetails abzurufen.
Sie können alle Bindungen, die einem Projekt, Ordner oder einer Organisation untergeordnet sind, mit der gcloud CLI oder der IAM REST API aufrufen.
gcloud
Mit dem Befehl gcloud iam policy-bindings list werden alle UAP-Bindungen aufgelistet, die einer bestimmten Ressource untergeordnet sind.
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
-
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. FORMAT: Das Format für die Antwort. Verwenden Siejsonoderyaml.
Führen Sie folgenden Befehl aus:
Linux, macOS oder Cloud Shell
gcloud iam policy-bindings list --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID \ --location=global \ --filter=policyKind:ACCESS \ --format=FORMAT
Windows (PowerShell)
gcloud iam policy-bindings list --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID ` --location=global ` --filter=policyKind:ACCESS ` --format=FORMAT
Windows (cmd.exe)
gcloud iam policy-bindings list --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID ^ --location=global ^ --filter=policyKind:ACCESS ^ --format=FORMAT
Die Antwort enthält die UAP-Bindungen, die untergeordnete Elemente der Ressource im Befehl sind.
{
"policyBindings": [
{
"createTime": "2026-05-06T18:08:24.729843Z",
"displayName": "Example binding 1",
"etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
"name": "organizations/123456789012/locations/global/policyBindings/example-binding-1",
"policy": "organizations/123456789012/locations/global/accessPolicies/example-uap-1",
"policyKind": "ACCESS",
"policyUid": "puid_9519202237377675265",
"target": {
"resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"uid": "buid_9904260005517852673",
"updateTime": "2026-05-06T18:08:24.729843Z"
},
{
"createTime": "2026-05-07T07:05:06.203861Z",
"displayName": "Example binding 2",
"etag": "W/\"cRMdDXbT82aLuZlvoL9Gqg==\"",
"name": "organizations/123456789012/locations/global/policyBindings/example-binding-2",
"policy": "organizations/123456789012/locations/global/accessPolicies/example-uap-2",
"policyKind": "ACCESS",
"policyUid": "puid_1566408245394800641",
"target": {
"resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"uid": "buid_4331055466646863873",
"updateTime": "2026-05-07T07:05:06.203861Z"
}
]
}
REST
Mit der Methode policyBindings.list werden alle UAP-Bindungen aufgelistet, die einer bestimmten Ressource untergeordnet sind.
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.
HTTP-Methode und URL:
GET https://iam.googleapis.com/v3/BINDING_PARENT_RESOURCE_TYPE/BINDING_PARENT_RESOURCE_ID/locations/global/policyBindings?filter=policyKind:ACCESS
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Die Antwort enthält die UAP-Bindungen, die der Ressource in der Anfrage untergeordnet sind.
{
"policyBindings": [
{
"name": "organizations/123456789012/locations/global/policyBindings/example-binding-1",
"uid": "buid_9904260005517852673",
"etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
"displayName": "Example binding 1",
"target": {
"resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"policyKind": "ACCESS",
"policy": "organizations/123456789012/locations/global/accessPolicies/example-uap-1",
"policyUid": "puid_9519202237377675265",
"createTime": "2026-05-06T18:08:24.729843Z",
"updateTime": "2026-05-06T18:08:24.729843Z"
},
{
"name": "organizations/123456789012/locations/global/policyBindings/example-binding-2",
"uid": "buid_4331055466646863873",
"etag": "W/\"cRMdDXbT82aLuZlvoL9Gqg==\"",
"displayName": "Example binding 2",
"target": {
"resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"policyKind": "ACCESS",
"policy": "organizations/123456789012/locations/global/accessPolicies/example-uap-2",
"policyUid": "puid_1566408245394800641",
"createTime": "2026-05-07T07:05:06.203861Z",
"updateTime": "2026-05-07T07:05:06.203861Z"
}
]
}
Bindung für eine Unified Access Policy abrufen
Sie können die Details einer Bindung über die Google Cloud Console, die gcloud CLI oder die IAM REST API abrufen.
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 bzw. der die UAP gehört, deren Bindungen Sie aufrufen möchten.
- Klicken Sie auf die Richtlinien-ID der UAP, deren Bindungen Sie aufrufen möchten.
- Wählen Sie den Tab Bindungen aus.
- Suchen Sie die Bindung anhand der Bindungs-ID oder des Bindungsnamens.
In der Tabelle werden die Bindungsdetails angezeigt, einschließlich der Bindungs-ID, des Bindungsnamens und der Zielressource in der Bindung.
gcloud
Mit dem Befehl gcloud iam policy-bindings describe wird eine Bindung abgerufen.
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
-
BINDING_ID: Die ID der Bindung, die Sie abrufen möchten, 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. FORMAT: Das Format für die Antwort. Verwenden Siejsonoderyaml.
Führen Sie folgenden Befehl aus:
Linux, macOS oder Cloud Shell
gcloud iam policy-bindings describe BINDING_ID \ --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID \ --location=global --format=FORMAT
Windows (PowerShell)
gcloud iam policy-bindings describe BINDING_ID ` --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID ` --location=global --format=FORMAT
Windows (cmd.exe)
gcloud iam policy-bindings describe BINDING_ID ^ --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID ^ --location=global --format=FORMAT
Die Antwort enthält die Bindung.
{
"createTime": "2026-05-06T18:08:24.729843Z",
"displayName": "Example binding",
"etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
"name": "organizations/123456789012/locations/global/policyBindings/example-binding",
"policy": "organizations/123456789012/locations/global/accessPolicies/example-uap",
"policyKind": "ACCESS",
"policyUid": "puid_9519202237377675265",
"target": {
"resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"uid": "buid_9904260005517852673",
"updateTime": "2026-05-06T18:08:24.729843Z"
}
REST
Mit der Methode policyBindings.get wird eine Bindung abgerufen.
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: Die ID der Bindung, die Sie abrufen möchten, z. B.example-binding.
HTTP-Methode und URL:
GET https://iam.googleapis.com/v3/BINDING_PARENT_RESOURCE_TYPE/BINDING_PARENT_RESOURCE_ID/locations/global/policyBindings/BINDING_ID
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Die Antwort enthält die Bindung.
{
"name": "organizations/123456789012/locations/global/policyBindings/example-binding",
"uid": "buid_9904260005517852673",
"etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
"displayName": "Example binding",
"target": {
"resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"policyKind": "ACCESS",
"policy": "organizations/123456789012/locations/global/accessPolicies/example-uap",
"policyUid": "puid_9519202237377675265",
"createTime": "2026-05-06T18:08:24.729843Z",
"updateTime": "2026-05-06T18:08:24.729843Z"
}