ストリーミング API 開発者ガイド
jストリーミング API エラーコード
ストリーミングクライアントのトラブルシューティングのために、ストリーミング API が返す可能性のあるエラーについて説明します。
| エラーコード | エラーメッセージ | エラーの説明 |
|---|---|---|
| 400 | API version in the URI is mandatory. (URI 内の API バージョンは必須です。)URI format: '/cometd/60.0' (URI の形式は '/cometd/59.0' です。) | URI に API バージョン情報が含まれていません。URI の末尾に API バージョンを含めてください。たとえば、/cometd/60.0 です。 |
| 400 | Unsupported API version. (API バージョンがサポートされていません。)Only API versions '23.0' and above are supported. (サポートされているのは、API バージョン '23.0' 以降のみです。)URI format: '/cometd/60.0' (URI の形式は '/cometd/59.0' です。) | URI で指定された API バージョンはサポートされていません。サポートされているのは、API バージョン 23.0 以降のみです。URI の形式は /cometd/xx.x です。 |
| 400 | Invalid connection type {connection_type} (無効な接続種別 {connection_type}) | 無効なトランスポート種別が使用されました。long polling のみがサポートされていますが、別の接続種別 (WebSocket またはコールバック long polling など) が要求されました。 |
| 400 | The channel you requested to subscribe to does not exist {channel_name} (登録を要求されたチャネルは存在しません {channel_name}) | 登録を要求されたストリーミングチャネルは存在しません。登録の前にチャネルが作成されていることを確認してください。 |
| 400 | Channel name not specified (チャネル名が指定されていません) | チャネル名が指定されていません。登録する有効なチャネル名を指定してください。 |
| 400 | Channel subscriptions must start with a leading '/' (チャネル登録は「/」で開始する必要があります) | チャネル名の形式が無効です。チャネル名はスラッシュ (/) で開始する必要があります。 |
| 400 | Query fields {query_fields} do not exist on the topic entity (クエリ項目 {query_fields} はトピックエントリに存在しません) | 指定されたクエリ項目が、PushTopic で指定された Salesforce オブジェクトに存在しません。 |
| 400 | Client client_name has established a session, but no cookie_name cookie present (クライアント client_name はセッションを確立しましたが、cookie_name という Cookie が存在しません) | クライアントがセッションを確立した後に Cookie が見つかりませんでした。ストリーミングクライアントが Cookie を受け入れていることを確認してください。 |
| 400 | The replayId {replay_id} you provided was invalid. Please provide a valid ID, -2 to replay all events, or -1 to replay only new events. (指定された再実行 ID {replay_id} が無効でした。有効な ID を指定してください。すべてのイベントを再実行する場合は -2、新規イベントのみを再実行する場合は -1 を指定します。) | 指定された再実行 ID が無効です。再実行 ID が、保持期間内にあって削除されていないイベントに対応していることを確認してください。または、すべてのイベントを再実行する場合は -2、新規イベントのみを再実行する場合は -1 を指定します。 |
| 401 | Authentication invalid. (認証が無効です。) | 指定された認証トークンまたはセッション ID が無効です。このエラーは、/meta/handshake チャネルまたは /meta/connect チャネルで返されます。/meta/handshake チャネルでは、エラーは ext/sfdc 項目にネストされている failureReason 応答項目にあります。/meta/connect チャネルでは、エラーは error 項目にあります。 |
| 401 | Request requires authentication. (要求には認証が必要です。) | 要求ヘッダーで認証トークンまたはセッション ID が指定されていません。クライアントは認証情報を送信する必要があります。このエラーは、ハンドシェイクエラー応答 (/meta/handshake チャネル) の ext/sfdc 項目にネストされている failureReason 応答項目で返されます。応答の error 項目には、403::Handshake denied エラーも含まれます。 |
| 403 | Cannot create channel {channel_name} (チャネルを作成できません {channel_name}) | 登録チャネルを作成できません。権限が不十分である可能性があります。 |
| 403 | Subscriber does not have access to the entity in this topic (登録者には、このトピックのエンティティへのアクセス権がありません) | 登録者には、PushTopic の Salesforce オブジェクトへのアクセス権がありません。 |
| 403 | Subscriber does not have access to all fields referenced in the where clause of the PushTopic (登録者には、PushTopic トピックの where 句で参照されるすべての項目へのアクセス権がありません) | 登録者には、PushTopic トピックの WHERE 句で参照されるすべての項目へのアクセス権がありません。 |
| 403 | Handshake denied (ハンドシェイクが拒否されました) | ハンドシェイク要求が拒否されました。このエラーの原因は、応答の ext/sfdc 項目にネストされている failureReason 項目に表示されています。 |
| 403 | Client has not completed handshake (クライアントはハンドシェイクを完了していません) | クライアントはハンドシェイクを完了していません。クライアントは、登録前にハンドシェイクを実行する必要があります。 |
| 403 | Organization concurrent user limit exceeded (組織の同時ユーザー数の制限を超えました) | すべてのチャネルでの同時クライアントの最大数を超えました。このエラーは、PushTopic、汎用、プラットフォーム、変更データキャプチャイベントを含むすべてのイベント種別に適用されます。 |
| 403 | Organization total events daily limit exceeded (組織の 1 日あたりの合計イベント数の制限を超えました) | 24 時間以内にすべての CometD クライアントに配信されたイベント通知の最大数を超えました。このエラーは、PushTopic、汎用、プラットフォーム、変更データキャプチャイベントを含むすべてのイベント種別に適用されます。 |
| 403 | Restricted channel (制限されたチャネル) | ユーザーには、このストリーミングチャネルに登録するために必要な権限がありません。 |
| 403 | User not enabled for streaming (ユーザーはストリーミングに対して有効になっていません) | ユーザーには、PushTopic に対する参照権限がありません。 |
| 403 | User not allowed to subscribe CDC without View All Data permissions (ユーザーに「すべてのデータの参照」権限がないと CDC に登録できません) | ユーザーが変更データキャプチャに登録するには、「すべてのデータの参照」権限が必要です。 |
| 403 | Subscription limit exceeded for this topic (このトピックの登録制限を超えました) | PushTopic イベントと汎用イベントのトピックあたりの同時クライアントの最大数を超えました。このエラーはプラットフォームイベントには適用されません。 |
| 403 | Unknown client (不明なクライアント) | タイムアウトのためにサーバーがクライアント CometD セッションを削除しました。ネットワーク障害による可能性があります。クライアントは、新しいハンドシェイクを実行して再接続する必要があります。 |
| 403 | To protect all customers from excessive use and Denial of Service attacks, we limit the number of simultaneous connections per server. Your request has been denied because this limit has been exceeded. Please try your request again later. (過度な使用およびサービス拒否攻撃からすべてのお客様を保護するために、サーバーあたりの同時接続数を制限しています。この制限に達したために、要求が拒否されました。後でもう一度要求をお試しください。) | 過度な使用およびサービス拒否攻撃から保護するため、Salesforce アプリケーションサーバーには、サーバーあたりの同時接続数の制限が適用されます。この制限に達したために、要求が拒否されました。後でもう一度要求をお試しください。このエラーは、ハンドシェイク応答 (/meta/handshake チャネル) の ext/sfdc 項目にネストされている failureReason 応答項目で返されます。応答の error 項目には、403::Handshake denied エラーも含まれます。 |
| 413 | Maximum Request Size Exceeded (最大要求サイズを超えました) | 最大要求サイズである 32,768 バイトを超えました。 |
| 503 | Server is too busy. Please try your request again later. (サーバーが混雑しています。後でもう一度要求をお試しください。) | サーバーが混雑しているため、要求を処理できません。後でもう一度要求をお試しください。このエラーは、/meta/handshake チャネルまたは /meta/connect チャネルの ext/sfdc 項目にネストされている failureReason 応答項目で返されます。応答の error 項目には、このエラーと共に別のエラーも含まれます。 |
汎用ストリーミングのみのエラー
次のエラーは汎用ストリーミングイベントでのみ返されます。
| エラーコード | エラーメッセージ | エラーの説明 |
|---|---|---|
| 403 | Unable to create channel dynamically, maximum channel limit has been exceeded (最大チャネル数の制限を超えたため、チャネルを動的に作成できません) | 汎用ストリーミングチャネルの最大数を超えました。 |
| 403 | No access on channel (チャネルにアクセスできません) | ユーザーに StreamingChannel オブジェクトに対する権限がないため、汎用ストリーミングチャネルにアクセスできません。 |
| 404 | channel names may not vary only by case (大文字小文字のみが異なるチャネル名は使用できません) | 大文字小文字のみが異なる汎用ストリーミングチャネルが存在します。汎用ストリーミングチャネル名では大文字と小文字が区別されます。 |
| 404 | Unknown channel (不明なチャネル) | 汎用ストリーミングチャネルが見つからないか、動的に作成できません。 |