AWS Asset Discovery

API commands to discover, refresh, and retrieve AWS assets

List the assets in an AWS account

get/awsaccountassets/{accountId}
Request
path Parameters
accountId
required
string
query Parameters
vpcIds
Array of strings^vpc-
Default: []
header Parameters
api-version
required
string

API version, e.g. v1

Responses
200

OK

401

Unauthorized

403

Forbidden

404

Not Found

500

Internal Server Error

Response samples
application/json
{
  • "accountName": "string",
  • "accountId": "string",
  • "assets": [
    ]
}

Sync the AWS account assets with Network Security

post/awsaccountassets/{accountId}
Request
path Parameters
accountId
required
string
header Parameters
api-version
required
string

API version, e.g. v1

Request Body schema: application/json
vpcIds
Array of strings

AWS VPC Ids

Responses
202

Accepted

401

Unauthorized

403

Forbidden

404

Not Found

500

Internal Server Error

Request samples
application/json
{
  • "vpcIds": [
    ]
}
Response samples
application/json
{
  • "accountName": "string",
  • "accountId": "string",
  • "assets": [
    ]
}

List VPC availability zones

post/awsaccountassets/discoveravailabilityzones

Returns a list of all availability zones for the given VPC along with information about public subnets for each zone. Some deployment options require availability zones with public subnets.

Request
Request Body schema: application/json
accountId
string

AWS account ID

region
string

AWS region

vpcId
string

AWS VPC ID

Responses
200

OK

400

Bad Request

500

Internal Server Error

Request samples
application/json
{
  • "accountId": "string",
  • "vpcId": "string",
  • "region": "string"
}
Response samples
application/json
{
  • "availabilityZones": [
    ]
}

List the assets across all AWS accounts associated with Network Security

get/awsaccountassets
Request
header Parameters
api-version
required
string

API version, e.g. v1

Responses
200

OK

401

Unauthorized

403

Forbidden

404

Not Found

500

Internal Server Error

Response samples
application/json
{
  • "awsAccountAssets": [
    ]
}