許可リストからドメインを削除する

このページでは、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 リクエストで指定された識別子の形式が正しく、ソースが正しいことを確認します:
• リソース名の形式を検証する: name パラメータに使用する文字列は、allowlistedDomains/UNIQUE_IDENTIFIER という形式に正確に従う必要があります。
• 名前のソースを確認する: リソース名は出力専用の識別子であり、同じ顧客に対して allowlistedDomains.list メソッドを以前に正常に呼び出したときに取得する必要があります。リソース名を構築したり推測したりしないでください。

監査ログ

Allowlisted Domains API を使用した削除では、管理者が確認できる監査ログイベントが生成されます。詳細については、監査ログの表示をご覧ください。