このコードは、次のいずれかの理由で返されます。

• ユーザーのロールには、アクセス許可も機能スコープもありません。
• 必要なSKUサブスクリプションが不足しています。
• スケジュール済みアップグレード中にZIA管理ポータルがメンテナンス モードになっている場合、POST、PUTまたはDELETEメソッドを使用するAPI操作が実行されます。

Zscalerサポートまたはお客様のZscalerアカウント チームに連絡してサポートを受けてください。

不正な要求

例えば、以下の通りです。

{
 "id": "resource.not.found", 
 "reason": "No resource exists with the given id/name :0", 
 "params": [
   "0" 
 ] 
}

承認解除

例えば、以下の通りです。

{
 id: "access.denied",
 reason: "Access denied"
}

競合

例えば、以下の通りです。

{
   "params":[
      "com.zscaler.zpn.model.PolicySet"
   ],
   "id":"api.concurrent.access.error",
   "reason":"Unable to modify the resource due to concurrent change requests. Try again"
}

ポリシー・セット・コントローラーに対してPOST、PUT、およびDELETEメソッドを使用した並行API呼び出しは、エラー409ー競合を返すことがあります。ポリシー ルールごとに一度に1つのPUTリクエストのみが送信されるようにします。

レート制限またはクォータを超えました。

次の例は、APIコールがレート制限されているときのレスポンス本文です。

{
  "exception": "invalid.toomanyrequests",
  "id": "invalid.toomanyrequests",
  "reason": "Exceeded the number of requests allowed"
}

次の例は、APIコールがレート制限されているときのレスポンス ヘッダーです。

{
  "content-type": "application/json",
  "date": "Wed, 6 Mar 2024 11:38 GMT",
  "retry-after": "13s"
} 

詳細は、「レート制限について」を参照してください。

サービスを利用できません

次の例は、エラー コード503のレスポンス本文です。

{
 "id": "retryable.server.error",
 "reason": "An error occurred. Refer to the Retry-After header, and then try again."
}

レスポンス ヘッダーの例を次に示します：{Retry-After: 10s}

Zscalerは、再試行する前に、指数関数的なバックオフ戦略を推奨します。Retry-Afterヘッダーがレスポンス ヘッダーの一部として使用可能な場合は、Retry-Afterヘッダーに記載されている規定の時間まで待ってから再試行してください。