imagebuilder/aws.sdk.kotlin.services.imagebuilder/ImagebuilderClient/putImagePolicy

putImagePolicy

abstract suspend fun putImagePolicy(input: PutImagePolicyRequest): PutImagePolicyResponse

Applies a policy to an image. The preferred way to share resources is with the RAM API CreateResourceShare. If you use the PutImagePolicy operation instead, you must also call the RAM API PromoteResourceShareCreatedFromPolicy. Otherwise, the resource isn't visible to the principals that it's shared with.

Samples

// The following example applies a resource policy to an image build version that grants another AWS
// account permission to view the image.
val resp = imagebuilderClient.putImagePolicy {
    imageArn = "arn:aws:imagebuilder:us-west-2:111122223333:image/my-example-recipe/1.0.0/1"
    policy = "{\"Version\": \"2012-10-17\", \"Statement\": [{\"Effect\": \"Allow\", \"Principal\": {\"AWS\": \"arn:aws:iam::444455556666:root\"}, \"Action\": [\"imagebuilder:GetImage\", \"imagebuilder:ListImages\"], \"Resource\": [\"arn:aws:imagebuilder:us-west-2:111122223333:image/my-example-recipe/1.0.0/1\"]}]}"
}