Amazonka.CloudFront.CopyDistribution

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.

Creating a Request

data CopyDistribution

See: newCopyDistribution smart constructor.

Constructors

CopyDistribution'

Fields

• ifMatch :: Maybe Text

  The version identifier of the primary distribution whose configuration you are copying. This is the ETag value returned in the response to GetDistribution and GetDistributionConfig.

• staging :: Maybe Bool

  The type of distribution that your primary distribution will be copied to. The only valid value is True, indicating that you are copying to a staging distribution.

• primaryDistributionId :: Text

  The identifier of the primary distribution whose configuration you are copying. To get a distribution ID, use ListDistributions.

• callerReference :: Text

  A value that uniquely identifies a request to create a resource. This helps to prevent CloudFront from creating a duplicate resource if you accidentally resubmit an identical request.

Instances

ToHeaders CopyDistribution

Defined in Amazonka.CloudFront.CopyDistribution

Methods

toHeaders :: CopyDistribution -> [Header]

ToPath CopyDistribution

Defined in Amazonka.CloudFront.CopyDistribution

Methods

toPath :: CopyDistribution -> ByteString

ToQuery CopyDistribution

Defined in Amazonka.CloudFront.CopyDistribution

Methods

toQuery :: CopyDistribution -> QueryString

ToElement CopyDistribution

Defined in Amazonka.CloudFront.CopyDistribution

Methods

toElement :: CopyDistribution -> Element

ToXML CopyDistribution

Defined in Amazonka.CloudFront.CopyDistribution

Methods

toXML :: CopyDistribution -> XML

AWSRequest CopyDistribution

Defined in Amazonka.CloudFront.CopyDistribution

Associated Types

type AWSResponse CopyDistribution

Methods

request :: (Service -> Service) -> CopyDistribution -> Request CopyDistribution

response :: MonadResource m => (ByteStringLazy -> IO ByteStringLazy) -> Service -> Proxy CopyDistribution -> ClientResponse ClientBody -> m (Either Error (ClientResponse (AWSResponse CopyDistribution)))

Generic CopyDistribution

Defined in Amazonka.CloudFront.CopyDistribution

Associated Types

type Rep CopyDistribution :: Type -> Type

Methods

from :: CopyDistribution -> Rep CopyDistribution x

to :: Rep CopyDistribution x -> CopyDistribution

Read CopyDistribution

Defined in Amazonka.CloudFront.CopyDistribution

Methods

readsPrec :: Int -> ReadS CopyDistribution

readList :: ReadS [CopyDistribution]

readPrec :: ReadPrec CopyDistribution

readListPrec :: ReadPrec [CopyDistribution]

Show CopyDistribution

Defined in Amazonka.CloudFront.CopyDistribution

Methods

showsPrec :: Int -> CopyDistribution -> ShowS

show :: CopyDistribution -> String

showList :: [CopyDistribution] -> ShowS

NFData CopyDistribution

Defined in Amazonka.CloudFront.CopyDistribution

Methods

rnf :: CopyDistribution -> ()

Eq CopyDistribution

Defined in Amazonka.CloudFront.CopyDistribution

Methods

(==) :: CopyDistribution -> CopyDistribution -> Bool

(/=) :: CopyDistribution -> CopyDistribution -> Bool

Hashable CopyDistribution

Defined in Amazonka.CloudFront.CopyDistribution

Methods

hashWithSalt :: Int -> CopyDistribution -> Int

hash :: CopyDistribution -> Int

type AWSResponse CopyDistribution

Defined in Amazonka.CloudFront.CopyDistribution

type AWSResponse CopyDistribution = CopyDistributionResponse

type Rep CopyDistribution

Defined in Amazonka.CloudFront.CopyDistribution

type Rep CopyDistribution = D1 ('MetaData "CopyDistribution" "Amazonka.CloudFront.CopyDistribution" "amazonka-cloudfront-2.0-8Jb7luniAuUfLdUxCxW4K" 'False) (C1 ('MetaCons "CopyDistribution'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "ifMatch") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "staging") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Bool))) :*: (S1 ('MetaSel ('Just "primaryDistributionId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text) :*: S1 ('MetaSel ('Just "callerReference") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text))))

newCopyDistribution

Arguments

:: Text

$sel:primaryDistributionId:CopyDistribution'

-> Text

CopyDistribution

-> CopyDistribution

Create a value of CopyDistribution with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:ifMatch:CopyDistribution', copyDistribution_ifMatch - The version identifier of the primary distribution whose configuration you are copying. This is the ETag value returned in the response to GetDistribution and GetDistributionConfig.

CopyDistribution, copyDistribution_staging - The type of distribution that your primary distribution will be copied to. The only valid value is True, indicating that you are copying to a staging distribution.

$sel:primaryDistributionId:CopyDistribution', copyDistribution_primaryDistributionId - The identifier of the primary distribution whose configuration you are copying. To get a distribution ID, use ListDistributions.

CopyDistribution, copyDistribution_callerReference - A value that uniquely identifies a request to create a resource. This helps to prevent CloudFront from creating a duplicate resource if you accidentally resubmit an identical request.

Request Lenses

copyDistribution_ifMatch :: Lens' CopyDistribution (Maybe Text)

The version identifier of the primary distribution whose configuration you are copying. This is the ETag value returned in the response to GetDistribution and GetDistributionConfig.

copyDistribution_staging :: Lens' CopyDistribution (Maybe Bool)

The type of distribution that your primary distribution will be copied to. The only valid value is True, indicating that you are copying to a staging distribution.

copyDistribution_primaryDistributionId :: Lens' CopyDistribution Text

The identifier of the primary distribution whose configuration you are copying. To get a distribution ID, use ListDistributions.

copyDistribution_callerReference :: Lens' CopyDistribution Text

A value that uniquely identifies a request to create a resource. This helps to prevent CloudFront from creating a duplicate resource if you accidentally resubmit an identical request.

Destructuring the Response

data CopyDistributionResponse

See: newCopyDistributionResponse smart constructor.

Constructors

CopyDistributionResponse'

Fields

• distribution :: Maybe Distribution
• eTag :: Maybe Text

  The version identifier for the current version of the staging distribution.

• location :: Maybe Text

  The URL of the staging distribution.

• httpStatus :: Int

  The response's http status code.

Instances

Generic CopyDistributionResponse

Defined in Amazonka.CloudFront.CopyDistribution

Associated Types

type Rep CopyDistributionResponse :: Type -> Type

Methods

from :: CopyDistributionResponse -> Rep CopyDistributionResponse x

to :: Rep CopyDistributionResponse x -> CopyDistributionResponse

Show CopyDistributionResponse

Defined in Amazonka.CloudFront.CopyDistribution

Methods

showsPrec :: Int -> CopyDistributionResponse -> ShowS

show :: CopyDistributionResponse -> String

showList :: [CopyDistributionResponse] -> ShowS

NFData CopyDistributionResponse

Defined in Amazonka.CloudFront.CopyDistribution

Methods

rnf :: CopyDistributionResponse -> ()

Eq CopyDistributionResponse

Defined in Amazonka.CloudFront.CopyDistribution

Methods

(==) :: CopyDistributionResponse -> CopyDistributionResponse -> Bool

(/=) :: CopyDistributionResponse -> CopyDistributionResponse -> Bool

type Rep CopyDistributionResponse

Defined in Amazonka.CloudFront.CopyDistribution

type Rep CopyDistributionResponse = D1 ('MetaData "CopyDistributionResponse" "Amazonka.CloudFront.CopyDistribution" "amazonka-cloudfront-2.0-8Jb7luniAuUfLdUxCxW4K" 'False) (C1 ('MetaCons "CopyDistributionResponse'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "distribution") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Distribution)) :*: S1 ('MetaSel ('Just "eTag") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))) :*: (S1 ('MetaSel ('Just "location") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int))))

newCopyDistributionResponse

Arguments

:: Int

$sel:httpStatus:CopyDistributionResponse'

-> CopyDistributionResponse

Create a value of CopyDistributionResponse with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:distribution:CopyDistributionResponse', copyDistributionResponse_distribution - Undocumented member.

$sel:eTag:CopyDistributionResponse', copyDistributionResponse_eTag - The version identifier for the current version of the staging distribution.

$sel:location:CopyDistributionResponse', copyDistributionResponse_location - The URL of the staging distribution.

$sel:httpStatus:CopyDistributionResponse', copyDistributionResponse_httpStatus - The response's http status code.

Response Lenses

copyDistributionResponse_distribution :: Lens' CopyDistributionResponse (Maybe Distribution)

Undocumented member.

copyDistributionResponse_eTag :: Lens' CopyDistributionResponse (Maybe Text)

The version identifier for the current version of the staging distribution.

copyDistributionResponse_location :: Lens' CopyDistributionResponse (Maybe Text)

The URL of the staging distribution.

copyDistributionResponse_httpStatus :: Lens' CopyDistributionResponse Int

The response's http status code.