AWS Asset Discovery

API commands to discover, refresh, and retrieve AWS assets

List the assets in an AWS account

get/awsaccountassets/{accountId}

SecurityTrend Micro Cloud One API Key

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

401

Unauthorized

403

Forbidden

404

Not Found

500

Internal Server Error

Response samples

application/json

{"accountName": "string",
"accountId": "string",
"assets": [{"outboundProtections": {"domainFiltering": "filtered"
},
"vpcId": "string",
"vpcName": "string",
"internetGatewayId": "string",
"internetGatewayName": "string",
"region": "string",
"hasProtectableEnis": true,
"supportedAzs": [{"name": "string",
"nsvaEc2InstanceId": ["string"
],
"protectionStatus": "string",
"computeResources": [{"type": "ec2",
"summary": {"publicFacing": null
}
}
],
"errors": [{"reason": "string",
"action": "string",
"type": "missing-account-permissions"
}
],
"protectableSubnets": [{"name": "test-subnet",
"id": "subnet-1234567890",
"type": "public"
}
]
}
],
"protectionStatus": "loading",
"outboundAccess": "allowed",
"loadBalancers": [{"type": "alb",
"summary": {"publicFacing": {"protected": {"count": null,
"loadBalancerIds": [ ],
"targetGroups": null
},
"unprotected": {"count": null,
"loadBalancerIds": [ ],
"targetGroups": null
}
}
}
}
],
"errors": [{"reason": "string",
"action": "string",
"type": "missing-account-permissions"
}
],
"lastRefresh": "string"
}
]
}

Sync the AWS account assets with Network Security

post/awsaccountassets/{accountId}

SecurityTrend Micro Cloud One API Key

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

Payload

application/json

{"vpcIds": ["string"
]
}

Response samples

application/json

{"accountName": "string",
"accountId": "string",
"assets": [{"outboundProtections": {"domainFiltering": "filtered"
},
"vpcId": "string",
"vpcName": "string",
"internetGatewayId": "string",
"internetGatewayName": "string",
"region": "string",
"hasProtectableEnis": true,
"supportedAzs": [{"name": "string",
"nsvaEc2InstanceId": ["string"
],
"protectionStatus": "string",
"computeResources": [{"type": "ec2",
"summary": {"publicFacing": null
}
}
],
"errors": [{"reason": "string",
"action": "string",
"type": "missing-account-permissions"
}
],
"protectableSubnets": [{"name": "test-subnet",
"id": "subnet-1234567890",
"type": "public"
}
]
}
],
"protectionStatus": "loading",
"outboundAccess": "allowed",
"loadBalancers": [{"type": "alb",
"summary": {"publicFacing": {"protected": {"count": null,
"loadBalancerIds": [ ],
"targetGroups": null
},
"unprotected": {"count": null,
"loadBalancerIds": [ ],
"targetGroups": null
}
}
}
}
],
"errors": [{"reason": "string",
"action": "string",
"type": "missing-account-permissions"
}
],
"lastRefresh": "string"
}
]
}

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.

SecurityTrend Micro Cloud One API Key

Request

Request Body schema: application/json

accountId	string AWS account ID
region	string AWS region
vpcId	string AWS VPC ID

Responses

200

400

Bad Request

500

Internal Server Error

Request samples

Payload

application/json

{"accountId": "string",
"vpcId": "string",
"region": "string"
}

Response samples

application/json

{"availabilityZones": [{"name": "string",
"publicSubnets": [{"name": "string"
}
]
}
]
}

List the assets across all AWS accounts associated with Network Security

get/awsaccountassets

SecurityTrend Micro Cloud One API Key

Request

header Parameters

api-version

required

string

API version, e.g. v1

Responses

200

401

Unauthorized

403

Forbidden

404

Not Found

500

Internal Server Error

Response samples

application/json

{"awsAccountAssets": [{"accountName": "string",
"accountId": "string",
"assets": [{"outboundProtections": {"domainFiltering": "filtered"
},
"vpcId": "string",
"vpcName": "string",
"internetGatewayId": "string",
"internetGatewayName": "string",
"region": "string",
"hasProtectableEnis": true,
"supportedAzs": [{"name": "string",
"nsvaEc2InstanceId": [null
],
"protectionStatus": "string",
"computeResources": [null
],
"errors": [null
],
"protectableSubnets": [null
]
}
],
"protectionStatus": "loading",
"outboundAccess": "allowed",
"loadBalancers": [{"type": "alb",
"summary": {"publicFacing": null
}
}
],
"errors": [{"reason": "string",
"action": "string",
"type": "missing-account-permissions"
}
],
"lastRefresh": "string"
}
]
}
]
}

➔ Next to Cross Account Permissions Template API