DeleteVPCAssociationAuthorizationCommand

Suggest an Edit

Removes authorization to submit an AssociateVPCWithHostedZone request to associate a specified VPC with a hosted zone that was created by a different account. You must use the account that created the hosted zone to submit a DeleteVPCAssociationAuthorization request.

Sending this request only prevents the Amazon Web Services account that created the VPC from associating the VPC with the Amazon Route 53 hosted zone in the future. If the VPC is already associated with the hosted zone, DeleteVPCAssociationAuthorization won't disassociate the VPC from the hosted zone. If you want to delete an existing association, use DisassociateVPCFromHostedZone.

Example Syntax

Use a bare-bones client and the command you need to make an API call.

import { Route53Client, DeleteVPCAssociationAuthorizationCommand } from "@aws-sdk/client-route-53"; // ES Modules import
// const { Route53Client, DeleteVPCAssociationAuthorizationCommand } = require("@aws-sdk/client-route-53"); // CommonJS import
const client = new Route53Client(config);
const input = { // DeleteVPCAssociationAuthorizationRequest
  HostedZoneId: "STRING_VALUE", // required
  VPC: { // VPC
    VPCRegion: "us-east-1" || "us-east-2" || "us-west-1" || "us-west-2" || "eu-west-1" || "eu-west-2" || "eu-west-3" || "eu-central-1" || "eu-central-2" || "ap-east-1" || "me-south-1" || "us-gov-west-1" || "us-gov-east-1" || "us-iso-east-1" || "us-iso-west-1" || "us-isob-east-1" || "me-central-1" || "ap-southeast-1" || "ap-southeast-2" || "ap-southeast-3" || "ap-south-1" || "ap-south-2" || "ap-northeast-1" || "ap-northeast-2" || "ap-northeast-3" || "eu-north-1" || "sa-east-1" || "ca-central-1" || "cn-north-1" || "cn-northwest-1" || "af-south-1" || "eu-south-1" || "eu-south-2" || "ap-southeast-4" || "il-central-1" || "ca-west-1" || "ap-southeast-5" || "mx-central-1" || "us-isof-south-1" || "us-isof-east-1" || "ap-southeast-7" || "ap-east-2",
    VPCId: "STRING_VALUE",
  },
};
const command = new DeleteVPCAssociationAuthorizationCommand(input);
const response = await client.send(command);
// {};

DeleteVPCAssociationAuthorizationCommand Input

See DeleteVPCAssociationAuthorizationCommandInput for more details

Parameter
Type
Description
HostedZoneId
Required
string | undefined

When removing authorization to associate a VPC that was created by one Amazon Web Services account with a hosted zone that was created with a different Amazon Web Services account, the ID of the hosted zone.

VPC
Required
VPC | undefined

When removing authorization to associate a VPC that was created by one Amazon Web Services account with a hosted zone that was created with a different Amazon Web Services account, a complex type that includes the ID and region of the VPC.

DeleteVPCAssociationAuthorizationCommand Output

See DeleteVPCAssociationAuthorizationCommandOutput for details

Parameter
Type
Description
$metadata
Required
ResponseMetadata
Metadata pertaining to this request.

Throws

Name
Fault
Details
ConcurrentModification
client

Another user submitted a request to create, update, or delete the object at the same time that you did. Retry the request.

InvalidInput
client

The input is not valid.

InvalidVPCId
client

The VPC ID that you specified either isn't a valid ID or the current account is not authorized to access this VPC.

NoSuchHostedZone
client

No hosted zone exists with the ID that you specified.

VPCAssociationAuthorizationNotFound
client

The VPC that you specified is not authorized to be associated with the hosted zone.

Route53ServiceException
Base exception class for all service exceptions from Route53 service.