Privacy Service エラーコード privacy-service-error-codes
このリファレンスを使用して、Privacy Service ジョブの結果を特定し、エラーを診断し、Adobe Experience Platform でプライバシージョブを送信または監視する際の次の適切な手順を決定します。 プライバシージョブを作成、送信、監視する方法については、 プライバシージョブエンドポイントガイド または Privacy Service UI ユーザーガイド を参照してください。
Privacy Service エラーコードは、安定したパブリックコントラクトです。 各エラーコードは、プログラムによる処理と操作ワークフローで信頼できる失敗状態または完了状態を一意に識別します。
自動化を構築したりワークフローを監視したりする場合は、次の保証が適用されます。
- エラーコードは、公開後も安定しています。
- エラーメッセージは、わかりやすくするために変更される場合がありますが、コード値は変更されません。
- 新しいエラーコードは、時間の経過と共に追加される場合があります。既存のコードは再利用されません。
自動化や決定ロジックを実装するには、メッセージテキストではなく、エラーコードを使用します。 ポーリングやメッセージ文字列に依存せずにプライバシージョブを効率的に処理する方法、ジョブのステータスを監視する方法、およびエラーを処理する方法については、Privacy Serviceのベストプラクティス を参照してください。
エラー応答形式 error-response-format
Privacy Serviceは、ジョブとリクエストの応答でエラー情報を返します。 応答は、応答ペイロードに数値エラーコードと人間が判読できるメッセージを含む。
このエラーコードは、信頼できる結果を示しています。 メッセージには、トラブルシューティングに役立つ追加のコンテキストが表示されます。
このドキュメントでは、各エラーコードの意味と目的について説明します。 フィールドレベルの応答スキーマとリクエストの詳細については、Privacy Service API ドキュメント を参照してください。
エラードメイン error-domains
エラーコードは、問題をより迅速に診断できるように、機能ドメイン別にグループ化されています。
このドキュメントで使用されるドメインは次のとおりです。
- リクエストの検証：リクエストの形式が正しくないか、無効な値が含まれています。 リクエスト構造と検証の要件については、 プライバシージョブエンドポイントガイド を参照してください。
- 認証とプロビジョニング：組織またはユーザーが、必要なアクセス権を持っていません。 役割ベースの権限要件を確認するには、 権限の管理 を参照してください。
- ID と適用性：識別子または名前空間はリクエストに適用されません。 サポートされる ID タイプと名前空間要件については、 プライバシーリクエストの ID データ を参照してください。
- レート制限：送信ボリュームがプラットフォームの制限を超えています。 このエラーが発生した場合は、送信率を下げて、もう一度試してください。
- データのアクセスと処理：システムは、リクエストされたデータにアクセスしたり処理したりできません。 一般的な原因と修復手順については、 トラブルシューティングガイド を参照してください。
- 暗号化とキー管理：必要な暗号化キーを使用できません。 鍵のアクセス、設定、回復のガイダンスについては、 顧客管理キー を参照してください。
- ジョブの実行状態：ジョブが完全、部分的に、または失敗して完了しました。 ジョブステータスカテゴリとその意味の説明については、 プライバシージョブエンドポイントガイド を参照してください。
エラーコードの参照 error-code-reference
次の表に、すべてのパブリック Privacy Service エラーコードを示します。