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.

Route53Domains

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

type Route53Domains struct { *client.Client }

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

Route53Domains 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

CheckDomainAvailability

func (c *Route53Domains) CheckDomainAvailability(input *CheckDomainAvailabilityInput) (*CheckDomainAvailabilityOutput, error)

CheckDomainAvailability API operation for Amazon Route 53 Domains.

This operation checks the availability of one domain name. Note that if the availability status of a domain is pending, you must submit another request to determine the availability of the domain 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 Domains's API operation CheckDomainAvailability for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidInput "InvalidInput" The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.

  • ErrCodeUnsupportedTLD "UnsupportedTLD" Amazon Route 53 does not support this top-level domain (TLD).

See also, https://docs.aws.amazon.com/goto/WebAPI/route53domains-2014-05-15/CheckDomainAvailability

CheckDomainAvailabilityRequest

func (c *Route53Domains) CheckDomainAvailabilityRequest(input *CheckDomainAvailabilityInput) (req *request.Request, output *CheckDomainAvailabilityOutput)

CheckDomainAvailabilityRequest generates a "aws/request.Request" representing the client's request for the CheckDomainAvailability 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 CheckDomainAvailability for more information on using the CheckDomainAvailability 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 CheckDomainAvailabilityRequest method. req, resp := client.CheckDomainAvailabilityRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53domains-2014-05-15/CheckDomainAvailability

CheckDomainAvailabilityWithContext

func (c *Route53Domains) CheckDomainAvailabilityWithContext(ctx aws.Context, input *CheckDomainAvailabilityInput, opts ...request.Option) (*CheckDomainAvailabilityOutput, error)

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

See CheckDomainAvailability 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.

CheckDomainTransferability

func (c *Route53Domains) CheckDomainTransferability(input *CheckDomainTransferabilityInput) (*CheckDomainTransferabilityOutput, error)

CheckDomainTransferability API operation for Amazon Route 53 Domains.

Checks whether a domain name can be transferred to Amazon Route 53.

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 Domains's API operation CheckDomainTransferability for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidInput "InvalidInput" The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.

  • ErrCodeUnsupportedTLD "UnsupportedTLD" Amazon Route 53 does not support this top-level domain (TLD).

See also, https://docs.aws.amazon.com/goto/WebAPI/route53domains-2014-05-15/CheckDomainTransferability

CheckDomainTransferabilityRequest

func (c *Route53Domains) CheckDomainTransferabilityRequest(input *CheckDomainTransferabilityInput) (req *request.Request, output *CheckDomainTransferabilityOutput)

CheckDomainTransferabilityRequest generates a "aws/request.Request" representing the client's request for the CheckDomainTransferability 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 CheckDomainTransferability for more information on using the CheckDomainTransferability 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 CheckDomainTransferabilityRequest method. req, resp := client.CheckDomainTransferabilityRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53domains-2014-05-15/CheckDomainTransferability

CheckDomainTransferabilityWithContext

func (c *Route53Domains) CheckDomainTransferabilityWithContext(ctx aws.Context, input *CheckDomainTransferabilityInput, opts ...request.Option) (*CheckDomainTransferabilityOutput, error)

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

See CheckDomainTransferability 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.

DeleteTagsForDomain

func (c *Route53Domains) DeleteTagsForDomain(input *DeleteTagsForDomainInput) (*DeleteTagsForDomainOutput, error)

DeleteTagsForDomain API operation for Amazon Route 53 Domains.

This operation deletes the specified tags for a domain.

All tag operations are eventually consistent; subsequent operations might not immediately represent all issued operations.

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 Domains's API operation DeleteTagsForDomain for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidInput "InvalidInput" The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.

  • ErrCodeOperationLimitExceeded "OperationLimitExceeded" The number of operations or jobs running exceeded the allowed threshold for the account.

  • ErrCodeUnsupportedTLD "UnsupportedTLD" Amazon Route 53 does not support this top-level domain (TLD).

See also, https://docs.aws.amazon.com/goto/WebAPI/route53domains-2014-05-15/DeleteTagsForDomain

DeleteTagsForDomainRequest

func (c *Route53Domains) DeleteTagsForDomainRequest(input *DeleteTagsForDomainInput) (req *request.Request, output *DeleteTagsForDomainOutput)

DeleteTagsForDomainRequest generates a "aws/request.Request" representing the client's request for the DeleteTagsForDomain 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 DeleteTagsForDomain for more information on using the DeleteTagsForDomain 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 DeleteTagsForDomainRequest method. req, resp := client.DeleteTagsForDomainRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53domains-2014-05-15/DeleteTagsForDomain

DeleteTagsForDomainWithContext

func (c *Route53Domains) DeleteTagsForDomainWithContext(ctx aws.Context, input *DeleteTagsForDomainInput, opts ...request.Option) (*DeleteTagsForDomainOutput, error)

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

See DeleteTagsForDomain 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.

DisableDomainAutoRenew

func (c *Route53Domains) DisableDomainAutoRenew(input *DisableDomainAutoRenewInput) (*DisableDomainAutoRenewOutput, error)

DisableDomainAutoRenew API operation for Amazon Route 53 Domains.

This operation disables automatic renewal of domain registration for the specified domain.

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 Domains's API operation DisableDomainAutoRenew for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidInput "InvalidInput" The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.

  • ErrCodeUnsupportedTLD "UnsupportedTLD" Amazon Route 53 does not support this top-level domain (TLD).

