Management API v2エンドポイントの移行：クエリのページネーション

• 2020年7月21日より前 に作成されたパブリッククラウドテナントまたはバージョン2108で導入のプライベートクラウド。
• 複数の結果を返す可能性のあるクエリに対してper_pageパラメーターを渡すことなく、影響を受けるエンドポイントを積極的に呼び出す

• 2020年7月21日以後 に作成されたパブリッククラウドテナントまたはバージョン2108以降で導入のプライベートクラウド。
• 影響を受けるエンドポイントを使用していない。
• 影響を受けるエンドポイントを使用しており、かつper_pageパラメーターを渡している、または単一の結果を常に返すクエリを実行している。

​

影響を受けるエンドポイント

• GET /api/v2/clients
• GET /api/v2/client_grants
• GET /api/v2/grants
• GET /api/v2/connections
• GET /api/v2/device-credentials
• GET /api/v2/resource-servers
• GET /api/v2/rules

​

アクション

1. pageおよびper_pageパラメーターを提供して、影響を受けるエンドポイントへの呼び出しすべてを置き換えます。

   パラメーター	タイプ	説明
   page	整数	返される結果のページインデックス。最初のページは0になります。
   per_page	整数	1ページあたりの結果件数。このパラメーターが送信されない場合、ページ分割は無効になります。

2. テナントログに廃止通知が表示されないことを確認します。要求が50個より多くのアイテムを返しているかどうか確認します。details.size_exceededフィールドを見て、trueになっているか確認します。
   1. 以下のログクエリを使用して、複数の結果でページネーションオプションなしで呼び出しすべてを返します。 type:depnote AND description:*Unpaginated*
   2. 以下のログクエリを使用して、複数の結果でページネーションオプションなしで呼び出しすべてを返します。 type:depnote AND description:*Unpaginated* AND details.size_exceeded:true
   要求を行うアプリケーションを特定するために、要求を行うために使用されるclient_idがログに含まれます。また、ログのdetails.pathフィールドで使用されるエンドポイントを見つけることもできます。
3. テナントに対するManagement APIの非ページネーション要求を無効にする［Dashboard］>［Tenant Settings（テナント設定）］>［Advanced（詳細設定）］>［Migration（移行）］に移動します。これにより、移行ウィンドウが閉じた後に期待される動作をシミュレートして、影響を受けるエンドポイントを呼び出し、最大50個の結果を返します。その日までいつでも、非ページネーションの要求を最び有効化できます。

​

拡張機能の更新

1. 拡張機能URLに一致するIDのクライアントについて、廃止通知があるかテナントログを確認してください。その場合、その拡張機能を更新する必要があります。
2. ［Dashboard］ > ［Extensions（拡張機能）］に移動し、［Installed Extensions（インストール済みの拡張機能）］ を選択して、拡張機能の ［Update（更新）］ リンクがあれば、それをクリックしてください。

​

Deploy CLIツールの更新