ZPA APIについての理解

APIデベロッパーおよびリファレンスガイド
- リファレンスガイド
- APIの操作

APIを使用した、切断されたApp Connectorの自動削除の設定

この記事では、ZPA クラウドサービスAPIを使用して、切断されたApp Connectorの自動削除を設定する方法について説明します。すべてのAPIはレート制限されています。詳細は、レート制限についての詳しい説明を参照してください。

切断されたApp Connectorの自動削除を設定する

切断されたApp Connectorの自動削除を設定するには、次の手順を実行します。

POSTリクエストをconnector-controllerの次のエンドポイントに送信します：/mgmtconfig/v1/customer/{customerId}/connectorSchedule。
要求エンドポイントに customerId、顧客の ZPA テナント ID を指定します。

たとえば、/mgmtconfig/v1/customer/145259576743165952/connectorSchedule。

要求のコンテキストに関する情報を提供するために、リクエストヘッダーを含めます。

[コンテンツタイプ]：application/json
[認証]：Bearer<access_token>

次のJSONペイロードを使用し、次の詳細を入力して、自動削除の頻度を設定します。

[customerId]：顧客のZPAテナントIDです。
frequency:切断されたApp Connectorを削除対象とする頻度を設定します。サポートされている値はdaysです。
frequencyInterval: App Connectorが切断されてから削除対象とみなされるまでの日数。サポートされる最小値は5です。

JSONペイロードの表示

{
  "customerId": 0,
  "deleteDisabled": true,
  "enabled": true,
  "frequency": "string",
  "frequencyInterval": integer,
}

閉じる

JSONペイロードの例を表示

{
  "customerId": 145259576743165952,
  "deleteDisabled": true,
  "enabled": true,
  "frequency": "days",
  "frequencyInterval": 5,
}

閉じる

成功した場合、Code 204 No Contentのレスポンスが返されます。これは、App Connector設定で自動削除の頻度が正常に有効化されたことを意味します。詳細については、APIレスポンスコードとエラーメッセージを参照してください。

切断されたApp Connectorの自動削除の頻度を取得する

切断されたApp Connectorの自動削除の頻度を取得するには、次の操作を実行します。

GETリクエストをconnector-controllerの次のエンドポイントに送信します：/mgmtconfig/v1/customer/{customerId}/connectorSchedule。
要求エンドポイントに customerId、顧客の ZPA テナント ID を指定します。

たとえば、/mgmtconfig/v1/customer/145259576743165952/connectorSchedule。

回答例を見る

{
   "id": 9,
   "frequencyInterval": 5,  
   "frequency": "days",
   "enabled": true,
   "customerId": 145259576743165952,
   "deleteDisabled": true,  
}

閉じる

応答が成功すると、コード200が返されます。詳細は、API応答コードとエラーメッセージを参照してください。

切断されたApp Connectorの自動削除の頻度を更新する

切断されたApp Connectorの自動削除の頻度を更新するには、次の操作を実行します。

PUTリクエストをconnector-controllerの次のエンドポイントに送信します：/mgmtconfig/v1/customer/{customerId}/connectorSchedule/{id}。
リクエストエンドポイントに以下を提供します。

customerId：リクエストエンドポイント内の顧客のZPAテナントID。
id:切断されたApp Connectorの自動削除の頻度を取得するでキャプチャされた、顧客のApp Connector自動削除設定の一意の識別子。

たとえば、/mgmtconfig/v1/customer/145259576743165952/connectorSchedule/9。

要求のコンテキストに関する情報を提供するために、リクエストヘッダーを含めます。

[コンテンツタイプ]：application/json
[認証]：Bearer<access_token>

次のJSONペイロードを使用し、次の詳細を入力して、自動削除の頻度を設定します。

[customerId]：顧客のZPAテナントIDです。
frequency:切断されたApp Connectorを削除する頻度を設定します。サポートされている値はdaysです。
frequencyInterval:自動削除の頻度がトリガーされる間隔。サポートされる最小値は5です。