スキーマレジストリ API ガイドの付録
このドキュメントでは、Schema Registry API の操作に関する補足情報を提供します。
クエリパラメーターの使用
Schema Registry では、リソースをリスト表示する際に、クエリパラメーターを使用して結果をページ化およびフィルタリングする機能をサポートしています。
メモ複数のクエリパラメーターを組み合わせる場合は、アンパサンド（
&）で区切る必要があります。ページング
ページングに最も一般的なクエリパラメーターは次のとおりです。
| パラメーター | 説明 |
|---|---|
orderby | 特定のプロパティで結果を並べ替えます。例：orderby=title は昇順（A ～ Z）のタイトルで結果を並べ替えます。パラメーター値（orderby=-title）の前に - を追加すると、項目がタイトルで降順（Z ～ A）に並べ替えられます。 |
limit | orderby パラメーターと共に使用す limit と、特定のリクエストに対して返される項目の最大数が制限されます。 このパラメーターは、orderby パラメーターが存在しない場合は使用できません。limit パラメーターは、返される項目の最大数に関して、ヒント として正の整数（0 ～ 500）を指定します。 例えば、limit=5 はリスト内の 5 つのリソースのみを返します。 ただし、この値は厳密には適用されません。 実際の応答サイズは、start パラメーターの信頼性の高い動作を提供する必要がある（提供されている場合）という制約の下で、小さくなることも大きくなることもあります。 |
start | orderby パラメーターと共に使用すると、start は項目のサブセット化されたリストを開始する場所を指定します。 このパラメーターは、orderby パラメーターが存在しない場合は使用できません。 この値は、リスト応答の _page.next 属性から取得でき、結果の次のページにアクセスするために使用できます。 _page.next の値が null の場合、使用可能な追加のページはありません。通常、結果の最初のページを取得するために、このパラメーターは省略されます。 その後、前のページ start 受け取った orderby フィールドのプライマリソートプロパティの最大値に設定する必要があります。 次に、API 応答は、指定された値より厳密に大きい（昇順の場合）または厳密 orderby 小さい（降順の場合）プライマリ並べ替えプロパティを持つエントリで始まるエントリを返します。例えば、 orderby パラメーターが orderby=name,firstname に設定されている場合、start パラメーターには name プロパティの値が含まれます。 この場合、「Miller」という名前の直後にリソースの次の 20 個のエントリを表示する場合は、?orderby=name,firstname&start=Miller&limit=20 を使用します。 |