Select your cookie preferences

We use cookies and similar tools to enhance your experience, provide our services, deliver relevant advertising, and make improvements. Approved third parties also use these tools to help us deliver advertising and provide certain site features.

put_image_policy

put_image_policy(**kwargs)

Applies a policy to an image. We recommend that you call the RAM API CreateResourceShare to share resources. If you call the Image Builder API PutImagePolicy , 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_image_policy(
    imageArn='string',
    policy='string'
)
Parameters
  • imageArn (string) --

    [REQUIRED]

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

  • policy (string) --

    [REQUIRED]

    The policy to apply.

Return type

dict

Returns

Response Syntax

{
    'requestId': 'string',
    'imageArn': 'string'
}

Response Structure

  • (dict) --

    • requestId (string) --

      The request ID that uniquely identifies this request.

    • imageArn (string) --

      The Amazon Resource Name (ARN) of the image 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