StartClusterCommand

Restarts the stopped elastic cluster that is specified by clusterARN.

Example Syntax

Use a bare-bones client and the command you need to make an API call.

import { DocDBElasticClient, StartClusterCommand } from "@aws-sdk/client-docdb-elastic"; // ES Modules import
// const { DocDBElasticClient, StartClusterCommand } = require("@aws-sdk/client-docdb-elastic"); // CommonJS import
const client = new DocDBElasticClient(config);
const input = { // StartClusterInput
  clusterArn: "STRING_VALUE", // required
};
const command = new StartClusterCommand(input);
const response = await client.send(command);
// { // StartClusterOutput
//   cluster: { // Cluster
//     clusterName: "STRING_VALUE", // required
//     clusterArn: "STRING_VALUE", // required
//     status: "STRING_VALUE", // required
//     clusterEndpoint: "STRING_VALUE", // required
//     createTime: "STRING_VALUE", // required
//     adminUserName: "STRING_VALUE", // required
//     authType: "STRING_VALUE", // required
//     shardCapacity: Number("int"), // required
//     shardCount: Number("int"), // required
//     vpcSecurityGroupIds: [ // StringList // required
//       "STRING_VALUE",
//     ],
//     subnetIds: [ // required
//       "STRING_VALUE",
//     ],
//     preferredMaintenanceWindow: "STRING_VALUE", // required
//     kmsKeyId: "STRING_VALUE", // required
//     shards: [ // ShardList
//       { // Shard
//         shardId: "STRING_VALUE", // required
//         createTime: "STRING_VALUE", // required
//         status: "STRING_VALUE", // required
//       },
//     ],
//     backupRetentionPeriod: Number("int"),
//     preferredBackupWindow: "STRING_VALUE",
//     shardInstanceCount: Number("int"),
//   },
// };

StartClusterCommand Input

See StartClusterCommandInput for more details

Parameter
Type
Description
clusterArn
Required
string | undefined

The ARN identifier of the elastic cluster.

StartClusterCommand Output

Parameter
Type
Description
$metadata
Required
ResponseMetadata
Metadata pertaining to this request.
cluster
Required
Cluster | undefined

Returns information about a specific elastic cluster.

Throws

Name
Fault
Details
AccessDeniedException
client

An exception that occurs when there are not sufficient permissions to perform an action.

InternalServerException
server

There was an internal server error.

ResourceNotFoundException
client

The specified resource could not be located.

ThrottlingException
client

ThrottlingException will be thrown when request was denied due to request throttling.

ValidationException
client

A structure defining a validation exception.

DocDBElasticServiceException
Base exception class for all service exceptions from DocDBElastic service.