openapi: 3.2.0
info:
  title: Amazon Web Services cloudfront Distribution API
  description: 'Amazon CloudFront

    This is the Amazon CloudFront API Reference. This guide is for developers who need detailed information about CloudFront API actions, data types, and errors. For detailed information about CloudFront features, see the Amazon CloudFront Developer Guide.'
tags:
- name: Distribution
paths:
  /2020-05-31/distribution/{TargetDistributionId}/associate-alias:
    PUT:
      summary: Amazon Web Services Associatealias
      description: Associates an alias (also known as a CNAME or an alternate domain name) with a CloudFront distribution. With this operation you can move an alias that's already in use on a CloudFront distribution to a different distribution in one step. This prevents the downtime that could occur if you first remove the alias from one distribution and then separately add the alias to another distribution. To use this operation to associate an alias with a distribution, you provide the alias and the ID of the target distribution for the alias. For more information, including how to set up the target distribution, prerequisites that you must complete, and other restrictions, see Moving an alternate domain name to a different distribution in the Amazon CloudFront Developer Guide.
      operationId: amazonWebServicesAssociateAlias
      tags:
      - Distribution
  /2020-05-31/distribution/{PrimaryDistributionId}/copy:
    POST:
      summary: Amazon Web Services Copydistribution
      description: 'Creates a staging distribution using the configuration of the provided primary distribution. A staging distribution is a copy of an existing distribution (called the primary distribution) that you can use in a continuous deployment workflow. After you create a staging distribution, you can use UpdateDistribution to modify the staging distribution''s configuration. Then you can use CreateContinuousDeploymentPolicy to incrementally move traffic to the staging distribution. This API operation requires the following IAM permissions: GetDistribution CreateDistribution CopyDistribution'
      operationId: amazonWebServicesCopyDistribution
      tags:
      - Distribution
  /2020-05-31/distribution:
    GET:
      summary: Amazon Web Services Listdistributions
      description: List CloudFront distributions.
      operationId: amazonWebServicesListDistributions
      tags:
      - Distribution
  /2020-05-31/distribution?WithTags:
    POST:
      summary: Amazon Web Services Createdistributionwithtags
      description: 'Create a new distribution with tags. This API operation requires the following IAM permissions: CreateDistribution TagResource'
      operationId: amazonWebServicesCreateDistributionWithTags
      tags:
      - Distribution
  /2020-05-31/distribution/{DistributionId}/invalidation:
    GET:
      summary: Amazon Web Services Listinvalidations
      description: Lists invalidation batches.
      operationId: amazonWebServicesListInvalidations
      tags:
      - Distribution
  /2020-05-31/distribution/{Id}:
    GET:
      summary: Amazon Web Services Getdistribution
      description: Get the information about a distribution.
      operationId: amazonWebServicesGetDistribution
      tags:
      - Distribution
  /2020-05-31/distribution/{Id}/config:
    PUT:
      summary: Amazon Web Services Updatedistribution
      description: 'Updates the configuration for a CloudFront distribution. The update process includes getting the current distribution configuration, updating it to make your changes, and then submitting an UpdateDistribution request to make the updates. To update a web distribution using the CloudFront API Use GetDistributionConfig to get the current configuration, including the version identifier (ETag). Update the distribution configuration that was returned in the response. Note the following important requirements and restrictions: You must rename the ETag field to IfMatch, leaving the value unchanged. (Set the value of IfMatch to the value of ETag, then remove the ETag field.) You can''t change the value of CallerReference. Submit an UpdateDistribution request, providing the distribution configuration. The new configuration replaces the existing configuration. The values that you specify in an UpdateDistribution request are not merged into your existing configuration. Make sure to include all fields: the ones that you modified and also the ones that you didn''t.'
      operationId: amazonWebServicesUpdateDistribution
      tags:
      - Distribution
  /2020-05-31/distribution/{DistributionId}/invalidation/{Id}:
    GET:
      summary: Amazon Web Services Getinvalidation
      description: Get the information about an invalidation.
      operationId: amazonWebServicesGetInvalidation
      tags:
      - Distribution
  /2020-05-31/distribution/{Id}/promote-staging-config:
    PUT:
      summary: Amazon Web Services Updatedistributionwithstagingconfig
      description: 'Copies the staging distribution''s configuration to its corresponding primary distribution. The primary distribution retains its Aliases (also known as alternate domain names or CNAMEs) and ContinuousDeploymentPolicyId value, but otherwise its configuration is overwritten to match the staging distribution. You can use this operation in a continuous deployment workflow after you have tested configuration changes on the staging distribution. After using a continuous deployment policy to move a portion of your domain name''s traffic to the staging distribution and verifying that it works as intended, you can use this operation to copy the staging distribution''s configuration to the primary distribution. This action will disable the continuous deployment policy and move your domain''s traffic back to the primary distribution. This API operation requires the following IAM permissions: GetDistribution UpdateDistribution'
      operationId: amazonWebServicesUpdateDistributionWithStagingConfig
      tags:
      - Distribution