--- title: Logs Restriction Queries description: "참고: 이 엔드포인트는 공개 베타 상태입니다. 피드백이 있으면 Datadog 지원팀에 문의하세요." breadcrumbs: 문서 > API > Logs Restriction Queries --- > For the complete documentation index, see [llms.txt](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/llms.txt). # Logs Restriction Queries **참고: 이 엔드포인트는 공개 베타 상태입니다. 피드백이 있으면 [Datadog 지원팀](https://docs.datadoghq.com/help.md)에 문의하세요.** 제한 쿼리는 `logs_read_data` 권한으로 읽기 액세스가 허용되는 로그를 제한하는 로그 쿼리입니다. 제한 쿼리가 있는 역할을 맡은 사용자의 경우, 어떤 로그 쿼리를 실행하든 본인의 Restriction Queries 중 하나와도 일치하는 로그 이벤트만 반환합니다. 이것은 사용자가 각종 로그 관련 기능(예: 로그 탐색기, Live Tail, 리하이드레이션 등) 또는 대시보드 위젯의 로그 이벤트를 쿼리해도 마찬가지입니다. 제한 쿼리는 현재 로그 이벤트 중 다음 구성 요소만 사용하도록 지원하고 있습니다. - 예약된 속성 - 로그 메시지 - 태그 로그 데이터에 대한 읽기 액세스를 제한하려면, 로그 이벤트에 팀 태그를 추가해 어느 팀이 해당 이벤트를 소유하는지 표시하고, 제한 쿼리의 범위를 팀 태그의 관련 값으로 지정합니다. 태그를 로그 이벤트에 적용하는 방법은 여러 가지이고, 로그 이벤트 하나에 키는 동일하고(예: team) 값은 다른 태그 여러 개가 포함될 수 있습니다. 다시 말해, 제한 쿼리가 서로 다른 팀 값으로 범위가 지정된 역할에 같은 로그 이벤트가 표시될 수 있다는 뜻입니다. 제한 쿼리를 추가하는 방법에 관한 자세한 정보는 [로그에 RBAC 설정하는 방법](https://docs.datadoghq.com/logs/guide/logs-rbac.md?tab=api#restrict-access-to-logs)을 참조하세요. ## [제한 쿼리 목록 표시](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/ko/api/latest/logs-restriction-queries/list-restriction-queries.md) (preview) | Datadog site | API endpoint | | ----------------- | ------------------------------------------------------------------------ | | app.datadoghq.com | GET https://api.datadoghq.com/api/v2/logs/config/restriction_queries | | us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/logs/config/restriction_queries | | us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/logs/config/restriction_queries | | app.datadoghq.eu | GET https://api.datadoghq.eu/api/v2/logs/config/restriction_queries | | ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/logs/config/restriction_queries | | ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/logs/config/restriction_queries | | uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/logs/config/restriction_queries | | app.ddog-gov.com | GET https://api.ddog-gov.com/api/v2/logs/config/restriction_queries | | us2.ddog-gov.com | GET https://api.us2.ddog-gov.com/api/v2/logs/config/restriction_queries | ## [제한 쿼리 생성](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/ko/api/latest/logs-restriction-queries/create-a-restriction-query.md) (preview) | Datadog site | API endpoint | | ----------------- | ------------------------------------------------------------------------- | | app.datadoghq.com | POST https://api.datadoghq.com/api/v2/logs/config/restriction_queries | | us3.datadoghq.com | POST https://api.us3.datadoghq.com/api/v2/logs/config/restriction_queries | | us5.datadoghq.com | POST https://api.us5.datadoghq.com/api/v2/logs/config/restriction_queries | | app.datadoghq.eu | POST https://api.datadoghq.eu/api/v2/logs/config/restriction_queries | | ap1.datadoghq.com | POST https://api.ap1.datadoghq.com/api/v2/logs/config/restriction_queries | | ap2.datadoghq.com | POST https://api.ap2.datadoghq.com/api/v2/logs/config/restriction_queries | | uk1.datadoghq.com | POST https://api.uk1.datadoghq.com/api/v2/logs/config/restriction_queries | | app.ddog-gov.com | POST https://api.ddog-gov.com/api/v2/logs/config/restriction_queries | | us2.ddog-gov.com | POST https://api.us2.ddog-gov.com/api/v2/logs/config/restriction_queries | ## [제한 쿼리 불러오기](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/ko/api/latest/logs-restriction-queries/get-a-restriction-query.md) (preview) | Datadog site | API endpoint | | ----------------- | ----------------------------------------------------------------------------------------------- | | app.datadoghq.com | GET https://api.datadoghq.com/api/v2/logs/config/restriction_queries/{restriction_query_id} | | us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/logs/config/restriction_queries/{restriction_query_id} | | us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/logs/config/restriction_queries/{restriction_query_id} | | app.datadoghq.eu | GET https://api.datadoghq.eu/api/v2/logs/config/restriction_queries/{restriction_query_id} | | ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/logs/config/restriction_queries/{restriction_query_id} | | ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/logs/config/restriction_queries/{restriction_query_id} | | uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/logs/config/restriction_queries/{restriction_query_id} | | app.ddog-gov.com | GET https://api.ddog-gov.com/api/v2/logs/config/restriction_queries/{restriction_query_id} | | us2.ddog-gov.com | GET https://api.us2.ddog-gov.com/api/v2/logs/config/restriction_queries/{restriction_query_id} | ## [제한 쿼리 업데이트](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/ko/api/latest/logs-restriction-queries/update-a-restriction-query.md) (preview) | Datadog site | API endpoint | | ----------------- | ------------------------------------------------------------------------------------------------- | | app.datadoghq.com | PATCH https://api.datadoghq.com/api/v2/logs/config/restriction_queries/{restriction_query_id} | | us3.datadoghq.com | PATCH https://api.us3.datadoghq.com/api/v2/logs/config/restriction_queries/{restriction_query_id} | | us5.datadoghq.com | PATCH https://api.us5.datadoghq.com/api/v2/logs/config/restriction_queries/{restriction_query_id} | | app.datadoghq.eu | PATCH https://api.datadoghq.eu/api/v2/logs/config/restriction_queries/{restriction_query_id} | | ap1.datadoghq.com | PATCH https://api.ap1.datadoghq.com/api/v2/logs/config/restriction_queries/{restriction_query_id} | | ap2.datadoghq.com | PATCH https://api.ap2.datadoghq.com/api/v2/logs/config/restriction_queries/{restriction_query_id} | | uk1.datadoghq.com | PATCH https://api.uk1.datadoghq.com/api/v2/logs/config/restriction_queries/{restriction_query_id} | | app.ddog-gov.com | PATCH https://api.ddog-gov.com/api/v2/logs/config/restriction_queries/{restriction_query_id} | | us2.ddog-gov.com | PATCH https://api.us2.ddog-gov.com/api/v2/logs/config/restriction_queries/{restriction_query_id} | ## [제한 쿼리 교체하기](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/ko/api/latest/logs-restriction-queries/replace-a-restriction-query.md) (preview) | Datadog site | API endpoint | | ----------------- | ----------------------------------------------------------------------------------------------- | | app.datadoghq.com | PUT https://api.datadoghq.com/api/v2/logs/config/restriction_queries/{restriction_query_id} | | us3.datadoghq.com | PUT https://api.us3.datadoghq.com/api/v2/logs/config/restriction_queries/{restriction_query_id} | | us5.datadoghq.com | PUT https://api.us5.datadoghq.com/api/v2/logs/config/restriction_queries/{restriction_query_id} | | app.datadoghq.eu | PUT https://api.datadoghq.eu/api/v2/logs/config/restriction_queries/{restriction_query_id} | | ap1.datadoghq.com | PUT https://api.ap1.datadoghq.com/api/v2/logs/config/restriction_queries/{restriction_query_id} | | ap2.datadoghq.com | PUT https://api.ap2.datadoghq.com/api/v2/logs/config/restriction_queries/{restriction_query_id} | | uk1.datadoghq.com | PUT https://api.uk1.datadoghq.com/api/v2/logs/config/restriction_queries/{restriction_query_id} | | app.ddog-gov.com | PUT https://api.ddog-gov.com/api/v2/logs/config/restriction_queries/{restriction_query_id} | | us2.ddog-gov.com | PUT https://api.us2.ddog-gov.com/api/v2/logs/config/restriction_queries/{restriction_query_id} | ## [제한 쿼리 삭제](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/ko/api/latest/logs-restriction-queries/delete-a-restriction-query.md) (preview) | Datadog site | API endpoint | | ----------------- | -------------------------------------------------------------------------------------------------- | | app.datadoghq.com | DELETE https://api.datadoghq.com/api/v2/logs/config/restriction_queries/{restriction_query_id} | | us3.datadoghq.com | DELETE https://api.us3.datadoghq.com/api/v2/logs/config/restriction_queries/{restriction_query_id} | | us5.datadoghq.com | DELETE https://api.us5.datadoghq.com/api/v2/logs/config/restriction_queries/{restriction_query_id} | | app.datadoghq.eu | DELETE https://api.datadoghq.eu/api/v2/logs/config/restriction_queries/{restriction_query_id} | | ap1.datadoghq.com | DELETE https://api.ap1.datadoghq.com/api/v2/logs/config/restriction_queries/{restriction_query_id} | | ap2.datadoghq.com | DELETE https://api.ap2.datadoghq.com/api/v2/logs/config/restriction_queries/{restriction_query_id} | | uk1.datadoghq.com | DELETE https://api.uk1.datadoghq.com/api/v2/logs/config/restriction_queries/{restriction_query_id} | | app.ddog-gov.com | DELETE https://api.ddog-gov.com/api/v2/logs/config/restriction_queries/{restriction_query_id} | | us2.ddog-gov.com | DELETE https://api.us2.ddog-gov.com/api/v2/logs/config/restriction_queries/{restriction_query_id} | ## [제한 쿼리 역할 목록 표시](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/ko/api/latest/logs-restriction-queries/list-roles-for-a-restriction-query.md) (preview) | Datadog site | API endpoint | | ----------------- | ----------------------------------------------------------------------------------------------------- | | app.datadoghq.com | GET https://api.datadoghq.com/api/v2/logs/config/restriction_queries/{restriction_query_id}/roles | | us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/logs/config/restriction_queries/{restriction_query_id}/roles | | us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/logs/config/restriction_queries/{restriction_query_id}/roles | | app.datadoghq.eu | GET https://api.datadoghq.eu/api/v2/logs/config/restriction_queries/{restriction_query_id}/roles | | ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/logs/config/restriction_queries/{restriction_query_id}/roles | | ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/logs/config/restriction_queries/{restriction_query_id}/roles | | uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/logs/config/restriction_queries/{restriction_query_id}/roles | | app.ddog-gov.com | GET https://api.ddog-gov.com/api/v2/logs/config/restriction_queries/{restriction_query_id}/roles | | us2.ddog-gov.com | GET https://api.us2.ddog-gov.com/api/v2/logs/config/restriction_queries/{restriction_query_id}/roles | ## [제한 쿼리 역할 부여](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/ko/api/latest/logs-restriction-queries/grant-role-to-a-restriction-query.md) (preview) | Datadog site | API endpoint | | ----------------- | ------------------------------------------------------------------------------------------------------ | | app.datadoghq.com | POST https://api.datadoghq.com/api/v2/logs/config/restriction_queries/{restriction_query_id}/roles | | us3.datadoghq.com | POST https://api.us3.datadoghq.com/api/v2/logs/config/restriction_queries/{restriction_query_id}/roles | | us5.datadoghq.com | POST https://api.us5.datadoghq.com/api/v2/logs/config/restriction_queries/{restriction_query_id}/roles | | app.datadoghq.eu | POST https://api.datadoghq.eu/api/v2/logs/config/restriction_queries/{restriction_query_id}/roles | | ap1.datadoghq.com | POST https://api.ap1.datadoghq.com/api/v2/logs/config/restriction_queries/{restriction_query_id}/roles | | ap2.datadoghq.com | POST https://api.ap2.datadoghq.com/api/v2/logs/config/restriction_queries/{restriction_query_id}/roles | | uk1.datadoghq.com | POST https://api.uk1.datadoghq.com/api/v2/logs/config/restriction_queries/{restriction_query_id}/roles | | app.ddog-gov.com | POST https://api.ddog-gov.com/api/v2/logs/config/restriction_queries/{restriction_query_id}/roles | | us2.ddog-gov.com | POST https://api.us2.ddog-gov.com/api/v2/logs/config/restriction_queries/{restriction_query_id}/roles | ## [제한 쿼리 역할 권한 취소](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/ko/api/latest/logs-restriction-queries/revoke-role-from-a-restriction-query.md) (preview) | Datadog site | API endpoint | | ----------------- | -------------------------------------------------------------------------------------------------------- | | app.datadoghq.com | DELETE https://api.datadoghq.com/api/v2/logs/config/restriction_queries/{restriction_query_id}/roles | | us3.datadoghq.com | DELETE https://api.us3.datadoghq.com/api/v2/logs/config/restriction_queries/{restriction_query_id}/roles | | us5.datadoghq.com | DELETE https://api.us5.datadoghq.com/api/v2/logs/config/restriction_queries/{restriction_query_id}/roles | | app.datadoghq.eu | DELETE https://api.datadoghq.eu/api/v2/logs/config/restriction_queries/{restriction_query_id}/roles | | ap1.datadoghq.com | DELETE https://api.ap1.datadoghq.com/api/v2/logs/config/restriction_queries/{restriction_query_id}/roles | | ap2.datadoghq.com | DELETE https://api.ap2.datadoghq.com/api/v2/logs/config/restriction_queries/{restriction_query_id}/roles | | uk1.datadoghq.com | DELETE https://api.uk1.datadoghq.com/api/v2/logs/config/restriction_queries/{restriction_query_id}/roles | | app.ddog-gov.com | DELETE https://api.ddog-gov.com/api/v2/logs/config/restriction_queries/{restriction_query_id}/roles | | us2.ddog-gov.com | DELETE https://api.us2.ddog-gov.com/api/v2/logs/config/restriction_queries/{restriction_query_id}/roles | ## [지정된 사용자의 제한 쿼리 전체 불러오기](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/ko/api/latest/logs-restriction-queries/get-all-restriction-queries-for-a-given-user.md) (preview) | Datadog site | API endpoint | | ----------------- | --------------------------------------------------------------------------------------- | | app.datadoghq.com | GET https://api.datadoghq.com/api/v2/logs/config/restriction_queries/user/{user_id} | | us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/logs/config/restriction_queries/user/{user_id} | | us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/logs/config/restriction_queries/user/{user_id} | | app.datadoghq.eu | GET https://api.datadoghq.eu/api/v2/logs/config/restriction_queries/user/{user_id} | | ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/logs/config/restriction_queries/user/{user_id} | | ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/logs/config/restriction_queries/user/{user_id} | | uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/logs/config/restriction_queries/user/{user_id} | | app.ddog-gov.com | GET https://api.ddog-gov.com/api/v2/logs/config/restriction_queries/user/{user_id} | | us2.ddog-gov.com | GET https://api.us2.ddog-gov.com/api/v2/logs/config/restriction_queries/user/{user_id} | ## [지정된 역할의 제한 쿼리 불러오기](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/ko/api/latest/logs-restriction-queries/get-restriction-query-for-a-given-role.md) (preview) | Datadog site | API endpoint | | ----------------- | --------------------------------------------------------------------------------------- | | app.datadoghq.com | GET https://api.datadoghq.com/api/v2/logs/config/restriction_queries/role/{role_id} | | us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/logs/config/restriction_queries/role/{role_id} | | us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/logs/config/restriction_queries/role/{role_id} | | app.datadoghq.eu | GET https://api.datadoghq.eu/api/v2/logs/config/restriction_queries/role/{role_id} | | ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/logs/config/restriction_queries/role/{role_id} | | ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/logs/config/restriction_queries/role/{role_id} | | uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/logs/config/restriction_queries/role/{role_id} | | app.ddog-gov.com | GET https://api.ddog-gov.com/api/v2/logs/config/restriction_queries/role/{role_id} | | us2.ddog-gov.com | GET https://api.us2.ddog-gov.com/api/v2/logs/config/restriction_queries/role/{role_id} |