CloudFront Domain Association API

openapi: 3.1.0
info:
  title: Amazon CloudFront Domain Association API
  version: '2020-05-31'
  description: Generated from AWS's published Smithy model for Amazon CloudFront. 1 operation(s).
  contact:
    name: Amazon Web Services
    url: https://aws.amazon.com/contact-us/
  license:
    name: Apache 2.0
    identifier: Apache-2.0
    url: https://github.com/aws/api-models-aws/blob/main/LICENSE
servers:
- url: https://cloudfront.{region}.amazonaws.com
  variables:
    region:
      default: us-east-1
security:
- sigv4: []
paths:
  /2020-05-31/domain-association:
    post:
      operationId: UpdateDomainAssociation
      summary: Update Domain Association
      description: We recommend that you use the UpdateDomainAssociation API operation to move a domain association, as it
        supports both standard distributions and distribution tenants. AssociateAlias performs similar checks but only supports
        standard distributions. Moves a domain from its current standard distribution or distribution tenant to another one.
        You must first disable the source distribution (standard distribution or distribution tenant) and then separately
        call this operation to move the domain to another target distribution (standard distribution or distribution tenant).
        To use this operation, specify the domain and the ID of the target resource (standard distribution or distribution
        tenant). For more information, including how to set up the target resource, prerequisites that you must complete,
        and other restrictions, see Moving an alternate domain name to a different standard distribution or distribution tenant
        in the Amazon CloudFront Developer Guide.
      responses:
        '200':
          description: Success
          content:
            text/xml:
              schema:
                $ref: '#/components/schemas/UpdateDomainAssociationResult'
        '403':
          description: AccessDenied
          content:
            text/xml:
              schema:
                $ref: '#/components/schemas/AccessDenied'
        '404':
          description: EntityNotFound
          content:
            text/xml:
              schema:
                $ref: '#/components/schemas/EntityNotFound'
        '400':
          description: IllegalUpdate; InvalidArgument; InvalidIfMatchVersion
          content:
            text/xml:
              schema:
                $ref: '#/components/schemas/IllegalUpdate'
        '412':
          description: PreconditionFailed
          content:
            text/xml:
              schema:
                $ref: '#/components/schemas/PreconditionFailed'
      requestBody:
        content:
          application/xml:
            schema:
              $ref: '#/components/schemas/UpdateDomainAssociationRequest'
      tags:
      - Domain Association
components:
  securitySchemes:
    sigv4:
      type: apiKey
      in: header
      name: Authorization
      description: AWS Signature Version 4. The Authorization header carries an AWS4-HMAC-SHA256 signature over the canonical
        request, with X-Amz-Date (and X-Amz-Security-Token for temporary credentials). Not a bearer token.
      x-aws-sigv4:
        signingName: cloudfront
  schemas:
    AccessDenied:
      type: object
      properties:
        Message:
          type: string
    DistributionResourceId:
      type: object
      properties:
        DistributionId:
          type: string
          description: The ID of the multi-tenant distribution.
        DistributionTenantId:
          type: string
          description: The ID of the distribution tenant.
    EntityNotFound:
      type: object
      properties:
        Message:
          type: string
    IllegalUpdate:
      type: object
      properties:
        Message:
          type: string
    PreconditionFailed:
      type: object
      properties:
        Message:
          type: string
    UpdateDomainAssociationRequest:
      type: object
      properties:
        Domain:
          type: string
          description: The domain to update.
        TargetResource:
          $ref: '#/components/schemas/DistributionResourceId'
        IfMatch:
          type: string
          description: The value of the ETag identifier for the standard distribution or distribution tenant that will be
            associated with the domain.
      required:
      - Domain
      - TargetResource
    UpdateDomainAssociationResult:
      type: object
      properties:
        Domain:
          type: string
          description: The domain that you're moving.
        ResourceId:
          type: string
          description: The intended destination for the domain.
        ETag:
          type: string
          description: The current version of the target standard distribution or distribution tenant that was associated
            with the domain.
x-provenance:
  method: harvested
  publisher: Amazon Web Services
  source: https://raw.githubusercontent.com/aws/api-models-aws/582e55931c45b944739742a2c1620b6026dd2d13/models/cloudfront/service/2020-05-31/cloudfront-2020-05-31.json
  note: converted by smithy-to-openapi.py from AWS's Smithy model (roadmap#1001)