# Actions
<a name="API_Operations"></a>

The following actions are supported:
+  [AddAttributesToFindings](API_AddAttributesToFindings.md) 
+  [CreateAssessmentTarget](API_CreateAssessmentTarget.md) 
+  [CreateAssessmentTemplate](API_CreateAssessmentTemplate.md) 
+  [CreateExclusionsPreview](API_CreateExclusionsPreview.md) 
+  [CreateResourceGroup](API_CreateResourceGroup.md) 
+  [DeleteAssessmentRun](API_DeleteAssessmentRun.md) 
+  [DeleteAssessmentTarget](API_DeleteAssessmentTarget.md) 
+  [DeleteAssessmentTemplate](API_DeleteAssessmentTemplate.md) 
+  [DescribeAssessmentRuns](API_DescribeAssessmentRuns.md) 
+  [DescribeAssessmentTargets](API_DescribeAssessmentTargets.md) 
+  [DescribeAssessmentTemplates](API_DescribeAssessmentTemplates.md) 
+  [DescribeCrossAccountAccessRole](API_DescribeCrossAccountAccessRole.md) 
+  [DescribeExclusions](API_DescribeExclusions.md) 
+  [DescribeFindings](API_DescribeFindings.md) 
+  [DescribeResourceGroups](API_DescribeResourceGroups.md) 
+  [DescribeRulesPackages](API_DescribeRulesPackages.md) 
+  [GetAssessmentReport](API_GetAssessmentReport.md) 
+  [GetExclusionsPreview](API_GetExclusionsPreview.md) 
+  [GetTelemetryMetadata](API_GetTelemetryMetadata.md) 
+  [ListAssessmentRunAgents](API_ListAssessmentRunAgents.md) 
+  [ListAssessmentRuns](API_ListAssessmentRuns.md) 
+  [ListAssessmentTargets](API_ListAssessmentTargets.md) 
+  [ListAssessmentTemplates](API_ListAssessmentTemplates.md) 
+  [ListEventSubscriptions](API_ListEventSubscriptions.md) 
+  [ListExclusions](API_ListExclusions.md) 
+  [ListFindings](API_ListFindings.md) 
+  [ListRulesPackages](API_ListRulesPackages.md) 
+  [ListTagsForResource](API_ListTagsForResource.md) 
+  [PreviewAgents](API_PreviewAgents.md) 
+  [RegisterCrossAccountAccessRole](API_RegisterCrossAccountAccessRole.md) 
+  [RemoveAttributesFromFindings](API_RemoveAttributesFromFindings.md) 
+  [SetTagsForResource](API_SetTagsForResource.md) 
+  [StartAssessmentRun](API_StartAssessmentRun.md) 
+  [StopAssessmentRun](API_StopAssessmentRun.md) 
+  [SubscribeToEvent](API_SubscribeToEvent.md) 
+  [UnsubscribeFromEvent](API_UnsubscribeFromEvent.md) 
+  [UpdateAssessmentTarget](API_UpdateAssessmentTarget.md) 

# AddAttributesToFindings
<a name="API_AddAttributesToFindings"></a>

