LaunchPermissionConfiguration
Describes the configuration for a launch permission. The launch permission
modification request is sent to the Amazon EC2
ModifyImageAttribute API on behalf of the user for each Region they have
selected to distribute the AMI. To make an AMI public, set userGroups
to the value all. See the examples for making an AMI public at
Amazon EC2
ModifyImageAttribute.
Contents
- organizationalUnitArns
-
The ARN for an AWS Organizations organizational unit (OU) that you want to share your AMI with. For more information about key concepts for AWS Organizations, see AWS Organizations terminology and concepts.
Type: Array of strings
Array Members: Minimum number of 1 item. Maximum number of 25 items.
Pattern:
^arn:aws[^:]*:organizations::[0-9]{12}:ou/o-[a-z0-9]{10,32}/ou-[0-9a-z]{4,32}-[0-9a-z]{8,32}Required: No
- organizationArns
-
The ARN for an AWS Organization that you want to share your AMI with. For more information, see What is AWS Organizations?.
Type: Array of strings
Array Members: Minimum number of 1 item. Maximum number of 25 items.
Pattern:
^arn:aws[^:]*:organizations::[0-9]{12}:organization/o-[a-z0-9]{10,32}$Required: No
- userGroups
-
The name of the group that you want to grant launch permission to. The only supported value is
all, which makes the distributed AMI public.Type: Array of strings
Length Constraints: Minimum length of 1. Maximum length of 1024.
Required: No
- userIds
-
The AWS account IDs to grant launch permission to. Each listed account can use the distributed AMI to launch instances.
Type: Array of strings
Array Members: Minimum number of 1 item. Maximum number of 1536 items.
Pattern:
^[0-9]{12}$Required: No
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: