IAmazonInspector.CreateAssessmentTarget Method (CreateAssessmentTargetRequest)

Creates a new assessment target using the ARN of the resource group that is generated by CreateResourceGroup. 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 isn’t already registered, this action also creates and registers a service-linked role to grant Amazon Inspector 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 Assessment Targets.

Note:

For .NET Core this operation is only available in asynchronous form. Please refer to CreateAssessmentTargetAsync.

Namespace: Amazon.Inspector
Assembly: AWSSDK.Inspector.dll
Version: 3.x.y.z

Syntax

public abstract CreateAssessmentTargetResponse CreateAssessmentTarget(
         CreateAssessmentTargetRequest request
)

Parameters

request: Type: Amazon.Inspector.Model.CreateAssessmentTargetRequest

Container for the necessary parameters to execute the CreateAssessmentTarget service method.

Return Value

Type: CreateAssessmentTargetResponse

The response from the CreateAssessmentTarget service method, as returned by Inspector.

Exceptions

Exception	Condition
AccessDeniedException	You do not have required permissions to access the requested resource.
InternalException	Internal server error.
InvalidCrossAccountRoleException	Amazon Inspector cannot assume the cross-account role that it needs to list your EC2 instances during the assessment run.
InvalidInputException	The request was rejected because an invalid or out-of-range value was supplied for an input parameter.
LimitExceededException	The request was rejected because it attempted to create resources beyond the current AWS account limits. The error code describes the limit exceeded.
NoSuchEntityException	The request was rejected because it referenced an entity that does not exist. The error code describes the entity.
ServiceTemporarilyUnavailableException	The serice is temporary unavailable.

Examples

Creates a new assessment target using the ARN of the resource group that is generated by CreateResourceGroup. You can create up to 50 assessment targets per AWS account. You can run up to 500 concurrent agents per AWS account.

Create assessment target


var client = new AmazonInspectorClient();
var response = client.CreateAssessmentTarget(new CreateAssessmentTargetRequest 
{
    AssessmentTargetName = "ExampleAssessmentTarget",
    ResourceGroupArn = "arn:aws:inspector:us-west-2:123456789012:resourcegroup/0-AB6DMKnv"
});

string assessmentTargetArn = response.AssessmentTargetArn;

Version Information

.NET Framework:
Supported in: 4.5, 4.0, 3.5

IAmazonInspector.CreateAssessmentTarget (CreateAssessmentTargetRequest)

Method