AWS SDK for Go (PILOT)
API Reference

PREVIEW DOCUMENTATION - This is a preview of a new format for the AWS SDK for Go API Reference documentation. For the current AWS SDK for Go API Reference, see https://docs.aws.amazon.com/sdk-for-go/api/.

We welcome your feedback on this new version of the documentation. Send your comments to aws-sdkdocs-feedback@amazon.com.

Route53

import "github.com/aws/aws-sdk-go/service/route53"

type Route53 struct { *client.Client }

Route53 provides the API operation methods for making requests to Amazon Route 53. See this package's package overview docs for details on the service.

Route53 methods are safe to use concurrently. It is not safe to modify mutate any of the struct's properties though.

Client

Type: *client.Client

Method

AssociateVPCWithHostedZone

func (c *Route53) AssociateVPCWithHostedZone(input *AssociateVPCWithHostedZoneInput) (*AssociateVPCWithHostedZoneOutput, error)

AssociateVPCWithHostedZone API operation for Amazon Route 53.

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 AWS account with a private hosted zone that was created by using a different account, the AWS 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.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation AssociateVPCWithHostedZone for usage and error information.

Returned Error Codes:

  • ErrCodeNoSuchHostedZone "NoSuchHostedZone" No hosted zone exists with the ID that you specified.

  • ErrCodeNotAuthorizedException "NotAuthorizedException" Associating the specified VPC with the specified hosted zone has not been authorized.

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

  • ErrCodeInvalidInput "InvalidInput" The input is not valid.

  • ErrCodePublicZoneVPCAssociation "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.

  • ErrCodeConflictingDomainExists "ConflictingDomainExists" The cause of this error depends on whether you're trying to create a public or a private hosted zone:

  • 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.

  • Private hosted zone: You specified an Amazon VPC that you're already using for another hosted zone, and the domain that you specified for one of the hosted zones is a subdomain of the domain that you specified for the other hosted zone. For example, you can't use the same Amazon VPC for the hosted zones for example.com and test.example.com.

  • ErrCodeLimitsExceeded "LimitsExceeded" This operation can't be completed either because the current account has reached the limit on reusable delegation sets that it can create or because you've reached the limit on the number of Amazon VPCs that you can associate with a private hosted zone. To get the current limit on the number of reusable delegation sets, see GetAccountLimit. To get the current limit on the number of Amazon VPCs that you can associate with a private hosted zone, see GetHostedZoneLimit. To request a higher limit, create a case (https://aws.amazon.com/route53-request) with the AWS Support Center.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/AssociateVPCWithHostedZone

Example

Route53 AssociateVPCWithHostedZone shared00

To associate a VPC with a hosted zone

The following example associates the VPC with ID vpc-1a2b3c4d with the hosted zone with ID Z3M3LMPEXAMPLE.

{ svc := route53.New(session.New()) input := &route53.AssociateVPCWithHostedZoneInput{ Comment: aws.String(""), HostedZoneId: aws.String("Z3M3LMPEXAMPLE"), VPC: &route53.VPC{ VPCId: aws.String("vpc-1a2b3c4d"), VPCRegion: aws.String("us-east-2"), }, } result, err := svc.AssociateVPCWithHostedZone(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case route53.ErrCodeNoSuchHostedZone: fmt.Println(route53.ErrCodeNoSuchHostedZone, aerr.Error()) case route53.ErrCodeNotAuthorizedException: fmt.Println(route53.ErrCodeNotAuthorizedException, aerr.Error()) case route53.ErrCodeInvalidVPCId: fmt.Println(route53.ErrCodeInvalidVPCId, aerr.Error()) case route53.ErrCodeInvalidInput: fmt.Println(route53.ErrCodeInvalidInput, aerr.Error()) case route53.ErrCodePublicZoneVPCAssociation: fmt.Println(route53.ErrCodePublicZoneVPCAssociation, aerr.Error()) case route53.ErrCodeConflictingDomainExists: fmt.Println(route53.ErrCodeConflictingDomainExists, aerr.Error()) case route53.ErrCodeLimitsExceeded: fmt.Println(route53.ErrCodeLimitsExceeded, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

AssociateVPCWithHostedZoneRequest

func (c *Route53) AssociateVPCWithHostedZoneRequest(input *AssociateVPCWithHostedZoneInput) (req *request.Request, output *AssociateVPCWithHostedZoneOutput)

AssociateVPCWithHostedZoneRequest generates a "aws/request.Request" representing the client's request for the AssociateVPCWithHostedZone operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See AssociateVPCWithHostedZone for more information on using the AssociateVPCWithHostedZone API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the AssociateVPCWithHostedZoneRequest method. req, resp := client.AssociateVPCWithHostedZoneRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/AssociateVPCWithHostedZone

AssociateVPCWithHostedZoneWithContext

func (c *Route53) AssociateVPCWithHostedZoneWithContext(ctx aws.Context, input *AssociateVPCWithHostedZoneInput, opts ...request.Option) (*AssociateVPCWithHostedZoneOutput, error)

AssociateVPCWithHostedZoneWithContext is the same as AssociateVPCWithHostedZone with the addition of the ability to pass a context and additional request options.

See AssociateVPCWithHostedZone for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

ChangeResourceRecordSets

func (c *Route53) ChangeResourceRecordSets(input *ChangeResourceRecordSetsInput) (*ChangeResourceRecordSetsOutput, error)

ChangeResourceRecordSets API operation for Amazon Route 53.

Creates, changes, or deletes a resource record set, which contains authoritative DNS information for a specified domain name or subdomain name. For example, you can use ChangeResourceRecordSets to create a resource record set that routes traffic for test.example.com to a web server that has an IP address of 192.0.2.44.

Change Batches and Transactional Changes

The request body must include a document with a ChangeResourceRecordSetsRequest element. The request body contains a list of change items, known as a change batch. Change batches are considered transactional changes. When using the Amazon Route 53 API to change resource record sets, Route 53 either makes all or none of the changes in a change batch request. This ensures that Route 53 never partially implements the intended changes to the resource record sets in a hosted zone.

For example, a change batch request that deletes the CNAME record for www.example.com and creates an alias resource record set for www.example.com. Route 53 deletes the first resource record set and creates the second resource record set in a single operation. If either the DELETE or the CREATE action fails, then both changes (plus any other changes in the batch) fail, and the original CNAME record continues to exist.

Due to the nature of transactional changes, you can't delete the same resource record set more than once in a single change batch. If you attempt to delete the same change batch more than once, Route 53 returns an InvalidChangeBatch error.

Traffic Flow

To create resource record sets for complex routing configurations, use either the traffic flow visual editor in the Route 53 console or the API actions for traffic policies and traffic policy instances. Save the configuration as a traffic policy, then associate the traffic policy with one or more domain names (such as example.com) or subdomain names (such as www.example.com), in the same hosted zone or in multiple hosted zones. You can roll back the updates if the new configuration isn't performing as expected. For more information, see Using Traffic Flow to Route DNS Traffic (https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/traffic-flow.html) in the Amazon Route 53 Developer Guide.

Create, Delete, and Upsert

Use ChangeResourceRecordsSetsRequest to perform the following actions:

  • CREATE: Creates a resource record set that has the specified values.

  • DELETE: Deletes an existing resource record set that has the specified values.

  • UPSERT: If a resource record set does not already exist, AWS creates it. If a resource set does exist, Route 53 updates it with the values in the request.

Syntaxes for Creating, Updating, and Deleting Resource Record Sets

The syntax for a request depends on the type of resource record set that you want to create, delete, or update, such as weighted, alias, or failover. The XML elements in your request must appear in the order listed in the syntax.

For an example for each type of resource record set, see "Examples."

Don't refer to the syntax in the "Parameter Syntax" section, which includes all of the elements for every kind of resource record set that you can create, delete, or update by using ChangeResourceRecordSets.

Change Propagation to Route 53 DNS Servers

When you submit a ChangeResourceRecordSets request, Route 53 propagates your changes to all of the Route 53 authoritative DNS servers. While your changes are propagating, GetChange returns a status of PENDING. When propagation is complete, GetChange returns a status of INSYNC. Changes generally propagate to all Route 53 name servers within 60 seconds. For more information, see GetChange.

Limits on ChangeResourceRecordSets Requests

For information about the limits on a ChangeResourceRecordSets request, see Limits (https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/DNSLimitations.html) in the Amazon Route 53 Developer Guide.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation ChangeResourceRecordSets for usage and error information.

Returned Error Codes:

  • ErrCodeNoSuchHostedZone "NoSuchHostedZone" No hosted zone exists with the ID that you specified.

  • ErrCodeNoSuchHealthCheck "NoSuchHealthCheck" No health check exists with the specified ID.

  • ErrCodeInvalidChangeBatch "InvalidChangeBatch" This exception contains a list of messages that might contain one or more error messages. Each error message indicates one error in the change batch.

  • ErrCodeInvalidInput "InvalidInput" The input is not valid.

  • ErrCodePriorRequestNotComplete "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.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ChangeResourceRecordSets

Examples

Route53 ChangeResourceRecordSets shared00

To create a basic resource record set

The following example creates a resource record set that routes Internet traffic to a resource with an IP address of 192.0.2.44.

{ svc := route53.New(session.New()) input := &route53.ChangeResourceRecordSetsInput{ ChangeBatch: &route53.ChangeBatch{ Changes: []*route53.Change{ { Action: aws.String("CREATE"), ResourceRecordSet: &route53.ResourceRecordSet{ Name: aws.String("example.com"), ResourceRecords: []*route53.ResourceRecord{ { Value: aws.String("192.0.2.44"), }, }, TTL: aws.Int64(60), Type: aws.String("A"), }, }, }, Comment: aws.String("Web server for example.com"), }, HostedZoneId: aws.String("Z3M3LMPEXAMPLE"), } result, err := svc.ChangeResourceRecordSets(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case route53.ErrCodeNoSuchHostedZone: fmt.Println(route53.ErrCodeNoSuchHostedZone, aerr.Error()) case route53.ErrCodeNoSuchHealthCheck: fmt.Println(route53.ErrCodeNoSuchHealthCheck, aerr.Error()) case route53.ErrCodeInvalidChangeBatch: fmt.Println(route53.ErrCodeInvalidChangeBatch, aerr.Error()) case route53.ErrCodeInvalidInput: fmt.Println(route53.ErrCodeInvalidInput, aerr.Error()) case route53.ErrCodePriorRequestNotComplete: fmt.Println(route53.ErrCodePriorRequestNotComplete, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }
Route53 ChangeResourceRecordSets shared01

To create weighted resource record sets

The following example creates two weighted resource record sets. The resource with a Weight of 100 will get 1/3rd of traffic (100/100+200), and the other resource will get the rest of the traffic for example.com.

{ svc := route53.New(session.New()) input := &route53.ChangeResourceRecordSetsInput{ ChangeBatch: &route53.ChangeBatch{ Changes: []*route53.Change{ { Action: aws.String("CREATE"), ResourceRecordSet: &route53.ResourceRecordSet{ HealthCheckId: aws.String("abcdef11-2222-3333-4444-555555fedcba"), Name: aws.String("example.com"), ResourceRecords: []*route53.ResourceRecord{ { Value: aws.String("192.0.2.44"), }, }, SetIdentifier: aws.String("Seattle data center"), TTL: aws.Int64(60), Type: aws.String("A"), Weight: aws.Int64(100), }, }, { Action: aws.String("CREATE"), ResourceRecordSet: &route53.ResourceRecordSet{ HealthCheckId: aws.String("abcdef66-7777-8888-9999-000000fedcba"), Name: aws.String("example.com"), ResourceRecords: []*route53.ResourceRecord{ { Value: aws.String("192.0.2.45"), }, }, SetIdentifier: aws.String("Portland data center"), TTL: aws.Int64(60), Type: aws.String("A"), Weight: aws.Int64(200), }, }, }, Comment: aws.String("Web servers for example.com"), }, HostedZoneId: aws.String("Z3M3LMPEXAMPLE"), } result, err := svc.ChangeResourceRecordSets(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case route53.ErrCodeNoSuchHostedZone: fmt.Println(route53.ErrCodeNoSuchHostedZone, aerr.Error()) case route53.ErrCodeNoSuchHealthCheck: fmt.Println(route53.ErrCodeNoSuchHealthCheck, aerr.Error()) case route53.ErrCodeInvalidChangeBatch: fmt.Println(route53.ErrCodeInvalidChangeBatch, aerr.Error()) case route53.ErrCodeInvalidInput: fmt.Println(route53.ErrCodeInvalidInput, aerr.Error()) case route53.ErrCodePriorRequestNotComplete: fmt.Println(route53.ErrCodePriorRequestNotComplete, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }
Route53 ChangeResourceRecordSets shared02

To create an alias resource record set

The following example creates an alias resource record set that routes traffic to a CloudFront distribution.

{ svc := route53.New(session.New()) input := &route53.ChangeResourceRecordSetsInput{ ChangeBatch: &route53.ChangeBatch{ Changes: []*route53.Change{ { Action: aws.String("CREATE"), ResourceRecordSet: &route53.ResourceRecordSet{ AliasTarget: &route53.AliasTarget{ DNSName: aws.String("d123rk29d0stfj.cloudfront.net"), EvaluateTargetHealth: aws.Bool(false), HostedZoneId: aws.String("Z2FDTNDATAQYW2"), }, Name: aws.String("example.com"), Type: aws.String("A"), }, }, }, Comment: aws.String("CloudFront distribution for example.com"), }, HostedZoneId: aws.String("Z3M3LMPEXAMPLE"), } result, err := svc.ChangeResourceRecordSets(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case route53.ErrCodeNoSuchHostedZone: fmt.Println(route53.ErrCodeNoSuchHostedZone, aerr.Error()) case route53.ErrCodeNoSuchHealthCheck: fmt.Println(route53.ErrCodeNoSuchHealthCheck, aerr.Error()) case route53.ErrCodeInvalidChangeBatch: fmt.Println(route53.ErrCodeInvalidChangeBatch, aerr.Error()) case route53.ErrCodeInvalidInput: fmt.Println(route53.ErrCodeInvalidInput, aerr.Error()) case route53.ErrCodePriorRequestNotComplete: fmt.Println(route53.ErrCodePriorRequestNotComplete, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }
Route53 ChangeResourceRecordSets shared03

To create weighted alias resource record sets

The following example creates two weighted alias resource record sets that route traffic to ELB load balancers. The resource with a Weight of 100 will get 1/3rd of traffic (100/100+200), and the other resource will get the rest of the traffic for example.com.

{ svc := route53.New(session.New()) input := &route53.ChangeResourceRecordSetsInput{ ChangeBatch: &route53.ChangeBatch{ Changes: []*route53.Change{ { Action: aws.String("CREATE"), ResourceRecordSet: &route53.ResourceRecordSet{ AliasTarget: &route53.AliasTarget{ DNSName: aws.String("example-com-123456789.us-east-2.elb.amazonaws.com "), EvaluateTargetHealth: aws.Bool(true), HostedZoneId: aws.String("Z3AADJGX6KTTL2"), }, Name: aws.String("example.com"), SetIdentifier: aws.String("Ohio region"), Type: aws.String("A"), Weight: aws.Int64(100), }, }, { Action: aws.String("CREATE"), ResourceRecordSet: &route53.ResourceRecordSet{ AliasTarget: &route53.AliasTarget{ DNSName: aws.String("example-com-987654321.us-west-2.elb.amazonaws.com "), EvaluateTargetHealth: aws.Bool(true), HostedZoneId: aws.String("Z1H1FL5HABSF5"), }, Name: aws.String("example.com"), SetIdentifier: aws.String("Oregon region"), Type: aws.String("A"), Weight: aws.Int64(200), }, }, }, Comment: aws.String("ELB load balancers for example.com"), }, HostedZoneId: aws.String("Z3M3LMPEXAMPLE"), } result, err := svc.ChangeResourceRecordSets(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case route53.ErrCodeNoSuchHostedZone: fmt.Println(route53.ErrCodeNoSuchHostedZone, aerr.Error()) case route53.ErrCodeNoSuchHealthCheck: fmt.Println(route53.ErrCodeNoSuchHealthCheck, aerr.Error()) case route53.ErrCodeInvalidChangeBatch: fmt.Println(route53.ErrCodeInvalidChangeBatch, aerr.Error()) case route53.ErrCodeInvalidInput: fmt.Println(route53.ErrCodeInvalidInput, aerr.Error()) case route53.ErrCodePriorRequestNotComplete: fmt.Println(route53.ErrCodePriorRequestNotComplete, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }
Route53 ChangeResourceRecordSets shared04

To create latency resource record sets

The following example creates two latency resource record sets that route traffic to EC2 instances. Traffic for example.com is routed either to the Ohio region or the Oregon region, depending on the latency between the user and those regions.

{ svc := route53.New(session.New()) input := &route53.ChangeResourceRecordSetsInput{ ChangeBatch: &route53.ChangeBatch{ Changes: []*route53.Change{ { Action: aws.String("CREATE"), ResourceRecordSet: &route53.ResourceRecordSet{ HealthCheckId: aws.String("abcdef11-2222-3333-4444-555555fedcba"), Name: aws.String("example.com"), Region: aws.String("us-east-2"), ResourceRecords: []*route53.ResourceRecord{ { Value: aws.String("192.0.2.44"), }, }, SetIdentifier: aws.String("Ohio region"), TTL: aws.Int64(60), Type: aws.String("A"), }, }, { Action: aws.String("CREATE"), ResourceRecordSet: &route53.ResourceRecordSet{ HealthCheckId: aws.String("abcdef66-7777-8888-9999-000000fedcba"), Name: aws.String("example.com"), Region: aws.String("us-west-2"), ResourceRecords: []*route53.ResourceRecord{ { Value: aws.String("192.0.2.45"), }, }, SetIdentifier: aws.String("Oregon region"), TTL: aws.Int64(60), Type: aws.String("A"), }, }, }, Comment: aws.String("EC2 instances for example.com"), }, HostedZoneId: aws.String("Z3M3LMPEXAMPLE"), } result, err := svc.ChangeResourceRecordSets(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case route53.ErrCodeNoSuchHostedZone: fmt.Println(route53.ErrCodeNoSuchHostedZone, aerr.Error()) case route53.ErrCodeNoSuchHealthCheck: fmt.Println(route53.ErrCodeNoSuchHealthCheck, aerr.Error()) case route53.ErrCodeInvalidChangeBatch: fmt.Println(route53.ErrCodeInvalidChangeBatch, aerr.Error()) case route53.ErrCodeInvalidInput: fmt.Println(route53.ErrCodeInvalidInput, aerr.Error()) case route53.ErrCodePriorRequestNotComplete: fmt.Println(route53.ErrCodePriorRequestNotComplete, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }
Route53 ChangeResourceRecordSets shared05

To create latency alias resource record sets

The following example creates two latency alias resource record sets that route traffic for example.com to ELB load balancers. Requests are routed either to the Ohio region or the Oregon region, depending on the latency between the user and those regions.

{ svc := route53.New(session.New()) input := &route53.ChangeResourceRecordSetsInput{ ChangeBatch: &route53.ChangeBatch{ Changes: []*route53.Change{ { Action: aws.String("CREATE"), ResourceRecordSet: &route53.ResourceRecordSet{ AliasTarget: &route53.AliasTarget{ DNSName: aws.String("example-com-123456789.us-east-2.elb.amazonaws.com "), EvaluateTargetHealth: aws.Bool(true), HostedZoneId: aws.String("Z3AADJGX6KTTL2"), }, Name: aws.String("example.com"), Region: aws.String("us-east-2"), SetIdentifier: aws.String("Ohio region"), Type: aws.String("A"), }, }, { Action: aws.String("CREATE"), ResourceRecordSet: &route53.ResourceRecordSet{ AliasTarget: &route53.AliasTarget{ DNSName: aws.String("example-com-987654321.us-west-2.elb.amazonaws.com "), EvaluateTargetHealth: aws.Bool(true), HostedZoneId: aws.String("Z1H1FL5HABSF5"), }, Name: aws.String("example.com"), Region: aws.String("us-west-2"), SetIdentifier: aws.String("Oregon region"), Type: aws.String("A"), }, }, }, Comment: aws.String("ELB load balancers for example.com"), }, HostedZoneId: aws.String("Z3M3LMPEXAMPLE"), } result, err := svc.ChangeResourceRecordSets(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case route53.ErrCodeNoSuchHostedZone: fmt.Println(route53.ErrCodeNoSuchHostedZone, aerr.Error()) case route53.ErrCodeNoSuchHealthCheck: fmt.Println(route53.ErrCodeNoSuchHealthCheck, aerr.Error()) case route53.ErrCodeInvalidChangeBatch: fmt.Println(route53.ErrCodeInvalidChangeBatch, aerr.Error()) case route53.ErrCodeInvalidInput: fmt.Println(route53.ErrCodeInvalidInput, aerr.Error()) case route53.ErrCodePriorRequestNotComplete: fmt.Println(route53.ErrCodePriorRequestNotComplete, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }
Route53 ChangeResourceRecordSets shared06

To create failover resource record sets

The following example creates primary and secondary failover resource record sets that route traffic to EC2 instances. Traffic is generally routed to the primary resource, in the Ohio region. If that resource is unavailable, traffic is routed to the secondary resource, in the Oregon region.

{ svc := route53.New(session.New()) input := &route53.ChangeResourceRecordSetsInput{ ChangeBatch: &route53.ChangeBatch{ Changes: []*route53.Change{ { Action: aws.String("CREATE"), ResourceRecordSet: &route53.ResourceRecordSet{ Failover: aws.String("PRIMARY"), HealthCheckId: aws.String("abcdef11-2222-3333-4444-555555fedcba"), Name: aws.String("example.com"), ResourceRecords: []*route53.ResourceRecord{ { Value: aws.String("192.0.2.44"), }, }, SetIdentifier: aws.String("Ohio region"), TTL: aws.Int64(60), Type: aws.String("A"), }, }, { Action: aws.String("CREATE"), ResourceRecordSet: &route53.ResourceRecordSet{ Failover: aws.String("SECONDARY"), HealthCheckId: aws.String("abcdef66-7777-8888-9999-000000fedcba"), Name: aws.String("example.com"), ResourceRecords: []*route53.ResourceRecord{ { Value: aws.String("192.0.2.45"), }, }, SetIdentifier: aws.String("Oregon region"), TTL: aws.Int64(60), Type: aws.String("A"), }, }, }, Comment: aws.String("Failover configuration for example.com"), }, HostedZoneId: aws.String("Z3M3LMPEXAMPLE"), } result, err := svc.ChangeResourceRecordSets(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case route53.ErrCodeNoSuchHostedZone: fmt.Println(route53.ErrCodeNoSuchHostedZone, aerr.Error()) case route53.ErrCodeNoSuchHealthCheck: fmt.Println(route53.ErrCodeNoSuchHealthCheck, aerr.Error()) case route53.ErrCodeInvalidChangeBatch: fmt.Println(route53.ErrCodeInvalidChangeBatch, aerr.Error()) case route53.ErrCodeInvalidInput: fmt.Println(route53.ErrCodeInvalidInput, aerr.Error()) case route53.ErrCodePriorRequestNotComplete: fmt.Println(route53.ErrCodePriorRequestNotComplete, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }
Route53 ChangeResourceRecordSets shared07

To create failover alias resource record sets

The following example creates primary and secondary failover alias resource record sets that route traffic to ELB load balancers. Traffic is generally routed to the primary resource, in the Ohio region. If that resource is unavailable, traffic is routed to the secondary resource, in the Oregon region.

{ svc := route53.New(session.New()) input := &route53.ChangeResourceRecordSetsInput{ ChangeBatch: &route53.ChangeBatch{ Changes: []*route53.Change{ { Action: aws.String("CREATE"), ResourceRecordSet: &route53.ResourceRecordSet{ AliasTarget: &route53.AliasTarget{ DNSName: aws.String("example-com-123456789.us-east-2.elb.amazonaws.com "), EvaluateTargetHealth: aws.Bool(true), HostedZoneId: aws.String("Z3AADJGX6KTTL2"), }, Failover: aws.String("PRIMARY"), Name: aws.String("example.com"), SetIdentifier: aws.String("Ohio region"), Type: aws.String("A"), }, }, { Action: aws.String("CREATE"), ResourceRecordSet: &route53.ResourceRecordSet{ AliasTarget: &route53.AliasTarget{ DNSName: aws.String("example-com-987654321.us-west-2.elb.amazonaws.com "), EvaluateTargetHealth: aws.Bool(true), HostedZoneId: aws.String("Z1H1FL5HABSF5"), }, Failover: aws.String("SECONDARY"), Name: aws.String("example.com"), SetIdentifier: aws.String("Oregon region"), Type: aws.String("A"), }, }, }, Comment: aws.String("Failover alias configuration for example.com"), }, HostedZoneId: aws.String("Z3M3LMPEXAMPLE"), } result, err := svc.ChangeResourceRecordSets(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case route53.ErrCodeNoSuchHostedZone: fmt.Println(route53.ErrCodeNoSuchHostedZone, aerr.Error()) case route53.ErrCodeNoSuchHealthCheck: fmt.Println(route53.ErrCodeNoSuchHealthCheck, aerr.Error()) case route53.ErrCodeInvalidChangeBatch: fmt.Println(route53.ErrCodeInvalidChangeBatch, aerr.Error()) case route53.ErrCodeInvalidInput: fmt.Println(route53.ErrCodeInvalidInput, aerr.Error()) case route53.ErrCodePriorRequestNotComplete: fmt.Println(route53.ErrCodePriorRequestNotComplete, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }
Route53 ChangeResourceRecordSets shared08

To create geolocation resource record sets

The following example creates four geolocation resource record sets that use IPv4 addresses to route traffic to resources such as web servers running on EC2 instances. Traffic is routed to one of four IP addresses, for North America (NA), for South America (SA), for Europe (EU), and for all other locations (*).

{ svc := route53.New(session.New()) input := &route53.ChangeResourceRecordSetsInput{ ChangeBatch: &route53.ChangeBatch{ Changes: []*route53.Change{ { Action: aws.String("CREATE"), ResourceRecordSet: &route53.ResourceRecordSet{ GeoLocation: &route53.GeoLocation{ ContinentCode: aws.String("NA"), }, Name: aws.String("example.com"), ResourceRecords: []*route53.ResourceRecord{ { Value: aws.String("192.0.2.44"), }, }, SetIdentifier: aws.String("North America"), TTL: aws.Int64(60), Type: aws.String("A"), }, }, { Action: aws.String("CREATE"), ResourceRecordSet: &route53.ResourceRecordSet{ GeoLocation: &route53.GeoLocation{ ContinentCode: aws.String("SA"), }, Name: aws.String("example.com"), ResourceRecords: []*route53.ResourceRecord{ { Value: aws.String("192.0.2.45"), }, }, SetIdentifier: aws.String("South America"), TTL: aws.Int64(60), Type: aws.String("A"), }, }, { Action: aws.String("CREATE"), ResourceRecordSet: &route53.ResourceRecordSet{ GeoLocation: &route53.GeoLocation{ ContinentCode: aws.String("EU"), }, Name: aws.String("example.com"), ResourceRecords: []*route53.ResourceRecord{ { Value: aws.String("192.0.2.46"), }, }, SetIdentifier: aws.String("Europe"), TTL: aws.Int64(60), Type: aws.String("A"), }, }, { Action: aws.String("CREATE"), ResourceRecordSet: &route53.ResourceRecordSet{ GeoLocation: &route53.GeoLocation{ CountryCode: aws.String("*"), }, Name: aws.String("example.com"), ResourceRecords: []*route53.ResourceRecord{ { Value: aws.String("192.0.2.47"), }, }, SetIdentifier: aws.String("Other locations"), TTL: aws.Int64(60), Type: aws.String("A"), }, }, }, Comment: aws.String("Geolocation configuration for example.com"), }, HostedZoneId: aws.String("Z3M3LMPEXAMPLE"), } result, err := svc.ChangeResourceRecordSets(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case route53.ErrCodeNoSuchHostedZone: fmt.Println(route53.ErrCodeNoSuchHostedZone, aerr.Error()) case route53.ErrCodeNoSuchHealthCheck: fmt.Println(route53.ErrCodeNoSuchHealthCheck, aerr.Error()) case route53.ErrCodeInvalidChangeBatch: fmt.Println(route53.ErrCodeInvalidChangeBatch, aerr.Error()) case route53.ErrCodeInvalidInput: fmt.Println(route53.ErrCodeInvalidInput, aerr.Error()) case route53.ErrCodePriorRequestNotComplete: fmt.Println(route53.ErrCodePriorRequestNotComplete, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }
Route53 ChangeResourceRecordSets shared09

To create geolocation alias resource record sets

The following example creates four geolocation alias resource record sets that route traffic to ELB load balancers. Traffic is routed to one of four IP addresses, for North America (NA), for South America (SA), for Europe (EU), and for all other locations (*).

{ svc := route53.New(session.New()) input := &route53.ChangeResourceRecordSetsInput{ ChangeBatch: &route53.ChangeBatch{ Changes: []*route53.Change{ { Action: aws.String("CREATE"), ResourceRecordSet: &route53.ResourceRecordSet{ AliasTarget: &route53.AliasTarget{ DNSName: aws.String("example-com-123456789.us-east-2.elb.amazonaws.com "), EvaluateTargetHealth: aws.Bool(true), HostedZoneId: aws.String("Z3AADJGX6KTTL2"), }, GeoLocation: &route53.GeoLocation{ ContinentCode: aws.String("NA"), }, Name: aws.String("example.com"), SetIdentifier: aws.String("North America"), Type: aws.String("A"), }, }, { Action: aws.String("CREATE"), ResourceRecordSet: &route53.ResourceRecordSet{ AliasTarget: &route53.AliasTarget{ DNSName: aws.String("example-com-234567890.sa-east-1.elb.amazonaws.com "), EvaluateTargetHealth: aws.Bool(true), HostedZoneId: aws.String("Z2P70J7HTTTPLU"), }, GeoLocation: &route53.GeoLocation{ ContinentCode: aws.String("SA"), }, Name: aws.String("example.com"), SetIdentifier: aws.String("South America"), Type: aws.String("A"), }, }, { Action: aws.String("CREATE"), ResourceRecordSet: &route53.ResourceRecordSet{ AliasTarget: &route53.AliasTarget{ DNSName: aws.String("example-com-234567890.eu-central-1.elb.amazonaws.com "), EvaluateTargetHealth: aws.Bool(true), HostedZoneId: aws.String("Z215JYRZR1TBD5"), }, GeoLocation: &route53.GeoLocation{ ContinentCode: aws.String("EU"), }, Name: aws.String("example.com"), SetIdentifier: aws.String("Europe"), Type: aws.String("A"), }, }, { Action: aws.String("CREATE"), ResourceRecordSet: &route53.ResourceRecordSet{ AliasTarget: &route53.AliasTarget{ DNSName: aws.String("example-com-234567890.ap-southeast-1.elb.amazonaws.com "), EvaluateTargetHealth: aws.Bool(true), HostedZoneId: aws.String("Z1LMS91P8CMLE5"), }, GeoLocation: &route53.GeoLocation{ CountryCode: aws.String("*"), }, Name: aws.String("example.com"), SetIdentifier: aws.String("Other locations"), Type: aws.String("A"), }, }, }, Comment: aws.String("Geolocation alias configuration for example.com"), }, HostedZoneId: aws.String("Z3M3LMPEXAMPLE"), } result, err := svc.ChangeResourceRecordSets(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case route53.ErrCodeNoSuchHostedZone: fmt.Println(route53.ErrCodeNoSuchHostedZone, aerr.Error()) case route53.ErrCodeNoSuchHealthCheck: fmt.Println(route53.ErrCodeNoSuchHealthCheck, aerr.Error()) case route53.ErrCodeInvalidChangeBatch: fmt.Println(route53.ErrCodeInvalidChangeBatch, aerr.Error()) case route53.ErrCodeInvalidInput: fmt.Println(route53.ErrCodeInvalidInput, aerr.Error()) case route53.ErrCodePriorRequestNotComplete: fmt.Println(route53.ErrCodePriorRequestNotComplete, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

ChangeResourceRecordSetsRequest

func (c *Route53) ChangeResourceRecordSetsRequest(input *ChangeResourceRecordSetsInput) (req *request.Request, output *ChangeResourceRecordSetsOutput)

ChangeResourceRecordSetsRequest generates a "aws/request.Request" representing the client's request for the ChangeResourceRecordSets operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See ChangeResourceRecordSets for more information on using the ChangeResourceRecordSets API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the ChangeResourceRecordSetsRequest method. req, resp := client.ChangeResourceRecordSetsRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ChangeResourceRecordSets

ChangeResourceRecordSetsWithContext

func (c *Route53) ChangeResourceRecordSetsWithContext(ctx aws.Context, input *ChangeResourceRecordSetsInput, opts ...request.Option) (*ChangeResourceRecordSetsOutput, error)

ChangeResourceRecordSetsWithContext is the same as ChangeResourceRecordSets with the addition of the ability to pass a context and additional request options.

See ChangeResourceRecordSets for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

ChangeTagsForResource

func (c *Route53) ChangeTagsForResource(input *ChangeTagsForResourceInput) (*ChangeTagsForResourceOutput, error)

ChangeTagsForResource API operation for Amazon Route 53.

Adds, edits, or deletes tags for a health check or a hosted zone.

For information about using tags for cost allocation, see Using Cost Allocation Tags (https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) in the AWS Billing and Cost Management User Guide.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation ChangeTagsForResource for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidInput "InvalidInput" The input is not valid.

  • ErrCodeNoSuchHealthCheck "NoSuchHealthCheck" No health check exists with the specified ID.

  • ErrCodeNoSuchHostedZone "NoSuchHostedZone" No hosted zone exists with the ID that you specified.

  • ErrCodePriorRequestNotComplete "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.

  • ErrCodeThrottlingException "ThrottlingException" The limit on the number of requests per second was exceeded.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ChangeTagsForResource

Example

Route53 ChangeTagsForResource shared00

To add or remove tags from a hosted zone or health check

The following example adds two tags and removes one tag from the hosted zone with ID Z3M3LMPEXAMPLE.

{ svc := route53.New(session.New()) input := &route53.ChangeTagsForResourceInput{ AddTags: []*route53.Tag{ { Key: aws.String("apex"), Value: aws.String("3874"), }, { Key: aws.String("acme"), Value: aws.String("4938"), }, }, RemoveTagKeys: []*string{ aws.String("Nadir"), }, ResourceId: aws.String("Z3M3LMPEXAMPLE"), ResourceType: aws.String("hostedzone"), } result, err := svc.ChangeTagsForResource(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case route53.ErrCodeInvalidInput: fmt.Println(route53.ErrCodeInvalidInput, aerr.Error()) case route53.ErrCodeNoSuchHealthCheck: fmt.Println(route53.ErrCodeNoSuchHealthCheck, aerr.Error()) case route53.ErrCodeNoSuchHostedZone: fmt.Println(route53.ErrCodeNoSuchHostedZone, aerr.Error()) case route53.ErrCodePriorRequestNotComplete: fmt.Println(route53.ErrCodePriorRequestNotComplete, aerr.Error()) case route53.ErrCodeThrottlingException: fmt.Println(route53.ErrCodeThrottlingException, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

ChangeTagsForResourceRequest

func (c *Route53) ChangeTagsForResourceRequest(input *ChangeTagsForResourceInput) (req *request.Request, output *ChangeTagsForResourceOutput)

ChangeTagsForResourceRequest generates a "aws/request.Request" representing the client's request for the ChangeTagsForResource operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See ChangeTagsForResource for more information on using the ChangeTagsForResource API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the ChangeTagsForResourceRequest method. req, resp := client.ChangeTagsForResourceRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ChangeTagsForResource

ChangeTagsForResourceWithContext

func (c *Route53) ChangeTagsForResourceWithContext(ctx aws.Context, input *ChangeTagsForResourceInput, opts ...request.Option) (*ChangeTagsForResourceOutput, error)

ChangeTagsForResourceWithContext is the same as ChangeTagsForResource with the addition of the ability to pass a context and additional request options.

See ChangeTagsForResource for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

CreateHealthCheck

func (c *Route53) CreateHealthCheck(input *CreateHealthCheckInput) (*CreateHealthCheckOutput, error)

CreateHealthCheck API operation for Amazon Route 53.

Creates a new health check.

For information about adding health checks to resource record sets, see ResourceRecordSet$HealthCheckId in ChangeResourceRecordSets.

ELB Load Balancers

If you're registering EC2 instances with an Elastic Load Balancing (ELB) load balancer, do not create Amazon Route 53 health checks for the EC2 instances. When you register an EC2 instance with a load balancer, you configure settings for an ELB health check, which performs a similar function to a Route 53 health check.

Private Hosted Zones

You can associate health checks with failover resource record sets in a private hosted zone. Note the following:

  • Route 53 health checkers are outside the VPC. To check the health of an endpoint within a VPC by IP address, you must assign a public IP address to the instance in the VPC.

  • You can configure a health checker to check the health of an external resource that the instance relies on, such as a database server.

  • You can create a CloudWatch metric, associate an alarm with the metric, and then create a health check that is based on the state of the alarm. For example, you might create a CloudWatch metric that checks the status of the Amazon EC2 StatusCheckFailed metric, add an alarm to the metric, and then create a health check that is based on the state of the alarm. For information about creating CloudWatch metrics and alarms by using the CloudWatch console, see the Amazon CloudWatch User Guide (https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/WhatIsCloudWatch.html).

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation CreateHealthCheck for usage and error information.

Returned Error Codes:

  • ErrCodeTooManyHealthChecks "TooManyHealthChecks" This health check can't be created because the current account has reached the limit on the number of active health checks.

For information about default limits, see Limits (http://docs.aws.amazon.com/Route53/latest/DeveloperGuide/DNSLimitations.html) in the Amazon Route 53 Developer Guide. For information about how to get the current limit for an account, see GetAccountLimit. To request a higher limit, create a case (http://aws.amazon.com/route53-request) with the AWS Support Center. You have reached the maximum number of active health checks for an AWS account. To request a higher limit, create a case (http://aws.amazon.com/route53-request) with the AWS Support Center.
  • ErrCodeHealthCheckAlreadyExists "HealthCheckAlreadyExists" The health check you're attempting to create already exists. Amazon Route 53 returns this error when you submit a request that has the following values:

  • The same value for CallerReference as an existing health check, and one or more values that differ from the existing health check that has the same caller reference.

  • The same value for CallerReference as a health check that you created and later deleted, regardless of the other settings in the request.

  • ErrCodeInvalidInput "InvalidInput" The input is not valid.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/CreateHealthCheck

CreateHealthCheckRequest

func (c *Route53) CreateHealthCheckRequest(input *CreateHealthCheckInput) (req *request.Request, output *CreateHealthCheckOutput)

CreateHealthCheckRequest generates a "aws/request.Request" representing the client's request for the CreateHealthCheck operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See CreateHealthCheck for more information on using the CreateHealthCheck API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the CreateHealthCheckRequest method. req, resp := client.CreateHealthCheckRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/CreateHealthCheck

CreateHealthCheckWithContext

func (c *Route53) CreateHealthCheckWithContext(ctx aws.Context, input *CreateHealthCheckInput, opts ...request.Option) (*CreateHealthCheckOutput, error)

CreateHealthCheckWithContext is the same as CreateHealthCheck with the addition of the ability to pass a context and additional request options.

See CreateHealthCheck for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

CreateHostedZone

func (c *Route53) CreateHostedZone(input *CreateHostedZoneInput) (*CreateHostedZoneOutput, error)

CreateHostedZone API operation for Amazon Route 53.

Creates a new public or private hosted zone. You create records in a public hosted zone to define how you want to route traffic on the internet for a domain, such as example.com, and its subdomains (apex.example.com, acme.example.com). You create records in a private hosted zone to define how you want to route traffic for a domain and its subdomains within one or more Amazon Virtual Private Clouds (Amazon VPCs).

You can't convert a public hosted zone to a private hosted zone or vice versa. Instead, you must create a new hosted zone with the same name and create new resource record sets.

For more information about charges for hosted zones, see Amazon Route 53 Pricing (https://aws.amazon.com/route53/pricing/).

Note the following:

  • You can't create a hosted zone for a top-level domain (TLD) such as .com.

If you want to use the same name servers for multiple public hosted zones,

you can optionally associate a reusable delegation set with the hosted zone. See the DelegationSetId element.
  • If your domain is registered with a registrar other than Route 53, you must update the name servers with your registrar to make Route 53 the DNS service for the domain. For more information, see Migrating DNS Service for an Existing Domain to Amazon Route 53 (https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/MigratingDNS.html) in the Amazon Route 53 Developer Guide.

When you submit a CreateHostedZone request, the initial status of the hosted zone is PENDING. For public hosted zones, this means that the NS and SOA records are not yet available on all Route 53 DNS servers. When the NS and SOA records are available, the status of the zone changes to INSYNC.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation CreateHostedZone for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidDomainName "InvalidDomainName" The specified domain name is not valid.

  • ErrCodeHostedZoneAlreadyExists "HostedZoneAlreadyExists" The hosted zone you're trying to create already exists. Amazon Route 53 returns this error when a hosted zone has already been created with the specified CallerReference.

  • ErrCodeTooManyHostedZones "TooManyHostedZones" This operation can't be completed either because the current account has reached the limit on the number of hosted zones or because you've reached the limit on the number of hosted zones that can be associated with a reusable delegation set.

For information about default limits, see Limits (http://docs.aws.amazon.com/Route53/latest/DeveloperGuide/DNSLimitations.html) in the Amazon Route 53 Developer Guide. To get the current limit on hosted zones that can be created by an account, see GetAccountLimit. To get the current limit on hosted zones that can be associated with a reusable delegation set, see GetReusableDelegationSetLimit. To request a higher limit, create a case (http://aws.amazon.com/route53-request) with the AWS Support Center.
  • ErrCodeInvalidVPCId "InvalidVPCId" The VPC ID that you specified either isn't a valid ID or the current account is not authorized to access this VPC.

  • ErrCodeInvalidInput "InvalidInput" The input is not valid.

  • ErrCodeDelegationSetNotAvailable "DelegationSetNotAvailable" You can create a hosted zone that has the same name as an existing hosted zone (example.com is common), but there is a limit to the number of hosted zones that have the same name. If you get this error, Amazon Route 53 has reached that limit. If you own the domain name and Route 53 generates this error, contact Customer Support.

  • ErrCodeConflictingDomainExists "ConflictingDomainExists" The cause of this error depends on whether you're trying to create a public or a private hosted zone:

  • 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.

  • Private hosted zone: You specified an Amazon VPC that you're already using for another hosted zone, and the domain that you specified for one of the hosted zones is a subdomain of the domain that you specified for the other hosted zone. For example, you can't use the same Amazon VPC for the hosted zones for example.com and test.example.com.

  • ErrCodeNoSuchDelegationSet "NoSuchDelegationSet" A reusable delegation set with the specified ID does not exist.

  • ErrCodeDelegationSetNotReusable "DelegationSetNotReusable" A reusable delegation set with the specified ID does not exist.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/CreateHostedZone

CreateHostedZoneRequest

func (c *Route53) CreateHostedZoneRequest(input *CreateHostedZoneInput) (req *request.Request, output *CreateHostedZoneOutput)

CreateHostedZoneRequest generates a "aws/request.Request" representing the client's request for the CreateHostedZone operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See CreateHostedZone for more information on using the CreateHostedZone API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the CreateHostedZoneRequest method. req, resp := client.CreateHostedZoneRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/CreateHostedZone

CreateHostedZoneWithContext

func (c *Route53) CreateHostedZoneWithContext(ctx aws.Context, input *CreateHostedZoneInput, opts ...request.Option) (*CreateHostedZoneOutput, error)

CreateHostedZoneWithContext is the same as CreateHostedZone with the addition of the ability to pass a context and additional request options.

See CreateHostedZone for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

CreateQueryLoggingConfig

func (c *Route53) CreateQueryLoggingConfig(input *CreateQueryLoggingConfigInput) (*CreateQueryLoggingConfigOutput, error)

CreateQueryLoggingConfig API operation for Amazon Route 53.

Creates a configuration for DNS query logging. After you create a query logging configuration, Amazon Route 53 begins to publish log data to an Amazon CloudWatch Logs log group.

DNS query logs contain information about the queries that Route 53 receives for a specified public hosted zone, such as the following:

  • Route 53 edge location that responded to the DNS query

  • Domain or subdomain that was requested

  • DNS record type, such as A or AAAA

  • DNS response code, such as NoError or ServFail

Log Group and Resource PolicyBefore you create a query logging configuration, perform the following operations.

If you create a query logging configuration using the Route 53 console, Route 53 performs these operations automatically.

Create a CloudWatch Logs log group, and make note of the ARN, which you specify when you create a query logging configuration. Note the following:

You must create the log group in the us-east-1 region.

You must use the same AWS account to create the log group and the hosted zone that you want to configure query logging for.

When you create log groups for query logging, we recommend that you use a consistent prefix, for example:

/aws/route53/hosted zone name

In the next step, you'll create a resource policy, which controls access to one or more log groups and the associated AWS resources, such as Route 53 hosted zones. There's a limit on the number of resource policies that you can create, so we recommend that you use a consistent prefix so you can use the same resource policy for all the log groups that you create for query logging.

Create a CloudWatch Logs resource policy, and give it the permissions that Route 53 needs to create log streams and to send query logs to log streams. For the value of Resource, specify the ARN for the log group that you created in the previous step. To use the same resource policy for all the CloudWatch Logs log groups that you created for query logging configurations, replace the hosted zone name with *, for example:

arn:aws:logs:us-east-1:123412341234:log-group:/aws/route53/*

You can't use the CloudWatch console to create or edit a resource policy. You must use the CloudWatch API, one of the AWS SDKs, or the AWS CLI.

Log Streams and Edge LocationsWhen Route 53 finishes creating the configuration for DNS query logging, it does the following:

Creates a log stream for an edge location the first time that the edge location responds to DNS queries for the specified hosted zone. That log stream is used to log all queries that Route 53 responds to for that edge location.

Begins to send query logs to the applicable log stream.

The name of each log stream is in the following format:

hosted zone ID/edge location code

The edge location code is a three-letter code and an arbitrarily assigned number, for example, DFW3. The three-letter code typically corresponds with the International Air Transport Association airport code for an airport near the edge location. (These abbreviations might change in the future.) For a list of edge locations, see "The Route 53 Global Network" on the Route 53 Product Details (https://aws.amazon.com/route53/details/) page.

Queries That Are LoggedQuery logs contain only the queries that DNS resolvers forward to Route 53. If a DNS resolver has already cached the response to a query (such as the IP address for a load balancer for example.com), the resolver will continue to return the cached response. It doesn't forward another query to Route 53 until the TTL for the corresponding resource record set expires. Depending on how many DNS queries are submitted for a resource record set, and depending on the TTL for that resource record set, query logs might contain information about only one query out of every several thousand queries that are submitted to DNS. For more information about how DNS works, see Routing Internet Traffic to Your Website or Web Application (https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/welcome-dns-service.html) in the Amazon Route 53 Developer Guide.

Log File FormatFor a list of the values in each query log and the format of each value, see Logging DNS Queries (https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/query-logs.html) in the Amazon Route 53 Developer Guide.

PricingFor information about charges for query logs, see Amazon CloudWatch Pricing (https://aws.amazon.com/cloudwatch/pricing/).

How to Stop LoggingIf you want Route 53 to stop sending query logs to CloudWatch Logs, delete the query logging configuration. For more information, see DeleteQueryLoggingConfig.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation CreateQueryLoggingConfig for usage and error information.

Returned Error Codes:

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

  • ErrCodeNoSuchHostedZone "NoSuchHostedZone" No hosted zone exists with the ID that you specified.

  • ErrCodeNoSuchCloudWatchLogsLogGroup "NoSuchCloudWatchLogsLogGroup" There is no CloudWatch Logs log group with the specified ARN.

  • ErrCodeInvalidInput "InvalidInput" The input is not valid.

  • ErrCodeQueryLoggingConfigAlreadyExists "QueryLoggingConfigAlreadyExists" You can create only one query logging configuration for a hosted zone, and a query logging configuration already exists for this hosted zone.

  • ErrCodeInsufficientCloudWatchLogsResourcePolicy "InsufficientCloudWatchLogsResourcePolicy" Amazon Route 53 doesn't have the permissions required to create log streams and send query logs to log streams. Possible causes include the following:

  • There is no resource policy that specifies the log group ARN in the value for Resource.

  • The resource policy that includes the log group ARN in the value for Resource doesn't have the necessary permissions.

  • The resource policy hasn't finished propagating yet.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/CreateQueryLoggingConfig

CreateQueryLoggingConfigRequest

func (c *Route53) CreateQueryLoggingConfigRequest(input *CreateQueryLoggingConfigInput) (req *request.Request, output *CreateQueryLoggingConfigOutput)

CreateQueryLoggingConfigRequest generates a "aws/request.Request" representing the client's request for the CreateQueryLoggingConfig operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See CreateQueryLoggingConfig for more information on using the CreateQueryLoggingConfig API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the CreateQueryLoggingConfigRequest method. req, resp := client.CreateQueryLoggingConfigRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/CreateQueryLoggingConfig

CreateQueryLoggingConfigWithContext

func (c *Route53) CreateQueryLoggingConfigWithContext(ctx aws.Context, input *CreateQueryLoggingConfigInput, opts ...request.Option) (*CreateQueryLoggingConfigOutput, error)

CreateQueryLoggingConfigWithContext is the same as CreateQueryLoggingConfig with the addition of the ability to pass a context and additional request options.

See CreateQueryLoggingConfig for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

CreateReusableDelegationSet

func (c *Route53) CreateReusableDelegationSet(input *CreateReusableDelegationSetInput) (*CreateReusableDelegationSetOutput, error)

CreateReusableDelegationSet API operation for Amazon Route 53.

Creates a delegation set (a group of four name servers) that can be reused by multiple hosted zones. If a hosted zoned ID is specified, CreateReusableDelegationSet marks the delegation set associated with that zone as reusable.

You can't associate a reusable delegation set with a private hosted zone.

For information about using a reusable delegation set to configure white label name servers, see Configuring White Label Name Servers (https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/white-label-name-servers.html).

The process for migrating existing hosted zones to use a reusable delegation set is comparable to the process for configuring white label name servers. You need to perform the following steps:

Create a reusable delegation set.

Recreate hosted zones, and reduce the TTL to 60 seconds or less.

Recreate resource record sets in the new hosted zones.

Change the registrar's name servers to use the name servers for the new hosted zones.

Monitor traffic for the website or application.

Change TTLs back to their original values.

If you want to migrate existing hosted zones to use a reusable delegation set, the existing hosted zones can't use any of the name servers that are assigned to the reusable delegation set. If one or more hosted zones do use one or more name servers that are assigned to the reusable delegation set, you can do one of the following:

  • For small numbers of hosted zones—up to a few hundred—it's relatively easy to create reusable delegation sets until you get one that has four name servers that don't overlap with any of the name servers in your hosted zones.

  • For larger numbers of hosted zones, the easiest solution is to use more than one reusable delegation set.

  • For larger numbers of hosted zones, you can also migrate hosted zones that have overlapping name servers to hosted zones that don't have overlapping name servers, then migrate the hosted zones again to use the reusable delegation set.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation CreateReusableDelegationSet for usage and error information.

Returned Error Codes:

  • ErrCodeDelegationSetAlreadyCreated "DelegationSetAlreadyCreated" A delegation set with the same owner and caller reference combination has already been created.

  • ErrCodeLimitsExceeded "LimitsExceeded" This operation can't be completed either because the current account has reached the limit on reusable delegation sets that it can create or because you've reached the limit on the number of Amazon VPCs that you can associate with a private hosted zone. To get the current limit on the number of reusable delegation sets, see GetAccountLimit. To get the current limit on the number of Amazon VPCs that you can associate with a private hosted zone, see GetHostedZoneLimit. To request a higher limit, create a case (https://aws.amazon.com/route53-request) with the AWS Support Center.

  • ErrCodeHostedZoneNotFound "HostedZoneNotFound" The specified HostedZone can't be found.

  • ErrCodeInvalidArgument "InvalidArgument" Parameter name is invalid.

  • ErrCodeInvalidInput "InvalidInput" The input is not valid.

  • ErrCodeDelegationSetNotAvailable "DelegationSetNotAvailable" You can create a hosted zone that has the same name as an existing hosted zone (example.com is common), but there is a limit to the number of hosted zones that have the same name. If you get this error, Amazon Route 53 has reached that limit. If you own the domain name and Route 53 generates this error, contact Customer Support.

  • ErrCodeDelegationSetAlreadyReusable "DelegationSetAlreadyReusable" The specified delegation set has already been marked as reusable.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/CreateReusableDelegationSet

CreateReusableDelegationSetRequest

func (c *Route53) CreateReusableDelegationSetRequest(input *CreateReusableDelegationSetInput) (req *request.Request, output *CreateReusableDelegationSetOutput)

CreateReusableDelegationSetRequest generates a "aws/request.Request" representing the client's request for the CreateReusableDelegationSet operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See CreateReusableDelegationSet for more information on using the CreateReusableDelegationSet API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the CreateReusableDelegationSetRequest method. req, resp := client.CreateReusableDelegationSetRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/CreateReusableDelegationSet

CreateReusableDelegationSetWithContext

func (c *Route53) CreateReusableDelegationSetWithContext(ctx aws.Context, input *CreateReusableDelegationSetInput, opts ...request.Option) (*CreateReusableDelegationSetOutput, error)

CreateReusableDelegationSetWithContext is the same as CreateReusableDelegationSet with the addition of the ability to pass a context and additional request options.

See CreateReusableDelegationSet for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

CreateTrafficPolicy

func (c *Route53) CreateTrafficPolicy(input *CreateTrafficPolicyInput) (*CreateTrafficPolicyOutput, error)

CreateTrafficPolicy API operation for Amazon Route 53.

Creates a traffic policy, which you use to create multiple DNS resource record sets for one domain name (such as example.com) or one subdomain name (such as www.example.com).

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation CreateTrafficPolicy for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidInput "InvalidInput" The input is not valid.

  • ErrCodeTooManyTrafficPolicies "TooManyTrafficPolicies" This traffic policy can't be created because the current account has reached the limit on the number of traffic policies.

For information about default limits, see Limits (http://docs.aws.amazon.com/Route53/latest/DeveloperGuide/DNSLimitations.html) in the Amazon Route 53 Developer Guide. To get the current limit for an account, see GetAccountLimit. To request a higher limit, create a case (http://aws.amazon.com/route53-request) with the AWS Support Center.
  • ErrCodeTrafficPolicyAlreadyExists "TrafficPolicyAlreadyExists" A traffic policy that has the same value for Name already exists.

  • ErrCodeInvalidTrafficPolicyDocument "InvalidTrafficPolicyDocument" The format of the traffic policy document that you specified in the Document element is invalid.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/CreateTrafficPolicy

CreateTrafficPolicyInstance

func (c *Route53) CreateTrafficPolicyInstance(input *CreateTrafficPolicyInstanceInput) (*CreateTrafficPolicyInstanceOutput, error)

CreateTrafficPolicyInstance API operation for Amazon Route 53.

Creates resource record sets in a specified hosted zone based on the settings in a specified traffic policy version. In addition, CreateTrafficPolicyInstance associates the resource record sets with a specified domain name (such as example.com) or subdomain name (such as www.example.com). Amazon Route 53 responds to DNS queries for the domain or subdomain name by using the resource record sets that CreateTrafficPolicyInstance created.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation CreateTrafficPolicyInstance for usage and error information.

Returned Error Codes:

  • ErrCodeNoSuchHostedZone "NoSuchHostedZone" No hosted zone exists with the ID that you specified.

  • ErrCodeInvalidInput "InvalidInput" The input is not valid.

  • ErrCodeTooManyTrafficPolicyInstances "TooManyTrafficPolicyInstances" This traffic policy instance can't be created because the current account has reached the limit on the number of traffic policy instances.

For information about default limits, see Limits (http://docs.aws.amazon.com/Route53/latest/DeveloperGuide/DNSLimitations.html) in the Amazon Route 53 Developer Guide. For information about how to get the current limit for an account, see GetAccountLimit. To request a higher limit, create a case (http://aws.amazon.com/route53-request) with the AWS Support Center.
  • ErrCodeNoSuchTrafficPolicy "NoSuchTrafficPolicy" No traffic policy exists with the specified ID.

  • ErrCodeTrafficPolicyInstanceAlreadyExists "TrafficPolicyInstanceAlreadyExists" There is already a traffic policy instance with the specified ID.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/CreateTrafficPolicyInstance

CreateTrafficPolicyInstanceRequest

func (c *Route53) CreateTrafficPolicyInstanceRequest(input *CreateTrafficPolicyInstanceInput) (req *request.Request, output *CreateTrafficPolicyInstanceOutput)

CreateTrafficPolicyInstanceRequest generates a "aws/request.Request" representing the client's request for the CreateTrafficPolicyInstance operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See CreateTrafficPolicyInstance for more information on using the CreateTrafficPolicyInstance API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the CreateTrafficPolicyInstanceRequest method. req, resp := client.CreateTrafficPolicyInstanceRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/CreateTrafficPolicyInstance

CreateTrafficPolicyInstanceWithContext

func (c *Route53) CreateTrafficPolicyInstanceWithContext(ctx aws.Context, input *CreateTrafficPolicyInstanceInput, opts ...request.Option) (*CreateTrafficPolicyInstanceOutput, error)

CreateTrafficPolicyInstanceWithContext is the same as CreateTrafficPolicyInstance with the addition of the ability to pass a context and additional request options.

See CreateTrafficPolicyInstance for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

CreateTrafficPolicyRequest

func (c *Route53) CreateTrafficPolicyRequest(input *CreateTrafficPolicyInput) (req *request.Request, output *CreateTrafficPolicyOutput)

CreateTrafficPolicyRequest generates a "aws/request.Request" representing the client's request for the CreateTrafficPolicy operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See CreateTrafficPolicy for more information on using the CreateTrafficPolicy API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the CreateTrafficPolicyRequest method. req, resp := client.CreateTrafficPolicyRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/CreateTrafficPolicy

CreateTrafficPolicyVersion

func (c *Route53) CreateTrafficPolicyVersion(input *CreateTrafficPolicyVersionInput) (*CreateTrafficPolicyVersionOutput, error)

CreateTrafficPolicyVersion API operation for Amazon Route 53.

Creates a new version of an existing traffic policy. When you create a new version of a traffic policy, you specify the ID of the traffic policy that you want to update and a JSON-formatted document that describes the new version. You use traffic policies to create multiple DNS resource record sets for one domain name (such as example.com) or one subdomain name (such as www.example.com). You can create a maximum of 1000 versions of a traffic policy. If you reach the limit and need to create another version, you'll need to start a new traffic policy.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation CreateTrafficPolicyVersion for usage and error information.

Returned Error Codes:

  • ErrCodeNoSuchTrafficPolicy "NoSuchTrafficPolicy" No traffic policy exists with the specified ID.

  • ErrCodeInvalidInput "InvalidInput" The input is not valid.

  • ErrCodeTooManyTrafficPolicyVersionsForCurrentPolicy "TooManyTrafficPolicyVersionsForCurrentPolicy" This traffic policy version can't be created because you've reached the limit of 1000 on the number of versions that you can create for the current traffic policy.

To create more traffic policy versions, you can use GetTrafficPolicy to get the traffic policy document for a specified traffic policy version, and then use CreateTrafficPolicy to create a new traffic policy using the traffic policy document.
  • ErrCodeConcurrentModification "ConcurrentModification" Another user submitted a request to create, update, or delete the object at the same time that you did. Retry the request.

  • ErrCodeInvalidTrafficPolicyDocument "InvalidTrafficPolicyDocument" The format of the traffic policy document that you specified in the Document element is invalid.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/CreateTrafficPolicyVersion

CreateTrafficPolicyVersionRequest

func (c *Route53) CreateTrafficPolicyVersionRequest(input *CreateTrafficPolicyVersionInput) (req *request.Request, output *CreateTrafficPolicyVersionOutput)

CreateTrafficPolicyVersionRequest generates a "aws/request.Request" representing the client's request for the CreateTrafficPolicyVersion operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See CreateTrafficPolicyVersion for more information on using the CreateTrafficPolicyVersion API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the CreateTrafficPolicyVersionRequest method. req, resp := client.CreateTrafficPolicyVersionRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/CreateTrafficPolicyVersion

CreateTrafficPolicyVersionWithContext

func (c *Route53) CreateTrafficPolicyVersionWithContext(ctx aws.Context, input *CreateTrafficPolicyVersionInput, opts ...request.Option) (*CreateTrafficPolicyVersionOutput, error)

CreateTrafficPolicyVersionWithContext is the same as CreateTrafficPolicyVersion with the addition of the ability to pass a context and additional request options.

See CreateTrafficPolicyVersion for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

CreateTrafficPolicyWithContext

func (c *Route53) CreateTrafficPolicyWithContext(ctx aws.Context, input *CreateTrafficPolicyInput, opts ...request.Option) (*CreateTrafficPolicyOutput, error)

CreateTrafficPolicyWithContext is the same as CreateTrafficPolicy with the addition of the ability to pass a context and additional request options.

See CreateTrafficPolicy for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

CreateVPCAssociationAuthorization

func (c *Route53) CreateVPCAssociationAuthorization(input *CreateVPCAssociationAuthorizationInput) (*CreateVPCAssociationAuthorizationOutput, error)

CreateVPCAssociationAuthorization API operation for Amazon Route 53.

Authorizes the AWS account that created a specified VPC to submit an AssociateVPCWithHostedZone request to associate the VPC with a specified hosted zone that was created by a different account. To submit a CreateVPCAssociationAuthorization request, you must use the account that created the hosted zone. After you authorize the association, use the account that created the VPC to submit an AssociateVPCWithHostedZone request.

If you want to associate multiple VPCs that you created by using one account with a hosted zone that you created by using a different account, you must submit one authorization request for each VPC.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation CreateVPCAssociationAuthorization for usage and error information.

Returned Error Codes:

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

  • ErrCodeTooManyVPCAssociationAuthorizations "TooManyVPCAssociationAuthorizations" You've created the maximum number of authorizations that can be created for the specified hosted zone. To authorize another VPC to be associated with the hosted zone, submit a DeleteVPCAssociationAuthorization request to remove an existing authorization. To get a list of existing authorizations, submit a ListVPCAssociationAuthorizations request.

  • ErrCodeNoSuchHostedZone "NoSuchHostedZone" No hosted zone exists with the ID that you specified.

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

  • ErrCodeInvalidInput "InvalidInput" The input is not valid.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/CreateVPCAssociationAuthorization

CreateVPCAssociationAuthorizationRequest

func (c *Route53) CreateVPCAssociationAuthorizationRequest(input *CreateVPCAssociationAuthorizationInput) (req *request.Request, output *CreateVPCAssociationAuthorizationOutput)

CreateVPCAssociationAuthorizationRequest generates a "aws/request.Request" representing the client's request for the CreateVPCAssociationAuthorization operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See CreateVPCAssociationAuthorization for more information on using the CreateVPCAssociationAuthorization API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the CreateVPCAssociationAuthorizationRequest method. req, resp := client.CreateVPCAssociationAuthorizationRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/CreateVPCAssociationAuthorization

CreateVPCAssociationAuthorizationWithContext

func (c *Route53) CreateVPCAssociationAuthorizationWithContext(ctx aws.Context, input *CreateVPCAssociationAuthorizationInput, opts ...request.Option) (*CreateVPCAssociationAuthorizationOutput, error)

CreateVPCAssociationAuthorizationWithContext is the same as CreateVPCAssociationAuthorization with the addition of the ability to pass a context and additional request options.

See CreateVPCAssociationAuthorization for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

DeleteHealthCheck

func (c *Route53) DeleteHealthCheck(input *DeleteHealthCheckInput) (*DeleteHealthCheckOutput, error)

DeleteHealthCheck API operation for Amazon Route 53.

Deletes a health check.

Amazon Route 53 does not prevent you from deleting a health check even if the health check is associated with one or more resource record sets. If you delete a health check and you don't update the associated resource record sets, the future status of the health check can't be predicted and may change. This will affect the routing of DNS queries for your DNS failover configuration. For more information, see Replacing and Deleting Health Checks (https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/health-checks-creating-deleting.html#health-checks-deleting.html) in the Amazon Route 53 Developer Guide.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation DeleteHealthCheck for usage and error information.

Returned Error Codes:

  • ErrCodeNoSuchHealthCheck "NoSuchHealthCheck" No health check exists with the specified ID.

  • ErrCodeHealthCheckInUse "HealthCheckInUse" This error code is not in use.

  • ErrCodeInvalidInput "InvalidInput" The input is not valid.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/DeleteHealthCheck

DeleteHealthCheckRequest

func (c *Route53) DeleteHealthCheckRequest(input *DeleteHealthCheckInput) (req *request.Request, output *DeleteHealthCheckOutput)

DeleteHealthCheckRequest generates a "aws/request.Request" representing the client's request for the DeleteHealthCheck operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DeleteHealthCheck for more information on using the DeleteHealthCheck API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DeleteHealthCheckRequest method. req, resp := client.DeleteHealthCheckRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/DeleteHealthCheck

DeleteHealthCheckWithContext

func (c *Route53) DeleteHealthCheckWithContext(ctx aws.Context, input *DeleteHealthCheckInput, opts ...request.Option) (*DeleteHealthCheckOutput, error)

DeleteHealthCheckWithContext is the same as DeleteHealthCheck with the addition of the ability to pass a context and additional request options.

See DeleteHealthCheck for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

DeleteHostedZone

func (c *Route53) DeleteHostedZone(input *DeleteHostedZoneInput) (*DeleteHostedZoneOutput, error)

DeleteHostedZone API operation for Amazon Route 53.

Deletes a hosted zone.

If the name servers for the hosted zone are associated with a domain and if you want to make the domain unavailable on the Internet, we recommend that you delete the name servers from the domain to prevent future DNS queries from possibly being misrouted. If the domain is registered with Amazon Route 53, see UpdateDomainNameservers. If the domain is registered with another registrar, use the method provided by the registrar to delete name servers for the domain.

Some domain registries don't allow you to remove all of the name servers for a domain. If the registry for your domain requires one or more name servers, we recommend that you delete the hosted zone only if you transfer DNS service to another service provider, and you replace the name servers for the domain with name servers from the new provider.

You can delete a hosted zone only if it contains only the default SOA record and NS resource record sets. If the hosted zone contains other resource record sets, you must delete them before you can delete the hosted zone. If you try to delete a hosted zone that contains other resource record sets, the request fails, and Route 53 returns a HostedZoneNotEmpty error. For information about deleting records from your hosted zone, see ChangeResourceRecordSets.

To verify that the hosted zone has been deleted, do one of the following:

  • Use the GetHostedZone action to request information about the hosted zone.

  • Use the ListHostedZones action to get a list of the hosted zones associated with the current AWS account.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation DeleteHostedZone for usage and error information.

Returned Error Codes:

  • ErrCodeNoSuchHostedZone "NoSuchHostedZone" No hosted zone exists with the ID that you specified.

  • ErrCodeHostedZoneNotEmpty "HostedZoneNotEmpty" The hosted zone contains resource records that are not SOA or NS records.

  • ErrCodePriorRequestNotComplete "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.

  • ErrCodeInvalidInput "InvalidInput" The input is not valid.

  • ErrCodeInvalidDomainName "InvalidDomainName" The specified domain name is not valid.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/DeleteHostedZone

DeleteHostedZoneRequest

func (c *Route53) DeleteHostedZoneRequest(input *DeleteHostedZoneInput) (req *request.Request, output *DeleteHostedZoneOutput)

DeleteHostedZoneRequest generates a "aws/request.Request" representing the client's request for the DeleteHostedZone operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DeleteHostedZone for more information on using the DeleteHostedZone API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DeleteHostedZoneRequest method. req, resp := client.DeleteHostedZoneRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/DeleteHostedZone

DeleteHostedZoneWithContext

func (c *Route53) DeleteHostedZoneWithContext(ctx aws.Context, input *DeleteHostedZoneInput, opts ...request.Option) (*DeleteHostedZoneOutput, error)

DeleteHostedZoneWithContext is the same as DeleteHostedZone with the addition of the ability to pass a context and additional request options.

See DeleteHostedZone for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

DeleteQueryLoggingConfig

func (c *Route53) DeleteQueryLoggingConfig(input *DeleteQueryLoggingConfigInput) (*DeleteQueryLoggingConfigOutput, error)

DeleteQueryLoggingConfig API operation for Amazon Route 53.

Deletes a configuration for DNS query logging. If you delete a configuration, Amazon Route 53 stops sending query logs to CloudWatch Logs. Route 53 doesn't delete any logs that are already in CloudWatch Logs.

For more information about DNS query logs, see CreateQueryLoggingConfig.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation DeleteQueryLoggingConfig for usage and error information.

Returned Error Codes:

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

  • ErrCodeNoSuchQueryLoggingConfig "NoSuchQueryLoggingConfig" There is no DNS query logging configuration with the specified ID.

  • ErrCodeInvalidInput "InvalidInput" The input is not valid.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/DeleteQueryLoggingConfig

DeleteQueryLoggingConfigRequest

func (c *Route53) DeleteQueryLoggingConfigRequest(input *DeleteQueryLoggingConfigInput) (req *request.Request, output *DeleteQueryLoggingConfigOutput)

DeleteQueryLoggingConfigRequest generates a "aws/request.Request" representing the client's request for the DeleteQueryLoggingConfig operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DeleteQueryLoggingConfig for more information on using the DeleteQueryLoggingConfig API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DeleteQueryLoggingConfigRequest method. req, resp := client.DeleteQueryLoggingConfigRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/DeleteQueryLoggingConfig

DeleteQueryLoggingConfigWithContext

func (c *Route53) DeleteQueryLoggingConfigWithContext(ctx aws.Context, input *DeleteQueryLoggingConfigInput, opts ...request.Option) (*DeleteQueryLoggingConfigOutput, error)

DeleteQueryLoggingConfigWithContext is the same as DeleteQueryLoggingConfig with the addition of the ability to pass a context and additional request options.

See DeleteQueryLoggingConfig for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

DeleteReusableDelegationSet

func (c *Route53) DeleteReusableDelegationSet(input *DeleteReusableDelegationSetInput) (*DeleteReusableDelegationSetOutput, error)

DeleteReusableDelegationSet API operation for Amazon Route 53.

Deletes a reusable delegation set.

You can delete a reusable delegation set only if it isn't associated with any hosted zones.

To verify that the reusable delegation set is not associated with any hosted zones, submit a GetReusableDelegationSet request and specify the ID of the reusable delegation set that you want to delete.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation DeleteReusableDelegationSet for usage and error information.

Returned Error Codes:

  • ErrCodeNoSuchDelegationSet "NoSuchDelegationSet" A reusable delegation set with the specified ID does not exist.

  • ErrCodeDelegationSetInUse "DelegationSetInUse" The specified delegation contains associated hosted zones which must be deleted before the reusable delegation set can be deleted.

  • ErrCodeDelegationSetNotReusable "DelegationSetNotReusable" A reusable delegation set with the specified ID does not exist.

  • ErrCodeInvalidInput "InvalidInput" The input is not valid.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/DeleteReusableDelegationSet

DeleteReusableDelegationSetRequest

func (c *Route53) DeleteReusableDelegationSetRequest(input *DeleteReusableDelegationSetInput) (req *request.Request, output *DeleteReusableDelegationSetOutput)

DeleteReusableDelegationSetRequest generates a "aws/request.Request" representing the client's request for the DeleteReusableDelegationSet operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DeleteReusableDelegationSet for more information on using the DeleteReusableDelegationSet API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DeleteReusableDelegationSetRequest method. req, resp := client.DeleteReusableDelegationSetRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/DeleteReusableDelegationSet

DeleteReusableDelegationSetWithContext

func (c *Route53) DeleteReusableDelegationSetWithContext(ctx aws.Context, input *DeleteReusableDelegationSetInput, opts ...request.Option) (*DeleteReusableDelegationSetOutput, error)

DeleteReusableDelegationSetWithContext is the same as DeleteReusableDelegationSet with the addition of the ability to pass a context and additional request options.

See DeleteReusableDelegationSet for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

DeleteTrafficPolicy

func (c *Route53) DeleteTrafficPolicy(input *DeleteTrafficPolicyInput) (*DeleteTrafficPolicyOutput, error)

DeleteTrafficPolicy API operation for Amazon Route 53.

Deletes a traffic policy.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation DeleteTrafficPolicy for usage and error information.

Returned Error Codes:

  • ErrCodeNoSuchTrafficPolicy "NoSuchTrafficPolicy" No traffic policy exists with the specified ID.

  • ErrCodeInvalidInput "InvalidInput" The input is not valid.

  • ErrCodeTrafficPolicyInUse "TrafficPolicyInUse" One or more traffic policy instances were created by using the specified traffic policy.

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

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/DeleteTrafficPolicy

DeleteTrafficPolicyInstance

func (c *Route53) DeleteTrafficPolicyInstance(input *DeleteTrafficPolicyInstanceInput) (*DeleteTrafficPolicyInstanceOutput, error)

DeleteTrafficPolicyInstance API operation for Amazon Route 53.

Deletes a traffic policy instance and all of the resource record sets that Amazon Route 53 created when you created the instance.

In the Route 53 console, traffic policy instances are known as policy records.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation DeleteTrafficPolicyInstance for usage and error information.

Returned Error Codes:

  • ErrCodeNoSuchTrafficPolicyInstance "NoSuchTrafficPolicyInstance" No traffic policy instance exists with the specified ID.

  • ErrCodeInvalidInput "InvalidInput" The input is not valid.

  • ErrCodePriorRequestNotComplete "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.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/DeleteTrafficPolicyInstance

DeleteTrafficPolicyInstanceRequest

func (c *Route53) DeleteTrafficPolicyInstanceRequest(input *DeleteTrafficPolicyInstanceInput) (req *request.Request, output *DeleteTrafficPolicyInstanceOutput)

DeleteTrafficPolicyInstanceRequest generates a "aws/request.Request" representing the client's request for the DeleteTrafficPolicyInstance operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DeleteTrafficPolicyInstance for more information on using the DeleteTrafficPolicyInstance API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DeleteTrafficPolicyInstanceRequest method. req, resp := client.DeleteTrafficPolicyInstanceRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/DeleteTrafficPolicyInstance

DeleteTrafficPolicyInstanceWithContext

func (c *Route53) DeleteTrafficPolicyInstanceWithContext(ctx aws.Context, input *DeleteTrafficPolicyInstanceInput, opts ...request.Option) (*DeleteTrafficPolicyInstanceOutput, error)

DeleteTrafficPolicyInstanceWithContext is the same as DeleteTrafficPolicyInstance with the addition of the ability to pass a context and additional request options.

See DeleteTrafficPolicyInstance for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

DeleteTrafficPolicyRequest

func (c *Route53) DeleteTrafficPolicyRequest(input *DeleteTrafficPolicyInput) (req *request.Request, output *DeleteTrafficPolicyOutput)

DeleteTrafficPolicyRequest generates a "aws/request.Request" representing the client's request for the DeleteTrafficPolicy operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DeleteTrafficPolicy for more information on using the DeleteTrafficPolicy API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DeleteTrafficPolicyRequest method. req, resp := client.DeleteTrafficPolicyRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/DeleteTrafficPolicy

DeleteTrafficPolicyWithContext

func (c *Route53) DeleteTrafficPolicyWithContext(ctx aws.Context, input *DeleteTrafficPolicyInput, opts ...request.Option) (*DeleteTrafficPolicyOutput, error)

DeleteTrafficPolicyWithContext is the same as DeleteTrafficPolicy with the addition of the ability to pass a context and additional request options.

See DeleteTrafficPolicy for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

DeleteVPCAssociationAuthorization

func (c *Route53) DeleteVPCAssociationAuthorization(input *DeleteVPCAssociationAuthorizationInput) (*DeleteVPCAssociationAuthorizationOutput, error)

DeleteVPCAssociationAuthorization API operation for Amazon Route 53.

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 AWS 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.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation DeleteVPCAssociationAuthorization for usage and error information.

Returned Error Codes:

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

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

  • ErrCodeNoSuchHostedZone "NoSuchHostedZone" No hosted zone exists with the ID that you specified.

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

  • ErrCodeInvalidInput "InvalidInput" The input is not valid.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/DeleteVPCAssociationAuthorization

DeleteVPCAssociationAuthorizationRequest

func (c *Route53) DeleteVPCAssociationAuthorizationRequest(input *DeleteVPCAssociationAuthorizationInput) (req *request.Request, output *DeleteVPCAssociationAuthorizationOutput)

DeleteVPCAssociationAuthorizationRequest generates a "aws/request.Request" representing the client's request for the DeleteVPCAssociationAuthorization operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DeleteVPCAssociationAuthorization for more information on using the DeleteVPCAssociationAuthorization API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DeleteVPCAssociationAuthorizationRequest method. req, resp := client.DeleteVPCAssociationAuthorizationRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/DeleteVPCAssociationAuthorization

DeleteVPCAssociationAuthorizationWithContext

func (c *Route53) DeleteVPCAssociationAuthorizationWithContext(ctx aws.Context, input *DeleteVPCAssociationAuthorizationInput, opts ...request.Option) (*DeleteVPCAssociationAuthorizationOutput, error)

DeleteVPCAssociationAuthorizationWithContext is the same as DeleteVPCAssociationAuthorization with the addition of the ability to pass a context and additional request options.

See DeleteVPCAssociationAuthorization for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

DisassociateVPCFromHostedZone

func (c *Route53) DisassociateVPCFromHostedZone(input *DisassociateVPCFromHostedZoneInput) (*DisassociateVPCFromHostedZoneOutput, error)

DisassociateVPCFromHostedZone API operation for Amazon Route 53.

Disassociates a VPC from a Amazon Route 53 private hosted zone. Note the following:

  • You can't disassociate the last VPC from a private hosted zone.

  • You can't convert a private hosted zone into a public hosted zone.

  • You can submit a DisassociateVPCFromHostedZone request using either the account that created the hosted zone or the account that created the VPC.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation DisassociateVPCFromHostedZone for usage and error information.

Returned Error Codes:

  • ErrCodeNoSuchHostedZone "NoSuchHostedZone" No hosted zone exists with the ID that you specified.

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

  • ErrCodeVPCAssociationNotFound "VPCAssociationNotFound" The specified VPC and hosted zone are not currently associated.

  • ErrCodeLastVPCAssociation "LastVPCAssociation" The VPC that you're trying to disassociate from the private hosted zone is the last VPC that is associated with the hosted zone. Amazon Route 53 doesn't support disassociating the last VPC from a hosted zone.

  • ErrCodeInvalidInput "InvalidInput" The input is not valid.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/DisassociateVPCFromHostedZone

DisassociateVPCFromHostedZoneRequest

func (c *Route53) DisassociateVPCFromHostedZoneRequest(input *DisassociateVPCFromHostedZoneInput) (req *request.Request, output *DisassociateVPCFromHostedZoneOutput)

DisassociateVPCFromHostedZoneRequest generates a "aws/request.Request" representing the client's request for the DisassociateVPCFromHostedZone operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DisassociateVPCFromHostedZone for more information on using the DisassociateVPCFromHostedZone API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DisassociateVPCFromHostedZoneRequest method. req, resp := client.DisassociateVPCFromHostedZoneRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/DisassociateVPCFromHostedZone

DisassociateVPCFromHostedZoneWithContext

func (c *Route53) DisassociateVPCFromHostedZoneWithContext(ctx aws.Context, input *DisassociateVPCFromHostedZoneInput, opts ...request.Option) (*DisassociateVPCFromHostedZoneOutput, error)

DisassociateVPCFromHostedZoneWithContext is the same as DisassociateVPCFromHostedZone with the addition of the ability to pass a context and additional request options.

See DisassociateVPCFromHostedZone for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

GetAccountLimit

func (c *Route53) GetAccountLimit(input *GetAccountLimitInput) (*GetAccountLimitOutput, error)

GetAccountLimit API operation for Amazon Route 53.

Gets the specified limit for the current account, for example, the maximum number of health checks that you can create using the account.

For the default limit, see Limits (https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/DNSLimitations.html) in the Amazon Route 53 Developer Guide. To request a higher limit, open a case (https://console.aws.amazon.com/support/home#/case/create?issueType=service-limit-increase&limitType=service-code-route53).

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation GetAccountLimit for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidInput "InvalidInput" The input is not valid.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/GetAccountLimit

GetAccountLimitRequest

func (c *Route53) GetAccountLimitRequest(input *GetAccountLimitInput) (req *request.Request, output *GetAccountLimitOutput)

GetAccountLimitRequest generates a "aws/request.Request" representing the client's request for the GetAccountLimit operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetAccountLimit for more information on using the GetAccountLimit API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the GetAccountLimitRequest method. req, resp := client.GetAccountLimitRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/GetAccountLimit

GetAccountLimitWithContext

func (c *Route53) GetAccountLimitWithContext(ctx aws.Context, input *GetAccountLimitInput, opts ...request.Option) (*GetAccountLimitOutput, error)

GetAccountLimitWithContext is the same as GetAccountLimit with the addition of the ability to pass a context and additional request options.

See GetAccountLimit for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

GetChange

func (c *Route53) GetChange(input *GetChangeInput) (*GetChangeOutput, error)

GetChange API operation for Amazon Route 53.

Returns the current status of a change batch request. The status is one of the following values:

  • PENDING indicates that the changes in this request have not propagated to all Amazon Route 53 DNS servers. This is the initial status of all change batch requests.

  • INSYNC indicates that the changes have propagated to all Route 53 DNS servers.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation GetChange for usage and error information.

Returned Error Codes:

  • ErrCodeNoSuchChange "NoSuchChange" A change with the specified change ID does not exist.

  • ErrCodeInvalidInput "InvalidInput" The input is not valid.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/GetChange

GetChangeRequest

func (c *Route53) GetChangeRequest(input *GetChangeInput) (req *request.Request, output *GetChangeOutput)

GetChangeRequest generates a "aws/request.Request" representing the client's request for the GetChange operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetChange for more information on using the GetChange API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the GetChangeRequest method. req, resp := client.GetChangeRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/GetChange

GetChangeWithContext

func (c *Route53) GetChangeWithContext(ctx aws.Context, input *GetChangeInput, opts ...request.Option) (*GetChangeOutput, error)

GetChangeWithContext is the same as GetChange with the addition of the ability to pass a context and additional request options.

See GetChange for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

GetCheckerIpRanges

func (c *Route53) GetCheckerIpRanges(input *GetCheckerIpRangesInput) (*GetCheckerIpRangesOutput, error)

GetCheckerIpRanges API operation for Amazon Route 53.

GetCheckerIpRanges still works, but we recommend that you download ip-ranges.json, which includes IP address ranges for all AWS services. For more information, see IP Address Ranges of Amazon Route 53 Servers (https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/route-53-ip-addresses.html) in the Amazon Route 53 Developer Guide.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation GetCheckerIpRanges for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/GetCheckerIpRanges

GetCheckerIpRangesRequest

func (c *Route53) GetCheckerIpRangesRequest(input *GetCheckerIpRangesInput) (req *request.Request, output *GetCheckerIpRangesOutput)

GetCheckerIpRangesRequest generates a "aws/request.Request" representing the client's request for the GetCheckerIpRanges operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetCheckerIpRanges for more information on using the GetCheckerIpRanges API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the GetCheckerIpRangesRequest method. req, resp := client.GetCheckerIpRangesRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/GetCheckerIpRanges

GetCheckerIpRangesWithContext

func (c *Route53) GetCheckerIpRangesWithContext(ctx aws.Context, input *GetCheckerIpRangesInput, opts ...request.Option) (*GetCheckerIpRangesOutput, error)

GetCheckerIpRangesWithContext is the same as GetCheckerIpRanges with the addition of the ability to pass a context and additional request options.

See GetCheckerIpRanges for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

GetGeoLocation

func (c *Route53) GetGeoLocation(input *GetGeoLocationInput) (*GetGeoLocationOutput, error)

GetGeoLocation API operation for Amazon Route 53.

Gets information about whether a specified geographic location is supported for Amazon Route 53 geolocation resource record sets.

Use the following syntax to determine whether a continent is supported for geolocation:

GET /2013-04-01/geolocation?continentcode=two-letter abbreviation for a continent

Use the following syntax to determine whether a country is supported for geolocation:

GET /2013-04-01/geolocation?countrycode=two-character country code

Use the following syntax to determine whether a subdivision of a country is supported for geolocation:

GET /2013-04-01/geolocation?countrycode=two-character country code&subdivisioncode=subdivision code

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation GetGeoLocation for usage and error information.

Returned Error Codes:

  • ErrCodeNoSuchGeoLocation "NoSuchGeoLocation" Amazon Route 53 doesn't support the specified geographic location.

  • ErrCodeInvalidInput "InvalidInput" The input is not valid.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/GetGeoLocation

GetGeoLocationRequest

func (c *Route53) GetGeoLocationRequest(input *GetGeoLocationInput) (req *request.Request, output *GetGeoLocationOutput)

GetGeoLocationRequest generates a "aws/request.Request" representing the client's request for the GetGeoLocation operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetGeoLocation for more information on using the GetGeoLocation API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the GetGeoLocationRequest method. req, resp := client.GetGeoLocationRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/GetGeoLocation

GetGeoLocationWithContext

func (c *Route53) GetGeoLocationWithContext(ctx aws.Context, input *GetGeoLocationInput, opts ...request.Option) (*GetGeoLocationOutput, error)

GetGeoLocationWithContext is the same as GetGeoLocation with the addition of the ability to pass a context and additional request options.

See GetGeoLocation for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

GetHealthCheck

func (c *Route53) GetHealthCheck(input *GetHealthCheckInput) (*GetHealthCheckOutput, error)

GetHealthCheck API operation for Amazon Route 53.

Gets information about a specified health check.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation GetHealthCheck for usage and error information.

Returned Error Codes:

  • ErrCodeNoSuchHealthCheck "NoSuchHealthCheck" No health check exists with the specified ID.

  • ErrCodeInvalidInput "InvalidInput" The input is not valid.

  • ErrCodeIncompatibleVersion "IncompatibleVersion" The resource you're trying to access is unsupported on this Amazon Route 53 endpoint.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/GetHealthCheck

GetHealthCheckCount

func (c *Route53) GetHealthCheckCount(input *GetHealthCheckCountInput) (*GetHealthCheckCountOutput, error)

GetHealthCheckCount API operation for Amazon Route 53.

Retrieves the number of health checks that are associated with the current AWS account.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation GetHealthCheckCount for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/GetHealthCheckCount

GetHealthCheckCountRequest

func (c *Route53) GetHealthCheckCountRequest(input *GetHealthCheckCountInput) (req *request.Request, output *GetHealthCheckCountOutput)

GetHealthCheckCountRequest generates a "aws/request.Request" representing the client's request for the GetHealthCheckCount operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetHealthCheckCount for more information on using the GetHealthCheckCount API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the GetHealthCheckCountRequest method. req, resp := client.GetHealthCheckCountRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/GetHealthCheckCount

GetHealthCheckCountWithContext

func (c *Route53) GetHealthCheckCountWithContext(ctx aws.Context, input *GetHealthCheckCountInput, opts ...request.Option) (*GetHealthCheckCountOutput, error)

GetHealthCheckCountWithContext is the same as GetHealthCheckCount with the addition of the ability to pass a context and additional request options.

See GetHealthCheckCount for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

GetHealthCheckLastFailureReason

func (c *Route53) GetHealthCheckLastFailureReason(input *GetHealthCheckLastFailureReasonInput) (*GetHealthCheckLastFailureReasonOutput, error)

GetHealthCheckLastFailureReason API operation for Amazon Route 53.

Gets the reason that a specified health check failed most recently.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation GetHealthCheckLastFailureReason for usage and error information.

Returned Error Codes:

  • ErrCodeNoSuchHealthCheck "NoSuchHealthCheck" No health check exists with the specified ID.

  • ErrCodeInvalidInput "InvalidInput" The input is not valid.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/GetHealthCheckLastFailureReason

GetHealthCheckLastFailureReasonRequest

func (c *Route53) GetHealthCheckLastFailureReasonRequest(input *GetHealthCheckLastFailureReasonInput) (req *request.Request, output *GetHealthCheckLastFailureReasonOutput)

GetHealthCheckLastFailureReasonRequest generates a "aws/request.Request" representing the client's request for the GetHealthCheckLastFailureReason operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetHealthCheckLastFailureReason for more information on using the GetHealthCheckLastFailureReason API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the GetHealthCheckLastFailureReasonRequest method. req, resp := client.GetHealthCheckLastFailureReasonRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/GetHealthCheckLastFailureReason

GetHealthCheckLastFailureReasonWithContext

func (c *Route53) GetHealthCheckLastFailureReasonWithContext(ctx aws.Context, input *GetHealthCheckLastFailureReasonInput, opts ...request.Option) (*GetHealthCheckLastFailureReasonOutput, error)

GetHealthCheckLastFailureReasonWithContext is the same as GetHealthCheckLastFailureReason with the addition of the ability to pass a context and additional request options.

See GetHealthCheckLastFailureReason for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

GetHealthCheckRequest

func (c *Route53) GetHealthCheckRequest(input *GetHealthCheckInput) (req *request.Request, output *GetHealthCheckOutput)

GetHealthCheckRequest generates a "aws/request.Request" representing the client's request for the GetHealthCheck operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetHealthCheck for more information on using the GetHealthCheck API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the GetHealthCheckRequest method. req, resp := client.GetHealthCheckRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/GetHealthCheck

GetHealthCheckStatus

func (c *Route53) GetHealthCheckStatus(input *GetHealthCheckStatusInput) (*GetHealthCheckStatusOutput, error)

GetHealthCheckStatus API operation for Amazon Route 53.

Gets status of a specified health check.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation GetHealthCheckStatus for usage and error information.

Returned Error Codes:

  • ErrCodeNoSuchHealthCheck "NoSuchHealthCheck" No health check exists with the specified ID.

  • ErrCodeInvalidInput "InvalidInput" The input is not valid.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/GetHealthCheckStatus

GetHealthCheckStatusRequest

func (c *Route53) GetHealthCheckStatusRequest(input *GetHealthCheckStatusInput) (req *request.Request, output *GetHealthCheckStatusOutput)

GetHealthCheckStatusRequest generates a "aws/request.Request" representing the client's request for the GetHealthCheckStatus operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetHealthCheckStatus for more information on using the GetHealthCheckStatus API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the GetHealthCheckStatusRequest method. req, resp := client.GetHealthCheckStatusRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/GetHealthCheckStatus

GetHealthCheckStatusWithContext

func (c *Route53) GetHealthCheckStatusWithContext(ctx aws.Context, input *GetHealthCheckStatusInput, opts ...request.Option) (*GetHealthCheckStatusOutput, error)

GetHealthCheckStatusWithContext is the same as GetHealthCheckStatus with the addition of the ability to pass a context and additional request options.

See GetHealthCheckStatus for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

GetHealthCheckWithContext

func (c *Route53) GetHealthCheckWithContext(ctx aws.Context, input *GetHealthCheckInput, opts ...request.Option) (*GetHealthCheckOutput, error)

GetHealthCheckWithContext is the same as GetHealthCheck with the addition of the ability to pass a context and additional request options.

See GetHealthCheck for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

GetHostedZone

func (c *Route53) GetHostedZone(input *GetHostedZoneInput) (*GetHostedZoneOutput, error)

GetHostedZone API operation for Amazon Route 53.

Gets information about a specified hosted zone including the four name servers assigned to the hosted zone.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation GetHostedZone for usage and error information.

Returned Error Codes:

  • ErrCodeNoSuchHostedZone "NoSuchHostedZone" No hosted zone exists with the ID that you specified.

  • ErrCodeInvalidInput "InvalidInput" The input is not valid.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/GetHostedZone

Example

Route53 GetHostedZone shared00

To get information about a hosted zone

The following example gets information about the Z3M3LMPEXAMPLE hosted zone.

{ svc := route53.New(session.New()) input := &route53.GetHostedZoneInput{ Id: aws.String("Z3M3LMPEXAMPLE"), } result, err := svc.GetHostedZone(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case route53.ErrCodeNoSuchHostedZone: fmt.Println(route53.ErrCodeNoSuchHostedZone, aerr.Error()) case route53.ErrCodeInvalidInput: fmt.Println(route53.ErrCodeInvalidInput, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

GetHostedZoneCount

func (c *Route53) GetHostedZoneCount(input *GetHostedZoneCountInput) (*GetHostedZoneCountOutput, error)

GetHostedZoneCount API operation for Amazon Route 53.

Retrieves the number of hosted zones that are associated with the current AWS account.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation GetHostedZoneCount for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidInput "InvalidInput" The input is not valid.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/GetHostedZoneCount

GetHostedZoneCountRequest

func (c *Route53) GetHostedZoneCountRequest(input *GetHostedZoneCountInput) (req *request.Request, output *GetHostedZoneCountOutput)

GetHostedZoneCountRequest generates a "aws/request.Request" representing the client's request for the GetHostedZoneCount operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetHostedZoneCount for more information on using the GetHostedZoneCount API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the GetHostedZoneCountRequest method. req, resp := client.GetHostedZoneCountRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/GetHostedZoneCount

GetHostedZoneCountWithContext

func (c *Route53) GetHostedZoneCountWithContext(ctx aws.Context, input *GetHostedZoneCountInput, opts ...request.Option) (*GetHostedZoneCountOutput, error)

GetHostedZoneCountWithContext is the same as GetHostedZoneCount with the addition of the ability to pass a context and additional request options.

See GetHostedZoneCount for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

GetHostedZoneLimit

func (c *Route53) GetHostedZoneLimit(input *GetHostedZoneLimitInput) (*GetHostedZoneLimitOutput, error)

GetHostedZoneLimit API operation for Amazon Route 53.

Gets the specified limit for a specified hosted zone, for example, the maximum number of records that you can create in the hosted zone.

For the default limit, see Limits (https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/DNSLimitations.html) in the Amazon Route 53 Developer Guide. To request a higher limit, open a case (https://console.aws.amazon.com/support/home#/case/create?issueType=service-limit-increase&limitType=service-code-route53).

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation GetHostedZoneLimit for usage and error information.

Returned Error Codes:

  • ErrCodeNoSuchHostedZone "NoSuchHostedZone" No hosted zone exists with the ID that you specified.

  • ErrCodeInvalidInput "InvalidInput" The input is not valid.

  • ErrCodeHostedZoneNotPrivate "HostedZoneNotPrivate" The specified hosted zone is a public hosted zone, not a private hosted zone.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/GetHostedZoneLimit

GetHostedZoneLimitRequest

func (c *Route53) GetHostedZoneLimitRequest(input *GetHostedZoneLimitInput) (req *request.Request, output *GetHostedZoneLimitOutput)

GetHostedZoneLimitRequest generates a "aws/request.Request" representing the client's request for the GetHostedZoneLimit operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetHostedZoneLimit for more information on using the GetHostedZoneLimit API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the GetHostedZoneLimitRequest method. req, resp := client.GetHostedZoneLimitRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/GetHostedZoneLimit

GetHostedZoneLimitWithContext

func (c *Route53) GetHostedZoneLimitWithContext(ctx aws.Context, input *GetHostedZoneLimitInput, opts ...request.Option) (*GetHostedZoneLimitOutput, error)

GetHostedZoneLimitWithContext is the same as GetHostedZoneLimit with the addition of the ability to pass a context and additional request options.

See GetHostedZoneLimit for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

GetHostedZoneRequest

func (c *Route53) GetHostedZoneRequest(input *GetHostedZoneInput) (req *request.Request, output *GetHostedZoneOutput)

GetHostedZoneRequest generates a "aws/request.Request" representing the client's request for the GetHostedZone operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetHostedZone for more information on using the GetHostedZone API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the GetHostedZoneRequest method. req, resp := client.GetHostedZoneRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/GetHostedZone

GetHostedZoneWithContext

func (c *Route53) GetHostedZoneWithContext(ctx aws.Context, input *GetHostedZoneInput, opts ...request.Option) (*GetHostedZoneOutput, error)

GetHostedZoneWithContext is the same as GetHostedZone with the addition of the ability to pass a context and additional request options.

See GetHostedZone for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

GetQueryLoggingConfig

func (c *Route53) GetQueryLoggingConfig(input *GetQueryLoggingConfigInput) (*GetQueryLoggingConfigOutput, error)

GetQueryLoggingConfig API operation for Amazon Route 53.

Gets information about a specified configuration for DNS query logging.

For more information about DNS query logs, see CreateQueryLoggingConfig and Logging DNS Queries (https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/query-logs.html).

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation GetQueryLoggingConfig for usage and error information.

Returned Error Codes:

  • ErrCodeNoSuchQueryLoggingConfig "NoSuchQueryLoggingConfig" There is no DNS query logging configuration with the specified ID.

  • ErrCodeInvalidInput "InvalidInput" The input is not valid.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/GetQueryLoggingConfig

GetQueryLoggingConfigRequest

func (c *Route53) GetQueryLoggingConfigRequest(input *GetQueryLoggingConfigInput) (req *request.Request, output *GetQueryLoggingConfigOutput)

GetQueryLoggingConfigRequest generates a "aws/request.Request" representing the client's request for the GetQueryLoggingConfig operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetQueryLoggingConfig for more information on using the GetQueryLoggingConfig API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the GetQueryLoggingConfigRequest method. req, resp := client.GetQueryLoggingConfigRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/GetQueryLoggingConfig

GetQueryLoggingConfigWithContext

func (c *Route53) GetQueryLoggingConfigWithContext(ctx aws.Context, input *GetQueryLoggingConfigInput, opts ...request.Option) (*GetQueryLoggingConfigOutput, error)

GetQueryLoggingConfigWithContext is the same as GetQueryLoggingConfig with the addition of the ability to pass a context and additional request options.

See GetQueryLoggingConfig for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

GetReusableDelegationSet

func (c *Route53) GetReusableDelegationSet(input *GetReusableDelegationSetInput) (*GetReusableDelegationSetOutput, error)

GetReusableDelegationSet API operation for Amazon Route 53.

Retrieves information about a specified reusable delegation set, including the four name servers that are assigned to the delegation set.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation GetReusableDelegationSet for usage and error information.

Returned Error Codes:

  • ErrCodeNoSuchDelegationSet "NoSuchDelegationSet" A reusable delegation set with the specified ID does not exist.

  • ErrCodeDelegationSetNotReusable "DelegationSetNotReusable" A reusable delegation set with the specified ID does not exist.

  • ErrCodeInvalidInput "InvalidInput" The input is not valid.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/GetReusableDelegationSet

GetReusableDelegationSetLimit

func (c *Route53) GetReusableDelegationSetLimit(input *GetReusableDelegationSetLimitInput) (*GetReusableDelegationSetLimitOutput, error)

GetReusableDelegationSetLimit API operation for Amazon Route 53.

Gets the maximum number of hosted zones that you can associate with the specified reusable delegation set.

For the default limit, see Limits (https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/DNSLimitations.html) in the Amazon Route 53 Developer Guide. To request a higher limit, open a case (https://console.aws.amazon.com/support/home#/case/create?issueType=service-limit-increase&limitType=service-code-route53).

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation GetReusableDelegationSetLimit for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidInput "InvalidInput" The input is not valid.

  • ErrCodeNoSuchDelegationSet "NoSuchDelegationSet" A reusable delegation set with the specified ID does not exist.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/GetReusableDelegationSetLimit

GetReusableDelegationSetLimitRequest

func (c *Route53) GetReusableDelegationSetLimitRequest(input *GetReusableDelegationSetLimitInput) (req *request.Request, output *GetReusableDelegationSetLimitOutput)

GetReusableDelegationSetLimitRequest generates a "aws/request.Request" representing the client's request for the GetReusableDelegationSetLimit operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetReusableDelegationSetLimit for more information on using the GetReusableDelegationSetLimit API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the GetReusableDelegationSetLimitRequest method. req, resp := client.GetReusableDelegationSetLimitRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/GetReusableDelegationSetLimit

GetReusableDelegationSetLimitWithContext

func (c *Route53) GetReusableDelegationSetLimitWithContext(ctx aws.Context, input *GetReusableDelegationSetLimitInput, opts ...request.Option) (*GetReusableDelegationSetLimitOutput, error)

GetReusableDelegationSetLimitWithContext is the same as GetReusableDelegationSetLimit with the addition of the ability to pass a context and additional request options.

See GetReusableDelegationSetLimit for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

GetReusableDelegationSetRequest

func (c *Route53) GetReusableDelegationSetRequest(input *GetReusableDelegationSetInput) (req *request.Request, output *GetReusableDelegationSetOutput)

GetReusableDelegationSetRequest generates a "aws/request.Request" representing the client's request for the GetReusableDelegationSet operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetReusableDelegationSet for more information on using the GetReusableDelegationSet API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the GetReusableDelegationSetRequest method. req, resp := client.GetReusableDelegationSetRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/GetReusableDelegationSet

GetReusableDelegationSetWithContext

func (c *Route53) GetReusableDelegationSetWithContext(ctx aws.Context, input *GetReusableDelegationSetInput, opts ...request.Option) (*GetReusableDelegationSetOutput, error)

GetReusableDelegationSetWithContext is the same as GetReusableDelegationSet with the addition of the ability to pass a context and additional request options.

See GetReusableDelegationSet for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

GetTrafficPolicy

func (c *Route53) GetTrafficPolicy(input *GetTrafficPolicyInput) (*GetTrafficPolicyOutput, error)

GetTrafficPolicy API operation for Amazon Route 53.

Gets information about a specific traffic policy version.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation GetTrafficPolicy for usage and error information.

Returned Error Codes:

  • ErrCodeNoSuchTrafficPolicy "NoSuchTrafficPolicy" No traffic policy exists with the specified ID.

  • ErrCodeInvalidInput "InvalidInput" The input is not valid.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/GetTrafficPolicy

GetTrafficPolicyInstance

func (c *Route53) GetTrafficPolicyInstance(input *GetTrafficPolicyInstanceInput) (*GetTrafficPolicyInstanceOutput, error)

GetTrafficPolicyInstance API operation for Amazon Route 53.

Gets information about a specified traffic policy instance.

After you submit a CreateTrafficPolicyInstance or an UpdateTrafficPolicyInstance request, there's a brief delay while Amazon Route 53 creates the resource record sets that are specified in the traffic policy definition. For more information, see the State response element.

In the Route 53 console, traffic policy instances are known as policy records.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation GetTrafficPolicyInstance for usage and error information.

Returned Error Codes:

  • ErrCodeNoSuchTrafficPolicyInstance "NoSuchTrafficPolicyInstance" No traffic policy instance exists with the specified ID.

  • ErrCodeInvalidInput "InvalidInput" The input is not valid.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/GetTrafficPolicyInstance

GetTrafficPolicyInstanceCount

func (c *Route53) GetTrafficPolicyInstanceCount(input *GetTrafficPolicyInstanceCountInput) (*GetTrafficPolicyInstanceCountOutput, error)

GetTrafficPolicyInstanceCount API operation for Amazon Route 53.

Gets the number of traffic policy instances that are associated with the current AWS account.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation GetTrafficPolicyInstanceCount for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/GetTrafficPolicyInstanceCount

GetTrafficPolicyInstanceCountRequest

func (c *Route53) GetTrafficPolicyInstanceCountRequest(input *GetTrafficPolicyInstanceCountInput) (req *request.Request, output *GetTrafficPolicyInstanceCountOutput)

GetTrafficPolicyInstanceCountRequest generates a "aws/request.Request" representing the client's request for the GetTrafficPolicyInstanceCount operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetTrafficPolicyInstanceCount for more information on using the GetTrafficPolicyInstanceCount API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the GetTrafficPolicyInstanceCountRequest method. req, resp := client.GetTrafficPolicyInstanceCountRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/GetTrafficPolicyInstanceCount

GetTrafficPolicyInstanceCountWithContext

func (c *Route53) GetTrafficPolicyInstanceCountWithContext(ctx aws.Context, input *GetTrafficPolicyInstanceCountInput, opts ...request.Option) (*GetTrafficPolicyInstanceCountOutput, error)

GetTrafficPolicyInstanceCountWithContext is the same as GetTrafficPolicyInstanceCount with the addition of the ability to pass a context and additional request options.

See GetTrafficPolicyInstanceCount for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

GetTrafficPolicyInstanceRequest

func (c *Route53) GetTrafficPolicyInstanceRequest(input *GetTrafficPolicyInstanceInput) (req *request.Request, output *GetTrafficPolicyInstanceOutput)

GetTrafficPolicyInstanceRequest generates a "aws/request.Request" representing the client's request for the GetTrafficPolicyInstance operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetTrafficPolicyInstance for more information on using the GetTrafficPolicyInstance API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the GetTrafficPolicyInstanceRequest method. req, resp := client.GetTrafficPolicyInstanceRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/GetTrafficPolicyInstance

GetTrafficPolicyInstanceWithContext

func (c *Route53) GetTrafficPolicyInstanceWithContext(ctx aws.Context, input *GetTrafficPolicyInstanceInput, opts ...request.Option) (*GetTrafficPolicyInstanceOutput, error)

GetTrafficPolicyInstanceWithContext is the same as GetTrafficPolicyInstance with the addition of the ability to pass a context and additional request options.

See GetTrafficPolicyInstance for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

GetTrafficPolicyRequest

func (c *Route53) GetTrafficPolicyRequest(input *GetTrafficPolicyInput) (req *request.Request, output *GetTrafficPolicyOutput)

GetTrafficPolicyRequest generates a "aws/request.Request" representing the client's request for the GetTrafficPolicy operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetTrafficPolicy for more information on using the GetTrafficPolicy API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the GetTrafficPolicyRequest method. req, resp := client.GetTrafficPolicyRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/GetTrafficPolicy

GetTrafficPolicyWithContext

func (c *Route53) GetTrafficPolicyWithContext(ctx aws.Context, input *GetTrafficPolicyInput, opts ...request.Option) (*GetTrafficPolicyOutput, error)

GetTrafficPolicyWithContext is the same as GetTrafficPolicy with the addition of the ability to pass a context and additional request options.

See GetTrafficPolicy for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

ListGeoLocations

func (c *Route53) ListGeoLocations(input *ListGeoLocationsInput) (*ListGeoLocationsOutput, error)

ListGeoLocations API operation for Amazon Route 53.

Retrieves a list of supported geographic locations.

Countries are listed first, and continents are listed last. If Amazon Route 53 supports subdivisions for a country (for example, states or provinces), the subdivisions for that country are listed in alphabetical order immediately after the corresponding country.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation ListGeoLocations for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidInput "InvalidInput" The input is not valid.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ListGeoLocations

ListGeoLocationsRequest

func (c *Route53) ListGeoLocationsRequest(input *ListGeoLocationsInput) (req *request.Request, output *ListGeoLocationsOutput)

ListGeoLocationsRequest generates a "aws/request.Request" representing the client's request for the ListGeoLocations operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See ListGeoLocations for more information on using the ListGeoLocations API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the ListGeoLocationsRequest method. req, resp := client.ListGeoLocationsRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ListGeoLocations

ListGeoLocationsWithContext

func (c *Route53) ListGeoLocationsWithContext(ctx aws.Context, input *ListGeoLocationsInput, opts ...request.Option) (*ListGeoLocationsOutput, error)

ListGeoLocationsWithContext is the same as ListGeoLocations with the addition of the ability to pass a context and additional request options.

See ListGeoLocations for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

ListHealthChecks

func (c *Route53) ListHealthChecks(input *ListHealthChecksInput) (*ListHealthChecksOutput, error)

ListHealthChecks API operation for Amazon Route 53.

Retrieve a list of the health checks that are associated with the current AWS account.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation ListHealthChecks for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidInput "InvalidInput" The input is not valid.

  • ErrCodeIncompatibleVersion "IncompatibleVersion" The resource you're trying to access is unsupported on this Amazon Route 53 endpoint.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ListHealthChecks

ListHealthChecksPages

func (c *Route53) ListHealthChecksPages(input *ListHealthChecksInput, fn func(*ListHealthChecksOutput, bool) bool) error

ListHealthChecksPages iterates over the pages of a ListHealthChecks operation, calling the "fn" function with the response data for each page. To stop iterating, return false from the fn function.

See ListHealthChecks method for more information on how to use this operation.

Note: This operation can generate multiple requests to a service.

// Example iterating over at most 3 pages of a ListHealthChecks operation. pageNum := 0 err := client.ListHealthChecksPages(params, func(page *ListHealthChecksOutput, lastPage bool) bool { pageNum++ fmt.Println(page) return pageNum <= 3 })

See Also

For more information about using this API, see AWS API Documentation.

ListHealthChecksPagesWithContext

func (c *Route53) ListHealthChecksPagesWithContext(ctx aws.Context, input *ListHealthChecksInput, fn func(*ListHealthChecksOutput, bool) bool, opts ...request.Option) error

ListHealthChecksPagesWithContext same as ListHealthChecksPages except it takes a Context and allows setting request options on the pages.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

ListHealthChecksRequest

func (c *Route53) ListHealthChecksRequest(input *ListHealthChecksInput) (req *request.Request, output *ListHealthChecksOutput)

ListHealthChecksRequest generates a "aws/request.Request" representing the client's request for the ListHealthChecks operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See ListHealthChecks for more information on using the ListHealthChecks API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the ListHealthChecksRequest method. req, resp := client.ListHealthChecksRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ListHealthChecks

ListHealthChecksWithContext

func (c *Route53) ListHealthChecksWithContext(ctx aws.Context, input *ListHealthChecksInput, opts ...request.Option) (*ListHealthChecksOutput, error)

ListHealthChecksWithContext is the same as ListHealthChecks with the addition of the ability to pass a context and additional request options.

See ListHealthChecks for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

ListHostedZones

func (c *Route53) ListHostedZones(input *ListHostedZonesInput) (*ListHostedZonesOutput, error)

ListHostedZones API operation for Amazon Route 53.

Retrieves a list of the public and private hosted zones that are associated with the current AWS account. The response includes a HostedZones child element for each hosted zone.

Amazon Route 53 returns a maximum of 100 items in each response. If you have a lot of hosted zones, you can use the maxitems parameter to list them in groups of up to 100.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation ListHostedZones for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidInput "InvalidInput" The input is not valid.

  • ErrCodeNoSuchDelegationSet "NoSuchDelegationSet" A reusable delegation set with the specified ID does not exist.

  • ErrCodeDelegationSetNotReusable "DelegationSetNotReusable" A reusable delegation set with the specified ID does not exist.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ListHostedZones

ListHostedZonesByName

func (c *Route53) ListHostedZonesByName(input *ListHostedZonesByNameInput) (*ListHostedZonesByNameOutput, error)

ListHostedZonesByName API operation for Amazon Route 53.

Retrieves a list of your hosted zones in lexicographic order. The response includes a HostedZones child element for each hosted zone created by the current AWS account.

ListHostedZonesByName sorts hosted zones by name with the labels reversed. For example:

com.example.www.

Note the trailing dot, which can change the sort order in some circumstances.

If the domain name includes escape characters or Punycode, ListHostedZonesByName alphabetizes the domain name using the escaped or Punycoded value, which is the format that Amazon Route 53 saves in its database. For example, to create a hosted zone for exämple.com, you specify ex\344mple.com for the domain name. ListHostedZonesByName alphabetizes it as:

com.ex\344mple.

The labels are reversed and alphabetized using the escaped value. For more information about valid domain name formats, including internationalized domain names, see DNS Domain Name Format (https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/DomainNameFormat.html) in the Amazon Route 53 Developer Guide.

Route 53 returns up to 100 items in each response. If you have a lot of hosted zones, use the MaxItems parameter to list them in groups of up to 100. The response includes values that help navigate from one group of MaxItems hosted zones to the next:

  • The DNSName and HostedZoneId elements in the response contain the values, if any, specified for the dnsname and hostedzoneid parameters in the request that produced the current response.

  • The MaxItems element in the response contains the value, if any, that you specified for the maxitems parameter in the request that produced the current response.

  • If the value of IsTruncated in the response is true, there are more hosted zones associated with the current AWS account.

If IsTruncated is false, this response includes the last hosted zone that

is associated with the current account. The NextDNSName element and NextHostedZoneId elements are omitted from the response.
  • The NextDNSName and NextHostedZoneId elements in the response contain the domain name and the hosted zone ID of the next hosted zone that is associated with the current AWS account. If you want to list more hosted zones, make another call to ListHostedZonesByName, and specify the value of NextDNSName and NextHostedZoneId in the dnsname and hostedzoneid parameters, respectively.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation ListHostedZonesByName for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidInput "InvalidInput" The input is not valid.

  • ErrCodeInvalidDomainName "InvalidDomainName" The specified domain name is not valid.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ListHostedZonesByName

ListHostedZonesByNameRequest

func (c *Route53) ListHostedZonesByNameRequest(input *ListHostedZonesByNameInput) (req *request.Request, output *ListHostedZonesByNameOutput)

ListHostedZonesByNameRequest generates a "aws/request.Request" representing the client's request for the ListHostedZonesByName operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See ListHostedZonesByName for more information on using the ListHostedZonesByName API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the ListHostedZonesByNameRequest method. req, resp := client.ListHostedZonesByNameRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ListHostedZonesByName

ListHostedZonesByNameWithContext

func (c *Route53) ListHostedZonesByNameWithContext(ctx aws.Context, input *ListHostedZonesByNameInput, opts ...request.Option) (*ListHostedZonesByNameOutput, error)

ListHostedZonesByNameWithContext is the same as ListHostedZonesByName with the addition of the ability to pass a context and additional request options.

See ListHostedZonesByName for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

ListHostedZonesPages

func (c *Route53) ListHostedZonesPages(input *ListHostedZonesInput, fn func(*ListHostedZonesOutput, bool) bool) error

ListHostedZonesPages iterates over the pages of a ListHostedZones operation, calling the "fn" function with the response data for each page. To stop iterating, return false from the fn function.

See ListHostedZones method for more information on how to use this operation.

Note: This operation can generate multiple requests to a service.

// Example iterating over at most 3 pages of a ListHostedZones operation. pageNum := 0 err := client.ListHostedZonesPages(params, func(page *ListHostedZonesOutput, lastPage bool) bool { pageNum++ fmt.Println(page) return pageNum <= 3 })

See Also

For more information about using this API, see AWS API Documentation.

ListHostedZonesPagesWithContext

func (c *Route53) ListHostedZonesPagesWithContext(ctx aws.Context, input *ListHostedZonesInput, fn func(*ListHostedZonesOutput, bool) bool, opts ...request.Option) error

ListHostedZonesPagesWithContext same as ListHostedZonesPages except it takes a Context and allows setting request options on the pages.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

ListHostedZonesRequest

func (c *Route53) ListHostedZonesRequest(input *ListHostedZonesInput) (req *request.Request, output *ListHostedZonesOutput)

ListHostedZonesRequest generates a "aws/request.Request" representing the client's request for the ListHostedZones operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See ListHostedZones for more information on using the ListHostedZones API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the ListHostedZonesRequest method. req, resp := client.ListHostedZonesRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ListHostedZones

ListHostedZonesWithContext

func (c *Route53) ListHostedZonesWithContext(ctx aws.Context, input *ListHostedZonesInput, opts ...request.Option) (*ListHostedZonesOutput, error)

ListHostedZonesWithContext is the same as ListHostedZones with the addition of the ability to pass a context and additional request options.

See ListHostedZones for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

ListQueryLoggingConfigs

func (c *Route53) ListQueryLoggingConfigs(input *ListQueryLoggingConfigsInput) (*ListQueryLoggingConfigsOutput, error)

ListQueryLoggingConfigs API operation for Amazon Route 53.

Lists the configurations for DNS query logging that are associated with the current AWS account or the configuration that is associated with a specified hosted zone.

For more information about DNS query logs, see CreateQueryLoggingConfig. Additional information, including the format of DNS query logs, appears in Logging DNS Queries (https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/query-logs.html) in the Amazon Route 53 Developer Guide.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation ListQueryLoggingConfigs for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidInput "InvalidInput" The input is not valid.

  • ErrCodeInvalidPaginationToken "InvalidPaginationToken" The value that you specified to get the second or subsequent page of results is invalid.

  • ErrCodeNoSuchHostedZone "NoSuchHostedZone" No hosted zone exists with the ID that you specified.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ListQueryLoggingConfigs

ListQueryLoggingConfigsRequest

func (c *Route53) ListQueryLoggingConfigsRequest(input *ListQueryLoggingConfigsInput) (req *request.Request, output *ListQueryLoggingConfigsOutput)

ListQueryLoggingConfigsRequest generates a "aws/request.Request" representing the client's request for the ListQueryLoggingConfigs operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See ListQueryLoggingConfigs for more information on using the ListQueryLoggingConfigs API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the ListQueryLoggingConfigsRequest method. req, resp := client.ListQueryLoggingConfigsRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ListQueryLoggingConfigs

ListQueryLoggingConfigsWithContext

func (c *Route53) ListQueryLoggingConfigsWithContext(ctx aws.Context, input *ListQueryLoggingConfigsInput, opts ...request.Option) (*ListQueryLoggingConfigsOutput, error)

ListQueryLoggingConfigsWithContext is the same as ListQueryLoggingConfigs with the addition of the ability to pass a context and additional request options.

See ListQueryLoggingConfigs for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

ListResourceRecordSets

func (c *Route53) ListResourceRecordSets(input *ListResourceRecordSetsInput) (*ListResourceRecordSetsOutput, error)

ListResourceRecordSets API operation for Amazon Route 53.

Lists the resource record sets in a specified hosted zone.

ListResourceRecordSets returns up to 100 resource record sets at a time in ASCII order, beginning at a position specified by the name and type elements.

Sort order

ListResourceRecordSets sorts results first by DNS name with the labels reversed, for example:

com.example.www.

Note the trailing dot, which can change the sort order when the record name contains characters that appear before . (decimal 46) in the ASCII table. These characters include the following: ! " # $ % & ' ( ) * + , -

When multiple records have the same DNS name, ListResourceRecordSets sorts results by the record type.

Specifying where to start listing records

You can use the name and type elements to specify the resource record set that the list begins with:

If you do not specify Name or TypeThe results begin with the first resource record set that the hosted zone contains.

If you specify Name but not TypeThe results begin with the first resource record set in the list whose name is greater than or equal to Name.

If you specify Type but not NameAmazon Route 53 returns the InvalidInput error.

If you specify both Name and TypeThe results begin with the first resource record set in the list whose name is greater than or equal to Name, and whose type is greater than or equal to Type.

Resource record sets that are PENDING

This action returns the most current version of the records. This includes records that are PENDING, and that are not yet available on all Route 53 DNS servers.

Changing resource record sets

To ensure that you get an accurate listing of the resource record sets for a hosted zone at a point in time, do not submit a ChangeResourceRecordSets request while you're paging through the results of a ListResourceRecordSets request. If you do, some pages may display results without the latest changes while other pages display results with the latest changes.

Displaying the next page of results

If a ListResourceRecordSets command returns more than one page of results, the value of IsTruncated is true. To display the next page of results, get the values of NextRecordName, NextRecordType, and NextRecordIdentifier (if any) from the response. Then submit another ListResourceRecordSets request, and specify those values for StartRecordName, StartRecordType, and StartRecordIdentifier.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation ListResourceRecordSets for usage and error information.

Returned Error Codes:

  • ErrCodeNoSuchHostedZone "NoSuchHostedZone" No hosted zone exists with the ID that you specified.

  • ErrCodeInvalidInput "InvalidInput" The input is not valid.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ListResourceRecordSets

ListResourceRecordSetsPages

func (c *Route53) ListResourceRecordSetsPages(input *ListResourceRecordSetsInput, fn func(*ListResourceRecordSetsOutput, bool) bool) error

ListResourceRecordSetsPages iterates over the pages of a ListResourceRecordSets operation, calling the "fn" function with the response data for each page. To stop iterating, return false from the fn function.

See ListResourceRecordSets method for more information on how to use this operation.

Note: This operation can generate multiple requests to a service.

// Example iterating over at most 3 pages of a ListResourceRecordSets operation. pageNum := 0 err := client.ListResourceRecordSetsPages(params, func(page *ListResourceRecordSetsOutput, lastPage bool) bool { pageNum++ fmt.Println(page) return pageNum <= 3 })

See Also

For more information about using this API, see AWS API Documentation.

ListResourceRecordSetsPagesWithContext

func (c *Route53) ListResourceRecordSetsPagesWithContext(ctx aws.Context, input *ListResourceRecordSetsInput, fn func(*ListResourceRecordSetsOutput, bool) bool, opts ...request.Option) error

ListResourceRecordSetsPagesWithContext same as ListResourceRecordSetsPages except it takes a Context and allows setting request options on the pages.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

ListResourceRecordSetsRequest

func (c *Route53) ListResourceRecordSetsRequest(input *ListResourceRecordSetsInput) (req *request.Request, output *ListResourceRecordSetsOutput)

ListResourceRecordSetsRequest generates a "aws/request.Request" representing the client's request for the ListResourceRecordSets operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See ListResourceRecordSets for more information on using the ListResourceRecordSets API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the ListResourceRecordSetsRequest method. req, resp := client.ListResourceRecordSetsRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ListResourceRecordSets

ListResourceRecordSetsWithContext

func (c *Route53) ListResourceRecordSetsWithContext(ctx aws.Context, input *ListResourceRecordSetsInput, opts ...request.Option) (*ListResourceRecordSetsOutput, error)

ListResourceRecordSetsWithContext is the same as ListResourceRecordSets with the addition of the ability to pass a context and additional request options.

See ListResourceRecordSets for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

ListReusableDelegationSets

func (c *Route53) ListReusableDelegationSets(input *ListReusableDelegationSetsInput) (*ListReusableDelegationSetsOutput, error)

ListReusableDelegationSets API operation for Amazon Route 53.

Retrieves a list of the reusable delegation sets that are associated with the current AWS account.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation ListReusableDelegationSets for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidInput "InvalidInput" The input is not valid.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ListReusableDelegationSets

ListReusableDelegationSetsRequest

func (c *Route53) ListReusableDelegationSetsRequest(input *ListReusableDelegationSetsInput) (req *request.Request, output *ListReusableDelegationSetsOutput)

ListReusableDelegationSetsRequest generates a "aws/request.Request" representing the client's request for the ListReusableDelegationSets operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See ListReusableDelegationSets for more information on using the ListReusableDelegationSets API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the ListReusableDelegationSetsRequest method. req, resp := client.ListReusableDelegationSetsRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ListReusableDelegationSets

ListReusableDelegationSetsWithContext

func (c *Route53) ListReusableDelegationSetsWithContext(ctx aws.Context, input *ListReusableDelegationSetsInput, opts ...request.Option) (*ListReusableDelegationSetsOutput, error)

ListReusableDelegationSetsWithContext is the same as ListReusableDelegationSets with the addition of the ability to pass a context and additional request options.

See ListReusableDelegationSets for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

ListTagsForResource

func (c *Route53) ListTagsForResource(input *ListTagsForResourceInput) (*ListTagsForResourceOutput, error)

ListTagsForResource API operation for Amazon Route 53.

Lists tags for one health check or hosted zone.

For information about using tags for cost allocation, see Using Cost Allocation Tags (https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) in the AWS Billing and Cost Management User Guide.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation ListTagsForResource for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidInput "InvalidInput" The input is not valid.

  • ErrCodeNoSuchHealthCheck "NoSuchHealthCheck" No health check exists with the specified ID.

  • ErrCodeNoSuchHostedZone "NoSuchHostedZone" No hosted zone exists with the ID that you specified.

  • ErrCodePriorRequestNotComplete "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.

  • ErrCodeThrottlingException "ThrottlingException" The limit on the number of requests per second was exceeded.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ListTagsForResource

ListTagsForResourceRequest

func (c *Route53) ListTagsForResourceRequest(input *ListTagsForResourceInput) (req *request.Request, output *ListTagsForResourceOutput)

ListTagsForResourceRequest generates a "aws/request.Request" representing the client's request for the ListTagsForResource operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See ListTagsForResource for more information on using the ListTagsForResource API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the ListTagsForResourceRequest method. req, resp := client.ListTagsForResourceRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ListTagsForResource

ListTagsForResourceWithContext

func (c *Route53) ListTagsForResourceWithContext(ctx aws.Context, input *ListTagsForResourceInput, opts ...request.Option) (*ListTagsForResourceOutput, error)

ListTagsForResourceWithContext is the same as ListTagsForResource with the addition of the ability to pass a context and additional request options.

See ListTagsForResource for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

ListTagsForResources

func (c *Route53) ListTagsForResources(input *ListTagsForResourcesInput) (*ListTagsForResourcesOutput, error)

ListTagsForResources API operation for Amazon Route 53.

Lists tags for up to 10 health checks or hosted zones.

For information about using tags for cost allocation, see Using Cost Allocation Tags (https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) in the AWS Billing and Cost Management User Guide.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation ListTagsForResources for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidInput "InvalidInput" The input is not valid.

  • ErrCodeNoSuchHealthCheck "NoSuchHealthCheck" No health check exists with the specified ID.

  • ErrCodeNoSuchHostedZone "NoSuchHostedZone" No hosted zone exists with the ID that you specified.

  • ErrCodePriorRequestNotComplete "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.

  • ErrCodeThrottlingException "ThrottlingException" The limit on the number of requests per second was exceeded.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ListTagsForResources

ListTagsForResourcesRequest

func (c *Route53) ListTagsForResourcesRequest(input *ListTagsForResourcesInput) (req *request.Request, output *ListTagsForResourcesOutput)

ListTagsForResourcesRequest generates a "aws/request.Request" representing the client's request for the ListTagsForResources operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See ListTagsForResources for more information on using the ListTagsForResources API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the ListTagsForResourcesRequest method. req, resp := client.ListTagsForResourcesRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ListTagsForResources

ListTagsForResourcesWithContext

func (c *Route53) ListTagsForResourcesWithContext(ctx aws.Context, input *ListTagsForResourcesInput, opts ...request.Option) (*ListTagsForResourcesOutput, error)

ListTagsForResourcesWithContext is the same as ListTagsForResources with the addition of the ability to pass a context and additional request options.

See ListTagsForResources for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

ListTrafficPolicies

func (c *Route53) ListTrafficPolicies(input *ListTrafficPoliciesInput) (*ListTrafficPoliciesOutput, error)

ListTrafficPolicies API operation for Amazon Route 53.

Gets information about the latest version for every traffic policy that is associated with the current AWS account. Policies are listed in the order that they were created in.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation ListTrafficPolicies for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidInput "InvalidInput" The input is not valid.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ListTrafficPolicies

ListTrafficPoliciesRequest

func (c *Route53) ListTrafficPoliciesRequest(input *ListTrafficPoliciesInput) (req *request.Request, output *ListTrafficPoliciesOutput)

ListTrafficPoliciesRequest generates a "aws/request.Request" representing the client's request for the ListTrafficPolicies operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See ListTrafficPolicies for more information on using the ListTrafficPolicies API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the ListTrafficPoliciesRequest method. req, resp := client.ListTrafficPoliciesRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ListTrafficPolicies

ListTrafficPoliciesWithContext

func (c *Route53) ListTrafficPoliciesWithContext(ctx aws.Context, input *ListTrafficPoliciesInput, opts ...request.Option) (*ListTrafficPoliciesOutput, error)

ListTrafficPoliciesWithContext is the same as ListTrafficPolicies with the addition of the ability to pass a context and additional request options.

See ListTrafficPolicies for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

ListTrafficPolicyInstances

func (c *Route53) ListTrafficPolicyInstances(input *ListTrafficPolicyInstancesInput) (*ListTrafficPolicyInstancesOutput, error)

ListTrafficPolicyInstances API operation for Amazon Route 53.

Gets information about the traffic policy instances that you created by using the current AWS account.

After you submit an UpdateTrafficPolicyInstance request, there's a brief delay while Amazon Route 53 creates the resource record sets that are specified in the traffic policy definition. For more information, see the State response element.

Route 53 returns a maximum of 100 items in each response. If you have a lot of traffic policy instances, you can use the MaxItems parameter to list them in groups of up to 100.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation ListTrafficPolicyInstances for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidInput "InvalidInput" The input is not valid.

  • ErrCodeNoSuchTrafficPolicyInstance "NoSuchTrafficPolicyInstance" No traffic policy instance exists with the specified ID.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ListTrafficPolicyInstances

ListTrafficPolicyInstancesByHostedZone

func (c *Route53) ListTrafficPolicyInstancesByHostedZone(input *ListTrafficPolicyInstancesByHostedZoneInput) (*ListTrafficPolicyInstancesByHostedZoneOutput, error)

ListTrafficPolicyInstancesByHostedZone API operation for Amazon Route 53.

Gets information about the traffic policy instances that you created in a specified hosted zone.

After you submit a CreateTrafficPolicyInstance or an UpdateTrafficPolicyInstance request, there's a brief delay while Amazon Route 53 creates the resource record sets that are specified in the traffic policy definition. For more information, see the State response element.

Route 53 returns a maximum of 100 items in each response. If you have a lot of traffic policy instances, you can use the MaxItems parameter to list them in groups of up to 100.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation ListTrafficPolicyInstancesByHostedZone for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidInput "InvalidInput" The input is not valid.

  • ErrCodeNoSuchTrafficPolicyInstance "NoSuchTrafficPolicyInstance" No traffic policy instance exists with the specified ID.

  • ErrCodeNoSuchHostedZone "NoSuchHostedZone" No hosted zone exists with the ID that you specified.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ListTrafficPolicyInstancesByHostedZone

ListTrafficPolicyInstancesByHostedZoneRequest

func (c *Route53) ListTrafficPolicyInstancesByHostedZoneRequest(input *ListTrafficPolicyInstancesByHostedZoneInput) (req *request.Request, output *ListTrafficPolicyInstancesByHostedZoneOutput)

ListTrafficPolicyInstancesByHostedZoneRequest generates a "aws/request.Request" representing the client's request for the ListTrafficPolicyInstancesByHostedZone operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See ListTrafficPolicyInstancesByHostedZone for more information on using the ListTrafficPolicyInstancesByHostedZone API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the ListTrafficPolicyInstancesByHostedZoneRequest method. req, resp := client.ListTrafficPolicyInstancesByHostedZoneRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ListTrafficPolicyInstancesByHostedZone

ListTrafficPolicyInstancesByHostedZoneWithContext

func (c *Route53) ListTrafficPolicyInstancesByHostedZoneWithContext(ctx aws.Context, input *ListTrafficPolicyInstancesByHostedZoneInput, opts ...request.Option) (*ListTrafficPolicyInstancesByHostedZoneOutput, error)

ListTrafficPolicyInstancesByHostedZoneWithContext is the same as ListTrafficPolicyInstancesByHostedZone with the addition of the ability to pass a context and additional request options.

See ListTrafficPolicyInstancesByHostedZone for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

ListTrafficPolicyInstancesByPolicy

func (c *Route53) ListTrafficPolicyInstancesByPolicy(input *ListTrafficPolicyInstancesByPolicyInput) (*ListTrafficPolicyInstancesByPolicyOutput, error)

ListTrafficPolicyInstancesByPolicy API operation for Amazon Route 53.

Gets information about the traffic policy instances that you created by using a specify traffic policy version.

After you submit a CreateTrafficPolicyInstance or an UpdateTrafficPolicyInstance request, there's a brief delay while Amazon Route 53 creates the resource record sets that are specified in the traffic policy definition. For more information, see the State response element.

Route 53 returns a maximum of 100 items in each response. If you have a lot of traffic policy instances, you can use the MaxItems parameter to list them in groups of up to 100.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation ListTrafficPolicyInstancesByPolicy for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidInput "InvalidInput" The input is not valid.

  • ErrCodeNoSuchTrafficPolicyInstance "NoSuchTrafficPolicyInstance" No traffic policy instance exists with the specified ID.

  • ErrCodeNoSuchTrafficPolicy "NoSuchTrafficPolicy" No traffic policy exists with the specified ID.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ListTrafficPolicyInstancesByPolicy

ListTrafficPolicyInstancesByPolicyRequest

func (c *Route53) ListTrafficPolicyInstancesByPolicyRequest(input *ListTrafficPolicyInstancesByPolicyInput) (req *request.Request, output *ListTrafficPolicyInstancesByPolicyOutput)

ListTrafficPolicyInstancesByPolicyRequest generates a "aws/request.Request" representing the client's request for the ListTrafficPolicyInstancesByPolicy operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See ListTrafficPolicyInstancesByPolicy for more information on using the ListTrafficPolicyInstancesByPolicy API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the ListTrafficPolicyInstancesByPolicyRequest method. req, resp := client.ListTrafficPolicyInstancesByPolicyRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ListTrafficPolicyInstancesByPolicy

ListTrafficPolicyInstancesByPolicyWithContext

func (c *Route53) ListTrafficPolicyInstancesByPolicyWithContext(ctx aws.Context, input *ListTrafficPolicyInstancesByPolicyInput, opts ...request.Option) (*ListTrafficPolicyInstancesByPolicyOutput, error)

ListTrafficPolicyInstancesByPolicyWithContext is the same as ListTrafficPolicyInstancesByPolicy with the addition of the ability to pass a context and additional request options.

See ListTrafficPolicyInstancesByPolicy for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

ListTrafficPolicyInstancesRequest

func (c *Route53) ListTrafficPolicyInstancesRequest(input *ListTrafficPolicyInstancesInput) (req *request.Request, output *ListTrafficPolicyInstancesOutput)

ListTrafficPolicyInstancesRequest generates a "aws/request.Request" representing the client's request for the ListTrafficPolicyInstances operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See ListTrafficPolicyInstances for more information on using the ListTrafficPolicyInstances API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the ListTrafficPolicyInstancesRequest method. req, resp := client.ListTrafficPolicyInstancesRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ListTrafficPolicyInstances

ListTrafficPolicyInstancesWithContext

func (c *Route53) ListTrafficPolicyInstancesWithContext(ctx aws.Context, input *ListTrafficPolicyInstancesInput, opts ...request.Option) (*ListTrafficPolicyInstancesOutput, error)

ListTrafficPolicyInstancesWithContext is the same as ListTrafficPolicyInstances with the addition of the ability to pass a context and additional request options.

See ListTrafficPolicyInstances for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

ListTrafficPolicyVersions

func (c *Route53) ListTrafficPolicyVersions(input *ListTrafficPolicyVersionsInput) (*ListTrafficPolicyVersionsOutput, error)

ListTrafficPolicyVersions API operation for Amazon Route 53.

Gets information about all of the versions for a specified traffic policy.

Traffic policy versions are listed in numerical order by VersionNumber.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation ListTrafficPolicyVersions for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidInput "InvalidInput" The input is not valid.

  • ErrCodeNoSuchTrafficPolicy "NoSuchTrafficPolicy" No traffic policy exists with the specified ID.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ListTrafficPolicyVersions

ListTrafficPolicyVersionsRequest

func (c *Route53) ListTrafficPolicyVersionsRequest(input *ListTrafficPolicyVersionsInput) (req *request.Request, output *ListTrafficPolicyVersionsOutput)

ListTrafficPolicyVersionsRequest generates a "aws/request.Request" representing the client's request for the ListTrafficPolicyVersions operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See ListTrafficPolicyVersions for more information on using the ListTrafficPolicyVersions API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the ListTrafficPolicyVersionsRequest method. req, resp := client.ListTrafficPolicyVersionsRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ListTrafficPolicyVersions

ListTrafficPolicyVersionsWithContext

func (c *Route53) ListTrafficPolicyVersionsWithContext(ctx aws.Context, input *ListTrafficPolicyVersionsInput, opts ...request.Option) (*ListTrafficPolicyVersionsOutput, error)

ListTrafficPolicyVersionsWithContext is the same as ListTrafficPolicyVersions with the addition of the ability to pass a context and additional request options.

See ListTrafficPolicyVersions for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

ListVPCAssociationAuthorizations

func (c *Route53) ListVPCAssociationAuthorizations(input *ListVPCAssociationAuthorizationsInput) (*ListVPCAssociationAuthorizationsOutput, error)

ListVPCAssociationAuthorizations API operation for Amazon Route 53.

Gets a list of the VPCs that were created by other accounts and that can be associated with a specified hosted zone because you've submitted one or more CreateVPCAssociationAuthorization requests.

The response includes a VPCs element with a VPC child element for each VPC that can be associated with the hosted zone.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation ListVPCAssociationAuthorizations for usage and error information.

Returned Error Codes:

  • ErrCodeNoSuchHostedZone "NoSuchHostedZone" No hosted zone exists with the ID that you specified.

  • ErrCodeInvalidInput "InvalidInput" The input is not valid.

  • ErrCodeInvalidPaginationToken "InvalidPaginationToken" The value that you specified to get the second or subsequent page of results is invalid.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ListVPCAssociationAuthorizations

ListVPCAssociationAuthorizationsRequest

func (c *Route53) ListVPCAssociationAuthorizationsRequest(input *ListVPCAssociationAuthorizationsInput) (req *request.Request, output *ListVPCAssociationAuthorizationsOutput)

ListVPCAssociationAuthorizationsRequest generates a "aws/request.Request" representing the client's request for the ListVPCAssociationAuthorizations operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See ListVPCAssociationAuthorizations for more information on using the ListVPCAssociationAuthorizations API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the ListVPCAssociationAuthorizationsRequest method. req, resp := client.ListVPCAssociationAuthorizationsRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ListVPCAssociationAuthorizations

ListVPCAssociationAuthorizationsWithContext

func (c *Route53) ListVPCAssociationAuthorizationsWithContext(ctx aws.Context, input *ListVPCAssociationAuthorizationsInput, opts ...request.Option) (*ListVPCAssociationAuthorizationsOutput, error)

ListVPCAssociationAuthorizationsWithContext is the same as ListVPCAssociationAuthorizations with the addition of the ability to pass a context and additional request options.

See ListVPCAssociationAuthorizations for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

TestDNSAnswer

func (c *Route53) TestDNSAnswer(input *TestDNSAnswerInput) (*TestDNSAnswerOutput, error)

TestDNSAnswer API operation for Amazon Route 53.

Gets the value that Amazon Route 53 returns in response to a DNS request for a specified record name and type. You can optionally specify the IP address of a DNS resolver, an EDNS0 client subnet IP address, and a subnet mask.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation TestDNSAnswer for usage and error information.

Returned Error Codes:

  • ErrCodeNoSuchHostedZone "NoSuchHostedZone" No hosted zone exists with the ID that you specified.

  • ErrCodeInvalidInput "InvalidInput" The input is not valid.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/TestDNSAnswer

TestDNSAnswerRequest

func (c *Route53) TestDNSAnswerRequest(input *TestDNSAnswerInput) (req *request.Request, output *TestDNSAnswerOutput)

TestDNSAnswerRequest generates a "aws/request.Request" representing the client's request for the TestDNSAnswer operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See TestDNSAnswer for more information on using the TestDNSAnswer API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the TestDNSAnswerRequest method. req, resp := client.TestDNSAnswerRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/TestDNSAnswer

TestDNSAnswerWithContext

func (c *Route53) TestDNSAnswerWithContext(ctx aws.Context, input *TestDNSAnswerInput, opts ...request.Option) (*TestDNSAnswerOutput, error)

TestDNSAnswerWithContext is the same as TestDNSAnswer with the addition of the ability to pass a context and additional request options.

See TestDNSAnswer for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

UpdateHealthCheck

func (c *Route53) UpdateHealthCheck(input *UpdateHealthCheckInput) (*UpdateHealthCheckOutput, error)

UpdateHealthCheck API operation for Amazon Route 53.

Updates an existing health check. Note that some values can't be updated.

For more information about updating health checks, see Creating, Updating, and Deleting Health Checks (https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/health-checks-creating-deleting.html) in the Amazon Route 53 Developer Guide.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation UpdateHealthCheck for usage and error information.

Returned Error Codes:

  • ErrCodeNoSuchHealthCheck "NoSuchHealthCheck" No health check exists with the specified ID.

  • ErrCodeInvalidInput "InvalidInput" The input is not valid.

  • ErrCodeHealthCheckVersionMismatch "HealthCheckVersionMismatch" The value of HealthCheckVersion in the request doesn't match the value of HealthCheckVersion in the health check.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/UpdateHealthCheck

UpdateHealthCheckRequest

func (c *Route53) UpdateHealthCheckRequest(input *UpdateHealthCheckInput) (req *request.Request, output *UpdateHealthCheckOutput)

UpdateHealthCheckRequest generates a "aws/request.Request" representing the client's request for the UpdateHealthCheck operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See UpdateHealthCheck for more information on using the UpdateHealthCheck API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the UpdateHealthCheckRequest method. req, resp := client.UpdateHealthCheckRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/UpdateHealthCheck

UpdateHealthCheckWithContext

func (c *Route53) UpdateHealthCheckWithContext(ctx aws.Context, input *UpdateHealthCheckInput, opts ...request.Option) (*UpdateHealthCheckOutput, error)

UpdateHealthCheckWithContext is the same as UpdateHealthCheck with the addition of the ability to pass a context and additional request options.

See UpdateHealthCheck for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

UpdateHostedZoneComment

func (c *Route53) UpdateHostedZoneComment(input *UpdateHostedZoneCommentInput) (*UpdateHostedZoneCommentOutput, error)

UpdateHostedZoneComment API operation for Amazon Route 53.

Updates the comment for a specified hosted zone.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation UpdateHostedZoneComment for usage and error information.

Returned Error Codes:

  • ErrCodeNoSuchHostedZone "NoSuchHostedZone" No hosted zone exists with the ID that you specified.

  • ErrCodeInvalidInput "InvalidInput" The input is not valid.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/UpdateHostedZoneComment

UpdateHostedZoneCommentRequest

func (c *Route53) UpdateHostedZoneCommentRequest(input *UpdateHostedZoneCommentInput) (req *request.Request, output *UpdateHostedZoneCommentOutput)

UpdateHostedZoneCommentRequest generates a "aws/request.Request" representing the client's request for the UpdateHostedZoneComment operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See UpdateHostedZoneComment for more information on using the UpdateHostedZoneComment API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the UpdateHostedZoneCommentRequest method. req, resp := client.UpdateHostedZoneCommentRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/UpdateHostedZoneComment

UpdateHostedZoneCommentWithContext

func (c *Route53) UpdateHostedZoneCommentWithContext(ctx aws.Context, input *UpdateHostedZoneCommentInput, opts ...request.Option) (*UpdateHostedZoneCommentOutput, error)

UpdateHostedZoneCommentWithContext is the same as UpdateHostedZoneComment with the addition of the ability to pass a context and additional request options.

See UpdateHostedZoneComment for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

UpdateTrafficPolicyComment

func (c *Route53) UpdateTrafficPolicyComment(input *UpdateTrafficPolicyCommentInput) (*UpdateTrafficPolicyCommentOutput, error)

UpdateTrafficPolicyComment API operation for Amazon Route 53.

Updates the comment for a specified traffic policy version.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation UpdateTrafficPolicyComment for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidInput "InvalidInput" The input is not valid.

  • ErrCodeNoSuchTrafficPolicy "NoSuchTrafficPolicy" No traffic policy exists with the specified ID.

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

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/UpdateTrafficPolicyComment

UpdateTrafficPolicyCommentRequest

func (c *Route53) UpdateTrafficPolicyCommentRequest(input *UpdateTrafficPolicyCommentInput) (req *request.Request, output *UpdateTrafficPolicyCommentOutput)

UpdateTrafficPolicyCommentRequest generates a "aws/request.Request" representing the client's request for the UpdateTrafficPolicyComment operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See UpdateTrafficPolicyComment for more information on using the UpdateTrafficPolicyComment API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the UpdateTrafficPolicyCommentRequest method. req, resp := client.UpdateTrafficPolicyCommentRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/UpdateTrafficPolicyComment

UpdateTrafficPolicyCommentWithContext

func (c *Route53) UpdateTrafficPolicyCommentWithContext(ctx aws.Context, input *UpdateTrafficPolicyCommentInput, opts ...request.Option) (*UpdateTrafficPolicyCommentOutput, error)

UpdateTrafficPolicyCommentWithContext is the same as UpdateTrafficPolicyComment with the addition of the ability to pass a context and additional request options.

See UpdateTrafficPolicyComment for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

UpdateTrafficPolicyInstance

func (c *Route53) UpdateTrafficPolicyInstance(input *UpdateTrafficPolicyInstanceInput) (*UpdateTrafficPolicyInstanceOutput, error)

UpdateTrafficPolicyInstance API operation for Amazon Route 53.

Updates the resource record sets in a specified hosted zone that were created based on the settings in a specified traffic policy version.

When you update a traffic policy instance, Amazon Route 53 continues to respond to DNS queries for the root resource record set name (such as example.com) while it replaces one group of resource record sets with another. Route 53 performs the following operations:

Route 53 creates a new group of resource record sets based on the specified traffic policy. This is true regardless of how significant the differences are between the existing resource record sets and the new resource record sets.

When all of the new resource record sets have been created, Route 53 starts to respond to DNS queries for the root resource record set name (such as example.com) by using the new resource record sets.

Route 53 deletes the old group of resource record sets that are associated with the root resource record set name.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Route 53's API operation UpdateTrafficPolicyInstance for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidInput "InvalidInput" The input is not valid.

  • ErrCodeNoSuchTrafficPolicy "NoSuchTrafficPolicy" No traffic policy exists with the specified ID.

  • ErrCodeNoSuchTrafficPolicyInstance "NoSuchTrafficPolicyInstance" No traffic policy instance exists with the specified ID.

  • ErrCodePriorRequestNotComplete "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.

  • ErrCodeConflictingTypes "ConflictingTypes" You tried to update a traffic policy instance by using a traffic policy version that has a different DNS type than the current type for the instance. You specified the type in the JSON document in the CreateTrafficPolicy or CreateTrafficPolicyVersionrequest.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/UpdateTrafficPolicyInstance

UpdateTrafficPolicyInstanceRequest

func (c *Route53) UpdateTrafficPolicyInstanceRequest(input *UpdateTrafficPolicyInstanceInput) (req *request.Request, output *UpdateTrafficPolicyInstanceOutput)

UpdateTrafficPolicyInstanceRequest generates a "aws/request.Request" representing the client's request for the UpdateTrafficPolicyInstance operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See UpdateTrafficPolicyInstance for more information on using the UpdateTrafficPolicyInstance API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the UpdateTrafficPolicyInstanceRequest method. req, resp := client.UpdateTrafficPolicyInstanceRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/UpdateTrafficPolicyInstance

UpdateTrafficPolicyInstanceWithContext

func (c *Route53) UpdateTrafficPolicyInstanceWithContext(ctx aws.Context, input *UpdateTrafficPolicyInstanceInput, opts ...request.Option) (*UpdateTrafficPolicyInstanceOutput, error)

UpdateTrafficPolicyInstanceWithContext is the same as UpdateTrafficPolicyInstance with the addition of the ability to pass a context and additional request options.

See UpdateTrafficPolicyInstance for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

WaitUntilResourceRecordSetsChanged

func (c *Route53) WaitUntilResourceRecordSetsChanged(input *GetChangeInput) error

WaitUntilResourceRecordSetsChanged uses the Route 53 API operation GetChange to wait for a condition to be met before returning. If the condition is not met within the max attempt window, an error will be returned.

WaitUntilResourceRecordSetsChangedWithContext

func (c *Route53) WaitUntilResourceRecordSetsChangedWithContext(ctx aws.Context, input *GetChangeInput, opts ...request.WaiterOption) error

WaitUntilResourceRecordSetsChangedWithContext is an extended version of WaitUntilResourceRecordSetsChanged. With the support for passing in a context and options to configure the Waiter and the underlying request options.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

On this page: