コンテンツにスキップ
View in Postman (opens in new tab)

カタログ項目を置き換える

put

/catalogs/{catalog_name}/items

このエンドポイントを使用して、カタログ内の複数の項目を置き換えます。

カタログ項目が存在しない場合、このエンドポイントはカタログ内にその項目を作成します。1回のリクエストで最大50個のカタログ項目を処理できます。このエンドポイントは非同期です。

トラブルシューティング

次の表に、返される可能性のあるエラーと、それに対応するトラブルシューティングのステップを示します。

エラー トラブルシューティング
catalog-not-found カタログ名が有効であることを確認してください。
company-size-limit-already-reached カタログのストレージサイズの上限に達しています。ストレージ階層の詳細については、データストレージの制限を参照してください。
company-size-limit-surge リクエストが会社の残りのカタログストレージを超えています。より小さな更新で再試行してください。ストレージ階層の詳細については、データストレージの制限を参照してください。
ids-not-strings 各項目IDが文字列であることを確認してください。
ids-not-unique 各項目IDが一意であることを確認してください。
ids-too-large 各項目IDの文字数の上限は250文字です。
items-array-is-invalid itemsはオブジェクトの配列である必要があります。
items-missing-ids 項目IDがない項目があります。各項目にIDがあることを確認してください。
items-too-large 項目の値は5,000文字を超えることはできません。
invalid-ids 項目ID名に使用できる文字は、英字、数字、ハイフン、アンダースコアです。
invalid-fields APIリクエストで送信するすべてのフィールドがカタログにすでに存在することを確認してください。これは、エラーに記載されているIDフィールドとは関係ありません。
invalid-keys-in-value-object 項目オブジェクトのキーに.または$を含めることはできません。
too-deep-nesting-in-value-object 項目オブジェクトのネストは50レベルを超えることはできません。
request-includes-too-many-items リクエストに含まれる項目が多すぎます。1回のリクエストあたりの項目の上限は50です。
unable-to-coerce-value 項目のタイプを変換できません。

OpenAPIドキュメントをダウンロードして、スキーマの検証に使用できます。方法については、リクエスト検証にOpenAPIスキーマを使用するを参照してください。

New Stuff!