---
title: "POST /2020-05-31/distribution/{PrimaryDistributionId}/copy"
method: POST
path: "/2020-05-31/distribution/{PrimaryDistributionId}/copy"
---

# POST /2020-05-31/distribution/{PrimaryDistributionId}/copy

`POST /2020-05-31/distribution/{PrimaryDistributionId}/copy`

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.

## Path parameters

- `PrimaryDistributionId` string, required

## Headers

- `Staging` boolean
- `If-Match` string

## Response `201`

Success

## Other responses

- `480` — CNAMEAlreadyExists
- `481` — DistributionAlreadyExists
- `482` — InvalidOrigin
- `483` — InvalidOriginAccessIdentity
- `484` — InvalidOriginAccessControl
- `485` — InvalidIfMatchVersion
- `486` — NoSuchDistribution
- `487` — PreconditionFailed
- `488` — AccessDenied
- `489` — TooManyTrustedSigners
- `490` — TrustedSignerDoesNotExist
- `491` — InvalidViewerCertificate
- `492` — InvalidMinimumProtocolVersion
- `493` — MissingBody
- `494` — TooManyDistributionCNAMEs
- `495` — TooManyDistributions
- `496` — InvalidDefaultRootObject
- `497` — InvalidRelativePath
- `498` — InvalidErrorCode
- `499` — InvalidResponseCode
- `500` — InvalidArgument
- `501` — InvalidRequiredProtocol
- `502` — NoSuchOrigin
- `503` — TooManyOrigins
- `504` — TooManyOriginGroupsPerDistribution
- `505` — TooManyCacheBehaviors
- `506` — TooManyCookieNamesInWhiteList
- `507` — InvalidForwardCookies
- `508` — TooManyHeadersInForwardedValues
- `509` — InvalidHeadersForS3Origin
- `510` — InconsistentQuantities
- `511` — TooManyCertificates
- `512` — InvalidLocationCode
- `513` — InvalidGeoRestrictionParameter
- `514` — InvalidProtocolSettings
- `515` — InvalidTTLOrder
- `516` — InvalidWebACLId
- `517` — TooManyOriginCustomHeaders
- `518` — TooManyQueryStringParameters
- `519` — InvalidQueryStringParameters
- `520` — TooManyDistributionsWithLambdaAssociations
- `521` — TooManyDistributionsWithSingleFunctionARN
- `522` — TooManyLambdaFunctionAssociations
- `523` — InvalidLambdaFunctionAssociation
- `524` — TooManyDistributionsWithFunctionAssociations
- `525` — TooManyFunctionAssociations
- `526` — InvalidFunctionAssociation
- `527` — InvalidOriginReadTimeout
- `528` — InvalidOriginKeepaliveTimeout
- `529` — NoSuchFieldLevelEncryptionConfig
- `530` — IllegalFieldLevelEncryptionConfigAssociationWithCacheBehavior
- `531` — TooManyDistributionsAssociatedToFieldLevelEncryptionConfig
- `532` — NoSuchCachePolicy
- `533` — TooManyDistributionsAssociatedToCachePolicy
- `534` — NoSuchResponseHeadersPolicy
- `535` — TooManyDistributionsAssociatedToResponseHeadersPolicy
- `536` — NoSuchOriginRequestPolicy
- `537` — TooManyDistributionsAssociatedToOriginRequestPolicy
- `538` — TooManyDistributionsAssociatedToKeyGroup
- `539` — TooManyKeyGroupsAssociatedToDistribution
- `540` — TrustedKeyGroupDoesNotExist
- `541` — NoSuchRealtimeLogConfig
- `542` — RealtimeLogConfigOwnerMismatch

---

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