IAmazonInspector.RegisterCrossAccountAccessRole Method (RegisterCrossAccountAccessRoleRequest)

Registers the IAM role that grants Amazon Inspector access to AWS Services needed to perform security assessments.

Note:

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

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

Syntax

public abstract RegisterCrossAccountAccessRoleResponse RegisterCrossAccountAccessRole(
         RegisterCrossAccountAccessRoleRequest request
)

Parameters

request: Type: Amazon.Inspector.Model.RegisterCrossAccountAccessRoleRequest

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

Return Value

Type: RegisterCrossAccountAccessRoleResponse

The response from the RegisterCrossAccountAccessRole 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.
ServiceTemporarilyUnavailableException	The serice is temporary unavailable.

Examples

Registers the IAM role that Amazon Inspector uses to list your EC2 instances at the start of the assessment run or when you call the PreviewAgents action.

Register cross account access role


var client = new AmazonInspectorClient();
var response = client.RegisterCrossAccountAccessRole(new RegisterCrossAccountAccessRoleRequest 
{
    RoleArn = "arn:aws:iam::123456789012:role/inspector"
});

Version Information

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

IAmazonInspector.RegisterCrossAccountAccessRole (RegisterCrossAccountAccessRoleRequest)

Method