Supprimer un domaine de la liste d'autorisation
Cette page explique comment supprimer un domaine de la liste d'autorisation à l'aide de l'API Allowlisted Domains.
Avant de commencer
- Consultez la présentation de l'API Allowlisted Domains.
- Configurez l'API Allowlisted Domains.
Supprimer un domaine de la liste d'autorisation
Utilisez la méthode delete pour supprimer un domaine. Cette mutation est asynchrone et renvoie une opération de longue durée.
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
Traitement des erreurs
| Condition d'erreur | Code d'état RPC | Message d'erreur | Dépannage / Justification |
|---|---|---|---|
| Non autorisé à accéder à la ressource | PERMISSION_DENIED (403) |
"Permission denied for allowlisted domain resource." |
• Assurez-vous que l'utilisateur dispose du champ d'application approprié. • Assurez-vous que l'utilisateur dispose de l'autorisation requise. • Contactez l'adresse e-mail de contact pour vérifier si le projet/l'utilisateur a été ajouté à la liste d'autorisation ou non. |
| ID client introuvable pour l'utilisateur | NOT_FOUND (404) |
"Customer ID not found for user." |
L'utilisateur connecté n'est pas associé à un domaine valide. |
| Une mise à jour de la liste d'autorisation est déjà en cours. | FAILED_PRECONDITION (400) |
"An allowlist update is already in progress. Please wait for it to complete before making another request." |
Attendez la fin de toute opération de mutation précédente (création ou suppression) avant de lancer une nouvelle requête. |
| Domaine introuvable dans la liste d'autorisation | NOT_FOUND (404) |
"Allowlisted domain <domain> not found." |
Le domaine fourni n'existe pas dans la liste d'autorisation. Cela peut se produire si le domaine n'a pas été ajouté ou s'il a déjà été supprimé de la liste d'autorisation. Vous pouvez consulter les journaux d'audit pour vérifier si le domaine a été ajouté/supprimé au cours des six derniers mois. |
| Nom de ressource non valide | INVALID_ARGUMENT (400) |
"Invalid resource name: <resourceName>." |
Pour résoudre l'erreur "Nom de ressource non valide", assurez-vous que l'identifiant fourni dans la requête DELETE est correctement mis en forme et provient de la bonne source : • Valider le format du nom de ressource : la chaîne utilisée pour le paramètre name doit respecter précisément le format allowlistedDomains/UNIQUE_IDENTIFIER.• Vérifier la source du nom : le nom de ressource est un identifiant en sortie uniquement et doit être obtenu à partir d'un appel réussi précédent à la méthode allowlistedDomains.list pour le même client. Ne construisez pas le nom de ressource et ne le devinez pas. |
Journaux d'audit
Les suppressions effectuées à l'aide de l'API Allowlisted Domains génèrent des événements de journal d'audit que les administrateurs peuvent examiner. Pour plus d'informations, consultez la section Afficher les journaux d'audit.