排查错误代码问题
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
本页介绍了您在使用 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 小时。这种方法需要多次查询。如需了解详情,请参阅搜索设备。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-03-25。
[null,null,["最后更新时间 (UTC):2025-03-25。"],[],[],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)."]]