エラー処理

Reactor API を呼び出す際に問題が発生した場合は、次のいずれかの方法でエラーが返されることがあります。

  • 即時エラー:即時エラーになるリクエストを実行すると、API によってエラー応答が返され、HTTP ステータスには、発生した一般的なタイプのエラーが反映されます。
  • 遅延エラー:遅延エラー(非同期アクティビティなど)を引き起こす API リクエストを実行すると、API から関連リソースの meta.status_details でエラーが返される場合があります。

エラー形式

エラー応答は、JSON:API エラーの仕様に準拠することを目的とし、通常は次の構造に従います。

{
  "errors": [
    {
      "id": "8a5526da-ab12-4be9-b084-2efe537f388c",
      "status": "404",
      "code": "not-found",
      "title": "Record Not Found",
      "meta": {
        "request_id": "jfb0dQ2e0XVTkQ6AOfEJFfTDjguw9x3d"
      },
      "source": {
        "pointer": "/data"
      }
    }
  ]
}
プロパティ
説明
id
この問題の発生に対する一意の ID です。
status
この問題に適用される HTTP ステータスコードを文字列値で表します。
code
アプリケーション固有のエラーコードで、文字列値で表されます。
title
ローカリゼーション目的以外で、発生から次の発生までの間に​ 変更すべきでない、人間が判読可能な、問題の短い要約です。
detail
この問題の発生に固有の、人間が判読可能な説明です。title と同様に、このフィールドの値はローカライズできます。
source

エラーのソースへの参照を含むオブジェクトです。オプションで、次のメンバーのいずれかを含みます。

  • pointer:要求ドキュメント内の関連エンティティを参照する JSON ポインター(RFC6901) 文字列(例えば、プライマリデータオブジェクトの /data や、特定の属性の /data/attributes/title)。
meta
エラーに関する非標準のメタデータを含むオブジェクトです。

エラーリファレンス

次の表に、API が返す様々なエラーを示します。

エラータイトル
説明
authentication-failure
IMS アクセストークンが無効です。再度ログインすると、新しいアクセストークンを取得できます。または、テクニカルアカウントの場合、新しい JWT を生成し、IMS アクセストークンを入れ替えます。
connection-refused
サーバーへの接続を確立できませんでした。
decrypt-bad-passphrase
指定されたパスフレーズでデータを復号化できませんでした。
decrypt-failed
指定された秘密キーでデータを復号化できませんでした。キーがローカルで機能し、空白が削除されていることを確認します。
decrypt-no-data
秘密キーがないと、データを復号化できません。暗号化された秘密キーを指定してください。
delegate-descriptor-unresolved
拡張機能は、このデリゲート記述子の予期された定義を提供しませんでした。 拡張機能の更新が必要になる場合があります。
deleted-resources
ライブラリに追加しようとしているリソースが削除されました。
environment-in-use
環境は、一度に 1 つのライブラリにのみ割り当てることができます。オプション 1 は、別の環境を選択することです。オプション 2 は、ライブラリを別の環境に移動するか、ライブラリを削除して、この環境を解放することです。
environment-required
ビルドを作成するには、ライブラリに環境が割り当てられている必要があります。
extension-not-found
データ要素またはルールコンポーネントを定義する拡張機能は、ライブラリに含まれません。必要な拡張機能がすべてライブラリに追加されていることを確認します。
extension-package-path-error
extension.json で定義されたパスが正しく構築されませんでした。
extension-package-transform-definition-error
オブジェクトプロパティに対して無効な変換を定義しました。各オブジェクトプロパティには、ファイル変換または関数変換のいずれかを 1 つ定義できます。
extension-package-zip-error
ExtensionPackage を解凍中、または配布用にファイルを圧縮中にエラーが発生しました。
host-in-use
1 つ以上の環境がホストを使用している場合、ホストは削除されない場合があります。
host-required
このライブラリに割り当てられた環境に有効なホストがありません。ライブラリに割り当てられている環境を確認します。次に、その環境に有効なホストを割り当てます。
host-type-error
SFTP ホストのみが使用前に資格情報を検証する必要があるため、事前テストはそのホストタイプでのみ使用できます。
illegal-custom-code-transform
customCode 変換を使用することはできません。関数またはファイル変換を指定してください。
ims-not-authorized
アカウントの認証中に不明なエラーが発生しました。後でもう一度やり直してください。
ims-session-error
ログインセッションに問題があります。ログアウトしてから、もう一度ログインしてください。
internal-error
内部エラーが発生しました。数分待ってから、もう一度お試しください。問題が解決しない場合は、クライアントケアにお問い合わせください。
invalid-data_element
無効なデータ要素をライブラリに追加できません。
invalid-embed_code
有効な埋め込みコードでないか、開発環境またはステージング環境にリンクしようとしています。Dynamic Tag Management(DTM)埋め込みコードは、実稼動環境にのみリンクできます。
invalid-extension
無効な拡張機能をライブラリに追加することはできません。
invalid-extension_package_id
拡張機能パッケージのオブジェクトプロパティの一部のみを変更できます。許可されていないプロパティを変更しようとしました。
invalid-new-owner-org-id
割り当てようとした組織 ID が有効な組織 ID ではありません。
invalid-org
アクティブな組織が API へのアクセス権を持っていません。正しい組織を使用していることを確認します。
invalid-rule
無効なルールをライブラリに追加することはできません。
invalid-settings-syntax
設定 JSON の解析中に構文エラーが発生しました。
library-file-not-found
extension.json で定義された必須のファイルが zip パッケージ内に見つかりませんでした。
minification-error
無効なコードが原因で、コードをコンパイルできませんでした。
multiple-revisions
1 つのライブラリに含めることができるリビジョンは、各リソースで 1 つだけです。
no-available-orgs
このユーザーアカウントは、タグへのアクセス権を持つ製品プロファイルに属していません。Admin Console を使用して、タグ権限を持つ製品プロファイルにこのユーザーを追加します。
not-authorized
このユーザーアカウントには、この操作を実行するために必要な権限がありません。
not-found
レコードが見つかりませんでした。取得しようとしているオブジェクトの ID を検証します。
not-unique
使用しようとしている名前は既に使用中です。このリソースでは、「name」プロパティは一意である必要があります。
public-release-not-authorized
拡張機能の公開リリースは launch-ext-dev@adobe.com が調整します。 詳しくは、拡張機能のリリースに関するドキュメントを参照してください。
read-only
これは読み取り専用で、変更できません。
session-timeout
ユーザーセッションの有効期限が切れました。ログアウトしてから、もう一度ログインしてください。
sftp-authentication-failed
SFTP 接続の認証に失敗しました。
sftp-connection-timeout
SFTP 接続がタイムアウトしました。
sftp-exception
SFTP を使用してサーバーに接続する際に例外が発生しました。
sftp-status-exception
サーバーとの通信中に SFTP 例外が発生しました。
socket-error
サーバーとの通信中にソケットエラーが発生しました。
ssh-disconnect
SSH セッションが切断されました。
timeout-error
サーバーとの接続がタイムアウトしました。
unknown-error
予期しないエラーが発生しました。後でもう一度試すか、カスタマーケアに連絡して、発生時の操作を説明してもらうことができます。
unsupported-custom-code-language
サポートされていないカスタムコード言語が指定されました。
upgraded-extension-required
拡張機能のアップグレードをインストールしたら、アップグレードが実稼動環境に移行するまで、そのアップグレードをすべてのライブラリに含める必要があります。唯一の例外は、拡張機能がまだ公開されていない場合です。
upstream-build-required
これをビルドする前に、アップストリームライブラリを正常にビルドする必要があります。
recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743