---
title: "GET /GetDistributionConfiguration#distributionConfigurationArn"
method: GET
path: "/GetDistributionConfiguration#distributionConfigurationArn"
---

# GET /GetDistributionConfiguration#distributionConfigurationArn

`GET /GetDistributionConfiguration#distributionConfigurationArn`

Gets a distribution configuration.

## Query parameters

- `distributionConfigurationArn` string, required

## Response `200`

Success

- GetDistributionConfigurationResponse
  - `requestId` string — The request ID that uniquely identifies this request.
  - `distributionConfiguration` object — The distribution configuration object.
    - `arn` string — The Amazon Resource Name (ARN) of the distribution configuration.
    - `name` string — The name of the distribution configuration.
    - `description` string — The description of the distribution configuration.
    - `distributions` Distribution[] — The distribution objects that apply Region-specific settings for the deployment of the image to targeted Regions.
      - `region` string, required — The target Region.
      - `amiDistributionConfiguration` object — The specific AMI settings; for example, launch permissions or AMI tags.
        - `name` string — The name of the output AMI.
        - `description` string — The description of the AMI distribution configuration. Minimum and maximum length are in characters.
        - `targetAccountIds` AccountId[] — The ID of an account to which you want to distribute an image.
        - `amiTags` object — The tags to apply to AMIs distributed to this Region.
        - `kmsKeyId` string — The KMS key identifier used to encrypt the distributed image.
        - `launchPermission` object — Launch permissions can be used to configure which Amazon Web Services accounts can use the AMI to launch instances.
          - `userIds` AccountId[] — The Amazon Web Services account ID.
          - `userGroups` NonEmptyString[] — The name of the group.
          - `organizationArns` OrganizationArn[] — The ARN for an Amazon Web Services Organization that you want to share your AMI with. For more information, see <a href="https://docs.aws.amazon.com/organizations/latest/userguide/orgs_introduction.html">What is Organizations?</a>.
          - `organizationalUnitArns` OrganizationalUnitArn[] — The ARN for an Organizations organizational unit (OU) that you want to share your AMI with. For more information about key concepts for Organizations, see <a href="https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html">Organizations terminology and concepts</a>.
      - `containerDistributionConfiguration` object — Container distribution settings for encryption, licensing, and sharing in a specific Region.
        - `description` string — The description of the container distribution configuration.
        - `containerTags` NonEmptyString[] — Tags that are attached to the container distribution configuration.
        - `targetRepository` object, required — The destination repository for the container distribution configuration.
          - `service` 'ECR', required — Specifies the service in which this image was registered.
          - `repositoryName` string, required — The name of the container repository where the output container image is stored. This name is prefixed by the repository location.
      - `licenseConfigurationArns` LicenseConfigurationArn[] — The License Manager Configuration to associate with the AMI in the specified Region.
      - `launchTemplateConfigurations` LaunchTemplateConfiguration[] — A group of launchTemplateConfiguration settings that apply to image distribution for specified accounts.
        - `launchTemplateId` string, required — Identifies the Amazon EC2 launch template to use.
        - `accountId` string — The account ID that this configuration applies to.
        - `setDefaultVersion` boolean — Set the specified Amazon EC2 launch template as the default launch template for the specified account.
      - `s3ExportConfiguration` object — Configure export settings to deliver disk images created from your image build, using a file format that is compatible with your VMs in that Region.
        - `roleName` string, required — The name of the role that grants VM Import/Export permission to export images to your S3 bucket.
        - `diskImageFormat` 'VMDK' | 'RAW' | 'VHD', required — <p>Export the updated image to one of the following supported disk image formats:</p> <ul> <li> <p> <b>Virtual Hard Disk (VHD)</b> – Compatible with Citrix Xen and Microsoft Hyper-V virtualization products.</p> </li> <li> <p> <b>Stream-optimized ESX Virtual Machine Disk (VMDK)</b> – Compatible with VMware ESX and VMware vSphere versions 4, 5, and 6.</p> </li> <li> <p> <b>Raw</b> – Raw format.</p> </li> </ul>
        - `s3Bucket` string, required — The S3 bucket in which to store the output disk images for your VM.
        - `s3Prefix` string — The Amazon S3 path for the bucket where the output disk images for your VM are stored.
      - `fastLaunchConfigurations` FastLaunchConfiguration[] — The Windows faster-launching configurations to use for AMI distribution.
        - `enabled` boolean, required — A Boolean that represents the current state of faster launching for the Windows AMI. Set to <code>true</code> to start using Windows faster launching, or <code>false</code> to stop using it.
        - `snapshotConfiguration` object — Configuration settings for managing the number of snapshots that are created from pre-provisioned instances for the Windows AMI when faster launching is enabled.
          - `targetResourceCount` integer — The number of pre-provisioned snapshots to keep on hand for a fast-launch enabled Windows AMI.
        - `maxParallelLaunches` integer — The maximum number of parallel instances that are launched for creating resources.
        - `launchTemplate` object — The launch template that the fast-launch enabled Windows AMI uses when it launches Windows instances to create pre-provisioned snapshots.
          - `launchTemplateId` string — The ID of the launch template to use for faster launching for a Windows AMI.
          - `launchTemplateName` string — The name of the launch template to use for faster launching for a Windows AMI.
          - `launchTemplateVersion` string — The version of the launch template to use for faster launching for a Windows AMI.
        - `accountId` string — The owner account ID for the fast-launch enabled Windows AMI.
    - `timeoutMinutes` integer, required — The maximum duration in minutes for this distribution configuration.
    - `dateCreated` string — The date on which this distribution configuration was created.
    - `dateUpdated` string — The date on which this distribution configuration was last updated.
    - `tags` object — The tags of the distribution configuration.

## Other responses

- `480` — ServiceException
- `481` — ClientException
- `482` — ServiceUnavailableException
- `483` — InvalidRequestException
- `484` — ForbiddenException
- `485` — CallRateLimitExceededException

---

[API](https://skmtc.net/aws/apis/imagebuilder.md) · [All operations](https://skmtc.net/aws/apis/imagebuilder/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/imagebuilder/versions/cfe68d8f8262/schema)