- Navigation GuideYou are on a Command (operation) page with structural examples. Use the navigation breadcrumb if you would like to return to the Client landing page.
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 |
---|
Parameter | Type | Description |
---|---|---|
clusterArn Required | string | undefined | The ARN identifier of the elastic cluster. |
StartClusterCommand Output
See StartClusterCommandOutput for details
Parameter | Type | Description |
---|
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 |
---|
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. |