エラーコードのトラブルシューティング

このページでは、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 時間以上かかることがないようにします。この方法では複数のクエリが必要になります。詳しくは、デバイスの検索をご覧ください。