See also, https://docs.aws.amazon.com/goto/WebAPI/route53domains-2014-05-15/DisableDomainAutoRenew

DisableDomainAutoRenewRequest

func (c *Route53Domains) DisableDomainAutoRenewRequest(input *DisableDomainAutoRenewInput) (req *request.Request, output *DisableDomainAutoRenewOutput)

DisableDomainAutoRenewRequest generates a "aws/request.Request" representing the client's request for the DisableDomainAutoRenew 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 DisableDomainAutoRenew for more information on using the DisableDomainAutoRenew 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 DisableDomainAutoRenewRequest method. req, resp := client.DisableDomainAutoRenewRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53domains-2014-05-15/DisableDomainAutoRenew

DisableDomainAutoRenewWithContext

func (c *Route53Domains) DisableDomainAutoRenewWithContext(ctx aws.Context, input *DisableDomainAutoRenewInput, opts ...request.Option) (*DisableDomainAutoRenewOutput, error)

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

See DisableDomainAutoRenew 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.

DisableDomainTransferLock

func (c *Route53Domains) DisableDomainTransferLock(input *DisableDomainTransferLockInput) (*DisableDomainTransferLockOutput, error)

DisableDomainTransferLock API operation for Amazon Route 53 Domains.

This operation removes the transfer lock on the domain (specifically the clientTransferProhibited status) to allow domain transfers. We recommend you refrain from performing this action unless you intend to transfer the domain to a different registrar. Successful submission returns an operation ID that you can use to track the progress and completion of the action. If the request is not completed successfully, the domain registrant will be notified by email.

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 Domains's API operation DisableDomainTransferLock for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidInput "InvalidInput" The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.

  • ErrCodeDuplicateRequest "DuplicateRequest" The request is already in progress for the domain.

  • ErrCodeTLDRulesViolation "TLDRulesViolation" The top-level domain does not support this operation.

  • ErrCodeOperationLimitExceeded "OperationLimitExceeded" The number of operations or jobs running exceeded the allowed threshold for the account.

  • ErrCodeUnsupportedTLD "UnsupportedTLD" Amazon Route 53 does not support this top-level domain (TLD).

See also, https://docs.aws.amazon.com/goto/WebAPI/route53domains-2014-05-15/DisableDomainTransferLock

DisableDomainTransferLockRequest

func (c *Route53Domains) DisableDomainTransferLockRequest(input *DisableDomainTransferLockInput) (req *request.Request, output *DisableDomainTransferLockOutput)

DisableDomainTransferLockRequest generates a "aws/request.Request" representing the client's request for the DisableDomainTransferLock 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 DisableDomainTransferLock for more information on using the DisableDomainTransferLock 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 DisableDomainTransferLockRequest method. req, resp := client.DisableDomainTransferLockRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53domains-2014-05-15/DisableDomainTransferLock

DisableDomainTransferLockWithContext

func (c *Route53Domains) DisableDomainTransferLockWithContext(ctx aws.Context, input *DisableDomainTransferLockInput, opts ...request.Option) (*DisableDomainTransferLockOutput, error)

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

See DisableDomainTransferLock 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.

EnableDomainAutoRenew

func (c *Route53Domains) EnableDomainAutoRenew(input *EnableDomainAutoRenewInput) (*EnableDomainAutoRenewOutput, error)

EnableDomainAutoRenew API operation for Amazon Route 53 Domains.

This operation configures Amazon Route 53 to automatically renew the specified domain before the domain registration expires. The cost of renewing your domain registration is billed to your AWS account.

The period during which you can renew a domain name varies by TLD. For a list of TLDs and their renewal policies, see "Renewal, restoration, and deletion times" (http://wiki.gandi.net/en/domains/renew#renewal_restoration_and_deletion_times) on the website for our registrar associate, Gandi. Amazon Route 53 requires that you renew before the end of the renewal period that is listed on the Gandi website so we can complete processing before the deadline.

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 Domains's API operation EnableDomainAutoRenew for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidInput "InvalidInput" The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.

  • ErrCodeUnsupportedTLD "UnsupportedTLD" Amazon Route 53 does not support this top-level domain (TLD).

  • ErrCodeTLDRulesViolation "TLDRulesViolation" The top-level domain does not support this operation.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53domains-2014-05-15/EnableDomainAutoRenew

EnableDomainAutoRenewRequest

func (c *Route53Domains) EnableDomainAutoRenewRequest(input *EnableDomainAutoRenewInput) (req *request.Request, output *EnableDomainAutoRenewOutput)

EnableDomainAutoRenewRequest generates a "aws/request.Request" representing the client's request for the EnableDomainAutoRenew 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 EnableDomainAutoRenew for more information on using the EnableDomainAutoRenew 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 EnableDomainAutoRenewRequest method. req, resp := client.EnableDomainAutoRenewRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53domains-2014-05-15/EnableDomainAutoRenew

EnableDomainAutoRenewWithContext

func (c *Route53Domains) EnableDomainAutoRenewWithContext(ctx aws.Context, input *EnableDomainAutoRenewInput, opts ...request.Option) (*EnableDomainAutoRenewOutput, error)

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

See EnableDomainAutoRenew 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.

EnableDomainTransferLock

func (c *Route53Domains) EnableDomainTransferLock(input *EnableDomainTransferLockInput) (*EnableDomainTransferLockOutput, error)

EnableDomainTransferLock API operation for Amazon Route 53 Domains.

This operation sets the transfer lock on the domain (specifically the clientTransferProhibited status) to prevent domain transfers. Successful submission returns an operation ID that you can use to track the progress and completion of the action. If the request is not completed successfully, the domain registrant will be notified by email.

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 Domains's API operation EnableDomainTransferLock for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidInput "InvalidInput" The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.

  • ErrCodeDuplicateRequest "DuplicateRequest" The request is already in progress for the domain.

  • ErrCodeTLDRulesViolation "TLDRulesViolation" The top-level domain does not support this operation.

  • ErrCodeOperationLimitExceeded "OperationLimitExceeded" The number of operations or jobs running exceeded the allowed threshold for the account.

  • ErrCodeUnsupportedTLD "UnsupportedTLD" Amazon Route 53 does not support this top-level domain (TLD).

See also, https://docs.aws.amazon.com/goto/WebAPI/route53domains-2014-05-15/EnableDomainTransferLock

EnableDomainTransferLockRequest

func (c *Route53Domains) EnableDomainTransferLockRequest(input *EnableDomainTransferLockInput) (req *request.Request, output *EnableDomainTransferLockOutput)

EnableDomainTransferLockRequest generates a "aws/request.Request" representing the client's request for the EnableDomainTransferLock 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 EnableDomainTransferLock for more information on using the EnableDomainTransferLock 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 EnableDomainTransferLockRequest method. req, resp := client.EnableDomainTransferLockRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53domains-2014-05-15/EnableDomainTransferLock

EnableDomainTransferLockWithContext

func (c *Route53Domains) EnableDomainTransferLockWithContext(ctx aws.Context, input *EnableDomainTransferLockInput, opts ...request.Option) (*EnableDomainTransferLockOutput, error)

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

See EnableDomainTransferLock 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.

GetContactReachabilityStatus

func (c *Route53Domains) GetContactReachabilityStatus(input *GetContactReachabilityStatusInput) (*GetContactReachabilityStatusOutput, error)

GetContactReachabilityStatus API operation for Amazon Route 53 Domains.

For operations that require confirmation that the email address for the registrant contact is valid, such as registering a new domain, this operation returns information about whether the registrant contact has responded.

If you want us to resend the email, use the ResendContactReachabilityEmail operation.

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 Domains's API operation GetContactReachabilityStatus for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidInput "InvalidInput" The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.

  • ErrCodeOperationLimitExceeded "OperationLimitExceeded" The number of operations or jobs running exceeded the allowed threshold for the account.

  • ErrCodeUnsupportedTLD "UnsupportedTLD" Amazon Route 53 does not support this top-level domain (TLD).

See also, https://docs.aws.amazon.com/goto/WebAPI/route53domains-2014-05-15/GetContactReachabilityStatus

GetContactReachabilityStatusRequest

func (c *Route53Domains) GetContactReachabilityStatusRequest(input *GetContactReachabilityStatusInput) (req *request.Request, output *GetContactReachabilityStatusOutput)

GetContactReachabilityStatusRequest generates a "aws/request.Request" representing the client's request for the GetContactReachabilityStatus 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 GetContactReachabilityStatus for more information on using the GetContactReachabilityStatus 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 GetContactReachabilityStatusRequest method. req, resp := client.GetContactReachabilityStatusRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53domains-2014-05-15/GetContactReachabilityStatus

GetContactReachabilityStatusWithContext

func (c *Route53Domains) GetContactReachabilityStatusWithContext(ctx aws.Context, input *GetContactReachabilityStatusInput, opts ...request.Option) (*GetContactReachabilityStatusOutput, error)

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

See GetContactReachabilityStatus 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.

GetDomainDetail

func (c *Route53Domains) GetDomainDetail(input *GetDomainDetailInput) (*GetDomainDetailOutput, error)

GetDomainDetail API operation for Amazon Route 53 Domains.

This operation returns detailed information about a specified domain that is associated with the current AWS account. Contact information for the domain is also returned as part of the output.

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 Domains's API operation GetDomainDetail for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidInput "InvalidInput" The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.

  • ErrCodeUnsupportedTLD "UnsupportedTLD" Amazon Route 53 does not support this top-level domain (TLD).

See also, https://docs.aws.amazon.com/goto/WebAPI/route53domains-2014-05-15/GetDomainDetail

GetDomainDetailRequest

func (c *Route53Domains) GetDomainDetailRequest(input *GetDomainDetailInput) (req *request.Request, output *GetDomainDetailOutput)

GetDomainDetailRequest generates a "aws/request.Request" representing the client's request for the GetDomainDetail 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 GetDomainDetail for more information on using the GetDomainDetail 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 GetDomainDetailRequest method. req, resp := client.GetDomainDetailRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53domains-2014-05-15/GetDomainDetail

GetDomainDetailWithContext

func (c *Route53Domains) GetDomainDetailWithContext(ctx aws.Context, input *GetDomainDetailInput, opts ...request.Option) (*GetDomainDetailOutput, error)

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

See GetDomainDetail 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.

GetDomainSuggestions

func (c *Route53Domains) GetDomainSuggestions(input *GetDomainSuggestionsInput) (*GetDomainSuggestionsOutput, error)

GetDomainSuggestions API operation for Amazon Route 53 Domains.

The GetDomainSuggestions operation returns a list of suggested domain names given a string, which can either be a domain name or simply a word or phrase (without spaces).

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 Domains's API operation GetDomainSuggestions for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidInput "InvalidInput" The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.

  • ErrCodeUnsupportedTLD "UnsupportedTLD" Amazon Route 53 does not support this top-level domain (TLD).

See also, https://docs.aws.amazon.com/goto/WebAPI/route53domains-2014-05-15/GetDomainSuggestions

GetDomainSuggestionsRequest

func (c *Route53Domains) GetDomainSuggestionsRequest(input *GetDomainSuggestionsInput) (req *request.Request, output *GetDomainSuggestionsOutput)

GetDomainSuggestionsRequest generates a "aws/request.Request" representing the client's request for the GetDomainSuggestions 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 GetDomainSuggestions for more information on using the GetDomainSuggestions 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 GetDomainSuggestionsRequest method. req, resp := client.GetDomainSuggestionsRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53domains-2014-05-15/GetDomainSuggestions

GetDomainSuggestionsWithContext

func (c *Route53Domains) GetDomainSuggestionsWithContext(ctx aws.Context, input *GetDomainSuggestionsInput, opts ...request.Option) (*GetDomainSuggestionsOutput, error)

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

See GetDomainSuggestions 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.

GetOperationDetail

func (c *Route53Domains) GetOperationDetail(input *GetOperationDetailInput) (*GetOperationDetailOutput, error)

GetOperationDetail API operation for Amazon Route 53 Domains.

This operation returns the current status of an operation that is not completed.

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 Domains's API operation GetOperationDetail for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidInput "InvalidInput" The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53domains-2014-05-15/GetOperationDetail

GetOperationDetailRequest

func (c *Route53Domains) GetOperationDetailRequest(input *GetOperationDetailInput) (req *request.Request, output *GetOperationDetailOutput)

GetOperationDetailRequest generates a "aws/request.Request" representing the client's request for the GetOperationDetail 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 GetOperationDetail for more information on using the GetOperationDetail 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 GetOperationDetailRequest method. req, resp := client.GetOperationDetailRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53domains-2014-05-15/GetOperationDetail

GetOperationDetailWithContext

func (c *Route53Domains) GetOperationDetailWithContext(ctx aws.Context, input *GetOperationDetailInput, opts ...request.Option) (*GetOperationDetailOutput, error)

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

See GetOperationDetail 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.

ListDomains

func (c *Route53Domains) ListDomains(input *ListDomainsInput) (*ListDomainsOutput, error)

ListDomains API operation for Amazon Route 53 Domains.

This operation returns all the domain names registered with Amazon Route 53 for 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 Domains's API operation ListDomains for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidInput "InvalidInput" The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53domains-2014-05-15/ListDomains

ListDomainsPages

func (c *Route53Domains) ListDomainsPages(input *ListDomainsInput, fn func(*ListDomainsOutput, bool) bool) error

ListDomainsPages iterates over the pages of a ListDomains operation, calling the "fn" function with the response data for each page. To stop iterating, return false from the fn function.

See ListDomains 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 ListDomains operation. pageNum := 0 err := client.ListDomainsPages(params, func(page *ListDomainsOutput, lastPage bool) bool { pageNum++ fmt.Println(page) return pageNum <= 3 })

See Also

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

ListDomainsPagesWithContext

func (c *Route53Domains) ListDomainsPagesWithContext(ctx aws.Context, input *ListDomainsInput, fn func(*ListDomainsOutput, bool) bool, opts ...request.Option) error

ListDomainsPagesWithContext same as ListDomainsPages 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.

ListDomainsRequest

func (c *Route53Domains) ListDomainsRequest(input *ListDomainsInput) (req *request.Request, output *ListDomainsOutput)

ListDomainsRequest generates a "aws/request.Request" representing the client's request for the ListDomains 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 ListDomains for more information on using the ListDomains 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 ListDomainsRequest method. req, resp := client.ListDomainsRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53domains-2014-05-15/ListDomains

ListDomainsWithContext

func (c *Route53Domains) ListDomainsWithContext(ctx aws.Context, input *ListDomainsInput, opts ...request.Option) (*ListDomainsOutput, error)

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

See ListDomains 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.

ListOperations

func (c *Route53Domains) ListOperations(input *ListOperationsInput) (*ListOperationsOutput, error)

ListOperations API operation for Amazon Route 53 Domains.

This operation returns the operation IDs of operations that are not yet complete.

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 Domains's API operation ListOperations for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidInput "InvalidInput" The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53domains-2014-05-15/ListOperations

ListOperationsPages

func (c *Route53Domains) ListOperationsPages(input *ListOperationsInput, fn func(*ListOperationsOutput, bool) bool) error

ListOperationsPages iterates over the pages of a ListOperations operation, calling the "fn" function with the response data for each page. To stop iterating, return false from the fn function.

See ListOperations 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 ListOperations operation. pageNum := 0 err := client.ListOperationsPages(params, func(page *ListOperationsOutput, lastPage bool) bool { pageNum++ fmt.Println(page) return pageNum <= 3 })

See Also

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

ListOperationsPagesWithContext

func (c *Route53Domains) ListOperationsPagesWithContext(ctx aws.Context, input *ListOperationsInput, fn func(*ListOperationsOutput, bool) bool, opts ...request.Option) error

ListOperationsPagesWithContext same as ListOperationsPages 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.

ListOperationsRequest

func (c *Route53Domains) ListOperationsRequest(input *ListOperationsInput) (req *request.Request, output *ListOperationsOutput)

ListOperationsRequest generates a "aws/request.Request" representing the client's request for the ListOperations 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 ListOperations for more information on using the ListOperations 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 ListOperationsRequest method. req, resp := client.ListOperationsRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53domains-2014-05-15/ListOperations

ListOperationsWithContext

func (c *Route53Domains) ListOperationsWithContext(ctx aws.Context, input *ListOperationsInput, opts ...request.Option) (*ListOperationsOutput, error)

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

See ListOperations 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.

ListTagsForDomain

func (c *Route53Domains) ListTagsForDomain(input *ListTagsForDomainInput) (*ListTagsForDomainOutput, error)

ListTagsForDomain API operation for Amazon Route 53 Domains.

This operation returns all of the tags that are associated with the specified domain.

All tag operations are eventually consistent; subsequent operations might not immediately represent all issued operations.

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 Domains's API operation ListTagsForDomain for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidInput "InvalidInput" The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.

  • ErrCodeOperationLimitExceeded "OperationLimitExceeded" The number of operations or jobs running exceeded the allowed threshold for the account.

  • ErrCodeUnsupportedTLD "UnsupportedTLD" Amazon Route 53 does not support this top-level domain (TLD).

See also, https://docs.aws.amazon.com/goto/WebAPI/route53domains-2014-05-15/ListTagsForDomain

ListTagsForDomainRequest

func (c *Route53Domains) ListTagsForDomainRequest(input *ListTagsForDomainInput) (req *request.Request, output *ListTagsForDomainOutput)

ListTagsForDomainRequest generates a "aws/request.Request" representing the client's request for the ListTagsForDomain 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 ListTagsForDomain for more information on using the ListTagsForDomain 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 ListTagsForDomainRequest method. req, resp := client.ListTagsForDomainRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53domains-2014-05-15/ListTagsForDomain

ListTagsForDomainWithContext

func (c *Route53Domains) ListTagsForDomainWithContext(ctx aws.Context, input *ListTagsForDomainInput, opts ...request.Option) (*ListTagsForDomainOutput, error)

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

See ListTagsForDomain 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.

RegisterDomain

func (c *Route53Domains) RegisterDomain(input *RegisterDomainInput) (*RegisterDomainOutput, error)

RegisterDomain API operation for Amazon Route 53 Domains.

This operation registers a domain. Domains are registered either by Amazon Registrar (for .com, .net, and .org domains) or by our registrar associate, Gandi (for all other domains). For some top-level domains (TLDs), this operation requires extra parameters.

When you register a domain, Amazon Route 53 does the following:

  • Creates a Amazon Route 53 hosted zone that has the same name as the domain. Amazon Route 53 assigns four name servers to your hosted zone and automatically updates your domain registration with the names of these name servers.

  • Enables autorenew, so your domain registration will renew automatically each year. We'll notify you in advance of the renewal date so you can choose whether to renew the registration.

  • Optionally enables privacy protection, so WHOIS queries return contact information either for Amazon Registrar (for .com, .net, and .org domains) or for our registrar associate, Gandi (for all other TLDs). If you don't enable privacy protection, WHOIS queries return the information that you entered for the registrant, admin, and tech contacts.

  • If registration is successful, returns an operation ID that you can use to track the progress and completion of the action. If the request is not completed successfully, the domain registrant is notified by email.

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 Domains's API operation RegisterDomain for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidInput "InvalidInput" The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.

  • ErrCodeUnsupportedTLD "UnsupportedTLD" Amazon Route 53 does not support this top-level domain (TLD).

  • ErrCodeDuplicateRequest "DuplicateRequest" The request is already in progress for the domain.

  • ErrCodeTLDRulesViolation "TLDRulesViolation" The top-level domain does not support this operation.

  • ErrCodeDomainLimitExceeded "DomainLimitExceeded" The number of domains has exceeded the allowed threshold for the account.

  • ErrCodeOperationLimitExceeded "OperationLimitExceeded" The number of operations or jobs running exceeded the allowed threshold for the account.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53domains-2014-05-15/RegisterDomain

RegisterDomainRequest

func (c *Route53Domains) RegisterDomainRequest(input *RegisterDomainInput) (req *request.Request, output *RegisterDomainOutput)

RegisterDomainRequest generates a "aws/request.Request" representing the client's request for the RegisterDomain 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 RegisterDomain for more information on using the RegisterDomain 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 RegisterDomainRequest method. req, resp := client.RegisterDomainRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53domains-2014-05-15/RegisterDomain

RegisterDomainWithContext

func (c *Route53Domains) RegisterDomainWithContext(ctx aws.Context, input *RegisterDomainInput, opts ...request.Option) (*RegisterDomainOutput, error)

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

See RegisterDomain 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.

RenewDomain

func (c *Route53Domains) RenewDomain(input *RenewDomainInput) (*RenewDomainOutput, error)

RenewDomain API operation for Amazon Route 53 Domains.

This operation renews a domain for the specified number of years. The cost of renewing your domain is billed to your AWS account.

We recommend that you renew your domain several weeks before the expiration date. Some TLD registries delete domains before the expiration date if you haven't renewed far enough in advance. For more information about renewing domain registration, see Renewing Registration for a Domain (https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-renew.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 Domains's API operation RenewDomain for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidInput "InvalidInput" The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.

  • ErrCodeUnsupportedTLD "UnsupportedTLD" Amazon Route 53 does not support this top-level domain (TLD).

  • ErrCodeDuplicateRequest "DuplicateRequest" The request is already in progress for the domain.

  • ErrCodeTLDRulesViolation "TLDRulesViolation" The top-level domain does not support this operation.

  • ErrCodeOperationLimitExceeded "OperationLimitExceeded" The number of operations or jobs running exceeded the allowed threshold for the account.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53domains-2014-05-15/RenewDomain

RenewDomainRequest

func (c *Route53Domains) RenewDomainRequest(input *RenewDomainInput) (req *request.Request, output *RenewDomainOutput)

RenewDomainRequest generates a "aws/request.Request" representing the client's request for the RenewDomain 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 RenewDomain for more information on using the RenewDomain 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 RenewDomainRequest method. req, resp := client.RenewDomainRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53domains-2014-05-15/RenewDomain

RenewDomainWithContext

func (c *Route53Domains) RenewDomainWithContext(ctx aws.Context, input *RenewDomainInput, opts ...request.Option) (*RenewDomainOutput, error)

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

See RenewDomain 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.

ResendContactReachabilityEmail

func (c *Route53Domains) ResendContactReachabilityEmail(input *ResendContactReachabilityEmailInput) (*ResendContactReachabilityEmailOutput, error)

ResendContactReachabilityEmail API operation for Amazon Route 53 Domains.

For operations that require confirmation that the email address for the registrant contact is valid, such as registering a new domain, this operation resends the confirmation email to the current email address for the registrant contact.

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 Domains's API operation ResendContactReachabilityEmail for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidInput "InvalidInput" The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.

  • ErrCodeOperationLimitExceeded "OperationLimitExceeded" The number of operations or jobs running exceeded the allowed threshold for the account.

  • ErrCodeUnsupportedTLD "UnsupportedTLD" Amazon Route 53 does not support this top-level domain (TLD).

See also, https://docs.aws.amazon.com/goto/WebAPI/route53domains-2014-05-15/ResendContactReachabilityEmail

ResendContactReachabilityEmailRequest

func (c *Route53Domains) ResendContactReachabilityEmailRequest(input *ResendContactReachabilityEmailInput) (req *request.Request, output *ResendContactReachabilityEmailOutput)

ResendContactReachabilityEmailRequest generates a "aws/request.Request" representing the client's request for the ResendContactReachabilityEmail 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 ResendContactReachabilityEmail for more information on using the ResendContactReachabilityEmail 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 ResendContactReachabilityEmailRequest method. req, resp := client.ResendContactReachabilityEmailRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53domains-2014-05-15/ResendContactReachabilityEmail

ResendContactReachabilityEmailWithContext

func (c *Route53Domains) ResendContactReachabilityEmailWithContext(ctx aws.Context, input *ResendContactReachabilityEmailInput, opts ...request.Option) (*ResendContactReachabilityEmailOutput, error)

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

See ResendContactReachabilityEmail 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.

RetrieveDomainAuthCode

func (c *Route53Domains) RetrieveDomainAuthCode(input *RetrieveDomainAuthCodeInput) (*RetrieveDomainAuthCodeOutput, error)

RetrieveDomainAuthCode API operation for Amazon Route 53 Domains.

This operation returns the AuthCode for the domain. To transfer a domain to another registrar, you provide this value to the new registrar.

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 Domains's API operation RetrieveDomainAuthCode for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidInput "InvalidInput" The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.

  • ErrCodeUnsupportedTLD "UnsupportedTLD" Amazon Route 53 does not support this top-level domain (TLD).

See also, https://docs.aws.amazon.com/goto/WebAPI/route53domains-2014-05-15/RetrieveDomainAuthCode

RetrieveDomainAuthCodeRequest

func (c *Route53Domains) RetrieveDomainAuthCodeRequest(input *RetrieveDomainAuthCodeInput) (req *request.Request, output *RetrieveDomainAuthCodeOutput)

RetrieveDomainAuthCodeRequest generates a "aws/request.Request" representing the client's request for the RetrieveDomainAuthCode 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 RetrieveDomainAuthCode for more information on using the RetrieveDomainAuthCode 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 RetrieveDomainAuthCodeRequest method. req, resp := client.RetrieveDomainAuthCodeRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53domains-2014-05-15/RetrieveDomainAuthCode

RetrieveDomainAuthCodeWithContext

func (c *Route53Domains) RetrieveDomainAuthCodeWithContext(ctx aws.Context, input *RetrieveDomainAuthCodeInput, opts ...request.Option) (*RetrieveDomainAuthCodeOutput, error)

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

See RetrieveDomainAuthCode 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.

TransferDomain

func (c *Route53Domains) TransferDomain(input *TransferDomainInput) (*TransferDomainOutput, error)

TransferDomain API operation for Amazon Route 53 Domains.

This operation transfers a domain from another registrar to Amazon Route 53. When the transfer is complete, the domain is registered either with Amazon Registrar (for .com, .net, and .org domains) or with our registrar associate, Gandi (for all other TLDs).

For transfer requirements, a detailed procedure, and information about viewing the status of a domain transfer, see Transferring Registration for a Domain to Amazon Route 53 (https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-transfer-to-route-53.html) in the Amazon Route 53 Developer Guide.

If the registrar for your domain is also the DNS service provider for the domain, we highly recommend that you consider transferring your DNS service to Amazon Route 53 or to another DNS service provider before you transfer your registration. Some registrars provide free DNS service when you purchase a domain registration. When you transfer the registration, the previous registrar will not renew your domain registration and could end your DNS service at any time.

If the registrar for your domain is also the DNS service provider for the domain and you don't transfer DNS service to another provider, your website, email, and the web applications associated with the domain might become unavailable.

If the transfer is successful, this method returns an operation ID that you can use to track the progress and completion of the action. If the transfer doesn't complete successfully, the domain registrant will be notified by email.

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 Domains's API operation TransferDomain for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidInput "InvalidInput" The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.

  • ErrCodeUnsupportedTLD "UnsupportedTLD" Amazon Route 53 does not support this top-level domain (TLD).

  • ErrCodeDuplicateRequest "DuplicateRequest" The request is already in progress for the domain.

  • ErrCodeTLDRulesViolation "TLDRulesViolation" The top-level domain does not support this operation.

  • ErrCodeDomainLimitExceeded "DomainLimitExceeded" The number of domains has exceeded the allowed threshold for the account.

  • ErrCodeOperationLimitExceeded "OperationLimitExceeded" The number of operations or jobs running exceeded the allowed threshold for the account.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53domains-2014-05-15/TransferDomain

TransferDomainRequest

func (c *Route53Domains) TransferDomainRequest(input *TransferDomainInput) (req *request.Request, output *TransferDomainOutput)

TransferDomainRequest generates a "aws/request.Request" representing the client's request for the TransferDomain 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 TransferDomain for more information on using the TransferDomain 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 TransferDomainRequest method. req, resp := client.TransferDomainRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53domains-2014-05-15/TransferDomain

TransferDomainWithContext

func (c *Route53Domains) TransferDomainWithContext(ctx aws.Context, input *TransferDomainInput, opts ...request.Option) (*TransferDomainOutput, error)

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

See TransferDomain 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.

UpdateDomainContact

func (c *Route53Domains) UpdateDomainContact(input *UpdateDomainContactInput) (*UpdateDomainContactOutput, error)

UpdateDomainContact API operation for Amazon Route 53 Domains.

This operation updates the contact information for a particular domain. You must specify information for at least one contact: registrant, administrator, or technical.

If the update is successful, this method returns an operation ID that you can use to track the progress and completion of the action. If the request is not completed successfully, the domain registrant will be notified by email.

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 Domains's API operation UpdateDomainContact for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidInput "InvalidInput" The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.

  • ErrCodeDuplicateRequest "DuplicateRequest" The request is already in progress for the domain.

  • ErrCodeTLDRulesViolation "TLDRulesViolation" The top-level domain does not support this operation.

  • ErrCodeOperationLimitExceeded "OperationLimitExceeded" The number of operations or jobs running exceeded the allowed threshold for the account.

  • ErrCodeUnsupportedTLD "UnsupportedTLD" Amazon Route 53 does not support this top-level domain (TLD).

See also, https://docs.aws.amazon.com/goto/WebAPI/route53domains-2014-05-15/UpdateDomainContact

UpdateDomainContactPrivacy

func (c *Route53Domains) UpdateDomainContactPrivacy(input *UpdateDomainContactPrivacyInput) (*UpdateDomainContactPrivacyOutput, error)

UpdateDomainContactPrivacy API operation for Amazon Route 53 Domains.

This operation updates the specified domain contact's privacy setting. When privacy protection is enabled, contact information such as email address is replaced either with contact information for Amazon Registrar (for .com, .net, and .org domains) or with contact information for our registrar associate, Gandi.

This operation affects only the contact information for the specified contact type (registrant, administrator, or tech). If the request succeeds, Amazon Route 53 returns an operation ID that you can use with GetOperationDetail to track the progress and completion of the action. If the request doesn't complete successfully, the domain registrant will be notified by email.

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 Domains's API operation UpdateDomainContactPrivacy for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidInput "InvalidInput" The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.

  • ErrCodeDuplicateRequest "DuplicateRequest" The request is already in progress for the domain.

  • ErrCodeTLDRulesViolation "TLDRulesViolation" The top-level domain does not support this operation.

  • ErrCodeOperationLimitExceeded "OperationLimitExceeded" The number of operations or jobs running exceeded the allowed threshold for the account.

  • ErrCodeUnsupportedTLD "UnsupportedTLD" Amazon Route 53 does not support this top-level domain (TLD).

See also, https://docs.aws.amazon.com/goto/WebAPI/route53domains-2014-05-15/UpdateDomainContactPrivacy

UpdateDomainContactPrivacyRequest

func (c *Route53Domains) UpdateDomainContactPrivacyRequest(input *UpdateDomainContactPrivacyInput) (req *request.Request, output *UpdateDomainContactPrivacyOutput)

UpdateDomainContactPrivacyRequest generates a "aws/request.Request" representing the client's request for the UpdateDomainContactPrivacy 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 UpdateDomainContactPrivacy for more information on using the UpdateDomainContactPrivacy 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 UpdateDomainContactPrivacyRequest method. req, resp := client.UpdateDomainContactPrivacyRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53domains-2014-05-15/UpdateDomainContactPrivacy

UpdateDomainContactPrivacyWithContext

func (c *Route53Domains) UpdateDomainContactPrivacyWithContext(ctx aws.Context, input *UpdateDomainContactPrivacyInput, opts ...request.Option) (*UpdateDomainContactPrivacyOutput, error)

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

See UpdateDomainContactPrivacy 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.

UpdateDomainContactRequest

func (c *Route53Domains) UpdateDomainContactRequest(input *UpdateDomainContactInput) (req *request.Request, output *UpdateDomainContactOutput)

UpdateDomainContactRequest generates a "aws/request.Request" representing the client's request for the UpdateDomainContact 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 UpdateDomainContact for more information on using the UpdateDomainContact 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 UpdateDomainContactRequest method. req, resp := client.UpdateDomainContactRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53domains-2014-05-15/UpdateDomainContact

UpdateDomainContactWithContext

func (c *Route53Domains) UpdateDomainContactWithContext(ctx aws.Context, input *UpdateDomainContactInput, opts ...request.Option) (*UpdateDomainContactOutput, error)

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

See UpdateDomainContact 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.

UpdateDomainNameservers

func (c *Route53Domains) UpdateDomainNameservers(input *UpdateDomainNameserversInput) (*UpdateDomainNameserversOutput, error)

UpdateDomainNameservers API operation for Amazon Route 53 Domains.

This operation replaces the current set of name servers for the domain with the specified set of name servers. If you use Amazon Route 53 as your DNS service, specify the four name servers in the delegation set for the hosted zone for the domain.

If successful, this operation returns an operation ID that you can use to track the progress and completion of the action. If the request is not completed successfully, the domain registrant will be notified by email.

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 Domains's API operation UpdateDomainNameservers for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidInput "InvalidInput" The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.

  • ErrCodeDuplicateRequest "DuplicateRequest" The request is already in progress for the domain.

  • ErrCodeTLDRulesViolation "TLDRulesViolation" The top-level domain does not support this operation.

  • ErrCodeOperationLimitExceeded "OperationLimitExceeded" The number of operations or jobs running exceeded the allowed threshold for the account.

  • ErrCodeUnsupportedTLD "UnsupportedTLD" Amazon Route 53 does not support this top-level domain (TLD).

See also, https://docs.aws.amazon.com/goto/WebAPI/route53domains-2014-05-15/UpdateDomainNameservers

UpdateDomainNameserversRequest

func (c *Route53Domains) UpdateDomainNameserversRequest(input *UpdateDomainNameserversInput) (req *request.Request, output *UpdateDomainNameserversOutput)

UpdateDomainNameserversRequest generates a "aws/request.Request" representing the client's request for the UpdateDomainNameservers 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 UpdateDomainNameservers for more information on using the UpdateDomainNameservers 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 UpdateDomainNameserversRequest method. req, resp := client.UpdateDomainNameserversRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53domains-2014-05-15/UpdateDomainNameservers

UpdateDomainNameserversWithContext

func (c *Route53Domains) UpdateDomainNameserversWithContext(ctx aws.Context, input *UpdateDomainNameserversInput, opts ...request.Option) (*UpdateDomainNameserversOutput, error)

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

See UpdateDomainNameservers 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.

UpdateTagsForDomain

func (c *Route53Domains) UpdateTagsForDomain(input *UpdateTagsForDomainInput) (*UpdateTagsForDomainOutput, error)

UpdateTagsForDomain API operation for Amazon Route 53 Domains.

This operation adds or updates tags for a specified domain.

All tag operations are eventually consistent; subsequent operations might not immediately represent all issued operations.

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 Domains's API operation UpdateTagsForDomain for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidInput "InvalidInput" The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.

  • ErrCodeOperationLimitExceeded "OperationLimitExceeded" The number of operations or jobs running exceeded the allowed threshold for the account.

  • ErrCodeUnsupportedTLD "UnsupportedTLD" Amazon Route 53 does not support this top-level domain (TLD).

See also, https://docs.aws.amazon.com/goto/WebAPI/route53domains-2014-05-15/UpdateTagsForDomain

UpdateTagsForDomainRequest

func (c *Route53Domains) UpdateTagsForDomainRequest(input *UpdateTagsForDomainInput) (req *request.Request, output *UpdateTagsForDomainOutput)

UpdateTagsForDomainRequest generates a "aws/request.Request" representing the client's request for the UpdateTagsForDomain 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 UpdateTagsForDomain for more information on using the UpdateTagsForDomain 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 UpdateTagsForDomainRequest method. req, resp := client.UpdateTagsForDomainRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53domains-2014-05-15/UpdateTagsForDomain

UpdateTagsForDomainWithContext

func (c *Route53Domains) UpdateTagsForDomainWithContext(ctx aws.Context, input *UpdateTagsForDomainInput, opts ...request.Option) (*UpdateTagsForDomainOutput, error)

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

See UpdateTagsForDomain 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.

ViewBilling

func (c *Route53Domains) ViewBilling(input *ViewBillingInput) (*ViewBillingOutput, error)

ViewBilling API operation for Amazon Route 53 Domains.

Returns all the domain-related billing records for the current AWS account for a specified period

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 Domains's API operation ViewBilling for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidInput "InvalidInput" The requested item is not acceptable. For example, for an OperationId it might refer to the ID of an operation that is already completed. For a domain name, it might not be a valid domain name or belong to the requester account.

See also, https://docs.aws.amazon.com/goto/WebAPI/route53domains-2014-05-15/ViewBilling

ViewBillingRequest

func (c *Route53Domains) ViewBillingRequest(input *ViewBillingInput) (req *request.Request, output *ViewBillingOutput)

ViewBillingRequest generates a "aws/request.Request" representing the client's request for the ViewBilling 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 ViewBilling for more information on using the ViewBilling 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 ViewBillingRequest method. req, resp := client.ViewBillingRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/route53domains-2014-05-15/ViewBilling

ViewBillingWithContext

func (c *Route53Domains) ViewBillingWithContext(ctx aws.Context, input *ViewBillingInput, opts ...request.Option) (*ViewBillingOutput, error)

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

See ViewBilling 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.

On this page: