Amazonka.Route53.AssociateVPCWithHostedZone

Associates an Amazon VPC with a private hosted zone.

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.

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.

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 Web Services GovCloud (US) Region

For more information, see Access Management in the Amazon Web Services General Reference.

Creating a Request

data AssociateVPCWithHostedZone

A complex type that contains information about the request to associate a VPC with a private hosted zone.

See: newAssociateVPCWithHostedZone smart constructor.

Constructors

AssociateVPCWithHostedZone'

Fields

• comment :: Maybe Text

  Optional: A comment about the association request.

• hostedZoneId :: ResourceId

  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.

• vpc :: VPC

  A complex type that contains information about the VPC that you want to associate with a private hosted zone.

Instances

ToHeaders AssociateVPCWithHostedZone

Defined in Amazonka.Route53.AssociateVPCWithHostedZone

Methods

toHeaders :: AssociateVPCWithHostedZone -> [Header]

ToPath AssociateVPCWithHostedZone

Defined in Amazonka.Route53.AssociateVPCWithHostedZone

Methods

toPath :: AssociateVPCWithHostedZone -> ByteString

ToQuery AssociateVPCWithHostedZone

Defined in Amazonka.Route53.AssociateVPCWithHostedZone

Methods

toQuery :: AssociateVPCWithHostedZone -> QueryString

ToElement AssociateVPCWithHostedZone

Defined in Amazonka.Route53.AssociateVPCWithHostedZone

Methods

toElement :: AssociateVPCWithHostedZone -> Element

ToXML AssociateVPCWithHostedZone

Defined in Amazonka.Route53.AssociateVPCWithHostedZone

Methods

toXML :: AssociateVPCWithHostedZone -> XML

AWSRequest AssociateVPCWithHostedZone

Defined in Amazonka.Route53.AssociateVPCWithHostedZone

Associated Types

type AWSResponse AssociateVPCWithHostedZone

Methods

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

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

Generic AssociateVPCWithHostedZone

Defined in Amazonka.Route53.AssociateVPCWithHostedZone

Associated Types

type Rep AssociateVPCWithHostedZone :: Type -> Type

Methods

from :: AssociateVPCWithHostedZone -> Rep AssociateVPCWithHostedZone x

to :: Rep AssociateVPCWithHostedZone x -> AssociateVPCWithHostedZone

Read AssociateVPCWithHostedZone

Defined in Amazonka.Route53.AssociateVPCWithHostedZone

Methods

readsPrec :: Int -> ReadS AssociateVPCWithHostedZone

readList :: ReadS [AssociateVPCWithHostedZone]

readPrec :: ReadPrec AssociateVPCWithHostedZone

readListPrec :: ReadPrec [AssociateVPCWithHostedZone]

Show AssociateVPCWithHostedZone

Defined in Amazonka.Route53.AssociateVPCWithHostedZone

Methods

showsPrec :: Int -> AssociateVPCWithHostedZone -> ShowS

show :: AssociateVPCWithHostedZone -> String

showList :: [AssociateVPCWithHostedZone] -> ShowS

NFData AssociateVPCWithHostedZone

Defined in Amazonka.Route53.AssociateVPCWithHostedZone

Methods

rnf :: AssociateVPCWithHostedZone -> ()

Eq AssociateVPCWithHostedZone

Defined in Amazonka.Route53.AssociateVPCWithHostedZone

Methods

(==) :: AssociateVPCWithHostedZone -> AssociateVPCWithHostedZone -> Bool

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

Hashable AssociateVPCWithHostedZone

Defined in Amazonka.Route53.AssociateVPCWithHostedZone

Methods

hashWithSalt :: Int -> AssociateVPCWithHostedZone -> Int

hash :: AssociateVPCWithHostedZone -> Int

type AWSResponse AssociateVPCWithHostedZone

Defined in Amazonka.Route53.AssociateVPCWithHostedZone

type AWSResponse AssociateVPCWithHostedZone = AssociateVPCWithHostedZoneResponse

type Rep AssociateVPCWithHostedZone

Defined in Amazonka.Route53.AssociateVPCWithHostedZone

type Rep AssociateVPCWithHostedZone = D1 ('MetaData "AssociateVPCWithHostedZone" "Amazonka.Route53.AssociateVPCWithHostedZone" "amazonka-route53-2.0-8wP357MyuPX6rh87d4wklb" 'False) (C1 ('MetaCons "AssociateVPCWithHostedZone'" 'PrefixI 'True) (S1 ('MetaSel ('Just "comment") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: (S1 ('MetaSel ('Just "hostedZoneId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 ResourceId) :*: S1 ('MetaSel ('Just "vpc") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 VPC))))

newAssociateVPCWithHostedZone

Arguments

:: ResourceId

AssociateVPCWithHostedZone

-> VPC

$sel:vpc:AssociateVPCWithHostedZone'

-> AssociateVPCWithHostedZone

Create a value of AssociateVPCWithHostedZone 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:

AssociateVPCWithHostedZone, associateVPCWithHostedZone_comment - Optional: A comment about the association request.

AssociateVPCWithHostedZone, associateVPCWithHostedZone_hostedZoneId - 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.

$sel:vpc:AssociateVPCWithHostedZone', associateVPCWithHostedZone_vpc - A complex type that contains information about the VPC that you want to associate with a private hosted zone.

Request Lenses

associateVPCWithHostedZone_comment :: Lens' AssociateVPCWithHostedZone (Maybe Text)

Optional: A comment about the association request.

associateVPCWithHostedZone_hostedZoneId :: Lens' AssociateVPCWithHostedZone ResourceId

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.

associateVPCWithHostedZone_vpc :: Lens' AssociateVPCWithHostedZone VPC

A complex type that contains information about the VPC that you want to associate with a private hosted zone.

Destructuring the Response

data AssociateVPCWithHostedZoneResponse

A complex type that contains the response information for the AssociateVPCWithHostedZone request.

See: newAssociateVPCWithHostedZoneResponse smart constructor.

Constructors

AssociateVPCWithHostedZoneResponse'

Fields

• httpStatus :: Int

  The response's http status code.

• changeInfo :: ChangeInfo

  A complex type that describes the changes made to your hosted zone.

Instances

Generic AssociateVPCWithHostedZoneResponse

Defined in Amazonka.Route53.AssociateVPCWithHostedZone

Associated Types

type Rep AssociateVPCWithHostedZoneResponse :: Type -> Type

Methods

from :: AssociateVPCWithHostedZoneResponse -> Rep AssociateVPCWithHostedZoneResponse x

to :: Rep AssociateVPCWithHostedZoneResponse x -> AssociateVPCWithHostedZoneResponse

Read AssociateVPCWithHostedZoneResponse

Defined in Amazonka.Route53.AssociateVPCWithHostedZone

Methods

readsPrec :: Int -> ReadS AssociateVPCWithHostedZoneResponse

readList :: ReadS [AssociateVPCWithHostedZoneResponse]

readPrec :: ReadPrec AssociateVPCWithHostedZoneResponse

readListPrec :: ReadPrec [AssociateVPCWithHostedZoneResponse]

Show AssociateVPCWithHostedZoneResponse

Defined in Amazonka.Route53.AssociateVPCWithHostedZone

Methods

showsPrec :: Int -> AssociateVPCWithHostedZoneResponse -> ShowS

show :: AssociateVPCWithHostedZoneResponse -> String

showList :: [AssociateVPCWithHostedZoneResponse] -> ShowS

NFData AssociateVPCWithHostedZoneResponse

Defined in Amazonka.Route53.AssociateVPCWithHostedZone

Methods

rnf :: AssociateVPCWithHostedZoneResponse -> ()

Eq AssociateVPCWithHostedZoneResponse

Defined in Amazonka.Route53.AssociateVPCWithHostedZone

Methods

(==) :: AssociateVPCWithHostedZoneResponse -> AssociateVPCWithHostedZoneResponse -> Bool

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

type Rep AssociateVPCWithHostedZoneResponse

Defined in Amazonka.Route53.AssociateVPCWithHostedZone

type Rep AssociateVPCWithHostedZoneResponse = D1 ('MetaData "AssociateVPCWithHostedZoneResponse" "Amazonka.Route53.AssociateVPCWithHostedZone" "amazonka-route53-2.0-8wP357MyuPX6rh87d4wklb" 'False) (C1 ('MetaCons "AssociateVPCWithHostedZoneResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int) :*: S1 ('MetaSel ('Just "changeInfo") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 ChangeInfo)))

newAssociateVPCWithHostedZoneResponse

Arguments

:: Int

$sel:httpStatus:AssociateVPCWithHostedZoneResponse'

-> ChangeInfo

$sel:changeInfo:AssociateVPCWithHostedZoneResponse'

-> AssociateVPCWithHostedZoneResponse

Create a value of AssociateVPCWithHostedZoneResponse 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:httpStatus:AssociateVPCWithHostedZoneResponse', associateVPCWithHostedZoneResponse_httpStatus - The response's http status code.

$sel:changeInfo:AssociateVPCWithHostedZoneResponse', associateVPCWithHostedZoneResponse_changeInfo - A complex type that describes the changes made to your hosted zone.

Response Lenses

associateVPCWithHostedZoneResponse_httpStatus :: Lens' AssociateVPCWithHostedZoneResponse Int

The response's http status code.

associateVPCWithHostedZoneResponse_changeInfo :: Lens' AssociateVPCWithHostedZoneResponse ChangeInfo

A complex type that describes the changes made to your hosted zone.