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.

RDS

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

type RDS struct { *client.Client }

RDS provides the API operation methods for making requests to Amazon Relational Database Service. See this package's package overview docs for details on the service.

RDS 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

AddRoleToDBCluster

func (c *RDS) AddRoleToDBCluster(input *AddRoleToDBClusterInput) (*AddRoleToDBClusterOutput, error)

AddRoleToDBCluster API operation for Amazon Relational Database Service.

Associates an Identity and Access Management (IAM) role from an Amazon Aurora DB cluster. For more information, see Authorizing Amazon Aurora MySQL to Access Other AWS Services on Your Behalf (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraMySQL.Integrating.Authorizing.html) in the Amazon Aurora 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 Relational Database Service's API operation AddRoleToDBCluster for usage and error information.

Returned Error Codes:

  • ErrCodeDBClusterNotFoundFault "DBClusterNotFoundFault" DBClusterIdentifier doesn't refer to an existing DB cluster.

  • ErrCodeDBClusterRoleAlreadyExistsFault "DBClusterRoleAlreadyExists" The specified IAM role Amazon Resource Name (ARN) is already associated with the specified DB cluster.

  • ErrCodeInvalidDBClusterStateFault "InvalidDBClusterStateFault" The requested operation can't be performed while the cluster is in this state.

  • ErrCodeDBClusterRoleQuotaExceededFault "DBClusterRoleQuotaExceeded" You have exceeded the maximum number of IAM roles that can be associated with the specified DB cluster.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/AddRoleToDBCluster

AddRoleToDBClusterRequest

