Domain aus der Zulassungsliste entfernen

Auf dieser Seite wird erklärt, wie Sie eine Domain mithilfe der Allowlisted Domains API aus der Zulassungsliste entfernen.

Hinweis

• Lesen Sie die Übersicht zur Allowlisted Domains API.
• Richten Sie die Allowlisted Domains API ein.

Domain aus der Zulassungsliste entfernen

Verwenden Sie die Methode delete, um eine Domain zu entfernen. Diese Mutation ist asynchron und gibt einen Vorgang mit langer Ausführungszeit zurück.

Python

def delete_allowlisted_domain(service, resource_name):
  """Deletes an allowlisted domain."""
  if not resource_name:
    print('Resource name is missing.')
    return None

  try:
    response = (
        service.allowlistedDomains().delete(name=resource_name).execute()
    )
    return response
  except Exception as e:
    print(f'An error occurred during delete: {e}')
    return None

Fehlerbehandlung

Fehlerbedingung	RPC-Statuscode	Fehlermeldung	Fehlerbehebung / Begründung
Keine Berechtigung für die Ressource	PERMISSION_DENIED (403)	"Permission denied for allowlisted domain resource."	• Prüfen Sie, ob dem Nutzer der entsprechende Bereich gewährt wurde. • Prüfen Sie, ob der Nutzer die erforderliche Berechtigung hat. • Wenden Sie sich an die E‑Mail-Adresse des Kontakts, um zu prüfen, ob das Projekt/der Nutzer auf der Zulassungsliste steht.
Kundennummer für den Nutzer nicht gefunden	NOT_FOUND (404)	"Customer ID not found for user."	Der angemeldete Nutzer ist nicht mit einer gültigen Domain verknüpft.
Eine Aktualisierung der Zulassungsliste läuft bereits.	FAILED_PRECONDITION (400)	"An allowlist update is already in progress. Please wait for it to complete before making another request."	Warten Sie, bis alle vorherigen Mutationsvorgänge (Erstellen oder Löschen) abgeschlossen sind, bevor Sie eine neue Anfrage senden.
Domain nicht in der Zulassungsliste gefunden	NOT_FOUND (404)	"Allowlisted domain <domain> not found."	Die angegebene Domain ist nicht in der Zulassungsliste vorhanden. Das kann passieren, wenn die Domain nicht hinzugefügt oder bereits aus der Zulassungsliste gelöscht wurde. In den Audit-Logs können Sie prüfen, ob die Domain in den letzten sechs Monaten hinzugefügt oder gelöscht wurde.
Ressourcenname ist ungültig	INVALID_ARGUMENT (400)	"Invalid resource name: <resourceName>."	So beheben Sie den Fehler „Ungültiger Ressourcenname“: Prüfen Sie, ob der im DELETE-Antrag angegebene Bezeichner korrekt formatiert ist und aus der richtigen Quelle stammt: • Format des Ressourcennamens prüfen: Die für den Parameter „name“ verwendete String muss genau dem Format allowlistedDomains/UNIQUE_IDENTIFIER entsprechen. • Quelle des Namens prüfen: Der Ressourcenname ist ein Bezeichner, der nur in der Ausgabe enthalten ist. Er muss aus einem vorherigen erfolgreichen Aufruf der Methode allowlistedDomains.list für denselben Kunden stammen. Erstellen oder erraten Sie den Ressourcennamen nicht.

Audit-Logs

Bei Löschvorgängen mit der Allowlisted Domains API werden Audit-Log-Ereignisse generiert, die von Administratoren geprüft werden können. Weitere Informationen finden Sie unter Audit-Logs ansehen.