REST APIリファレンス

前へ次へ

Secure Agentグループの選択の管理

runtimeEnvironmentリソースを使用して、Secure Agentグループで

Informatica Intelligent Cloud Services

とコネクタを有効または無効にすることができます。また、選択の詳細を取得することもできます。

GET要求を使用して、Secure Agentグループの有効化および無効化の選択に関する詳細を取得します。PUT要求を使用して、Secure Agentグループをサービスとコネクタに割り当てます。

GET要求

Secure Agentグループに対して有効になっている選択に関する情報を要求できます。組織のライセンスに基づいて、Secure Agentグループで使用できるすべての選択に関する情報を要求することもできます。応答には、使用可能なサービスとコネクタの名前とIDが含まれます。

有効な選択に関する情報を取得するには、次のURIを使用します。

/api/v2/runtimeEnvironment/<id>/selections

Secure Agentグループで使用できるすべての選択に関する情報を取得するには、次のURIを使用します。

/api/v2/runtimeEnvironment/<id>/selections/details

GET応答

Secure Agentグループの選択を返します。成功した場合、次のフィールドを返します。

フィールド	タイプ	説明
services		サービスの選択情報を含みます。
selections		有効なサービスの情報を含みます。要求に詳細を含める場合は、無効なサービスの選択情報も含みます。
id	String	selectionsオブジェクトに含まれます。サービスID。
name	String	selectionsオブジェクトに含まれます。サービス名。
enabled	Boolean	selectionsオブジェクトに含まれます。 Secure Agentグループでサービスが有効になっているかどうか。
connectors		コネクタの選択情報を含みます。
selections		有効なコネクタの情報を含みます。要求に詳細を含める場合は、無効なコネクタの選択情報も含みます。
id	String	selectionsオブジェクトに含まれます。コネクタID。
name	String	selectionsオブジェクトに含まれます。コネクタ名。
enabled	Boolean	selectionsオブジェクトに含まれます。 Secure Agentグループでコネクタが有効になっているかどうか。
Additional services		Gitなどの追加サービスの選択情報を含みます。
selections		有効になっている追加サービスの情報を含みます。要求に詳細を含める場合は、無効になっている追加サービスの選択情報も含みます。
id	String	selectionsオブジェクトに含まれます。サービスID。
name	String	selectionsオブジェクトに含まれます。サービス名。
enabled	Boolean	selectionsオブジェクトに含まれます。 Secure Agentグループでサービスが有効になっているかどうか。

GET要求の例

有効な選択に関する情報を取得する要求の例を以下に示します。

POST <serverUrl>/api/v2/runtimeEnvironment/00000425000000000004/selections
Accept:application/json
icSessionId: <icSessionId>

有効な選択と無効な選択に関する情報を取得する要求の例を以下に示します。

POST <serverUrl>/api/v2/runtimeEnvironment/00000425000000000004/selections/details
Accept:application/json
icSessionId: <icSessionId>

GET応答の例

要求が有効な選択と無効な選択に対するものである場合、次の例のような応答を受信します。

{
  "services": {
    "selections": [
      {
        "id": "00000047000000000002",
        "name": "Data Integration",
        "enabled": true
      }
    ]
  },
  "connectors": {
    "selections": [
      {
        "id": "01000000000005L",
        "name": "Amazon Redshift v2",
        "enabled": true
      },

     {
        "id": "01000000000005Q",
        "name": "Amazon S3",
        "enabled": false
      }
    ]
  },
  "additionalServices": {
    "selections": [
      {
        "id": "00000048000000000002",
        "name": "Git",
        "enabled": false
      }
    ]
  }
}

PUT要求

Secure Agentグループでサービスとコネクタを有効にするには、次のURIに示すようにエージェントグループIDを含めます。

/api/v2/runtimeEnvironment/<id>/selections

使用可能なすべてのサービスとコネクタのリストを表示し、選択IDを見つけるには、GET要求を使用して、有効な選択と無効な選択に関する情報を取得します。

要求に次のフィールドを含めます。

フィールド	タイプ	必須	説明
id	String	○	選択オブジェクトID。
name	String	-	選択オブジェクト名。
enabled	Boolean	-	選択を有効にするか無効にするか。

PUT要求の例

Secure Agentグループでデータ統合サービス、Amazon Redshift v2コネクタ、およびGitサービスを選択する場合、要求は次の例のようになります。

ここで示されているIDは一例です。GET要求を使用して、Secure Agentグループで使用できる選択IDと名前を見つけます。

PUT <serverUrl>/api/v2/runtimeEnvironment/00000425000000000004/selections
Accept:application/json
icSessionId: <icSessionId>
{
  "services": {
    "selections": [
      {
        "id": "00000047000000000002",
        "name": "Data Integration",
        "enabled": true
      }
    ]
  },
  "connectors": {
    "selections": [
      {
        "id": "01000000000005L",
        "name": "Amazon Redshift v2",
        "enabled": false
      },
      {
        "id": "01000000000005M",
        "name": "Amazon S3 v2",
        "enabled": false
      }
    ]
  },
  "additionalServices": {
    "selections": [
      {
        "id": "00000047000000000013",
        "name": "Self-hosted Git Repo",
        "enabled": true
      }
    ]
  }
}

ランタイム環境

ガイドをダウンロード

ページをウォッチ

フィードバックを送信

コミュニティ

Knowledge Base

Success Portal