func (c *RDS) AddRoleToDBClusterRequest(input *AddRoleToDBClusterInput) (req *request.Request, output *AddRoleToDBClusterOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/AddRoleToDBCluster

AddRoleToDBClusterWithContext

func (c *RDS) AddRoleToDBClusterWithContext(ctx aws.Context, input *AddRoleToDBClusterInput, opts ...request.Option) (*AddRoleToDBClusterOutput, error)

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

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

AddRoleToDBInstance

func (c *RDS) AddRoleToDBInstance(input *AddRoleToDBInstanceInput) (*AddRoleToDBInstanceOutput, error)

AddRoleToDBInstance API operation for Amazon Relational Database Service.

Associates an AWS Identity and Access Management (IAM) role with a DB instance.

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 Relational Database Service's API operation AddRoleToDBInstance for usage and error information.

Returned Error Codes:

  • ErrCodeDBInstanceNotFoundFault "DBInstanceNotFound" DBInstanceIdentifier doesn't refer to an existing DB instance.

  • ErrCodeDBInstanceRoleAlreadyExistsFault "DBInstanceRoleAlreadyExists" The specified RoleArn or FeatureName value is already associated with the DB instance.

  • ErrCodeInvalidDBInstanceStateFault "InvalidDBInstanceState" The DB instance isn't in a valid state.

  • ErrCodeDBInstanceRoleQuotaExceededFault "DBInstanceRoleQuotaExceeded" You can't associate any more AWS Identity and Access Management (IAM) roles with the DB instance because the quota has been reached.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/AddRoleToDBInstance

AddRoleToDBInstanceRequest

func (c *RDS) AddRoleToDBInstanceRequest(input *AddRoleToDBInstanceInput) (req *request.Request, output *AddRoleToDBInstanceOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/AddRoleToDBInstance

AddRoleToDBInstanceWithContext

func (c *RDS) AddRoleToDBInstanceWithContext(ctx aws.Context, input *AddRoleToDBInstanceInput, opts ...request.Option) (*AddRoleToDBInstanceOutput, error)

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

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

AddSourceIdentifierToSubscription

func (c *RDS) AddSourceIdentifierToSubscription(input *AddSourceIdentifierToSubscriptionInput) (*AddSourceIdentifierToSubscriptionOutput, error)

AddSourceIdentifierToSubscription API operation for Amazon Relational Database Service.

Adds a source identifier to an existing RDS event notification subscription.

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 Relational Database Service's API operation AddSourceIdentifierToSubscription for usage and error information.

Returned Error Codes:

  • ErrCodeSubscriptionNotFoundFault "SubscriptionNotFound" The subscription name does not exist.

  • ErrCodeSourceNotFoundFault "SourceNotFound" The requested source could not be found.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/AddSourceIdentifierToSubscription

Example

RDS AddSourceIdentifierToSubscription shared00

To add a source identifier to an event notification subscription

This example add a source identifier to an event notification subscription.

{ svc := rds.New(session.New()) input := &rds.AddSourceIdentifierToSubscriptionInput{ SourceIdentifier: aws.String("mymysqlinstance"), SubscriptionName: aws.String("mymysqleventsubscription"), } result, err := svc.AddSourceIdentifierToSubscription(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeSubscriptionNotFoundFault: fmt.Println(rds.ErrCodeSubscriptionNotFoundFault, aerr.Error()) case rds.ErrCodeSourceNotFoundFault: fmt.Println(rds.ErrCodeSourceNotFoundFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

AddSourceIdentifierToSubscriptionRequest

func (c *RDS) AddSourceIdentifierToSubscriptionRequest(input *AddSourceIdentifierToSubscriptionInput) (req *request.Request, output *AddSourceIdentifierToSubscriptionOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/AddSourceIdentifierToSubscription

AddSourceIdentifierToSubscriptionWithContext

func (c *RDS) AddSourceIdentifierToSubscriptionWithContext(ctx aws.Context, input *AddSourceIdentifierToSubscriptionInput, opts ...request.Option) (*AddSourceIdentifierToSubscriptionOutput, error)

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

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

AddTagsToResource

func (c *RDS) AddTagsToResource(input *AddTagsToResourceInput) (*AddTagsToResourceOutput, error)

AddTagsToResource API operation for Amazon Relational Database Service.

Adds metadata tags to an Amazon RDS resource. These tags can also be used with cost allocation reporting to track cost associated with Amazon RDS resources, or used in a Condition statement in an IAM policy for Amazon RDS.

For an overview on tagging Amazon RDS resources, see Tagging Amazon RDS Resources (https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Overview.Tagging.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 Relational Database Service's API operation AddTagsToResource for usage and error information.

Returned Error Codes:

  • ErrCodeDBInstanceNotFoundFault "DBInstanceNotFound" DBInstanceIdentifier doesn't refer to an existing DB instance.

  • ErrCodeDBSnapshotNotFoundFault "DBSnapshotNotFound" DBSnapshotIdentifier doesn't refer to an existing DB snapshot.

  • ErrCodeDBClusterNotFoundFault "DBClusterNotFoundFault" DBClusterIdentifier doesn't refer to an existing DB cluster.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/AddTagsToResource

Example

RDS AddTagsToResource shared00

To add tags to a resource

This example adds a tag to an option group.

{ svc := rds.New(session.New()) input := &rds.AddTagsToResourceInput{ ResourceName: aws.String("arn:aws:rds:us-east-1:992648334831:og:mymysqloptiongroup"), Tags: []*rds.Tag{ { Key: aws.String("Staging"), Value: aws.String("LocationDB"), }, }, } result, err := svc.AddTagsToResource(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeDBInstanceNotFoundFault: fmt.Println(rds.ErrCodeDBInstanceNotFoundFault, aerr.Error()) case rds.ErrCodeDBSnapshotNotFoundFault: fmt.Println(rds.ErrCodeDBSnapshotNotFoundFault, aerr.Error()) case rds.ErrCodeDBClusterNotFoundFault: fmt.Println(rds.ErrCodeDBClusterNotFoundFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

AddTagsToResourceRequest

func (c *RDS) AddTagsToResourceRequest(input *AddTagsToResourceInput) (req *request.Request, output *AddTagsToResourceOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/AddTagsToResource

AddTagsToResourceWithContext

func (c *RDS) AddTagsToResourceWithContext(ctx aws.Context, input *AddTagsToResourceInput, opts ...request.Option) (*AddTagsToResourceOutput, error)

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

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

ApplyPendingMaintenanceAction

func (c *RDS) ApplyPendingMaintenanceAction(input *ApplyPendingMaintenanceActionInput) (*ApplyPendingMaintenanceActionOutput, error)

ApplyPendingMaintenanceAction API operation for Amazon Relational Database Service.

Applies a pending maintenance action to a resource (for example, to a DB instance).

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 Relational Database Service's API operation ApplyPendingMaintenanceAction for usage and error information.

Returned Error Codes:

  • ErrCodeResourceNotFoundFault "ResourceNotFoundFault" The specified resource ID was not found.

  • ErrCodeInvalidDBClusterStateFault "InvalidDBClusterStateFault" The requested operation can't be performed while the cluster is in this state.

  • ErrCodeInvalidDBInstanceStateFault "InvalidDBInstanceState" The DB instance isn't in a valid state.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ApplyPendingMaintenanceAction

Example

RDS ApplyPendingMaintenanceAction shared00

To apply a pending maintenance action

This example immediately applies a pending system update to a DB instance.

{ svc := rds.New(session.New()) input := &rds.ApplyPendingMaintenanceActionInput{ ApplyAction: aws.String("system-update"), OptInType: aws.String("immediate"), ResourceIdentifier: aws.String("arn:aws:rds:us-east-1:992648334831:db:mymysqlinstance"), } result, err := svc.ApplyPendingMaintenanceAction(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeResourceNotFoundFault: fmt.Println(rds.ErrCodeResourceNotFoundFault, aerr.Error()) case rds.ErrCodeInvalidDBClusterStateFault: fmt.Println(rds.ErrCodeInvalidDBClusterStateFault, aerr.Error()) case rds.ErrCodeInvalidDBInstanceStateFault: fmt.Println(rds.ErrCodeInvalidDBInstanceStateFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

ApplyPendingMaintenanceActionRequest

func (c *RDS) ApplyPendingMaintenanceActionRequest(input *ApplyPendingMaintenanceActionInput) (req *request.Request, output *ApplyPendingMaintenanceActionOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ApplyPendingMaintenanceAction

ApplyPendingMaintenanceActionWithContext

func (c *RDS) ApplyPendingMaintenanceActionWithContext(ctx aws.Context, input *ApplyPendingMaintenanceActionInput, opts ...request.Option) (*ApplyPendingMaintenanceActionOutput, error)

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

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

AuthorizeDBSecurityGroupIngress

func (c *RDS) AuthorizeDBSecurityGroupIngress(input *AuthorizeDBSecurityGroupIngressInput) (*AuthorizeDBSecurityGroupIngressOutput, error)

AuthorizeDBSecurityGroupIngress API operation for Amazon Relational Database Service.

Enables ingress to a DBSecurityGroup using one of two forms of authorization. First, EC2 or VPC security groups can be added to the DBSecurityGroup if the application using the database is running on EC2 or VPC instances. Second, IP ranges are available if the application accessing your database is running on the Internet. Required parameters for this API are one of CIDR range, EC2SecurityGroupId for VPC, or (EC2SecurityGroupOwnerId and either EC2SecurityGroupName or EC2SecurityGroupId for non-VPC).

You can't authorize ingress from an EC2 security group in one AWS Region to an Amazon RDS DB instance in another. You can't authorize ingress from a VPC security group in one VPC to an Amazon RDS DB instance in another.

For an overview of CIDR ranges, go to the Wikipedia Tutorial (http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing).

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 Relational Database Service's API operation AuthorizeDBSecurityGroupIngress for usage and error information.

Returned Error Codes:

  • ErrCodeDBSecurityGroupNotFoundFault "DBSecurityGroupNotFound" DBSecurityGroupName doesn't refer to an existing DB security group.

  • ErrCodeInvalidDBSecurityGroupStateFault "InvalidDBSecurityGroupState" The state of the DB security group doesn't allow deletion.

  • ErrCodeAuthorizationAlreadyExistsFault "AuthorizationAlreadyExists" The specified CIDRIP or Amazon EC2 security group is already authorized for the specified DB security group.

  • ErrCodeAuthorizationQuotaExceededFault "AuthorizationQuotaExceeded" The DB security group authorization quota has been reached.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/AuthorizeDBSecurityGroupIngress

Example

RDS AuthorizeDBSecurityGroupIngress shared00

To authorize DB security group integress

This example authorizes access to the specified security group by the specified CIDR block.

{ svc := rds.New(session.New()) input := &rds.AuthorizeDBSecurityGroupIngressInput{ CIDRIP: aws.String("203.0.113.5/32"), DBSecurityGroupName: aws.String("mydbsecuritygroup"), } result, err := svc.AuthorizeDBSecurityGroupIngress(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeDBSecurityGroupNotFoundFault: fmt.Println(rds.ErrCodeDBSecurityGroupNotFoundFault, aerr.Error()) case rds.ErrCodeInvalidDBSecurityGroupStateFault: fmt.Println(rds.ErrCodeInvalidDBSecurityGroupStateFault, aerr.Error()) case rds.ErrCodeAuthorizationAlreadyExistsFault: fmt.Println(rds.ErrCodeAuthorizationAlreadyExistsFault, aerr.Error()) case rds.ErrCodeAuthorizationQuotaExceededFault: fmt.Println(rds.ErrCodeAuthorizationQuotaExceededFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

AuthorizeDBSecurityGroupIngressRequest

func (c *RDS) AuthorizeDBSecurityGroupIngressRequest(input *AuthorizeDBSecurityGroupIngressInput) (req *request.Request, output *AuthorizeDBSecurityGroupIngressOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/AuthorizeDBSecurityGroupIngress

AuthorizeDBSecurityGroupIngressWithContext

func (c *RDS) AuthorizeDBSecurityGroupIngressWithContext(ctx aws.Context, input *AuthorizeDBSecurityGroupIngressInput, opts ...request.Option) (*AuthorizeDBSecurityGroupIngressOutput, error)

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

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

BacktrackDBCluster

func (c *RDS) BacktrackDBCluster(input *BacktrackDBClusterInput) (*BacktrackDBClusterOutput, error)

BacktrackDBCluster API operation for Amazon Relational Database Service.

Backtracks a DB cluster to a specific time, without creating a new DB cluster.

For more information on backtracking, see Backtracking an Aurora DB Cluster (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraMySQL.Managing.Backtrack.html) in the Amazon Aurora 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 Relational Database Service's API operation BacktrackDBCluster for usage and error information.

Returned Error Codes:

  • ErrCodeDBClusterNotFoundFault "DBClusterNotFoundFault" DBClusterIdentifier doesn't refer to an existing DB cluster.

  • ErrCodeInvalidDBClusterStateFault "InvalidDBClusterStateFault" The requested operation can't be performed while the cluster is in this state.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/BacktrackDBCluster

BacktrackDBClusterRequest

func (c *RDS) BacktrackDBClusterRequest(input *BacktrackDBClusterInput) (req *request.Request, output *BacktrackDBClusterOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/BacktrackDBCluster

BacktrackDBClusterWithContext

func (c *RDS) BacktrackDBClusterWithContext(ctx aws.Context, input *BacktrackDBClusterInput, opts ...request.Option) (*BacktrackDBClusterOutput, error)

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

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

CopyDBClusterParameterGroup

func (c *RDS) CopyDBClusterParameterGroup(input *CopyDBClusterParameterGroupInput) (*CopyDBClusterParameterGroupOutput, error)

CopyDBClusterParameterGroup API operation for Amazon Relational Database Service.

Copies the specified DB cluster parameter group.

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 Relational Database Service's API operation CopyDBClusterParameterGroup for usage and error information.

Returned Error Codes:

  • ErrCodeDBParameterGroupNotFoundFault "DBParameterGroupNotFound" DBParameterGroupName doesn't refer to an existing DB parameter group.

  • ErrCodeDBParameterGroupQuotaExceededFault "DBParameterGroupQuotaExceeded" The request would result in the user exceeding the allowed number of DB parameter groups.

  • ErrCodeDBParameterGroupAlreadyExistsFault "DBParameterGroupAlreadyExists" A DB parameter group with the same name exists.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CopyDBClusterParameterGroup

Example

RDS CopyDBClusterParameterGroup shared00

To copy a DB cluster parameter group

This example copies a DB cluster parameter group.

{ svc := rds.New(session.New()) input := &rds.CopyDBClusterParameterGroupInput{ SourceDBClusterParameterGroupIdentifier: aws.String("mydbclusterparametergroup"), TargetDBClusterParameterGroupDescription: aws.String("My DB cluster parameter group copy"), TargetDBClusterParameterGroupIdentifier: aws.String("mydbclusterparametergroup-copy"), } result, err := svc.CopyDBClusterParameterGroup(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeDBParameterGroupNotFoundFault: fmt.Println(rds.ErrCodeDBParameterGroupNotFoundFault, aerr.Error()) case rds.ErrCodeDBParameterGroupQuotaExceededFault: fmt.Println(rds.ErrCodeDBParameterGroupQuotaExceededFault, aerr.Error()) case rds.ErrCodeDBParameterGroupAlreadyExistsFault: fmt.Println(rds.ErrCodeDBParameterGroupAlreadyExistsFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

CopyDBClusterParameterGroupRequest

func (c *RDS) CopyDBClusterParameterGroupRequest(input *CopyDBClusterParameterGroupInput) (req *request.Request, output *CopyDBClusterParameterGroupOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CopyDBClusterParameterGroup

CopyDBClusterParameterGroupWithContext

func (c *RDS) CopyDBClusterParameterGroupWithContext(ctx aws.Context, input *CopyDBClusterParameterGroupInput, opts ...request.Option) (*CopyDBClusterParameterGroupOutput, error)

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

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

CopyDBClusterSnapshot

func (c *RDS) CopyDBClusterSnapshot(input *CopyDBClusterSnapshotInput) (*CopyDBClusterSnapshotOutput, error)

CopyDBClusterSnapshot API operation for Amazon Relational Database Service.

Copies a snapshot of a DB cluster.

To copy a DB cluster snapshot from a shared manual DB cluster snapshot, SourceDBClusterSnapshotIdentifier must be the Amazon Resource Name (ARN) of the shared DB cluster snapshot.

You can copy an encrypted DB cluster snapshot from another AWS Region. In that case, the AWS Region where you call the CopyDBClusterSnapshot action is the destination AWS Region for the encrypted DB cluster snapshot to be copied to. To copy an encrypted DB cluster snapshot from another AWS Region, you must provide the following values:

  • KmsKeyId - The AWS Key Management System (AWS KMS) key identifier for the key to use to encrypt the copy of the DB cluster snapshot in the destination AWS Region.

  • PreSignedUrl - A URL that contains a Signature Version 4 signed request for the CopyDBClusterSnapshot action to be called in the source AWS Region where the DB cluster snapshot is copied from. The pre-signed URL must be a valid request for the CopyDBClusterSnapshot API action that can be executed in the source AWS Region that contains the encrypted DB cluster snapshot to be copied.

The pre-signed URL request must contain the following parameter values:

KmsKeyId - The KMS key identifier for the key to use to encrypt the copy

of the DB cluster snapshot in the destination AWS Region. This is the same identifier for both the CopyDBClusterSnapshot action that is called in the destination AWS Region, and the action contained in the pre-signed URL.

DestinationRegion - The name of the AWS Region that the DB cluster snapshot

will be created in.

SourceDBClusterSnapshotIdentifier - The DB cluster snapshot identifier for

the encrypted DB cluster snapshot to be copied. This identifier must be in the Amazon Resource Name (ARN) format for the source AWS Region. For example, if you are copying an encrypted DB cluster snapshot from the us-west-2 AWS Region, then your SourceDBClusterSnapshotIdentifier looks like the following example: arn:aws:rds:us-west-2:123456789012:cluster-snapshot:aurora-cluster1-snapshot-20161115.

To learn how to generate a Signature Version 4 signed request, see Authenticating

Requests: Using Query Parameters (AWS Signature Version 4) (http://docs.aws.amazon.com/AmazonS3/latest/API/sigv4-query-string-auth.html) and Signature Version 4 Signing Process (http://docs.aws.amazon.com/general/latest/gr/signature-version-4.html).
  • TargetDBClusterSnapshotIdentifier - The identifier for the new copy of the DB cluster snapshot in the destination AWS Region.

  • SourceDBClusterSnapshotIdentifier - The DB cluster snapshot identifier for the encrypted DB cluster snapshot to be copied. This identifier must be in the ARN format for the source AWS Region and is the same value as the SourceDBClusterSnapshotIdentifier in the pre-signed URL.

To cancel the copy operation once it is in progress, delete the target DB cluster snapshot identified by TargetDBClusterSnapshotIdentifier while that DB cluster snapshot is in "copying" status.

For more information on copying encrypted DB cluster snapshots from one AWS Region to another, see Copying a Snapshot (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_CopySnapshot.html) in the Amazon Aurora User Guide.

For more information on Amazon Aurora, see What Is Amazon Aurora? (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html) in the Amazon Aurora 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 Relational Database Service's API operation CopyDBClusterSnapshot for usage and error information.

Returned Error Codes:

  • ErrCodeDBClusterSnapshotAlreadyExistsFault "DBClusterSnapshotAlreadyExistsFault" The user already has a DB cluster snapshot with the given identifier.

  • ErrCodeDBClusterSnapshotNotFoundFault "DBClusterSnapshotNotFoundFault" DBClusterSnapshotIdentifier doesn't refer to an existing DB cluster snapshot.

  • ErrCodeInvalidDBClusterStateFault "InvalidDBClusterStateFault" The requested operation can't be performed while the cluster is in this state.

  • ErrCodeInvalidDBClusterSnapshotStateFault "InvalidDBClusterSnapshotStateFault" The supplied value isn't a valid DB cluster snapshot state.

  • ErrCodeSnapshotQuotaExceededFault "SnapshotQuotaExceeded" The request would result in the user exceeding the allowed number of DB snapshots.

  • ErrCodeKMSKeyNotAccessibleFault "KMSKeyNotAccessibleFault" An error occurred accessing an AWS KMS key.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CopyDBClusterSnapshot

Example

RDS CopyDBClusterSnapshot shared00

To copy a DB cluster snapshot

The following example copies an automated snapshot of a DB cluster to a new DB cluster snapshot.

{ svc := rds.New(session.New()) input := &rds.CopyDBClusterSnapshotInput{ SourceDBClusterSnapshotIdentifier: aws.String("rds:sample-cluster-2016-09-14-10-38"), TargetDBClusterSnapshotIdentifier: aws.String("cluster-snapshot-copy-1"), } result, err := svc.CopyDBClusterSnapshot(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeDBClusterSnapshotAlreadyExistsFault: fmt.Println(rds.ErrCodeDBClusterSnapshotAlreadyExistsFault, aerr.Error()) case rds.ErrCodeDBClusterSnapshotNotFoundFault: fmt.Println(rds.ErrCodeDBClusterSnapshotNotFoundFault, aerr.Error()) case rds.ErrCodeInvalidDBClusterStateFault: fmt.Println(rds.ErrCodeInvalidDBClusterStateFault, aerr.Error()) case rds.ErrCodeInvalidDBClusterSnapshotStateFault: fmt.Println(rds.ErrCodeInvalidDBClusterSnapshotStateFault, aerr.Error()) case rds.ErrCodeSnapshotQuotaExceededFault: fmt.Println(rds.ErrCodeSnapshotQuotaExceededFault, aerr.Error()) case rds.ErrCodeKMSKeyNotAccessibleFault: fmt.Println(rds.ErrCodeKMSKeyNotAccessibleFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

CopyDBClusterSnapshotRequest

func (c *RDS) CopyDBClusterSnapshotRequest(input *CopyDBClusterSnapshotInput) (req *request.Request, output *CopyDBClusterSnapshotOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CopyDBClusterSnapshot

CopyDBClusterSnapshotWithContext

func (c *RDS) CopyDBClusterSnapshotWithContext(ctx aws.Context, input *CopyDBClusterSnapshotInput, opts ...request.Option) (*CopyDBClusterSnapshotOutput, error)

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

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

CopyDBParameterGroup

func (c *RDS) CopyDBParameterGroup(input *CopyDBParameterGroupInput) (*CopyDBParameterGroupOutput, error)

CopyDBParameterGroup API operation for Amazon Relational Database Service.

Copies the specified DB parameter group.

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 Relational Database Service's API operation CopyDBParameterGroup for usage and error information.

Returned Error Codes:

  • ErrCodeDBParameterGroupNotFoundFault "DBParameterGroupNotFound" DBParameterGroupName doesn't refer to an existing DB parameter group.

  • ErrCodeDBParameterGroupAlreadyExistsFault "DBParameterGroupAlreadyExists" A DB parameter group with the same name exists.

  • ErrCodeDBParameterGroupQuotaExceededFault "DBParameterGroupQuotaExceeded" The request would result in the user exceeding the allowed number of DB parameter groups.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CopyDBParameterGroup

Example

RDS CopyDBParameterGroup shared00

To copy a DB parameter group

This example copies a DB parameter group.

{ svc := rds.New(session.New()) input := &rds.CopyDBParameterGroupInput{ SourceDBParameterGroupIdentifier: aws.String("mymysqlparametergroup"), TargetDBParameterGroupDescription: aws.String("My MySQL parameter group copy"), TargetDBParameterGroupIdentifier: aws.String("mymysqlparametergroup-copy"), } result, err := svc.CopyDBParameterGroup(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeDBParameterGroupNotFoundFault: fmt.Println(rds.ErrCodeDBParameterGroupNotFoundFault, aerr.Error()) case rds.ErrCodeDBParameterGroupAlreadyExistsFault: fmt.Println(rds.ErrCodeDBParameterGroupAlreadyExistsFault, aerr.Error()) case rds.ErrCodeDBParameterGroupQuotaExceededFault: fmt.Println(rds.ErrCodeDBParameterGroupQuotaExceededFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

CopyDBParameterGroupRequest

func (c *RDS) CopyDBParameterGroupRequest(input *CopyDBParameterGroupInput) (req *request.Request, output *CopyDBParameterGroupOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CopyDBParameterGroup

CopyDBParameterGroupWithContext

func (c *RDS) CopyDBParameterGroupWithContext(ctx aws.Context, input *CopyDBParameterGroupInput, opts ...request.Option) (*CopyDBParameterGroupOutput, error)

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

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

CopyDBSnapshot

func (c *RDS) CopyDBSnapshot(input *CopyDBSnapshotInput) (*CopyDBSnapshotOutput, error)

CopyDBSnapshot API operation for Amazon Relational Database Service.

Copies the specified DB snapshot. The source DB snapshot must be in the "available" state.

You can copy a snapshot from one AWS Region to another. In that case, the AWS Region where you call the CopyDBSnapshot action is the destination AWS Region for the DB snapshot copy.

For more information about copying snapshots, see Copying a DB Snapshot (https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_CopyDBSnapshot.html) in the Amazon RDS 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 Relational Database Service's API operation CopyDBSnapshot for usage and error information.

Returned Error Codes:

  • ErrCodeDBSnapshotAlreadyExistsFault "DBSnapshotAlreadyExists" DBSnapshotIdentifier is already used by an existing snapshot.

  • ErrCodeDBSnapshotNotFoundFault "DBSnapshotNotFound" DBSnapshotIdentifier doesn't refer to an existing DB snapshot.

  • ErrCodeInvalidDBSnapshotStateFault "InvalidDBSnapshotState" The state of the DB snapshot doesn't allow deletion.

  • ErrCodeSnapshotQuotaExceededFault "SnapshotQuotaExceeded" The request would result in the user exceeding the allowed number of DB snapshots.

  • ErrCodeKMSKeyNotAccessibleFault "KMSKeyNotAccessibleFault" An error occurred accessing an AWS KMS key.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CopyDBSnapshot

Example

RDS CopyDBSnapshot shared00

To copy a DB snapshot

This example copies a DB snapshot.

{ svc := rds.New(session.New()) input := &rds.CopyDBSnapshotInput{ SourceDBSnapshotIdentifier: aws.String("mydbsnapshot"), TargetDBSnapshotIdentifier: aws.String("mydbsnapshot-copy"), } result, err := svc.CopyDBSnapshot(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeDBSnapshotAlreadyExistsFault: fmt.Println(rds.ErrCodeDBSnapshotAlreadyExistsFault, aerr.Error()) case rds.ErrCodeDBSnapshotNotFoundFault: fmt.Println(rds.ErrCodeDBSnapshotNotFoundFault, aerr.Error()) case rds.ErrCodeInvalidDBSnapshotStateFault: fmt.Println(rds.ErrCodeInvalidDBSnapshotStateFault, aerr.Error()) case rds.ErrCodeSnapshotQuotaExceededFault: fmt.Println(rds.ErrCodeSnapshotQuotaExceededFault, aerr.Error()) case rds.ErrCodeKMSKeyNotAccessibleFault: fmt.Println(rds.ErrCodeKMSKeyNotAccessibleFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

CopyDBSnapshotRequest

func (c *RDS) CopyDBSnapshotRequest(input *CopyDBSnapshotInput) (req *request.Request, output *CopyDBSnapshotOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CopyDBSnapshot

CopyDBSnapshotWithContext

func (c *RDS) CopyDBSnapshotWithContext(ctx aws.Context, input *CopyDBSnapshotInput, opts ...request.Option) (*CopyDBSnapshotOutput, error)

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

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

CopyOptionGroup

func (c *RDS) CopyOptionGroup(input *CopyOptionGroupInput) (*CopyOptionGroupOutput, error)

CopyOptionGroup API operation for Amazon Relational Database Service.

Copies the specified option group.

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 Relational Database Service's API operation CopyOptionGroup for usage and error information.

Returned Error Codes:

  • ErrCodeOptionGroupAlreadyExistsFault "OptionGroupAlreadyExistsFault" The option group you are trying to create already exists.

  • ErrCodeOptionGroupNotFoundFault "OptionGroupNotFoundFault" The specified option group could not be found.

  • ErrCodeOptionGroupQuotaExceededFault "OptionGroupQuotaExceededFault" The quota of 20 option groups was exceeded for this AWS account.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CopyOptionGroup

Example

RDS CopyOptionGroup shared00

To copy an option group

This example copies an option group.

{ svc := rds.New(session.New()) input := &rds.CopyOptionGroupInput{ SourceOptionGroupIdentifier: aws.String("mymysqloptiongroup"), TargetOptionGroupDescription: aws.String("My MySQL option group copy"), TargetOptionGroupIdentifier: aws.String("mymysqloptiongroup-copy"), } result, err := svc.CopyOptionGroup(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeOptionGroupAlreadyExistsFault: fmt.Println(rds.ErrCodeOptionGroupAlreadyExistsFault, aerr.Error()) case rds.ErrCodeOptionGroupNotFoundFault: fmt.Println(rds.ErrCodeOptionGroupNotFoundFault, aerr.Error()) case rds.ErrCodeOptionGroupQuotaExceededFault: fmt.Println(rds.ErrCodeOptionGroupQuotaExceededFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

CopyOptionGroupRequest

func (c *RDS) CopyOptionGroupRequest(input *CopyOptionGroupInput) (req *request.Request, output *CopyOptionGroupOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CopyOptionGroup

CopyOptionGroupWithContext

func (c *RDS) CopyOptionGroupWithContext(ctx aws.Context, input *CopyOptionGroupInput, opts ...request.Option) (*CopyOptionGroupOutput, error)

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

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

CreateDBCluster

func (c *RDS) CreateDBCluster(input *CreateDBClusterInput) (*CreateDBClusterOutput, error)

CreateDBCluster API operation for Amazon Relational Database Service.

Creates a new Amazon Aurora DB cluster.

You can use the ReplicationSourceIdentifier parameter to create the DB cluster as a Read Replica of another DB cluster or Amazon RDS MySQL DB instance. For cross-region replication where the DB cluster identified by ReplicationSourceIdentifier is encrypted, you must also specify the PreSignedUrl parameter.

For more information on Amazon Aurora, see What Is Amazon Aurora? (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html) in the Amazon Aurora 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 Relational Database Service's API operation CreateDBCluster for usage and error information.

Returned Error Codes:

  • ErrCodeDBClusterAlreadyExistsFault "DBClusterAlreadyExistsFault" The user already has a DB cluster with the given identifier.

  • ErrCodeInsufficientStorageClusterCapacityFault "InsufficientStorageClusterCapacity" There is insufficient storage available for the current action. You might be able to resolve this error by updating your subnet group to use different Availability Zones that have more storage available.

  • ErrCodeDBClusterQuotaExceededFault "DBClusterQuotaExceededFault" The user attempted to create a new DB cluster and the user has already reached the maximum allowed DB cluster quota.

  • ErrCodeStorageQuotaExceededFault "StorageQuotaExceeded" The request would result in the user exceeding the allowed amount of storage available across all DB instances.

  • ErrCodeDBSubnetGroupNotFoundFault "DBSubnetGroupNotFoundFault" DBSubnetGroupName doesn't refer to an existing DB subnet group.

  • ErrCodeInvalidVPCNetworkStateFault "InvalidVPCNetworkStateFault" The DB subnet group doesn't cover all Availability Zones after it's created because of users' change.

  • ErrCodeInvalidDBClusterStateFault "InvalidDBClusterStateFault" The requested operation can't be performed while the cluster is in this state.

  • ErrCodeInvalidDBSubnetGroupStateFault "InvalidDBSubnetGroupStateFault" The DB subnet group cannot be deleted because it's in use.

  • ErrCodeInvalidSubnet "InvalidSubnet" The requested subnet is invalid, or multiple subnets were requested that are not all in a common VPC.

  • ErrCodeInvalidDBInstanceStateFault "InvalidDBInstanceState" The DB instance isn't in a valid state.

  • ErrCodeDBClusterParameterGroupNotFoundFault "DBClusterParameterGroupNotFound" DBClusterParameterGroupName doesn't refer to an existing DB cluster parameter group.

  • ErrCodeKMSKeyNotAccessibleFault "KMSKeyNotAccessibleFault" An error occurred accessing an AWS KMS key.

  • ErrCodeDBClusterNotFoundFault "DBClusterNotFoundFault" DBClusterIdentifier doesn't refer to an existing DB cluster.

  • ErrCodeDBInstanceNotFoundFault "DBInstanceNotFound" DBInstanceIdentifier doesn't refer to an existing DB instance.

  • ErrCodeDBSubnetGroupDoesNotCoverEnoughAZs "DBSubnetGroupDoesNotCoverEnoughAZs" Subnets in the DB subnet group should cover at least two Availability Zones unless there is only one Availability Zone.

  • ErrCodeGlobalClusterNotFoundFault "GlobalClusterNotFoundFault"

  • ErrCodeInvalidGlobalClusterStateFault "InvalidGlobalClusterStateFault"

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateDBCluster

Example

RDS CreateDBCluster shared00

To create a DB cluster

This example creates a DB cluster.

{ svc := rds.New(session.New()) input := &rds.CreateDBClusterInput{ AvailabilityZones: []*string{ aws.String("us-east-1a"), }, BackupRetentionPeriod: aws.Int64(1), DBClusterIdentifier: aws.String("mydbcluster"), DBClusterParameterGroupName: aws.String("mydbclusterparametergroup"), DatabaseName: aws.String("myauroradb"), Engine: aws.String("aurora"), EngineVersion: aws.String("5.6.10a"), MasterUserPassword: aws.String("mypassword"), MasterUsername: aws.String("myuser"), Port: aws.Int64(3306), StorageEncrypted: aws.Bool(true), } result, err := svc.CreateDBCluster(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeDBClusterAlreadyExistsFault: fmt.Println(rds.ErrCodeDBClusterAlreadyExistsFault, aerr.Error()) case rds.ErrCodeInsufficientStorageClusterCapacityFault: fmt.Println(rds.ErrCodeInsufficientStorageClusterCapacityFault, aerr.Error()) case rds.ErrCodeDBClusterQuotaExceededFault: fmt.Println(rds.ErrCodeDBClusterQuotaExceededFault, aerr.Error()) case rds.ErrCodeStorageQuotaExceededFault: fmt.Println(rds.ErrCodeStorageQuotaExceededFault, aerr.Error()) case rds.ErrCodeDBSubnetGroupNotFoundFault: fmt.Println(rds.ErrCodeDBSubnetGroupNotFoundFault, aerr.Error()) case rds.ErrCodeInvalidVPCNetworkStateFault: fmt.Println(rds.ErrCodeInvalidVPCNetworkStateFault, aerr.Error()) case rds.ErrCodeInvalidDBClusterStateFault: fmt.Println(rds.ErrCodeInvalidDBClusterStateFault, aerr.Error()) case rds.ErrCodeInvalidDBSubnetGroupStateFault: fmt.Println(rds.ErrCodeInvalidDBSubnetGroupStateFault, aerr.Error()) case rds.ErrCodeInvalidSubnet: fmt.Println(rds.ErrCodeInvalidSubnet, aerr.Error()) case rds.ErrCodeInvalidDBInstanceStateFault: fmt.Println(rds.ErrCodeInvalidDBInstanceStateFault, aerr.Error()) case rds.ErrCodeDBClusterParameterGroupNotFoundFault: fmt.Println(rds.ErrCodeDBClusterParameterGroupNotFoundFault, aerr.Error()) case rds.ErrCodeKMSKeyNotAccessibleFault: fmt.Println(rds.ErrCodeKMSKeyNotAccessibleFault, aerr.Error()) case rds.ErrCodeDBClusterNotFoundFault: fmt.Println(rds.ErrCodeDBClusterNotFoundFault, aerr.Error()) case rds.ErrCodeDBInstanceNotFoundFault: fmt.Println(rds.ErrCodeDBInstanceNotFoundFault, aerr.Error()) case rds.ErrCodeDBSubnetGroupDoesNotCoverEnoughAZs: fmt.Println(rds.ErrCodeDBSubnetGroupDoesNotCoverEnoughAZs, aerr.Error()) case rds.ErrCodeGlobalClusterNotFoundFault: fmt.Println(rds.ErrCodeGlobalClusterNotFoundFault, aerr.Error()) case rds.ErrCodeInvalidGlobalClusterStateFault: fmt.Println(rds.ErrCodeInvalidGlobalClusterStateFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

CreateDBClusterEndpoint

func (c *RDS) CreateDBClusterEndpoint(input *CreateDBClusterEndpointInput) (*CreateDBClusterEndpointOutput, error)

CreateDBClusterEndpoint API operation for Amazon Relational Database Service.

Creates a new custom endpoint and associates it with an Amazon Aurora DB cluster.

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 Relational Database Service's API operation CreateDBClusterEndpoint for usage and error information.

Returned Error Codes:

  • ErrCodeDBClusterEndpointQuotaExceededFault "DBClusterEndpointQuotaExceededFault" The cluster already has the maximum number of custom endpoints.

  • ErrCodeDBClusterEndpointAlreadyExistsFault "DBClusterEndpointAlreadyExistsFault" The specified custom endpoint can't be created because it already exists.

  • ErrCodeDBClusterNotFoundFault "DBClusterNotFoundFault" DBClusterIdentifier doesn't refer to an existing DB cluster.

  • ErrCodeInvalidDBClusterStateFault "InvalidDBClusterStateFault" The requested operation can't be performed while the cluster is in this state.

  • ErrCodeDBInstanceNotFoundFault "DBInstanceNotFound" DBInstanceIdentifier doesn't refer to an existing DB instance.

  • ErrCodeInvalidDBInstanceStateFault "InvalidDBInstanceState" The DB instance isn't in a valid state.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateDBClusterEndpoint

CreateDBClusterEndpointRequest

func (c *RDS) CreateDBClusterEndpointRequest(input *CreateDBClusterEndpointInput) (req *request.Request, output *CreateDBClusterEndpointOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateDBClusterEndpoint

CreateDBClusterEndpointWithContext

func (c *RDS) CreateDBClusterEndpointWithContext(ctx aws.Context, input *CreateDBClusterEndpointInput, opts ...request.Option) (*CreateDBClusterEndpointOutput, error)

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

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

CreateDBClusterParameterGroup

func (c *RDS) CreateDBClusterParameterGroup(input *CreateDBClusterParameterGroupInput) (*CreateDBClusterParameterGroupOutput, error)

CreateDBClusterParameterGroup API operation for Amazon Relational Database Service.

Creates a new DB cluster parameter group.

Parameters in a DB cluster parameter group apply to all of the instances in a DB cluster.

A DB cluster parameter group is initially created with the default parameters for the database engine used by instances in the DB cluster. To provide custom values for any of the parameters, you must modify the group after creating it using ModifyDBClusterParameterGroup. Once you've created a DB cluster parameter group, you need to associate it with your DB cluster using ModifyDBCluster. When you associate a new DB cluster parameter group with a running DB cluster, you need to reboot the DB instances in the DB cluster without failover for the new DB cluster parameter group and associated settings to take effect.

After you create a DB cluster parameter group, you should wait at least 5 minutes before creating your first DB cluster that uses that DB cluster parameter group as the default parameter group. This allows Amazon RDS to fully complete the create action before the DB cluster parameter group is used as the default for a new DB cluster. This is especially important for parameters that are critical when creating the default database for a DB cluster, such as the character set for the default database defined by the character_set_database parameter. You can use the Parameter Groups option of the Amazon RDS console (https://console.aws.amazon.com/rds/) or the DescribeDBClusterParameters command to verify that your DB cluster parameter group has been created or modified.

For more information on Amazon Aurora, see What Is Amazon Aurora? (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html) in the Amazon Aurora 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 Relational Database Service's API operation CreateDBClusterParameterGroup for usage and error information.

Returned Error Codes:

  • ErrCodeDBParameterGroupQuotaExceededFault "DBParameterGroupQuotaExceeded" The request would result in the user exceeding the allowed number of DB parameter groups.

  • ErrCodeDBParameterGroupAlreadyExistsFault "DBParameterGroupAlreadyExists" A DB parameter group with the same name exists.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateDBClusterParameterGroup

Example

RDS CreateDBClusterParameterGroup shared00

To create a DB cluster parameter group

This example creates a DB cluster parameter group.

{ svc := rds.New(session.New()) input := &rds.CreateDBClusterParameterGroupInput{ DBClusterParameterGroupName: aws.String("mydbclusterparametergroup"), DBParameterGroupFamily: aws.String("aurora5.6"), Description: aws.String("My DB cluster parameter group"), } result, err := svc.CreateDBClusterParameterGroup(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeDBParameterGroupQuotaExceededFault: fmt.Println(rds.ErrCodeDBParameterGroupQuotaExceededFault, aerr.Error()) case rds.ErrCodeDBParameterGroupAlreadyExistsFault: fmt.Println(rds.ErrCodeDBParameterGroupAlreadyExistsFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

CreateDBClusterParameterGroupRequest

func (c *RDS) CreateDBClusterParameterGroupRequest(input *CreateDBClusterParameterGroupInput) (req *request.Request, output *CreateDBClusterParameterGroupOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateDBClusterParameterGroup

CreateDBClusterParameterGroupWithContext

func (c *RDS) CreateDBClusterParameterGroupWithContext(ctx aws.Context, input *CreateDBClusterParameterGroupInput, opts ...request.Option) (*CreateDBClusterParameterGroupOutput, error)

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

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

CreateDBClusterRequest

func (c *RDS) CreateDBClusterRequest(input *CreateDBClusterInput) (req *request.Request, output *CreateDBClusterOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateDBCluster

CreateDBClusterSnapshot

func (c *RDS) CreateDBClusterSnapshot(input *CreateDBClusterSnapshotInput) (*CreateDBClusterSnapshotOutput, error)

CreateDBClusterSnapshot API operation for Amazon Relational Database Service.

Creates a snapshot of a DB cluster. For more information on Amazon Aurora, see What Is Amazon Aurora? (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html) in the Amazon Aurora 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 Relational Database Service's API operation CreateDBClusterSnapshot for usage and error information.

Returned Error Codes:

  • ErrCodeDBClusterSnapshotAlreadyExistsFault "DBClusterSnapshotAlreadyExistsFault" The user already has a DB cluster snapshot with the given identifier.

  • ErrCodeInvalidDBClusterStateFault "InvalidDBClusterStateFault" The requested operation can't be performed while the cluster is in this state.

  • ErrCodeDBClusterNotFoundFault "DBClusterNotFoundFault" DBClusterIdentifier doesn't refer to an existing DB cluster.

  • ErrCodeSnapshotQuotaExceededFault "SnapshotQuotaExceeded" The request would result in the user exceeding the allowed number of DB snapshots.

  • ErrCodeInvalidDBClusterSnapshotStateFault "InvalidDBClusterSnapshotStateFault" The supplied value isn't a valid DB cluster snapshot state.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateDBClusterSnapshot

Example

RDS CreateDBClusterSnapshot shared00

To create a DB cluster snapshot

This example creates a DB cluster snapshot.

{ svc := rds.New(session.New()) input := &rds.CreateDBClusterSnapshotInput{ DBClusterIdentifier: aws.String("mydbcluster"), DBClusterSnapshotIdentifier: aws.String("mydbclustersnapshot"), } result, err := svc.CreateDBClusterSnapshot(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeDBClusterSnapshotAlreadyExistsFault: fmt.Println(rds.ErrCodeDBClusterSnapshotAlreadyExistsFault, aerr.Error()) case rds.ErrCodeInvalidDBClusterStateFault: fmt.Println(rds.ErrCodeInvalidDBClusterStateFault, aerr.Error()) case rds.ErrCodeDBClusterNotFoundFault: fmt.Println(rds.ErrCodeDBClusterNotFoundFault, aerr.Error()) case rds.ErrCodeSnapshotQuotaExceededFault: fmt.Println(rds.ErrCodeSnapshotQuotaExceededFault, aerr.Error()) case rds.ErrCodeInvalidDBClusterSnapshotStateFault: fmt.Println(rds.ErrCodeInvalidDBClusterSnapshotStateFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

CreateDBClusterSnapshotRequest

func (c *RDS) CreateDBClusterSnapshotRequest(input *CreateDBClusterSnapshotInput) (req *request.Request, output *CreateDBClusterSnapshotOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateDBClusterSnapshot

CreateDBClusterSnapshotWithContext

func (c *RDS) CreateDBClusterSnapshotWithContext(ctx aws.Context, input *CreateDBClusterSnapshotInput, opts ...request.Option) (*CreateDBClusterSnapshotOutput, error)

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

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

CreateDBClusterWithContext

func (c *RDS) CreateDBClusterWithContext(ctx aws.Context, input *CreateDBClusterInput, opts ...request.Option) (*CreateDBClusterOutput, error)

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

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

CreateDBInstance

func (c *RDS) CreateDBInstance(input *CreateDBInstanceInput) (*CreateDBInstanceOutput, error)

CreateDBInstance API operation for Amazon Relational Database Service.

Creates a new DB instance.

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 Relational Database Service's API operation CreateDBInstance for usage and error information.

Returned Error Codes:

  • ErrCodeDBInstanceAlreadyExistsFault "DBInstanceAlreadyExists" The user already has a DB instance with the given identifier.

  • ErrCodeInsufficientDBInstanceCapacityFault "InsufficientDBInstanceCapacity" The specified DB instance class isn't available in the specified Availability Zone.

  • ErrCodeDBParameterGroupNotFoundFault "DBParameterGroupNotFound" DBParameterGroupName doesn't refer to an existing DB parameter group.

  • ErrCodeDBSecurityGroupNotFoundFault "DBSecurityGroupNotFound" DBSecurityGroupName doesn't refer to an existing DB security group.

  • ErrCodeInstanceQuotaExceededFault "InstanceQuotaExceeded" The request would result in the user exceeding the allowed number of DB instances.

  • ErrCodeStorageQuotaExceededFault "StorageQuotaExceeded" The request would result in the user exceeding the allowed amount of storage available across all DB instances.

  • ErrCodeDBSubnetGroupNotFoundFault "DBSubnetGroupNotFoundFault" DBSubnetGroupName doesn't refer to an existing DB subnet group.

  • ErrCodeDBSubnetGroupDoesNotCoverEnoughAZs "DBSubnetGroupDoesNotCoverEnoughAZs" Subnets in the DB subnet group should cover at least two Availability Zones unless there is only one Availability Zone.

  • ErrCodeInvalidDBClusterStateFault "InvalidDBClusterStateFault" The requested operation can't be performed while the cluster is in this state.

  • ErrCodeInvalidSubnet "InvalidSubnet" The requested subnet is invalid, or multiple subnets were requested that are not all in a common VPC.

  • ErrCodeInvalidVPCNetworkStateFault "InvalidVPCNetworkStateFault" The DB subnet group doesn't cover all Availability Zones after it's created because of users' change.

  • ErrCodeProvisionedIopsNotAvailableInAZFault "ProvisionedIopsNotAvailableInAZFault" Provisioned IOPS not available in the specified Availability Zone.

  • ErrCodeOptionGroupNotFoundFault "OptionGroupNotFoundFault" The specified option group could not be found.

  • ErrCodeDBClusterNotFoundFault "DBClusterNotFoundFault" DBClusterIdentifier doesn't refer to an existing DB cluster.

  • ErrCodeStorageTypeNotSupportedFault "StorageTypeNotSupported" Storage of the StorageType specified can't be associated with the DB instance.

  • ErrCodeAuthorizationNotFoundFault "AuthorizationNotFound" The specified CIDRIP or Amazon EC2 security group isn't authorized for the specified DB security group.

RDS also may not be authorized by using IAM to perform necessary actions on your behalf.
  • ErrCodeKMSKeyNotAccessibleFault "KMSKeyNotAccessibleFault" An error occurred accessing an AWS KMS key.

  • ErrCodeDomainNotFoundFault "DomainNotFoundFault" Domain doesn't refer to an existing Active Directory domain.

  • ErrCodeBackupPolicyNotFoundFault "BackupPolicyNotFoundFault" The backup policy was not found.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateDBInstance

Example

RDS CreateDBInstance shared00

To create a DB instance.

This example creates a DB instance.

{ svc := rds.New(session.New()) input := &rds.CreateDBInstanceInput{ AllocatedStorage: aws.Int64(5), DBInstanceClass: aws.String("db.t2.micro"), DBInstanceIdentifier: aws.String("mymysqlinstance"), Engine: aws.String("MySQL"), MasterUserPassword: aws.String("MyPassword"), MasterUsername: aws.String("MyUser"), } result, err := svc.CreateDBInstance(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeDBInstanceAlreadyExistsFault: fmt.Println(rds.ErrCodeDBInstanceAlreadyExistsFault, aerr.Error()) case rds.ErrCodeInsufficientDBInstanceCapacityFault: fmt.Println(rds.ErrCodeInsufficientDBInstanceCapacityFault, aerr.Error()) case rds.ErrCodeDBParameterGroupNotFoundFault: fmt.Println(rds.ErrCodeDBParameterGroupNotFoundFault, aerr.Error()) case rds.ErrCodeDBSecurityGroupNotFoundFault: fmt.Println(rds.ErrCodeDBSecurityGroupNotFoundFault, aerr.Error()) case rds.ErrCodeInstanceQuotaExceededFault: fmt.Println(rds.ErrCodeInstanceQuotaExceededFault, aerr.Error()) case rds.ErrCodeStorageQuotaExceededFault: fmt.Println(rds.ErrCodeStorageQuotaExceededFault, aerr.Error()) case rds.ErrCodeDBSubnetGroupNotFoundFault: fmt.Println(rds.ErrCodeDBSubnetGroupNotFoundFault, aerr.Error()) case rds.ErrCodeDBSubnetGroupDoesNotCoverEnoughAZs: fmt.Println(rds.ErrCodeDBSubnetGroupDoesNotCoverEnoughAZs, aerr.Error()) case rds.ErrCodeInvalidDBClusterStateFault: fmt.Println(rds.ErrCodeInvalidDBClusterStateFault, aerr.Error()) case rds.ErrCodeInvalidSubnet: fmt.Println(rds.ErrCodeInvalidSubnet, aerr.Error()) case rds.ErrCodeInvalidVPCNetworkStateFault: fmt.Println(rds.ErrCodeInvalidVPCNetworkStateFault, aerr.Error()) case rds.ErrCodeProvisionedIopsNotAvailableInAZFault: fmt.Println(rds.ErrCodeProvisionedIopsNotAvailableInAZFault, aerr.Error()) case rds.ErrCodeOptionGroupNotFoundFault: fmt.Println(rds.ErrCodeOptionGroupNotFoundFault, aerr.Error()) case rds.ErrCodeDBClusterNotFoundFault: fmt.Println(rds.ErrCodeDBClusterNotFoundFault, aerr.Error()) case rds.ErrCodeStorageTypeNotSupportedFault: fmt.Println(rds.ErrCodeStorageTypeNotSupportedFault, aerr.Error()) case rds.ErrCodeAuthorizationNotFoundFault: fmt.Println(rds.ErrCodeAuthorizationNotFoundFault, aerr.Error()) case rds.ErrCodeKMSKeyNotAccessibleFault: fmt.Println(rds.ErrCodeKMSKeyNotAccessibleFault, aerr.Error()) case rds.ErrCodeDomainNotFoundFault: fmt.Println(rds.ErrCodeDomainNotFoundFault, aerr.Error()) case rds.ErrCodeBackupPolicyNotFoundFault: fmt.Println(rds.ErrCodeBackupPolicyNotFoundFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

CreateDBInstanceReadReplica

func (c *RDS) CreateDBInstanceReadReplica(input *CreateDBInstanceReadReplicaInput) (*CreateDBInstanceReadReplicaOutput, error)

CreateDBInstanceReadReplica API operation for Amazon Relational Database Service.

Creates a new DB instance that acts as a Read Replica for an existing source DB instance. You can create a Read Replica for a DB instance running MySQL, MariaDB, or PostgreSQL. For more information, see Working with PostgreSQL, MySQL, and MariaDB Read Replicas (https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ReadRepl.html) in the Amazon RDS User Guide.

Amazon Aurora doesn't support this action. You must call the CreateDBInstance action to create a DB instance for an Aurora DB cluster.

All Read Replica DB instances are created with backups disabled. All other DB instance attributes (including DB security groups and DB parameter groups) are inherited from the source DB instance, except as specified following.

Your source DB instance must have backup retention enabled.

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 Relational Database Service's API operation CreateDBInstanceReadReplica for usage and error information.

Returned Error Codes:

  • ErrCodeDBInstanceAlreadyExistsFault "DBInstanceAlreadyExists" The user already has a DB instance with the given identifier.

  • ErrCodeInsufficientDBInstanceCapacityFault "InsufficientDBInstanceCapacity" The specified DB instance class isn't available in the specified Availability Zone.

  • ErrCodeDBParameterGroupNotFoundFault "DBParameterGroupNotFound" DBParameterGroupName doesn't refer to an existing DB parameter group.

  • ErrCodeDBSecurityGroupNotFoundFault "DBSecurityGroupNotFound" DBSecurityGroupName doesn't refer to an existing DB security group.

  • ErrCodeInstanceQuotaExceededFault "InstanceQuotaExceeded" The request would result in the user exceeding the allowed number of DB instances.

  • ErrCodeStorageQuotaExceededFault "StorageQuotaExceeded" The request would result in the user exceeding the allowed amount of storage available across all DB instances.

  • ErrCodeDBInstanceNotFoundFault "DBInstanceNotFound" DBInstanceIdentifier doesn't refer to an existing DB instance.

  • ErrCodeInvalidDBInstanceStateFault "InvalidDBInstanceState" The DB instance isn't in a valid state.

  • ErrCodeDBSubnetGroupNotFoundFault "DBSubnetGroupNotFoundFault" DBSubnetGroupName doesn't refer to an existing DB subnet group.

  • ErrCodeDBSubnetGroupDoesNotCoverEnoughAZs "DBSubnetGroupDoesNotCoverEnoughAZs" Subnets in the DB subnet group should cover at least two Availability Zones unless there is only one Availability Zone.

  • ErrCodeInvalidSubnet "InvalidSubnet" The requested subnet is invalid, or multiple subnets were requested that are not all in a common VPC.

  • ErrCodeInvalidVPCNetworkStateFault "InvalidVPCNetworkStateFault" The DB subnet group doesn't cover all Availability Zones after it's created because of users' change.

  • ErrCodeProvisionedIopsNotAvailableInAZFault "ProvisionedIopsNotAvailableInAZFault" Provisioned IOPS not available in the specified Availability Zone.

  • ErrCodeOptionGroupNotFoundFault "OptionGroupNotFoundFault" The specified option group could not be found.

  • ErrCodeDBSubnetGroupNotAllowedFault "DBSubnetGroupNotAllowedFault" The DBSubnetGroup shouldn't be specified while creating read replicas that lie in the same region as the source instance.

  • ErrCodeInvalidDBSubnetGroupFault "InvalidDBSubnetGroupFault" The DBSubnetGroup doesn't belong to the same VPC as that of an existing cross-region read replica of the same source instance.

  • ErrCodeStorageTypeNotSupportedFault "StorageTypeNotSupported" Storage of the StorageType specified can't be associated with the DB instance.

  • ErrCodeKMSKeyNotAccessibleFault "KMSKeyNotAccessibleFault" An error occurred accessing an AWS KMS key.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateDBInstanceReadReplica

Example

RDS CreateDBInstanceReadReplica shared00

To create a DB instance read replica.

This example creates a DB instance read replica.

{ svc := rds.New(session.New()) input := &rds.CreateDBInstanceReadReplicaInput{ AvailabilityZone: aws.String("us-east-1a"), CopyTagsToSnapshot: aws.Bool(true), DBInstanceClass: aws.String("db.t2.micro"), DBInstanceIdentifier: aws.String("mydbreadreplica"), PubliclyAccessible: aws.Bool(true), SourceDBInstanceIdentifier: aws.String("mymysqlinstance"), StorageType: aws.String("gp2"), Tags: []*rds.Tag{ { Key: aws.String("mydbreadreplicakey"), Value: aws.String("mydbreadreplicavalue"), }, }, } result, err := svc.CreateDBInstanceReadReplica(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeDBInstanceAlreadyExistsFault: fmt.Println(rds.ErrCodeDBInstanceAlreadyExistsFault, aerr.Error()) case rds.ErrCodeInsufficientDBInstanceCapacityFault: fmt.Println(rds.ErrCodeInsufficientDBInstanceCapacityFault, aerr.Error()) case rds.ErrCodeDBParameterGroupNotFoundFault: fmt.Println(rds.ErrCodeDBParameterGroupNotFoundFault, aerr.Error()) case rds.ErrCodeDBSecurityGroupNotFoundFault: fmt.Println(rds.ErrCodeDBSecurityGroupNotFoundFault, aerr.Error()) case rds.ErrCodeInstanceQuotaExceededFault: fmt.Println(rds.ErrCodeInstanceQuotaExceededFault, aerr.Error()) case rds.ErrCodeStorageQuotaExceededFault: fmt.Println(rds.ErrCodeStorageQuotaExceededFault, aerr.Error()) case rds.ErrCodeDBInstanceNotFoundFault: fmt.Println(rds.ErrCodeDBInstanceNotFoundFault, aerr.Error()) case rds.ErrCodeInvalidDBInstanceStateFault: fmt.Println(rds.ErrCodeInvalidDBInstanceStateFault, aerr.Error()) case rds.ErrCodeDBSubnetGroupNotFoundFault: fmt.Println(rds.ErrCodeDBSubnetGroupNotFoundFault, aerr.Error()) case rds.ErrCodeDBSubnetGroupDoesNotCoverEnoughAZs: fmt.Println(rds.ErrCodeDBSubnetGroupDoesNotCoverEnoughAZs, aerr.Error()) case rds.ErrCodeInvalidSubnet: fmt.Println(rds.ErrCodeInvalidSubnet, aerr.Error()) case rds.ErrCodeInvalidVPCNetworkStateFault: fmt.Println(rds.ErrCodeInvalidVPCNetworkStateFault, aerr.Error()) case rds.ErrCodeProvisionedIopsNotAvailableInAZFault: fmt.Println(rds.ErrCodeProvisionedIopsNotAvailableInAZFault, aerr.Error()) case rds.ErrCodeOptionGroupNotFoundFault: fmt.Println(rds.ErrCodeOptionGroupNotFoundFault, aerr.Error()) case rds.ErrCodeDBSubnetGroupNotAllowedFault: fmt.Println(rds.ErrCodeDBSubnetGroupNotAllowedFault, aerr.Error()) case rds.ErrCodeInvalidDBSubnetGroupFault: fmt.Println(rds.ErrCodeInvalidDBSubnetGroupFault, aerr.Error()) case rds.ErrCodeStorageTypeNotSupportedFault: fmt.Println(rds.ErrCodeStorageTypeNotSupportedFault, aerr.Error()) case rds.ErrCodeKMSKeyNotAccessibleFault: fmt.Println(rds.ErrCodeKMSKeyNotAccessibleFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

CreateDBInstanceReadReplicaRequest

func (c *RDS) CreateDBInstanceReadReplicaRequest(input *CreateDBInstanceReadReplicaInput) (req *request.Request, output *CreateDBInstanceReadReplicaOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateDBInstanceReadReplica

CreateDBInstanceReadReplicaWithContext

func (c *RDS) CreateDBInstanceReadReplicaWithContext(ctx aws.Context, input *CreateDBInstanceReadReplicaInput, opts ...request.Option) (*CreateDBInstanceReadReplicaOutput, error)

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

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

CreateDBInstanceRequest

func (c *RDS) CreateDBInstanceRequest(input *CreateDBInstanceInput) (req *request.Request, output *CreateDBInstanceOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateDBInstance

CreateDBInstanceWithContext

func (c *RDS) CreateDBInstanceWithContext(ctx aws.Context, input *CreateDBInstanceInput, opts ...request.Option) (*CreateDBInstanceOutput, error)

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

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

CreateDBParameterGroup

func (c *RDS) CreateDBParameterGroup(input *CreateDBParameterGroupInput) (*CreateDBParameterGroupOutput, error)

CreateDBParameterGroup API operation for Amazon Relational Database Service.

Creates a new DB parameter group.

A DB parameter group is initially created with the default parameters for the database engine used by the DB instance. To provide custom values for any of the parameters, you must modify the group after creating it using ModifyDBParameterGroup. Once you've created a DB parameter group, you need to associate it with your DB instance using ModifyDBInstance. When you associate a new DB parameter group with a running DB instance, you need to reboot the DB instance without failover for the new DB parameter group and associated settings to take effect.

After you create a DB parameter group, you should wait at least 5 minutes before creating your first DB instance that uses that DB parameter group as the default parameter group. This allows Amazon RDS to fully complete the create action before the parameter group is used as the default for a new DB instance. This is especially important for parameters that are critical when creating the default database for a DB instance, such as the character set for the default database defined by the character_set_database parameter. You can use the Parameter Groups option of the Amazon RDS console (https://console.aws.amazon.com/rds/) or the DescribeDBParameters command to verify that your DB parameter group has been created or modified.

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 Relational Database Service's API operation CreateDBParameterGroup for usage and error information.

Returned Error Codes:

  • ErrCodeDBParameterGroupQuotaExceededFault "DBParameterGroupQuotaExceeded" The request would result in the user exceeding the allowed number of DB parameter groups.

  • ErrCodeDBParameterGroupAlreadyExistsFault "DBParameterGroupAlreadyExists" A DB parameter group with the same name exists.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateDBParameterGroup

Example

RDS CreateDBParameterGroup shared00

To create a DB parameter group.

This example creates a DB parameter group.

{ svc := rds.New(session.New()) input := &rds.CreateDBParameterGroupInput{ DBParameterGroupFamily: aws.String("mysql5.6"), DBParameterGroupName: aws.String("mymysqlparametergroup"), Description: aws.String("My MySQL parameter group"), } result, err := svc.CreateDBParameterGroup(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeDBParameterGroupQuotaExceededFault: fmt.Println(rds.ErrCodeDBParameterGroupQuotaExceededFault, aerr.Error()) case rds.ErrCodeDBParameterGroupAlreadyExistsFault: fmt.Println(rds.ErrCodeDBParameterGroupAlreadyExistsFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

CreateDBParameterGroupRequest

func (c *RDS) CreateDBParameterGroupRequest(input *CreateDBParameterGroupInput) (req *request.Request, output *CreateDBParameterGroupOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateDBParameterGroup

CreateDBParameterGroupWithContext

func (c *RDS) CreateDBParameterGroupWithContext(ctx aws.Context, input *CreateDBParameterGroupInput, opts ...request.Option) (*CreateDBParameterGroupOutput, error)

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

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

CreateDBSecurityGroup

func (c *RDS) CreateDBSecurityGroup(input *CreateDBSecurityGroupInput) (*CreateDBSecurityGroupOutput, error)

CreateDBSecurityGroup API operation for Amazon Relational Database Service.

Creates a new DB security group. DB security groups control access to a DB instance.

A DB security group controls access to EC2-Classic DB instances that are not in a 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 Relational Database Service's API operation CreateDBSecurityGroup for usage and error information.

Returned Error Codes:

  • ErrCodeDBSecurityGroupAlreadyExistsFault "DBSecurityGroupAlreadyExists" A DB security group with the name specified in DBSecurityGroupName already exists.

  • ErrCodeDBSecurityGroupQuotaExceededFault "QuotaExceeded.DBSecurityGroup" The request would result in the user exceeding the allowed number of DB security groups.

  • ErrCodeDBSecurityGroupNotSupportedFault "DBSecurityGroupNotSupported" A DB security group isn't allowed for this action.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateDBSecurityGroup

Example

RDS CreateDBSecurityGroup shared00

To create a DB security group.

This example creates a DB security group.

{ svc := rds.New(session.New()) input := &rds.CreateDBSecurityGroupInput{ DBSecurityGroupDescription: aws.String("My DB security group"), DBSecurityGroupName: aws.String("mydbsecuritygroup"), } result, err := svc.CreateDBSecurityGroup(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeDBSecurityGroupAlreadyExistsFault: fmt.Println(rds.ErrCodeDBSecurityGroupAlreadyExistsFault, aerr.Error()) case rds.ErrCodeDBSecurityGroupQuotaExceededFault: fmt.Println(rds.ErrCodeDBSecurityGroupQuotaExceededFault, aerr.Error()) case rds.ErrCodeDBSecurityGroupNotSupportedFault: fmt.Println(rds.ErrCodeDBSecurityGroupNotSupportedFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

CreateDBSecurityGroupRequest

func (c *RDS) CreateDBSecurityGroupRequest(input *CreateDBSecurityGroupInput) (req *request.Request, output *CreateDBSecurityGroupOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateDBSecurityGroup

CreateDBSecurityGroupWithContext

func (c *RDS) CreateDBSecurityGroupWithContext(ctx aws.Context, input *CreateDBSecurityGroupInput, opts ...request.Option) (*CreateDBSecurityGroupOutput, error)

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

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

CreateDBSnapshot

func (c *RDS) CreateDBSnapshot(input *CreateDBSnapshotInput) (*CreateDBSnapshotOutput, error)

CreateDBSnapshot API operation for Amazon Relational Database Service.

Creates a DBSnapshot. The source DBInstance must be in "available" state.

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 Relational Database Service's API operation CreateDBSnapshot for usage and error information.

Returned Error Codes:

  • ErrCodeDBSnapshotAlreadyExistsFault "DBSnapshotAlreadyExists" DBSnapshotIdentifier is already used by an existing snapshot.

  • ErrCodeInvalidDBInstanceStateFault "InvalidDBInstanceState" The DB instance isn't in a valid state.

  • ErrCodeDBInstanceNotFoundFault "DBInstanceNotFound" DBInstanceIdentifier doesn't refer to an existing DB instance.

  • ErrCodeSnapshotQuotaExceededFault "SnapshotQuotaExceeded" The request would result in the user exceeding the allowed number of DB snapshots.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateDBSnapshot

Example

RDS CreateDBSnapshot shared00

To create a DB snapshot.

This example creates a DB snapshot.

{ svc := rds.New(session.New()) input := &rds.CreateDBSnapshotInput{ DBInstanceIdentifier: aws.String("mymysqlinstance"), DBSnapshotIdentifier: aws.String("mydbsnapshot"), } result, err := svc.CreateDBSnapshot(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeDBSnapshotAlreadyExistsFault: fmt.Println(rds.ErrCodeDBSnapshotAlreadyExistsFault, aerr.Error()) case rds.ErrCodeInvalidDBInstanceStateFault: fmt.Println(rds.ErrCodeInvalidDBInstanceStateFault, aerr.Error()) case rds.ErrCodeDBInstanceNotFoundFault: fmt.Println(rds.ErrCodeDBInstanceNotFoundFault, aerr.Error()) case rds.ErrCodeSnapshotQuotaExceededFault: fmt.Println(rds.ErrCodeSnapshotQuotaExceededFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

CreateDBSnapshotRequest

func (c *RDS) CreateDBSnapshotRequest(input *CreateDBSnapshotInput) (req *request.Request, output *CreateDBSnapshotOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateDBSnapshot

CreateDBSnapshotWithContext

func (c *RDS) CreateDBSnapshotWithContext(ctx aws.Context, input *CreateDBSnapshotInput, opts ...request.Option) (*CreateDBSnapshotOutput, error)

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

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

CreateDBSubnetGroup

func (c *RDS) CreateDBSubnetGroup(input *CreateDBSubnetGroupInput) (*CreateDBSubnetGroupOutput, error)

CreateDBSubnetGroup API operation for Amazon Relational Database Service.

Creates a new DB subnet group. DB subnet groups must contain at least one subnet in at least two AZs in the AWS Region.

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 Relational Database Service's API operation CreateDBSubnetGroup for usage and error information.

Returned Error Codes:

  • ErrCodeDBSubnetGroupAlreadyExistsFault "DBSubnetGroupAlreadyExists" DBSubnetGroupName is already used by an existing DB subnet group.

  • ErrCodeDBSubnetGroupQuotaExceededFault "DBSubnetGroupQuotaExceeded" The request would result in the user exceeding the allowed number of DB subnet groups.

  • ErrCodeDBSubnetQuotaExceededFault "DBSubnetQuotaExceededFault" The request would result in the user exceeding the allowed number of subnets in a DB subnet groups.

  • ErrCodeDBSubnetGroupDoesNotCoverEnoughAZs "DBSubnetGroupDoesNotCoverEnoughAZs" Subnets in the DB subnet group should cover at least two Availability Zones unless there is only one Availability Zone.

  • ErrCodeInvalidSubnet "InvalidSubnet" The requested subnet is invalid, or multiple subnets were requested that are not all in a common VPC.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateDBSubnetGroup

Example

RDS CreateDBSubnetGroup shared00

To create a DB subnet group.

This example creates a DB subnet group.

{ svc := rds.New(session.New()) input := &rds.CreateDBSubnetGroupInput{ DBSubnetGroupDescription: aws.String("My DB subnet group"), DBSubnetGroupName: aws.String("mydbsubnetgroup"), SubnetIds: []*string{ aws.String("subnet-1fab8a69"), aws.String("subnet-d43a468c"), }, } result, err := svc.CreateDBSubnetGroup(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeDBSubnetGroupAlreadyExistsFault: fmt.Println(rds.ErrCodeDBSubnetGroupAlreadyExistsFault, aerr.Error()) case rds.ErrCodeDBSubnetGroupQuotaExceededFault: fmt.Println(rds.ErrCodeDBSubnetGroupQuotaExceededFault, aerr.Error()) case rds.ErrCodeDBSubnetQuotaExceededFault: fmt.Println(rds.ErrCodeDBSubnetQuotaExceededFault, aerr.Error()) case rds.ErrCodeDBSubnetGroupDoesNotCoverEnoughAZs: fmt.Println(rds.ErrCodeDBSubnetGroupDoesNotCoverEnoughAZs, aerr.Error()) case rds.ErrCodeInvalidSubnet: fmt.Println(rds.ErrCodeInvalidSubnet, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

CreateDBSubnetGroupRequest

func (c *RDS) CreateDBSubnetGroupRequest(input *CreateDBSubnetGroupInput) (req *request.Request, output *CreateDBSubnetGroupOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateDBSubnetGroup

CreateDBSubnetGroupWithContext

func (c *RDS) CreateDBSubnetGroupWithContext(ctx aws.Context, input *CreateDBSubnetGroupInput, opts ...request.Option) (*CreateDBSubnetGroupOutput, error)

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

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

CreateEventSubscription

func (c *RDS) CreateEventSubscription(input *CreateEventSubscriptionInput) (*CreateEventSubscriptionOutput, error)

CreateEventSubscription API operation for Amazon Relational Database Service.

Creates an RDS event notification subscription. This action requires a topic ARN (Amazon Resource Name) created by either the RDS console, the SNS console, or the SNS API. To obtain an ARN with SNS, you must create a topic in Amazon SNS and subscribe to the topic. The ARN is displayed in the SNS console.

You can specify the type of source (SourceType) you want to be notified of, provide a list of RDS sources (SourceIds) that triggers the events, and provide a list of event categories (EventCategories) for events you want to be notified of. For example, you can specify SourceType = db-instance, SourceIds = mydbinstance1, mydbinstance2 and EventCategories = Availability, Backup.

If you specify both the SourceType and SourceIds, such as SourceType = db-instance and SourceIdentifier = myDBInstance1, you are notified of all the db-instance events for the specified source. If you specify a SourceType but do not specify a SourceIdentifier, you receive notice of the events for that source type for all your RDS sources. If you do not specify either the SourceType nor the SourceIdentifier, you are notified of events generated from all RDS sources belonging to your customer 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 Relational Database Service's API operation CreateEventSubscription for usage and error information.

Returned Error Codes:

  • ErrCodeEventSubscriptionQuotaExceededFault "EventSubscriptionQuotaExceeded" You have reached the maximum number of event subscriptions.

  • ErrCodeSubscriptionAlreadyExistFault "SubscriptionAlreadyExist" The supplied subscription name already exists.

  • ErrCodeSNSInvalidTopicFault "SNSInvalidTopic" SNS has responded that there is a problem with the SND topic specified.

  • ErrCodeSNSNoAuthorizationFault "SNSNoAuthorization" You do not have permission to publish to the SNS topic ARN.

  • ErrCodeSNSTopicArnNotFoundFault "SNSTopicArnNotFound" The SNS topic ARN does not exist.

  • ErrCodeSubscriptionCategoryNotFoundFault "SubscriptionCategoryNotFound" The supplied category does not exist.

  • ErrCodeSourceNotFoundFault "SourceNotFound" The requested source could not be found.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateEventSubscription

Example

RDS CreateEventSubscription shared00

To create an event notification subscription

This example creates an event notification subscription.

{ svc := rds.New(session.New()) input := &rds.CreateEventSubscriptionInput{ Enabled: aws.Bool(true), EventCategories: []*string{ aws.String("availability"), }, SnsTopicArn: aws.String("arn:aws:sns:us-east-1:992648334831:MyDemoSNSTopic"), SourceIds: []*string{ aws.String("mymysqlinstance"), }, SourceType: aws.String("db-instance"), SubscriptionName: aws.String("mymysqleventsubscription"), } result, err := svc.CreateEventSubscription(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeEventSubscriptionQuotaExceededFault: fmt.Println(rds.ErrCodeEventSubscriptionQuotaExceededFault, aerr.Error()) case rds.ErrCodeSubscriptionAlreadyExistFault: fmt.Println(rds.ErrCodeSubscriptionAlreadyExistFault, aerr.Error()) case rds.ErrCodeSNSInvalidTopicFault: fmt.Println(rds.ErrCodeSNSInvalidTopicFault, aerr.Error()) case rds.ErrCodeSNSNoAuthorizationFault: fmt.Println(rds.ErrCodeSNSNoAuthorizationFault, aerr.Error()) case rds.ErrCodeSNSTopicArnNotFoundFault: fmt.Println(rds.ErrCodeSNSTopicArnNotFoundFault, aerr.Error()) case rds.ErrCodeSubscriptionCategoryNotFoundFault: fmt.Println(rds.ErrCodeSubscriptionCategoryNotFoundFault, aerr.Error()) case rds.ErrCodeSourceNotFoundFault: fmt.Println(rds.ErrCodeSourceNotFoundFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

CreateEventSubscriptionRequest

func (c *RDS) CreateEventSubscriptionRequest(input *CreateEventSubscriptionInput) (req *request.Request, output *CreateEventSubscriptionOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateEventSubscription

CreateEventSubscriptionWithContext

func (c *RDS) CreateEventSubscriptionWithContext(ctx aws.Context, input *CreateEventSubscriptionInput, opts ...request.Option) (*CreateEventSubscriptionOutput, error)

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

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

CreateGlobalCluster

func (c *RDS) CreateGlobalCluster(input *CreateGlobalClusterInput) (*CreateGlobalClusterOutput, error)

CreateGlobalCluster API operation for Amazon Relational Database Service.

Creates an Aurora global database spread across multiple regions. The global database contains a single primary cluster with read-write capability, and a read-only secondary cluster that receives data from the primary cluster through high-speed replication performed by the Aurora storage subsystem.

You can create a global database that is initially empty, and then add a primary cluster and a secondary cluster to it. Or you can specify an existing Aurora cluster during the create operation, and this cluster becomes the primary cluster of the global database.

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 Relational Database Service's API operation CreateGlobalCluster for usage and error information.

Returned Error Codes:

  • ErrCodeGlobalClusterAlreadyExistsFault "GlobalClusterAlreadyExistsFault"

  • ErrCodeGlobalClusterQuotaExceededFault "GlobalClusterQuotaExceededFault"

  • ErrCodeInvalidDBClusterStateFault "InvalidDBClusterStateFault" The requested operation can't be performed while the cluster is in this state.

  • ErrCodeDBClusterNotFoundFault "DBClusterNotFoundFault" DBClusterIdentifier doesn't refer to an existing DB cluster.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateGlobalCluster

CreateGlobalClusterRequest

func (c *RDS) CreateGlobalClusterRequest(input *CreateGlobalClusterInput) (req *request.Request, output *CreateGlobalClusterOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateGlobalCluster

CreateGlobalClusterWithContext

func (c *RDS) CreateGlobalClusterWithContext(ctx aws.Context, input *CreateGlobalClusterInput, opts ...request.Option) (*CreateGlobalClusterOutput, error)

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

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

CreateOptionGroup

func (c *RDS) CreateOptionGroup(input *CreateOptionGroupInput) (*CreateOptionGroupOutput, error)

CreateOptionGroup API operation for Amazon Relational Database Service.

Creates a new option group. You can create up to 20 option groups.

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 Relational Database Service's API operation CreateOptionGroup for usage and error information.

Returned Error Codes:

  • ErrCodeOptionGroupAlreadyExistsFault "OptionGroupAlreadyExistsFault" The option group you are trying to create already exists.

  • ErrCodeOptionGroupQuotaExceededFault "OptionGroupQuotaExceededFault" The quota of 20 option groups was exceeded for this AWS account.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateOptionGroup

Example

RDS CreateOptionGroup shared00

To create an option group

This example creates an option group.

{ svc := rds.New(session.New()) input := &rds.CreateOptionGroupInput{ EngineName: aws.String("MySQL"), MajorEngineVersion: aws.String("5.6"), OptionGroupDescription: aws.String("My MySQL 5.6 option group"), OptionGroupName: aws.String("mymysqloptiongroup"), } result, err := svc.CreateOptionGroup(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeOptionGroupAlreadyExistsFault: fmt.Println(rds.ErrCodeOptionGroupAlreadyExistsFault, aerr.Error()) case rds.ErrCodeOptionGroupQuotaExceededFault: fmt.Println(rds.ErrCodeOptionGroupQuotaExceededFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

CreateOptionGroupRequest

func (c *RDS) CreateOptionGroupRequest(input *CreateOptionGroupInput) (req *request.Request, output *CreateOptionGroupOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateOptionGroup

CreateOptionGroupWithContext

func (c *RDS) CreateOptionGroupWithContext(ctx aws.Context, input *CreateOptionGroupInput, opts ...request.Option) (*CreateOptionGroupOutput, error)

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

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

DeleteDBCluster

func (c *RDS) DeleteDBCluster(input *DeleteDBClusterInput) (*DeleteDBClusterOutput, error)

DeleteDBCluster API operation for Amazon Relational Database Service.

The DeleteDBCluster action deletes a previously provisioned DB cluster. When you delete a DB cluster, all automated backups for that DB cluster are deleted and can't be recovered. Manual DB cluster snapshots of the specified DB cluster are not deleted.

For more information on Amazon Aurora, see What Is Amazon Aurora? (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html)in the Amazon Aurora 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 Relational Database Service's API operation DeleteDBCluster for usage and error information.

Returned Error Codes:

  • ErrCodeDBClusterNotFoundFault "DBClusterNotFoundFault" DBClusterIdentifier doesn't refer to an existing DB cluster.

  • ErrCodeInvalidDBClusterStateFault "InvalidDBClusterStateFault" The requested operation can't be performed while the cluster is in this state.

  • ErrCodeDBClusterSnapshotAlreadyExistsFault "DBClusterSnapshotAlreadyExistsFault" The user already has a DB cluster snapshot with the given identifier.

  • ErrCodeSnapshotQuotaExceededFault "SnapshotQuotaExceeded" The request would result in the user exceeding the allowed number of DB snapshots.

  • ErrCodeInvalidDBClusterSnapshotStateFault "InvalidDBClusterSnapshotStateFault" The supplied value isn't a valid DB cluster snapshot state.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DeleteDBCluster

Example

RDS DeleteDBCluster shared00

To delete a DB cluster.

This example deletes the specified DB cluster.

{ svc := rds.New(session.New()) input := &rds.DeleteDBClusterInput{ DBClusterIdentifier: aws.String("mydbcluster"), SkipFinalSnapshot: aws.Bool(true), } result, err := svc.DeleteDBCluster(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeDBClusterNotFoundFault: fmt.Println(rds.ErrCodeDBClusterNotFoundFault, aerr.Error()) case rds.ErrCodeInvalidDBClusterStateFault: fmt.Println(rds.ErrCodeInvalidDBClusterStateFault, aerr.Error()) case rds.ErrCodeDBClusterSnapshotAlreadyExistsFault: fmt.Println(rds.ErrCodeDBClusterSnapshotAlreadyExistsFault, aerr.Error()) case rds.ErrCodeSnapshotQuotaExceededFault: fmt.Println(rds.ErrCodeSnapshotQuotaExceededFault, aerr.Error()) case rds.ErrCodeInvalidDBClusterSnapshotStateFault: fmt.Println(rds.ErrCodeInvalidDBClusterSnapshotStateFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

DeleteDBClusterEndpoint

func (c *RDS) DeleteDBClusterEndpoint(input *DeleteDBClusterEndpointInput) (*DeleteDBClusterEndpointOutput, error)

DeleteDBClusterEndpoint API operation for Amazon Relational Database Service.

Deletes a custom endpoint and removes it from an Amazon Aurora DB cluster.

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 Relational Database Service's API operation DeleteDBClusterEndpoint for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidDBClusterEndpointStateFault "InvalidDBClusterEndpointStateFault" The requested operation can't be performed on the endpoint while the endpoint is in this state.

  • ErrCodeDBClusterEndpointNotFoundFault "DBClusterEndpointNotFoundFault" The specified custom endpoint doesn't exist.

  • ErrCodeInvalidDBClusterStateFault "InvalidDBClusterStateFault" The requested operation can't be performed while the cluster is in this state.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DeleteDBClusterEndpoint

DeleteDBClusterEndpointRequest

func (c *RDS) DeleteDBClusterEndpointRequest(input *DeleteDBClusterEndpointInput) (req *request.Request, output *DeleteDBClusterEndpointOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DeleteDBClusterEndpoint

DeleteDBClusterEndpointWithContext

func (c *RDS) DeleteDBClusterEndpointWithContext(ctx aws.Context, input *DeleteDBClusterEndpointInput, opts ...request.Option) (*DeleteDBClusterEndpointOutput, error)

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

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

DeleteDBClusterParameterGroup

func (c *RDS) DeleteDBClusterParameterGroup(input *DeleteDBClusterParameterGroupInput) (*DeleteDBClusterParameterGroupOutput, error)

DeleteDBClusterParameterGroup API operation for Amazon Relational Database Service.

Deletes a specified DB cluster parameter group. The DB cluster parameter group to be deleted can't be associated with any DB clusters.

For more information on Amazon Aurora, see What Is Amazon Aurora? (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html) in the Amazon Aurora 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 Relational Database Service's API operation DeleteDBClusterParameterGroup for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidDBParameterGroupStateFault "InvalidDBParameterGroupState" The DB parameter group is in use or is in an invalid state. If you are attempting to delete the parameter group, you can't delete it when the parameter group is in this state.

  • ErrCodeDBParameterGroupNotFoundFault "DBParameterGroupNotFound" DBParameterGroupName doesn't refer to an existing DB parameter group.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DeleteDBClusterParameterGroup

Example

RDS DeleteDBClusterParameterGroup shared00

To delete a DB cluster parameter group.

This example deletes the specified DB cluster parameter group.

{ svc := rds.New(session.New()) input := &rds.DeleteDBClusterParameterGroupInput{ DBClusterParameterGroupName: aws.String("mydbclusterparametergroup"), } result, err := svc.DeleteDBClusterParameterGroup(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeInvalidDBParameterGroupStateFault: fmt.Println(rds.ErrCodeInvalidDBParameterGroupStateFault, aerr.Error()) case rds.ErrCodeDBParameterGroupNotFoundFault: fmt.Println(rds.ErrCodeDBParameterGroupNotFoundFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

DeleteDBClusterParameterGroupRequest

func (c *RDS) DeleteDBClusterParameterGroupRequest(input *DeleteDBClusterParameterGroupInput) (req *request.Request, output *DeleteDBClusterParameterGroupOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DeleteDBClusterParameterGroup

DeleteDBClusterParameterGroupWithContext

func (c *RDS) DeleteDBClusterParameterGroupWithContext(ctx aws.Context, input *DeleteDBClusterParameterGroupInput, opts ...request.Option) (*DeleteDBClusterParameterGroupOutput, error)

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

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

DeleteDBClusterRequest

func (c *RDS) DeleteDBClusterRequest(input *DeleteDBClusterInput) (req *request.Request, output *DeleteDBClusterOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DeleteDBCluster

DeleteDBClusterSnapshot

func (c *RDS) DeleteDBClusterSnapshot(input *DeleteDBClusterSnapshotInput) (*DeleteDBClusterSnapshotOutput, error)

DeleteDBClusterSnapshot API operation for Amazon Relational Database Service.

Deletes a DB cluster snapshot. If the snapshot is being copied, the copy operation is terminated.

The DB cluster snapshot must be in the available state to be deleted.

For more information on Amazon Aurora, see What Is Amazon Aurora? (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html) in the Amazon Aurora 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 Relational Database Service's API operation DeleteDBClusterSnapshot for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidDBClusterSnapshotStateFault "InvalidDBClusterSnapshotStateFault" The supplied value isn't a valid DB cluster snapshot state.

  • ErrCodeDBClusterSnapshotNotFoundFault "DBClusterSnapshotNotFoundFault" DBClusterSnapshotIdentifier doesn't refer to an existing DB cluster snapshot.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DeleteDBClusterSnapshot

Example

RDS DeleteDBClusterSnapshot shared00

To delete a DB cluster snapshot.

This example deletes the specified DB cluster snapshot.

{ svc := rds.New(session.New()) input := &rds.DeleteDBClusterSnapshotInput{ DBClusterSnapshotIdentifier: aws.String("mydbclustersnapshot"), } result, err := svc.DeleteDBClusterSnapshot(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeInvalidDBClusterSnapshotStateFault: fmt.Println(rds.ErrCodeInvalidDBClusterSnapshotStateFault, aerr.Error()) case rds.ErrCodeDBClusterSnapshotNotFoundFault: fmt.Println(rds.ErrCodeDBClusterSnapshotNotFoundFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

DeleteDBClusterSnapshotRequest

func (c *RDS) DeleteDBClusterSnapshotRequest(input *DeleteDBClusterSnapshotInput) (req *request.Request, output *DeleteDBClusterSnapshotOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DeleteDBClusterSnapshot

DeleteDBClusterSnapshotWithContext

func (c *RDS) DeleteDBClusterSnapshotWithContext(ctx aws.Context, input *DeleteDBClusterSnapshotInput, opts ...request.Option) (*DeleteDBClusterSnapshotOutput, error)

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

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

DeleteDBClusterWithContext

func (c *RDS) DeleteDBClusterWithContext(ctx aws.Context, input *DeleteDBClusterInput, opts ...request.Option) (*DeleteDBClusterOutput, error)

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

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

DeleteDBInstance

func (c *RDS) DeleteDBInstance(input *DeleteDBInstanceInput) (*DeleteDBInstanceOutput, error)

DeleteDBInstance API operation for Amazon Relational Database Service.

The DeleteDBInstance action deletes a previously provisioned DB instance. When you delete a DB instance, all automated backups for that instance are deleted and can't be recovered. Manual DB snapshots of the DB instance to be deleted by DeleteDBInstance are not deleted.

If you request a final DB snapshot the status of the Amazon RDS DB instance is deleting until the DB snapshot is created. The API action DescribeDBInstance is used to monitor the status of this operation. The action can't be canceled or reverted once submitted.

Note that when a DB instance is in a failure state and has a status of failed, incompatible-restore, or incompatible-network, you can only delete it when the SkipFinalSnapshot parameter is set to true.

If the specified DB instance is part of an Amazon Aurora DB cluster, you can't delete the DB instance if both of the following conditions are true:

  • The DB cluster is a Read Replica of another Amazon Aurora DB cluster.

  • The DB instance is the only instance in the DB cluster.

To delete a DB instance in this case, first call the PromoteReadReplicaDBCluster API action to promote the DB cluster so it's no longer a Read Replica. After the promotion completes, then call the DeleteDBInstance API action to delete the final instance in the DB cluster.

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 Relational Database Service's API operation DeleteDBInstance for usage and error information.

Returned Error Codes:

  • ErrCodeDBInstanceNotFoundFault "DBInstanceNotFound" DBInstanceIdentifier doesn't refer to an existing DB instance.

  • ErrCodeInvalidDBInstanceStateFault "InvalidDBInstanceState" The DB instance isn't in a valid state.

  • ErrCodeDBSnapshotAlreadyExistsFault "DBSnapshotAlreadyExists" DBSnapshotIdentifier is already used by an existing snapshot.

  • ErrCodeSnapshotQuotaExceededFault "SnapshotQuotaExceeded" The request would result in the user exceeding the allowed number of DB snapshots.

  • ErrCodeInvalidDBClusterStateFault "InvalidDBClusterStateFault" The requested operation can't be performed while the cluster is in this state.

  • ErrCodeDBInstanceAutomatedBackupQuotaExceededFault "DBInstanceAutomatedBackupQuotaExceeded" The quota for retained automated backups was exceeded. This prevents you from retaining any additional automated backups. The retained automated backups quota is the same as your DB Instance quota.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DeleteDBInstance

Example

RDS DeleteDBInstance shared00

To delete a DB instance.

This example deletes the specified DB instance.

{ svc := rds.New(session.New()) input := &rds.DeleteDBInstanceInput{ DBInstanceIdentifier: aws.String("mymysqlinstance"), SkipFinalSnapshot: aws.Bool(true), } result, err := svc.DeleteDBInstance(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeDBInstanceNotFoundFault: fmt.Println(rds.ErrCodeDBInstanceNotFoundFault, aerr.Error()) case rds.ErrCodeInvalidDBInstanceStateFault: fmt.Println(rds.ErrCodeInvalidDBInstanceStateFault, aerr.Error()) case rds.ErrCodeDBSnapshotAlreadyExistsFault: fmt.Println(rds.ErrCodeDBSnapshotAlreadyExistsFault, aerr.Error()) case rds.ErrCodeSnapshotQuotaExceededFault: fmt.Println(rds.ErrCodeSnapshotQuotaExceededFault, aerr.Error()) case rds.ErrCodeInvalidDBClusterStateFault: fmt.Println(rds.ErrCodeInvalidDBClusterStateFault, aerr.Error()) case rds.ErrCodeDBInstanceAutomatedBackupQuotaExceededFault: fmt.Println(rds.ErrCodeDBInstanceAutomatedBackupQuotaExceededFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

DeleteDBInstanceAutomatedBackup

func (c *RDS) DeleteDBInstanceAutomatedBackup(input *DeleteDBInstanceAutomatedBackupInput) (*DeleteDBInstanceAutomatedBackupOutput, error)

DeleteDBInstanceAutomatedBackup API operation for Amazon Relational Database Service.

Deletes automated backups based on the source instance's DbiResourceId value or the restorable instance's resource ID.

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 Relational Database Service's API operation DeleteDBInstanceAutomatedBackup for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidDBInstanceAutomatedBackupStateFault "InvalidDBInstanceAutomatedBackupState" The automated backup is in an invalid state. For example, this automated backup is associated with an active instance.

  • ErrCodeDBInstanceAutomatedBackupNotFoundFault "DBInstanceAutomatedBackupNotFound" No automated backup for this DB instance was found.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DeleteDBInstanceAutomatedBackup

DeleteDBInstanceAutomatedBackupRequest

func (c *RDS) DeleteDBInstanceAutomatedBackupRequest(input *DeleteDBInstanceAutomatedBackupInput) (req *request.Request, output *DeleteDBInstanceAutomatedBackupOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DeleteDBInstanceAutomatedBackup

DeleteDBInstanceAutomatedBackupWithContext

func (c *RDS) DeleteDBInstanceAutomatedBackupWithContext(ctx aws.Context, input *DeleteDBInstanceAutomatedBackupInput, opts ...request.Option) (*DeleteDBInstanceAutomatedBackupOutput, error)

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

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

DeleteDBInstanceRequest

func (c *RDS) DeleteDBInstanceRequest(input *DeleteDBInstanceInput) (req *request.Request, output *DeleteDBInstanceOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DeleteDBInstance

DeleteDBInstanceWithContext

func (c *RDS) DeleteDBInstanceWithContext(ctx aws.Context, input *DeleteDBInstanceInput, opts ...request.Option) (*DeleteDBInstanceOutput, error)

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

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

DeleteDBParameterGroup

func (c *RDS) DeleteDBParameterGroup(input *DeleteDBParameterGroupInput) (*DeleteDBParameterGroupOutput, error)

DeleteDBParameterGroup API operation for Amazon Relational Database Service.

Deletes a specified DB parameter group. The DB parameter group to be deleted can't be associated with any DB instances.

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 Relational Database Service's API operation DeleteDBParameterGroup for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidDBParameterGroupStateFault "InvalidDBParameterGroupState" The DB parameter group is in use or is in an invalid state. If you are attempting to delete the parameter group, you can't delete it when the parameter group is in this state.

  • ErrCodeDBParameterGroupNotFoundFault "DBParameterGroupNotFound" DBParameterGroupName doesn't refer to an existing DB parameter group.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DeleteDBParameterGroup

Example

RDS DeleteDBParameterGroup shared00

To delete a DB parameter group

The following example deletes a DB parameter group.

{ svc := rds.New(session.New()) input := &rds.DeleteDBParameterGroupInput{ DBParameterGroupName: aws.String("mydbparamgroup3"), } result, err := svc.DeleteDBParameterGroup(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeInvalidDBParameterGroupStateFault: fmt.Println(rds.ErrCodeInvalidDBParameterGroupStateFault, aerr.Error()) case rds.ErrCodeDBParameterGroupNotFoundFault: fmt.Println(rds.ErrCodeDBParameterGroupNotFoundFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

DeleteDBParameterGroupRequest

func (c *RDS) DeleteDBParameterGroupRequest(input *DeleteDBParameterGroupInput) (req *request.Request, output *DeleteDBParameterGroupOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DeleteDBParameterGroup

DeleteDBParameterGroupWithContext

func (c *RDS) DeleteDBParameterGroupWithContext(ctx aws.Context, input *DeleteDBParameterGroupInput, opts ...request.Option) (*DeleteDBParameterGroupOutput, error)

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

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

DeleteDBSecurityGroup

func (c *RDS) DeleteDBSecurityGroup(input *DeleteDBSecurityGroupInput) (*DeleteDBSecurityGroupOutput, error)

DeleteDBSecurityGroup API operation for Amazon Relational Database Service.

Deletes a DB security group.

The specified DB security group must not be associated with any DB instances.

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 Relational Database Service's API operation DeleteDBSecurityGroup for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidDBSecurityGroupStateFault "InvalidDBSecurityGroupState" The state of the DB security group doesn't allow deletion.

  • ErrCodeDBSecurityGroupNotFoundFault "DBSecurityGroupNotFound" DBSecurityGroupName doesn't refer to an existing DB security group.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DeleteDBSecurityGroup

Example

RDS DeleteDBSecurityGroup shared00

To delete a DB security group

The following example deletes a DB security group.

{ svc := rds.New(session.New()) input := &rds.DeleteDBSecurityGroupInput{ DBSecurityGroupName: aws.String("mysecgroup"), } result, err := svc.DeleteDBSecurityGroup(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeInvalidDBSecurityGroupStateFault: fmt.Println(rds.ErrCodeInvalidDBSecurityGroupStateFault, aerr.Error()) case rds.ErrCodeDBSecurityGroupNotFoundFault: fmt.Println(rds.ErrCodeDBSecurityGroupNotFoundFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

DeleteDBSecurityGroupRequest

func (c *RDS) DeleteDBSecurityGroupRequest(input *DeleteDBSecurityGroupInput) (req *request.Request, output *DeleteDBSecurityGroupOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DeleteDBSecurityGroup

DeleteDBSecurityGroupWithContext

func (c *RDS) DeleteDBSecurityGroupWithContext(ctx aws.Context, input *DeleteDBSecurityGroupInput, opts ...request.Option) (*DeleteDBSecurityGroupOutput, error)

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

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

DeleteDBSnapshot

func (c *RDS) DeleteDBSnapshot(input *DeleteDBSnapshotInput) (*DeleteDBSnapshotOutput, error)

DeleteDBSnapshot API operation for Amazon Relational Database Service.

Deletes a DB snapshot. If the snapshot is being copied, the copy operation is terminated.

The DB snapshot must be in the available state to be deleted.

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 Relational Database Service's API operation DeleteDBSnapshot for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidDBSnapshotStateFault "InvalidDBSnapshotState" The state of the DB snapshot doesn't allow deletion.

  • ErrCodeDBSnapshotNotFoundFault "DBSnapshotNotFound" DBSnapshotIdentifier doesn't refer to an existing DB snapshot.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DeleteDBSnapshot

Example

RDS DeleteDBSnapshot shared00

To delete a DB cluster snapshot.

This example deletes the specified DB snapshot.

{ svc := rds.New(session.New()) input := &rds.DeleteDBSnapshotInput{ DBSnapshotIdentifier: aws.String("mydbsnapshot"), } result, err := svc.DeleteDBSnapshot(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeInvalidDBSnapshotStateFault: fmt.Println(rds.ErrCodeInvalidDBSnapshotStateFault, aerr.Error()) case rds.ErrCodeDBSnapshotNotFoundFault: fmt.Println(rds.ErrCodeDBSnapshotNotFoundFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

DeleteDBSnapshotRequest

func (c *RDS) DeleteDBSnapshotRequest(input *DeleteDBSnapshotInput) (req *request.Request, output *DeleteDBSnapshotOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DeleteDBSnapshot

DeleteDBSnapshotWithContext

func (c *RDS) DeleteDBSnapshotWithContext(ctx aws.Context, input *DeleteDBSnapshotInput, opts ...request.Option) (*DeleteDBSnapshotOutput, error)

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

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

DeleteDBSubnetGroup

func (c *RDS) DeleteDBSubnetGroup(input *DeleteDBSubnetGroupInput) (*DeleteDBSubnetGroupOutput, error)

DeleteDBSubnetGroup API operation for Amazon Relational Database Service.

Deletes a DB subnet group.

The specified database subnet group must not be associated with any DB instances.

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 Relational Database Service's API operation DeleteDBSubnetGroup for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidDBSubnetGroupStateFault "InvalidDBSubnetGroupStateFault" The DB subnet group cannot be deleted because it's in use.

  • ErrCodeInvalidDBSubnetStateFault "InvalidDBSubnetStateFault" The DB subnet isn't in the available state.

  • ErrCodeDBSubnetGroupNotFoundFault "DBSubnetGroupNotFoundFault" DBSubnetGroupName doesn't refer to an existing DB subnet group.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DeleteDBSubnetGroup

Example

RDS DeleteDBSubnetGroup shared00

To delete a DB subnet group.

This example deletes the specified DB subnetgroup.

{ svc := rds.New(session.New()) input := &rds.DeleteDBSubnetGroupInput{ DBSubnetGroupName: aws.String("mydbsubnetgroup"), } result, err := svc.DeleteDBSubnetGroup(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeInvalidDBSubnetGroupStateFault: fmt.Println(rds.ErrCodeInvalidDBSubnetGroupStateFault, aerr.Error()) case rds.ErrCodeInvalidDBSubnetStateFault: fmt.Println(rds.ErrCodeInvalidDBSubnetStateFault, aerr.Error()) case rds.ErrCodeDBSubnetGroupNotFoundFault: fmt.Println(rds.ErrCodeDBSubnetGroupNotFoundFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

DeleteDBSubnetGroupRequest

func (c *RDS) DeleteDBSubnetGroupRequest(input *DeleteDBSubnetGroupInput) (req *request.Request, output *DeleteDBSubnetGroupOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DeleteDBSubnetGroup

DeleteDBSubnetGroupWithContext

func (c *RDS) DeleteDBSubnetGroupWithContext(ctx aws.Context, input *DeleteDBSubnetGroupInput, opts ...request.Option) (*DeleteDBSubnetGroupOutput, error)

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

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

DeleteEventSubscription

func (c *RDS) DeleteEventSubscription(input *DeleteEventSubscriptionInput) (*DeleteEventSubscriptionOutput, error)

DeleteEventSubscription API operation for Amazon Relational Database Service.

Deletes an RDS event notification subscription.

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 Relational Database Service's API operation DeleteEventSubscription for usage and error information.

Returned Error Codes:

  • ErrCodeSubscriptionNotFoundFault "SubscriptionNotFound" The subscription name does not exist.

  • ErrCodeInvalidEventSubscriptionStateFault "InvalidEventSubscriptionState" This error can occur if someone else is modifying a subscription. You should retry the action.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DeleteEventSubscription

Example

RDS DeleteEventSubscription shared00

To delete a DB event subscription.

This example deletes the specified DB event subscription.

{ svc := rds.New(session.New()) input := &rds.DeleteEventSubscriptionInput{ SubscriptionName: aws.String("myeventsubscription"), } result, err := svc.DeleteEventSubscription(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeSubscriptionNotFoundFault: fmt.Println(rds.ErrCodeSubscriptionNotFoundFault, aerr.Error()) case rds.ErrCodeInvalidEventSubscriptionStateFault: fmt.Println(rds.ErrCodeInvalidEventSubscriptionStateFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

DeleteEventSubscriptionRequest

func (c *RDS) DeleteEventSubscriptionRequest(input *DeleteEventSubscriptionInput) (req *request.Request, output *DeleteEventSubscriptionOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DeleteEventSubscription

DeleteEventSubscriptionWithContext

func (c *RDS) DeleteEventSubscriptionWithContext(ctx aws.Context, input *DeleteEventSubscriptionInput, opts ...request.Option) (*DeleteEventSubscriptionOutput, error)

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

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

DeleteGlobalCluster

func (c *RDS) DeleteGlobalCluster(input *DeleteGlobalClusterInput) (*DeleteGlobalClusterOutput, error)

DeleteGlobalCluster API operation for Amazon Relational Database Service.

Deletes a global database cluster. The primary and secondary clusters must already be detached or destroyed first.

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 Relational Database Service's API operation DeleteGlobalCluster for usage and error information.

Returned Error Codes:

  • ErrCodeGlobalClusterNotFoundFault "GlobalClusterNotFoundFault"

  • ErrCodeInvalidGlobalClusterStateFault "InvalidGlobalClusterStateFault"

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DeleteGlobalCluster

DeleteGlobalClusterRequest

func (c *RDS) DeleteGlobalClusterRequest(input *DeleteGlobalClusterInput) (req *request.Request, output *DeleteGlobalClusterOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DeleteGlobalCluster

DeleteGlobalClusterWithContext

func (c *RDS) DeleteGlobalClusterWithContext(ctx aws.Context, input *DeleteGlobalClusterInput, opts ...request.Option) (*DeleteGlobalClusterOutput, error)

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

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

DeleteOptionGroup

func (c *RDS) DeleteOptionGroup(input *DeleteOptionGroupInput) (*DeleteOptionGroupOutput, error)

DeleteOptionGroup API operation for Amazon Relational Database Service.

Deletes an existing option group.

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 Relational Database Service's API operation DeleteOptionGroup for usage and error information.

Returned Error Codes:

  • ErrCodeOptionGroupNotFoundFault "OptionGroupNotFoundFault" The specified option group could not be found.

  • ErrCodeInvalidOptionGroupStateFault "InvalidOptionGroupStateFault" The option group isn't in the available state.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DeleteOptionGroup

Example

RDS DeleteOptionGroup shared00

To delete an option group.

This example deletes the specified option group.

{ svc := rds.New(session.New()) input := &rds.DeleteOptionGroupInput{ OptionGroupName: aws.String("mydboptiongroup"), } result, err := svc.DeleteOptionGroup(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeOptionGroupNotFoundFault: fmt.Println(rds.ErrCodeOptionGroupNotFoundFault, aerr.Error()) case rds.ErrCodeInvalidOptionGroupStateFault: fmt.Println(rds.ErrCodeInvalidOptionGroupStateFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

DeleteOptionGroupRequest

func (c *RDS) DeleteOptionGroupRequest(input *DeleteOptionGroupInput) (req *request.Request, output *DeleteOptionGroupOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DeleteOptionGroup

DeleteOptionGroupWithContext

func (c *RDS) DeleteOptionGroupWithContext(ctx aws.Context, input *DeleteOptionGroupInput, opts ...request.Option) (*DeleteOptionGroupOutput, error)

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

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

DescribeAccountAttributes

func (c *RDS) DescribeAccountAttributes(input *DescribeAccountAttributesInput) (*DescribeAccountAttributesOutput, error)

DescribeAccountAttributes API operation for Amazon Relational Database Service.

Lists all of the attributes for a customer account. The attributes include Amazon RDS quotas for the account, such as the number of DB instances allowed. The description for a quota includes the quota name, current usage toward that quota, and the quota's maximum value.

This command doesn't take any parameters.

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 Relational Database Service's API operation DescribeAccountAttributes for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeAccountAttributes

Example

RDS DescribeAccountAttributes shared00

To list account attributes

This example lists account attributes.

{ svc := rds.New(session.New()) input := &rds.DescribeAccountAttributesInput{} result, err := svc.DescribeAccountAttributes(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

DescribeAccountAttributesRequest

func (c *RDS) DescribeAccountAttributesRequest(input *DescribeAccountAttributesInput) (req *request.Request, output *DescribeAccountAttributesOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeAccountAttributes

DescribeAccountAttributesWithContext

func (c *RDS) DescribeAccountAttributesWithContext(ctx aws.Context, input *DescribeAccountAttributesInput, opts ...request.Option) (*DescribeAccountAttributesOutput, error)

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

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

DescribeCertificates

func (c *RDS) DescribeCertificates(input *DescribeCertificatesInput) (*DescribeCertificatesOutput, error)

DescribeCertificates API operation for Amazon Relational Database Service.

Lists the set of CA certificates provided by Amazon RDS for this 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 Relational Database Service's API operation DescribeCertificates for usage and error information.

Returned Error Codes:

  • ErrCodeCertificateNotFoundFault "CertificateNotFound" CertificateIdentifier doesn't refer to an existing certificate.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeCertificates

Example

RDS DescribeCertificates shared00

To list certificates

This example lists up to 20 certificates for the specified certificate identifier.

{ svc := rds.New(session.New()) input := &rds.DescribeCertificatesInput{ CertificateIdentifier: aws.String("rds-ca-2015"), MaxRecords: aws.Int64(20), } result, err := svc.DescribeCertificates(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeCertificateNotFoundFault: fmt.Println(rds.ErrCodeCertificateNotFoundFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

DescribeCertificatesRequest

func (c *RDS) DescribeCertificatesRequest(input *DescribeCertificatesInput) (req *request.Request, output *DescribeCertificatesOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeCertificates

DescribeCertificatesWithContext

func (c *RDS) DescribeCertificatesWithContext(ctx aws.Context, input *DescribeCertificatesInput, opts ...request.Option) (*DescribeCertificatesOutput, error)

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

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

DescribeDBClusterBacktracks

func (c *RDS) DescribeDBClusterBacktracks(input *DescribeDBClusterBacktracksInput) (*DescribeDBClusterBacktracksOutput, error)

DescribeDBClusterBacktracks API operation for Amazon Relational Database Service.

Returns information about backtracks for a DB cluster.

For more information on Amazon Aurora, see What Is Amazon Aurora? (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html) in the Amazon Aurora 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 Relational Database Service's API operation DescribeDBClusterBacktracks for usage and error information.

Returned Error Codes:

  • ErrCodeDBClusterNotFoundFault "DBClusterNotFoundFault" DBClusterIdentifier doesn't refer to an existing DB cluster.

  • ErrCodeDBClusterBacktrackNotFoundFault "DBClusterBacktrackNotFoundFault" BacktrackIdentifier doesn't refer to an existing backtrack.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBClusterBacktracks

DescribeDBClusterBacktracksRequest

func (c *RDS) DescribeDBClusterBacktracksRequest(input *DescribeDBClusterBacktracksInput) (req *request.Request, output *DescribeDBClusterBacktracksOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBClusterBacktracks

DescribeDBClusterBacktracksWithContext

func (c *RDS) DescribeDBClusterBacktracksWithContext(ctx aws.Context, input *DescribeDBClusterBacktracksInput, opts ...request.Option) (*DescribeDBClusterBacktracksOutput, error)

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

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

DescribeDBClusterEndpoints

func (c *RDS) DescribeDBClusterEndpoints(input *DescribeDBClusterEndpointsInput) (*DescribeDBClusterEndpointsOutput, error)

DescribeDBClusterEndpoints API operation for Amazon Relational Database Service.

Returns information about endpoints for an Amazon Aurora DB cluster.

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 Relational Database Service's API operation DescribeDBClusterEndpoints for usage and error information.

Returned Error Codes:

  • ErrCodeDBClusterNotFoundFault "DBClusterNotFoundFault" DBClusterIdentifier doesn't refer to an existing DB cluster.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBClusterEndpoints

DescribeDBClusterEndpointsRequest

func (c *RDS) DescribeDBClusterEndpointsRequest(input *DescribeDBClusterEndpointsInput) (req *request.Request, output *DescribeDBClusterEndpointsOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBClusterEndpoints

DescribeDBClusterEndpointsWithContext

func (c *RDS) DescribeDBClusterEndpointsWithContext(ctx aws.Context, input *DescribeDBClusterEndpointsInput, opts ...request.Option) (*DescribeDBClusterEndpointsOutput, error)

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

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

DescribeDBClusterParameterGroups

func (c *RDS) DescribeDBClusterParameterGroups(input *DescribeDBClusterParameterGroupsInput) (*DescribeDBClusterParameterGroupsOutput, error)

DescribeDBClusterParameterGroups API operation for Amazon Relational Database Service.

Returns a list of DBClusterParameterGroup descriptions. If a DBClusterParameterGroupName parameter is specified, the list will contain only the description of the specified DB cluster parameter group.

For more information on Amazon Aurora, see What Is Amazon Aurora? (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html) in the Amazon Aurora 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 Relational Database Service's API operation DescribeDBClusterParameterGroups for usage and error information.

Returned Error Codes:

  • ErrCodeDBParameterGroupNotFoundFault "DBParameterGroupNotFound" DBParameterGroupName doesn't refer to an existing DB parameter group.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBClusterParameterGroups

Example

RDS DescribeDBClusterParameterGroups shared00

To list DB cluster parameter group settings

This example lists settings for the specified DB cluster parameter group.

{ svc := rds.New(session.New()) input := &rds.DescribeDBClusterParameterGroupsInput{ DBClusterParameterGroupName: aws.String("mydbclusterparametergroup"), } result, err := svc.DescribeDBClusterParameterGroups(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeDBParameterGroupNotFoundFault: fmt.Println(rds.ErrCodeDBParameterGroupNotFoundFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

DescribeDBClusterParameterGroupsRequest

func (c *RDS) DescribeDBClusterParameterGroupsRequest(input *DescribeDBClusterParameterGroupsInput) (req *request.Request, output *DescribeDBClusterParameterGroupsOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBClusterParameterGroups

DescribeDBClusterParameterGroupsWithContext

func (c *RDS) DescribeDBClusterParameterGroupsWithContext(ctx aws.Context, input *DescribeDBClusterParameterGroupsInput, opts ...request.Option) (*DescribeDBClusterParameterGroupsOutput, error)

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

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

DescribeDBClusterParameters

func (c *RDS) DescribeDBClusterParameters(input *DescribeDBClusterParametersInput) (*DescribeDBClusterParametersOutput, error)

DescribeDBClusterParameters API operation for Amazon Relational Database Service.

Returns the detailed parameter list for a particular DB cluster parameter group.

For more information on Amazon Aurora, see What Is Amazon Aurora? (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html) in the Amazon Aurora 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 Relational Database Service's API operation DescribeDBClusterParameters for usage and error information.

Returned Error Codes:

  • ErrCodeDBParameterGroupNotFoundFault "DBParameterGroupNotFound" DBParameterGroupName doesn't refer to an existing DB parameter group.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBClusterParameters

Example

RDS DescribeDBClusterParameters shared00

To list DB cluster parameters

This example lists system parameters for the specified DB cluster parameter group.

{ svc := rds.New(session.New()) input := &rds.DescribeDBClusterParametersInput{ DBClusterParameterGroupName: aws.String("mydbclusterparametergroup"), Source: aws.String("system"), } result, err := svc.DescribeDBClusterParameters(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeDBParameterGroupNotFoundFault: fmt.Println(rds.ErrCodeDBParameterGroupNotFoundFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

DescribeDBClusterParametersRequest

func (c *RDS) DescribeDBClusterParametersRequest(input *DescribeDBClusterParametersInput) (req *request.Request, output *DescribeDBClusterParametersOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBClusterParameters

DescribeDBClusterParametersWithContext

func (c *RDS) DescribeDBClusterParametersWithContext(ctx aws.Context, input *DescribeDBClusterParametersInput, opts ...request.Option) (*DescribeDBClusterParametersOutput, error)

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

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

DescribeDBClusterSnapshotAttributes

func (c *RDS) DescribeDBClusterSnapshotAttributes(input *DescribeDBClusterSnapshotAttributesInput) (*DescribeDBClusterSnapshotAttributesOutput, error)

DescribeDBClusterSnapshotAttributes API operation for Amazon Relational Database Service.

Returns a list of DB cluster snapshot attribute names and values for a manual DB cluster snapshot.

When sharing snapshots with other AWS accounts, DescribeDBClusterSnapshotAttributes returns the restore attribute and a list of IDs for the AWS accounts that are authorized to copy or restore the manual DB cluster snapshot. If all is included in the list of values for the restore attribute, then the manual DB cluster snapshot is public and can be copied or restored by all AWS accounts.

To add or remove access for an AWS account to copy or restore a manual DB cluster snapshot, or to make the manual DB cluster snapshot public or private, use the ModifyDBClusterSnapshotAttribute API action.

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 Relational Database Service's API operation DescribeDBClusterSnapshotAttributes for usage and error information.

Returned Error Codes:

  • ErrCodeDBClusterSnapshotNotFoundFault "DBClusterSnapshotNotFoundFault" DBClusterSnapshotIdentifier doesn't refer to an existing DB cluster snapshot.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBClusterSnapshotAttributes

Example

RDS DescribeDBClusterSnapshotAttributes shared00

To list DB cluster snapshot attributes

This example lists attributes for the specified DB cluster snapshot.

{ svc := rds.New(session.New()) input := &rds.DescribeDBClusterSnapshotAttributesInput{ DBClusterSnapshotIdentifier: aws.String("mydbclustersnapshot"), } result, err := svc.DescribeDBClusterSnapshotAttributes(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeDBClusterSnapshotNotFoundFault: fmt.Println(rds.ErrCodeDBClusterSnapshotNotFoundFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

DescribeDBClusterSnapshotAttributesRequest

func (c *RDS) DescribeDBClusterSnapshotAttributesRequest(input *DescribeDBClusterSnapshotAttributesInput) (req *request.Request, output *DescribeDBClusterSnapshotAttributesOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBClusterSnapshotAttributes

DescribeDBClusterSnapshotAttributesWithContext

func (c *RDS) DescribeDBClusterSnapshotAttributesWithContext(ctx aws.Context, input *DescribeDBClusterSnapshotAttributesInput, opts ...request.Option) (*DescribeDBClusterSnapshotAttributesOutput, error)

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

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

DescribeDBClusterSnapshots

func (c *RDS) DescribeDBClusterSnapshots(input *DescribeDBClusterSnapshotsInput) (*DescribeDBClusterSnapshotsOutput, error)

DescribeDBClusterSnapshots API operation for Amazon Relational Database Service.

Returns information about DB cluster snapshots. This API action supports pagination.

For more information on Amazon Aurora, see What Is Amazon Aurora? (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html) in the Amazon Aurora 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 Relational Database Service's API operation DescribeDBClusterSnapshots for usage and error information.

Returned Error Codes:

  • ErrCodeDBClusterSnapshotNotFoundFault "DBClusterSnapshotNotFoundFault" DBClusterSnapshotIdentifier doesn't refer to an existing DB cluster snapshot.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBClusterSnapshots

Example

RDS DescribeDBClusterSnapshots shared00

To list DB cluster snapshots

This example lists settings for the specified, manually-created cluster snapshot.

{ svc := rds.New(session.New()) input := &rds.DescribeDBClusterSnapshotsInput{ DBClusterSnapshotIdentifier: aws.String("mydbclustersnapshot"), SnapshotType: aws.String("manual"), } result, err := svc.DescribeDBClusterSnapshots(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeDBClusterSnapshotNotFoundFault: fmt.Println(rds.ErrCodeDBClusterSnapshotNotFoundFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

DescribeDBClusterSnapshotsRequest

func (c *RDS) DescribeDBClusterSnapshotsRequest(input *DescribeDBClusterSnapshotsInput) (req *request.Request, output *DescribeDBClusterSnapshotsOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBClusterSnapshots

DescribeDBClusterSnapshotsWithContext

func (c *RDS) DescribeDBClusterSnapshotsWithContext(ctx aws.Context, input *DescribeDBClusterSnapshotsInput, opts ...request.Option) (*DescribeDBClusterSnapshotsOutput, error)

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

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

DescribeDBClusters

func (c *RDS) DescribeDBClusters(input *DescribeDBClustersInput) (*DescribeDBClustersOutput, error)

DescribeDBClusters API operation for Amazon Relational Database Service.

Returns information about provisioned Aurora DB clusters. This API supports pagination.

For more information on Amazon Aurora, see What Is Amazon Aurora? (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html) in the Amazon Aurora 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 Relational Database Service's API operation DescribeDBClusters for usage and error information.

Returned Error Codes:

  • ErrCodeDBClusterNotFoundFault "DBClusterNotFoundFault" DBClusterIdentifier doesn't refer to an existing DB cluster.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBClusters

Example

RDS DescribeDBClusters shared00

To list DB clusters

This example lists settings for the specified DB cluster.

{ svc := rds.New(session.New()) input := &rds.DescribeDBClustersInput{ DBClusterIdentifier: aws.String("mynewdbcluster"), } result, err := svc.DescribeDBClusters(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeDBClusterNotFoundFault: fmt.Println(rds.ErrCodeDBClusterNotFoundFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

DescribeDBClustersPages

func (c *RDS) DescribeDBClustersPages(input *DescribeDBClustersInput, fn func(*DescribeDBClustersOutput, bool) bool) error

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

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

See Also

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

DescribeDBClustersPagesWithContext

func (c *RDS) DescribeDBClustersPagesWithContext(ctx aws.Context, input *DescribeDBClustersInput, fn func(*DescribeDBClustersOutput, bool) bool, opts ...request.Option) error

DescribeDBClustersPagesWithContext same as DescribeDBClustersPages 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.

DescribeDBClustersRequest

func (c *RDS) DescribeDBClustersRequest(input *DescribeDBClustersInput) (req *request.Request, output *DescribeDBClustersOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBClusters

DescribeDBClustersWithContext

func (c *RDS) DescribeDBClustersWithContext(ctx aws.Context, input *DescribeDBClustersInput, opts ...request.Option) (*DescribeDBClustersOutput, error)

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

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

DescribeDBEngineVersions

func (c *RDS) DescribeDBEngineVersions(input *DescribeDBEngineVersionsInput) (*DescribeDBEngineVersionsOutput, error)

DescribeDBEngineVersions API operation for Amazon Relational Database Service.

Returns a list of the available DB engines.

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 Relational Database Service's API operation DescribeDBEngineVersions for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBEngineVersions

Example

RDS DescribeDBEngineVersions shared00

To list DB engine version settings

This example lists settings for the specified DB engine version.

{ svc := rds.New(session.New()) input := &rds.DescribeDBEngineVersionsInput{ DBParameterGroupFamily: aws.String("mysql5.6"), DefaultOnly: aws.Bool(true), Engine: aws.String("mysql"), EngineVersion: aws.String("5.6"), ListSupportedCharacterSets: aws.Bool(true), } result, err := svc.DescribeDBEngineVersions(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

DescribeDBEngineVersionsPages

func (c *RDS) DescribeDBEngineVersionsPages(input *DescribeDBEngineVersionsInput, fn func(*DescribeDBEngineVersionsOutput, bool) bool) error

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

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

See Also

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

DescribeDBEngineVersionsPagesWithContext

func (c *RDS) DescribeDBEngineVersionsPagesWithContext(ctx aws.Context, input *DescribeDBEngineVersionsInput, fn func(*DescribeDBEngineVersionsOutput, bool) bool, opts ...request.Option) error

DescribeDBEngineVersionsPagesWithContext same as DescribeDBEngineVersionsPages 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.

DescribeDBEngineVersionsRequest

func (c *RDS) DescribeDBEngineVersionsRequest(input *DescribeDBEngineVersionsInput) (req *request.Request, output *DescribeDBEngineVersionsOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBEngineVersions

DescribeDBEngineVersionsWithContext

func (c *RDS) DescribeDBEngineVersionsWithContext(ctx aws.Context, input *DescribeDBEngineVersionsInput, opts ...request.Option) (*DescribeDBEngineVersionsOutput, error)

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

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

DescribeDBInstanceAutomatedBackups

func (c *RDS) DescribeDBInstanceAutomatedBackups(input *DescribeDBInstanceAutomatedBackupsInput) (*DescribeDBInstanceAutomatedBackupsOutput, error)

DescribeDBInstanceAutomatedBackups API operation for Amazon Relational Database Service.

Displays backups for both current and deleted instances. For example, use this operation to find details about automated backups for previously deleted instances. Current instances with retention periods greater than zero (0) are returned for both the DescribeDBInstanceAutomatedBackups and DescribeDBInstances operations.

All parameters are optional.

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 Relational Database Service's API operation DescribeDBInstanceAutomatedBackups for usage and error information.

Returned Error Codes:

  • ErrCodeDBInstanceAutomatedBackupNotFoundFault "DBInstanceAutomatedBackupNotFound" No automated backup for this DB instance was found.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBInstanceAutomatedBackups

DescribeDBInstanceAutomatedBackupsPages

func (c *RDS) DescribeDBInstanceAutomatedBackupsPages(input *DescribeDBInstanceAutomatedBackupsInput, fn func(*DescribeDBInstanceAutomatedBackupsOutput, bool) bool) error

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

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

See Also

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

DescribeDBInstanceAutomatedBackupsPagesWithContext

func (c *RDS) DescribeDBInstanceAutomatedBackupsPagesWithContext(ctx aws.Context, input *DescribeDBInstanceAutomatedBackupsInput, fn func(*DescribeDBInstanceAutomatedBackupsOutput, bool) bool, opts ...request.Option) error

DescribeDBInstanceAutomatedBackupsPagesWithContext same as DescribeDBInstanceAutomatedBackupsPages 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.

DescribeDBInstanceAutomatedBackupsRequest

func (c *RDS) DescribeDBInstanceAutomatedBackupsRequest(input *DescribeDBInstanceAutomatedBackupsInput) (req *request.Request, output *DescribeDBInstanceAutomatedBackupsOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBInstanceAutomatedBackups

DescribeDBInstanceAutomatedBackupsWithContext

func (c *RDS) DescribeDBInstanceAutomatedBackupsWithContext(ctx aws.Context, input *DescribeDBInstanceAutomatedBackupsInput, opts ...request.Option) (*DescribeDBInstanceAutomatedBackupsOutput, error)

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

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

DescribeDBInstances

func (c *RDS) DescribeDBInstances(input *DescribeDBInstancesInput) (*DescribeDBInstancesOutput, error)

DescribeDBInstances API operation for Amazon Relational Database Service.

Returns information about provisioned RDS instances. This API supports pagination.

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 Relational Database Service's API operation DescribeDBInstances for usage and error information.

Returned Error Codes:

  • ErrCodeDBInstanceNotFoundFault "DBInstanceNotFound" DBInstanceIdentifier doesn't refer to an existing DB instance.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBInstances

Example

RDS DescribeDBInstances shared00

To list DB instance settings

This example lists settings for the specified DB instance.

{ svc := rds.New(session.New()) input := &rds.DescribeDBInstancesInput{ DBInstanceIdentifier: aws.String("mymysqlinstance"), } result, err := svc.DescribeDBInstances(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeDBInstanceNotFoundFault: fmt.Println(rds.ErrCodeDBInstanceNotFoundFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

DescribeDBInstancesPages

func (c *RDS) DescribeDBInstancesPages(input *DescribeDBInstancesInput, fn func(*DescribeDBInstancesOutput, bool) bool) error

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

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

See Also

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

DescribeDBInstancesPagesWithContext

func (c *RDS) DescribeDBInstancesPagesWithContext(ctx aws.Context, input *DescribeDBInstancesInput, fn func(*DescribeDBInstancesOutput, bool) bool, opts ...request.Option) error

DescribeDBInstancesPagesWithContext same as DescribeDBInstancesPages 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.

DescribeDBInstancesRequest

func (c *RDS) DescribeDBInstancesRequest(input *DescribeDBInstancesInput) (req *request.Request, output *DescribeDBInstancesOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBInstances

DescribeDBInstancesWithContext

func (c *RDS) DescribeDBInstancesWithContext(ctx aws.Context, input *DescribeDBInstancesInput, opts ...request.Option) (*DescribeDBInstancesOutput, error)

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

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

DescribeDBLogFiles

func (c *RDS) DescribeDBLogFiles(input *DescribeDBLogFilesInput) (*DescribeDBLogFilesOutput, error)

DescribeDBLogFiles API operation for Amazon Relational Database Service.

Returns a list of DB log files for the DB instance.

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 Relational Database Service's API operation DescribeDBLogFiles for usage and error information.

Returned Error Codes:

  • ErrCodeDBInstanceNotFoundFault "DBInstanceNotFound" DBInstanceIdentifier doesn't refer to an existing DB instance.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBLogFiles

Example

RDS DescribeDBLogFiles shared00

To list DB log file names

This example lists matching log file names for the specified DB instance, file name pattern, last write date in POSIX time with milleseconds, and minimum file size.

{ svc := rds.New(session.New()) input := &rds.DescribeDBLogFilesInput{ DBInstanceIdentifier: aws.String("mymysqlinstance"), FileLastWritten: aws.Int64(1470873600000), FileSize: aws.Int64(0), FilenameContains: aws.String("error"), } result, err := svc.DescribeDBLogFiles(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeDBInstanceNotFoundFault: fmt.Println(rds.ErrCodeDBInstanceNotFoundFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

DescribeDBLogFilesPages

func (c *RDS) DescribeDBLogFilesPages(input *DescribeDBLogFilesInput, fn func(*DescribeDBLogFilesOutput, bool) bool) error

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

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

See Also

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

DescribeDBLogFilesPagesWithContext

func (c *RDS) DescribeDBLogFilesPagesWithContext(ctx aws.Context, input *DescribeDBLogFilesInput, fn func(*DescribeDBLogFilesOutput, bool) bool, opts ...request.Option) error

DescribeDBLogFilesPagesWithContext same as DescribeDBLogFilesPages 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.

DescribeDBLogFilesRequest

func (c *RDS) DescribeDBLogFilesRequest(input *DescribeDBLogFilesInput) (req *request.Request, output *DescribeDBLogFilesOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBLogFiles

DescribeDBLogFilesWithContext

func (c *RDS) DescribeDBLogFilesWithContext(ctx aws.Context, input *DescribeDBLogFilesInput, opts ...request.Option) (*DescribeDBLogFilesOutput, error)

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

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

DescribeDBParameterGroups

func (c *RDS) DescribeDBParameterGroups(input *DescribeDBParameterGroupsInput) (*DescribeDBParameterGroupsOutput, error)

DescribeDBParameterGroups API operation for Amazon Relational Database Service.

Returns a list of DBParameterGroup descriptions. If a DBParameterGroupName is specified, the list will contain only the description of the specified DB parameter group.

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 Relational Database Service's API operation DescribeDBParameterGroups for usage and error information.

Returned Error Codes:

  • ErrCodeDBParameterGroupNotFoundFault "DBParameterGroupNotFound" DBParameterGroupName doesn't refer to an existing DB parameter group.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBParameterGroups

Example

RDS DescribeDBParameterGroups shared00

To list information about DB parameter groups

This example lists information about the specified DB parameter group.

{ svc := rds.New(session.New()) input := &rds.DescribeDBParameterGroupsInput{ DBParameterGroupName: aws.String("mymysqlparametergroup"), } result, err := svc.DescribeDBParameterGroups(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeDBParameterGroupNotFoundFault: fmt.Println(rds.ErrCodeDBParameterGroupNotFoundFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

DescribeDBParameterGroupsPages

func (c *RDS) DescribeDBParameterGroupsPages(input *DescribeDBParameterGroupsInput, fn func(*DescribeDBParameterGroupsOutput, bool) bool) error

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

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

See Also

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

DescribeDBParameterGroupsPagesWithContext

func (c *RDS) DescribeDBParameterGroupsPagesWithContext(ctx aws.Context, input *DescribeDBParameterGroupsInput, fn func(*DescribeDBParameterGroupsOutput, bool) bool, opts ...request.Option) error

DescribeDBParameterGroupsPagesWithContext same as DescribeDBParameterGroupsPages 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.

DescribeDBParameterGroupsRequest

func (c *RDS) DescribeDBParameterGroupsRequest(input *DescribeDBParameterGroupsInput) (req *request.Request, output *DescribeDBParameterGroupsOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBParameterGroups

DescribeDBParameterGroupsWithContext

func (c *RDS) DescribeDBParameterGroupsWithContext(ctx aws.Context, input *DescribeDBParameterGroupsInput, opts ...request.Option) (*DescribeDBParameterGroupsOutput, error)

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

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

DescribeDBParameters

func (c *RDS) DescribeDBParameters(input *DescribeDBParametersInput) (*DescribeDBParametersOutput, error)

DescribeDBParameters API operation for Amazon Relational Database Service.

Returns the detailed parameter list for a particular DB parameter group.

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 Relational Database Service's API operation DescribeDBParameters for usage and error information.

Returned Error Codes:

  • ErrCodeDBParameterGroupNotFoundFault "DBParameterGroupNotFound" DBParameterGroupName doesn't refer to an existing DB parameter group.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBParameters

Example

RDS DescribeDBParameters shared00

To list information about DB parameters

This example lists information for up to the first 20 system parameters for the specified DB parameter group.

{ svc := rds.New(session.New()) input := &rds.DescribeDBParametersInput{ DBParameterGroupName: aws.String("mymysqlparametergroup"), MaxRecords: aws.Int64(20), Source: aws.String("system"), } result, err := svc.DescribeDBParameters(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeDBParameterGroupNotFoundFault: fmt.Println(rds.ErrCodeDBParameterGroupNotFoundFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

DescribeDBParametersPages

func (c *RDS) DescribeDBParametersPages(input *DescribeDBParametersInput, fn func(*DescribeDBParametersOutput, bool) bool) error

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

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

See Also

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

DescribeDBParametersPagesWithContext

func (c *RDS) DescribeDBParametersPagesWithContext(ctx aws.Context, input *DescribeDBParametersInput, fn func(*DescribeDBParametersOutput, bool) bool, opts ...request.Option) error

DescribeDBParametersPagesWithContext same as DescribeDBParametersPages 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.

DescribeDBParametersRequest

func (c *RDS) DescribeDBParametersRequest(input *DescribeDBParametersInput) (req *request.Request, output *DescribeDBParametersOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBParameters

DescribeDBParametersWithContext

func (c *RDS) DescribeDBParametersWithContext(ctx aws.Context, input *DescribeDBParametersInput, opts ...request.Option) (*DescribeDBParametersOutput, error)

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

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

DescribeDBSecurityGroups

func (c *RDS) DescribeDBSecurityGroups(input *DescribeDBSecurityGroupsInput) (*DescribeDBSecurityGroupsOutput, error)

DescribeDBSecurityGroups API operation for Amazon Relational Database Service.

Returns a list of DBSecurityGroup descriptions. If a DBSecurityGroupName is specified, the list will contain only the descriptions of the specified DB security group.

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 Relational Database Service's API operation DescribeDBSecurityGroups for usage and error information.

Returned Error Codes:

  • ErrCodeDBSecurityGroupNotFoundFault "DBSecurityGroupNotFound" DBSecurityGroupName doesn't refer to an existing DB security group.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBSecurityGroups

Example

RDS DescribeDBSecurityGroups shared00

To list DB security group settings

This example lists settings for the specified security group.

{ svc := rds.New(session.New()) input := &rds.DescribeDBSecurityGroupsInput{ DBSecurityGroupName: aws.String("mydbsecuritygroup"), } result, err := svc.DescribeDBSecurityGroups(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeDBSecurityGroupNotFoundFault: fmt.Println(rds.ErrCodeDBSecurityGroupNotFoundFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

DescribeDBSecurityGroupsPages

func (c *RDS) DescribeDBSecurityGroupsPages(input *DescribeDBSecurityGroupsInput, fn func(*DescribeDBSecurityGroupsOutput, bool) bool) error

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

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

See Also

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

DescribeDBSecurityGroupsPagesWithContext

func (c *RDS) DescribeDBSecurityGroupsPagesWithContext(ctx aws.Context, input *DescribeDBSecurityGroupsInput, fn func(*DescribeDBSecurityGroupsOutput, bool) bool, opts ...request.Option) error

DescribeDBSecurityGroupsPagesWithContext same as DescribeDBSecurityGroupsPages 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.

DescribeDBSecurityGroupsRequest

func (c *RDS) DescribeDBSecurityGroupsRequest(input *DescribeDBSecurityGroupsInput) (req *request.Request, output *DescribeDBSecurityGroupsOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBSecurityGroups

DescribeDBSecurityGroupsWithContext

func (c *RDS) DescribeDBSecurityGroupsWithContext(ctx aws.Context, input *DescribeDBSecurityGroupsInput, opts ...request.Option) (*DescribeDBSecurityGroupsOutput, error)

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

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

DescribeDBSnapshotAttributes

func (c *RDS) DescribeDBSnapshotAttributes(input *DescribeDBSnapshotAttributesInput) (*DescribeDBSnapshotAttributesOutput, error)

DescribeDBSnapshotAttributes API operation for Amazon Relational Database Service.

Returns a list of DB snapshot attribute names and values for a manual DB snapshot.

When sharing snapshots with other AWS accounts, DescribeDBSnapshotAttributes returns the restore attribute and a list of IDs for the AWS accounts that are authorized to copy or restore the manual DB snapshot. If all is included in the list of values for the restore attribute, then the manual DB snapshot is public and can be copied or restored by all AWS accounts.

To add or remove access for an AWS account to copy or restore a manual DB snapshot, or to make the manual DB snapshot public or private, use the ModifyDBSnapshotAttribute API action.

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 Relational Database Service's API operation DescribeDBSnapshotAttributes for usage and error information.

Returned Error Codes:

  • ErrCodeDBSnapshotNotFoundFault "DBSnapshotNotFound" DBSnapshotIdentifier doesn't refer to an existing DB snapshot.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBSnapshotAttributes

Example

RDS DescribeDBSnapshotAttributes shared00

To list DB snapshot attributes

This example lists attributes for the specified DB snapshot.

{ svc := rds.New(session.New()) input := &rds.DescribeDBSnapshotAttributesInput{ DBSnapshotIdentifier: aws.String("mydbsnapshot"), } result, err := svc.DescribeDBSnapshotAttributes(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeDBSnapshotNotFoundFault: fmt.Println(rds.ErrCodeDBSnapshotNotFoundFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

DescribeDBSnapshotAttributesRequest

func (c *RDS) DescribeDBSnapshotAttributesRequest(input *DescribeDBSnapshotAttributesInput) (req *request.Request, output *DescribeDBSnapshotAttributesOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBSnapshotAttributes

DescribeDBSnapshotAttributesWithContext

func (c *RDS) DescribeDBSnapshotAttributesWithContext(ctx aws.Context, input *DescribeDBSnapshotAttributesInput, opts ...request.Option) (*DescribeDBSnapshotAttributesOutput, error)

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

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

DescribeDBSnapshots

func (c *RDS) DescribeDBSnapshots(input *DescribeDBSnapshotsInput) (*DescribeDBSnapshotsOutput, error)

DescribeDBSnapshots API operation for Amazon Relational Database Service.

Returns information about DB snapshots. This API action supports pagination.

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 Relational Database Service's API operation DescribeDBSnapshots for usage and error information.

Returned Error Codes:

  • ErrCodeDBSnapshotNotFoundFault "DBSnapshotNotFound" DBSnapshotIdentifier doesn't refer to an existing DB snapshot.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBSnapshots

Example

RDS DescribeDBSnapshots shared00

To list DB snapshot attributes

This example lists all manually-created, shared snapshots for the specified DB instance.

{ svc := rds.New(session.New()) input := &rds.DescribeDBSnapshotsInput{ DBInstanceIdentifier: aws.String("mymysqlinstance"), IncludePublic: aws.Bool(false), IncludeShared: aws.Bool(true), SnapshotType: aws.String("manual"), } result, err := svc.DescribeDBSnapshots(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeDBSnapshotNotFoundFault: fmt.Println(rds.ErrCodeDBSnapshotNotFoundFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

DescribeDBSnapshotsPages

func (c *RDS) DescribeDBSnapshotsPages(input *DescribeDBSnapshotsInput, fn func(*DescribeDBSnapshotsOutput, bool) bool) error

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

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

See Also

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

DescribeDBSnapshotsPagesWithContext

func (c *RDS) DescribeDBSnapshotsPagesWithContext(ctx aws.Context, input *DescribeDBSnapshotsInput, fn func(*DescribeDBSnapshotsOutput, bool) bool, opts ...request.Option) error

DescribeDBSnapshotsPagesWithContext same as DescribeDBSnapshotsPages 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.

DescribeDBSnapshotsRequest

func (c *RDS) DescribeDBSnapshotsRequest(input *DescribeDBSnapshotsInput) (req *request.Request, output *DescribeDBSnapshotsOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBSnapshots

DescribeDBSnapshotsWithContext

func (c *RDS) DescribeDBSnapshotsWithContext(ctx aws.Context, input *DescribeDBSnapshotsInput, opts ...request.Option) (*DescribeDBSnapshotsOutput, error)

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

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

DescribeDBSubnetGroups

func (c *RDS) DescribeDBSubnetGroups(input *DescribeDBSubnetGroupsInput) (*DescribeDBSubnetGroupsOutput, error)

DescribeDBSubnetGroups API operation for Amazon Relational Database Service.

Returns a list of DBSubnetGroup descriptions. If a DBSubnetGroupName is specified, the list will contain only the descriptions of the specified DBSubnetGroup.

For an overview of CIDR ranges, go to the Wikipedia Tutorial (http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing).

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 Relational Database Service's API operation DescribeDBSubnetGroups for usage and error information.

Returned Error Codes:

  • ErrCodeDBSubnetGroupNotFoundFault "DBSubnetGroupNotFoundFault" DBSubnetGroupName doesn't refer to an existing DB subnet group.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBSubnetGroups

Example

RDS DescribeDBSubnetGroups shared00

To list information about DB subnet groups

This example lists information about the specified DB subnet group.

{ svc := rds.New(session.New()) input := &rds.DescribeDBSubnetGroupsInput{ DBSubnetGroupName: aws.String("mydbsubnetgroup"), } result, err := svc.DescribeDBSubnetGroups(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeDBSubnetGroupNotFoundFault: fmt.Println(rds.ErrCodeDBSubnetGroupNotFoundFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

DescribeDBSubnetGroupsPages

func (c *RDS) DescribeDBSubnetGroupsPages(input *DescribeDBSubnetGroupsInput, fn func(*DescribeDBSubnetGroupsOutput, bool) bool) error

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

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

See Also

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

DescribeDBSubnetGroupsPagesWithContext

func (c *RDS) DescribeDBSubnetGroupsPagesWithContext(ctx aws.Context, input *DescribeDBSubnetGroupsInput, fn func(*DescribeDBSubnetGroupsOutput, bool) bool, opts ...request.Option) error

DescribeDBSubnetGroupsPagesWithContext same as DescribeDBSubnetGroupsPages 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.

DescribeDBSubnetGroupsRequest

func (c *RDS) DescribeDBSubnetGroupsRequest(input *DescribeDBSubnetGroupsInput) (req *request.Request, output *DescribeDBSubnetGroupsOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBSubnetGroups

DescribeDBSubnetGroupsWithContext

func (c *RDS) DescribeDBSubnetGroupsWithContext(ctx aws.Context, input *DescribeDBSubnetGroupsInput, opts ...request.Option) (*DescribeDBSubnetGroupsOutput, error)

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

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

DescribeEngineDefaultClusterParameters

func (c *RDS) DescribeEngineDefaultClusterParameters(input *DescribeEngineDefaultClusterParametersInput) (*DescribeEngineDefaultClusterParametersOutput, error)

DescribeEngineDefaultClusterParameters API operation for Amazon Relational Database Service.

Returns the default engine and system parameter information for the cluster database engine.

For more information on Amazon Aurora, see What Is Amazon Aurora? (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html) in the Amazon Aurora 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 Relational Database Service's API operation DescribeEngineDefaultClusterParameters for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeEngineDefaultClusterParameters

Example

RDS DescribeEngineDefaultClusterParameters shared00

To list default parameters for a DB cluster engine

This example lists default parameters for the specified DB cluster engine.

{ svc := rds.New(session.New()) input := &rds.DescribeEngineDefaultClusterParametersInput{ DBParameterGroupFamily: aws.String("aurora5.6"), } result, err := svc.DescribeEngineDefaultClusterParameters(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

DescribeEngineDefaultClusterParametersRequest

func (c *RDS) DescribeEngineDefaultClusterParametersRequest(input *DescribeEngineDefaultClusterParametersInput) (req *request.Request, output *DescribeEngineDefaultClusterParametersOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeEngineDefaultClusterParameters

DescribeEngineDefaultClusterParametersWithContext

func (c *RDS) DescribeEngineDefaultClusterParametersWithContext(ctx aws.Context, input *DescribeEngineDefaultClusterParametersInput, opts ...request.Option) (*DescribeEngineDefaultClusterParametersOutput, error)

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

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

DescribeEngineDefaultParameters

func (c *RDS) DescribeEngineDefaultParameters(input *DescribeEngineDefaultParametersInput) (*DescribeEngineDefaultParametersOutput, error)

DescribeEngineDefaultParameters API operation for Amazon Relational Database Service.

Returns the default engine and system parameter information for the specified database engine.

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 Relational Database Service's API operation DescribeEngineDefaultParameters for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeEngineDefaultParameters

Example

RDS DescribeEngineDefaultParameters shared00

To list default parameters for a DB engine

This example lists default parameters for the specified DB engine.

{ svc := rds.New(session.New()) input := &rds.DescribeEngineDefaultParametersInput{ DBParameterGroupFamily: aws.String("mysql5.6"), } result, err := svc.DescribeEngineDefaultParameters(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

DescribeEngineDefaultParametersPages

func (c *RDS) DescribeEngineDefaultParametersPages(input *DescribeEngineDefaultParametersInput, fn func(*DescribeEngineDefaultParametersOutput, bool) bool) error

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

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

See Also

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

DescribeEngineDefaultParametersPagesWithContext

func (c *RDS) DescribeEngineDefaultParametersPagesWithContext(ctx aws.Context, input *DescribeEngineDefaultParametersInput, fn func(*DescribeEngineDefaultParametersOutput, bool) bool, opts ...request.Option) error

DescribeEngineDefaultParametersPagesWithContext same as DescribeEngineDefaultParametersPages 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.

DescribeEngineDefaultParametersRequest

func (c *RDS) DescribeEngineDefaultParametersRequest(input *DescribeEngineDefaultParametersInput) (req *request.Request, output *DescribeEngineDefaultParametersOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeEngineDefaultParameters

DescribeEngineDefaultParametersWithContext

func (c *RDS) DescribeEngineDefaultParametersWithContext(ctx aws.Context, input *DescribeEngineDefaultParametersInput, opts ...request.Option) (*DescribeEngineDefaultParametersOutput, error)

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

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

DescribeEventCategories

func (c *RDS) DescribeEventCategories(input *DescribeEventCategoriesInput) (*DescribeEventCategoriesOutput, error)

DescribeEventCategories API operation for Amazon Relational Database Service.

Displays a list of categories for all event source types, or, if specified, for a specified source type. You can see a list of the event categories and source types in the Events (https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Events.html) topic in the Amazon RDS 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 Relational Database Service's API operation DescribeEventCategories for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeEventCategories

Example

RDS DescribeEventCategories shared00

To list event categories.

This example lists all DB instance event categories.

{ svc := rds.New(session.New()) input := &rds.DescribeEventCategoriesInput{ SourceType: aws.String("db-instance"), } result, err := svc.DescribeEventCategories(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

DescribeEventCategoriesRequest

func (c *RDS) DescribeEventCategoriesRequest(input *DescribeEventCategoriesInput) (req *request.Request, output *DescribeEventCategoriesOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeEventCategories

DescribeEventCategoriesWithContext

func (c *RDS) DescribeEventCategoriesWithContext(ctx aws.Context, input *DescribeEventCategoriesInput, opts ...request.Option) (*DescribeEventCategoriesOutput, error)

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

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

DescribeEventSubscriptions

func (c *RDS) DescribeEventSubscriptions(input *DescribeEventSubscriptionsInput) (*DescribeEventSubscriptionsOutput, error)

DescribeEventSubscriptions API operation for Amazon Relational Database Service.

Lists all the subscription descriptions for a customer account. The description for a subscription includes SubscriptionName, SNSTopicARN, CustomerID, SourceType, SourceID, CreationTime, and Status.

If you specify a SubscriptionName, lists the description for that subscription.

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 Relational Database Service's API operation DescribeEventSubscriptions for usage and error information.

Returned Error Codes:

  • ErrCodeSubscriptionNotFoundFault "SubscriptionNotFound" The subscription name does not exist.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeEventSubscriptions

Example

RDS DescribeEventSubscriptions shared00

To list information about DB event notification subscriptions

This example lists information for the specified DB event notification subscription.

{ svc := rds.New(session.New()) input := &rds.DescribeEventSubscriptionsInput{ SubscriptionName: aws.String("mymysqleventsubscription"), } result, err := svc.DescribeEventSubscriptions(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeSubscriptionNotFoundFault: fmt.Println(rds.ErrCodeSubscriptionNotFoundFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

DescribeEventSubscriptionsPages

func (c *RDS) DescribeEventSubscriptionsPages(input *DescribeEventSubscriptionsInput, fn func(*DescribeEventSubscriptionsOutput, bool) bool) error

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

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

See Also

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

DescribeEventSubscriptionsPagesWithContext

func (c *RDS) DescribeEventSubscriptionsPagesWithContext(ctx aws.Context, input *DescribeEventSubscriptionsInput, fn func(*DescribeEventSubscriptionsOutput, bool) bool, opts ...request.Option) error

DescribeEventSubscriptionsPagesWithContext same as DescribeEventSubscriptionsPages 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.

DescribeEventSubscriptionsRequest

func (c *RDS) DescribeEventSubscriptionsRequest(input *DescribeEventSubscriptionsInput) (req *request.Request, output *DescribeEventSubscriptionsOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeEventSubscriptions

DescribeEventSubscriptionsWithContext

func (c *RDS) DescribeEventSubscriptionsWithContext(ctx aws.Context, input *DescribeEventSubscriptionsInput, opts ...request.Option) (*DescribeEventSubscriptionsOutput, error)

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

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

DescribeEvents

func (c *RDS) DescribeEvents(input *DescribeEventsInput) (*DescribeEventsOutput, error)

DescribeEvents API operation for Amazon Relational Database Service.

Returns events related to DB instances, DB security groups, DB snapshots, and DB parameter groups for the past 14 days. Events specific to a particular DB instance, DB security group, database snapshot, or DB parameter group can be obtained by providing the name as a parameter. By default, the past hour of events are returned.

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 Relational Database Service's API operation DescribeEvents for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeEvents

Example

RDS DescribeEvents shared00

To list information about events

This example lists information for all backup-related events for the specified DB instance for the past 7 days (7 days * 24 hours * 60 minutes = 10,080 minutes).

{ svc := rds.New(session.New()) input := &rds.DescribeEventsInput{ Duration: aws.Int64(10080), EventCategories: []*string{ aws.String("backup"), }, SourceIdentifier: aws.String("mymysqlinstance"), SourceType: aws.String("db-instance"), } result, err := svc.DescribeEvents(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

DescribeEventsPages

func (c *RDS) DescribeEventsPages(input *DescribeEventsInput, fn func(*DescribeEventsOutput, bool) bool) error

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

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

See Also

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

DescribeEventsPagesWithContext

func (c *RDS) DescribeEventsPagesWithContext(ctx aws.Context, input *DescribeEventsInput, fn func(*DescribeEventsOutput, bool) bool, opts ...request.Option) error

DescribeEventsPagesWithContext same as DescribeEventsPages 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.

DescribeEventsRequest

func (c *RDS) DescribeEventsRequest(input *DescribeEventsInput) (req *request.Request, output *DescribeEventsOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeEvents

DescribeEventsWithContext

func (c *RDS) DescribeEventsWithContext(ctx aws.Context, input *DescribeEventsInput, opts ...request.Option) (*DescribeEventsOutput, error)

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

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

DescribeGlobalClusters

func (c *RDS) DescribeGlobalClusters(input *DescribeGlobalClustersInput) (*DescribeGlobalClustersOutput, error)

DescribeGlobalClusters API operation for Amazon Relational Database Service.

Returns information about Aurora global database clusters. This API supports pagination.

For more information on Amazon Aurora, see What Is Amazon Aurora? (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html) in the Amazon Aurora 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 Relational Database Service's API operation DescribeGlobalClusters for usage and error information.

Returned Error Codes:

  • ErrCodeGlobalClusterNotFoundFault "GlobalClusterNotFoundFault"

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeGlobalClusters

DescribeGlobalClustersPages

func (c *RDS) DescribeGlobalClustersPages(input *DescribeGlobalClustersInput, fn func(*DescribeGlobalClustersOutput, bool) bool) error

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

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

See Also

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

DescribeGlobalClustersPagesWithContext

func (c *RDS) DescribeGlobalClustersPagesWithContext(ctx aws.Context, input *DescribeGlobalClustersInput, fn func(*DescribeGlobalClustersOutput, bool) bool, opts ...request.Option) error

DescribeGlobalClustersPagesWithContext same as DescribeGlobalClustersPages 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.

DescribeGlobalClustersRequest

func (c *RDS) DescribeGlobalClustersRequest(input *DescribeGlobalClustersInput) (req *request.Request, output *DescribeGlobalClustersOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeGlobalClusters

DescribeGlobalClustersWithContext

func (c *RDS) DescribeGlobalClustersWithContext(ctx aws.Context, input *DescribeGlobalClustersInput, opts ...request.Option) (*DescribeGlobalClustersOutput, error)

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

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

DescribeOptionGroupOptions

func (c *RDS) DescribeOptionGroupOptions(input *DescribeOptionGroupOptionsInput) (*DescribeOptionGroupOptionsOutput, error)

DescribeOptionGroupOptions API operation for Amazon Relational Database Service.

Describes all available options.

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 Relational Database Service's API operation DescribeOptionGroupOptions for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeOptionGroupOptions

Example

RDS DescribeOptionGroupOptions shared00

To list information about DB option group options

This example lists information for all option group options for the specified DB engine.

{ svc := rds.New(session.New()) input := &rds.DescribeOptionGroupOptionsInput{ EngineName: aws.String("mysql"), MajorEngineVersion: aws.String("5.6"), } result, err := svc.DescribeOptionGroupOptions(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

DescribeOptionGroupOptionsPages

func (c *RDS) DescribeOptionGroupOptionsPages(input *DescribeOptionGroupOptionsInput, fn func(*DescribeOptionGroupOptionsOutput, bool) bool) error

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

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

See Also

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

DescribeOptionGroupOptionsPagesWithContext

func (c *RDS) DescribeOptionGroupOptionsPagesWithContext(ctx aws.Context, input *DescribeOptionGroupOptionsInput, fn func(*DescribeOptionGroupOptionsOutput, bool) bool, opts ...request.Option) error

DescribeOptionGroupOptionsPagesWithContext same as DescribeOptionGroupOptionsPages 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.

DescribeOptionGroupOptionsRequest

func (c *RDS) DescribeOptionGroupOptionsRequest(input *DescribeOptionGroupOptionsInput) (req *request.Request, output *DescribeOptionGroupOptionsOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeOptionGroupOptions

DescribeOptionGroupOptionsWithContext

func (c *RDS) DescribeOptionGroupOptionsWithContext(ctx aws.Context, input *DescribeOptionGroupOptionsInput, opts ...request.Option) (*DescribeOptionGroupOptionsOutput, error)

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

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

DescribeOptionGroups

func (c *RDS) DescribeOptionGroups(input *DescribeOptionGroupsInput) (*DescribeOptionGroupsOutput, error)

DescribeOptionGroups API operation for Amazon Relational Database Service.

Describes the available option groups.

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 Relational Database Service's API operation DescribeOptionGroups for usage and error information.

Returned Error Codes:

  • ErrCodeOptionGroupNotFoundFault "OptionGroupNotFoundFault" The specified option group could not be found.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeOptionGroups

Example

RDS DescribeOptionGroups shared00

To list information about DB option groups

This example lists information for all option groups for the specified DB engine.

{ svc := rds.New(session.New()) input := &rds.DescribeOptionGroupsInput{ EngineName: aws.String("mysql"), MajorEngineVersion: aws.String("5.6"), } result, err := svc.DescribeOptionGroups(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeOptionGroupNotFoundFault: fmt.Println(rds.ErrCodeOptionGroupNotFoundFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

DescribeOptionGroupsPages

func (c *RDS) DescribeOptionGroupsPages(input *DescribeOptionGroupsInput, fn func(*DescribeOptionGroupsOutput, bool) bool) error

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

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

See Also

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

DescribeOptionGroupsPagesWithContext

func (c *RDS) DescribeOptionGroupsPagesWithContext(ctx aws.Context, input *DescribeOptionGroupsInput, fn func(*DescribeOptionGroupsOutput, bool) bool, opts ...request.Option) error

DescribeOptionGroupsPagesWithContext same as DescribeOptionGroupsPages 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.

DescribeOptionGroupsRequest

func (c *RDS) DescribeOptionGroupsRequest(input *DescribeOptionGroupsInput) (req *request.Request, output *DescribeOptionGroupsOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeOptionGroups

DescribeOptionGroupsWithContext

func (c *RDS) DescribeOptionGroupsWithContext(ctx aws.Context, input *DescribeOptionGroupsInput, opts ...request.Option) (*DescribeOptionGroupsOutput, error)

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

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

DescribeOrderableDBInstanceOptions

func (c *RDS) DescribeOrderableDBInstanceOptions(input *DescribeOrderableDBInstanceOptionsInput) (*DescribeOrderableDBInstanceOptionsOutput, error)

DescribeOrderableDBInstanceOptions API operation for Amazon Relational Database Service.

Returns a list of orderable DB instance options for the specified engine.

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 Relational Database Service's API operation DescribeOrderableDBInstanceOptions for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeOrderableDBInstanceOptions

Example

RDS DescribeOrderableDBInstanceOptions shared00

To list information about orderable DB instance options

This example lists information for all orderable DB instance options for the specified DB engine, engine version, DB instance class, license model, and VPC settings.

{ svc := rds.New(session.New()) input := &rds.DescribeOrderableDBInstanceOptionsInput{ DBInstanceClass: aws.String("db.t2.micro"), Engine: aws.String("mysql"), EngineVersion: aws.String("5.6.27"), LicenseModel: aws.String("general-public-license"), Vpc: aws.Bool(true), } result, err := svc.DescribeOrderableDBInstanceOptions(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

DescribeOrderableDBInstanceOptionsPages

func (c *RDS) DescribeOrderableDBInstanceOptionsPages(input *DescribeOrderableDBInstanceOptionsInput, fn func(*DescribeOrderableDBInstanceOptionsOutput, bool) bool) error

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

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

See Also

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

DescribeOrderableDBInstanceOptionsPagesWithContext

func (c *RDS) DescribeOrderableDBInstanceOptionsPagesWithContext(ctx aws.Context, input *DescribeOrderableDBInstanceOptionsInput, fn func(*DescribeOrderableDBInstanceOptionsOutput, bool) bool, opts ...request.Option) error

DescribeOrderableDBInstanceOptionsPagesWithContext same as DescribeOrderableDBInstanceOptionsPages 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.

DescribeOrderableDBInstanceOptionsRequest

func (c *RDS) DescribeOrderableDBInstanceOptionsRequest(input *DescribeOrderableDBInstanceOptionsInput) (req *request.Request, output *DescribeOrderableDBInstanceOptionsOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeOrderableDBInstanceOptions

DescribeOrderableDBInstanceOptionsWithContext

func (c *RDS) DescribeOrderableDBInstanceOptionsWithContext(ctx aws.Context, input *DescribeOrderableDBInstanceOptionsInput, opts ...request.Option) (*DescribeOrderableDBInstanceOptionsOutput, error)

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

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

DescribePendingMaintenanceActions

func (c *RDS) DescribePendingMaintenanceActions(input *DescribePendingMaintenanceActionsInput) (*DescribePendingMaintenanceActionsOutput, error)

DescribePendingMaintenanceActions API operation for Amazon Relational Database Service.

Returns a list of resources (for example, DB instances) that have at least one pending maintenance action.

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 Relational Database Service's API operation DescribePendingMaintenanceActions for usage and error information.

Returned Error Codes:

  • ErrCodeResourceNotFoundFault "ResourceNotFoundFault" The specified resource ID was not found.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribePendingMaintenanceActions

Example

RDS DescribePendingMaintenanceActions shared00

To list information about pending maintenance actions

This example lists information for all pending maintenance actions for the specified DB instance.

{ svc := rds.New(session.New()) input := &rds.DescribePendingMaintenanceActionsInput{ ResourceIdentifier: aws.String("arn:aws:rds:us-east-1:992648334831:db:mymysqlinstance"), } result, err := svc.DescribePendingMaintenanceActions(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeResourceNotFoundFault: fmt.Println(rds.ErrCodeResourceNotFoundFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

DescribePendingMaintenanceActionsRequest

func (c *RDS) DescribePendingMaintenanceActionsRequest(input *DescribePendingMaintenanceActionsInput) (req *request.Request, output *DescribePendingMaintenanceActionsOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribePendingMaintenanceActions

DescribePendingMaintenanceActionsWithContext

func (c *RDS) DescribePendingMaintenanceActionsWithContext(ctx aws.Context, input *DescribePendingMaintenanceActionsInput, opts ...request.Option) (*DescribePendingMaintenanceActionsOutput, error)

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

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

DescribeReservedDBInstances

func (c *RDS) DescribeReservedDBInstances(input *DescribeReservedDBInstancesInput) (*DescribeReservedDBInstancesOutput, error)

DescribeReservedDBInstances API operation for Amazon Relational Database Service.

Returns information about reserved DB instances for this account, or about a specified reserved DB instance.

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 Relational Database Service's API operation DescribeReservedDBInstances for usage and error information.

Returned Error Codes:

  • ErrCodeReservedDBInstanceNotFoundFault "ReservedDBInstanceNotFound" The specified reserved DB Instance not found.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeReservedDBInstances

Example

RDS DescribeReservedDBInstances shared00

To list information about reserved DB instances

This example lists information for all reserved DB instances for the specified DB instance class, duration, product, offering type, and availability zone settings.

{ svc := rds.New(session.New()) input := &rds.DescribeReservedDBInstancesInput{ DBInstanceClass: aws.String("db.t2.micro"), Duration: aws.String("1y"), MultiAZ: aws.Bool(false), OfferingType: aws.String("No Upfront"), ProductDescription: aws.String("mysql"), } result, err := svc.DescribeReservedDBInstances(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeReservedDBInstanceNotFoundFault: fmt.Println(rds.ErrCodeReservedDBInstanceNotFoundFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

DescribeReservedDBInstancesOfferings

func (c *RDS) DescribeReservedDBInstancesOfferings(input *DescribeReservedDBInstancesOfferingsInput) (*DescribeReservedDBInstancesOfferingsOutput, error)

DescribeReservedDBInstancesOfferings API operation for Amazon Relational Database Service.

Lists available reserved DB instance offerings.

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 Relational Database Service's API operation DescribeReservedDBInstancesOfferings for usage and error information.

Returned Error Codes:

  • ErrCodeReservedDBInstancesOfferingNotFoundFault "ReservedDBInstancesOfferingNotFound" Specified offering does not exist.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeReservedDBInstancesOfferings

Example

RDS DescribeReservedDBInstancesOfferings shared00

To list information about reserved DB instance offerings

This example lists information for all reserved DB instance offerings for the specified DB instance class, duration, product, offering type, and availability zone settings.

{ svc := rds.New(session.New()) input := &rds.DescribeReservedDBInstancesOfferingsInput{ DBInstanceClass: aws.String("db.t2.micro"), Duration: aws.String("1y"), MultiAZ: aws.Bool(false), OfferingType: aws.String("No Upfront"), ProductDescription: aws.String("mysql"), } result, err := svc.DescribeReservedDBInstancesOfferings(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeReservedDBInstancesOfferingNotFoundFault: fmt.Println(rds.ErrCodeReservedDBInstancesOfferingNotFoundFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

DescribeReservedDBInstancesOfferingsPages

func (c *RDS) DescribeReservedDBInstancesOfferingsPages(input *DescribeReservedDBInstancesOfferingsInput, fn func(*DescribeReservedDBInstancesOfferingsOutput, bool) bool) error

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

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

See Also

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

DescribeReservedDBInstancesOfferingsPagesWithContext

func (c *RDS) DescribeReservedDBInstancesOfferingsPagesWithContext(ctx aws.Context, input *DescribeReservedDBInstancesOfferingsInput, fn func(*DescribeReservedDBInstancesOfferingsOutput, bool) bool, opts ...request.Option) error

DescribeReservedDBInstancesOfferingsPagesWithContext same as DescribeReservedDBInstancesOfferingsPages 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.

DescribeReservedDBInstancesOfferingsRequest

func (c *RDS) DescribeReservedDBInstancesOfferingsRequest(input *DescribeReservedDBInstancesOfferingsInput) (req *request.Request, output *DescribeReservedDBInstancesOfferingsOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeReservedDBInstancesOfferings

DescribeReservedDBInstancesOfferingsWithContext

func (c *RDS) DescribeReservedDBInstancesOfferingsWithContext(ctx aws.Context, input *DescribeReservedDBInstancesOfferingsInput, opts ...request.Option) (*DescribeReservedDBInstancesOfferingsOutput, error)

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

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

DescribeReservedDBInstancesPages

func (c *RDS) DescribeReservedDBInstancesPages(input *DescribeReservedDBInstancesInput, fn func(*DescribeReservedDBInstancesOutput, bool) bool) error

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

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

See Also

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

DescribeReservedDBInstancesPagesWithContext

func (c *RDS) DescribeReservedDBInstancesPagesWithContext(ctx aws.Context, input *DescribeReservedDBInstancesInput, fn func(*DescribeReservedDBInstancesOutput, bool) bool, opts ...request.Option) error

DescribeReservedDBInstancesPagesWithContext same as DescribeReservedDBInstancesPages 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.

DescribeReservedDBInstancesRequest

func (c *RDS) DescribeReservedDBInstancesRequest(input *DescribeReservedDBInstancesInput) (req *request.Request, output *DescribeReservedDBInstancesOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeReservedDBInstances

DescribeReservedDBInstancesWithContext

func (c *RDS) DescribeReservedDBInstancesWithContext(ctx aws.Context, input *DescribeReservedDBInstancesInput, opts ...request.Option) (*DescribeReservedDBInstancesOutput, error)

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

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

DescribeSourceRegions

func (c *RDS) DescribeSourceRegions(input *DescribeSourceRegionsInput) (*DescribeSourceRegionsOutput, error)

DescribeSourceRegions API operation for Amazon Relational Database Service.

Returns a list of the source AWS Regions where the current AWS Region can create a Read Replica or copy a DB snapshot from. This API action supports pagination.

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 Relational Database Service's API operation DescribeSourceRegions for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeSourceRegions

Example

RDS DescribeSourceRegions shared00

To describe source regions

To list the AWS regions where a Read Replica can be created.

{ svc := rds.New(session.New()) input := &rds.DescribeSourceRegionsInput{} result, err := svc.DescribeSourceRegions(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

DescribeSourceRegionsRequest

func (c *RDS) DescribeSourceRegionsRequest(input *DescribeSourceRegionsInput) (req *request.Request, output *DescribeSourceRegionsOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeSourceRegions

DescribeSourceRegionsWithContext

func (c *RDS) DescribeSourceRegionsWithContext(ctx aws.Context, input *DescribeSourceRegionsInput, opts ...request.Option) (*DescribeSourceRegionsOutput, error)

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

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

DescribeValidDBInstanceModifications

func (c *RDS) DescribeValidDBInstanceModifications(input *DescribeValidDBInstanceModificationsInput) (*DescribeValidDBInstanceModificationsOutput, error)

DescribeValidDBInstanceModifications API operation for Amazon Relational Database Service.

You can call DescribeValidDBInstanceModifications to learn what modifications you can make to your DB instance. You can use this information when you call ModifyDBInstance.

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 Relational Database Service's API operation DescribeValidDBInstanceModifications for usage and error information.

Returned Error Codes:

  • ErrCodeDBInstanceNotFoundFault "DBInstanceNotFound" DBInstanceIdentifier doesn't refer to an existing DB instance.

  • ErrCodeInvalidDBInstanceStateFault "InvalidDBInstanceState" The DB instance isn't in a valid state.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeValidDBInstanceModifications

DescribeValidDBInstanceModificationsRequest

func (c *RDS) DescribeValidDBInstanceModificationsRequest(input *DescribeValidDBInstanceModificationsInput) (req *request.Request, output *DescribeValidDBInstanceModificationsOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeValidDBInstanceModifications

DescribeValidDBInstanceModificationsWithContext

func (c *RDS) DescribeValidDBInstanceModificationsWithContext(ctx aws.Context, input *DescribeValidDBInstanceModificationsInput, opts ...request.Option) (*DescribeValidDBInstanceModificationsOutput, error)

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

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

DownloadDBLogFilePortion

func (c *RDS) DownloadDBLogFilePortion(input *DownloadDBLogFilePortionInput) (*DownloadDBLogFilePortionOutput, error)

DownloadDBLogFilePortion API operation for Amazon Relational Database Service.

Downloads all or a portion of the specified log file, up to 1 MB in size.

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 Relational Database Service's API operation DownloadDBLogFilePortion for usage and error information.

Returned Error Codes:

  • ErrCodeDBInstanceNotFoundFault "DBInstanceNotFound" DBInstanceIdentifier doesn't refer to an existing DB instance.

  • ErrCodeDBLogFileNotFoundFault "DBLogFileNotFoundFault" LogFileName doesn't refer to an existing DB log file.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DownloadDBLogFilePortion

Example

RDS DownloadDBLogFilePortion shared00

To list information about DB log files

This example lists information for the specified log file for the specified DB instance.

{ svc := rds.New(session.New()) input := &rds.DownloadDBLogFilePortionInput{ DBInstanceIdentifier: aws.String("mymysqlinstance"), LogFileName: aws.String("mysqlUpgrade"), } result, err := svc.DownloadDBLogFilePortion(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeDBInstanceNotFoundFault: fmt.Println(rds.ErrCodeDBInstanceNotFoundFault, aerr.Error()) case rds.ErrCodeDBLogFileNotFoundFault: fmt.Println(rds.ErrCodeDBLogFileNotFoundFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

DownloadDBLogFilePortionPages

func (c *RDS) DownloadDBLogFilePortionPages(input *DownloadDBLogFilePortionInput, fn func(*DownloadDBLogFilePortionOutput, bool) bool) error

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

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

See Also

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

DownloadDBLogFilePortionPagesWithContext

func (c *RDS) DownloadDBLogFilePortionPagesWithContext(ctx aws.Context, input *DownloadDBLogFilePortionInput, fn func(*DownloadDBLogFilePortionOutput, bool) bool, opts ...request.Option) error

DownloadDBLogFilePortionPagesWithContext same as DownloadDBLogFilePortionPages 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.

DownloadDBLogFilePortionRequest

func (c *RDS) DownloadDBLogFilePortionRequest(input *DownloadDBLogFilePortionInput) (req *request.Request, output *DownloadDBLogFilePortionOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DownloadDBLogFilePortion

DownloadDBLogFilePortionWithContext

func (c *RDS) DownloadDBLogFilePortionWithContext(ctx aws.Context, input *DownloadDBLogFilePortionInput, opts ...request.Option) (*DownloadDBLogFilePortionOutput, error)

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

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

FailoverDBCluster

func (c *RDS) FailoverDBCluster(input *FailoverDBClusterInput) (*FailoverDBClusterOutput, error)

FailoverDBCluster API operation for Amazon Relational Database Service.

Forces a failover for a DB cluster.

A failover for a DB cluster promotes one of the Aurora Replicas (read-only instances) in the DB cluster to be the primary instance (the cluster writer).

Amazon Aurora will automatically fail over to an Aurora Replica, if one exists, when the primary instance fails. You can force a failover when you want to simulate a failure of a primary instance for testing. Because each instance in a DB cluster has its own endpoint address, you will need to clean up and re-establish any existing connections that use those endpoint addresses when the failover is complete.

For more information on Amazon Aurora, see What Is Amazon Aurora? (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html) in the Amazon Aurora 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 Relational Database Service's API operation FailoverDBCluster for usage and error information.

Returned Error Codes:

  • ErrCodeDBClusterNotFoundFault "DBClusterNotFoundFault" DBClusterIdentifier doesn't refer to an existing DB cluster.

  • ErrCodeInvalidDBClusterStateFault "InvalidDBClusterStateFault" The requested operation can't be performed while the cluster is in this state.

  • ErrCodeInvalidDBInstanceStateFault "InvalidDBInstanceState" The DB instance isn't in a valid state.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/FailoverDBCluster

Example

RDS FailoverDBCluster shared00

To perform a failover for a DB cluster

This example performs a failover for the specified DB cluster to the specified DB instance.

{ svc := rds.New(session.New()) input := &rds.FailoverDBClusterInput{ DBClusterIdentifier: aws.String("myaurorainstance-cluster"), TargetDBInstanceIdentifier: aws.String("myaurorareplica"), } result, err := svc.FailoverDBCluster(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeDBClusterNotFoundFault: fmt.Println(rds.ErrCodeDBClusterNotFoundFault, aerr.Error()) case rds.ErrCodeInvalidDBClusterStateFault: fmt.Println(rds.ErrCodeInvalidDBClusterStateFault, aerr.Error()) case rds.ErrCodeInvalidDBInstanceStateFault: fmt.Println(rds.ErrCodeInvalidDBInstanceStateFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

FailoverDBClusterRequest

func (c *RDS) FailoverDBClusterRequest(input *FailoverDBClusterInput) (req *request.Request, output *FailoverDBClusterOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/FailoverDBCluster

FailoverDBClusterWithContext

func (c *RDS) FailoverDBClusterWithContext(ctx aws.Context, input *FailoverDBClusterInput, opts ...request.Option) (*FailoverDBClusterOutput, error)

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

See FailoverDBCluster 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 *RDS) ListTagsForResource(input *ListTagsForResourceInput) (*ListTagsForResourceOutput, error)

ListTagsForResource API operation for Amazon Relational Database Service.

Lists all tags on an Amazon RDS resource.

For an overview on tagging an Amazon RDS resource, see Tagging Amazon RDS Resources (https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Overview.Tagging.html) in the Amazon RDS 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 Relational Database Service's API operation ListTagsForResource for usage and error information.

Returned Error Codes:

  • ErrCodeDBInstanceNotFoundFault "DBInstanceNotFound" DBInstanceIdentifier doesn't refer to an existing DB instance.

  • ErrCodeDBSnapshotNotFoundFault "DBSnapshotNotFound" DBSnapshotIdentifier doesn't refer to an existing DB snapshot.

  • ErrCodeDBClusterNotFoundFault "DBClusterNotFoundFault" DBClusterIdentifier doesn't refer to an existing DB cluster.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ListTagsForResource

Example

RDS ListTagsForResource shared00

To list information about tags associated with a resource

This example lists information about all tags associated with the specified DB option group.

{ svc := rds.New(session.New()) input := &rds.ListTagsForResourceInput{ ResourceName: aws.String("arn:aws:rds:us-east-1:992648334831:og:mymysqloptiongroup"), } result, err := svc.ListTagsForResource(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeDBInstanceNotFoundFault: fmt.Println(rds.ErrCodeDBInstanceNotFoundFault, aerr.Error()) case rds.ErrCodeDBSnapshotNotFoundFault: fmt.Println(rds.ErrCodeDBSnapshotNotFoundFault, aerr.Error()) case rds.ErrCodeDBClusterNotFoundFault: fmt.Println(rds.ErrCodeDBClusterNotFoundFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

ListTagsForResourceRequest

func (c *RDS) 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/rds-2014-10-31/ListTagsForResource

ListTagsForResourceWithContext

func (c *RDS) 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.

ModifyCurrentDBClusterCapacity

func (c *RDS) ModifyCurrentDBClusterCapacity(input *ModifyCurrentDBClusterCapacityInput) (*ModifyCurrentDBClusterCapacityOutput, error)

ModifyCurrentDBClusterCapacity API operation for Amazon Relational Database Service.

Set the capacity of an Aurora Serverless DB cluster to a specific value.

Aurora Serverless scales seamlessly based on the workload on the DB cluster. In some cases, the capacity might not scale fast enough to meet a sudden change in workload, such as a large number of new transactions. Call ModifyCurrentDBClusterCapacity to set the capacity explicitly.

After this call sets the DB cluster capacity, Aurora Serverless can automatically scale the DB cluster based on the cooldown period for scaling up and the cooldown period for scaling down.

For more information about Aurora Serverless, see Using Amazon Aurora Serverless (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-serverless.html) in the Amazon Aurora User Guide.

If you call ModifyCurrentDBClusterCapacity with the default TimeoutAction, connections that prevent Aurora Serverless from finding a scaling point might be dropped. For more information about scaling points, see Autoscaling for Aurora Serverless (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-serverless.how-it-works.html#aurora-serverless.how-it-works.auto-scaling) in the Amazon Aurora 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 Relational Database Service's API operation ModifyCurrentDBClusterCapacity for usage and error information.

Returned Error Codes:

  • ErrCodeDBClusterNotFoundFault "DBClusterNotFoundFault" DBClusterIdentifier doesn't refer to an existing DB cluster.

  • ErrCodeInvalidDBClusterStateFault "InvalidDBClusterStateFault" The requested operation can't be performed while the cluster is in this state.

  • ErrCodeInvalidDBClusterCapacityFault "InvalidDBClusterCapacityFault" Capacity isn't a valid Aurora Serverless DB cluster capacity. Valid capacity values are 2, 4, 8, 16, 32, 64, 128, and 256.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyCurrentDBClusterCapacity

ModifyCurrentDBClusterCapacityRequest

func (c *RDS) ModifyCurrentDBClusterCapacityRequest(input *ModifyCurrentDBClusterCapacityInput) (req *request.Request, output *ModifyCurrentDBClusterCapacityOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyCurrentDBClusterCapacity

ModifyCurrentDBClusterCapacityWithContext

func (c *RDS) ModifyCurrentDBClusterCapacityWithContext(ctx aws.Context, input *ModifyCurrentDBClusterCapacityInput, opts ...request.Option) (*ModifyCurrentDBClusterCapacityOutput, error)

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

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

ModifyDBCluster

func (c *RDS) ModifyDBCluster(input *ModifyDBClusterInput) (*ModifyDBClusterOutput, error)

ModifyDBCluster API operation for Amazon Relational Database Service.

Modify a setting for an Amazon Aurora DB cluster. You can change one or more database configuration parameters by specifying these parameters and the new values in the request. For more information on Amazon Aurora, see What Is Amazon Aurora? (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html) in the Amazon Aurora 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 Relational Database Service's API operation ModifyDBCluster for usage and error information.

Returned Error Codes:

  • ErrCodeDBClusterNotFoundFault "DBClusterNotFoundFault" DBClusterIdentifier doesn't refer to an existing DB cluster.

  • ErrCodeInvalidDBClusterStateFault "InvalidDBClusterStateFault" The requested operation can't be performed while the cluster is in this state.

  • ErrCodeStorageQuotaExceededFault "StorageQuotaExceeded" The request would result in the user exceeding the allowed amount of storage available across all DB instances.

  • ErrCodeDBSubnetGroupNotFoundFault "DBSubnetGroupNotFoundFault" DBSubnetGroupName doesn't refer to an existing DB subnet group.

  • ErrCodeInvalidVPCNetworkStateFault "InvalidVPCNetworkStateFault" The DB subnet group doesn't cover all Availability Zones after it's created because of users' change.

  • ErrCodeInvalidDBSubnetGroupStateFault "InvalidDBSubnetGroupStateFault" The DB subnet group cannot be deleted because it's in use.

  • ErrCodeInvalidSubnet "InvalidSubnet" The requested subnet is invalid, or multiple subnets were requested that are not all in a common VPC.

  • ErrCodeDBClusterParameterGroupNotFoundFault "DBClusterParameterGroupNotFound" DBClusterParameterGroupName doesn't refer to an existing DB cluster parameter group.

  • ErrCodeInvalidDBSecurityGroupStateFault "InvalidDBSecurityGroupState" The state of the DB security group doesn't allow deletion.

  • ErrCodeInvalidDBInstanceStateFault "InvalidDBInstanceState" The DB instance isn't in a valid state.

  • ErrCodeDBClusterAlreadyExistsFault "DBClusterAlreadyExistsFault" The user already has a DB cluster with the given identifier.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyDBCluster

Example

RDS ModifyDBCluster shared00

To change DB cluster settings

This example changes the specified settings for the specified DB cluster.

{ svc := rds.New(session.New()) input := &rds.ModifyDBClusterInput{ ApplyImmediately: aws.Bool(true), DBClusterIdentifier: aws.String("mydbcluster"), MasterUserPassword: aws.String("mynewpassword"), NewDBClusterIdentifier: aws.String("mynewdbcluster"), PreferredBackupWindow: aws.String("04:00-04:30"), PreferredMaintenanceWindow: aws.String("Tue:05:00-Tue:05:30"), } result, err := svc.ModifyDBCluster(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeDBClusterNotFoundFault: fmt.Println(rds.ErrCodeDBClusterNotFoundFault, aerr.Error()) case rds.ErrCodeInvalidDBClusterStateFault: fmt.Println(rds.ErrCodeInvalidDBClusterStateFault, aerr.Error()) case rds.ErrCodeStorageQuotaExceededFault: fmt.Println(rds.ErrCodeStorageQuotaExceededFault, aerr.Error()) case rds.ErrCodeDBSubnetGroupNotFoundFault: fmt.Println(rds.ErrCodeDBSubnetGroupNotFoundFault, aerr.Error()) case rds.ErrCodeInvalidVPCNetworkStateFault: fmt.Println(rds.ErrCodeInvalidVPCNetworkStateFault, aerr.Error()) case rds.ErrCodeInvalidDBSubnetGroupStateFault: fmt.Println(rds.ErrCodeInvalidDBSubnetGroupStateFault, aerr.Error()) case rds.ErrCodeInvalidSubnet: fmt.Println(rds.ErrCodeInvalidSubnet, aerr.Error()) case rds.ErrCodeDBClusterParameterGroupNotFoundFault: fmt.Println(rds.ErrCodeDBClusterParameterGroupNotFoundFault, aerr.Error()) case rds.ErrCodeInvalidDBSecurityGroupStateFault: fmt.Println(rds.ErrCodeInvalidDBSecurityGroupStateFault, aerr.Error()) case rds.ErrCodeInvalidDBInstanceStateFault: fmt.Println(rds.ErrCodeInvalidDBInstanceStateFault, aerr.Error()) case rds.ErrCodeDBClusterAlreadyExistsFault: fmt.Println(rds.ErrCodeDBClusterAlreadyExistsFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

ModifyDBClusterEndpoint

func (c *RDS) ModifyDBClusterEndpoint(input *ModifyDBClusterEndpointInput) (*ModifyDBClusterEndpointOutput, error)

ModifyDBClusterEndpoint API operation for Amazon Relational Database Service.

Modifies the properties of an endpoint in an Amazon Aurora DB cluster.

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 Relational Database Service's API operation ModifyDBClusterEndpoint for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidDBClusterStateFault "InvalidDBClusterStateFault" The requested operation can't be performed while the cluster is in this state.

  • ErrCodeInvalidDBClusterEndpointStateFault "InvalidDBClusterEndpointStateFault" The requested operation can't be performed on the endpoint while the endpoint is in this state.

  • ErrCodeDBClusterEndpointNotFoundFault "DBClusterEndpointNotFoundFault" The specified custom endpoint doesn't exist.

  • ErrCodeDBInstanceNotFoundFault "DBInstanceNotFound" DBInstanceIdentifier doesn't refer to an existing DB instance.

  • ErrCodeInvalidDBInstanceStateFault "InvalidDBInstanceState" The DB instance isn't in a valid state.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyDBClusterEndpoint

ModifyDBClusterEndpointRequest

func (c *RDS) ModifyDBClusterEndpointRequest(input *ModifyDBClusterEndpointInput) (req *request.Request, output *ModifyDBClusterEndpointOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyDBClusterEndpoint

ModifyDBClusterEndpointWithContext

func (c *RDS) ModifyDBClusterEndpointWithContext(ctx aws.Context, input *ModifyDBClusterEndpointInput, opts ...request.Option) (*ModifyDBClusterEndpointOutput, error)

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

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

ModifyDBClusterParameterGroup

func (c *RDS) ModifyDBClusterParameterGroup(input *ModifyDBClusterParameterGroupInput) (*DBClusterParameterGroupNameMessage, error)

ModifyDBClusterParameterGroup API operation for Amazon Relational Database Service.

Modifies the parameters of a DB cluster parameter group. To modify more than one parameter, submit a list of the following: ParameterName, ParameterValue, and ApplyMethod. A maximum of 20 parameters can be modified in a single request.

For more information on Amazon Aurora, see What Is Amazon Aurora? (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html) in the Amazon Aurora User Guide.

Changes to dynamic parameters are applied immediately. Changes to static parameters require a reboot without failover to the DB cluster associated with the parameter group before the change can take effect.

After you create a DB cluster parameter group, you should wait at least 5 minutes before creating your first DB cluster that uses that DB cluster parameter group as the default parameter group. This allows Amazon RDS to fully complete the create action before the parameter group is used as the default for a new DB cluster. This is especially important for parameters that are critical when creating the default database for a DB cluster, such as the character set for the default database defined by the character_set_database parameter. You can use the Parameter Groups option of the Amazon RDS console (https://console.aws.amazon.com/rds/) or the DescribeDBClusterParameters command to verify that your DB cluster parameter group has been created or modified.

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 Relational Database Service's API operation ModifyDBClusterParameterGroup for usage and error information.

Returned Error Codes:

  • ErrCodeDBParameterGroupNotFoundFault "DBParameterGroupNotFound" DBParameterGroupName doesn't refer to an existing DB parameter group.

  • ErrCodeInvalidDBParameterGroupStateFault "InvalidDBParameterGroupState" The DB parameter group is in use or is in an invalid state. If you are attempting to delete the parameter group, you can't delete it when the parameter group is in this state.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyDBClusterParameterGroup

Example

RDS ModifyDBClusterParameterGroup shared00

To change DB cluster parameter group settings

This example immediately changes the specified setting for the specified DB cluster parameter group.

{ svc := rds.New(session.New()) input := &rds.ModifyDBClusterParameterGroupInput{ DBClusterParameterGroupName: aws.String("mydbclusterparametergroup"), Parameters: []*rds.Parameter{ { ApplyMethod: aws.String("immediate"), ParameterName: aws.String("time_zone"), ParameterValue: aws.String("America/Phoenix"), }, }, } result, err := svc.ModifyDBClusterParameterGroup(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeDBParameterGroupNotFoundFault: fmt.Println(rds.ErrCodeDBParameterGroupNotFoundFault, aerr.Error()) case rds.ErrCodeInvalidDBParameterGroupStateFault: fmt.Println(rds.ErrCodeInvalidDBParameterGroupStateFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

ModifyDBClusterParameterGroupRequest

func (c *RDS) ModifyDBClusterParameterGroupRequest(input *ModifyDBClusterParameterGroupInput) (req *request.Request, output *DBClusterParameterGroupNameMessage)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyDBClusterParameterGroup

ModifyDBClusterParameterGroupWithContext

func (c *RDS) ModifyDBClusterParameterGroupWithContext(ctx aws.Context, input *ModifyDBClusterParameterGroupInput, opts ...request.Option) (*DBClusterParameterGroupNameMessage, error)

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

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

ModifyDBClusterRequest

func (c *RDS) ModifyDBClusterRequest(input *ModifyDBClusterInput) (req *request.Request, output *ModifyDBClusterOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyDBCluster

ModifyDBClusterSnapshotAttribute

func (c *RDS) ModifyDBClusterSnapshotAttribute(input *ModifyDBClusterSnapshotAttributeInput) (*ModifyDBClusterSnapshotAttributeOutput, error)

ModifyDBClusterSnapshotAttribute API operation for Amazon Relational Database Service.

Adds an attribute and values to, or removes an attribute and values from, a manual DB cluster snapshot.

To share a manual DB cluster snapshot with other AWS accounts, specify restore as the AttributeName and use the ValuesToAdd parameter to add a list of IDs of the AWS accounts that are authorized to restore the manual DB cluster snapshot. Use the value all to make the manual DB cluster snapshot public, which means that it can be copied or restored by all AWS accounts. Do not add the all value for any manual DB cluster snapshots that contain private information that you don't want available to all AWS accounts. If a manual DB cluster snapshot is encrypted, it can be shared, but only by specifying a list of authorized AWS account IDs for the ValuesToAdd parameter. You can't use all as a value for that parameter in this case.

To view which AWS accounts have access to copy or restore a manual DB cluster snapshot, or whether a manual DB cluster snapshot public or private, use the DescribeDBClusterSnapshotAttributes API action.

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 Relational Database Service's API operation ModifyDBClusterSnapshotAttribute for usage and error information.

Returned Error Codes:

  • ErrCodeDBClusterSnapshotNotFoundFault "DBClusterSnapshotNotFoundFault" DBClusterSnapshotIdentifier doesn't refer to an existing DB cluster snapshot.

  • ErrCodeInvalidDBClusterSnapshotStateFault "InvalidDBClusterSnapshotStateFault" The supplied value isn't a valid DB cluster snapshot state.

  • ErrCodeSharedSnapshotQuotaExceededFault "SharedSnapshotQuotaExceeded" You have exceeded the maximum number of accounts that you can share a manual DB snapshot with.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyDBClusterSnapshotAttribute

Example

RDS ModifyDBClusterSnapshotAttribute shared00

To add or remove access to a manual DB cluster snapshot

The following example gives two AWS accounts access to a manual DB cluster snapshot and ensures that the DB cluster snapshot is private by removing the value "all".

{ svc := rds.New(session.New()) input := &rds.ModifyDBClusterSnapshotAttributeInput{ AttributeName: aws.String("restore"), DBClusterSnapshotIdentifier: aws.String("manual-cluster-snapshot1"), ValuesToAdd: []*string{ aws.String("123451234512"), aws.String("123456789012"), }, ValuesToRemove: []*string{ aws.String("all"), }, } result, err := svc.ModifyDBClusterSnapshotAttribute(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeDBClusterSnapshotNotFoundFault: fmt.Println(rds.ErrCodeDBClusterSnapshotNotFoundFault, aerr.Error()) case rds.ErrCodeInvalidDBClusterSnapshotStateFault: fmt.Println(rds.ErrCodeInvalidDBClusterSnapshotStateFault, aerr.Error()) case rds.ErrCodeSharedSnapshotQuotaExceededFault: fmt.Println(rds.ErrCodeSharedSnapshotQuotaExceededFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

ModifyDBClusterSnapshotAttributeRequest

func (c *RDS) ModifyDBClusterSnapshotAttributeRequest(input *ModifyDBClusterSnapshotAttributeInput) (req *request.Request, output *ModifyDBClusterSnapshotAttributeOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyDBClusterSnapshotAttribute

ModifyDBClusterSnapshotAttributeWithContext

func (c *RDS) ModifyDBClusterSnapshotAttributeWithContext(ctx aws.Context, input *ModifyDBClusterSnapshotAttributeInput, opts ...request.Option) (*ModifyDBClusterSnapshotAttributeOutput, error)

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

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

ModifyDBClusterWithContext

func (c *RDS) ModifyDBClusterWithContext(ctx aws.Context, input *ModifyDBClusterInput, opts ...request.Option) (*ModifyDBClusterOutput, error)

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

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

ModifyDBInstance

func (c *RDS) ModifyDBInstance(input *ModifyDBInstanceInput) (*ModifyDBInstanceOutput, error)

ModifyDBInstance API operation for Amazon Relational Database Service.

Modifies settings for a DB instance. You can change one or more database configuration parameters by specifying these parameters and the new values in the request. To learn what modifications you can make to your DB instance, call DescribeValidDBInstanceModifications before you call ModifyDBInstance.

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 Relational Database Service's API operation ModifyDBInstance for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidDBInstanceStateFault "InvalidDBInstanceState" The DB instance isn't in a valid state.

  • ErrCodeInvalidDBSecurityGroupStateFault "InvalidDBSecurityGroupState" The state of the DB security group doesn't allow deletion.

  • ErrCodeDBInstanceAlreadyExistsFault "DBInstanceAlreadyExists" The user already has a DB instance with the given identifier.

  • ErrCodeDBInstanceNotFoundFault "DBInstanceNotFound" DBInstanceIdentifier doesn't refer to an existing DB instance.

  • ErrCodeDBSecurityGroupNotFoundFault "DBSecurityGroupNotFound" DBSecurityGroupName doesn't refer to an existing DB security group.

  • ErrCodeDBParameterGroupNotFoundFault "DBParameterGroupNotFound" DBParameterGroupName doesn't refer to an existing DB parameter group.

  • ErrCodeInsufficientDBInstanceCapacityFault "InsufficientDBInstanceCapacity" The specified DB instance class isn't available in the specified Availability Zone.

  • ErrCodeStorageQuotaExceededFault "StorageQuotaExceeded" The request would result in the user exceeding the allowed amount of storage available across all DB instances.

  • ErrCodeInvalidVPCNetworkStateFault "InvalidVPCNetworkStateFault" The DB subnet group doesn't cover all Availability Zones after it's created because of users' change.

  • ErrCodeProvisionedIopsNotAvailableInAZFault "ProvisionedIopsNotAvailableInAZFault" Provisioned IOPS not available in the specified Availability Zone.

  • ErrCodeOptionGroupNotFoundFault "OptionGroupNotFoundFault" The specified option group could not be found.

  • ErrCodeDBUpgradeDependencyFailureFault "DBUpgradeDependencyFailure" The DB upgrade failed because a resource the DB depends on can't be modified.

  • ErrCodeStorageTypeNotSupportedFault "StorageTypeNotSupported" Storage of the StorageType specified can't be associated with the DB instance.

  • ErrCodeAuthorizationNotFoundFault "AuthorizationNotFound" The specified CIDRIP or Amazon EC2 security group isn't authorized for the specified DB security group.

RDS also may not be authorized by using IAM to perform necessary actions on your behalf.
  • ErrCodeCertificateNotFoundFault "CertificateNotFound" CertificateIdentifier doesn't refer to an existing certificate.

  • ErrCodeDomainNotFoundFault "DomainNotFoundFault" Domain doesn't refer to an existing Active Directory domain.

  • ErrCodeBackupPolicyNotFoundFault "BackupPolicyNotFoundFault" The backup policy was not found.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyDBInstance

Example

RDS ModifyDBInstance shared00

To change DB instance settings

This example immediately changes the specified settings for the specified DB instance.

{ svc := rds.New(session.New()) input := &rds.ModifyDBInstanceInput{ AllocatedStorage: aws.Int64(10), ApplyImmediately: aws.Bool(true), BackupRetentionPeriod: aws.Int64(1), DBInstanceClass: aws.String("db.t2.small"), DBInstanceIdentifier: aws.String("mymysqlinstance"), MasterUserPassword: aws.String("mynewpassword"), PreferredBackupWindow: aws.String("04:00-04:30"), PreferredMaintenanceWindow: aws.String("Tue:05:00-Tue:05:30"), } result, err := svc.ModifyDBInstance(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeInvalidDBInstanceStateFault: fmt.Println(rds.ErrCodeInvalidDBInstanceStateFault, aerr.Error()) case rds.ErrCodeInvalidDBSecurityGroupStateFault: fmt.Println(rds.ErrCodeInvalidDBSecurityGroupStateFault, aerr.Error()) case rds.ErrCodeDBInstanceAlreadyExistsFault: fmt.Println(rds.ErrCodeDBInstanceAlreadyExistsFault, aerr.Error()) case rds.ErrCodeDBInstanceNotFoundFault: fmt.Println(rds.ErrCodeDBInstanceNotFoundFault, aerr.Error()) case rds.ErrCodeDBSecurityGroupNotFoundFault: fmt.Println(rds.ErrCodeDBSecurityGroupNotFoundFault, aerr.Error()) case rds.ErrCodeDBParameterGroupNotFoundFault: fmt.Println(rds.ErrCodeDBParameterGroupNotFoundFault, aerr.Error()) case rds.ErrCodeInsufficientDBInstanceCapacityFault: fmt.Println(rds.ErrCodeInsufficientDBInstanceCapacityFault, aerr.Error()) case rds.ErrCodeStorageQuotaExceededFault: fmt.Println(rds.ErrCodeStorageQuotaExceededFault, aerr.Error()) case rds.ErrCodeInvalidVPCNetworkStateFault: fmt.Println(rds.ErrCodeInvalidVPCNetworkStateFault, aerr.Error()) case rds.ErrCodeProvisionedIopsNotAvailableInAZFault: fmt.Println(rds.ErrCodeProvisionedIopsNotAvailableInAZFault, aerr.Error()) case rds.ErrCodeOptionGroupNotFoundFault: fmt.Println(rds.ErrCodeOptionGroupNotFoundFault, aerr.Error()) case rds.ErrCodeDBUpgradeDependencyFailureFault: fmt.Println(rds.ErrCodeDBUpgradeDependencyFailureFault, aerr.Error()) case rds.ErrCodeStorageTypeNotSupportedFault: fmt.Println(rds.ErrCodeStorageTypeNotSupportedFault, aerr.Error()) case rds.ErrCodeAuthorizationNotFoundFault: fmt.Println(rds.ErrCodeAuthorizationNotFoundFault, aerr.Error()) case rds.ErrCodeCertificateNotFoundFault: fmt.Println(rds.ErrCodeCertificateNotFoundFault, aerr.Error()) case rds.ErrCodeDomainNotFoundFault: fmt.Println(rds.ErrCodeDomainNotFoundFault, aerr.Error()) case rds.ErrCodeBackupPolicyNotFoundFault: fmt.Println(rds.ErrCodeBackupPolicyNotFoundFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

ModifyDBInstanceRequest

func (c *RDS) ModifyDBInstanceRequest(input *ModifyDBInstanceInput) (req *request.Request, output *ModifyDBInstanceOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyDBInstance

ModifyDBInstanceWithContext

func (c *RDS) ModifyDBInstanceWithContext(ctx aws.Context, input *ModifyDBInstanceInput, opts ...request.Option) (*ModifyDBInstanceOutput, error)

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

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

ModifyDBParameterGroup

func (c *RDS) ModifyDBParameterGroup(input *ModifyDBParameterGroupInput) (*DBParameterGroupNameMessage, error)

ModifyDBParameterGroup API operation for Amazon Relational Database Service.

Modifies the parameters of a DB parameter group. To modify more than one parameter, submit a list of the following: ParameterName, ParameterValue, and ApplyMethod. A maximum of 20 parameters can be modified in a single request.

Changes to dynamic parameters are applied immediately. Changes to static parameters require a reboot without failover to the DB instance associated with the parameter group before the change can take effect.

After you modify a DB parameter group, you should wait at least 5 minutes before creating your first DB instance that uses that DB parameter group as the default parameter group. This allows Amazon RDS to fully complete the modify action before the parameter group is used as the default for a new DB instance. This is especially important for parameters that are critical when creating the default database for a DB instance, such as the character set for the default database defined by the character_set_database parameter. You can use the Parameter Groups option of the Amazon RDS console (https://console.aws.amazon.com/rds/) or the DescribeDBParameters command to verify that your DB parameter group has been created or modified.

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 Relational Database Service's API operation ModifyDBParameterGroup for usage and error information.

Returned Error Codes:

  • ErrCodeDBParameterGroupNotFoundFault "DBParameterGroupNotFound" DBParameterGroupName doesn't refer to an existing DB parameter group.

  • ErrCodeInvalidDBParameterGroupStateFault "InvalidDBParameterGroupState" The DB parameter group is in use or is in an invalid state. If you are attempting to delete the parameter group, you can't delete it when the parameter group is in this state.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyDBParameterGroup

Example

RDS ModifyDBParameterGroup shared00

To change DB parameter group settings

This example immediately changes the specified setting for the specified DB parameter group.

{ svc := rds.New(session.New()) input := &rds.ModifyDBParameterGroupInput{ DBParameterGroupName: aws.String("mymysqlparametergroup"), Parameters: []*rds.Parameter{ { ApplyMethod: aws.String("immediate"), ParameterName: aws.String("time_zone"), ParameterValue: aws.String("America/Phoenix"), }, }, } result, err := svc.ModifyDBParameterGroup(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeDBParameterGroupNotFoundFault: fmt.Println(rds.ErrCodeDBParameterGroupNotFoundFault, aerr.Error()) case rds.ErrCodeInvalidDBParameterGroupStateFault: fmt.Println(rds.ErrCodeInvalidDBParameterGroupStateFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

ModifyDBParameterGroupRequest

func (c *RDS) ModifyDBParameterGroupRequest(input *ModifyDBParameterGroupInput) (req *request.Request, output *DBParameterGroupNameMessage)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyDBParameterGroup

ModifyDBParameterGroupWithContext

func (c *RDS) ModifyDBParameterGroupWithContext(ctx aws.Context, input *ModifyDBParameterGroupInput, opts ...request.Option) (*DBParameterGroupNameMessage, error)

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

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

ModifyDBSnapshot

func (c *RDS) ModifyDBSnapshot(input *ModifyDBSnapshotInput) (*ModifyDBSnapshotOutput, error)

ModifyDBSnapshot API operation for Amazon Relational Database Service.

Updates a manual DB snapshot, which can be encrypted or not encrypted, with a new engine version.

Amazon RDS supports upgrading DB snapshots for MySQL and Oracle.

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 Relational Database Service's API operation ModifyDBSnapshot for usage and error information.

Returned Error Codes:

  • ErrCodeDBSnapshotNotFoundFault "DBSnapshotNotFound" DBSnapshotIdentifier doesn't refer to an existing DB snapshot.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyDBSnapshot

ModifyDBSnapshotAttribute

func (c *RDS) ModifyDBSnapshotAttribute(input *ModifyDBSnapshotAttributeInput) (*ModifyDBSnapshotAttributeOutput, error)

ModifyDBSnapshotAttribute API operation for Amazon Relational Database Service.

Adds an attribute and values to, or removes an attribute and values from, a manual DB snapshot.

To share a manual DB snapshot with other AWS accounts, specify restore as the AttributeName and use the ValuesToAdd parameter to add a list of IDs of the AWS accounts that are authorized to restore the manual DB snapshot. Uses the value all to make the manual DB snapshot public, which means it can be copied or restored by all AWS accounts. Do not add the all value for any manual DB snapshots that contain private information that you don't want available to all AWS accounts. If the manual DB snapshot is encrypted, it can be shared, but only by specifying a list of authorized AWS account IDs for the ValuesToAdd parameter. You can't use all as a value for that parameter in this case.

To view which AWS accounts have access to copy or restore a manual DB snapshot, or whether a manual DB snapshot public or private, use the DescribeDBSnapshotAttributes API action.

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 Relational Database Service's API operation ModifyDBSnapshotAttribute for usage and error information.

Returned Error Codes:

  • ErrCodeDBSnapshotNotFoundFault "DBSnapshotNotFound" DBSnapshotIdentifier doesn't refer to an existing DB snapshot.

  • ErrCodeInvalidDBSnapshotStateFault "InvalidDBSnapshotState" The state of the DB snapshot doesn't allow deletion.

  • ErrCodeSharedSnapshotQuotaExceededFault "SharedSnapshotQuotaExceeded" You have exceeded the maximum number of accounts that you can share a manual DB snapshot with.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyDBSnapshotAttribute

Example

RDS ModifyDBSnapshotAttribute shared00

To change DB snapshot attributes

This example adds the specified attribute for the specified DB snapshot.

{ svc := rds.New(session.New()) input := &rds.ModifyDBSnapshotAttributeInput{ AttributeName: aws.String("restore"), DBSnapshotIdentifier: aws.String("mydbsnapshot"), ValuesToAdd: []*string{ aws.String("all"), }, } result, err := svc.ModifyDBSnapshotAttribute(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeDBSnapshotNotFoundFault: fmt.Println(rds.ErrCodeDBSnapshotNotFoundFault, aerr.Error()) case rds.ErrCodeInvalidDBSnapshotStateFault: fmt.Println(rds.ErrCodeInvalidDBSnapshotStateFault, aerr.Error()) case rds.ErrCodeSharedSnapshotQuotaExceededFault: fmt.Println(rds.ErrCodeSharedSnapshotQuotaExceededFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

ModifyDBSnapshotAttributeRequest

func (c *RDS) ModifyDBSnapshotAttributeRequest(input *ModifyDBSnapshotAttributeInput) (req *request.Request, output *ModifyDBSnapshotAttributeOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyDBSnapshotAttribute

ModifyDBSnapshotAttributeWithContext

func (c *RDS) ModifyDBSnapshotAttributeWithContext(ctx aws.Context, input *ModifyDBSnapshotAttributeInput, opts ...request.Option) (*ModifyDBSnapshotAttributeOutput, error)

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

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

ModifyDBSnapshotRequest

func (c *RDS) ModifyDBSnapshotRequest(input *ModifyDBSnapshotInput) (req *request.Request, output *ModifyDBSnapshotOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyDBSnapshot

ModifyDBSnapshotWithContext

func (c *RDS) ModifyDBSnapshotWithContext(ctx aws.Context, input *ModifyDBSnapshotInput, opts ...request.Option) (*ModifyDBSnapshotOutput, error)

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

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

ModifyDBSubnetGroup

func (c *RDS) ModifyDBSubnetGroup(input *ModifyDBSubnetGroupInput) (*ModifyDBSubnetGroupOutput, error)

ModifyDBSubnetGroup API operation for Amazon Relational Database Service.

Modifies an existing DB subnet group. DB subnet groups must contain at least one subnet in at least two AZs in the AWS Region.

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 Relational Database Service's API operation ModifyDBSubnetGroup for usage and error information.

Returned Error Codes:

  • ErrCodeDBSubnetGroupNotFoundFault "DBSubnetGroupNotFoundFault" DBSubnetGroupName doesn't refer to an existing DB subnet group.

  • ErrCodeDBSubnetQuotaExceededFault "DBSubnetQuotaExceededFault" The request would result in the user exceeding the allowed number of subnets in a DB subnet groups.

  • ErrCodeSubnetAlreadyInUse "SubnetAlreadyInUse" The DB subnet is already in use in the Availability Zone.

  • ErrCodeDBSubnetGroupDoesNotCoverEnoughAZs "DBSubnetGroupDoesNotCoverEnoughAZs" Subnets in the DB subnet group should cover at least two Availability Zones unless there is only one Availability Zone.

  • ErrCodeInvalidSubnet "InvalidSubnet" The requested subnet is invalid, or multiple subnets were requested that are not all in a common VPC.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyDBSubnetGroup

Example

RDS ModifyDBSubnetGroup shared00

To change DB subnet group settings

This example changes the specified setting for the specified DB subnet group.

{ svc := rds.New(session.New()) input := &rds.ModifyDBSubnetGroupInput{ DBSubnetGroupName: aws.String("mydbsubnetgroup"), SubnetIds: []*string{ aws.String("subnet-70e1975a"), aws.String("subnet-747a5c49"), }, } result, err := svc.ModifyDBSubnetGroup(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeDBSubnetGroupNotFoundFault: fmt.Println(rds.ErrCodeDBSubnetGroupNotFoundFault, aerr.Error()) case rds.ErrCodeDBSubnetQuotaExceededFault: fmt.Println(rds.ErrCodeDBSubnetQuotaExceededFault, aerr.Error()) case rds.ErrCodeSubnetAlreadyInUse: fmt.Println(rds.ErrCodeSubnetAlreadyInUse, aerr.Error()) case rds.ErrCodeDBSubnetGroupDoesNotCoverEnoughAZs: fmt.Println(rds.ErrCodeDBSubnetGroupDoesNotCoverEnoughAZs, aerr.Error()) case rds.ErrCodeInvalidSubnet: fmt.Println(rds.ErrCodeInvalidSubnet, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

ModifyDBSubnetGroupRequest

func (c *RDS) ModifyDBSubnetGroupRequest(input *ModifyDBSubnetGroupInput) (req *request.Request, output *ModifyDBSubnetGroupOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyDBSubnetGroup

ModifyDBSubnetGroupWithContext

func (c *RDS) ModifyDBSubnetGroupWithContext(ctx aws.Context, input *ModifyDBSubnetGroupInput, opts ...request.Option) (*ModifyDBSubnetGroupOutput, error)

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

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

ModifyEventSubscription

func (c *RDS) ModifyEventSubscription(input *ModifyEventSubscriptionInput) (*ModifyEventSubscriptionOutput, error)

ModifyEventSubscription API operation for Amazon Relational Database Service.

Modifies an existing RDS event notification subscription. Note that you can't modify the source identifiers using this call; to change source identifiers for a subscription, use the AddSourceIdentifierToSubscription and RemoveSourceIdentifierFromSubscription calls.

You can see a list of the event categories for a given SourceType in the Events (https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Events.html) topic in the Amazon RDS User Guide or by using the DescribeEventCategories action.

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 Relational Database Service's API operation ModifyEventSubscription for usage and error information.

Returned Error Codes:

  • ErrCodeEventSubscriptionQuotaExceededFault "EventSubscriptionQuotaExceeded" You have reached the maximum number of event subscriptions.

  • ErrCodeSubscriptionNotFoundFault "SubscriptionNotFound" The subscription name does not exist.

  • ErrCodeSNSInvalidTopicFault "SNSInvalidTopic" SNS has responded that there is a problem with the SND topic specified.

  • ErrCodeSNSNoAuthorizationFault "SNSNoAuthorization" You do not have permission to publish to the SNS topic ARN.

  • ErrCodeSNSTopicArnNotFoundFault "SNSTopicArnNotFound" The SNS topic ARN does not exist.

  • ErrCodeSubscriptionCategoryNotFoundFault "SubscriptionCategoryNotFound" The supplied category does not exist.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyEventSubscription

Example

RDS ModifyEventSubscription shared00

To change event notification subscription settings

This example changes the specified setting for the specified event notification subscription.

{ svc := rds.New(session.New()) input := &rds.ModifyEventSubscriptionInput{ Enabled: aws.Bool(true), EventCategories: []*string{ aws.String("deletion"), aws.String("low storage"), }, SourceType: aws.String("db-instance"), SubscriptionName: aws.String("mymysqleventsubscription"), } result, err := svc.ModifyEventSubscription(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeEventSubscriptionQuotaExceededFault: fmt.Println(rds.ErrCodeEventSubscriptionQuotaExceededFault, aerr.Error()) case rds.ErrCodeSubscriptionNotFoundFault: fmt.Println(rds.ErrCodeSubscriptionNotFoundFault, aerr.Error()) case rds.ErrCodeSNSInvalidTopicFault: fmt.Println(rds.ErrCodeSNSInvalidTopicFault, aerr.Error()) case rds.ErrCodeSNSNoAuthorizationFault: fmt.Println(rds.ErrCodeSNSNoAuthorizationFault, aerr.Error()) case rds.ErrCodeSNSTopicArnNotFoundFault: fmt.Println(rds.ErrCodeSNSTopicArnNotFoundFault, aerr.Error()) case rds.ErrCodeSubscriptionCategoryNotFoundFault: fmt.Println(rds.ErrCodeSubscriptionCategoryNotFoundFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

ModifyEventSubscriptionRequest

func (c *RDS) ModifyEventSubscriptionRequest(input *ModifyEventSubscriptionInput) (req *request.Request, output *ModifyEventSubscriptionOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyEventSubscription

ModifyEventSubscriptionWithContext

func (c *RDS) ModifyEventSubscriptionWithContext(ctx aws.Context, input *ModifyEventSubscriptionInput, opts ...request.Option) (*ModifyEventSubscriptionOutput, error)

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

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

ModifyGlobalCluster

func (c *RDS) ModifyGlobalCluster(input *ModifyGlobalClusterInput) (*ModifyGlobalClusterOutput, error)

ModifyGlobalCluster API operation for Amazon Relational Database Service.

Modify a setting for an Amazon Aurora global cluster. You can change one or more database configuration parameters by specifying these parameters and the new values in the request. For more information on Amazon Aurora, see What Is Amazon Aurora? (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html) in the Amazon Aurora 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 Relational Database Service's API operation ModifyGlobalCluster for usage and error information.

Returned Error Codes:

  • ErrCodeGlobalClusterNotFoundFault "GlobalClusterNotFoundFault"

  • ErrCodeInvalidGlobalClusterStateFault "InvalidGlobalClusterStateFault"

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyGlobalCluster

ModifyGlobalClusterRequest

func (c *RDS) ModifyGlobalClusterRequest(input *ModifyGlobalClusterInput) (req *request.Request, output *ModifyGlobalClusterOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyGlobalCluster

ModifyGlobalClusterWithContext

func (c *RDS) ModifyGlobalClusterWithContext(ctx aws.Context, input *ModifyGlobalClusterInput, opts ...request.Option) (*ModifyGlobalClusterOutput, error)

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

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

ModifyOptionGroup

func (c *RDS) ModifyOptionGroup(input *ModifyOptionGroupInput) (*ModifyOptionGroupOutput, error)

ModifyOptionGroup API operation for Amazon Relational Database Service.

Modifies an existing option group.

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 Relational Database Service's API operation ModifyOptionGroup for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidOptionGroupStateFault "InvalidOptionGroupStateFault" The option group isn't in the available state.

  • ErrCodeOptionGroupNotFoundFault "OptionGroupNotFoundFault" The specified option group could not be found.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyOptionGroup

Example

RDS ModifyOptionGroup shared00

To modify an option group

The following example adds an option to an option group.

{ svc := rds.New(session.New()) input := &rds.ModifyOptionGroupInput{ ApplyImmediately: aws.Bool(true), OptionGroupName: aws.String("myawsuser-og02"), OptionsToInclude: []*rds.OptionConfiguration{ { DBSecurityGroupMemberships: []*string{ aws.String("default"), }, OptionName: aws.String("MEMCACHED"), }, }, } result, err := svc.ModifyOptionGroup(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeInvalidOptionGroupStateFault: fmt.Println(rds.ErrCodeInvalidOptionGroupStateFault, aerr.Error()) case rds.ErrCodeOptionGroupNotFoundFault: fmt.Println(rds.ErrCodeOptionGroupNotFoundFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

ModifyOptionGroupRequest

func (c *RDS) ModifyOptionGroupRequest(input *ModifyOptionGroupInput) (req *request.Request, output *ModifyOptionGroupOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyOptionGroup

ModifyOptionGroupWithContext

func (c *RDS) ModifyOptionGroupWithContext(ctx aws.Context, input *ModifyOptionGroupInput, opts ...request.Option) (*ModifyOptionGroupOutput, error)

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

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

PromoteReadReplica

func (c *RDS) PromoteReadReplica(input *PromoteReadReplicaInput) (*PromoteReadReplicaOutput, error)

PromoteReadReplica API operation for Amazon Relational Database Service.

Promotes a Read Replica DB instance to a standalone DB instance.

Backup duration is a function of the amount of changes to the database since the previous backup. If you plan to promote a Read Replica to a standalone instance, we recommend that you enable backups and complete at least one backup prior to promotion. In addition, a Read Replica cannot be promoted to a standalone instance when it is in the backing-up status. If you have enabled backups on your Read Replica, configure the automated backup window so that daily backups do not interfere with Read Replica promotion.

This command doesn't apply to Aurora MySQL and Aurora PostgreSQL.

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 Relational Database Service's API operation PromoteReadReplica for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidDBInstanceStateFault "InvalidDBInstanceState" The DB instance isn't in a valid state.

  • ErrCodeDBInstanceNotFoundFault "DBInstanceNotFound" DBInstanceIdentifier doesn't refer to an existing DB instance.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/PromoteReadReplica

Example

RDS PromoteReadReplica shared00

To promote a read replica

This example promotes the specified read replica and sets its backup retention period and preferred backup window.

{ svc := rds.New(session.New()) input := &rds.PromoteReadReplicaInput{ BackupRetentionPeriod: aws.Int64(1), DBInstanceIdentifier: aws.String("mydbreadreplica"), PreferredBackupWindow: aws.String("03:30-04:00"), } result, err := svc.PromoteReadReplica(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeInvalidDBInstanceStateFault: fmt.Println(rds.ErrCodeInvalidDBInstanceStateFault, aerr.Error()) case rds.ErrCodeDBInstanceNotFoundFault: fmt.Println(rds.ErrCodeDBInstanceNotFoundFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

PromoteReadReplicaDBCluster

func (c *RDS) PromoteReadReplicaDBCluster(input *PromoteReadReplicaDBClusterInput) (*PromoteReadReplicaDBClusterOutput, error)

PromoteReadReplicaDBCluster API operation for Amazon Relational Database Service.

Promotes a Read Replica DB cluster to a standalone DB cluster.

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 Relational Database Service's API operation PromoteReadReplicaDBCluster for usage and error information.

Returned Error Codes:

  • ErrCodeDBClusterNotFoundFault "DBClusterNotFoundFault" DBClusterIdentifier doesn't refer to an existing DB cluster.

  • ErrCodeInvalidDBClusterStateFault "InvalidDBClusterStateFault" The requested operation can't be performed while the cluster is in this state.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/PromoteReadReplicaDBCluster

PromoteReadReplicaDBClusterRequest

func (c *RDS) PromoteReadReplicaDBClusterRequest(input *PromoteReadReplicaDBClusterInput) (req *request.Request, output *PromoteReadReplicaDBClusterOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/PromoteReadReplicaDBCluster

PromoteReadReplicaDBClusterWithContext

func (c *RDS) PromoteReadReplicaDBClusterWithContext(ctx aws.Context, input *PromoteReadReplicaDBClusterInput, opts ...request.Option) (*PromoteReadReplicaDBClusterOutput, error)

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

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

PromoteReadReplicaRequest

func (c *RDS) PromoteReadReplicaRequest(input *PromoteReadReplicaInput) (req *request.Request, output *PromoteReadReplicaOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/PromoteReadReplica

PromoteReadReplicaWithContext

func (c *RDS) PromoteReadReplicaWithContext(ctx aws.Context, input *PromoteReadReplicaInput, opts ...request.Option) (*PromoteReadReplicaOutput, error)

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

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

PurchaseReservedDBInstancesOffering

func (c *RDS) PurchaseReservedDBInstancesOffering(input *PurchaseReservedDBInstancesOfferingInput) (*PurchaseReservedDBInstancesOfferingOutput, error)

PurchaseReservedDBInstancesOffering API operation for Amazon Relational Database Service.

Purchases a reserved DB instance offering.

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 Relational Database Service's API operation PurchaseReservedDBInstancesOffering for usage and error information.

Returned Error Codes:

  • ErrCodeReservedDBInstancesOfferingNotFoundFault "ReservedDBInstancesOfferingNotFound" Specified offering does not exist.

  • ErrCodeReservedDBInstanceAlreadyExistsFault "ReservedDBInstanceAlreadyExists" User already has a reservation with the given identifier.

  • ErrCodeReservedDBInstanceQuotaExceededFault "ReservedDBInstanceQuotaExceeded" Request would exceed the user's DB Instance quota.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/PurchaseReservedDBInstancesOffering

Example

RDS PurchaseReservedDBInstancesOffering shared00

To purchase a reserved DB instance offering

This example purchases a reserved DB instance offering that matches the specified settings.

{ svc := rds.New(session.New()) input := &rds.PurchaseReservedDBInstancesOfferingInput{ ReservedDBInstanceId: aws.String("myreservationid"), ReservedDBInstancesOfferingId: aws.String("fb29428a-646d-4390-850e-5fe89926e727"), } result, err := svc.PurchaseReservedDBInstancesOffering(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeReservedDBInstancesOfferingNotFoundFault: fmt.Println(rds.ErrCodeReservedDBInstancesOfferingNotFoundFault, aerr.Error()) case rds.ErrCodeReservedDBInstanceAlreadyExistsFault: fmt.Println(rds.ErrCodeReservedDBInstanceAlreadyExistsFault, aerr.Error()) case rds.ErrCodeReservedDBInstanceQuotaExceededFault: fmt.Println(rds.ErrCodeReservedDBInstanceQuotaExceededFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

PurchaseReservedDBInstancesOfferingRequest

func (c *RDS) PurchaseReservedDBInstancesOfferingRequest(input *PurchaseReservedDBInstancesOfferingInput) (req *request.Request, output *PurchaseReservedDBInstancesOfferingOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/PurchaseReservedDBInstancesOffering

PurchaseReservedDBInstancesOfferingWithContext

func (c *RDS) PurchaseReservedDBInstancesOfferingWithContext(ctx aws.Context, input *PurchaseReservedDBInstancesOfferingInput, opts ...request.Option) (*PurchaseReservedDBInstancesOfferingOutput, error)

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

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

RebootDBInstance

func (c *RDS) RebootDBInstance(input *RebootDBInstanceInput) (*RebootDBInstanceOutput, error)

RebootDBInstance API operation for Amazon Relational Database Service.

You might need to reboot your DB instance, usually for maintenance reasons. For example, if you make certain modifications, or if you change the DB parameter group associated with the DB instance, you must reboot the instance for the changes to take effect.

Rebooting a DB instance restarts the database engine service. Rebooting a DB instance results in a momentary outage, during which the DB instance status is set to rebooting.

For more information about rebooting, see Rebooting a DB Instance (https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_RebootInstance.html) in the Amazon RDS 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 Relational Database Service's API operation RebootDBInstance for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidDBInstanceStateFault "InvalidDBInstanceState" The DB instance isn't in a valid state.

  • ErrCodeDBInstanceNotFoundFault "DBInstanceNotFound" DBInstanceIdentifier doesn't refer to an existing DB instance.

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RebootDBInstance

Example

RDS RebootDBInstance shared00

To reboot a DB instance

This example reboots the specified DB instance without forcing a failover.

{ svc := rds.New(session.New()) input := &rds.RebootDBInstanceInput{ DBInstanceIdentifier: aws.String("mymysqlinstance"), ForceFailover: aws.Bool(false), } result, err := svc.RebootDBInstance(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case rds.ErrCodeInvalidDBInstanceStateFault: fmt.Println(rds.ErrCodeInvalidDBInstanceStateFault, aerr.Error()) case rds.ErrCodeDBInstanceNotFoundFault: fmt.Println(rds.ErrCodeDBInstanceNotFoundFault, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

RebootDBInstanceRequest

func (c *RDS) RebootDBInstanceRequest(input *RebootDBInstanceInput) (req *request.Request, output *RebootDBInstanceOutput)

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

See also, https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RebootDBInstance

RebootDBInstanceWithContext

func (c *RDS) RebootDBInstanceWithContext(ctx aws.Context, input *RebootDBInstanceInput, opts ...request.Option) (*RebootDBInstanceOutput, error)

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

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

RemoveFromGlobalCluster

func (c *RDS) RemoveFromGlobalCluster(input *RemoveFromGlobalClusterInput) (*RemoveFromGlobalClusterOutput, error)

RemoveFromGlobalCluster API operation for Amazon Relational Database Service.

Detaches an Aurora secondary cluster from an Aurora global database cluster. The cluster becomes a standalone cluster with read-write capability instead of being read-only and receiving data from a primary cluster in a different region.

Returns awserr.Error for service API and SDK errors. Use runtim