v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1456338351.9 KB

Applies a policy to an image. We recommend that you call the RAM API <a href="https://docs.aws.amazon.com/ram/latest/APIReference/API_CreateResourceShare.html">CreateResourceShare</a> to share resources. If you call the Image Builder API <code>PutImagePolicy</code>, you must also call the RAM API <a href="https://docs.aws.amazon.com/ram/latest/APIReference/API_PromoteResourceShareCreatedFromPolicy.html">PromoteResourceShareCreatedFromPolicy</a> in order for the resource to be visible to all principals with whom the resource is shared.

put/PutImagePolicy

Request body

imageArnstring required

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

policystring required

The policy to apply.

Response

Success

requestIdstring

The request ID that uniquely identifies this request.

imageArnstring

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