Skip to main content
2021年1月26日以降 (またはPrivate Cloud version 2202以降) 、 v2エンドポイントへのリクエストでは、Public Cloud のテナントに対して最大50件までしか返されません。さらに多くの項目を取得するには、pageper_page パラメーターを含める必要があります。2020年7月21日 (またはPrivate Cloud version 2108) 以降、Auth0 はこの変更に備えられるよう、テナントログと移行用のトグルを表示します。 影響を受けるテナントは、次の条件を満たすものです。
  • 2020年7月21日より前に作成された Public Cloud テナント、またはバージョン2108の Private Cloud デプロイ
  • 影響を受けるエンドポイントに対して、複数の結果を返す可能性があるクエリで per_page パラメーターを渡さずに、継続的に呼び出しを行っていること。
次のテナントでは、新しいページネーション動作がデフォルトとなり、2021年1月26日以降も現在と同じように動作し続けます。
  • 2020年7月21日以降に作成された Public Cloud テナント、またはバージョン2108以上の Private Cloud デプロイ
  • 影響を受けるエンドポイントを使用していない
  • 影響を受けるエンドポイントを使用し、per_page パラメーターを渡している、または常に単一の結果を返すクエリを実行している。

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

以下の Management API v2 エンドポイントの呼び出しが影響を受けます: ページネーションオプションを指定していないすべてのリクエストのうち、現在 2 件以上の項目を返しているものについては、クライアントとエンドポイントの組み合わせごとに 1 時間に 1 回、非推奨通知がテナントログに記録されます。

Actions

  1. page パラメーターと per_page パラメーターを指定して、影響を受けるすべてのエンドポイントへの呼び出しを置き換えます。
  1. テナントログに非推奨通知が表示されなくなったことを確認します。リクエストが 50 件を超える項目を返していないか確認してください。details.size_exceeded フィールドを確認し、値が true かどうかを確認します。
    1. ページネーションオプションなしで 1 件を超える結果を返すすべての呼び出しを確認するには、次のログクエリを使用します。 type:depnote AND description:*Unpaginated*
    2. ページネーションオプションなしで 50 件を超える結果を返すすべての呼び出しを確認するには、次のログクエリを使用します。 type:depnote AND description:*Unpaginated* AND details.size_exceeded:true
    リクエストを行っているアプリケーションを特定するには、ログにそのリクエストで使用された client_id が含まれます。使用されているエンドポイントは、ログの details.path フィールドでも確認できます。
  2. テナントで Management API のページネーションなしリクエストを無効にします。Auth0 Dashboard > Tenant Settings > Advanced > Migration に移動してください。これにより、migration window の終了後に想定される動作を再現でき、影響を受けるエンドポイントへの呼び出しは最大 50 件の結果を返すようになります。その日付までは、ページネーションなしリクエストをいつでも再度有効にできます。

拡張機能を更新する

以前のバージョンのAuth0 Extensionsやカスタム拡張機能は、ページネーション対応のクエリのみを実行するように、最新バージョンへ更新する必要がある場合があります。
  1. テナントログで、ID が拡張機能の URL と一致するクライアントに関する非推奨通知を確認します。通知がある場合は、その拡張機能を更新する必要があります。
  2. Auth0 Dashboard > Extensionsに移動し、Installed Extensionsを選択して、表示されていれば拡張機能の Update リンクをクリックします。

Deploy CLI ツールを更新する

auth0-deploy-cli ツールを使用している場合は、バージョン 5.3.0 以降に更新する必要があります。詳細については、Deploy CLI ツール を参照してください。