Mit Unified Access Policies (UAPs) können Sie Hauptkonten Zugriff aufGoogle Cloud -Ressourcen gewähren oder verweigern. Wenn eine UAP nicht mehr auf eine Ressource angewendet werden soll, können Sie die Richtlinienbindung löschen, die die Richtlinie an die Ressource bindet. Wenn Sie eine Richtlinie aus allen Ressourcen entfernen möchten, an die sie gebunden ist, können Sie die Richtlinie löschen.
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.
Rollen, die zum Löschen von Unified Access Policy-Bindungen erforderlich sind
Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Löschen einer Bindung für eine UAP benötigen:
- Access Policy User (
roles/iam.accessPolicyUser) für die Ressource, die die UAP besitzt. Diese Rolle enthält die Berechtigungiam.accesspolicies.unbind, die zum Löschen von Bindungen erforderlich ist. Eine Rolle, die die Berechtigung
SERVICE.RESOURCE.deletePolicyBindingenthält, wobeiRESOURCEder Ressourcentyp ist, an den die UAP gebunden ist, 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.
Rollen, die zum Löschen von Unified Access Policies erforderlich sind
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 Inhaber der UAP ist, die Sie löschen möchten, um die Berechtigungen zu erhalten, die Sie zum Löschen 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 Löschen von UAPs erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:
Erforderliche Berechtigungen
Die folgenden Berechtigungen sind zum Löschen von UAPs erforderlich:
-
iam.accesspolicies.delete -
Löschen Sie UAPs in der Google Cloud Console:
-
iam.accesspolicies.get -
iam.accessPolicies.list
-
Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.
Unified Access Policy aus einer Ressource entfernen
Wenn Sie eine UAP von einer Ressource entfernen möchten, löschen Sie die Bindung, die die UAP an die Ressource bindet. Nachdem Sie die Bindung gelöscht haben, gilt die UAP nicht mehr für die Ressource oder die untergeordneten Ressourcen. Das UAP wird jedoch nicht gelöscht und keine der anderen Bindungen ist betroffen.
Sie können Bindungen für Projekte, Ordner und Organisationen mit derGoogle Cloud Console, der gcloud CLI oder der IAM REST API löschen. Wenn Sie Bindungen für andere Ressourcen löschen 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 bzw. der die UAP gehört, die Sie entfernen möchten.
- Klicken Sie auf die Richtlinien-ID der UAP, die Sie entfernen möchten.
- Wählen Sie den Tab Bindungen aus.
- Suchen Sie in der Tabelle Bindungen die Zeile mit der Bindung, die Sie entfernen möchten.
- Klicken Sie in dieser Zeile auf das Menü Aktionen und dann auf Bindung löschen.
- Klicken Sie im Dialogfeld Bindung löschen auf Löschen.
gcloud
Mit dem Befehl gcloud iam policy-bindings delete wird eine Bindung gelöscht.
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
-
BINDING_ID: Die ID der Bindung, die Sie löschen 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.
Führen Sie folgenden Befehl aus:
Linux, macOS oder Cloud Shell
gcloud iam policy-bindings delete BINDING_ID \ --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID --location=global
Windows (PowerShell)
gcloud iam policy-bindings delete BINDING_ID ` --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID --location=global
Windows (cmd.exe)
gcloud iam policy-bindings delete BINDING_ID ^ --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID --location=global
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.
Delete request issued for: [example-binding] Waiting for operation [organizations/123456789012/locations/global/operations/operation-1715374724030-6181fcd1520c5-d21b0a12-b704e1ce] to complete...done. Deleted policyBinding [example-binding].
REST
Mit der Methode policyBindings.delete wird eine Bindung gelöscht.
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 löschen möchten, z. B.example-binding.
HTTP-Methode und URL:
DELETE 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 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-1715373190994-6181f71b4daad-6d8168c1-13cc6600",
"metadata": {
"@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
"createTime": "2026-05-10T20:33:11.165728913Z",
"target": "organizations/123456789012/locations/global/policyBindings/example-binding",
"verb": "delete",
"requestedCancellation": false,
"apiVersion": "v3"
},
"done": false
}
Unified Access Policy löschen
Bevor Sie eine UAP löschen, müssen Sie alle vorhandenen Bindungen, die auf die UAP verweisen, identifizieren und löschen. Der Versuch, eine UAP zu löschen, ohne vorhandene Bindungen zu löschen, führt zu einem Fehler.
Wenn Sie eine UAP löschen möchten, ohne vorhandene Bindungen zu löschen, können Sie die UAP zwangsweise löschen. Wenn Sie eine UAP zwangsweise löschen, wird sie aus allen Ressourcen entfernt, an die sie gebunden ist. Alle Bindungen, die auf die UAP verweisen, werden schließlich gelöscht. Bis sie gelöscht werden, werden die Bindungen jedoch weiterhin auf die maximale Anzahl von Bindungen angerechnet, die sich auf eine einzelne Ressource beziehen können.
Sie können UAPs mit der Google Cloud Console, der gcloud CLI oder der IAM REST API löschen.
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, die Sie löschen möchten.
- Klicken Sie auf die Richtlinien-ID der UAP, die Sie löschen möchten.
- Klicken Sie auf Richtlinie löschen.
- Wenn die UAP vorhandene Bindungen hat, wählen Sie Diese Richtlinie und alle zugehörigen Bindungen löschen aus. Wenn Sie versuchen, eine UAP mit vorhandenen Bindungen zu löschen, ohne diese Option auszuwählen, schlägt die Anfrage fehl.
- Klicken Sie im Dialogfeld Richtlinie löschen auf Löschen.
gcloud
Mit dem Befehl gcloud iam access-policies delete wird eine UAP und alle zugehörigen Bindungen gelöscht.
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
-
UAP_ID: Die ID der UAP, die Sie löschen 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 löschen 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 löschen möchten. Projekt-IDs sind alphanumerische Strings, wiemy-project. Ordner- und Organisations-IDs sind numerisch, z. B.123456789012. -
FORCE_FLAG: Optional. Wenn Sie das Löschen einer Richtlinie erzwingen möchten, auch wenn diese Richtlinie in vorhandenen Bindungen referenziert wird, verwenden Sie das Flag--force. Wenn dieses Flag nicht festgelegt ist und die Richtlinie in vorhandenen Bindungen referenziert wird, schlägt der Befehl fehl.
Führen Sie folgenden Befehl aus:
Linux, macOS oder Cloud Shell
gcloud iam access-policies delete UAP_ID \ --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID --location=global \ FORCE_FLAG
Windows (PowerShell)
gcloud iam access-policies delete UAP_ID ` --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID --location=global ` FORCE_FLAG
Windows (cmd.exe)
gcloud iam access-policies delete UAP_ID ^ --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID --location=global ^ FORCE_FLAG
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.
Delete request issued for: [example-policy] Waiting for operation [organizations/123456789012/locations/global/operations/operation-1715374811191-6181fd2471ab4-f0947406-85778c43] to complete...done. Deleted accessPolicy [example-policy].
REST
Mit der Methode accessPolicies.delete werden eine UAP und alle zugehörigen Bindungen gelöscht.
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 löschen 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 löschen 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 löschen möchten, z. B.example-policy. -
FORCE_DELETE: Optional. Wenn Sie das Löschen der Richtlinie erzwingen möchten, auch wenn die Richtlinie in vorhandenen Bindungen referenziert wird, fügen Sie den Suchparameterforce=truehinzu. Wenn dieser Suchparameter nicht festgelegt ist und die Richtlinie in vorhandenen Bindungen referenziert wird, schlägt die Anfrage fehl.
HTTP-Methode und URL:
DELETE https://iam.googleapis.com/v3/UAP_PARENT_RESOURCE_TYPE/UAP_PARENT_RESOURCE_ID/locations/global/accessPolicies/UAP_ID?FORCE_DELETE
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-1715373190994-6181f71b4daad-6d8168c1-13cc6600",
"metadata": {
"@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
"createTime": "2026-05-10T20:33:11.165728913Z",
"target": "organizations/123456789012/locations/global/accessPolicies/example-policy",
"verb": "delete",
"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.