AssociateVPCWithHostedZone
Associates an Amazon VPC with a private hosted zone.
Important
To perform the association, the VPC and the private hosted zone must already exist. You can't convert a public hosted zone into a private hosted zone.
Note
If you want to associate a VPC that was created by using one Amazon Web Services account with a private hosted zone that was created by using a
different account, the Amazon Web Services account that created the private hosted
zone must first submit a CreateVPCAssociationAuthorization
request.
Then the account that created the VPC must submit an
AssociateVPCWithHostedZone
request.
Note
When granting access, the hosted zone and the Amazon VPC must belong to the same partition. A partition is a group of Amazon Web Services Regions. Each Amazon Web Services account is scoped to one partition.
The following are the supported partitions:
-
aws
- Amazon Web Services Regions -
aws-cn
- China Regions -
aws-us-gov
- Amazon GovCloud (US) Region
For more information, see Access Management in the Amazon General Reference.
Request Syntax
POST /2013-04-01/hostedzone/Id
/associatevpc HTTP/1.1
<?xml version="1.0" encoding="UTF-8"?>
<AssociateVPCWithHostedZoneRequest xmlns="https://route53.amazonaws.com/doc/2013-04-01/">
<Comment>string
</Comment>
<VPC>
<VPCId>string
</VPCId>
<VPCRegion>string
</VPCRegion>
</VPC>
</AssociateVPCWithHostedZoneRequest>
URI Request Parameters
The request uses the following URI parameters.
- Id
-
The ID of the private hosted zone that you want to associate an Amazon VPC with.
Note that you can't associate a VPC with a hosted zone that doesn't have an existing VPC association.
Length Constraints: Maximum length of 32.
Required: Yes
Request Body
The request accepts the following data in XML format.
- AssociateVPCWithHostedZoneRequest
-
Root level tag for the AssociateVPCWithHostedZoneRequest parameters.
Required: Yes
- Comment
-
Optional: A comment about the association request.
Type: String
Required: No
- VPC
-
A complex type that contains information about the VPC that you want to associate with a private hosted zone.
Type: VPC object
Required: Yes
Response Syntax
HTTP/1.1 200
<?xml version="1.0" encoding="UTF-8"?>
<AssociateVPCWithHostedZoneResponse>
<ChangeInfo>
<Comment>string</Comment>
<Id>string</Id>
<Status>string</Status>
<SubmittedAt>timestamp</SubmittedAt>
</ChangeInfo>
</AssociateVPCWithHostedZoneResponse>
Response Elements
If the action is successful, the service sends back an HTTP 200 response.
The following data is returned in XML format by the service.
- AssociateVPCWithHostedZoneResponse
-
Root level tag for the AssociateVPCWithHostedZoneResponse parameters.
Required: Yes
- ChangeInfo
-
A complex type that describes the changes made to your hosted zone.
Type: ChangeInfo object
Errors
For information about the errors that are common to all actions, see Common Errors.
- ConflictingDomainExists
-
The cause of this error depends on the operation that you're performing:
-
Create a public hosted zone: Two hosted zones that have the same name or that have a parent/child relationship (example.com and test.example.com) can't have any common name servers. You tried to create a hosted zone that has the same name as an existing hosted zone or that's the parent or child of an existing hosted zone, and you specified a delegation set that shares one or more name servers with the existing hosted zone. For more information, see CreateReusableDelegationSet.
-
Create a private hosted zone: A hosted zone with the specified name already exists and is already associated with the Amazon VPC that you specified.
-
Associate VPCs with a private hosted zone: The VPC that you specified is already associated with another hosted zone that has the same name.
HTTP Status Code: 400
-
- InvalidInput
-
The input is not valid.
HTTP Status Code: 400
- InvalidVPCId
-
The VPC ID that you specified either isn't a valid ID or the current account is not authorized to access this VPC.
HTTP Status Code: 400
- LimitsExceeded
-
This operation can't be completed because the current account has reached the limit on the resource you are trying to create. To request a higher limit, create a case
with the Amazon Support Center. HTTP Status Code: 400
- NoSuchHostedZone
-
No hosted zone exists with the ID that you specified.
HTTP Status Code: 404
- NotAuthorizedException
-
Associating the specified VPC with the specified hosted zone has not been authorized.
HTTP Status Code: 401
- PriorRequestNotComplete
-
If Amazon Route 53 can't process a request before the next request arrives, it will reject subsequent requests for the same hosted zone and return an
HTTP 400 error
(Bad request
). If Route 53 returns this error repeatedly for the same request, we recommend that you wait, in intervals of increasing duration, before you try the request again.HTTP Status Code: 400
- PublicZoneVPCAssociation
-
You're trying to associate a VPC with a public hosted zone. Amazon Route 53 doesn't support associating a VPC with a public hosted zone.
HTTP Status Code: 400
Examples
Example Request
This example illustrates one usage of AssociateVPCWithHostedZone.
POST /2013-04-01/hostedzone/Z1PA6795UKMFR9/associatevpc HTTP/1.1 <?xml version="1.0" encoding="UTF-8"?> <AssociateVPCWithHostedZoneRequest xmlns="https://route53.amazonaws.com/doc/2013-04-01/"> <VPC> <VPCId>vpc-a1b2c3d4e5</VPCId> <VPCRegion>us-east-2</VPCRegion> <VPC> </AssociateVPCWithHostedZoneRequest>
Example Response
This example illustrates one usage of AssociateVPCWithHostedZone.
HTTP/1.1 200 OK <?xml version="1.0" encoding="UTF-8"?> <AssociateVPCWithHostedZoneResponse xmlns="https://route53.amazonaws.com/doc/2013-04-01/"> <ChangeInfo> <Id>/change/a1b2c3d4</Id> <Status>INSYNC</Status> <SubmittedAt>2017-03-31T01:36:41.958Z</SubmittedAt> </ChangeInfo> </AssociateVPCWithHostedZoneResponse>
See Also
For more information about using this API in one of the language-specific Amazon SDKs, see the following: