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 Amazon Organizations organizational unit (OU) that you want to share your AMI with. For more information about key concepts for Amazon Organizations, see Amazon 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 Amazon Organization that you want to share your AMI with. For more information, see What is Amazon 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 Amazon Web Services 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 Amazon SDKs, see the following: