오류 코드 문제 해결하기
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
이 페이지에서는 Directory API를 사용할 때 발생할 수 있는 몇 가지 일반적인 오류 코드를 설명합니다.
503 Service unavailable
nextPageToken
메서드를 사용하여 사용자 또는 기기의 대규모 목록을 가져오는 동안 요청에 60분이 넘게 걸리는 경우 이 오류가 발생할 수 있습니다. 이 오류는 Directory API의 제한으로 인해 발생합니다.
다음은 전체 오류 응답입니다.
{
"error": {
"code": 503,
"message": "Service unavailable. Please try again",
"errors": [
{
"message": "Service unavailable. Please try again",
"domain": "global",
"reason": "backendError"
}
]
}
}
이 오류를 방지하려면 필터를 사용하여 쿼리하여 개별 작업이 완료되는 데 1시간 넘게 걸리지 않도록 기기 또는 사용자 수를 줄일 수 있습니다. 이 접근 방식에는 여러 쿼리가 필요합니다. 자세한 내용은 기기 검색을 참고하세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-03-25(UTC)
[null,null,["최종 업데이트: 2025-03-25(UTC)"],[],[],null,["# Troubleshoot error codes\n\nThis page describes some common error codes that you might encounter while using\nthe Directory API.\n\n`503 Service unavailable`\n-------------------------\n\nWhile using the `nextPageToken` method to retrieve a large list of users or\ndevices, you might encounter this error if the request takes longer than 60\nminutes. This error is due to a limitation of the Directory API.\n\nThe following is the full error response: \n\n```\n{\n \"error\": {\n \"code\": 503,\n \"message\": \"Service unavailable. Please try again\",\n \"errors\": [\n {\n \"message\": \"Service unavailable. Please try again\",\n \"domain\": \"global\",\n \"reason\": \"backendError\"\n }\n ]\n }\n}\n```\n\nTo avoid this error, you can reduce the number of devices or users by querying\nwith filters so that the individual operations don't take over an hour to\ncomplete. This approach requires multiple queries. For more information, see\n[Search for devices](/workspace/admin/directory/v1/guides/search-devices)."]]