**Important**  
End of support notice: On May 20, 2026, AWS will end support for (Amazon Inspector Classic). After May 20, 2026, you will no longer be able to access the Amazon Inspector Classic console or Amazon Inspector Classic resources. For more information, see [Amazon Inspector Classic end of support](https://docs.aws.amazon.com/inspector/v1/userguide/inspector-migration.html). 

Assigns attributes (key and value pairs) to the findings that are specified by the ARNs of the findings.

## Request Syntax
<a name="API_AddAttributesToFindings_RequestSyntax"></a>

```
{
   "attributes": [ 
      { 
         "key": "string",
         "value": "string"
      }
   ],
   "findingArns": [ "string" ]
}
```

## Request Parameters
<a name="API_AddAttributesToFindings_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [attributes](#API_AddAttributesToFindings_RequestSyntax) **   <a name="Inspector-AddAttributesToFindings-request-attributes"></a>
The array of attributes that you want to assign to specified findings.  
Type: Array of [Attribute](API_Attribute.md) objects  
Array Members: Minimum number of 0 items. Maximum number of 10 items.  
Required: Yes

 ** [findingArns](#API_AddAttributesToFindings_RequestSyntax) **   <a name="Inspector-AddAttributesToFindings-request-findingArns"></a>
The ARNs that specify the findings that you want to assign attributes to.  
Type: Array of strings  
Array Members: Minimum number of 1 item. Maximum number of 10 items.  
Length Constraints: Minimum length of 1. Maximum length of 300.  
Required: Yes

## Response Syntax
<a name="API_AddAttributesToFindings_ResponseSyntax"></a>

```
{
   "failedItems": { 
      "string" : { 
         "failureCode": "string",
         "retryable": boolean
      }
   }
}
```

## Response Elements
<a name="API_AddAttributesToFindings_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [failedItems](#API_AddAttributesToFindings_ResponseSyntax) **   <a name="Inspector-AddAttributesToFindings-response-failedItems"></a>
Attribute details that cannot be described. An error code is provided for each failed item.  
Type: String to [FailedItemDetails](API_FailedItemDetails.md) object map  
Key Length Constraints: Minimum length of 1. Maximum length of 300.

## Errors
<a name="API_AddAttributesToFindings_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InternalException **   
Internal server error.    
 ** canRetry **   
You can immediately retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 500

 ** InvalidInputException **   
The request was rejected because an invalid or out-of-range value was supplied for an input parameter.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** NoSuchEntityException **   
The request was rejected because it referenced an entity that does not exist. The error code describes the entity.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** ServiceTemporarilyUnavailableException **   
The serice is temporary unavailable.    
 ** canRetry **   
You can wait and then retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

## Examples
<a name="API_AddAttributesToFindings_Examples"></a>

### Example
<a name="API_AddAttributesToFindings_Example_1"></a>

This example illustrates one usage of AddAttributesToFindings.

#### Sample Request
<a name="API_AddAttributesToFindings_Example_1_Request"></a>

```
               
                  POST / HTTP/1.1
                  Host: inspector.us-west-2.amazonaws.com
                  Accept-Encoding: identity
                  Content-Length: 189
                  X-Amz-Target: InspectorService.AddAttributesToFindings
                  X-Amz-Date: 20160329T233810Z
                  User-Agent: aws-cli/1.10.12 Python/2.7.9 Windows/7 botocore/1.4.3
                  Content-Type: application/x-amz-json-1.1
                  Authorization: AUTHPARAMS
                  {
                    "attributes": [
                      {
                        "key": "Example",
                        "value": "example"
                      }
                    ],
                    "findingArns": [
                      "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-8l1VIE0D/run/0-Z02cjjug/finding/0-T8yM9mEU"
                    ]
                  }
```

#### Sample Response
<a name="API_AddAttributesToFindings_Example_1_Response"></a>

```
               
                  HTTP/1.1 200 OK
                  x-amzn-RequestId: 4c8b9c50-f607-11e5-9380-d76f0924b6d7
                  Content-Type: application/x-amz-json-1.1
                  Content-Length: 18
                  Date: Tue, 29 Mar 2016 23:38:11 GMT
                  {
                    "failedItems": {}
                  }
```

## See Also
<a name="API_AddAttributesToFindings_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/inspector-2016-02-16/AddAttributesToFindings) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/inspector-2016-02-16/AddAttributesToFindings) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/inspector-2016-02-16/AddAttributesToFindings) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/inspector-2016-02-16/AddAttributesToFindings) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/inspector-2016-02-16/AddAttributesToFindings) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/inspector-2016-02-16/AddAttributesToFindings) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/inspector-2016-02-16/AddAttributesToFindings) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/inspector-2016-02-16/AddAttributesToFindings) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/inspector-2016-02-16/AddAttributesToFindings) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/inspector-2016-02-16/AddAttributesToFindings) 

# CreateAssessmentTarget
<a name="API_CreateAssessmentTarget"></a>

**Important**  
End of support notice: On May 20, 2026, AWS will end support for (Amazon Inspector Classic). After May 20, 2026, you will no longer be able to access the Amazon Inspector Classic console or Amazon Inspector Classic resources. For more information, see [Amazon Inspector Classic end of support](https://docs.aws.amazon.com/inspector/v1/userguide/inspector-migration.html). 

Creates a new assessment target using the ARN of the resource group that is generated by [CreateResourceGroup](API_CreateResourceGroup.md). If resourceGroupArn is not specified, all EC2 instances in the current AWS account and region are included in the assessment target. If the [service-linked role](https://docs.aws.amazon.com/inspector/latest/userguide/inspector_slr.html) isn’t already registered, this action also creates and registers a service-linked role to grant Amazon Inspector Classic access to AWS Services needed to perform security assessments. You can create up to 50 assessment targets per AWS account. You can run up to 500 concurrent agents per AWS account. For more information, see [ Amazon Inspector Classic Assessment Targets](https://docs.aws.amazon.com/inspector/latest/userguide/inspector_applications.html).

## Request Syntax
<a name="API_CreateAssessmentTarget_RequestSyntax"></a>

```
{
   "assessmentTargetName": "string",
   "resourceGroupArn": "string"
}
```

## Request Parameters
<a name="API_CreateAssessmentTarget_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [assessmentTargetName](#API_CreateAssessmentTarget_RequestSyntax) **   <a name="Inspector-CreateAssessmentTarget-request-assessmentTargetName"></a>
The user-defined name that identifies the assessment target that you want to create. The name must be unique within the AWS account.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 140.  
Required: Yes

 ** [resourceGroupArn](#API_CreateAssessmentTarget_RequestSyntax) **   <a name="Inspector-CreateAssessmentTarget-request-resourceGroupArn"></a>
The ARN that specifies the resource group that is used to create the assessment target. If resourceGroupArn is not specified, all EC2 instances in the current AWS account and region are included in the assessment target.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 300.  
Required: No

## Response Syntax
<a name="API_CreateAssessmentTarget_ResponseSyntax"></a>

```
{
   "assessmentTargetArn": "string"
}
```

## Response Elements
<a name="API_CreateAssessmentTarget_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [assessmentTargetArn](#API_CreateAssessmentTarget_ResponseSyntax) **   <a name="Inspector-CreateAssessmentTarget-response-assessmentTargetArn"></a>
The ARN that specifies the assessment target that is created.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 300.

## Errors
<a name="API_CreateAssessmentTarget_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InternalException **   
Internal server error.    
 ** canRetry **   
You can immediately retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 500

 ** InvalidCrossAccountRoleException **   
Amazon Inspector Classic cannot assume the cross-account role that it needs to list your EC2 instances during the assessment run.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** InvalidInputException **   
The request was rejected because an invalid or out-of-range value was supplied for an input parameter.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** LimitExceededException **   
The request was rejected because it attempted to create resources beyond the current AWS account limits. The error code describes the limit exceeded.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** NoSuchEntityException **   
The request was rejected because it referenced an entity that does not exist. The error code describes the entity.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** ServiceTemporarilyUnavailableException **   
The serice is temporary unavailable.    
 ** canRetry **   
You can wait and then retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

## Examples
<a name="API_CreateAssessmentTarget_Examples"></a>

### Example
<a name="API_CreateAssessmentTarget_Example_1"></a>

This example illustrates one usage of CreateAssessmentTarget.

#### Sample Request
<a name="API_CreateAssessmentTarget_Example_1_Request"></a>

```
               
                  POST / HTTP/1.1
                  Host: inspector.us-west-2.amazonaws.com
                  Accept-Encoding: identity
                  Content-Length: 129
                  X-Amz-Target: InspectorService.CreateAssessmentTarget
                  X-Amz-Date: 20160331T174054Z
                  User-Agent: aws-cli/1.10.12 Python/2.7.9 Windows/7 botocore/1.4.3
                  Content-Type: application/x-amz-json-1.1
                  Authorization: AUTHPARAMS
                  {
                    "assessmentTargetName": "ExampleAssessmentTarget",
                    "resourceGroupArn": "arn:aws:inspector:us-west-2:123456789012:resourcegroup/0-AB6DMKnv"
                  }
```

#### Sample Response
<a name="API_CreateAssessmentTarget_Example_1_Response"></a>

```
               
                  HTTP/1.1 200 OK
                  x-amzn-RequestId: b87f981e-f767-11e5-82d7-bb83264505be
                  Content-Type: application/x-amz-json-1.1
                  Content-Length: 84
                  Date: Thu, 31 Mar 2016 17:40:55 GMT
                  {
                    "assessmentTargetArn": "arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX"
                  }
```

## See Also
<a name="API_CreateAssessmentTarget_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/inspector-2016-02-16/CreateAssessmentTarget) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/inspector-2016-02-16/CreateAssessmentTarget) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/inspector-2016-02-16/CreateAssessmentTarget) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/inspector-2016-02-16/CreateAssessmentTarget) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/inspector-2016-02-16/CreateAssessmentTarget) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/inspector-2016-02-16/CreateAssessmentTarget) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/inspector-2016-02-16/CreateAssessmentTarget) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/inspector-2016-02-16/CreateAssessmentTarget) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/inspector-2016-02-16/CreateAssessmentTarget) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/inspector-2016-02-16/CreateAssessmentTarget) 

# CreateAssessmentTemplate
<a name="API_CreateAssessmentTemplate"></a>

**Important**  
End of support notice: On May 20, 2026, AWS will end support for (Amazon Inspector Classic). After May 20, 2026, you will no longer be able to access the Amazon Inspector Classic console or Amazon Inspector Classic resources. For more information, see [Amazon Inspector Classic end of support](https://docs.aws.amazon.com/inspector/v1/userguide/inspector-migration.html). 

Creates an assessment template for the assessment target that is specified by the ARN of the assessment target. If the [service-linked role](https://docs.aws.amazon.com/inspector/latest/userguide/inspector_slr.html) isn’t already registered, this action also creates and registers a service-linked role to grant Amazon Inspector Classic access to AWS Services needed to perform security assessments.

## Request Syntax
<a name="API_CreateAssessmentTemplate_RequestSyntax"></a>

```
{
   "assessmentTargetArn": "string",
   "assessmentTemplateName": "string",
   "durationInSeconds": number,
   "rulesPackageArns": [ "string" ],
   "userAttributesForFindings": [ 
      { 
         "key": "string",
         "value": "string"
      }
   ]
}
```

## Request Parameters
<a name="API_CreateAssessmentTemplate_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [assessmentTargetArn](#API_CreateAssessmentTemplate_RequestSyntax) **   <a name="Inspector-CreateAssessmentTemplate-request-assessmentTargetArn"></a>
The ARN that specifies the assessment target for which you want to create the assessment template.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 300.  
Required: Yes

 ** [assessmentTemplateName](#API_CreateAssessmentTemplate_RequestSyntax) **   <a name="Inspector-CreateAssessmentTemplate-request-assessmentTemplateName"></a>
The user-defined name that identifies the assessment template that you want to create. You can create several assessment templates for an assessment target. The names of the assessment templates that correspond to a particular assessment target must be unique.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 140.  
Required: Yes

 ** [durationInSeconds](#API_CreateAssessmentTemplate_RequestSyntax) **   <a name="Inspector-CreateAssessmentTemplate-request-durationInSeconds"></a>
The duration of the assessment run in seconds.  
Type: Integer  
Valid Range: Minimum value of 180. Maximum value of 86400.  
Required: Yes

 ** [rulesPackageArns](#API_CreateAssessmentTemplate_RequestSyntax) **   <a name="Inspector-CreateAssessmentTemplate-request-rulesPackageArns"></a>
The ARNs that specify the rules packages that you want to attach to the assessment template.  
Type: Array of strings  
Array Members: Minimum number of 0 items. Maximum number of 50 items.  
Length Constraints: Minimum length of 1. Maximum length of 300.  
Required: Yes

 ** [userAttributesForFindings](#API_CreateAssessmentTemplate_RequestSyntax) **   <a name="Inspector-CreateAssessmentTemplate-request-userAttributesForFindings"></a>
The user-defined attributes that are assigned to every finding that is generated by the assessment run that uses this assessment template. An attribute is a key and value pair (an [Attribute](API_Attribute.md) object). Within an assessment template, each key must be unique.  
Type: Array of [Attribute](API_Attribute.md) objects  
Array Members: Minimum number of 0 items. Maximum number of 10 items.  
Required: No

## Response Syntax
<a name="API_CreateAssessmentTemplate_ResponseSyntax"></a>

```
{
   "assessmentTemplateArn": "string"
}
```

## Response Elements
<a name="API_CreateAssessmentTemplate_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [assessmentTemplateArn](#API_CreateAssessmentTemplate_ResponseSyntax) **   <a name="Inspector-CreateAssessmentTemplate-response-assessmentTemplateArn"></a>
The ARN that specifies the assessment template that is created.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 300.

## Errors
<a name="API_CreateAssessmentTemplate_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InternalException **   
Internal server error.    
 ** canRetry **   
You can immediately retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 500

 ** InvalidInputException **   
The request was rejected because an invalid or out-of-range value was supplied for an input parameter.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** LimitExceededException **   
The request was rejected because it attempted to create resources beyond the current AWS account limits. The error code describes the limit exceeded.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** NoSuchEntityException **   
The request was rejected because it referenced an entity that does not exist. The error code describes the entity.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** ServiceTemporarilyUnavailableException **   
The serice is temporary unavailable.    
 ** canRetry **   
You can wait and then retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

## Examples
<a name="API_CreateAssessmentTemplate_Examples"></a>

### Example
<a name="API_CreateAssessmentTemplate_Example_1"></a>

This example illustrates one usage of CreateAssessmentTemplate.

#### Sample Request
<a name="API_CreateAssessmentTemplate_Example_1_Request"></a>

```
               
                  POST / HTTP/1.1
                  Host: inspector.us-west-2.amazonaws.com
                  Accept-Encoding: identity
                  Content-Length: 335
                  X-Amz-Target: InspectorService.CreateAssessmentTemplate
                  X-Amz-Date: 20160331T175559Z
                  User-Agent: aws-cli/1.10.12 Python/2.7.9 Windows/7 botocore/1.4.3
                  Content-Type: application/x-amz-json-1.1
                  Authorization: AUTHPARAMS
                  {
                    "assessmentTargetArn": "arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX",
                    "assessmentTemplateName": "ExampleAssessmentTemplate",
                    "userAttributesForFindings": [
                      {
                        "key": "Example",
                        "value": "example"
                      }
                    ],
                    "durationInSeconds": 180,
                    "rulesPackageArns": [
                      "arn:aws:inspector:us-west-2:758058086616:rulespackage/0-11B9DBXp"
                    ]
                  }
```

#### Sample Response
<a name="API_CreateAssessmentTemplate_Example_1_Response"></a>

```
               
                  HTTP/1.1 200 OK
                  x-amzn-RequestId: d3d3d58e-f769-11e5-9da0-9bde5220d15c
                  Content-Type: application/x-amz-json-1.1
                  Content-Length: 106
                  Date: Thu, 31 Mar 2016 17:56:00 GMT
                  {
                    "assessmentTemplateArn": "arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-it5r2S4T"
                  }
```

## See Also
<a name="API_CreateAssessmentTemplate_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/inspector-2016-02-16/CreateAssessmentTemplate) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/inspector-2016-02-16/CreateAssessmentTemplate) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/inspector-2016-02-16/CreateAssessmentTemplate) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/inspector-2016-02-16/CreateAssessmentTemplate) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/inspector-2016-02-16/CreateAssessmentTemplate) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/inspector-2016-02-16/CreateAssessmentTemplate) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/inspector-2016-02-16/CreateAssessmentTemplate) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/inspector-2016-02-16/CreateAssessmentTemplate) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/inspector-2016-02-16/CreateAssessmentTemplate) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/inspector-2016-02-16/CreateAssessmentTemplate) 

# CreateExclusionsPreview
<a name="API_CreateExclusionsPreview"></a>

**Important**  
End of support notice: On May 20, 2026, AWS will end support for (Amazon Inspector Classic). After May 20, 2026, you will no longer be able to access the Amazon Inspector Classic console or Amazon Inspector Classic resources. For more information, see [Amazon Inspector Classic end of support](https://docs.aws.amazon.com/inspector/v1/userguide/inspector-migration.html). 

Starts the generation of an exclusions preview for the specified assessment template. The exclusions preview lists the potential exclusions (ExclusionPreview) that Inspector Classic can detect before it runs the assessment. 

## Request Syntax
<a name="API_CreateExclusionsPreview_RequestSyntax"></a>

```
{
   "assessmentTemplateArn": "string"
}
```

## Request Parameters
<a name="API_CreateExclusionsPreview_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [assessmentTemplateArn](#API_CreateExclusionsPreview_RequestSyntax) **   <a name="Inspector-CreateExclusionsPreview-request-assessmentTemplateArn"></a>
The ARN that specifies the assessment template for which you want to create an exclusions preview.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 300.  
Required: Yes

## Response Syntax
<a name="API_CreateExclusionsPreview_ResponseSyntax"></a>

```
{
   "previewToken": "string"
}
```

## Response Elements
<a name="API_CreateExclusionsPreview_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [previewToken](#API_CreateExclusionsPreview_ResponseSyntax) **   <a name="Inspector-CreateExclusionsPreview-response-previewToken"></a>
Specifies the unique identifier of the requested exclusions preview. You can use the unique identifier to retrieve the exclusions preview when running the GetExclusionsPreview API.  
Type: String  
Pattern: `[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}` 

## Errors
<a name="API_CreateExclusionsPreview_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InternalException **   
Internal server error.    
 ** canRetry **   
You can immediately retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 500

 ** InvalidInputException **   
The request was rejected because an invalid or out-of-range value was supplied for an input parameter.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** NoSuchEntityException **   
The request was rejected because it referenced an entity that does not exist. The error code describes the entity.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** PreviewGenerationInProgressException **   
The request is rejected. The specified assessment template is currently generating an exclusions preview.  
HTTP Status Code: 400

 ** ServiceTemporarilyUnavailableException **   
The serice is temporary unavailable.    
 ** canRetry **   
You can wait and then retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

## See Also
<a name="API_CreateExclusionsPreview_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/inspector-2016-02-16/CreateExclusionsPreview) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/inspector-2016-02-16/CreateExclusionsPreview) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/inspector-2016-02-16/CreateExclusionsPreview) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/inspector-2016-02-16/CreateExclusionsPreview) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/inspector-2016-02-16/CreateExclusionsPreview) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/inspector-2016-02-16/CreateExclusionsPreview) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/inspector-2016-02-16/CreateExclusionsPreview) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/inspector-2016-02-16/CreateExclusionsPreview) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/inspector-2016-02-16/CreateExclusionsPreview) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/inspector-2016-02-16/CreateExclusionsPreview) 

# CreateResourceGroup
<a name="API_CreateResourceGroup"></a>

**Important**  
End of support notice: On May 20, 2026, AWS will end support for (Amazon Inspector Classic). After May 20, 2026, you will no longer be able to access the Amazon Inspector Classic console or Amazon Inspector Classic resources. For more information, see [Amazon Inspector Classic end of support](https://docs.aws.amazon.com/inspector/v1/userguide/inspector-migration.html). 

Creates a resource group using the specified set of tags (key and value pairs) that are used to select the EC2 instances to be included in an Amazon Inspector Classic assessment target. The created resource group is then used to create an Amazon Inspector Classic assessment target. For more information, see [CreateAssessmentTarget](API_CreateAssessmentTarget.md).

## Request Syntax
<a name="API_CreateResourceGroup_RequestSyntax"></a>

```
{
   "resourceGroupTags": [ 
      { 
         "key": "string",
         "value": "string"
      }
   ]
}
```

## Request Parameters
<a name="API_CreateResourceGroup_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [resourceGroupTags](#API_CreateResourceGroup_RequestSyntax) **   <a name="Inspector-CreateResourceGroup-request-resourceGroupTags"></a>
A collection of keys and an array of possible values, '[\$1"key":"key1","values":["Value1","Value2"]\$1,\$1"key":"Key2","values":["Value3"]\$1]'.  
For example,'[\$1"key":"Name","values":["TestEC2Instance"]\$1]'.  
Type: Array of [ResourceGroupTag](API_ResourceGroupTag.md) objects  
Array Members: Minimum number of 1 item. Maximum number of 10 items.  
Required: Yes

## Response Syntax
<a name="API_CreateResourceGroup_ResponseSyntax"></a>

```
{
   "resourceGroupArn": "string"
}
```

## Response Elements
<a name="API_CreateResourceGroup_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [resourceGroupArn](#API_CreateResourceGroup_ResponseSyntax) **   <a name="Inspector-CreateResourceGroup-response-resourceGroupArn"></a>
The ARN that specifies the resource group that is created.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 300.

## Errors
<a name="API_CreateResourceGroup_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InternalException **   
Internal server error.    
 ** canRetry **   
You can immediately retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 500

 ** InvalidInputException **   
The request was rejected because an invalid or out-of-range value was supplied for an input parameter.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** LimitExceededException **   
The request was rejected because it attempted to create resources beyond the current AWS account limits. The error code describes the limit exceeded.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** ServiceTemporarilyUnavailableException **   
The serice is temporary unavailable.    
 ** canRetry **   
You can wait and then retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

## Examples
<a name="API_CreateResourceGroup_Examples"></a>

### Example
<a name="API_CreateResourceGroup_Example_1"></a>

This example illustrates one usage of CreateResourceGroup.

#### Sample Request
<a name="API_CreateResourceGroup_Example_1_Request"></a>

```
               
                  POST / HTTP/1.1
                  Host: inspector.us-west-2.amazonaws.com
                  Accept-Encoding: identity
                  Content-Length: 67
                  X-Amz-Target: InspectorService.CreateResourceGroup
                  X-Amz-Date: 20160331T171757Z
                  User-Agent: aws-cli/1.10.12 Python/2.7.9 Windows/7 botocore/1.4.3
                  Content-Type: application/x-amz-json-1.1
                  Authorization: AUTHPARAMS
                  {
                    "resourceGroupTags": [
                      {
                        "key": "Name",
                        "value": "example"
                      }
                    ]
                  }
```

#### Sample Response
<a name="API_CreateResourceGroup_Example_1_Response"></a>

```
               
                  HTTP/1.1 200 OK
                  x-amzn-RequestId: 8416dfb4-f764-11e5-872a-fde3682789d5
                  Content-Type: application/x-amz-json-1.1
                  Content-Length: 88
                  Date: Thu, 31 Mar 2016 17:17:58 GMT
                  {
                    "resourceGroupArn": "arn:aws:inspector:us-west-2:123456789012:resourcegroup/0-AB6DMKnv"
                  }
```

## See Also
<a name="API_CreateResourceGroup_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/inspector-2016-02-16/CreateResourceGroup) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/inspector-2016-02-16/CreateResourceGroup) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/inspector-2016-02-16/CreateResourceGroup) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/inspector-2016-02-16/CreateResourceGroup) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/inspector-2016-02-16/CreateResourceGroup) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/inspector-2016-02-16/CreateResourceGroup) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/inspector-2016-02-16/CreateResourceGroup) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/inspector-2016-02-16/CreateResourceGroup) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/inspector-2016-02-16/CreateResourceGroup) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/inspector-2016-02-16/CreateResourceGroup) 

# DeleteAssessmentRun
<a name="API_DeleteAssessmentRun"></a>

**Important**  
End of support notice: On May 20, 2026, AWS will end support for (Amazon Inspector Classic). After May 20, 2026, you will no longer be able to access the Amazon Inspector Classic console or Amazon Inspector Classic resources. For more information, see [Amazon Inspector Classic end of support](https://docs.aws.amazon.com/inspector/v1/userguide/inspector-migration.html). 

Deletes the assessment run that is specified by the ARN of the assessment run.

## Request Syntax
<a name="API_DeleteAssessmentRun_RequestSyntax"></a>

```
{
   "assessmentRunArn": "string"
}
```

## Request Parameters
<a name="API_DeleteAssessmentRun_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [assessmentRunArn](#API_DeleteAssessmentRun_RequestSyntax) **   <a name="Inspector-DeleteAssessmentRun-request-assessmentRunArn"></a>
The ARN that specifies the assessment run that you want to delete.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 300.  
Required: Yes

## Response Elements
<a name="API_DeleteAssessmentRun_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_DeleteAssessmentRun_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AssessmentRunInProgressException **   
You cannot perform a specified action if an assessment run is currently in progress.    
 ** assessmentRunArns **   
The ARNs of the assessment runs that are currently in progress.  
 ** assessmentRunArnsTruncated **   
Boolean value that indicates whether the ARN list of the assessment runs is truncated.  
 ** canRetry **   
You can immediately retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** InternalException **   
Internal server error.    
 ** canRetry **   
You can immediately retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 500

 ** InvalidInputException **   
The request was rejected because an invalid or out-of-range value was supplied for an input parameter.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** NoSuchEntityException **   
The request was rejected because it referenced an entity that does not exist. The error code describes the entity.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** ServiceTemporarilyUnavailableException **   
The serice is temporary unavailable.    
 ** canRetry **   
You can wait and then retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

## Examples
<a name="API_DeleteAssessmentRun_Examples"></a>

### Example
<a name="API_DeleteAssessmentRun_Example_1"></a>

This example illustrates one usage of DeleteAssessmentRun.

#### Sample Request
<a name="API_DeleteAssessmentRun_Example_1_Request"></a>

```
               
                  POST / HTTP/1.1
                  Host: inspector.us-west-2.amazonaws.com
                  Accept-Encoding: identity
                  Content-Length: 117
                  X-Amz-Target: InspectorService.DeleteAssessmentRun
                  X-Amz-Date: 20160331T183810Z
                  User-Agent: aws-cli/1.10.12 Python/2.7.9 Windows/7 botocore/1.4.3
                  Content-Type: application/x-amz-json-1.1
                  Authorization: AUTHPARAMS
                  {
                    "assessmentRunArn": "arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-it5r2S4T/run/0-11LMTAVe"
                  }
```

#### Sample Response
<a name="API_DeleteAssessmentRun_Example_1_Response"></a>

```
               
                  HTTP/1.1 200 OK
                  x-amzn-RequestId: b8494bff-f76f-11e5-9d49-6dd670a2a95d
                  Content-Type: application/x-amz-json-1.1
                  Content-Length: 0
                  Date: Thu, 31 Mar 2016 18:38:11 GMT
```

## See Also
<a name="API_DeleteAssessmentRun_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/inspector-2016-02-16/DeleteAssessmentRun) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/inspector-2016-02-16/DeleteAssessmentRun) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/inspector-2016-02-16/DeleteAssessmentRun) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/inspector-2016-02-16/DeleteAssessmentRun) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/inspector-2016-02-16/DeleteAssessmentRun) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/inspector-2016-02-16/DeleteAssessmentRun) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/inspector-2016-02-16/DeleteAssessmentRun) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/inspector-2016-02-16/DeleteAssessmentRun) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/inspector-2016-02-16/DeleteAssessmentRun) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/inspector-2016-02-16/DeleteAssessmentRun) 

# DeleteAssessmentTarget
<a name="API_DeleteAssessmentTarget"></a>

**Important**  
End of support notice: On May 20, 2026, AWS will end support for (Amazon Inspector Classic). After May 20, 2026, you will no longer be able to access the Amazon Inspector Classic console or Amazon Inspector Classic resources. For more information, see [Amazon Inspector Classic end of support](https://docs.aws.amazon.com/inspector/v1/userguide/inspector-migration.html). 

Deletes the assessment target that is specified by the ARN of the assessment target.

## Request Syntax
<a name="API_DeleteAssessmentTarget_RequestSyntax"></a>

```
{
   "assessmentTargetArn": "string"
}
```

## Request Parameters
<a name="API_DeleteAssessmentTarget_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [assessmentTargetArn](#API_DeleteAssessmentTarget_RequestSyntax) **   <a name="Inspector-DeleteAssessmentTarget-request-assessmentTargetArn"></a>
The ARN that specifies the assessment target that you want to delete.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 300.  
Required: Yes

## Response Elements
<a name="API_DeleteAssessmentTarget_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_DeleteAssessmentTarget_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AssessmentRunInProgressException **   
You cannot perform a specified action if an assessment run is currently in progress.    
 ** assessmentRunArns **   
The ARNs of the assessment runs that are currently in progress.  
 ** assessmentRunArnsTruncated **   
Boolean value that indicates whether the ARN list of the assessment runs is truncated.  
 ** canRetry **   
You can immediately retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** InternalException **   
Internal server error.    
 ** canRetry **   
You can immediately retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 500

 ** InvalidInputException **   
The request was rejected because an invalid or out-of-range value was supplied for an input parameter.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** NoSuchEntityException **   
The request was rejected because it referenced an entity that does not exist. The error code describes the entity.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** ServiceTemporarilyUnavailableException **   
The serice is temporary unavailable.    
 ** canRetry **   
You can wait and then retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

## Examples
<a name="API_DeleteAssessmentTarget_Examples"></a>

### Example
<a name="API_DeleteAssessmentTarget_Example_1"></a>

This example illustrates one usage of DeleteAssessmentTarget.

#### Sample Request
<a name="API_DeleteAssessmentTarget_Example_1_Request"></a>

```
               
                  POST / HTTP/1.1
                  Host: inspector.us-west-2.amazonaws.com
                  Accept-Encoding: identity
                  Content-Length: 85
                  X-Amz-Target: InspectorService.DeleteAssessmentTarget
                  X-Amz-Date: 20160331T184144Z
                  User-Agent: aws-cli/1.10.12 Python/2.7.9 Windows/7 botocore/1.4.3
                  Content-Type: application/x-amz-json-1.1
                  Authorization: AUTHPARAMS
                  {
                    "assessmentTargetArn": "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq"
                  }
```

#### Sample Response
<a name="API_DeleteAssessmentTarget_Example_1_Response"></a>

```
               
                  HTTP/1.1 200 OK
                  x-amzn-RequestId: 37dee3da-f770-11e5-b61e-e163adb0c30c
                  Content-Type: application/x-amz-json-1.1
                  Content-Length: 0
                  Date: Thu, 31 Mar 2016 18:41:45 GMT
```

## See Also
<a name="API_DeleteAssessmentTarget_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/inspector-2016-02-16/DeleteAssessmentTarget) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/inspector-2016-02-16/DeleteAssessmentTarget) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/inspector-2016-02-16/DeleteAssessmentTarget) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/inspector-2016-02-16/DeleteAssessmentTarget) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/inspector-2016-02-16/DeleteAssessmentTarget) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/inspector-2016-02-16/DeleteAssessmentTarget) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/inspector-2016-02-16/DeleteAssessmentTarget) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/inspector-2016-02-16/DeleteAssessmentTarget) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/inspector-2016-02-16/DeleteAssessmentTarget) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/inspector-2016-02-16/DeleteAssessmentTarget) 

# DeleteAssessmentTemplate
<a name="API_DeleteAssessmentTemplate"></a>

**Important**  
End of support notice: On May 20, 2026, AWS will end support for (Amazon Inspector Classic). After May 20, 2026, you will no longer be able to access the Amazon Inspector Classic console or Amazon Inspector Classic resources. For more information, see [Amazon Inspector Classic end of support](https://docs.aws.amazon.com/inspector/v1/userguide/inspector-migration.html). 

Deletes the assessment template that is specified by the ARN of the assessment template.

## Request Syntax
<a name="API_DeleteAssessmentTemplate_RequestSyntax"></a>

```
{
   "assessmentTemplateArn": "string"
}
```

## Request Parameters
<a name="API_DeleteAssessmentTemplate_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [assessmentTemplateArn](#API_DeleteAssessmentTemplate_RequestSyntax) **   <a name="Inspector-DeleteAssessmentTemplate-request-assessmentTemplateArn"></a>
The ARN that specifies the assessment template that you want to delete.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 300.  
Required: Yes

## Response Elements
<a name="API_DeleteAssessmentTemplate_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_DeleteAssessmentTemplate_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AssessmentRunInProgressException **   
You cannot perform a specified action if an assessment run is currently in progress.    
 ** assessmentRunArns **   
The ARNs of the assessment runs that are currently in progress.  
 ** assessmentRunArnsTruncated **   
Boolean value that indicates whether the ARN list of the assessment runs is truncated.  
 ** canRetry **   
You can immediately retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** InternalException **   
Internal server error.    
 ** canRetry **   
You can immediately retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 500

 ** InvalidInputException **   
The request was rejected because an invalid or out-of-range value was supplied for an input parameter.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** NoSuchEntityException **   
The request was rejected because it referenced an entity that does not exist. The error code describes the entity.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** ServiceTemporarilyUnavailableException **   
The serice is temporary unavailable.    
 ** canRetry **   
You can wait and then retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

## Examples
<a name="API_DeleteAssessmentTemplate_Examples"></a>

### Example
<a name="API_DeleteAssessmentTemplate_Example_1"></a>

This example illustrates one usage of DeleteAssessmentTemplate.

#### Sample Request
<a name="API_DeleteAssessmentTemplate_Example_1_Request"></a>

```
               
                  POST / HTTP/1.1
                  Host: inspector.us-west-2.amazonaws.com
                  Accept-Encoding: identity
                  Content-Length: 107
                  X-Amz-Target: InspectorService.DeleteAssessmentTemplate
                  X-Amz-Date: 20160331T184505Z
                  User-Agent: aws-cli/1.10.12 Python/2.7.9 Windows/7 botocore/1.4.3
                  Content-Type: application/x-amz-json-1.1
                  Authorization: AUTHPARAMS
                  {
                    "assessmentTemplateArn": "arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-it5r2S4T"
                  }
```

#### Sample Response
<a name="API_DeleteAssessmentTemplate_Example_1_Response"></a>

```
               
                  HTTP/1.1 200 OK
                  x-amzn-RequestId: afcc2e7e-f770-11e5-8f9c-054cd1296cf6
                  Content-Type: application/x-amz-json-1.1
                  Content-Length: 0
                  Date: Thu, 31 Mar 2016 18:45:06 GMT
```

## See Also
<a name="API_DeleteAssessmentTemplate_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/inspector-2016-02-16/DeleteAssessmentTemplate) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/inspector-2016-02-16/DeleteAssessmentTemplate) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/inspector-2016-02-16/DeleteAssessmentTemplate) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/inspector-2016-02-16/DeleteAssessmentTemplate) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/inspector-2016-02-16/DeleteAssessmentTemplate) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/inspector-2016-02-16/DeleteAssessmentTemplate) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/inspector-2016-02-16/DeleteAssessmentTemplate) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/inspector-2016-02-16/DeleteAssessmentTemplate) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/inspector-2016-02-16/DeleteAssessmentTemplate) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/inspector-2016-02-16/DeleteAssessmentTemplate) 

# DescribeAssessmentRuns
<a name="API_DescribeAssessmentRuns"></a>

**Important**  
End of support notice: On May 20, 2026, AWS will end support for (Amazon Inspector Classic). After May 20, 2026, you will no longer be able to access the Amazon Inspector Classic console or Amazon Inspector Classic resources. For more information, see [Amazon Inspector Classic end of support](https://docs.aws.amazon.com/inspector/v1/userguide/inspector-migration.html). 

Describes the assessment runs that are specified by the ARNs of the assessment runs.

## Request Syntax
<a name="API_DescribeAssessmentRuns_RequestSyntax"></a>

```
{
   "assessmentRunArns": [ "string" ]
}
```

## Request Parameters
<a name="API_DescribeAssessmentRuns_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [assessmentRunArns](#API_DescribeAssessmentRuns_RequestSyntax) **   <a name="Inspector-DescribeAssessmentRuns-request-assessmentRunArns"></a>
The ARN that specifies the assessment run that you want to describe.  
Type: Array of strings  
Array Members: Minimum number of 1 item. Maximum number of 10 items.  
Length Constraints: Minimum length of 1. Maximum length of 300.  
Required: Yes

## Response Syntax
<a name="API_DescribeAssessmentRuns_ResponseSyntax"></a>

```
{
   "assessmentRuns": [ 
      { 
         "arn": "string",
         "assessmentTemplateArn": "string",
         "completedAt": number,
         "createdAt": number,
         "dataCollected": boolean,
         "durationInSeconds": number,
         "findingCounts": { 
            "string" : number 
         },
         "name": "string",
         "notifications": [ 
            { 
               "date": number,
               "error": boolean,
               "event": "string",
               "message": "string",
               "snsPublishStatusCode": "string",
               "snsTopicArn": "string"
            }
         ],
         "rulesPackageArns": [ "string" ],
         "startedAt": number,
         "state": "string",
         "stateChangedAt": number,
         "stateChanges": [ 
            { 
               "state": "string",
               "stateChangedAt": number
            }
         ],
         "userAttributesForFindings": [ 
            { 
               "key": "string",
               "value": "string"
            }
         ]
      }
   ],
   "failedItems": { 
      "string" : { 
         "failureCode": "string",
         "retryable": boolean
      }
   }
}
```

## Response Elements
<a name="API_DescribeAssessmentRuns_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [assessmentRuns](#API_DescribeAssessmentRuns_ResponseSyntax) **   <a name="Inspector-DescribeAssessmentRuns-response-assessmentRuns"></a>
Information about the assessment run.  
Type: Array of [AssessmentRun](API_AssessmentRun.md) objects  
Array Members: Minimum number of 0 items. Maximum number of 10 items.

 ** [failedItems](#API_DescribeAssessmentRuns_ResponseSyntax) **   <a name="Inspector-DescribeAssessmentRuns-response-failedItems"></a>
Assessment run details that cannot be described. An error code is provided for each failed item.  
Type: String to [FailedItemDetails](API_FailedItemDetails.md) object map  
Key Length Constraints: Minimum length of 1. Maximum length of 300.

## Errors
<a name="API_DescribeAssessmentRuns_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InternalException **   
Internal server error.    
 ** canRetry **   
You can immediately retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 500

 ** InvalidInputException **   
The request was rejected because an invalid or out-of-range value was supplied for an input parameter.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

## Examples
<a name="API_DescribeAssessmentRuns_Examples"></a>

### Example
<a name="API_DescribeAssessmentRuns_Example_1"></a>

This example illustrates one usage of DescribeAssessmentRuns.

#### Sample Request
<a name="API_DescribeAssessmentRuns_Example_1_Request"></a>

```
               
               Host: inspector.us-west-2.amazonaws.com
               Accept-Encoding: identity
               Content-Length: 120
               X-Amz-Target: InspectorService.DescribeAssessmentRuns
               X-Amz-Date: 20160323T213431Z
               User-Agent: aws-cli/1.10.12 Python/2.7.9 Windows/7 botocore/1.4.3
               Content-Type: application/x-amz-json-1.1
               Authorization: AUTHPARAMS   
               {
                 "assessmentRunArns": [
                   "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE"
                 ]
               }
```

#### Sample Response
<a name="API_DescribeAssessmentRuns_Example_1_Response"></a>

```
               
               HTTP/1.1 200 OK
               x-amzn-RequestId: 0834f495-f13f-11e5-8a9a-395a36305628
               Content-Type: application/x-amz-json-1.1
               Content-Length: 1156
               Date: Wed, 23 Mar 2016 21:34:32 GMT
               {
                 "assessmentRuns": [
                   {
                     "arn": "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE",
                     "assessmentTemplateArn": "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw",
                     "completedAt": 1458680301.4,
                     "createdAt": 1458680170.035,
                     "dataCollected": true,
                     "durationInSeconds": 3600,
                     "name": "Run 1 for ExampleAssessmentTemplate",
                     "notifications": [],
                     "rulesPackageArns": [
                       "arn:aws:inspector:us-west-2:758058086616:rulespackage/0-X1KXtawP"
                     ],
                     "startedAt": 1458680170.161,
                     "state": "COMPLETED",
                     "stateChangedAt": 1458680301.4,
                     "stateChanges": [
                       {
                         "state": "CREATED",
                         "stateChangedAt": 1458680170.035
                       },
                       {
                         "state": "START_DATA_COLLECTION_PENDING",
                         "stateChangedAt": 1458680170.065
                       },
                       {
                         "state": "START_DATA_COLLECTION_IN_PROGRESS",
                         "stateChangedAt": 1458680170.096
                       },
                       {
                         "state": "COLLECTING_DATA",
                         "stateChangedAt": 1458680170.161
                       },
                       {
                         "state": "STOP_DATA_COLLECTION_PENDING",
                         "stateChangedAt": 1458680239.883
                       },
                       {
                         "state": "DATA_COLLECTED",
                         "stateChangedAt": 1458680299.847
                       },
                       {
                         "state": "EVALUATING_RULES",
                         "stateChangedAt": 1458680300.099
                       },
                       {
                         "state": "COMPLETED",
                         "stateChangedAt": 1458680301.4
                       }
                     ],
                     "userAttributesForFindings": []
                   }
                 ],
                 "failedItems": {}
               }
```

## See Also
<a name="API_DescribeAssessmentRuns_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/inspector-2016-02-16/DescribeAssessmentRuns) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/inspector-2016-02-16/DescribeAssessmentRuns) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/inspector-2016-02-16/DescribeAssessmentRuns) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/inspector-2016-02-16/DescribeAssessmentRuns) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/inspector-2016-02-16/DescribeAssessmentRuns) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/inspector-2016-02-16/DescribeAssessmentRuns) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/inspector-2016-02-16/DescribeAssessmentRuns) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/inspector-2016-02-16/DescribeAssessmentRuns) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/inspector-2016-02-16/DescribeAssessmentRuns) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/inspector-2016-02-16/DescribeAssessmentRuns) 

# DescribeAssessmentTargets
<a name="API_DescribeAssessmentTargets"></a>

**Important**  
End of support notice: On May 20, 2026, AWS will end support for (Amazon Inspector Classic). After May 20, 2026, you will no longer be able to access the Amazon Inspector Classic console or Amazon Inspector Classic resources. For more information, see [Amazon Inspector Classic end of support](https://docs.aws.amazon.com/inspector/v1/userguide/inspector-migration.html). 

Describes the assessment targets that are specified by the ARNs of the assessment targets.

## Request Syntax
<a name="API_DescribeAssessmentTargets_RequestSyntax"></a>

```
{
   "assessmentTargetArns": [ "string" ]
}
```

## Request Parameters
<a name="API_DescribeAssessmentTargets_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [assessmentTargetArns](#API_DescribeAssessmentTargets_RequestSyntax) **   <a name="Inspector-DescribeAssessmentTargets-request-assessmentTargetArns"></a>
The ARNs that specifies the assessment targets that you want to describe.  
Type: Array of strings  
Array Members: Minimum number of 1 item. Maximum number of 10 items.  
Length Constraints: Minimum length of 1. Maximum length of 300.  
Required: Yes

## Response Syntax
<a name="API_DescribeAssessmentTargets_ResponseSyntax"></a>

```
{
   "assessmentTargets": [ 
      { 
         "arn": "string",
         "createdAt": number,
         "name": "string",
         "resourceGroupArn": "string",
         "updatedAt": number
      }
   ],
   "failedItems": { 
      "string" : { 
         "failureCode": "string",
         "retryable": boolean
      }
   }
}
```

## Response Elements
<a name="API_DescribeAssessmentTargets_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [assessmentTargets](#API_DescribeAssessmentTargets_ResponseSyntax) **   <a name="Inspector-DescribeAssessmentTargets-response-assessmentTargets"></a>
Information about the assessment targets.  
Type: Array of [AssessmentTarget](API_AssessmentTarget.md) objects  
Array Members: Minimum number of 0 items. Maximum number of 10 items.

 ** [failedItems](#API_DescribeAssessmentTargets_ResponseSyntax) **   <a name="Inspector-DescribeAssessmentTargets-response-failedItems"></a>
Assessment target details that cannot be described. An error code is provided for each failed item.  
Type: String to [FailedItemDetails](API_FailedItemDetails.md) object map  
Key Length Constraints: Minimum length of 1. Maximum length of 300.

## Errors
<a name="API_DescribeAssessmentTargets_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InternalException **   
Internal server error.    
 ** canRetry **   
You can immediately retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 500

 ** InvalidInputException **   
The request was rejected because an invalid or out-of-range value was supplied for an input parameter.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

## Examples
<a name="API_DescribeAssessmentTargets_Examples"></a>

### Example
<a name="API_DescribeAssessmentTargets_Example_1"></a>

This example illustrates one usage of DescribeAssessmentTargets.

#### Sample Request
<a name="API_DescribeAssessmentTargets_Example_1_Request"></a>

```
               
               POST / HTTP/1.1
               Host: inspector.us-west-2.amazonaws.com
               Accept-Encoding: identity
               Content-Length: 88
               X-Amz-Target: InspectorService.DescribeAssessmentTargets
               X-Amz-Date: 20160323T214315Z
               User-Agent: aws-cli/1.10.12 Python/2.7.9 Windows/7 botocore/1.4.3
               Content-Type: application/x-amz-json-1.1
               Authorization: AUTHPARAMS
               {
                 "assessmentTargetArns": [
                   "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq"
                 ]
               }
```

#### Sample Response
<a name="API_DescribeAssessmentTargets_Example_1_Response"></a>

```
               
               HTTP/1.1 200 OK
               x-amzn-RequestId: 407ddf01-f140-11e5-823c-bd257ba1495d
               Content-Type: application/x-amz-json-1.1
               Content-Length: 287
               Date: Wed, 23 Mar 2016 21:43:16 GMT
               {
                 "assessmentTargets": [
                   {
                     "arn": "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq",
                     "createdAt": 1458074191.459,
                     "name": "ExampleAssessmentTarget",
                     "resourceGroupArn": "arn:aws:inspector:us-west-2:123456789012:resourcegroup/0-PyGXopAI",
                     "updatedAt": 1458074191.459
                   }
                 ],
                 "failedItems": {}
               }
```

## See Also
<a name="API_DescribeAssessmentTargets_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/inspector-2016-02-16/DescribeAssessmentTargets) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/inspector-2016-02-16/DescribeAssessmentTargets) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/inspector-2016-02-16/DescribeAssessmentTargets) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/inspector-2016-02-16/DescribeAssessmentTargets) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/inspector-2016-02-16/DescribeAssessmentTargets) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/inspector-2016-02-16/DescribeAssessmentTargets) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/inspector-2016-02-16/DescribeAssessmentTargets) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/inspector-2016-02-16/DescribeAssessmentTargets) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/inspector-2016-02-16/DescribeAssessmentTargets) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/inspector-2016-02-16/DescribeAssessmentTargets) 

# DescribeAssessmentTemplates
<a name="API_DescribeAssessmentTemplates"></a>

**Important**  
End of support notice: On May 20, 2026, AWS will end support for (Amazon Inspector Classic). After May 20, 2026, you will no longer be able to access the Amazon Inspector Classic console or Amazon Inspector Classic resources. For more information, see [Amazon Inspector Classic end of support](https://docs.aws.amazon.com/inspector/v1/userguide/inspector-migration.html). 

Describes the assessment templates that are specified by the ARNs of the assessment templates.

## Request Syntax
<a name="API_DescribeAssessmentTemplates_RequestSyntax"></a>

```
{
   "assessmentTemplateArns": [ "string" ]
}
```

## Request Parameters
<a name="API_DescribeAssessmentTemplates_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [assessmentTemplateArns](#API_DescribeAssessmentTemplates_RequestSyntax) **   <a name="Inspector-DescribeAssessmentTemplates-request-assessmentTemplateArns"></a>
Type: Array of strings  
Array Members: Minimum number of 1 item. Maximum number of 10 items.  
Length Constraints: Minimum length of 1. Maximum length of 300.  
Required: Yes

## Response Syntax
<a name="API_DescribeAssessmentTemplates_ResponseSyntax"></a>

```
{
   "assessmentTemplates": [ 
      { 
         "arn": "string",
         "assessmentRunCount": number,
         "assessmentTargetArn": "string",
         "createdAt": number,
         "durationInSeconds": number,
         "lastAssessmentRunArn": "string",
         "name": "string",
         "rulesPackageArns": [ "string" ],
         "userAttributesForFindings": [ 
            { 
               "key": "string",
               "value": "string"
            }
         ]
      }
   ],
   "failedItems": { 
      "string" : { 
         "failureCode": "string",
         "retryable": boolean
      }
   }
}
```

## Response Elements
<a name="API_DescribeAssessmentTemplates_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [assessmentTemplates](#API_DescribeAssessmentTemplates_ResponseSyntax) **   <a name="Inspector-DescribeAssessmentTemplates-response-assessmentTemplates"></a>
Information about the assessment templates.  
Type: Array of [AssessmentTemplate](API_AssessmentTemplate.md) objects  
Array Members: Minimum number of 0 items. Maximum number of 10 items.

 ** [failedItems](#API_DescribeAssessmentTemplates_ResponseSyntax) **   <a name="Inspector-DescribeAssessmentTemplates-response-failedItems"></a>
Assessment template details that cannot be described. An error code is provided for each failed item.  
Type: String to [FailedItemDetails](API_FailedItemDetails.md) object map  
Key Length Constraints: Minimum length of 1. Maximum length of 300.

## Errors
<a name="API_DescribeAssessmentTemplates_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InternalException **   
Internal server error.    
 ** canRetry **   
You can immediately retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 500

 ** InvalidInputException **   
The request was rejected because an invalid or out-of-range value was supplied for an input parameter.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

## Examples
<a name="API_DescribeAssessmentTemplates_Examples"></a>

### Example
<a name="API_DescribeAssessmentTemplates_Example_1"></a>

This example illustrates one usage of DescribeAssessmentTemplates.

#### Sample Request
<a name="API_DescribeAssessmentTemplates_Example_1_Request"></a>

```
               
               POST / HTTP/1.1
               Host: inspector.us-west-2.amazonaws.com
               Accept-Encoding: identity
               Content-Length: 110
               X-Amz-Target: InspectorService.DescribeAssessmentTemplates
               X-Amz-Date: 20160323T214822Z
               User-Agent: aws-cli/1.10.12 Python/2.7.9 Windows/7 botocore/1.4.3
               Content-Type: application/x-amz-json-1.1
               Authorization: AUTHPARAMS
               {
                 "assessmentTemplateArns": [
                   "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw"
                 ]
               }
```

#### Sample Response
<a name="API_DescribeAssessmentTemplates_Example_1_Response"></a>

```
               
               HTTP/1.1 200 OK
               x-amzn-RequestId: f73a449b-f140-11e5-b473-ed8493878c40
               Content-Type: application/x-amz-json-1.1
               Content-Length: 422
               Date: Wed, 23 Mar 2016 21:48:23 GMT
               {
                 "assessmentTemplates": [
                   {
                     "arn": "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw",
                     "assessmentTargetArn": "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq",
                     "createdAt": 1458074191.844,
                     "durationInSeconds": 3600,
                     "name": "ExampleAssessmentTemplate",
                     "rulesPackageArns": [
                       "arn:aws:inspector:us-west-2:758058086616:rulespackage/0-X1KXtawP"
                     ],
                     "userAttributesForFindings": []
                   }
                 ],
                 "failedItems": {}
               }
```

## See Also
<a name="API_DescribeAssessmentTemplates_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/inspector-2016-02-16/DescribeAssessmentTemplates) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/inspector-2016-02-16/DescribeAssessmentTemplates) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/inspector-2016-02-16/DescribeAssessmentTemplates) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/inspector-2016-02-16/DescribeAssessmentTemplates) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/inspector-2016-02-16/DescribeAssessmentTemplates) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/inspector-2016-02-16/DescribeAssessmentTemplates) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/inspector-2016-02-16/DescribeAssessmentTemplates) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/inspector-2016-02-16/DescribeAssessmentTemplates) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/inspector-2016-02-16/DescribeAssessmentTemplates) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/inspector-2016-02-16/DescribeAssessmentTemplates) 

# DescribeCrossAccountAccessRole
<a name="API_DescribeCrossAccountAccessRole"></a>

**Important**  
End of support notice: On May 20, 2026, AWS will end support for (Amazon Inspector Classic). After May 20, 2026, you will no longer be able to access the Amazon Inspector Classic console or Amazon Inspector Classic resources. For more information, see [Amazon Inspector Classic end of support](https://docs.aws.amazon.com/inspector/v1/userguide/inspector-migration.html). 

Describes the IAM role that enables Amazon Inspector Classic to access your AWS account.

## Response Syntax
<a name="API_DescribeCrossAccountAccessRole_ResponseSyntax"></a>

```
{
   "registeredAt": number,
   "roleArn": "string",
   "valid": boolean
}
```

## Response Elements
<a name="API_DescribeCrossAccountAccessRole_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [registeredAt](#API_DescribeCrossAccountAccessRole_ResponseSyntax) **   <a name="Inspector-DescribeCrossAccountAccessRole-response-registeredAt"></a>
The date when the cross-account access role was registered.  
Type: Timestamp

 ** [roleArn](#API_DescribeCrossAccountAccessRole_ResponseSyntax) **   <a name="Inspector-DescribeCrossAccountAccessRole-response-roleArn"></a>
The ARN that specifies the IAM role that Amazon Inspector Classic uses to access your AWS account.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 300.

 ** [valid](#API_DescribeCrossAccountAccessRole_ResponseSyntax) **   <a name="Inspector-DescribeCrossAccountAccessRole-response-valid"></a>
A Boolean value that specifies whether the IAM role has the necessary policies attached to enable Amazon Inspector Classic to access your AWS account.  
Type: Boolean

## Errors
<a name="API_DescribeCrossAccountAccessRole_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InternalException **   
Internal server error.    
 ** canRetry **   
You can immediately retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 500

## Examples
<a name="API_DescribeCrossAccountAccessRole_Examples"></a>

### Example
<a name="API_DescribeCrossAccountAccessRole_Example_1"></a>

This example illustrates one usage of DescribeCrossAccountAccessRole.

#### Sample Request
<a name="API_DescribeCrossAccountAccessRole_Example_1_Request"></a>

```
               
               POST / HTTP/1.1
               Host: inspector.us-west-2.amazonaws.com
               Accept-Encoding: identity
               Content-Length: 2
               X-Amz-Target: InspectorService.DescribeCrossAccountAccessRole
               X-Amz-Date: 20160323T215330Z
               User-Agent: aws-cli/1.10.12 Python/2.7.9 Windows/7 botocore/1.4.3
               Content-Type: application/x-amz-json-1.1
               Authorization: AUTHPARAMS
               {}
```

#### Sample Response
<a name="API_DescribeCrossAccountAccessRole_Example_1_Response"></a>

```
               
               HTTP/1.1 200 OK
               x-amzn-RequestId: aef491a7-f141-11e5-bf1e-bbcaffe8bf2e
               Content-Type: application/x-amz-json-1.1
               Content-Length: 99
               Date: Wed, 23 Mar 2016 21:53:32 GMT
               {
                 "registeredAt": 1458069182.826,
                 "roleArn": "arn:aws:iam::123456789012:role/inspector",
                 "valid": true
               }
```

## See Also
<a name="API_DescribeCrossAccountAccessRole_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/inspector-2016-02-16/DescribeCrossAccountAccessRole) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/inspector-2016-02-16/DescribeCrossAccountAccessRole) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/inspector-2016-02-16/DescribeCrossAccountAccessRole) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/inspector-2016-02-16/DescribeCrossAccountAccessRole) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/inspector-2016-02-16/DescribeCrossAccountAccessRole) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/inspector-2016-02-16/DescribeCrossAccountAccessRole) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/inspector-2016-02-16/DescribeCrossAccountAccessRole) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/inspector-2016-02-16/DescribeCrossAccountAccessRole) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/inspector-2016-02-16/DescribeCrossAccountAccessRole) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/inspector-2016-02-16/DescribeCrossAccountAccessRole) 

# DescribeExclusions
<a name="API_DescribeExclusions"></a>

**Important**  
End of support notice: On May 20, 2026, AWS will end support for (Amazon Inspector Classic). After May 20, 2026, you will no longer be able to access the Amazon Inspector Classic console or Amazon Inspector Classic resources. For more information, see [Amazon Inspector Classic end of support](https://docs.aws.amazon.com/inspector/v1/userguide/inspector-migration.html). 

Describes the exclusions that are specified by the exclusions' ARNs.

## Request Syntax
<a name="API_DescribeExclusions_RequestSyntax"></a>

```
{
   "exclusionArns": [ "string" ],
   "locale": "string"
}
```

## Request Parameters
<a name="API_DescribeExclusions_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [exclusionArns](#API_DescribeExclusions_RequestSyntax) **   <a name="Inspector-DescribeExclusions-request-exclusionArns"></a>
The list of ARNs that specify the exclusions that you want to describe.  
Type: Array of strings  
Array Members: Minimum number of 1 item. Maximum number of 100 items.  
Length Constraints: Minimum length of 1. Maximum length of 300.  
Required: Yes

 ** [locale](#API_DescribeExclusions_RequestSyntax) **   <a name="Inspector-DescribeExclusions-request-locale"></a>
The locale into which you want to translate the exclusion's title, description, and recommendation.  
Type: String  
Valid Values: `EN_US`   
Required: No

## Response Syntax
<a name="API_DescribeExclusions_ResponseSyntax"></a>

```
{
   "exclusions": { 
      "string" : { 
         "arn": "string",
         "attributes": [ 
            { 
               "key": "string",
               "value": "string"
            }
         ],
         "description": "string",
         "recommendation": "string",
         "scopes": [ 
            { 
               "key": "string",
               "value": "string"
            }
         ],
         "title": "string"
      }
   },
   "failedItems": { 
      "string" : { 
         "failureCode": "string",
         "retryable": boolean
      }
   }
}
```

## Response Elements
<a name="API_DescribeExclusions_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [exclusions](#API_DescribeExclusions_ResponseSyntax) **   <a name="Inspector-DescribeExclusions-response-exclusions"></a>
Information about the exclusions.  
Type: String to [Exclusion](API_Exclusion.md) object map  
Map Entries: Maximum number of 100 items.  
Key Length Constraints: Minimum length of 1. Maximum length of 300.

 ** [failedItems](#API_DescribeExclusions_ResponseSyntax) **   <a name="Inspector-DescribeExclusions-response-failedItems"></a>
Exclusion details that cannot be described. An error code is provided for each failed item.  
Type: String to [FailedItemDetails](API_FailedItemDetails.md) object map  
Key Length Constraints: Minimum length of 1. Maximum length of 300.

## Errors
<a name="API_DescribeExclusions_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InternalException **   
Internal server error.    
 ** canRetry **   
You can immediately retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 500

 ** InvalidInputException **   
The request was rejected because an invalid or out-of-range value was supplied for an input parameter.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

## See Also
<a name="API_DescribeExclusions_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/inspector-2016-02-16/DescribeExclusions) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/inspector-2016-02-16/DescribeExclusions) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/inspector-2016-02-16/DescribeExclusions) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/inspector-2016-02-16/DescribeExclusions) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/inspector-2016-02-16/DescribeExclusions) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/inspector-2016-02-16/DescribeExclusions) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/inspector-2016-02-16/DescribeExclusions) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/inspector-2016-02-16/DescribeExclusions) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/inspector-2016-02-16/DescribeExclusions) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/inspector-2016-02-16/DescribeExclusions) 

# DescribeFindings
<a name="API_DescribeFindings"></a>

**Important**  
End of support notice: On May 20, 2026, AWS will end support for (Amazon Inspector Classic). After May 20, 2026, you will no longer be able to access the Amazon Inspector Classic console or Amazon Inspector Classic resources. For more information, see [Amazon Inspector Classic end of support](https://docs.aws.amazon.com/inspector/v1/userguide/inspector-migration.html). 

Describes the findings that are specified by the ARNs of the findings.

## Request Syntax
<a name="API_DescribeFindings_RequestSyntax"></a>

```
{
   "findingArns": [ "string" ],
   "locale": "string"
}
```

## Request Parameters
<a name="API_DescribeFindings_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [findingArns](#API_DescribeFindings_RequestSyntax) **   <a name="Inspector-DescribeFindings-request-findingArns"></a>
The ARN that specifies the finding that you want to describe.  
Type: Array of strings  
Array Members: Minimum number of 1 item. Maximum number of 10 items.  
Length Constraints: Minimum length of 1. Maximum length of 300.  
Required: Yes

 ** [locale](#API_DescribeFindings_RequestSyntax) **   <a name="Inspector-DescribeFindings-request-locale"></a>
The locale into which you want to translate a finding description, recommendation, and the short description that identifies the finding.  
Type: String  
Valid Values: `EN_US`   
Required: No

## Response Syntax
<a name="API_DescribeFindings_ResponseSyntax"></a>

```
{
   "failedItems": { 
      "string" : { 
         "failureCode": "string",
         "retryable": boolean
      }
   },
   "findings": [ 
      { 
         "arn": "string",
         "assetAttributes": { 
            "agentId": "string",
            "amiId": "string",
            "autoScalingGroup": "string",
            "hostname": "string",
            "ipv4Addresses": [ "string" ],
            "networkInterfaces": [ 
               { 
                  "ipv6Addresses": [ "string" ],
                  "networkInterfaceId": "string",
                  "privateDnsName": "string",
                  "privateIpAddress": "string",
                  "privateIpAddresses": [ 
                     { 
                        "privateDnsName": "string",
                        "privateIpAddress": "string"
                     }
                  ],
                  "publicDnsName": "string",
                  "publicIp": "string",
                  "securityGroups": [ 
                     { 
                        "groupId": "string",
                        "groupName": "string"
                     }
                  ],
                  "subnetId": "string",
                  "vpcId": "string"
               }
            ],
            "schemaVersion": number,
            "tags": [ 
               { 
                  "key": "string",
                  "value": "string"
               }
            ]
         },
         "assetType": "string",
         "attributes": [ 
            { 
               "key": "string",
               "value": "string"
            }
         ],
         "confidence": number,
         "createdAt": number,
         "description": "string",
         "id": "string",
         "indicatorOfCompromise": boolean,
         "numericSeverity": number,
         "recommendation": "string",
         "schemaVersion": number,
         "service": "string",
         "serviceAttributes": { 
            "assessmentRunArn": "string",
            "rulesPackageArn": "string",
            "schemaVersion": number
         },
         "severity": "string",
         "title": "string",
         "updatedAt": number,
         "userAttributes": [ 
            { 
               "key": "string",
               "value": "string"
            }
         ]
      }
   ]
}
```

## Response Elements
<a name="API_DescribeFindings_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [failedItems](#API_DescribeFindings_ResponseSyntax) **   <a name="Inspector-DescribeFindings-response-failedItems"></a>
Finding details that cannot be described. An error code is provided for each failed item.  
Type: String to [FailedItemDetails](API_FailedItemDetails.md) object map  
Key Length Constraints: Minimum length of 1. Maximum length of 300.

 ** [findings](#API_DescribeFindings_ResponseSyntax) **   <a name="Inspector-DescribeFindings-response-findings"></a>
Information about the finding.  
Type: Array of [Finding](API_Finding.md) objects  
Array Members: Minimum number of 0 items. Maximum number of 100 items.

## Errors
<a name="API_DescribeFindings_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InternalException **   
Internal server error.    
 ** canRetry **   
You can immediately retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 500

 ** InvalidInputException **   
The request was rejected because an invalid or out-of-range value was supplied for an input parameter.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

## Examples
<a name="API_DescribeFindings_Examples"></a>

### Example
<a name="API_DescribeFindings_Example_1"></a>

This example illustrates one usage of DescribeFindings.

#### Sample Request
<a name="API_DescribeFindings_Example_1_Request"></a>

```
               
               POST / HTTP/1.1
               Host: inspector.us-west-2.amazonaws.com
               Accept-Encoding: identity
               Content-Length: 133
               X-Amz-Target: InspectorService.DescribeFindings
               X-Amz-Date: 20160323T215809Z
               User-Agent: aws-cli/1.10.12 Python/2.7.9 Windows/7 botocore/1.4.3
               Content-Type: application/x-amz-json-1.1
               Authorization: AUTHPARAMS
               {
                 "findingArns": [
                   "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE/finding/0-HwPnsDm4"
                 ]
               }
```

#### Sample Response
<a name="API_DescribeFindings_Example_1_Response"></a>

```
               
               HTTP/1.1 200 OK
               x-amzn-RequestId: 555dbc27-f142-11e5-9dc2-6746fe4b2002
               Content-Type: application/x-amz-json-1.1
               Content-Length: 892
               Date: Wed, 23 Mar 2016 21:58:10 GMT
               {
                 "failedItems": {},
                 "findings": [
                   {
                     "arn": "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE/finding/0-HwPnsDm4",
                      "assetAttributes": {
                        "agentId": "i-092e1184e67721f24",
                        "amiId": "ami-0ad99772",
                        "autoScalingGroup": "auto scaling group",
                        "hostname": "ec2-54-202-242-173.us-west-2.compute.amazonaws.com",
                        "ipv4Addresses": [],
                        "networkInterfaces": [
                          {
                            "ipv6Addresses": [],
                            "networkInterfaceId": "eni-09b5ad02",
                            "privateDnsName": "ip-172-31-36-75.us-west-2.compute.internal",
                            "privateIpAddress": "172.31.36.75",
                            "privateIpAddresses": [
                              {
                                "privateDnsName": "ip-172-31-36-75.us-west-2.compute.internal",
                                "privateIpAddress": "172.31.36.75"
                              }
                            ],
                            "publicDnsName": "ec2-54-202-242-173.us-west-2.compute.amazonaws.com",
                            "publicIp": "54.202.242.173",
                            "securityGroups": [
                              {
                                "groupId": "sg-48578931",
                                "groupName": "default"
                              }
                            ],
                            "subnetId": "subnet-8aeebbfc",
                            "vpcId": "vpc-05515b61"
                          }
                        ],
                        "schemaVersion": 1,
                        "tags": [
                          {
                            "key": "scaling",
                            "value": "yes"
                          },
                          {
                            "key": "aws:autoscaling:groupName",
                            "value": "auto scaling group"
                          },
                          {
                            "key": "Name",
                            "value": "beta_amazon_linux_201803_scaling"
                          },
                          {
                            "key": "beta",
                            "value": "true"
                          }
                        ]
                      },
                     "assetType": "ec2-instance",
                     "attributes": [],
                     "confidence": 10,
                     "createdAt": 1458680301.37,
                     "description": "Amazon Inspector Classic did not find any potential security issues during this assessment.",
                     "indicatorOfCompromise": false,
                     "numericSeverity": 0,
                     "recommendation": "No remediation needed.",
                     "schemaVersion": 1,
                     "service": "Inspector",
                     "serviceAttributes": {
                       "assessmentRunArn": "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE",
                       "rulesPackageArn": "arn:aws:inspector:us-west-2:758058086616:rulespackage/0-X1KXtawP",
                       "schemaVersion": 1
                     },
                     "severity": "Informational",
                     "title": "No potential security issues found",
                     "updatedAt": 1458680301.37,
                     "userAttributes": []
                   }
                 ]
               }
```

## See Also
<a name="API_DescribeFindings_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/inspector-2016-02-16/DescribeFindings) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/inspector-2016-02-16/DescribeFindings) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/inspector-2016-02-16/DescribeFindings) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/inspector-2016-02-16/DescribeFindings) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/inspector-2016-02-16/DescribeFindings) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/inspector-2016-02-16/DescribeFindings) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/inspector-2016-02-16/DescribeFindings) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/inspector-2016-02-16/DescribeFindings) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/inspector-2016-02-16/DescribeFindings) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/inspector-2016-02-16/DescribeFindings) 

# DescribeResourceGroups
<a name="API_DescribeResourceGroups"></a>

**Important**  
End of support notice: On May 20, 2026, AWS will end support for (Amazon Inspector Classic). After May 20, 2026, you will no longer be able to access the Amazon Inspector Classic console or Amazon Inspector Classic resources. For more information, see [Amazon Inspector Classic end of support](https://docs.aws.amazon.com/inspector/v1/userguide/inspector-migration.html). 

Describes the resource groups that are specified by the ARNs of the resource groups.

## Request Syntax
<a name="API_DescribeResourceGroups_RequestSyntax"></a>

```
{
   "resourceGroupArns": [ "string" ]
}
```

## Request Parameters
<a name="API_DescribeResourceGroups_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [resourceGroupArns](#API_DescribeResourceGroups_RequestSyntax) **   <a name="Inspector-DescribeResourceGroups-request-resourceGroupArns"></a>
The ARN that specifies the resource group that you want to describe.  
Type: Array of strings  
Array Members: Minimum number of 1 item. Maximum number of 10 items.  
Length Constraints: Minimum length of 1. Maximum length of 300.  
Required: Yes

## Response Syntax
<a name="API_DescribeResourceGroups_ResponseSyntax"></a>

```
{
   "failedItems": { 
      "string" : { 
         "failureCode": "string",
         "retryable": boolean
      }
   },
   "resourceGroups": [ 
      { 
         "arn": "string",
         "createdAt": number,
         "tags": [ 
            { 
               "key": "string",
               "value": "string"
            }
         ]
      }
   ]
}
```

## Response Elements
<a name="API_DescribeResourceGroups_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [failedItems](#API_DescribeResourceGroups_ResponseSyntax) **   <a name="Inspector-DescribeResourceGroups-response-failedItems"></a>
Resource group details that cannot be described. An error code is provided for each failed item.  
Type: String to [FailedItemDetails](API_FailedItemDetails.md) object map  
Key Length Constraints: Minimum length of 1. Maximum length of 300.

 ** [resourceGroups](#API_DescribeResourceGroups_ResponseSyntax) **   <a name="Inspector-DescribeResourceGroups-response-resourceGroups"></a>
Information about a resource group.  
Type: Array of [ResourceGroup](API_ResourceGroup.md) objects  
Array Members: Minimum number of 0 items. Maximum number of 10 items.

## Errors
<a name="API_DescribeResourceGroups_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InternalException **   
Internal server error.    
 ** canRetry **   
You can immediately retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 500

 ** InvalidInputException **   
The request was rejected because an invalid or out-of-range value was supplied for an input parameter.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

## Examples
<a name="API_DescribeResourceGroups_Examples"></a>

### Example
<a name="API_DescribeResourceGroups_Example_1"></a>

This example illustrates one usage of DescribeResourceGroups.

#### Sample Request
<a name="API_DescribeResourceGroups_Example_1_Request"></a>

```
               
               POST / HTTP/1.1
               Host: inspector.us-west-2.amazonaws.com
               Accept-Encoding: identity
               Content-Length: 92
               X-Amz-Target: InspectorService.DescribeResourceGroups
               X-Amz-Date: 20160323T220453Z
               User-Agent: aws-cli/1.10.12 Python/2.7.9 Windows/7 botocore/1.4.3
               Content-Type: application/x-amz-json-1.1
               Authorization: AUTHPARAMS
               {
                 "resourceGroupArns": [
                   "arn:aws:inspector:us-west-2:123456789012:resourcegroup/0-PyGXopAI"
                 ]
               }
```

#### Sample Response
<a name="API_DescribeResourceGroups_Example_1_Response"></a>

```
               
               HTTP/1.1 200 OK
               x-amzn-RequestId: 4636d6a9-f143-11e5-9f03-eb6e194efa59
               Content-Type: application/x-amz-json-1.1
               Content-Length: 191
               Date: Wed, 23 Mar 2016 22:04:54 GMT
               {
                 "failedItems": {},
                 "resourceGroups": [
                   {
                     "arn": "arn:aws:inspector:us-west-2:123456789012:resourcegroup/0-PyGXopAI",
                     "createdAt": 1458074191.098,
                     "tags": [
                       {
                         "key": "Name",
                         "value": "example"
                       }
                     ]
                   }
                 ]
               }
```

## See Also
<a name="API_DescribeResourceGroups_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/inspector-2016-02-16/DescribeResourceGroups) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/inspector-2016-02-16/DescribeResourceGroups) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/inspector-2016-02-16/DescribeResourceGroups) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/inspector-2016-02-16/DescribeResourceGroups) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/inspector-2016-02-16/DescribeResourceGroups) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/inspector-2016-02-16/DescribeResourceGroups) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/inspector-2016-02-16/DescribeResourceGroups) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/inspector-2016-02-16/DescribeResourceGroups) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/inspector-2016-02-16/DescribeResourceGroups) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/inspector-2016-02-16/DescribeResourceGroups) 

# DescribeRulesPackages
<a name="API_DescribeRulesPackages"></a>

**Important**  
End of support notice: On May 20, 2026, AWS will end support for (Amazon Inspector Classic). After May 20, 2026, you will no longer be able to access the Amazon Inspector Classic console or Amazon Inspector Classic resources. For more information, see [Amazon Inspector Classic end of support](https://docs.aws.amazon.com/inspector/v1/userguide/inspector-migration.html). 

Describes the rules packages that are specified by the ARNs of the rules packages.

## Request Syntax
<a name="API_DescribeRulesPackages_RequestSyntax"></a>

```
{
   "locale": "string",
   "rulesPackageArns": [ "string" ]
}
```

## Request Parameters
<a name="API_DescribeRulesPackages_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [locale](#API_DescribeRulesPackages_RequestSyntax) **   <a name="Inspector-DescribeRulesPackages-request-locale"></a>
The locale that you want to translate a rules package description into.  
Type: String  
Valid Values: `EN_US`   
Required: No

 ** [rulesPackageArns](#API_DescribeRulesPackages_RequestSyntax) **   <a name="Inspector-DescribeRulesPackages-request-rulesPackageArns"></a>
The ARN that specifies the rules package that you want to describe.  
Type: Array of strings  
Array Members: Minimum number of 1 item. Maximum number of 10 items.  
Length Constraints: Minimum length of 1. Maximum length of 300.  
Required: Yes

## Response Syntax
<a name="API_DescribeRulesPackages_ResponseSyntax"></a>

```
{
   "failedItems": { 
      "string" : { 
         "failureCode": "string",
         "retryable": boolean
      }
   },
   "rulesPackages": [ 
      { 
         "arn": "string",
         "description": "string",
         "name": "string",
         "provider": "string",
         "version": "string"
      }
   ]
}
```

## Response Elements
<a name="API_DescribeRulesPackages_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [failedItems](#API_DescribeRulesPackages_ResponseSyntax) **   <a name="Inspector-DescribeRulesPackages-response-failedItems"></a>
Rules package details that cannot be described. An error code is provided for each failed item.  
Type: String to [FailedItemDetails](API_FailedItemDetails.md) object map  
Key Length Constraints: Minimum length of 1. Maximum length of 300.

 ** [rulesPackages](#API_DescribeRulesPackages_ResponseSyntax) **   <a name="Inspector-DescribeRulesPackages-response-rulesPackages"></a>
Information about the rules package.  
Type: Array of [RulesPackage](API_RulesPackage.md) objects  
Array Members: Minimum number of 0 items. Maximum number of 10 items.

## Errors
<a name="API_DescribeRulesPackages_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InternalException **   
Internal server error.    
 ** canRetry **   
You can immediately retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 500

 ** InvalidInputException **   
The request was rejected because an invalid or out-of-range value was supplied for an input parameter.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

## Examples
<a name="API_DescribeRulesPackages_Examples"></a>

### Example
<a name="API_DescribeRulesPackages_Example_1"></a>

This example illustrates one usage of DescribeRulesPackages.

#### Sample Request
<a name="API_DescribeRulesPackages_Example_1_Request"></a>

```
               
               POST / HTTP/1.1
               Host: inspector.us-west-2.amazonaws.com
               Accept-Encoding: identity
               Content-Length: 90
               X-Amz-Target: InspectorService.DescribeRulesPackages
               X-Amz-Date: 20160323T220919Z
               User-Agent: aws-cli/1.10.12 Python/2.7.9 Windows/7 botocore/1.4.3
               Content-Type: application/x-amz-json-1.1
               Authorization: AUTHPARAMS
               {
                 "rulesPackageArns": [
                   "arn:aws:inspector:us-west-2:758058086616:rulespackage/0-9hgA516p"
                 ]
               }
```

#### Sample Response
<a name="API_DescribeRulesPackages_Example_1_Response"></a>

```
               
               HTTP/1.1 200 OK
               x-amzn-RequestId: e4a6aee0-f143-11e5-a5ad-73b7f19c946c
               Content-Type: application/x-amz-json-1.1
               Content-Length: 387
               Date: Wed, 23 Mar 2016 22:09:20 GMT
               {
                 "failedItems": {},
                 "rulesPackages": [
                   {
                     "arn": "arn:aws:inspector:us-west-2:758058086616:rulespackage/0-9hgA516p",
                     "description": "The rules in this package help verify whether the EC2 instances in your application are exposed to Common Vulnerabilities and 
                     Exposures (CVEs). Attacks can exploit unpatched vulnerabilities to compromise the confidentiality, integrity, or availability of your service 
                     or data. The CVE system provides a reference for publicly known information security vulnerabilities and exposures. For more information, see 
                     [https://cve.mitre.org/](https://cve.mitre.org/). If a particular CVE appears in one of the produced Findings at the end of a completed 
                     Inspector Classic assessment, you can search [https://cve.mitre.org/](https://cve.mitre.org/) using the CVE's ID (for example, \"CVE-2009-0021\") to 
                     find detailed information about this CVE, its severity, and how to mitigate it. ",
                     "name": "Common Vulnerabilities and Exposures",
                     "provider": "Amazon Web Services, Inc.",
                     "version": "1.1"
                   }
                 ]
               }
```

## See Also
<a name="API_DescribeRulesPackages_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/inspector-2016-02-16/DescribeRulesPackages) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/inspector-2016-02-16/DescribeRulesPackages) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/inspector-2016-02-16/DescribeRulesPackages) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/inspector-2016-02-16/DescribeRulesPackages) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/inspector-2016-02-16/DescribeRulesPackages) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/inspector-2016-02-16/DescribeRulesPackages) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/inspector-2016-02-16/DescribeRulesPackages) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/inspector-2016-02-16/DescribeRulesPackages) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/inspector-2016-02-16/DescribeRulesPackages) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/inspector-2016-02-16/DescribeRulesPackages) 

# GetAssessmentReport
<a name="API_GetAssessmentReport"></a>

**Important**  
End of support notice: On May 20, 2026, AWS will end support for (Amazon Inspector Classic). After May 20, 2026, you will no longer be able to access the Amazon Inspector Classic console or Amazon Inspector Classic resources. For more information, see [Amazon Inspector Classic end of support](https://docs.aws.amazon.com/inspector/v1/userguide/inspector-migration.html). 

Produces an assessment report that includes detailed and comprehensive results of a specified assessment run. 

## Request Syntax
<a name="API_GetAssessmentReport_RequestSyntax"></a>

```
{
   "assessmentRunArn": "string",
   "reportFileFormat": "string",
   "reportType": "string"
}
```

## Request Parameters
<a name="API_GetAssessmentReport_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [assessmentRunArn](#API_GetAssessmentReport_RequestSyntax) **   <a name="Inspector-GetAssessmentReport-request-assessmentRunArn"></a>
The ARN that specifies the assessment run for which you want to generate a report.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 300.  
Required: Yes

 ** [reportFileFormat](#API_GetAssessmentReport_RequestSyntax) **   <a name="Inspector-GetAssessmentReport-request-reportFileFormat"></a>
Specifies the file format (html or pdf) of the assessment report that you want to generate.  
Type: String  
Valid Values: `HTML | PDF`   
Required: Yes

 ** [reportType](#API_GetAssessmentReport_RequestSyntax) **   <a name="Inspector-GetAssessmentReport-request-reportType"></a>
Specifies the type of the assessment report that you want to generate. There are two types of assessment reports: a finding report and a full report. For more information, see [Assessment Reports](https://docs.aws.amazon.com/inspector/latest/userguide/inspector_reports.html).   
Type: String  
Valid Values: `FINDING | FULL`   
Required: Yes

## Response Syntax
<a name="API_GetAssessmentReport_ResponseSyntax"></a>

```
{
   "status": "string",
   "url": "string"
}
```

## Response Elements
<a name="API_GetAssessmentReport_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [status](#API_GetAssessmentReport_ResponseSyntax) **   <a name="Inspector-GetAssessmentReport-response-status"></a>
Specifies the status of the request to generate an assessment report.   
Type: String  
Valid Values: `WORK_IN_PROGRESS | FAILED | COMPLETED` 

 ** [url](#API_GetAssessmentReport_ResponseSyntax) **   <a name="Inspector-GetAssessmentReport-response-url"></a>
Specifies the URL where you can find the generated assessment report. This parameter is only returned if the report is successfully generated.  
Type: String  
Length Constraints: Maximum length of 2048.

## Errors
<a name="API_GetAssessmentReport_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AssessmentRunInProgressException **   
You cannot perform a specified action if an assessment run is currently in progress.    
 ** assessmentRunArns **   
The ARNs of the assessment runs that are currently in progress.  
 ** assessmentRunArnsTruncated **   
Boolean value that indicates whether the ARN list of the assessment runs is truncated.  
 ** canRetry **   
You can immediately retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** InternalException **   
Internal server error.    
 ** canRetry **   
You can immediately retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 500

 ** InvalidInputException **   
The request was rejected because an invalid or out-of-range value was supplied for an input parameter.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** NoSuchEntityException **   
The request was rejected because it referenced an entity that does not exist. The error code describes the entity.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** ServiceTemporarilyUnavailableException **   
The serice is temporary unavailable.    
 ** canRetry **   
You can wait and then retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** UnsupportedFeatureException **   
Used by the [GetAssessmentReport](#API_GetAssessmentReport) API. The request was rejected because you tried to generate a report for an assessment run that existed before reporting was supported in Amazon Inspector. You can only generate reports for assessment runs that took place or will take place after generating reports in Amazon Inspector Classic became available.  
HTTP Status Code: 400

## See Also
<a name="API_GetAssessmentReport_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/inspector-2016-02-16/GetAssessmentReport) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/inspector-2016-02-16/GetAssessmentReport) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/inspector-2016-02-16/GetAssessmentReport) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/inspector-2016-02-16/GetAssessmentReport) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/inspector-2016-02-16/GetAssessmentReport) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/inspector-2016-02-16/GetAssessmentReport) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/inspector-2016-02-16/GetAssessmentReport) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/inspector-2016-02-16/GetAssessmentReport) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/inspector-2016-02-16/GetAssessmentReport) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/inspector-2016-02-16/GetAssessmentReport) 

# GetExclusionsPreview
<a name="API_GetExclusionsPreview"></a>

**Important**  
End of support notice: On May 20, 2026, AWS will end support for (Amazon Inspector Classic). After May 20, 2026, you will no longer be able to access the Amazon Inspector Classic console or Amazon Inspector Classic resources. For more information, see [Amazon Inspector Classic end of support](https://docs.aws.amazon.com/inspector/v1/userguide/inspector-migration.html). 

Retrieves the exclusions preview (a list of ExclusionPreview objects) specified by the preview token. You can obtain the preview token by running the CreateExclusionsPreview API.

## Request Syntax
<a name="API_GetExclusionsPreview_RequestSyntax"></a>

```
{
   "assessmentTemplateArn": "string",
   "locale": "string",
   "maxResults": number,
   "nextToken": "string",
   "previewToken": "string"
}
```

## Request Parameters
<a name="API_GetExclusionsPreview_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [assessmentTemplateArn](#API_GetExclusionsPreview_RequestSyntax) **   <a name="Inspector-GetExclusionsPreview-request-assessmentTemplateArn"></a>
The ARN that specifies the assessment template for which the exclusions preview was requested.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 300.  
Required: Yes

 ** [locale](#API_GetExclusionsPreview_RequestSyntax) **   <a name="Inspector-GetExclusionsPreview-request-locale"></a>
The locale into which you want to translate the exclusion's title, description, and recommendation.  
Type: String  
Valid Values: `EN_US`   
Required: No

 ** [maxResults](#API_GetExclusionsPreview_RequestSyntax) **   <a name="Inspector-GetExclusionsPreview-request-maxResults"></a>
You can use this parameter to indicate the maximum number of items you want in the response. The default value is 100. The maximum value is 500.  
Type: Integer  
Required: No

 ** [nextToken](#API_GetExclusionsPreview_RequestSyntax) **   <a name="Inspector-GetExclusionsPreview-request-nextToken"></a>
You can use this parameter when paginating results. Set the value of this parameter to null on your first call to the GetExclusionsPreviewRequest action. Subsequent calls to the action fill nextToken in the request with the value of nextToken from the previous response to continue listing data.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 300.  
Required: No

 ** [previewToken](#API_GetExclusionsPreview_RequestSyntax) **   <a name="Inspector-GetExclusionsPreview-request-previewToken"></a>
The unique identifier associated of the exclusions preview.  
Type: String  
Pattern: `[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}`   
Required: Yes

## Response Syntax
<a name="API_GetExclusionsPreview_ResponseSyntax"></a>

```
{
   "exclusionPreviews": [ 
      { 
         "attributes": [ 
            { 
               "key": "string",
               "value": "string"
            }
         ],
         "description": "string",
         "recommendation": "string",
         "scopes": [ 
            { 
               "key": "string",
               "value": "string"
            }
         ],
         "title": "string"
      }
   ],
   "nextToken": "string",
   "previewStatus": "string"
}
```

## Response Elements
<a name="API_GetExclusionsPreview_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [exclusionPreviews](#API_GetExclusionsPreview_ResponseSyntax) **   <a name="Inspector-GetExclusionsPreview-response-exclusionPreviews"></a>
Information about the exclusions included in the preview.  
Type: Array of [ExclusionPreview](API_ExclusionPreview.md) objects  
Array Members: Minimum number of 0 items. Maximum number of 100 items.

 ** [nextToken](#API_GetExclusionsPreview_ResponseSyntax) **   <a name="Inspector-GetExclusionsPreview-response-nextToken"></a>
When a response is generated, if there is more data to be listed, this parameters is present in the response and contains the value to use for the nextToken parameter in a subsequent pagination request. If there is no more data to be listed, this parameter is set to null.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 300.

 ** [previewStatus](#API_GetExclusionsPreview_ResponseSyntax) **   <a name="Inspector-GetExclusionsPreview-response-previewStatus"></a>
Specifies the status of the request to generate an exclusions preview.  
Type: String  
Valid Values: `WORK_IN_PROGRESS | COMPLETED` 

## Errors
<a name="API_GetExclusionsPreview_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InternalException **   
Internal server error.    
 ** canRetry **   
You can immediately retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 500

 ** InvalidInputException **   
The request was rejected because an invalid or out-of-range value was supplied for an input parameter.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** NoSuchEntityException **   
The request was rejected because it referenced an entity that does not exist. The error code describes the entity.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

## See Also
<a name="API_GetExclusionsPreview_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/inspector-2016-02-16/GetExclusionsPreview) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/inspector-2016-02-16/GetExclusionsPreview) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/inspector-2016-02-16/GetExclusionsPreview) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/inspector-2016-02-16/GetExclusionsPreview) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/inspector-2016-02-16/GetExclusionsPreview) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/inspector-2016-02-16/GetExclusionsPreview) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/inspector-2016-02-16/GetExclusionsPreview) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/inspector-2016-02-16/GetExclusionsPreview) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/inspector-2016-02-16/GetExclusionsPreview) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/inspector-2016-02-16/GetExclusionsPreview) 

# GetTelemetryMetadata
<a name="API_GetTelemetryMetadata"></a>

**Important**  
End of support notice: On May 20, 2026, AWS will end support for (Amazon Inspector Classic). After May 20, 2026, you will no longer be able to access the Amazon Inspector Classic console or Amazon Inspector Classic resources. For more information, see [Amazon Inspector Classic end of support](https://docs.aws.amazon.com/inspector/v1/userguide/inspector-migration.html). 

Information about the data that is collected for the specified assessment run.

## Request Syntax
<a name="API_GetTelemetryMetadata_RequestSyntax"></a>

```
{
   "assessmentRunArn": "string"
}
```

## Request Parameters
<a name="API_GetTelemetryMetadata_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [assessmentRunArn](#API_GetTelemetryMetadata_RequestSyntax) **   <a name="Inspector-GetTelemetryMetadata-request-assessmentRunArn"></a>
The ARN that specifies the assessment run that has the telemetry data that you want to obtain.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 300.  
Required: Yes

## Response Syntax
<a name="API_GetTelemetryMetadata_ResponseSyntax"></a>

```
{
   "telemetryMetadata": [ 
      { 
         "count": number,
         "dataSize": number,
         "messageType": "string"
      }
   ]
}
```

## Response Elements
<a name="API_GetTelemetryMetadata_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [telemetryMetadata](#API_GetTelemetryMetadata_ResponseSyntax) **   <a name="Inspector-GetTelemetryMetadata-response-telemetryMetadata"></a>
Telemetry details.  
Type: Array of [TelemetryMetadata](API_TelemetryMetadata.md) objects  
Array Members: Minimum number of 0 items. Maximum number of 5000 items.

## Errors
<a name="API_GetTelemetryMetadata_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InternalException **   
Internal server error.    
 ** canRetry **   
You can immediately retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 500

 ** InvalidInputException **   
The request was rejected because an invalid or out-of-range value was supplied for an input parameter.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** NoSuchEntityException **   
The request was rejected because it referenced an entity that does not exist. The error code describes the entity.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

## Examples
<a name="API_GetTelemetryMetadata_Examples"></a>

### Example
<a name="API_GetTelemetryMetadata_Example_1"></a>

This example illustrates one usage of GetTelemetryMetadata.

#### Sample Request
<a name="API_GetTelemetryMetadata_Example_1_Request"></a>

```
               
                  POST / HTTP/1.1
                  Host: inspector.us-west-2.amazonaws.com
                  Accept-Encoding: identity
                  Content-Length: 117
                  X-Amz-Target: InspectorService.GetTelemetryMetadata
                  X-Amz-Date: 20160329T223852Z
                  User-Agent: aws-cli/1.10.12 Python/2.7.9 Windows/7 botocore/1.4.3
                  Content-Type: application/x-amz-json-1.1
                  Authorization: AUTHPARAMS
                  {
                    "assessmentRunArn": "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE"
                  }
```

#### Sample Response
<a name="API_GetTelemetryMetadata_Example_1_Response"></a>

```
               
                  HTTP/1.1 200 OK
                  x-amzn-RequestId: 03ffa82f-f5ff-11e5-9cf9-9fd5e2aef2f6
                  Content-Type: application/x-amz-json-1.1
                  Content-Length: 1990
                  Date: Tue, 29 Mar 2016 22:38:53 GMT
                  {
                    "telemetryMetadata": [
                      {
                        "count": 2,
                        "dataSize": 345,
                        "messageType": "InspectorDuplicateProcess"
                      },
                      {
                        "count": 3,
                        "dataSize": 255,
                        "messageType": "InspectorTimeEventMsg"
                      },
                      {
                        "count": 4,
                        "dataSize": 1082,
                        "messageType": "InspectorNetworkInterface"
                      },
                      {
                        "count": 2,
                        "dataSize": 349,
                        "messageType": "InspectorDnsEntry"
                      },
                      {
                        "count": 11,
                        "dataSize": 2514,
                        "messageType": "InspectorDirectoryInfoMsg"
                      },
                      {
                        "count": 1,
                        "dataSize": 179,
                        "messageType": "InspectorTcpV6ListeningPort"
                      },
                      {
                        "count": 101,
                        "dataSize": 10949,
                        "messageType": "InspectorTerminal"
                      },
                      {
                        "count": 26,
                        "dataSize": 5916,
                        "messageType": "InspectorUser"
                      },
                      {
                        "count": 282,
                        "dataSize": 32148,
                        "messageType": "InspectorDynamicallyLoadedCodeModule"
                      },
                      {
                        "count": 18,
                        "dataSize": 10172,
                        "messageType": "InspectorCreateProcess"
                      },
                      {
                        "count": 3,
                        "dataSize": 8001,
                        "messageType": "InspectorProcessPerformance"
                      },
                      {
                        "count": 1,
                        "dataSize": 360,
                        "messageType": "InspectorOperatingSystem"
                      },
                      {
                        "count": 6,
                        "dataSize": 546,
                        "messageType": "InspectorStopProcess"
                      },
                      {
                        "count": 1,
                        "dataSize": 1553,
                        "messageType": "InspectorInstanceMetaData"
                      },
                      {
                        "count": 2,
                        "dataSize": 434,
                        "messageType": "InspectorTcpV4Connection"
                      },
                      {
                        "count": 474,
                        "dataSize": 2960322,
                        "messageType": "InspectorPackageInfo"
                      },
                      {
                        "count": 3,
                        "dataSize": 2235,
                        "messageType": "InspectorSystemPerformance"
                      },
                      {
                        "count": 105,
                        "dataSize": 46048,
                        "messageType": "InspectorCodeModule"
                      },
                      {
                        "count": 1,
                        "dataSize": 182,
                        "messageType": "InspectorUdpV6ListeningPort"
                      },
                      {
                        "count": 2,
                        "dataSize": 371,
                        "messageType": "InspectorUdpV4ListeningPort"
                      },
                      {
                        "count": 18,
                        "dataSize": 8362,
                        "messageType": "InspectorKernelModule"
                      },
                      {
                        "count": 29,
                        "dataSize": 48788,
                        "messageType": "InspectorConfigurationInfo"
                      },
                      {
                        "count": 1,
                        "dataSize": 79,
                        "messageType": "InspectorMonitoringStart"
                      },
                      {
                        "count": 5,
                        "dataSize": 0,
                        "messageType": "InspectorSplitMsgBegin"
                      },
                      {
                        "count": 51,
                        "dataSize": 4593,
                        "messageType": "InspectorGroup"
                      },
                      {
                        "count": 1,
                        "dataSize": 184,
                        "messageType": "InspectorTcpV4ListeningPort"
                      },
                      {
                        "count": 1159,
                        "dataSize": 3146579,
                        "messageType": "Total"
                      },
                      {
                        "count": 5,
                        "dataSize": 0,
                        "messageType": "InspectorSplitMsgEnd"
                      },
                      {
                        "count": 1,
                        "dataSize": 612,
                        "messageType": "InspectorLoadImageInProcess"
                      }
                    ]
                  }
```

## See Also
<a name="API_GetTelemetryMetadata_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/inspector-2016-02-16/GetTelemetryMetadata) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/inspector-2016-02-16/GetTelemetryMetadata) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/inspector-2016-02-16/GetTelemetryMetadata) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/inspector-2016-02-16/GetTelemetryMetadata) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/inspector-2016-02-16/GetTelemetryMetadata) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/inspector-2016-02-16/GetTelemetryMetadata) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/inspector-2016-02-16/GetTelemetryMetadata) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/inspector-2016-02-16/GetTelemetryMetadata) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/inspector-2016-02-16/GetTelemetryMetadata) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/inspector-2016-02-16/GetTelemetryMetadata) 

# ListAssessmentRunAgents
<a name="API_ListAssessmentRunAgents"></a>

**Important**  
End of support notice: On May 20, 2026, AWS will end support for (Amazon Inspector Classic). After May 20, 2026, you will no longer be able to access the Amazon Inspector Classic console or Amazon Inspector Classic resources. For more information, see [Amazon Inspector Classic end of support](https://docs.aws.amazon.com/inspector/v1/userguide/inspector-migration.html). 

Lists the agents of the assessment runs that are specified by the ARNs of the assessment runs.

## Request Syntax
<a name="API_ListAssessmentRunAgents_RequestSyntax"></a>

```
{
   "assessmentRunArn": "string",
   "filter": { 
      "agentHealthCodes": [ "string" ],
      "agentHealths": [ "string" ]
   },
   "maxResults": number,
   "nextToken": "string"
}
```

## Request Parameters
<a name="API_ListAssessmentRunAgents_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [assessmentRunArn](#API_ListAssessmentRunAgents_RequestSyntax) **   <a name="Inspector-ListAssessmentRunAgents-request-assessmentRunArn"></a>
The ARN that specifies the assessment run whose agents you want to list.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 300.  
Required: Yes

 ** [filter](#API_ListAssessmentRunAgents_RequestSyntax) **   <a name="Inspector-ListAssessmentRunAgents-request-filter"></a>
You can use this parameter to specify a subset of data to be included in the action's response.  
For a record to match a filter, all specified filter attributes must match. When multiple values are specified for a filter attribute, any of the values can match.  
Type: [AgentFilter](API_AgentFilter.md) object  
Required: No

 ** [maxResults](#API_ListAssessmentRunAgents_RequestSyntax) **   <a name="Inspector-ListAssessmentRunAgents-request-maxResults"></a>
You can use this parameter to indicate the maximum number of items that you want in the response. The default value is 10. The maximum value is 500.  
Type: Integer  
Required: No

 ** [nextToken](#API_ListAssessmentRunAgents_RequestSyntax) **   <a name="Inspector-ListAssessmentRunAgents-request-nextToken"></a>
You can use this parameter when paginating results. Set the value of this parameter to null on your first call to the **ListAssessmentRunAgents** action. Subsequent calls to the action fill **nextToken** in the request with the value of **NextToken** from the previous response to continue listing data.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 300.  
Required: No

## Response Syntax
<a name="API_ListAssessmentRunAgents_ResponseSyntax"></a>

```
{
   "assessmentRunAgents": [ 
      { 
         "agentHealth": "string",
         "agentHealthCode": "string",
         "agentHealthDetails": "string",
         "agentId": "string",
         "assessmentRunArn": "string",
         "autoScalingGroup": "string",
         "telemetryMetadata": [ 
            { 
               "count": number,
               "dataSize": number,
               "messageType": "string"
            }
         ]
      }
   ],
   "nextToken": "string"
}
```

## Response Elements
<a name="API_ListAssessmentRunAgents_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [assessmentRunAgents](#API_ListAssessmentRunAgents_ResponseSyntax) **   <a name="Inspector-ListAssessmentRunAgents-response-assessmentRunAgents"></a>
A list of ARNs that specifies the agents returned by the action.  
Type: Array of [AssessmentRunAgent](API_AssessmentRunAgent.md) objects  
Array Members: Minimum number of 0 items. Maximum number of 500 items.

 ** [nextToken](#API_ListAssessmentRunAgents_ResponseSyntax) **   <a name="Inspector-ListAssessmentRunAgents-response-nextToken"></a>
 When a response is generated, if there is more data to be listed, this parameter is present in the response and contains the value to use for the **nextToken** parameter in a subsequent pagination request. If there is no more data to be listed, this parameter is set to null.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 300.

## Errors
<a name="API_ListAssessmentRunAgents_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InternalException **   
Internal server error.    
 ** canRetry **   
You can immediately retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 500

 ** InvalidInputException **   
The request was rejected because an invalid or out-of-range value was supplied for an input parameter.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** NoSuchEntityException **   
The request was rejected because it referenced an entity that does not exist. The error code describes the entity.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

## Examples
<a name="API_ListAssessmentRunAgents_Examples"></a>

### Example
<a name="API_ListAssessmentRunAgents_Example_1"></a>

This example illustrates one usage of ListAssessmentRunAgents.

#### Sample Request
<a name="API_ListAssessmentRunAgents_Example_1_Request"></a>

```
               
               POST / HTTP/1.1
               Host: inspector.us-west-2.amazonaws.com
               Accept-Encoding: identity
               Content-Length: 117
               X-Amz-Target: InspectorService.ListAssessmentRunAgents
               X-Amz-Date: 20160323T212138Z
               User-Agent: aws-cli/1.10.12 Python/2.7.9 Windows/7 botocore/1.4.3
               Content-Type: application/x-amz-json-1.1
               Authorization: AUTHPARAMS
               {
                 "assessmentRunArn": "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE"
               }
```

#### Sample Response
<a name="API_ListAssessmentRunAgents_Example_1_Response"></a>

```
               
               HTTP/1.1 200 OK
               x-amzn-RequestId: 3b752481-f13d-11e5-9f2a-87dc3189b81c
               Content-Type: application/x-amz-json-1.1
               Content-Length: 2206
               Date: Wed, 23 Mar 2016 21:21:39 GMT
               {
                 "assessmentRunAgents": [
                   {
                     "agentHealth": "HEALTHY",
                     "agentHealthCode": "HEALTHY",
                     "agentId": "i-49113b93",
                     "assessmentRunArn": "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE",
                     "telemetryMetadata": [
                       {
                         "count": 2,
                         "dataSize": 345,
                         "messageType": "InspectorDuplicateProcess"
                       },
                       {
                         "count": 3,
                         "dataSize": 255,
                         "messageType": "InspectorTimeEventMsg"
                       },
                       {
                         "count": 4,
                         "dataSize": 1082,
                         "messageType": "InspectorNetworkInterface"
                       },
                       {
                         "count": 2,
                         "dataSize": 349,
                         "messageType": "InspectorDnsEntry"
                       },
                       {
                         "count": 11,
                         "dataSize": 2514,
                         "messageType": "InspectorDirectoryInfoMsg"
                       },
                       {
                         "count": 1,
                         "dataSize": 179,
                         "messageType": "InspectorTcpV6ListeningPort"
                       },
                       {
                         "count": 101,
                         "dataSize": 10949,
                         "messageType": "InspectorTerminal"
                       },
                       {
                         "count": 26,
                         "dataSize": 5916,
                         "messageType": "InspectorUser"
                       },
                       {
                         "count": 282,
                         "dataSize": 32148,
                         "messageType": "InspectorDynamicallyLoadedCodeModule"
                       },
                       {
                         "count": 18,
                         "dataSize": 10172,
                         "messageType": "InspectorCreateProcess"
                       },
                       {
                         "count": 3,
                         "dataSize": 8001,
                         "messageType": "InspectorProcessPerformance"
                       },
                       {
                         "count": 1,
                         "dataSize": 360,
                         "messageType": "InspectorOperatingSystem"
                       },
                       {
                         "count": 6,
                         "dataSize": 546,
                         "messageType": "InspectorStopProcess"
                       },
                       {
                         "count": 1,
                         "dataSize": 1553,
                         "messageType": "InspectorInstanceMetaData"
                       },
                       {
                         "count": 2,
                         "dataSize": 434,
                         "messageType": "InspectorTcpV4Connection"
                       },
                       {
                         "count": 474,
                         "dataSize": 2960322,
                         "messageType": "InspectorPackageInfo"
                       },
                       {
                         "count": 3,
                         "dataSize": 2235,
                         "messageType": "InspectorSystemPerformance"
                       },
                       {
                         "count": 105,
                         "dataSize": 46048,
                         "messageType": "InspectorCodeModule"
                       },
                       {
                         "count": 1,
                         "dataSize": 182,
                         "messageType": "InspectorUdpV6ListeningPort"
                       },
                       {
                         "count": 2,
                         "dataSize": 371,
                         "messageType": "InspectorUdpV4ListeningPort"
                       },
                       {
                         "count": 18,
                         "dataSize": 8362,
                         "messageType": "InspectorKernelModule"
                       },
                       {
                         "count": 29,
                         "dataSize": 48788,
                         "messageType": "InspectorConfigurationInfo"
                       },
                       {
                         "count": 1,
                         "dataSize": 79,
                         "messageType": "InspectorMonitoringStart"
                       },
                       {
                         "count": 5,
                         "dataSize": 0,
                         "messageType": "InspectorSplitMsgBegin"
                       },
                       {
                         "count": 51,
                         "dataSize": 4593,
                         "messageType": "InspectorGroup"
                       },
                       {
                         "count": 1,
                         "dataSize": 184,
                         "messageType": "InspectorTcpV4ListeningPort"
                       },
                       {
                         "count": 1159,
                         "dataSize": 3146579,
                         "messageType": "Total"
                       },
                       {
                         "count": 5,
                         "dataSize": 0,
                         "messageType": "InspectorSplitMsgEnd"
                       },
                       {
                         "count": 1,
                         "dataSize": 612,
                         "messageType": "InspectorLoadImageInProcess"
                       }
                     ]
                   }
                 ]
               }
```

## See Also
<a name="API_ListAssessmentRunAgents_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/inspector-2016-02-16/ListAssessmentRunAgents) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/inspector-2016-02-16/ListAssessmentRunAgents) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/inspector-2016-02-16/ListAssessmentRunAgents) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/inspector-2016-02-16/ListAssessmentRunAgents) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/inspector-2016-02-16/ListAssessmentRunAgents) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/inspector-2016-02-16/ListAssessmentRunAgents) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/inspector-2016-02-16/ListAssessmentRunAgents) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/inspector-2016-02-16/ListAssessmentRunAgents) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/inspector-2016-02-16/ListAssessmentRunAgents) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/inspector-2016-02-16/ListAssessmentRunAgents) 

# ListAssessmentRuns
<a name="API_ListAssessmentRuns"></a>

**Important**  
End of support notice: On May 20, 2026, AWS will end support for (Amazon Inspector Classic). After May 20, 2026, you will no longer be able to access the Amazon Inspector Classic console or Amazon Inspector Classic resources. For more information, see [Amazon Inspector Classic end of support](https://docs.aws.amazon.com/inspector/v1/userguide/inspector-migration.html). 

Lists the assessment runs that correspond to the assessment templates that are specified by the ARNs of the assessment templates.

## Request Syntax
<a name="API_ListAssessmentRuns_RequestSyntax"></a>

```
{
   "assessmentTemplateArns": [ "string" ],
   "filter": { 
      "completionTimeRange": { 
         "beginDate": number,
         "endDate": number
      },
      "durationRange": { 
         "maxSeconds": number,
         "minSeconds": number
      },
      "namePattern": "string",
      "rulesPackageArns": [ "string" ],
      "startTimeRange": { 
         "beginDate": number,
         "endDate": number
      },
      "stateChangeTimeRange": { 
         "beginDate": number,
         "endDate": number
      },
      "states": [ "string" ]
   },
   "maxResults": number,
   "nextToken": "string"
}
```

## Request Parameters
<a name="API_ListAssessmentRuns_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [assessmentTemplateArns](#API_ListAssessmentRuns_RequestSyntax) **   <a name="Inspector-ListAssessmentRuns-request-assessmentTemplateArns"></a>
The ARNs that specify the assessment templates whose assessment runs you want to list.  
Type: Array of strings  
Array Members: Minimum number of 0 items. Maximum number of 50 items.  
Length Constraints: Minimum length of 1. Maximum length of 300.  
Required: No

 ** [filter](#API_ListAssessmentRuns_RequestSyntax) **   <a name="Inspector-ListAssessmentRuns-request-filter"></a>
You can use this parameter to specify a subset of data to be included in the action's response.  
For a record to match a filter, all specified filter attributes must match. When multiple values are specified for a filter attribute, any of the values can match.  
Type: [AssessmentRunFilter](API_AssessmentRunFilter.md) object  
Required: No

 ** [maxResults](#API_ListAssessmentRuns_RequestSyntax) **   <a name="Inspector-ListAssessmentRuns-request-maxResults"></a>
You can use this parameter to indicate the maximum number of items that you want in the response. The default value is 10. The maximum value is 500.  
Type: Integer  
Required: No

 ** [nextToken](#API_ListAssessmentRuns_RequestSyntax) **   <a name="Inspector-ListAssessmentRuns-request-nextToken"></a>
You can use this parameter when paginating results. Set the value of this parameter to null on your first call to the **ListAssessmentRuns** action. Subsequent calls to the action fill **nextToken** in the request with the value of **NextToken** from the previous response to continue listing data.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 300.  
Required: No

## Response Syntax
<a name="API_ListAssessmentRuns_ResponseSyntax"></a>

```
{
   "assessmentRunArns": [ "string" ],
   "nextToken": "string"
}
```

## Response Elements
<a name="API_ListAssessmentRuns_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [assessmentRunArns](#API_ListAssessmentRuns_ResponseSyntax) **   <a name="Inspector-ListAssessmentRuns-response-assessmentRunArns"></a>
A list of ARNs that specifies the assessment runs that are returned by the action.  
Type: Array of strings  
Array Members: Minimum number of 0 items. Maximum number of 100 items.  
Length Constraints: Minimum length of 1. Maximum length of 300.

 ** [nextToken](#API_ListAssessmentRuns_ResponseSyntax) **   <a name="Inspector-ListAssessmentRuns-response-nextToken"></a>
 When a response is generated, if there is more data to be listed, this parameter is present in the response and contains the value to use for the **nextToken** parameter in a subsequent pagination request. If there is no more data to be listed, this parameter is set to null.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 300.

## Errors
<a name="API_ListAssessmentRuns_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InternalException **   
Internal server error.    
 ** canRetry **   
You can immediately retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 500

 ** InvalidInputException **   
The request was rejected because an invalid or out-of-range value was supplied for an input parameter.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** NoSuchEntityException **   
The request was rejected because it referenced an entity that does not exist. The error code describes the entity.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

## Examples
<a name="API_ListAssessmentRuns_Examples"></a>

### Example
<a name="API_ListAssessmentRuns_Example_1"></a>

This example illustrates one usage of ListAssessmentRuns.

#### Sample Request
<a name="API_ListAssessmentRuns_Example_1_Request"></a>

```
               
               POST / HTTP/1.1
               Host: inspector.us-west-2.amazonaws.com
               Accept-Encoding: identity
               Content-Length: 2
               X-Amz-Target: InspectorService.ListAssessmentRuns
               X-Amz-Date: 20160323T194135Z
               User-Agent: aws-cli/1.10.12 Python/2.7.9 Windows/7 botocore/1.4.3
               Content-Type: application/x-amz-json-1.1
               Authorization: AUTHPARAMS
               {}
```

#### Sample Response
<a name="API_ListAssessmentRuns_Example_1_Response"></a>

```
               
               HTTP/1.1 200 OK
               x-amzn-RequestId: 410dabf6-f12f-11e5-8b5a-810259c0c3ae
               Content-Type: application/x-amz-json-1.1
               Content-Length: 215
               Date: Wed, 23 Mar 2016 19:41:36 GMT
               {
                  "assessmentRunArns": 
                  [
                  "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE",
                  "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-v5D6fI3v"
                  ]
               }
```

## See Also
<a name="API_ListAssessmentRuns_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/inspector-2016-02-16/ListAssessmentRuns) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/inspector-2016-02-16/ListAssessmentRuns) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/inspector-2016-02-16/ListAssessmentRuns) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/inspector-2016-02-16/ListAssessmentRuns) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/inspector-2016-02-16/ListAssessmentRuns) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/inspector-2016-02-16/ListAssessmentRuns) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/inspector-2016-02-16/ListAssessmentRuns) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/inspector-2016-02-16/ListAssessmentRuns) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/inspector-2016-02-16/ListAssessmentRuns) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/inspector-2016-02-16/ListAssessmentRuns) 

# ListAssessmentTargets
<a name="API_ListAssessmentTargets"></a>

**Important**  
End of support notice: On May 20, 2026, AWS will end support for (Amazon Inspector Classic). After May 20, 2026, you will no longer be able to access the Amazon Inspector Classic console or Amazon Inspector Classic resources. For more information, see [Amazon Inspector Classic end of support](https://docs.aws.amazon.com/inspector/v1/userguide/inspector-migration.html). 

Lists the ARNs of the assessment targets within this AWS account. For more information about assessment targets, see [Amazon Inspector Classic Assessment Targets](https://docs.aws.amazon.com/inspector/latest/userguide/inspector_applications.html).

## Request Syntax
<a name="API_ListAssessmentTargets_RequestSyntax"></a>

```
{
   "filter": { 
      "assessmentTargetNamePattern": "string"
   },
   "maxResults": number,
   "nextToken": "string"
}
```

## Request Parameters
<a name="API_ListAssessmentTargets_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [filter](#API_ListAssessmentTargets_RequestSyntax) **   <a name="Inspector-ListAssessmentTargets-request-filter"></a>
You can use this parameter to specify a subset of data to be included in the action's response.  
For a record to match a filter, all specified filter attributes must match. When multiple values are specified for a filter attribute, any of the values can match.  
Type: [AssessmentTargetFilter](API_AssessmentTargetFilter.md) object  
Required: No

 ** [maxResults](#API_ListAssessmentTargets_RequestSyntax) **   <a name="Inspector-ListAssessmentTargets-request-maxResults"></a>
You can use this parameter to indicate the maximum number of items you want in the response. The default value is 10. The maximum value is 500.  
Type: Integer  
Required: No

 ** [nextToken](#API_ListAssessmentTargets_RequestSyntax) **   <a name="Inspector-ListAssessmentTargets-request-nextToken"></a>
You can use this parameter when paginating results. Set the value of this parameter to null on your first call to the **ListAssessmentTargets** action. Subsequent calls to the action fill **nextToken** in the request with the value of **NextToken** from the previous response to continue listing data.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 300.  
Required: No

## Response Syntax
<a name="API_ListAssessmentTargets_ResponseSyntax"></a>

```
{
   "assessmentTargetArns": [ "string" ],
   "nextToken": "string"
}
```

## Response Elements
<a name="API_ListAssessmentTargets_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [assessmentTargetArns](#API_ListAssessmentTargets_ResponseSyntax) **   <a name="Inspector-ListAssessmentTargets-response-assessmentTargetArns"></a>
A list of ARNs that specifies the assessment targets that are returned by the action.  
Type: Array of strings  
Array Members: Minimum number of 0 items. Maximum number of 100 items.  
Length Constraints: Minimum length of 1. Maximum length of 300.

 ** [nextToken](#API_ListAssessmentTargets_ResponseSyntax) **   <a name="Inspector-ListAssessmentTargets-response-nextToken"></a>
 When a response is generated, if there is more data to be listed, this parameter is present in the response and contains the value to use for the **nextToken** parameter in a subsequent pagination request. If there is no more data to be listed, this parameter is set to null.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 300.

## Errors
<a name="API_ListAssessmentTargets_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InternalException **   
Internal server error.    
 ** canRetry **   
You can immediately retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 500

 ** InvalidInputException **   
The request was rejected because an invalid or out-of-range value was supplied for an input parameter.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

## Examples
<a name="API_ListAssessmentTargets_Examples"></a>

### Example
<a name="API_ListAssessmentTargets_Example_1"></a>

This example illustrates one usage of ListAssessmentTargets.

#### Sample Request
<a name="API_ListAssessmentTargets_Example_1_Request"></a>

```
               
               POST / HTTP/1.1
               Host: inspector.us-west-2.amazonaws.com
               Accept-Encoding: identity
               Content-Length: 2
               X-Amz-Target: InspectorService.ListAssessmentTargets
               X-Amz-Date: 20160323T201018Z
               User-Agent: aws-cli/1.10.12 Python/2.7.9 Windows/7 botocore/1.4.3
               Content-Type: application/x-amz-json-1.1
               Authorization: AUTHPARAMS
               {}
```

#### Sample Response
<a name="API_ListAssessmentTargets_Example_1_Response"></a>

```
               
               HTTP/1.1 200 OK
               x-amzn-RequestId: 445f71f6-f133-11e5-932b-dd9c937d073a
               Content-Type: application/x-amz-json-1.1
               Content-Length: 87
               Date: Wed, 23 Mar 2016 20:10:19 GMT
               {
                  "assessmentTargetArns": [
                  "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq"
                  ]
               }
```

## See Also
<a name="API_ListAssessmentTargets_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/inspector-2016-02-16/ListAssessmentTargets) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/inspector-2016-02-16/ListAssessmentTargets) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/inspector-2016-02-16/ListAssessmentTargets) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/inspector-2016-02-16/ListAssessmentTargets) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/inspector-2016-02-16/ListAssessmentTargets) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/inspector-2016-02-16/ListAssessmentTargets) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/inspector-2016-02-16/ListAssessmentTargets) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/inspector-2016-02-16/ListAssessmentTargets) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/inspector-2016-02-16/ListAssessmentTargets) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/inspector-2016-02-16/ListAssessmentTargets) 

# ListAssessmentTemplates
<a name="API_ListAssessmentTemplates"></a>

**Important**  
End of support notice: On May 20, 2026, AWS will end support for (Amazon Inspector Classic). After May 20, 2026, you will no longer be able to access the Amazon Inspector Classic console or Amazon Inspector Classic resources. For more information, see [Amazon Inspector Classic end of support](https://docs.aws.amazon.com/inspector/v1/userguide/inspector-migration.html). 

Lists the assessment templates that correspond to the assessment targets that are specified by the ARNs of the assessment targets.

## Request Syntax
<a name="API_ListAssessmentTemplates_RequestSyntax"></a>

```
{
   "assessmentTargetArns": [ "string" ],
   "filter": { 
      "durationRange": { 
         "maxSeconds": number,
         "minSeconds": number
      },
      "namePattern": "string",
      "rulesPackageArns": [ "string" ]
   },
   "maxResults": number,
   "nextToken": "string"
}
```

## Request Parameters
<a name="API_ListAssessmentTemplates_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [assessmentTargetArns](#API_ListAssessmentTemplates_RequestSyntax) **   <a name="Inspector-ListAssessmentTemplates-request-assessmentTargetArns"></a>
A list of ARNs that specifies the assessment targets whose assessment templates you want to list.  
Type: Array of strings  
Array Members: Minimum number of 0 items. Maximum number of 50 items.  
Length Constraints: Minimum length of 1. Maximum length of 300.  
Required: No

 ** [filter](#API_ListAssessmentTemplates_RequestSyntax) **   <a name="Inspector-ListAssessmentTemplates-request-filter"></a>
You can use this parameter to specify a subset of data to be included in the action's response.  
For a record to match a filter, all specified filter attributes must match. When multiple values are specified for a filter attribute, any of the values can match.  
Type: [AssessmentTemplateFilter](API_AssessmentTemplateFilter.md) object  
Required: No

 ** [maxResults](#API_ListAssessmentTemplates_RequestSyntax) **   <a name="Inspector-ListAssessmentTemplates-request-maxResults"></a>
You can use this parameter to indicate the maximum number of items you want in the response. The default value is 10. The maximum value is 500.  
Type: Integer  
Required: No

 ** [nextToken](#API_ListAssessmentTemplates_RequestSyntax) **   <a name="Inspector-ListAssessmentTemplates-request-nextToken"></a>
You can use this parameter when paginating results. Set the value of this parameter to null on your first call to the **ListAssessmentTemplates** action. Subsequent calls to the action fill **nextToken** in the request with the value of **NextToken** from the previous response to continue listing data.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 300.  
Required: No

## Response Syntax
<a name="API_ListAssessmentTemplates_ResponseSyntax"></a>

```
{
   "assessmentTemplateArns": [ "string" ],
   "nextToken": "string"
}
```

## Response Elements
<a name="API_ListAssessmentTemplates_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [assessmentTemplateArns](#API_ListAssessmentTemplates_ResponseSyntax) **   <a name="Inspector-ListAssessmentTemplates-response-assessmentTemplateArns"></a>
A list of ARNs that specifies the assessment templates returned by the action.  
Type: Array of strings  
Array Members: Minimum number of 0 items. Maximum number of 100 items.  
Length Constraints: Minimum length of 1. Maximum length of 300.

 ** [nextToken](#API_ListAssessmentTemplates_ResponseSyntax) **   <a name="Inspector-ListAssessmentTemplates-response-nextToken"></a>
 When a response is generated, if there is more data to be listed, this parameter is present in the response and contains the value to use for the **nextToken** parameter in a subsequent pagination request. If there is no more data to be listed, this parameter is set to null.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 300.

## Errors
<a name="API_ListAssessmentTemplates_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InternalException **   
Internal server error.    
 ** canRetry **   
You can immediately retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 500

 ** InvalidInputException **   
The request was rejected because an invalid or out-of-range value was supplied for an input parameter.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** NoSuchEntityException **   
The request was rejected because it referenced an entity that does not exist. The error code describes the entity.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

## Examples
<a name="API_ListAssessmentTemplates_Examples"></a>

### Example
<a name="API_ListAssessmentTemplates_Example_1"></a>

This example illustrates one usage of ListAssessmentTemplates.

#### Sample Request
<a name="API_ListAssessmentTemplates_Example_1_Request"></a>

```
               
               POST / HTTP/1.1
               Host: inspector.us-west-2.amazonaws.com
               Accept-Encoding: identity
               Content-Length: 2
               X-Amz-Target: InspectorService.ListAssessmentTemplates
               X-Amz-Date: 20160323T202549Z
               User-Agent: aws-cli/1.10.12 Python/2.7.9 Windows/7 botocore/1.4.3
               Content-Type: application/x-amz-json-1.1
               Authorization: AUTHPARAMS
               {}
```

#### Sample Response
<a name="API_ListAssessmentTemplates_Example_1_Response"></a>

```
               
               HTTP/1.1 200 OK
               x-amzn-RequestId: 6f406528-f135-11e5-aa71-8de73166bfa9
               Content-Type: application/x-amz-json-1.1
               Content-Length: 190
               Date: Wed, 23 Mar 2016 20:25:50 GMT
               {
                  "assessmentTemplateArns": [
                  "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw",
                  "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-Uza6ihLh"
                  ]
               }
```

## See Also
<a name="API_ListAssessmentTemplates_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/inspector-2016-02-16/ListAssessmentTemplates) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/inspector-2016-02-16/ListAssessmentTemplates) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/inspector-2016-02-16/ListAssessmentTemplates) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/inspector-2016-02-16/ListAssessmentTemplates) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/inspector-2016-02-16/ListAssessmentTemplates) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/inspector-2016-02-16/ListAssessmentTemplates) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/inspector-2016-02-16/ListAssessmentTemplates) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/inspector-2016-02-16/ListAssessmentTemplates) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/inspector-2016-02-16/ListAssessmentTemplates) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/inspector-2016-02-16/ListAssessmentTemplates) 

# ListEventSubscriptions
<a name="API_ListEventSubscriptions"></a>

**Important**  
End of support notice: On May 20, 2026, AWS will end support for (Amazon Inspector Classic). After May 20, 2026, you will no longer be able to access the Amazon Inspector Classic console or Amazon Inspector Classic resources. For more information, see [Amazon Inspector Classic end of support](https://docs.aws.amazon.com/inspector/v1/userguide/inspector-migration.html). 

Lists all the event subscriptions for the assessment template that is specified by the ARN of the assessment template. For more information, see [SubscribeToEvent](API_SubscribeToEvent.md) and [UnsubscribeFromEvent](API_UnsubscribeFromEvent.md).

## Request Syntax
<a name="API_ListEventSubscriptions_RequestSyntax"></a>

```
{
   "maxResults": number,
   "nextToken": "string",
   "resourceArn": "string"
}
```

## Request Parameters
<a name="API_ListEventSubscriptions_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [maxResults](#API_ListEventSubscriptions_RequestSyntax) **   <a name="Inspector-ListEventSubscriptions-request-maxResults"></a>
You can use this parameter to indicate the maximum number of items you want in the response. The default value is 10. The maximum value is 500.  
Type: Integer  
Required: No

 ** [nextToken](#API_ListEventSubscriptions_RequestSyntax) **   <a name="Inspector-ListEventSubscriptions-request-nextToken"></a>
You can use this parameter when paginating results. Set the value of this parameter to null on your first call to the **ListEventSubscriptions** action. Subsequent calls to the action fill **nextToken** in the request with the value of **NextToken** from the previous response to continue listing data.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 300.  
Required: No

 ** [resourceArn](#API_ListEventSubscriptions_RequestSyntax) **   <a name="Inspector-ListEventSubscriptions-request-resourceArn"></a>
The ARN of the assessment template for which you want to list the existing event subscriptions.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 300.  
Required: No

## Response Syntax
<a name="API_ListEventSubscriptions_ResponseSyntax"></a>

```
{
   "nextToken": "string",
   "subscriptions": [ 
      { 
         "eventSubscriptions": [ 
            { 
               "event": "string",
               "subscribedAt": number
            }
         ],
         "resourceArn": "string",
         "topicArn": "string"
      }
   ]
}
```

## Response Elements
<a name="API_ListEventSubscriptions_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [nextToken](#API_ListEventSubscriptions_ResponseSyntax) **   <a name="Inspector-ListEventSubscriptions-response-nextToken"></a>
 When a response is generated, if there is more data to be listed, this parameter is present in the response and contains the value to use for the **nextToken** parameter in a subsequent pagination request. If there is no more data to be listed, this parameter is set to null.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 300.

 ** [subscriptions](#API_ListEventSubscriptions_ResponseSyntax) **   <a name="Inspector-ListEventSubscriptions-response-subscriptions"></a>
End of support notice: On May 20, 2026, AWS will end support for (Amazon Inspector Classic). After May 20, 2026, you will no longer be able to access the Amazon Inspector Classic console or Amazon Inspector Classic resources. For more information, see [Amazon Inspector Classic end of support](https://docs.aws.amazon.com/inspector/v1/userguide/inspector-migration.html). 
Details of the returned event subscriptions.  
Type: Array of [Subscription](API_Subscription.md) objects  
Array Members: Minimum number of 0 items. Maximum number of 50 items.

## Errors
<a name="API_ListEventSubscriptions_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InternalException **   
Internal server error.    
 ** canRetry **   
You can immediately retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 500

 ** InvalidInputException **   
The request was rejected because an invalid or out-of-range value was supplied for an input parameter.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** NoSuchEntityException **   
The request was rejected because it referenced an entity that does not exist. The error code describes the entity.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

## Examples
<a name="API_ListEventSubscriptions_Examples"></a>

### Example
<a name="API_ListEventSubscriptions_Example_1"></a>

This example illustrates one usage of ListEventSubscriptions.

#### Sample Request
<a name="API_ListEventSubscriptions_Example_1_Request"></a>

```
               
                  POST / HTTP/1.1
                  Host: inspector.us-west-2.amazonaws.com
                  Accept-Encoding: identity
                  Content-Length: 97
                  X-Amz-Target: InspectorService.ListEventSubscriptions
                  X-Amz-Date: 20160331T202943Z
                  User-Agent: aws-cli/1.10.12 Python/2.7.9 Windows/7 botocore/1.4.3
                  Content-Type: application/x-amz-json-1.1
                  Authorization: AUTHPARAMS
                  {
                    "resourceArn": "arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-7sbz2Kz0"
                  }
```

#### Sample Response
<a name="API_ListEventSubscriptions_Example_1_Response"></a>

```
               
                  HTTP/1.1 200 OK
                  x-amzn-RequestId: 4e21c005-f77f-11e5-823c-bd257ba1495d
                  Content-Type: application/x-amz-json-1.1
                  Content-Length: 272
                  Date: Thu, 31 Mar 2016 20:29:44 GMT
                  {
                    "subscriptions": [
                      {
                        "eventSubscriptions": [
                          {
                            "event": "ASSESSMENT_RUN_COMPLETED",
                            "subscribedAt": 1459455440.867
                          }
                        ],
                        "resourceArn": "arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-7sbz2Kz0",
                        "topicArn": "arn:aws:sns:us-west-2:123456789012:exampletopic"
                      }
                    ]
                  }
```

## See Also
<a name="API_ListEventSubscriptions_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/inspector-2016-02-16/ListEventSubscriptions) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/inspector-2016-02-16/ListEventSubscriptions) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/inspector-2016-02-16/ListEventSubscriptions) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/inspector-2016-02-16/ListEventSubscriptions) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/inspector-2016-02-16/ListEventSubscriptions) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/inspector-2016-02-16/ListEventSubscriptions) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/inspector-2016-02-16/ListEventSubscriptions) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/inspector-2016-02-16/ListEventSubscriptions) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/inspector-2016-02-16/ListEventSubscriptions) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/inspector-2016-02-16/ListEventSubscriptions) 

# ListExclusions
<a name="API_ListExclusions"></a>

**Important**  
End of support notice: On May 20, 2026, AWS will end support for (Amazon Inspector Classic). After May 20, 2026, you will no longer be able to access the Amazon Inspector Classic console or Amazon Inspector Classic resources. For more information, see [Amazon Inspector Classic end of support](https://docs.aws.amazon.com/inspector/v1/userguide/inspector-migration.html). 

List exclusions that are generated by the assessment run.

## Request Syntax
<a name="API_ListExclusions_RequestSyntax"></a>

```
{
   "assessmentRunArn": "string",
   "maxResults": number,
   "nextToken": "string"
}
```

## Request Parameters
<a name="API_ListExclusions_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [assessmentRunArn](#API_ListExclusions_RequestSyntax) **   <a name="Inspector-ListExclusions-request-assessmentRunArn"></a>
The ARN of the assessment run that generated the exclusions that you want to list.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 300.  
Required: Yes

 ** [maxResults](#API_ListExclusions_RequestSyntax) **   <a name="Inspector-ListExclusions-request-maxResults"></a>
You can use this parameter to indicate the maximum number of items you want in the response. The default value is 100. The maximum value is 500.  
Type: Integer  
Required: No

 ** [nextToken](#API_ListExclusions_RequestSyntax) **   <a name="Inspector-ListExclusions-request-nextToken"></a>
You can use this parameter when paginating results. Set the value of this parameter to null on your first call to the ListExclusionsRequest action. Subsequent calls to the action fill nextToken in the request with the value of nextToken from the previous response to continue listing data.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 300.  
Required: No

## Response Syntax
<a name="API_ListExclusions_ResponseSyntax"></a>

```
{
   "exclusionArns": [ "string" ],
   "nextToken": "string"
}
```

## Response Elements
<a name="API_ListExclusions_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [exclusionArns](#API_ListExclusions_ResponseSyntax) **   <a name="Inspector-ListExclusions-response-exclusionArns"></a>
A list of exclusions' ARNs returned by the action.  
Type: Array of strings  
Array Members: Minimum number of 0 items. Maximum number of 100 items.  
Length Constraints: Minimum length of 1. Maximum length of 300.

 ** [nextToken](#API_ListExclusions_ResponseSyntax) **   <a name="Inspector-ListExclusions-response-nextToken"></a>
When a response is generated, if there is more data to be listed, this parameters is present in the response and contains the value to use for the nextToken parameter in a subsequent pagination request. If there is no more data to be listed, this parameter is set to null.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 300.

## Errors
<a name="API_ListExclusions_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InternalException **   
Internal server error.    
 ** canRetry **   
You can immediately retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 500

 ** InvalidInputException **   
The request was rejected because an invalid or out-of-range value was supplied for an input parameter.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** NoSuchEntityException **   
The request was rejected because it referenced an entity that does not exist. The error code describes the entity.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

## See Also
<a name="API_ListExclusions_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/inspector-2016-02-16/ListExclusions) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/inspector-2016-02-16/ListExclusions) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/inspector-2016-02-16/ListExclusions) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/inspector-2016-02-16/ListExclusions) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/inspector-2016-02-16/ListExclusions) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/inspector-2016-02-16/ListExclusions) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/inspector-2016-02-16/ListExclusions) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/inspector-2016-02-16/ListExclusions) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/inspector-2016-02-16/ListExclusions) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/inspector-2016-02-16/ListExclusions) 

# ListFindings
<a name="API_ListFindings"></a>

**Important**  
End of support notice: On May 20, 2026, AWS will end support for (Amazon Inspector Classic). After May 20, 2026, you will no longer be able to access the Amazon Inspector Classic console or Amazon Inspector Classic resources. For more information, see [Amazon Inspector Classic end of support](https://docs.aws.amazon.com/inspector/v1/userguide/inspector-migration.html). 

Lists findings that are generated by the assessment runs that are specified by the ARNs of the assessment runs.

## Request Syntax
<a name="API_ListFindings_RequestSyntax"></a>

```
{
   "assessmentRunArns": [ "string" ],
   "filter": { 
      "agentIds": [ "string" ],
      "attributes": [ 
         { 
            "key": "string",
            "value": "string"
         }
      ],
      "autoScalingGroups": [ "string" ],
      "creationTimeRange": { 
         "beginDate": number,
         "endDate": number
      },
      "ruleNames": [ "string" ],
      "rulesPackageArns": [ "string" ],
      "severities": [ "string" ],
      "userAttributes": [ 
         { 
            "key": "string",
            "value": "string"
         }
      ]
   },
   "maxResults": number,
   "nextToken": "string"
}
```

## Request Parameters
<a name="API_ListFindings_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [assessmentRunArns](#API_ListFindings_RequestSyntax) **   <a name="Inspector-ListFindings-request-assessmentRunArns"></a>
The ARNs of the assessment runs that generate the findings that you want to list.  
Type: Array of strings  
Array Members: Minimum number of 0 items. Maximum number of 50 items.  
Length Constraints: Minimum length of 1. Maximum length of 300.  
Required: No

 ** [filter](#API_ListFindings_RequestSyntax) **   <a name="Inspector-ListFindings-request-filter"></a>
You can use this parameter to specify a subset of data to be included in the action's response.  
For a record to match a filter, all specified filter attributes must match. When multiple values are specified for a filter attribute, any of the values can match.  
Type: [FindingFilter](API_FindingFilter.md) object  
Required: No

 ** [maxResults](#API_ListFindings_RequestSyntax) **   <a name="Inspector-ListFindings-request-maxResults"></a>
You can use this parameter to indicate the maximum number of items you want in the response. The default value is 10. The maximum value is 500.  
Type: Integer  
Required: No

 ** [nextToken](#API_ListFindings_RequestSyntax) **   <a name="Inspector-ListFindings-request-nextToken"></a>
You can use this parameter when paginating results. Set the value of this parameter to null on your first call to the **ListFindings** action. Subsequent calls to the action fill **nextToken** in the request with the value of **NextToken** from the previous response to continue listing data.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 300.  
Required: No

## Response Syntax
<a name="API_ListFindings_ResponseSyntax"></a>

```
{
   "findingArns": [ "string" ],
   "nextToken": "string"
}
```

## Response Elements
<a name="API_ListFindings_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [findingArns](#API_ListFindings_ResponseSyntax) **   <a name="Inspector-ListFindings-response-findingArns"></a>
A list of ARNs that specifies the findings returned by the action.  
Type: Array of strings  
Array Members: Minimum number of 0 items. Maximum number of 100 items.  
Length Constraints: Minimum length of 1. Maximum length of 300.

 ** [nextToken](#API_ListFindings_ResponseSyntax) **   <a name="Inspector-ListFindings-response-nextToken"></a>
 When a response is generated, if there is more data to be listed, this parameter is present in the response and contains the value to use for the **nextToken** parameter in a subsequent pagination request. If there is no more data to be listed, this parameter is set to null.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 300.

## Errors
<a name="API_ListFindings_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InternalException **   
Internal server error.    
 ** canRetry **   
You can immediately retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 500

 ** InvalidInputException **   
The request was rejected because an invalid or out-of-range value was supplied for an input parameter.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** NoSuchEntityException **   
The request was rejected because it referenced an entity that does not exist. The error code describes the entity.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

## Examples
<a name="API_ListFindings_Examples"></a>

### Example
<a name="API_ListFindings_Example_1"></a>

This example illustrates one usage of ListFindings.

#### Sample Request
<a name="API_ListFindings_Example_1_Request"></a>

```
               
               POST / HTTP/1.1
               Host: inspector.us-west-2.amazonaws.com
               Accept-Encoding: identity
               Content-Length: 2
               X-Amz-Target: InspectorService.ListFindings
               X-Amz-Date: 20160323T203109Z
               User-Agent: aws-cli/1.10.12 Python/2.7.9 Windows/7 botocore/1.4.3
               Content-Type: application/x-amz-json-1.1
               Authorization: AUTHPARAMS
               {}
```

#### Sample Response
<a name="API_ListFindings_Example_1_Response"></a>

```
               
               HTTP/1.1 200 OK
               x-amzn-RequestId: 2df2e847-f136-11e5-b2c3-cd62ea256ca4
               Content-Type: application/x-amz-json-1.1
               Content-Length: 247
               Date: Wed, 23 Mar 2016 20:31:10 GMT
               {
                   "findingArns": [
                   "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE/finding/0-HwPnsDm4",
                   "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-v5D6fI3v/finding/0-tyvmqBLy"
                 ]
               }
```

## See Also
<a name="API_ListFindings_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/inspector-2016-02-16/ListFindings) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/inspector-2016-02-16/ListFindings) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/inspector-2016-02-16/ListFindings) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/inspector-2016-02-16/ListFindings) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/inspector-2016-02-16/ListFindings) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/inspector-2016-02-16/ListFindings) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/inspector-2016-02-16/ListFindings) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/inspector-2016-02-16/ListFindings) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/inspector-2016-02-16/ListFindings) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/inspector-2016-02-16/ListFindings) 

# ListRulesPackages
<a name="API_ListRulesPackages"></a>

**Important**  
End of support notice: On May 20, 2026, AWS will end support for (Amazon Inspector Classic). After May 20, 2026, you will no longer be able to access the Amazon Inspector Classic console or Amazon Inspector Classic resources. For more information, see [Amazon Inspector Classic end of support](https://docs.aws.amazon.com/inspector/v1/userguide/inspector-migration.html). 

Lists all available Amazon Inspector Classic rules packages.

## Request Syntax
<a name="API_ListRulesPackages_RequestSyntax"></a>

```
{
   "maxResults": number,
   "nextToken": "string"
}
```

## Request Parameters
<a name="API_ListRulesPackages_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [maxResults](#API_ListRulesPackages_RequestSyntax) **   <a name="Inspector-ListRulesPackages-request-maxResults"></a>
You can use this parameter to indicate the maximum number of items you want in the response. The default value is 10. The maximum value is 500.  
Type: Integer  
Required: No

 ** [nextToken](#API_ListRulesPackages_RequestSyntax) **   <a name="Inspector-ListRulesPackages-request-nextToken"></a>
You can use this parameter when paginating results. Set the value of this parameter to null on your first call to the **ListRulesPackages** action. Subsequent calls to the action fill **nextToken** in the request with the value of **NextToken** from the previous response to continue listing data.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 300.  
Required: No

## Response Syntax
<a name="API_ListRulesPackages_ResponseSyntax"></a>

```
{
   "nextToken": "string",
   "rulesPackageArns": [ "string" ]
}
```

## Response Elements
<a name="API_ListRulesPackages_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [nextToken](#API_ListRulesPackages_ResponseSyntax) **   <a name="Inspector-ListRulesPackages-response-nextToken"></a>
 When a response is generated, if there is more data to be listed, this parameter is present in the response and contains the value to use for the **nextToken** parameter in a subsequent pagination request. If there is no more data to be listed, this parameter is set to null.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 300.

 ** [rulesPackageArns](#API_ListRulesPackages_ResponseSyntax) **   <a name="Inspector-ListRulesPackages-response-rulesPackageArns"></a>
The list of ARNs that specifies the rules packages returned by the action.  
Type: Array of strings  
Array Members: Minimum number of 0 items. Maximum number of 100 items.  
Length Constraints: Minimum length of 1. Maximum length of 300.

## Errors
<a name="API_ListRulesPackages_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InternalException **   
Internal server error.    
 ** canRetry **   
You can immediately retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 500

 ** InvalidInputException **   
The request was rejected because an invalid or out-of-range value was supplied for an input parameter.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

## Examples
<a name="API_ListRulesPackages_Examples"></a>

### Example
<a name="API_ListRulesPackages_Example_1"></a>

This example illustrates one usage of ListRulesPackages.

#### Sample Request
<a name="API_ListRulesPackages_Example_1_Request"></a>

```
               
                  POST / HTTP/1.1
                  Host: inspector.us-west-2.amazonaws.com
                  Accept-Encoding: identity
                  Content-Length: 2
                  X-Amz-Target: InspectorService.ListRulesPackages
                  X-Amz-Date: 20160323T203727Z
                  User-Agent: aws-cli/1.10.12 Python/2.7.9 Windows/7 botocore/1.4.3
                  Content-Type: application/x-amz-json-1.1
                  Authorization: AUTHPARAMS
                  {}
```

#### Sample Response
<a name="API_ListRulesPackages_Example_1_Response"></a>

```
               
                  HTTP/1.1 200 OK
                  x-amzn-RequestId: 0e3779a9-f137-11e5-be28-e130082e2a98
                  Content-Type: application/x-amz-json-1.1
                  Content-Length: 424
                  Date: Wed, 23 Mar 2016 20:37:26 GMT
                  {
                    "rulesPackageArns": [
                      "arn:aws:inspector:us-west-2:758058086616:rulespackage/0-9hgA516p",
                      "arn:aws:inspector:us-west-2:758058086616:rulespackage/0-H5hpSawc",
                      "arn:aws:inspector:us-west-2:758058086616:rulespackage/0-JJOtZiqQ",
                      "arn:aws:inspector:us-west-2:758058086616:rulespackage/0-vg5GGHSD"
                    ]
                  }
```

## See Also
<a name="API_ListRulesPackages_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/inspector-2016-02-16/ListRulesPackages) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/inspector-2016-02-16/ListRulesPackages) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/inspector-2016-02-16/ListRulesPackages) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/inspector-2016-02-16/ListRulesPackages) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/inspector-2016-02-16/ListRulesPackages) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/inspector-2016-02-16/ListRulesPackages) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/inspector-2016-02-16/ListRulesPackages) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/inspector-2016-02-16/ListRulesPackages) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/inspector-2016-02-16/ListRulesPackages) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/inspector-2016-02-16/ListRulesPackages) 

# ListTagsForResource
<a name="API_ListTagsForResource"></a>

**Important**  
End of support notice: On May 20, 2026, AWS will end support for (Amazon Inspector Classic). After May 20, 2026, you will no longer be able to access the Amazon Inspector Classic console or Amazon Inspector Classic resources. For more information, see [Amazon Inspector Classic end of support](https://docs.aws.amazon.com/inspector/v1/userguide/inspector-migration.html). 

Lists all tags associated with an assessment template.

## Request Syntax
<a name="API_ListTagsForResource_RequestSyntax"></a>

```
{
   "resourceArn": "string"
}
```

## Request Parameters
<a name="API_ListTagsForResource_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [resourceArn](#API_ListTagsForResource_RequestSyntax) **   <a name="Inspector-ListTagsForResource-request-resourceArn"></a>
The ARN that specifies the assessment template whose tags you want to list.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 300.  
Required: Yes

## Response Syntax
<a name="API_ListTagsForResource_ResponseSyntax"></a>

```
{
   "tags": [ 
      { 
         "key": "string",
         "value": "string"
      }
   ]
}
```

## Response Elements
<a name="API_ListTagsForResource_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [tags](#API_ListTagsForResource_ResponseSyntax) **   <a name="Inspector-ListTagsForResource-response-tags"></a>
A collection of key and value pairs.  
Type: Array of [Tag](API_Tag.md) objects  
Array Members: Minimum number of 0 items. Maximum number of 10 items.

## Errors
<a name="API_ListTagsForResource_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InternalException **   
Internal server error.    
 ** canRetry **   
You can immediately retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 500

 ** InvalidInputException **   
The request was rejected because an invalid or out-of-range value was supplied for an input parameter.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** NoSuchEntityException **   
The request was rejected because it referenced an entity that does not exist. The error code describes the entity.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

## Examples
<a name="API_ListTagsForResource_Examples"></a>

### Example
<a name="API_ListTagsForResource_Example_1"></a>

This example illustrates one usage of ListTagsForResource.

#### Sample Request
<a name="API_ListTagsForResource_Example_1_Request"></a>

```
               
               POST / HTTP/1.1
               Host: inspector.us-west-2.amazonaws.com
               Accept-Encoding: identity
               Content-Length: 97
               X-Amz-Target: InspectorService.ListTagsForResource
               X-Amz-Date: 20160323T212838Z
               User-Agent: aws-cli/1.10.12 Python/2.7.9 Windows/7 botocore/1.4.3
               Content-Type: application/x-amz-json-1.1
               Authorization: AUTHPARAMS    
               {
                 "resourceArn": "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-gcwFliYu"
               }
```

#### Sample Response
<a name="API_ListTagsForResource_Example_1_Response"></a>

```
               
               HTTP/1.1 200 OK
               x-amzn-RequestId: 3580d562-f13e-11e5-8a9a-395a36305628
               Content-Type: application/x-amz-json-1.1
               Content-Length: 50
               Date: Wed, 23 Mar 2016 21:28:39 GMT
               {
                 "tags": [
                   {
                     "key": "Name",
                     "value": "Example"
                   }
                 ]
               }
```

## See Also
<a name="API_ListTagsForResource_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/inspector-2016-02-16/ListTagsForResource) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/inspector-2016-02-16/ListTagsForResource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/inspector-2016-02-16/ListTagsForResource) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/inspector-2016-02-16/ListTagsForResource) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/inspector-2016-02-16/ListTagsForResource) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/inspector-2016-02-16/ListTagsForResource) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/inspector-2016-02-16/ListTagsForResource) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/inspector-2016-02-16/ListTagsForResource) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/inspector-2016-02-16/ListTagsForResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/inspector-2016-02-16/ListTagsForResource) 

# PreviewAgents
<a name="API_PreviewAgents"></a>

**Important**  
End of support notice: On May 20, 2026, AWS will end support for (Amazon Inspector Classic). After May 20, 2026, you will no longer be able to access the Amazon Inspector Classic console or Amazon Inspector Classic resources. For more information, see [Amazon Inspector Classic end of support](https://docs.aws.amazon.com/inspector/v1/userguide/inspector-migration.html). 

Previews the agents installed on the EC2 instances that are part of the specified assessment target.

## Request Syntax
<a name="API_PreviewAgents_RequestSyntax"></a>

```
{
   "maxResults": number,
   "nextToken": "string",
   "previewAgentsArn": "string"
}
```

## Request Parameters
<a name="API_PreviewAgents_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [maxResults](#API_PreviewAgents_RequestSyntax) **   <a name="Inspector-PreviewAgents-request-maxResults"></a>
You can use this parameter to indicate the maximum number of items you want in the response. The default value is 10. The maximum value is 500.  
Type: Integer  
Required: No

 ** [nextToken](#API_PreviewAgents_RequestSyntax) **   <a name="Inspector-PreviewAgents-request-nextToken"></a>
You can use this parameter when paginating results. Set the value of this parameter to null on your first call to the **PreviewAgents** action. Subsequent calls to the action fill **nextToken** in the request with the value of **NextToken** from the previous response to continue listing data.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 300.  
Required: No

 ** [previewAgentsArn](#API_PreviewAgents_RequestSyntax) **   <a name="Inspector-PreviewAgents-request-previewAgentsArn"></a>
The ARN of the assessment target whose agents you want to preview.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 300.  
Required: Yes

## Response Syntax
<a name="API_PreviewAgents_ResponseSyntax"></a>

```
{
   "agentPreviews": [ 
      { 
         "agentHealth": "string",
         "agentId": "string",
         "agentVersion": "string",
         "autoScalingGroup": "string",
         "hostname": "string",
         "ipv4Address": "string",
         "kernelVersion": "string",
         "operatingSystem": "string"
      }
   ],
   "nextToken": "string"
}
```

## Response Elements
<a name="API_PreviewAgents_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [agentPreviews](#API_PreviewAgents_ResponseSyntax) **   <a name="Inspector-PreviewAgents-response-agentPreviews"></a>
The resulting list of agents.  
Type: Array of [AgentPreview](API_AgentPreview.md) objects  
Array Members: Minimum number of 0 items. Maximum number of 100 items.

 ** [nextToken](#API_PreviewAgents_ResponseSyntax) **   <a name="Inspector-PreviewAgents-response-nextToken"></a>
 When a response is generated, if there is more data to be listed, this parameter is present in the response and contains the value to use for the **nextToken** parameter in a subsequent pagination request. If there is no more data to be listed, this parameter is set to null.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 300.

## Errors
<a name="API_PreviewAgents_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InternalException **   
Internal server error.    
 ** canRetry **   
You can immediately retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 500

 ** InvalidCrossAccountRoleException **   
Amazon Inspector Classic cannot assume the cross-account role that it needs to list your EC2 instances during the assessment run.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** InvalidInputException **   
The request was rejected because an invalid or out-of-range value was supplied for an input parameter.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** NoSuchEntityException **   
The request was rejected because it referenced an entity that does not exist. The error code describes the entity.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

## Examples
<a name="API_PreviewAgents_Examples"></a>

### Example
<a name="API_PreviewAgents_Example_1"></a>

This example illustrates one usage of PreviewAgents.

#### Sample Request
<a name="API_PreviewAgents_Example_1_Request"></a>

```
               
                  POST / HTTP/1.1
                  Host: inspector.us-west-2.amazonaws.com
                  Accept-Encoding: identity
                  Content-Length: 82
                  X-Amz-Target: InspectorService.PreviewAgents
                  X-Amz-Date: 20160329T224634Z
                  User-Agent: aws-cli/1.10.12 Python/2.7.9 Windows/7 botocore/1.4.3
                  Content-Type: application/x-amz-json-1.1
                  Authorization: AUTHPARAMS
                  {
                    "previewAgentsArn": "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq"
                  }
```

#### Sample Response
<a name="API_PreviewAgents_Example_1_Response"></a>

```
               
                  HTTP/1.1 200 OK
                  x-amzn-RequestId: 176c8915-f600-11e5-ac8a-bb6015f4022c
                  Content-Type: application/x-amz-json-1.1
                  Content-Length: 44
                  Date: Tue, 29 Mar 2016 22:46:36 GMT
                  {
                    "agentPreviews": [
                      {
                        "hostname": "example",
                        "agentId": "i-49113b93",
                        "autoScalingGroup": "example",
                        "agentHealth": HEALTHY,
                        "agentVersion": "exampleversion",
                        "operatingSystem": "exampleOS",
                        "kernelVersion": "examplekernelversion",
                        "ipv4Address": "example"
                      }
                    ]
                  }
```

## See Also
<a name="API_PreviewAgents_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/inspector-2016-02-16/PreviewAgents) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/inspector-2016-02-16/PreviewAgents) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/inspector-2016-02-16/PreviewAgents) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/inspector-2016-02-16/PreviewAgents) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/inspector-2016-02-16/PreviewAgents) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/inspector-2016-02-16/PreviewAgents) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/inspector-2016-02-16/PreviewAgents) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/inspector-2016-02-16/PreviewAgents) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/inspector-2016-02-16/PreviewAgents) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/inspector-2016-02-16/PreviewAgents) 

# RegisterCrossAccountAccessRole
<a name="API_RegisterCrossAccountAccessRole"></a>

**Important**  
End of support notice: On May 20, 2026, AWS will end support for (Amazon Inspector Classic). After May 20, 2026, you will no longer be able to access the Amazon Inspector Classic console or Amazon Inspector Classic resources. For more information, see [Amazon Inspector Classic end of support](https://docs.aws.amazon.com/inspector/v1/userguide/inspector-migration.html). 

Registers the IAM role that grants Amazon Inspector Classic access to AWS Services needed to perform security assessments.

## Request Syntax
<a name="API_RegisterCrossAccountAccessRole_RequestSyntax"></a>

```
{
   "roleArn": "string"
}
```

## Request Parameters
<a name="API_RegisterCrossAccountAccessRole_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [roleArn](#API_RegisterCrossAccountAccessRole_RequestSyntax) **   <a name="Inspector-RegisterCrossAccountAccessRole-request-roleArn"></a>
The ARN of the IAM role that grants Amazon Inspector Classic access to AWS Services needed to perform security assessments.   
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 300.  
Required: Yes

## Response Elements
<a name="API_RegisterCrossAccountAccessRole_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_RegisterCrossAccountAccessRole_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InternalException **   
Internal server error.    
 ** canRetry **   
You can immediately retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 500

 ** InvalidCrossAccountRoleException **   
Amazon Inspector Classic cannot assume the cross-account role that it needs to list your EC2 instances during the assessment run.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** InvalidInputException **   
The request was rejected because an invalid or out-of-range value was supplied for an input parameter.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** ServiceTemporarilyUnavailableException **   
The serice is temporary unavailable.    
 ** canRetry **   
You can wait and then retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

## Examples
<a name="API_RegisterCrossAccountAccessRole_Examples"></a>

### Example
<a name="API_RegisterCrossAccountAccessRole_Example_1"></a>

This example illustrates one usage of RegisterCrossAccountAccessRole.

#### Sample Request
<a name="API_RegisterCrossAccountAccessRole_Example_1_Request"></a>

```
               
                  POST / HTTP/1.1
                  Host: inspector.us-west-2.amazonaws.com
                  Accept-Encoding: identity
                  Content-Length: 55
                  X-Amz-Target: InspectorService.RegisterCrossAccountAccessRole
                  X-Amz-Date: 20160329T225544Z
                  User-Agent: aws-cli/1.10.12 Python/2.7.9 Windows/7 botocore/1.4.3
                  Content-Type: application/x-amz-json-1.1
                  Authorization: AUTHPARAMS
                  
                  {
                    "roleArn": "arn:aws:iam::123456789012:role/inspector"
                  }
```

#### Sample Response
<a name="API_RegisterCrossAccountAccessRole_Example_1_Response"></a>

```
               
                  HTTP/1.1 200 OK
                  x-amzn-RequestId: 5f553cfa-f601-11e5-a47c-b7e2de2d572c
                  Content-Type: application/x-amz-json-1.1
                  Content-Length: 0
                  Date: Tue, 29 Mar 2016 22:55:46 GMT
```

## See Also
<a name="API_RegisterCrossAccountAccessRole_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/inspector-2016-02-16/RegisterCrossAccountAccessRole) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/inspector-2016-02-16/RegisterCrossAccountAccessRole) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/inspector-2016-02-16/RegisterCrossAccountAccessRole) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/inspector-2016-02-16/RegisterCrossAccountAccessRole) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/inspector-2016-02-16/RegisterCrossAccountAccessRole) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/inspector-2016-02-16/RegisterCrossAccountAccessRole) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/inspector-2016-02-16/RegisterCrossAccountAccessRole) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/inspector-2016-02-16/RegisterCrossAccountAccessRole) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/inspector-2016-02-16/RegisterCrossAccountAccessRole) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/inspector-2016-02-16/RegisterCrossAccountAccessRole) 

# RemoveAttributesFromFindings
<a name="API_RemoveAttributesFromFindings"></a>

**Important**  
End of support notice: On May 20, 2026, AWS will end support for (Amazon Inspector Classic). After May 20, 2026, you will no longer be able to access the Amazon Inspector Classic console or Amazon Inspector Classic resources. For more information, see [Amazon Inspector Classic end of support](https://docs.aws.amazon.com/inspector/v1/userguide/inspector-migration.html). 

Removes entire attributes (key and value pairs) from the findings that are specified by the ARNs of the findings where an attribute with the specified key exists.

## Request Syntax
<a name="API_RemoveAttributesFromFindings_RequestSyntax"></a>

```
{
   "attributeKeys": [ "string" ],
   "findingArns": [ "string" ]
}
```

## Request Parameters
<a name="API_RemoveAttributesFromFindings_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [attributeKeys](#API_RemoveAttributesFromFindings_RequestSyntax) **   <a name="Inspector-RemoveAttributesFromFindings-request-attributeKeys"></a>
The array of attribute keys that you want to remove from specified findings.  
Type: Array of strings  
Array Members: Minimum number of 0 items. Maximum number of 10 items.  
Length Constraints: Minimum length of 1. Maximum length of 128.  
Required: Yes

 ** [findingArns](#API_RemoveAttributesFromFindings_RequestSyntax) **   <a name="Inspector-RemoveAttributesFromFindings-request-findingArns"></a>
The ARNs that specify the findings that you want to remove attributes from.  
Type: Array of strings  
Array Members: Minimum number of 1 item. Maximum number of 10 items.  
Length Constraints: Minimum length of 1. Maximum length of 300.  
Required: Yes

## Response Syntax
<a name="API_RemoveAttributesFromFindings_ResponseSyntax"></a>

```
{
   "failedItems": { 
      "string" : { 
         "failureCode": "string",
         "retryable": boolean
      }
   }
}
```

## Response Elements
<a name="API_RemoveAttributesFromFindings_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [failedItems](#API_RemoveAttributesFromFindings_ResponseSyntax) **   <a name="Inspector-RemoveAttributesFromFindings-response-failedItems"></a>
Attributes details that cannot be described. An error code is provided for each failed item.  
Type: String to [FailedItemDetails](API_FailedItemDetails.md) object map  
Key Length Constraints: Minimum length of 1. Maximum length of 300.

## Errors
<a name="API_RemoveAttributesFromFindings_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InternalException **   
Internal server error.    
 ** canRetry **   
You can immediately retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 500

 ** InvalidInputException **   
The request was rejected because an invalid or out-of-range value was supplied for an input parameter.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** NoSuchEntityException **   
The request was rejected because it referenced an entity that does not exist. The error code describes the entity.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** ServiceTemporarilyUnavailableException **   
The serice is temporary unavailable.    
 ** canRetry **   
You can wait and then retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

## Examples
<a name="API_RemoveAttributesFromFindings_Examples"></a>

### Example
<a name="API_RemoveAttributesFromFindings_Example_1"></a>

This example illustrates one usage of RemoveAttributesFromFindings.

#### Sample Request
<a name="API_RemoveAttributesFromFindings_Example_1_Request"></a>

```
               
                  POST / HTTP/1.1
                  Host: inspector.us-west-2.amazonaws.com
                  Accept-Encoding: identity
                  Content-Length: 181
                  X-Amz-Target: InspectorService.RemoveAttributesFromFindings
                  X-Amz-Date: 20160329T234159Z
                  User-Agent: aws-cli/1.10.12 Python/2.7.9 Windows/7 botocore/1.4.3
                  Content-Type: application/x-amz-json-1.1
                  Authorization: AUTHPARAMS
                  {
                    "attributeKeys": [
                      "key=Example,value=example"
                    ],
                    "findingArns": [
                      "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-8l1VIE0D/run/0-Z02cjjug/finding/0-T8yM9mEU"
                    ]
                  }
```

#### Sample Response
<a name="API_RemoveAttributesFromFindings_Example_1_Response"></a>

```
               
                  HTTP/1.1 200 OK
                  x-amzn-RequestId: d4ebb8cf-f607-11e5-94d7-d9eab7a1ae2a
                  Content-Type: application/x-amz-json-1.1
                  Content-Length: 18
                  Date: Tue, 29 Mar 2016 23:42:00 GMT
                  {
                    "failedItems": {}
                  }
```

## See Also
<a name="API_RemoveAttributesFromFindings_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/inspector-2016-02-16/RemoveAttributesFromFindings) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/inspector-2016-02-16/RemoveAttributesFromFindings) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/inspector-2016-02-16/RemoveAttributesFromFindings) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/inspector-2016-02-16/RemoveAttributesFromFindings) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/inspector-2016-02-16/RemoveAttributesFromFindings) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/inspector-2016-02-16/RemoveAttributesFromFindings) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/inspector-2016-02-16/RemoveAttributesFromFindings) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/inspector-2016-02-16/RemoveAttributesFromFindings) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/inspector-2016-02-16/RemoveAttributesFromFindings) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/inspector-2016-02-16/RemoveAttributesFromFindings) 

# SetTagsForResource
<a name="API_SetTagsForResource"></a>

**Important**  
End of support notice: On May 20, 2026, AWS will end support for (Amazon Inspector Classic). After May 20, 2026, you will no longer be able to access the Amazon Inspector Classic console or Amazon Inspector Classic resources. For more information, see [Amazon Inspector Classic end of support](https://docs.aws.amazon.com/inspector/v1/userguide/inspector-migration.html). 

Sets tags (key and value pairs) to the assessment template that is specified by the ARN of the assessment template.

## Request Syntax
<a name="API_SetTagsForResource_RequestSyntax"></a>

```
{
   "resourceArn": "string",
   "tags": [ 
      { 
         "key": "string",
         "value": "string"
      }
   ]
}
```

## Request Parameters
<a name="API_SetTagsForResource_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [resourceArn](#API_SetTagsForResource_RequestSyntax) **   <a name="Inspector-SetTagsForResource-request-resourceArn"></a>
The ARN of the assessment template that you want to set tags to.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 300.  
Required: Yes

 ** [tags](#API_SetTagsForResource_RequestSyntax) **   <a name="Inspector-SetTagsForResource-request-tags"></a>
A collection of key and value pairs that you want to set to the assessment template.  
Type: Array of [Tag](API_Tag.md) objects  
Array Members: Minimum number of 0 items. Maximum number of 10 items.  
Required: No

## Response Elements
<a name="API_SetTagsForResource_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_SetTagsForResource_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InternalException **   
Internal server error.    
 ** canRetry **   
You can immediately retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 500

 ** InvalidInputException **   
The request was rejected because an invalid or out-of-range value was supplied for an input parameter.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** NoSuchEntityException **   
The request was rejected because it referenced an entity that does not exist. The error code describes the entity.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** ServiceTemporarilyUnavailableException **   
The serice is temporary unavailable.    
 ** canRetry **   
You can wait and then retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

## Examples
<a name="API_SetTagsForResource_Examples"></a>

### Example
<a name="API_SetTagsForResource_Example_1"></a>

This example illustrates one usage of SetTagsForResource.

#### Sample Request
<a name="API_SetTagsForResource_Example_1_Request"></a>

```
               
                  POST / HTTP/1.1
                  Host: inspector.us-west-2.amazonaws.com
                  Accept-Encoding: identity
                  Content-Length: 144
                  X-Amz-Target: InspectorService.SetTagsForResource
                  X-Amz-Date: 20160331T185018Z
                  User-Agent: aws-cli/1.10.12 Python/2.7.9 Windows/7 botocore/1.4.3
                  Content-Type: application/x-amz-json-1.1
                  Authorization: AUTHPARAMS
                  {
                    "resourceArn": "arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-7sbz2Kz0",
                    "tags": [
                      {
                        "key": "Example",
                        "value": "example"
                      }
                    ]
                  }
```

#### Sample Response
<a name="API_SetTagsForResource_Example_1_Response"></a>

```
               
                  HTTP/1.1 200 OK
                  x-amzn-RequestId: 6a3f5af3-f771-11e5-8599-f1b50afafb5a
                  Content-Type: application/x-amz-json-1.1
                  Content-Length: 0
                  Date: Thu, 31 Mar 2016 18:50:18 GMT
```

## See Also
<a name="API_SetTagsForResource_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/inspector-2016-02-16/SetTagsForResource) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/inspector-2016-02-16/SetTagsForResource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/inspector-2016-02-16/SetTagsForResource) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/inspector-2016-02-16/SetTagsForResource) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/inspector-2016-02-16/SetTagsForResource) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/inspector-2016-02-16/SetTagsForResource) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/inspector-2016-02-16/SetTagsForResource) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/inspector-2016-02-16/SetTagsForResource) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/inspector-2016-02-16/SetTagsForResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/inspector-2016-02-16/SetTagsForResource) 

# StartAssessmentRun
<a name="API_StartAssessmentRun"></a>

**Important**  
End of support notice: On May 20, 2026, AWS will end support for (Amazon Inspector Classic). After May 20, 2026, you will no longer be able to access the Amazon Inspector Classic console or Amazon Inspector Classic resources. For more information, see [Amazon Inspector Classic end of support](https://docs.aws.amazon.com/inspector/v1/userguide/inspector-migration.html). 

Starts the assessment run specified by the ARN of the assessment template. For this API to function properly, you must not exceed the limit of running up to 500 concurrent agents per AWS account.

## Request Syntax
<a name="API_StartAssessmentRun_RequestSyntax"></a>

```
{
   "assessmentRunName": "string",
   "assessmentTemplateArn": "string"
}
```

## Request Parameters
<a name="API_StartAssessmentRun_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [assessmentRunName](#API_StartAssessmentRun_RequestSyntax) **   <a name="Inspector-StartAssessmentRun-request-assessmentRunName"></a>
You can specify the name for the assessment run. The name must be unique for the assessment template whose ARN is used to start the assessment run.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 140.  
Required: No

 ** [assessmentTemplateArn](#API_StartAssessmentRun_RequestSyntax) **   <a name="Inspector-StartAssessmentRun-request-assessmentTemplateArn"></a>
The ARN of the assessment template of the assessment run that you want to start.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 300.  
Required: Yes

## Response Syntax
<a name="API_StartAssessmentRun_ResponseSyntax"></a>

```
{
   "assessmentRunArn": "string"
}
```

## Response Elements
<a name="API_StartAssessmentRun_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [assessmentRunArn](#API_StartAssessmentRun_ResponseSyntax) **   <a name="Inspector-StartAssessmentRun-response-assessmentRunArn"></a>
The ARN of the assessment run that has been started.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 300.

## Errors
<a name="API_StartAssessmentRun_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AgentsAlreadyRunningAssessmentException **   
You started an assessment run, but one of the instances is already participating in another assessment run.    
 ** agents **   
  
 ** agentsTruncated **   
  
 ** canRetry **   
You can immediately retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** InternalException **   
Internal server error.    
 ** canRetry **   
You can immediately retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 500

 ** InvalidCrossAccountRoleException **   
Amazon Inspector Classic cannot assume the cross-account role that it needs to list your EC2 instances during the assessment run.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** InvalidInputException **   
The request was rejected because an invalid or out-of-range value was supplied for an input parameter.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** LimitExceededException **   
The request was rejected because it attempted to create resources beyond the current AWS account limits. The error code describes the limit exceeded.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** NoSuchEntityException **   
The request was rejected because it referenced an entity that does not exist. The error code describes the entity.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** ServiceTemporarilyUnavailableException **   
The serice is temporary unavailable.    
 ** canRetry **   
You can wait and then retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

## Examples
<a name="API_StartAssessmentRun_Examples"></a>

### Example
<a name="API_StartAssessmentRun_Example_1"></a>

This example illustrates one usage of StartAssessmentRun.

#### Sample Request
<a name="API_StartAssessmentRun_Example_1_Request"></a>

```
               
                  POST / HTTP/1.1
                  Host: inspector.us-west-2.amazonaws.com
                  Accept-Encoding: identity
                  Content-Length: 142
                  X-Amz-Target: InspectorService.StartAssessmentRun
                  X-Amz-Date: 20160331T182519Z
                  User-Agent: aws-cli/1.10.12 Python/2.7.9 Windows/7 botocore/1.4.3
                  Content-Type: application/x-amz-json-1.1
                  Authorization: AUTHPARAMS
                  {
                    "assessmentRunName": "examplerun",
                    "assessmentTemplateArn": "arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-it5r2S4T"
                  }
```

#### Sample Response
<a name="API_StartAssessmentRun_Example_1_Response"></a>

```
               
                  HTTP/1.1 200 OK
                  x-amzn-RequestId: ed349455-f76d-11e5-b473-ed8493878c40
                  Content-Type: application/x-amz-json-1.1
                  Content-Length: 116
                  Date: Thu, 31 Mar 2016 18:25:22 GMT
                  {
                    "assessmentRunArn": "arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-it5r2S4T/run/0-jOoroxyY"
                  }
```

## See Also
<a name="API_StartAssessmentRun_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/inspector-2016-02-16/StartAssessmentRun) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/inspector-2016-02-16/StartAssessmentRun) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/inspector-2016-02-16/StartAssessmentRun) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/inspector-2016-02-16/StartAssessmentRun) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/inspector-2016-02-16/StartAssessmentRun) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/inspector-2016-02-16/StartAssessmentRun) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/inspector-2016-02-16/StartAssessmentRun) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/inspector-2016-02-16/StartAssessmentRun) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/inspector-2016-02-16/StartAssessmentRun) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/inspector-2016-02-16/StartAssessmentRun) 

# StopAssessmentRun
<a name="API_StopAssessmentRun"></a>

**Important**  
End of support notice: On May 20, 2026, AWS will end support for (Amazon Inspector Classic). After May 20, 2026, you will no longer be able to access the Amazon Inspector Classic console or Amazon Inspector Classic resources. For more information, see [Amazon Inspector Classic end of support](https://docs.aws.amazon.com/inspector/v1/userguide/inspector-migration.html). 

Stops the assessment run that is specified by the ARN of the assessment run.

## Request Syntax
<a name="API_StopAssessmentRun_RequestSyntax"></a>

```
{
   "assessmentRunArn": "string",
   "stopAction": "string"
}
```

## Request Parameters
<a name="API_StopAssessmentRun_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [assessmentRunArn](#API_StopAssessmentRun_RequestSyntax) **   <a name="Inspector-StopAssessmentRun-request-assessmentRunArn"></a>
The ARN of the assessment run that you want to stop.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 300.  
Required: Yes

 ** [stopAction](#API_StopAssessmentRun_RequestSyntax) **   <a name="Inspector-StopAssessmentRun-request-stopAction"></a>
An input option that can be set to either START\$1EVALUATION or SKIP\$1EVALUATION. START\$1EVALUATION (the default value), stops the AWS agent from collecting data and begins the results evaluation and the findings generation process. SKIP\$1EVALUATION cancels the assessment run immediately, after which no findings are generated.  
Type: String  
Valid Values: `START_EVALUATION | SKIP_EVALUATION`   
Required: No

## Response Elements
<a name="API_StopAssessmentRun_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_StopAssessmentRun_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InternalException **   
Internal server error.    
 ** canRetry **   
You can immediately retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 500

 ** InvalidInputException **   
The request was rejected because an invalid or out-of-range value was supplied for an input parameter.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** NoSuchEntityException **   
The request was rejected because it referenced an entity that does not exist. The error code describes the entity.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** ServiceTemporarilyUnavailableException **   
The serice is temporary unavailable.    
 ** canRetry **   
You can wait and then retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

## Examples
<a name="API_StopAssessmentRun_Examples"></a>

### Example
<a name="API_StopAssessmentRun_Example_1"></a>

This example illustrates one usage of StopAssessmentRun.

#### Sample Request
<a name="API_StopAssessmentRun_Example_1_Request"></a>

```
               
                  POST / HTTP/1.1
                  Host: inspector.us-west-2.amazonaws.com
                  Accept-Encoding: identity
                  Content-Length: 117
                  X-Amz-Target: InspectorService.StopAssessmentRun
                  X-Amz-Date: 20160331T183401Z
                  User-Agent: aws-cli/1.10.12 Python/2.7.9 Windows/7 botocore/1.4.3
                  Content-Type: application/x-amz-json-1.1
                  Authorization: AUTHPARAMS
                  {
                    "assessmentRunArn": "arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-it5r2S4T/run/0-11LMTAVe"
                  }
```

#### Sample Response
<a name="API_StopAssessmentRun_Example_1_Response"></a>

```
               
                  HTTP/1.1 200 OK
                  x-amzn-RequestId: 23e1a935-f76f-11e5-92d3-7ba54a65df23
                  Content-Type: application/x-amz-json-1.1
                  Content-Length: 0
                  Date: Thu, 31 Mar 2016 18:34:02 GMT
```

## See Also
<a name="API_StopAssessmentRun_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/inspector-2016-02-16/StopAssessmentRun) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/inspector-2016-02-16/StopAssessmentRun) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/inspector-2016-02-16/StopAssessmentRun) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/inspector-2016-02-16/StopAssessmentRun) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/inspector-2016-02-16/StopAssessmentRun) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/inspector-2016-02-16/StopAssessmentRun) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/inspector-2016-02-16/StopAssessmentRun) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/inspector-2016-02-16/StopAssessmentRun) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/inspector-2016-02-16/StopAssessmentRun) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/inspector-2016-02-16/StopAssessmentRun) 

# SubscribeToEvent
<a name="API_SubscribeToEvent"></a>

**Important**  
End of support notice: On May 20, 2026, AWS will end support for (Amazon Inspector Classic). After May 20, 2026, you will no longer be able to access the Amazon Inspector Classic console or Amazon Inspector Classic resources. For more information, see [Amazon Inspector Classic end of support](https://docs.aws.amazon.com/inspector/v1/userguide/inspector-migration.html). 

Enables the process of sending Amazon Simple Notification Service (SNS) notifications about a specified event to a specified SNS topic.

## Request Syntax
<a name="API_SubscribeToEvent_RequestSyntax"></a>

```
{
   "event": "string",
   "resourceArn": "string",
   "topicArn": "string"
}
```

## Request Parameters
<a name="API_SubscribeToEvent_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [event](#API_SubscribeToEvent_RequestSyntax) **   <a name="Inspector-SubscribeToEvent-request-event"></a>
The event for which you want to receive SNS notifications.  
Type: String  
Valid Values: `ASSESSMENT_RUN_STARTED | ASSESSMENT_RUN_COMPLETED | ASSESSMENT_RUN_STATE_CHANGED | FINDING_REPORTED | OTHER`   
Required: Yes

 ** [resourceArn](#API_SubscribeToEvent_RequestSyntax) **   <a name="Inspector-SubscribeToEvent-request-resourceArn"></a>
The ARN of the assessment template that is used during the event for which you want to receive SNS notifications.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 300.  
Required: Yes

 ** [topicArn](#API_SubscribeToEvent_RequestSyntax) **   <a name="Inspector-SubscribeToEvent-request-topicArn"></a>
The ARN of the SNS topic to which the SNS notifications are sent.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 300.  
Required: Yes

## Response Elements
<a name="API_SubscribeToEvent_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_SubscribeToEvent_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InternalException **   
Internal server error.    
 ** canRetry **   
You can immediately retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 500

 ** InvalidInputException **   
The request was rejected because an invalid or out-of-range value was supplied for an input parameter.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** LimitExceededException **   
The request was rejected because it attempted to create resources beyond the current AWS account limits. The error code describes the limit exceeded.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** NoSuchEntityException **   
The request was rejected because it referenced an entity that does not exist. The error code describes the entity.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** ServiceTemporarilyUnavailableException **   
The serice is temporary unavailable.    
 ** canRetry **   
You can wait and then retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

## Examples
<a name="API_SubscribeToEvent_Examples"></a>

### Example
<a name="API_SubscribeToEvent_Example_1"></a>

This example illustrates one usage of SubscribeToEvent.

#### Sample Request
<a name="API_SubscribeToEvent_Example_1_Request"></a>

```
               
                  POST / HTTP/1.1
                  Host: inspector.us-west-2.amazonaws.com
                  Accept-Encoding: identity
                  Content-Length: 200
                  X-Amz-Target: InspectorService.SubscribeToEvent
                  X-Amz-Date: 20160331T201719Z
                  User-Agent: aws-cli/1.10.12 Python/2.7.9 Windows/7 botocore/1.4.3
                  Content-Type: application/x-amz-json-1.1
                  Authorization: AUTHPARAMS
                  {
                    "resourceArn": "arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-7sbz2Kz0",
                    "event": "ASSESSMENT_RUN_COMPLETED",
                    "topicArn": "arn:aws:sns:us-west-2:123456789012:exampletopic"
                  }
```

#### Sample Response
<a name="API_SubscribeToEvent_Example_1_Response"></a>

```
               
                  HTTP/1.1 200 OK
                  x-amzn-RequestId: 929b6c44-f77d-11e5-bcc6-cd3a7bd10be0
                  Content-Type: application/x-amz-json-1.1
                  Content-Length: 0
                  Date: Thu, 31 Mar 2016 20:17:20 GMT
```

## See Also
<a name="API_SubscribeToEvent_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/inspector-2016-02-16/SubscribeToEvent) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/inspector-2016-02-16/SubscribeToEvent) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/inspector-2016-02-16/SubscribeToEvent) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/inspector-2016-02-16/SubscribeToEvent) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/inspector-2016-02-16/SubscribeToEvent) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/inspector-2016-02-16/SubscribeToEvent) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/inspector-2016-02-16/SubscribeToEvent) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/inspector-2016-02-16/SubscribeToEvent) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/inspector-2016-02-16/SubscribeToEvent) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/inspector-2016-02-16/SubscribeToEvent) 

# UnsubscribeFromEvent
<a name="API_UnsubscribeFromEvent"></a>

**Important**  
End of support notice: On May 20, 2026, AWS will end support for (Amazon Inspector Classic). After May 20, 2026, you will no longer be able to access the Amazon Inspector Classic console or Amazon Inspector Classic resources. For more information, see [Amazon Inspector Classic end of support](https://docs.aws.amazon.com/inspector/v1/userguide/inspector-migration.html). 

Disables the process of sending Amazon Simple Notification Service (SNS) notifications about a specified event to a specified SNS topic.

## Request Syntax
<a name="API_UnsubscribeFromEvent_RequestSyntax"></a>

```
{
   "event": "string",
   "resourceArn": "string",
   "topicArn": "string"
}
```

## Request Parameters
<a name="API_UnsubscribeFromEvent_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [event](#API_UnsubscribeFromEvent_RequestSyntax) **   <a name="Inspector-UnsubscribeFromEvent-request-event"></a>
The event for which you want to stop receiving SNS notifications.  
Type: String  
Valid Values: `ASSESSMENT_RUN_STARTED | ASSESSMENT_RUN_COMPLETED | ASSESSMENT_RUN_STATE_CHANGED | FINDING_REPORTED | OTHER`   
Required: Yes

 ** [resourceArn](#API_UnsubscribeFromEvent_RequestSyntax) **   <a name="Inspector-UnsubscribeFromEvent-request-resourceArn"></a>
The ARN of the assessment template that is used during the event for which you want to stop receiving SNS notifications.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 300.  
Required: Yes

 ** [topicArn](#API_UnsubscribeFromEvent_RequestSyntax) **   <a name="Inspector-UnsubscribeFromEvent-request-topicArn"></a>
The ARN of the SNS topic to which SNS notifications are sent.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 300.  
Required: Yes

## Response Elements
<a name="API_UnsubscribeFromEvent_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_UnsubscribeFromEvent_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InternalException **   
Internal server error.    
 ** canRetry **   
You can immediately retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 500

 ** InvalidInputException **   
The request was rejected because an invalid or out-of-range value was supplied for an input parameter.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** NoSuchEntityException **   
The request was rejected because it referenced an entity that does not exist. The error code describes the entity.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** ServiceTemporarilyUnavailableException **   
The serice is temporary unavailable.    
 ** canRetry **   
You can wait and then retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

## Examples
<a name="API_UnsubscribeFromEvent_Examples"></a>

### Example
<a name="API_UnsubscribeFromEvent_Example_1"></a>

This example illustrates one usage of UnsubscribeFromEvent.

#### Sample Request
<a name="API_UnsubscribeFromEvent_Example_1_Request"></a>

```
               
                  POST / HTTP/1.1
                  Host: inspector.us-west-2.amazonaws.com
                  Accept-Encoding: identity
                  Content-Length: 200
                  X-Amz-Target: InspectorService.UnsubscribeFromEvent
                  X-Amz-Date: 20160331T203404Z
                  User-Agent: aws-cli/1.10.12 Python/2.7.9 Windows/7 botocore/1.4.3
                  Content-Type: application/x-amz-json-1.1
                  Authorization: AUTHPARAMS
                  {
                    "resourceArn": "arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-7sbz2Kz0",
                    "event": "ASSESSMENT_RUN_COMPLETED",
                    "topicArn": "arn:aws:sns:us-west-2:123456789012:exampletopic"
                  }
```

#### Sample Response
<a name="API_UnsubscribeFromEvent_Example_1_Response"></a>

```
               
                  HTTP/1.1 200 OK
                  x-amzn-RequestId: e9c2e864-f77f-11e5-82d7-bb83264505be
                  Content-Type: application/x-amz-json-1.1
                  Content-Length: 0
                  Date: Thu, 31 Mar 2016 20:34:06 GMT
```

## See Also
<a name="API_UnsubscribeFromEvent_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/inspector-2016-02-16/UnsubscribeFromEvent) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/inspector-2016-02-16/UnsubscribeFromEvent) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/inspector-2016-02-16/UnsubscribeFromEvent) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/inspector-2016-02-16/UnsubscribeFromEvent) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/inspector-2016-02-16/UnsubscribeFromEvent) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/inspector-2016-02-16/UnsubscribeFromEvent) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/inspector-2016-02-16/UnsubscribeFromEvent) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/inspector-2016-02-16/UnsubscribeFromEvent) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/inspector-2016-02-16/UnsubscribeFromEvent) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/inspector-2016-02-16/UnsubscribeFromEvent) 

# UpdateAssessmentTarget
<a name="API_UpdateAssessmentTarget"></a>

**Important**  
End of support notice: On May 20, 2026, AWS will end support for (Amazon Inspector Classic). After May 20, 2026, you will no longer be able to access the Amazon Inspector Classic console or Amazon Inspector Classic resources. For more information, see [Amazon Inspector Classic end of support](https://docs.aws.amazon.com/inspector/v1/userguide/inspector-migration.html). 

Updates the assessment target that is specified by the ARN of the assessment target.

If resourceGroupArn is not specified, all EC2 instances in the current AWS account and region are included in the assessment target.

## Request Syntax
<a name="API_UpdateAssessmentTarget_RequestSyntax"></a>

```
{
   "assessmentTargetArn": "string",
   "assessmentTargetName": "string",
   "resourceGroupArn": "string"
}
```

## Request Parameters
<a name="API_UpdateAssessmentTarget_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [assessmentTargetArn](#API_UpdateAssessmentTarget_RequestSyntax) **   <a name="Inspector-UpdateAssessmentTarget-request-assessmentTargetArn"></a>
The ARN of the assessment target that you want to update.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 300.  
Required: Yes

 ** [assessmentTargetName](#API_UpdateAssessmentTarget_RequestSyntax) **   <a name="Inspector-UpdateAssessmentTarget-request-assessmentTargetName"></a>
The name of the assessment target that you want to update.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 140.  
Required: Yes

 ** [resourceGroupArn](#API_UpdateAssessmentTarget_RequestSyntax) **   <a name="Inspector-UpdateAssessmentTarget-request-resourceGroupArn"></a>
The ARN of the resource group that is used to specify the new resource group to associate with the assessment target.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 300.  
Required: No

## Response Elements
<a name="API_UpdateAssessmentTarget_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_UpdateAssessmentTarget_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InternalException **   
Internal server error.    
 ** canRetry **   
You can immediately retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 500

 ** InvalidInputException **   
The request was rejected because an invalid or out-of-range value was supplied for an input parameter.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** NoSuchEntityException **   
The request was rejected because it referenced an entity that does not exist. The error code describes the entity.    
 ** canRetry **   
You can immediately retry your request.  
 ** errorCode **   
Code that indicates the type of error that is generated.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

 ** ServiceTemporarilyUnavailableException **   
The serice is temporary unavailable.    
 ** canRetry **   
You can wait and then retry your request.  
 ** message **   
Details of the exception error.
HTTP Status Code: 400

## Examples
<a name="API_UpdateAssessmentTarget_Examples"></a>

### Example
<a name="API_UpdateAssessmentTarget_Example_1"></a>

This example illustrates one usage of UpdateAssessmentTarget.

#### Sample Request
<a name="API_UpdateAssessmentTarget_Example_1_Request"></a>

```
               
                  POST / HTTP/1.1
                  Host: inspector.us-west-2.amazonaws.com
                  Accept-Encoding: identity
                  Content-Length: 206
                  X-Amz-Target: InspectorService.UpdateAssessmentTarget
                  X-Amz-Date: 20160331T185748Z
                  User-Agent: aws-cli/1.10.12 Python/2.7.9 Windows/7 botocore/1.4.3
                  Content-Type: application/x-amz-json-1.1
                  Authorization: AUTHPARAMS
                  {
                    "assessmentTargetArn": "arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX",
                    "assessmentTargetName": "Example",
                    "resourceGroupArn": "arn:aws:inspector:us-west-2:123456789012:resourcegroup/0-yNbgL5Pt"
                  }
```

#### Sample Response
<a name="API_UpdateAssessmentTarget_Example_1_Response"></a>

```
               
                  HTTP/1.1 200 OK
                  x-amzn-RequestId: 76bc43e7-f772-11e5-a5f3-fb6257e71620
                  Content-Type: application/x-amz-json-1.1
                  Content-Length: 0
                  Date: Thu, 31 Mar 2016 18:57:49 GMT
```

## See Also
<a name="API_UpdateAssessmentTarget_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/inspector-2016-02-16/UpdateAssessmentTarget) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/inspector-2016-02-16/UpdateAssessmentTarget) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/inspector-2016-02-16/UpdateAssessmentTarget) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/inspector-2016-02-16/UpdateAssessmentTarget) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/inspector-2016-02-16/UpdateAssessmentTarget) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/inspector-2016-02-16/UpdateAssessmentTarget) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/inspector-2016-02-16/UpdateAssessmentTarget) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/inspector-2016-02-16/UpdateAssessmentTarget) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/inspector-2016-02-16/UpdateAssessmentTarget) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/inspector-2016-02-16/UpdateAssessmentTarget)