このエンドポイントを使用して、クラウド プロバイダー資産のインベントリを取得します。 これらのパラメータは、クラウドインフラストラクチャインベントリページのフィルタ(基準日、リソースカテゴリ、アカウント名、クラウドプロバイダー、リージョン、リソース名)に対応しています。
リクエストエンドポイント
https://<tenant-URL>/api/v1/public_cloud/inventory
All parameters are optional:
| 鍵 | Value | デスクリプション |
|---|---|---|
format | string: json | flatten | レスポンスのデフォルト形式はJSONです。 |
account_name | URLエンコードされた文字列 | Iaas プラットフォーム プロバイダーのアカウント名。 |
cloud_provider | azure | aws | googlecloud | IaaSプラットフォーム プロバイダー。 |
resource_category | 例: Compute | Database | Network | Role | Storage | Messagingサポートされているリソースカテゴリの完全なリストについては、以下を参照してください。 | Netskopeがアカウントリソースごとに設定するリソースカテゴリ。デフォルトでは、すべてのリソースカテゴリが選択されます。 |
resource_type | 例: EC2instance | Lambda | Image | Volumeサポートされているリソースタイプの完全なリストについては、以下を参照してください。 | 1つ以上のリソースカテゴリタイプ。型はパイプ記号「|」で区切ります。 |
resource_name | URLエンコードされた文字列 | IaaSインスタンス名。 |
tag_name | URLエンコードされた文字列 | Iaas プラットフォーム プロバイダー アカウント リソースに設定されたタグ名。 タグ価格も提供する必要があります。 |
tag_value | URLエンコードされた文字列 | Iaas プラットフォーム プロバイダー アカウント リソースに設定されたタグ値。 タグ名も指定する必要があります。 |
as_of | Integer | その時点での結果のエポックタイム。指定がない場合、デフォルト値はリクエスト時の時刻で、GMT時間となります。 |
limit | integer | REST APIのレスポンスは、1回のレスポンスで最大10000個のアイテムを返すことができます。ページネーションを使用して、より多くの結果を取得できます。 |
skip | 正の整数 | 一部の項目をスキップします( limitと組み合わせてページネーションを行う際に便利です)。 |
region | Azureの場合、考えられる値は次のとおりです。
AWSの場合、可能な値は以下のとおりです。
Google Cloudの場合、考えられる値は次のとおりです。
| 位置参照 |
Response
// JSON format
{
"status": "success",
"msg": "",
"data": [
{
"TrustedIdentities": "lambda.amazonaws.com",
"own": "",
"region_id": "",
"account_name": "demo_1234",
"region_name": "global",
"asset_id": "demo-iam-1-2-3",
"appname": "AWS",
"Description": "Allows Lambda functions to call AWS services on your behalf.",
"deletion_time": 0,
"first_seen_time": 1569430257.14,
"asset_type": "Role",
"instance": "demo_1234",
"metadata": {
"TrustedIdentities": [
"lambda.amazonaws.com"
],
"AssumeRolePolicy": {
"Version": "2019-10-17",
"Statement": [
{
"Action": "sts:AssumeRole",
"SID": null,
"Conditions": [],
"Effect": "Allow",
"Principal": {
"AWS": null,
"Federated": null,
"Service": [
"lambda.amazonaws.com"
]
}
}
]
},
"Description": "Allows Lambda functions to call AWS services on your behalf.",
"InstanceProfile": [],
"Policies": {
"Inline": [],
"Managed": [
{
"id": "arn:aws:iam::aws:policy/IAMFullAccess"
},
{
"id": "arn:aws:iam::aws:policy/AdministratorAccess"
},
{
"id": "arn:aws:iam::aws:policy/service-role/AWSLambdaBasicExecutionRole"
}
]
},
"CreationDate": 1563988648
},
"account_id": "1234567890",
"tags": [],
"alerts": {
"count_medium": 0,
"total_count": 0,
"count_critical": 0,
"count_high": 0,
"count_low": 0
},
"has_policy": true,
"asset_name": "demo-iam-1-2-3",
"asset_category": "Identity",
"entity_type": "IAMRole",
"last_updated_time": 1569430257.14,
"CreationDate": 1563988648
},
...
Response
// Flattened format
{
"status": "success",
"msg": "",
"data": [
{
"TrustedIdentities": "lambda.amazonaws.com",
"own": "",
"region_id": "",
"account_name": "demo_1234",
"region_name": "global",
"asset_id": "demo-iam-1-2-3",
"appname": "AWS",
"Description": "Allows Lambda functions to call AWS services on your behalf.",
"deletion_time": 0,
"first_seen_time": 1569430257.14,
"asset_type": "Role",
"instance": "demo_1234",
"metadata.TrustedIdentities.0": "lambda.amazonaws.com",
"metadata.AssumeRolePolicy.Version": "2012-10-17",
"metadata.AssumeRolePolicy.Statement.0.Action": "sts:AssumeRole",
"metadata.AssumeRolePolicy.Statement.0.SID": null,
"metadata.AssumeRolePolicy.Statement.0.Effect": "Allow",
"metadata.AssumeRolePolicy.Statement.0.Principal.AWS": null,
"metadata.AssumeRolePolicy.Statement.0.Principal.Federated": null,
"metadata.AssumeRolePolicy.Statement.0.Principal.Service.0": "lambda.amazonaws.com",
"metadata.Description": "Allows Lambda functions to call AWS services on your behalf.",
"metadata.Policies.Managed.0.id": "arn:aws:iam::aws:policy/IAMFullAccess",
"metadata.Policies.Managed.1.id": "arn:aws:iam::aws:policy/AdministratorAccess",
"metadata.Policies.Managed.2.id": "arn:aws:iam::aws:policy/service-role/AWSLambdaBasicExecutionRole",
"metadata.CreationDate": 1563988648,
"account_id": "1234567890",
"alerts.count_medium": 0,
"alerts.total_count": 0,
"alerts.count_critical": 0,
"alerts.count_high": 0,
"alerts.count_low": 0,
"has_policy": true,
"asset_name": "demo-iam-1-2-3",
"asset_category": "Identity",
"entity_type": "IAMRole",
"last_updated_time": 1569430257.14,
"CreationDate": 1563988648
},
...
