imagebuilder / Client / put_component_policy

put_component_policy

imagebuilder.Client.put_component_policy(**kwargs)

Applies a policy to a component. We recommend that you call the RAM API CreateResourceShare to share resources. If you call the Image Builder API PutComponentPolicy, you must also call the RAM API PromoteResourceShareCreatedFromPolicy in order for the resource to be visible to all principals with whom the resource is shared.

See also: AWS API Documentation

Request Syntax

response = client.put_component_policy(
    componentArn='string',
    policy='string'
)

Parameters:

• componentArn (string) –

  [REQUIRED]

  The Amazon Resource Name (ARN) of the component that this policy should be applied to.

• policy (string) –

  [REQUIRED]

  The policy to apply.

Return type:

dict

Returns:

Response Syntax

{
    'requestId': 'string',
    'componentArn': 'string'
}

Response Structure

• (dict) –

  • requestId (string) –

    The request ID that uniquely identifies this request.

  • componentArn (string) –

    The Amazon Resource Name (ARN) of the component that this policy was applied to.

Exceptions

• imagebuilder.Client.exceptions.ServiceException

• imagebuilder.Client.exceptions.ClientException

• imagebuilder.Client.exceptions.ServiceUnavailableException

• imagebuilder.Client.exceptions.InvalidRequestException

• imagebuilder.Client.exceptions.InvalidParameterValueException

• imagebuilder.Client.exceptions.ResourceNotFoundException

• imagebuilder.Client.exceptions.ForbiddenException

• imagebuilder.Client.exceptions.CallRateLimitExceededException