ListExposuresByRemediationV2
Retrieves the exposure findings tied to a specific remediation target. Results are sorted by previous severity, highest first, and are paginated.
Request Syntax
POST /ListExposuresByRemediationV2 HTTP/1.1
Content-type: application/json
{
"MaxResults": number,
"NextToken": "string",
"TargetUid": "string"
}URI Request Parameters
The request does not use any URI parameters.
Request Body
The request accepts the following data in JSON format.
- MaxResults
-
The maximum number of results to return. Valid range is 1-100. If you don't specify a value, the operation returns up to 25 results.
Type: Integer
Valid Range: Minimum value of 1. Maximum value of 100.
Required: No
- NextToken
-
The token used to paginate the exposures list returned. On your first call to
ListExposuresByRemediationV2, omit this parameter or set it toNULL. For subsequent calls, use theNextTokenvalue returned in the previous response to retrieve the next page of results.Type: String
Required: No
- TargetUid
-
The unique identifier (ID) of an existing remediation target to list exposure findings for.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 2048.
Required: Yes
Response Syntax
HTTP/1.1 200
Content-type: application/json
{
"Items": [
{
"Impact": "string",
"MetadataUid": "string",
"PreviousSeverity": "string",
"ProjectedSeverity": "string",
"Title": "string"
}
],
"NextToken": "string",
"Resource": {
"AccountId": "string",
"CloudProvider": "string",
"Id": "string",
"Name": "string",
"Region": "string",
"ResourceGuid": "string",
"ResourceOwnerAccountId": "string",
"ResourceOwnerOrgId": "string",
"ResourceRegion": "string",
"Type": "string"
},
"TargetUid": "string",
"TotalCount": number,
"Trait": {
"Title": "string",
"Type": "string"
}
}Response Elements
If the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
- Items
-
An array of exposure findings returned by the operation.
Type: Array of ExposureFinding objects
Array Members: Minimum number of 0 items. Maximum number of 1000 items.
- NextToken
-
The pagination token to use to request the next page of results. Otherwise, this parameter is null.
Type: String
- Resource
-
Provides comprehensive details about a resource.
Type: RemediationResource object
- TargetUid
-
The unique identifier (ID) of the remediation target that the exposure findings are associated with.
Type: String
Pattern:
.*\S.* - TotalCount
-
The total count of exposure findings associated with the remediation target.
Type: Integer
- Trait
-
The specific trait associated with the remediation target.
Type: RemediationTrait object
Errors
For information about the errors that are common to all actions, see Common Error Types.
- AccessDeniedException
-
You don't have permission to perform the action specified in the request.
HTTP Status Code: 403
- InternalServerException
-
The request has failed due to an internal failure of the service.
HTTP Status Code: 500
- ResourceNotFoundException
-
The request was rejected because we can't find the specified resource.
HTTP Status Code: 404
- ThrottlingException
-
The limit on the number of requests per second was exceeded.
HTTP Status Code: 429
- ValidationException
-
The request has failed validation because it's missing required fields or has invalid inputs.
HTTP Status Code: 400
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following:
