RebootDBCluster - Amazon Relational Database Service

RebootDBCluster

You might need to reboot your DB cluster, usually for maintenance reasons. For example, if you make certain modifications, or if you change the DB cluster parameter group associated with the DB cluster, reboot the DB cluster for the changes to take effect.

Rebooting a DB cluster restarts the database engine service. Rebooting a DB cluster results in a momentary outage, during which the DB cluster status is set to rebooting.

Use this operation only for a non-Aurora Multi-AZ DB cluster.

For more information on Multi-AZ DB clusters, see Multi-AZ deployments with two readable standby DB instances in the Amazon RDS User Guide.

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

DBClusterIdentifier

The DB cluster identifier. This parameter is stored as a lowercase string.

Constraints:

  • Must match the identifier of an existing DBCluster.

Type: String

Required: Yes

Response Elements

The following element is returned by the service.

DBCluster

Contains the details of an Amazon Aurora DB cluster or Multi-AZ DB cluster.

For an Amazon Aurora DB cluster, this data type is used as a response element in the operations CreateDBCluster, DeleteDBCluster, DescribeDBClusters, FailoverDBCluster, ModifyDBCluster, PromoteReadReplicaDBCluster, RestoreDBClusterFromS3, RestoreDBClusterFromSnapshot, RestoreDBClusterToPointInTime, StartDBCluster, and StopDBCluster.

For a Multi-AZ DB cluster, this data type is used as a response element in the operations CreateDBCluster, DeleteDBCluster, DescribeDBClusters, FailoverDBCluster, ModifyDBCluster, RebootDBCluster, RestoreDBClusterFromSnapshot, and RestoreDBClusterToPointInTime.

For more information on Amazon Aurora DB clusters, see What is Amazon Aurora? in the Amazon Aurora User Guide.

For more information on Multi-AZ DB clusters, see Multi-AZ deployments with two readable standby DB instances in the Amazon RDS User Guide.

Type: DBCluster object

Errors

For information about the errors that are common to all actions, see Common Errors.

DBClusterNotFoundFault

DBClusterIdentifier doesn't refer to an existing DB cluster.

HTTP Status Code: 404

InvalidDBClusterStateFault

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

HTTP Status Code: 400

InvalidDBInstanceState

The DB instance isn't in a valid state.

HTTP Status Code: 400

Examples

Example

This example illustrates one usage of RebootDBCluster.

Sample Request

https://rds.us-west-2.amazonaws.com/ ?Action=RebootDBCluster &DBClusterIdentifier=my-multi-az-cluster &SignatureMethod=HmacSHA256 &SignatureVersion=4 &Version=2014-10-31 &X-Amz-Algorithm=AWS4-HMAC-SHA256 &X-Amz-Credential=AKIADQKE4SARGYLE/20211014/us-west-2/rds/aws4_request &X-Amz-Date=20211020T204924Z &X-Amz-SignedHeaders=content-type;host;user-agent;x-amz-content-sha256;x-amz-date &X-Amz-Signature=1c48f44c14183cff26fde7d912946f87f3bb9d715f66448f457a8f9e99602af5

Sample Response

<RebootDBClusterResponse xmlns="http://rds.amazonaws.com/doc/2014-10-31/"> <RebootDBClusterResult> <DBCluster> <CrossAccountClone>false</CrossAccountClone> <AllocatedStorage>100</AllocatedStorage> <DatabaseName>mydb</DatabaseName> <AssociatedRoles /> <AvailabilityZones> <AvailabilityZone>us-west-2a</AvailabilityZone> <AvailabilityZone>us-west-2b</AvailabilityZone> <AvailabilityZone>us-west-2c</AvailabilityZone> </AvailabilityZones> <ReadReplicaIdentifiers /> <Iops>1000</Iops> <PerformanceInsightsKMSKeyId>arn:aws:kms:us-west-2:123456789012:key/123EXAMPLE-abcd-4567-efgEXAMPLE</PerformanceInsightsKMSKeyId> <PerformanceInsightsRetentionPeriod>7</PerformanceInsightsRetentionPeriod> <EngineVersion>8.0.26</EngineVersion> <MasterUsername>admin</MasterUsername> <DBClusterMembers> <DBClusterMember> <DBInstanceIdentifier>my-multi-az-cluster-instance-3</DBInstanceIdentifier> <DBClusterParameterGroupStatus>in-sync</DBClusterParameterGroupStatus> <PromotionTier>1</PromotionTier> <IsClusterWriter>false</IsClusterWriter> </DBClusterMember> <DBClusterMember> <DBInstanceIdentifier>my-multi-az-cluster-instance-2</DBInstanceIdentifier> <DBClusterParameterGroupStatus>in-sync</DBClusterParameterGroupStatus> <PromotionTier>1</PromotionTier> <IsClusterWriter>false</IsClusterWriter> </DBClusterMember> <DBClusterMember> <DBInstanceIdentifier>my-multi-az-cluster-instance-1</DBInstanceIdentifier> <DBClusterParameterGroupStatus>in-sync</DBClusterParameterGroupStatus> <PromotionTier>1</PromotionTier> <IsClusterWriter>true</IsClusterWriter> </DBClusterMember> </DBClusterMembers> <HttpEndpointEnabled>false</HttpEndpointEnabled> <Port>3306</Port> <MonitoringInterval>30</MonitoringInterval> <BackupRetentionPeriod>2</BackupRetentionPeriod> <KmsKeyId>arn:aws:kms:us-west-2:123456789012:key/123EXAMPLE-abcd-4567-efgEXAMPLE</KmsKeyId> <DBClusterIdentifier>my-multi-az-cluster</DBClusterIdentifier> <DbClusterResourceId>cluster-RCPGZXFNIHCTBQLDRJX6CP62VQ</DbClusterResourceId> <LatestRestorableTime>2021-10-20T20:45:00Z</LatestRestorableTime> <Status>available</Status> <PreferredBackupWindow>11:34-12:04</PreferredBackupWindow> <DeletionProtection>false</DeletionProtection> <Endpoint>my-multi-az-cluster.cluster-123456789012.us-west-2.rds.amazonaws.com</Endpoint> <EngineMode>provisioned</EngineMode> <Engine>mysql</Engine> <ReaderEndpoint>my-multi-az-cluster.cluster-ro-123456789012.us-west-2.rds.amazonaws.com</ReaderEndpoint> <PubliclyAccessible>true</PubliclyAccessible> <IAMDatabaseAuthenticationEnabled>false</IAMDatabaseAuthenticationEnabled> <EarliestRestorableTime>2021-10-20T00:21:43.013Z</EarliestRestorableTime> <ClusterCreateTime>2021-10-20T00:12:00.867Z</ClusterCreateTime> <PerformanceInsightsEnabled>true</PerformanceInsightsEnabled> <MultiAZ>true</MultiAZ> <DomainMemberships /> <MonitoringRoleArn>arn:aws:iam::123456789012:role/enhance-monitoring-role</MonitoringRoleArn> <StorageEncrypted>true</StorageEncrypted> <DBSubnetGroup>mysubnet1</DBSubnetGroup> <VpcSecurityGroups> <VpcSecurityGroupMembership> <VpcSecurityGroupId>sg-6921cc28</VpcSecurityGroupId> <Status>active</Status> </VpcSecurityGroupMembership> </VpcSecurityGroups> <TagList /> <HostedZoneId>Z3GZ3VYA3PGHTQ</HostedZoneId> <PreferredMaintenanceWindow>sat:07:05-sat:07:35</PreferredMaintenanceWindow> <DBClusterParameterGroup>my-multi-az-cluster-cpg</DBClusterParameterGroup> <StorageType>io1</StorageType> <DBClusterInstanceClass>db.r6gd.large</DBClusterInstanceClass> <AutoMinorVersionUpgrade>true</AutoMinorVersionUpgrade> <CopyTagsToSnapshot>false</CopyTagsToSnapshot> <DBClusterArn>arn:aws:rds:us-west-2:123456789012:cluster:my-multi-az-cluster</DBClusterArn> </DBCluster> </RebootDBClusterResult> <ResponseMetadata> <RequestId>056383d9-2d62-415d-b1bb-098b4cc86b5d</RequestId> </ResponseMetadata> </RebootDBClusterResponse>

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: