Manage Multiple AWS Accounts
This endpoint allows you to create, update, delete, and download multiple AWS accounts.
Request
POST https://<tenant-name>.goskope.com/api/v1/public_cloud/account?token=<token>&<parameters>
Valid payload parameters are:
Key | Type | Value | Description |
---|---|---|---|
| string |
| Required. Specifies operation to perform. |
| string |
| Required. When |
| JSON array of objects | For create: "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>" } ] For update: "accounts": [ { "instance_name": "abcish", "admin_email": "admin@netskope.com", "use_for": [ "securityscan", "malware", "introspection" ], "securityscan_interval": "120" } ] For delete: "accounts": [ { "instance_name": "abcish" } ] For download CFT: { "app":"aws" "type": "cft", "use_for": [ "introspection" ] } ] For download CFT migration: { "app":"aws", "type": "cft", "mode": "migrate", "instance_name": "abcish", "admin_email": "admin@netskope.com", "use_for": [ "securityscan", "introspection" ], "securityscan_interval": "60" } | List of accounts with account_id and admin_email. Create allows adding multiple accounts at one time. Only one account can be updated or deleted at one time. |
| string |
| Required. The AWS instance name in the Netskope UI. |
| string |
| Only for downloading the migration CFT. |
| string |
Example: | Admin email for updating and downloading the migration CFT. |
| string |
| Type of the download option. Currently only supported option is |
| array | Example: | Required. Must not be an empty array. Items in the array must be supported by AWS. If it contains Note To use |
| integer | In minutes. Example: | When used for If omitted, default value is the internally defined default value based on the app. |
Example Create Request
curl --location --request POST 'https://<tenant-name>.goskope.com/api/v1/public_cloud/account?token=f39866cb86ab84a0208e9e1ee&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"
}'
Example Update Request
curl --location --request POST 'https://<tenant-name>.goskope.com/api/v1/public_cloud/account?token=f39866cb86ab84a0208e9e1ee614&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"
}'
Example Delete Request
curl --location --request POST 'https://<tenant-name>.goskope.com/api/v1/public_cloud/account?token=f39866cb86ab84a0208e9e1ee614&op=delete' --header 'Content-Type: application/json' --data-raw '{
"app":"aws",
"account_id": "077000210270"
}'
Example Download CFT Request
curl --location --request POST 'https://<tenant-name>.goskope.com/api/v1/public_cloud/account?token=f39866cb86ab84a0208e9e1ee614&op=download' --header 'Content-Type: application/json' --data-raw '{
"app":"aws",
"type": "cft",
"use_for": [
"introspection"
]
}'
Example Download Migration CFT for Existing Instances Request
curl --location --request POST 'https://<tenant-name>.goskope.com/api/v1/public_cloud/account?token=f39866cb86ab84a0208e9e1ee614&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"
}'