この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。

Composite サブ要求の結果

Composite サブ要求の結果では、サブ要求の結果を記述します。

プロパティ

名前	型	説明
`body`	データ型は、サブ要求の応答種別によって異なります。	このサブ要求のレスポンスボディ。詳細は、サブ要求リソースのドキュメントを参照してください。サブ要求がエラーを返す場合、ボディにはエラーコードとエラーメッセージが含まれます。エラー応答についての詳細は「状況コードとエラー応答」を参照してください。
`httpHeaders`	Map<String, String>	このサブ要求のレポートヘッダーとその値。Composite リソースは Content-Length ヘッダーをサポートしないため、サブ要求のレスポンスにも最上位レベルのレスポンスにもこのヘッダーは含まれません。
`httpStatusCode`	Integer	このサブ要求の HTTP 状況コード。Composite 要求で `allOrNone` が true に設定されていて、サブ要求がエラーを返す場合、他のすべてのサブ要求は 400 HTTP 状況コードを返します。
`referenceId`	String	サブ要求で指定された参照 ID。このプロパティにより、サブ要求をその結果に容易に関連付けることができます。

次の例は、Contact の��成中にエラーが発生したサブ要求への応答を示します。

referenceId には、文字、数字、アンダースコア (「_」) のみを使用する必要があります。

無効な文字があった場合の API の動作は、API バージョンとリリースによって異なります。(Composite 要求の作成に使用された API バージョンが関係しますが、このバージョンは url パラメータに指定された API バージョンと必ずしも同じではありません)。

たとえば、以下の要求を検討します。この要求では、次の操作が試みられます。

最初の参照 ID、refNewAccount[1] に無効な文字が含まれています。

バージョン 51.0 以前

API バージョン 51.0 以前の場合、参照 ID に無効な文字が含まれていると、その参照 ID を使用するすべてのサブ要求が失敗します。この例の場合の応答を次に示します。

2 つの取引先が作成されます (最初の取引先が参照 ID 内の無効な文字を使用していても)。ただし、(無効な文字を含む参照 ID を使用して) 取引先を作成する試みは失敗します。

以前のリリースでのバージョン 51.0 以前の応答

上記の応答は、Summer ’21 以降のリリースのものです。Summer ’21 より前のリリースの場合、応答内の「(」または「[」を含む問題のある参照 ID は、切り捨てられました。したがって、応答は次のようになりました。

Summer ’21 リリース以降、参照 ID は、問題があっても切り捨てられなくなりました。この変更により、応答と要求の各部をより簡単に突き合わせることができます。

バージョン 52.0 以降

API バージョン 52.0 以降の場合、参照 ID に無効な文字が含まれていると、要求全体が失敗します。上記の例に対する応答を次に示します。

まとめ

エラー応答の概要。