Ce point d'accès vous permet de créer, mettre à jour, supprimer et télécharger plusieurs comptes AWS.
Request
POST https://<tenant-URL>/api/v1/public_cloud/account?token=<token>&<parameters>
Les paramètres valides de la charge utile sont les suivants :
| Clé | Type | Value | Description |
|---|---|---|---|
op | string | create | update | delete | download | Il s'agit d'une obligation. Spécifie l'opération à effectuer. |
app | string | "aws" | Requis. Lorsque aws, tous les champs obligatoires ci-dessous doivent être renseignés. |
accounts | Tableau JSON d'objets | Pour créer :"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>"
}
]Pour la mise à jour : "accounts": [
{
"instance_name": "abcish",
"admin_email": "admin@netskope.com",
"use_for": [
"securityscan",
"malware",
"introspection"
],
"securityscan_interval": "120"
}
]Pour supprimer : "accounts": [
{
"instance_name": "abcish"
}
]Pour télécharger CFT : {
"app":"aws"
"type": "cft",
"use_for": [
"introspection"
]
}
]Pour télécharger la migration CFT : {
"app":"aws",
"type": "cft",
"mode": "migrate",
"instance_name": "abcish",
"admin_email": "admin@netskope.com",
"use_for": [
"securityscan",
"introspection"
], "securityscan_interval": "60"
}
| Liste des comptes avec account_id et admin_email. Create permet d'ajouter plusieurs comptes à la fois. Un seul compte peut être mis à jour ou supprimé à la fois. |
instance_name | string | <instance_name> Exemple : "MYAWS_GOSKOPE" | Il s'agit d'une obligation. Le nom de l'instance AWS dans l'interface utilisateur de Netskope. |
mode | string | migrate | Uniquement pour télécharger le CFT de migration. |
admin_email | string | <emailaddress@company.com>Exemple : | Courriel de l'administrateur pour la mise à jour et le téléchargement du CFT de migration. |
type | string | cft | Type d'option de téléchargement. Actuellement, seule l'option cft est prise en charge. |
use_for | array | "introspection" | "malware" | "securityscan"Exemple : | Il s'agit d'une obligation. Ne doit pas être un tableau vide. Les éléments du tableau doivent être pris en charge par AWS. S'il contient "malware" ou "introspection", il doit également être fourni.Note Pour utiliser |
securityscan_interval | integer | En quelques minutes. Exemple : 1440 | Lorsqu'il est utilisé pour "securityscan", il doit s'agir d'une valeur autorisée par les intervalles disponibles.Si elle est omise, la valeur par défaut est la valeur par défaut définie en interne en fonction de l'application. |
Exemple de demande de création
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"
}'
Exemple de demande de mise à jour
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"
}'
Exemple de demande de suppression
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"
}'
Exemple de téléchargement d'une demande de 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"
]
}'
Exemple de demande de téléchargement de la migration CFT pour les instances existantes
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"
}'