レート制限ルールの検索方法

HEREプラットフォームでは、特定のIDタイプとエンドポイントのレート制限ルールを取得できます。これにより、実際に適用されているレート制限ルールを可視化でき、適用されたレート制限に関する透明性が向上します。

レート制限ルールは、顧客層、レルム、アプリID、認証状態、URLパスなど、さまざまなタイプのアクターに合わせて設定できます。

適用されたルール内で定義されたレート制限に基づいて、定義された制限を超えるリクエストはすべて429ステータスコードで失敗します。

レート制限ルールは、ユーザーのID (アプリ、組織、またはユーザーアカウントなど) と、ルールに指定されたIDスコープに基づいて適用されます。

IDスコープ	説明
`me`	ID固有のルールとグローバルルール (組織内のすべてのIDに適用されるルール) が含まれます。
`default`	呼び出し元IDの組織からの汎用IDのルールと、グローバルなルールが含まれます。
`identityHrn`	顧客が指定した特定のID (アプリ/ユーザー) に一致するすべてのルールを含む

IAMレート制限APIを使用すると、プラットフォーム上のAPIエンドポイントに対するレート制限ルールにアクセスして管理できます。

サービス固有のルールとエンドポイントが存在する場合、レート制限はendpointId、pathPrefix、またはURLごとに取得できます。

詳細については、「Identity & Access Management Rate Limit Rules API v1 API Reference」(Identity & Access Managementレート制限ルールAPI v1 APIリファレンス) を参照してください。

レート制限エンドポイントAPIを使用すると、プラットフォーム上のレート制限ルールの影響を受けるエンドポイントに関する情報を識別できます。詳細については、「レート制限エンドポイント」を参照してください。

エンドポイントの詳細は、すでにルールが作成され、サービスに関連付けられている場合にのみ、そのルールの一部になることに注意してください。

CLIによるレート制限ルールの取得方法

HEREプラットフォームでは、CLIを使用してratelimitルールを取得することもできます。

詳細については、CLIドキュメントを参照してください。