从许可名单中移除网域

本页介绍了如何使用 Allowlisted Domains API 从许可名单中移除网域。

准备工作

• 阅读列入许可名单的网域 API 概览。
• 设置 Allowlisted Domains API。

从许可名单中移除网域

使用 delete 方法移除网域。此变更是异步的，并返回长时间运行的操作 (LRO)。

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

错误处理

错误情况	RPC 状态代码	错误消息	问题排查 / 理由
未获得资源授权	PERMISSION_DENIED (403)	"Permission denied for allowlisted domain resource."	• 确保用户已获得适当的范围。 • 确保用户拥有所需权限。 • 请通过联系电子邮件地址确认项目/用户是否已列入许可名单。
找不到相应用户的客户 ID	NOT_FOUND (404)	"Customer ID not found for user."	登录的用户未与有效网域相关联。
许可名单更新已在进行中。	FAILED_PRECONDITION (400)	"An allowlist update is already in progress. Please wait for it to complete before making another request."	等待任何之前的变更（创建或删除）操作完成后，再发起新请求。
许可名单中未找到相应网域	NOT_FOUND (404)	"Allowlisted domain <domain> not found."	提供的网域不在许可名单中。如果网域未添加到许可名单中或已从许可名单中删除，就可能会发生这种情况。您可以查看审核日志，验证网域是否在过去 6 个月内添加/删除。
资源名称无效	INVALID_ARGUMENT (400)	"Invalid resource name: <resourceName>."	如需解决“资源名称无效”错误，请确保 DELETE 请求中提供的标识符格式正确且来源正确： • 验证资源名称格式：用于名称形参的字符串必须严格遵循 allowlistedDomains/UNIQUE_IDENTIFIER 格式。 • 验证名称来源：资源名称是“仅输出”标识符，应从之前对同一客户成功调用 allowlistedDomains.list 方法时获取。请勿构造或猜测资源名称。

审核日志

使用许可网域 API 进行的删除操作会生成审核日志事件，管理员可以查看这些事件。如需了解详情，请参阅查看审核日志。