複数のAWSアカウントを管理する - Netskopeナレッジポータル

このエンドポイントを使用すると、複数のAWSアカウントの作成、更新、削除、およびダウンロードを行うことができます。

Request

POST https://<tenant-URL>/api/v1/public_cloud/account?token=<token>&<parameters>

有効なペイロードパラメータは以下のとおりです。

鍵	タイプ	Value	デスクリプション
`op`	string	`create \| update \| delete \| download`	必須。実行する操作を指定します。
`app`	string	`"aws"`	必須。`aws`の場合、以下の必須項目はすべて入力する必要があります。
`accounts`	JSONオブジェクトの配列	作成用: "accounts": [ { "account_id": "<account_id>", "account_name": "<account_name>", "admin_email": "<admin_email>"}, { "account_id": "<account_id>"account_name": "<account_name>", "admin_email": "<admin_email>" } ] 最新情報： "accounts": [ { "instance_name": "abcish", "admin_email": "admin@netskope.com", "use_for": [ "securityscan", "malware", "introspection" ], "securityscan_interval": "120" } ] 削除対象: "accounts": [ { "instance_name": "abcish" } ] CFTのダウンロードはこちら： { "app":"aws" "type": "cft", "use_for": [ "introspection" ] } ] CFT移行のダウンロードはこちら： { "app":"aws", "type": "cft", "mode": "migrate", "instance_name": "abcish", "admin_email": "admin@netskope.com", "use_for": [ "securityscan", "introspection" ], "securityscan_interval": "60" }	アカウントIDと管理者メールアドレスを含むアカウント一覧。作成機能を使用すると、複数のアカウントを一度に追加できます。一度に更新または削除できるアカウントは1つだけです。
`instance_name`	string	`<instance_name>` 例： `"MYAWS_GOSKOPE"`	必須。Netskope UIに表示されるAWSインスタンス名。
`mode`	string	`migrate`	移行用CFTをダウンロードする場合のみ有効です。
`admin_email`	string	`<emailaddress@company.com>` 例： `admin@neskope.com`	移行 CFT を更新およびダウンロードするための管理者の電子メール。
`type`	string	`cft`	ダウンロードオプションの種類。現在サポートされているオプションは`cft`のみです。
`use_for`	array	`"introspection" \|` `"malware"` \| `"securityscan"` 例： `["malware","introspection"]`	必須。空の配列であってはなりません。配列内の項目はAWSでサポートされている必要があります。`"malware"`または`"introspection"`が含まれている場合は、も指定する必要があります。注記 `introspection` 、 `malware` 、および`securityscan`を使用するには、まずNetskopeサポートに連絡してこの機能を有効にしてください。
`securityscan_interval`	integer	数分で。例： `1440`	の場合`"securityscan"`は、使用可能な区間によって許可される値でなければなりません。省略した場合、デフォルト値はアプリに基づいて内部的に定義されたデフォルト値になります。

例：リクエストの作成

curl --location --request POST 'https://<tenant-URL>/api/v1/public_cloud/account?token=<token>&op=create' --header 'Content-Type: application/json' --data-raw '{
    "app":"aws",
    "accounts": [
        {
            "account_id": "077000210270",
            "account_name": "Test-1"
            "admin_email": "admin@netskope.com"
        },
        {
            "account_id": "077000210271",
            "account_name": "Test-2"
            "admin_email": "admin@netskope.com"
        }
    ],
    "use_for": [
        "securityscan",
        "malware",
        "introspection"
    ],
    "securityscan_interval": "60"
}'

更新リクエストの例

curl --location --request POST 'https://<tenant-URL>/api/v1/public_cloud/account?token=<token>&op=update' --header 'Content-Type: application/json' --data-raw '{
    "app":"aws",
    "instance_name": "abcish",
    "admin_email": "admin@netskope.com"
    "use_for": [
        "securityscan",
        "malware",
        "introspection"
    ],
    "securityscan_interval": "120"
}'

削除リクエストの例

curl --location --request POST 'https://<tenant-URL>/api/v1/public_cloud/account?token=<token>&op=delete' --header 'Content-Type: application/json' --data-raw '{
    "app":"aws",
    "account_id": "077000210270"
}'

CFTリクエストのダウンロード例

curl --location --request POST 'https://<tenant-URL>/api/v1/public_cloud/account?token=<token>&op=download' --header 'Content-Type: application/json' --data-raw '{
    "app":"aws",
    "type": "cft",
    "use_for": [
        "introspection"
    ]
}'

既存インスタンス向け移行CFTのダウンロード例リクエスト

curl --location --request POST 'https://<tenant-URL>/api/v1/public_cloud/account?token=<token>&op=download' --header 'Content-Type: application/json' --data-raw '{
    "app":"aws",
    "type": "cft",
    "mode": "migrate",
    "instance_name": "abcish",
    "admin_email": "admin@netskope.com",
    "use_for": [
        "securityscan",
        "introspection"
    ],
    "securityscan_interval": "60"
}'