> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# api_rate_limit_alert

> API 呼び出し元がレート制限に近づいたとき、または到達したときに発生するプレビュー版の PlayFab イベント。API、呼び出し元エンティティ、制限の超過に関するプロパティを含みます。

> \[!NOTE]
> このイベントはプレビュー段階です。ペイロード、動作、および提供状況は変更される可能性があります。

このイベントは、API 呼び出し元がレート制限に近づいたとき、または到達したときにトリガーされる可能性があります。現在、警告は制限の 80% で発生しますが、このしきい値は、イベントの他の詳細と同様に変更される可能性があります。アラートは、追跡期間内に使用量が警告しきい値 (`Warning`) または制限そのもの (`HardLimit`) を初めて超えたときに発生し、それ以降の呼び出しごとには発生しません。呼び出しが調整 (スロットリング) されているかどうかを判断するには、HTTP 429 応答を使用してください。このイベントは Game Manager の **データ エクスプローラー** でクエリできます。レート制限の詳細については、「[PlayFab での調整](/ja-jp/services/playfab/live-service-management/service-gateway/throttling/what-is-throttling)」を参照してください。

## プロパティ

| 名前 | 型 | 説明 |
| :- | :- | :- |
| API | String | 呼び出された PlayFab API。たとえば、`client/gettime` です。 |
| CallerEntityType | String | 呼び出しを行ったエンティティの種類。たとえば、`title_player_account` や `title` です。 |
| CallerEntityId | String | 呼び出しを行ったエンティティの ID。省略またはマスクされる場合があります。 |
| Crossings | object\[] | 呼び出しが近づいた、または到達したレート制限。各エントリでは、制限に近づいている場合は `CrossingType` が `Warning`、到達した場合は `HardLimit` となり、`LimitKind`、`TrackingPeriod`、`Limit` が制限を表します。ターゲット エンティティに対する制限のエントリには `TargetEntityType` と `TargetEntityId` も含まれ、その ID は省略またはマスクされる場合があります。 |

## 共通プロパティ

すべての V2 PlayStream イベントは JSON オブジェクトとして書式設定され、ほとんどのイベントは次の共通プロパティを共有します。

| 名前 | 型 | 説明 |
| :- | :- | :- |
| SchemaVersion | String | セマンティック バージョニング スキームに従った PlayStream イベント形式のバージョン。 |
| FullName | [Object](/ja-jp/services/playfab/api-references/events/data-types/fullnameobject) | イベントの種類を完全に指定するための、イベント名とイベント名前空間の組み合わせ。 |
| Id | String | このイベントに対して PlayFab が割り当てた一意の識別子。 |
| Timestamp | DateTime | このイベントに関連付けられた時刻 (UTC)。 |
| Entity | [Object](/ja-jp/services/playfab/api-references/events/data-types/entityobject) | このイベントが適用されるエンティティに関する詳細 (エンティティ ID とエンティティの種類を含む)。 |
| Originator | [Object](/ja-jp/services/playfab/api-references/events/data-types/originatorobject) | このイベントを開始したソースとソースの種類を表すオブジェクト。 |
| PayloadContentType | String | イベント ペイロードの内容を指定します。既定値は "JSON" です。 |
| Origin Info | Object | PlayFab の外部で発生したイベントに関する情報を含む省略可能なフィールド。 |


## Related topics

- [title_client_rate_limited_alert](/ja-jp/services/playfab/api-references/events/Title/title-client-rate-limited-alert.md)
- [title_high_error_rate_alert](/ja-jp/services/playfab/api-references/events/Title/title-high-error-rate-alert.md)
- [PlayFab の PlayStream イベント モデル リファレンス](/ja-jp/services/playfab/api-references/events/index.md)
- [AlertLevel](/ja-jp/services/playfab/api-references/events/data-types/alertlevel.md)
- [AlertStates](/ja-jp/services/playfab/api-references/events/data-types/alertstates.md)