> ## 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 **Data Explorer**에서 쿼리할 수 있습니다. 속도 제한에 대한 자세한 내용은 [PlayFab의 스로틀링](/ko/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](/ko/services/playfab/api-references/events/data-types/fullnameobject) | 이벤트 유형을 완전히 지정하기 위한 이벤트 이름과 이벤트 네임스페이스의 조합입니다. |
| Id | String | 이 이벤트에 대해 PlayFab에서 할당한 고유 식별자입니다. |
| Timestamp | DateTime | 이 이벤트와 연결된 시간(UTC)입니다. |
| Entity | [Object](/ko/services/playfab/api-references/events/data-types/entityobject) | Entity Id 및 Entity type을 포함하여 이 이벤트가 적용되는 엔터티에 대한 세부 정보입니다. |
| Originator | [Object](/ko/services/playfab/api-references/events/data-types/originatorobject) | 이 이벤트를 시작한 원본 및 원본 유형을 설명하는 개체입니다. |
| PayloadContentType | String | 이벤트 페이로드의 콘텐츠를 지정합니다. 기본값은 "JSON"입니다. |
| Origin Info | Object | PlayFab 외부에서 발생한 이벤트에 대한 정보를 포함하는 선택적 필드입니다. |


## Related topics

- [title_client_rate_limited_alert](/ko/services/playfab/api-references/events/Title/title-client-rate-limited-alert.md)
- [title_high_error_rate_alert](/ko/services/playfab/api-references/events/Title/title-high-error-rate-alert.md)
- [PlayFab의 PlayStream 이벤트 모델 참조](/ko/services/playfab/api-references/events/index.md)
- [Limits on Leaderboards](/ko/services/playfab/community/leaderboards/limits-leaderboards.md)
- [AlertLevel](/ko/services/playfab/api-references/events/data-types/alertlevel.md)