---
title: "PUT /cluster/{clusterArn}"
method: PUT
path: "/cluster/{clusterArn}"
---

# PUT /cluster/{clusterArn}

`PUT /cluster/{clusterArn}`

Modifies an elastic cluster. This includes updating admin-username/password, upgrading the API version, and setting up a backup window and maintenance window

## Path parameters

- `clusterArn` string, required

## Request body

- object
  - `adminUserPassword` string, password — <p>The password associated with the elastic cluster administrator. This password can contain any printable ASCII character except forward slash (/), double quote ("), or the "at" symbol (@).</p> <p> <i>Constraints</i>: Must contain from 8 to 100 characters.</p>
  - `authType` 'PLAIN_TEXT' | 'SECRET_ARN' — The authentication type used to determine where to fetch the password used for accessing the elastic cluster. Valid types are <code>PLAIN_TEXT</code> or <code>SECRET_ARN</code>.
  - `backupRetentionPeriod` integer — The number of days for which automatic snapshots are retained.
  - `clientToken` string — The client token for the elastic cluster.
  - `preferredBackupWindow` string — The daily time range during which automated backups are created if automated backups are enabled, as determined by the <code>backupRetentionPeriod</code>.
  - `preferredMaintenanceWindow` string — <p>The weekly time range during which system maintenance can occur, in Universal Coordinated Time (UTC).</p> <p> <i>Format</i>: <code>ddd:hh24:mi-ddd:hh24:mi</code> </p> <p> <i>Default</i>: a 30-minute window selected at random from an 8-hour block of time for each Amazon Web Services Region, occurring on a random day of the week.</p> <p> <i>Valid days</i>: Mon, Tue, Wed, Thu, Fri, Sat, Sun</p> <p> <i>Constraints</i>: Minimum 30-minute window.</p>
  - `shardCapacity` integer — The number of vCPUs assigned to each elastic cluster shard. Maximum is 64. Allowed values are 2, 4, 8, 16, 32, 64.
  - `shardCount` integer — The number of shards assigned to the elastic cluster. Maximum is 32.
  - `shardInstanceCount` integer — The number of replica instances applying to all shards in the elastic cluster. A <code>shardInstanceCount</code> value of 1 means there is one writer instance, and any additional instances are replicas that can be used for reads and to improve availability.
  - `subnetIds` String[] — The Amazon EC2 subnet IDs for the elastic cluster.
  - `vpcSecurityGroupIds` String[] — A list of EC2 VPC security groups to associate with the elastic cluster.

## Response `200`

Success

- UpdateClusterOutput
  - `cluster` object, required — Returns information about the updated elastic cluster.
    - `adminUserName` string, required — The name of the elastic cluster administrator.
    - `authType` 'PLAIN_TEXT' | 'SECRET_ARN', required — The authentication type for the elastic cluster.
    - `backupRetentionPeriod` integer — The number of days for which automatic snapshots are retained.
    - `clusterArn` string, required — The ARN identifier of the elastic cluster.
    - `clusterEndpoint` string, required — The URL used to connect to the elastic cluster.
    - `clusterName` string, required — The name of the elastic cluster.
    - `createTime` string, required — The time when the elastic cluster was created in Universal Coordinated Time (UTC).
    - `kmsKeyId` string, required — The KMS key identifier to use to encrypt the elastic cluster.
    - `preferredBackupWindow` string — The daily time range during which automated backups are created if automated backups are enabled, as determined by <code>backupRetentionPeriod</code>.
    - `preferredMaintenanceWindow` string, required — <p>The weekly time range during which system maintenance can occur, in Universal Coordinated Time (UTC).</p> <p> <i>Format</i>: <code>ddd:hh24:mi-ddd:hh24:mi</code> </p>
    - `shardCapacity` integer, required — The number of vCPUs assigned to each elastic cluster shard. Maximum is 64. Allowed values are 2, 4, 8, 16, 32, 64.
    - `shardCount` integer, required — The number of shards assigned to the elastic cluster. Maximum is 32.
    - `shardInstanceCount` integer — The number of replica instances applying to all shards in the cluster. A <code>shardInstanceCount</code> value of 1 means there is one writer instance, and any additional instances are replicas that can be used for reads and to improve availability.
    - `shards` Shard[] — The total number of shards in the cluster.
      - `createTime` string, required — The time when the shard was created in Universal Coordinated Time (UTC).
      - `shardId` string, required — The ID of the shard.
      - `status` 'CREATING' | 'ACTIVE' | 'DELETING' | 'UPDATING' | 'VPC_ENDPOINT_LIMIT_EXCEEDED' | 'IP_ADDRESS_LIMIT_EXCEEDED' | 'INVALID_SECURITY_GROUP_ID' | 'INVALID_SUBNET_ID' | 'INACCESSIBLE_ENCRYPTION_CREDS' | 'INACCESSIBLE_SECRET_ARN' | 'INACCESSIBLE_VPC_ENDPOINT' | 'INCOMPATIBLE_NETWORK' | 'MERGING' | 'MODIFYING' | 'SPLITTING' | 'COPYING' | 'STARTING' | 'STOPPING' | 'STOPPED' | 'MAINTENANCE' | 'INACCESSIBLE_ENCRYPTION_CREDENTIALS_RECOVERABLE', required — The current status of the shard.
    - `status` 'CREATING' | 'ACTIVE' | 'DELETING' | 'UPDATING' | 'VPC_ENDPOINT_LIMIT_EXCEEDED' | 'IP_ADDRESS_LIMIT_EXCEEDED' | 'INVALID_SECURITY_GROUP_ID' | 'INVALID_SUBNET_ID' | 'INACCESSIBLE_ENCRYPTION_CREDS' | 'INACCESSIBLE_SECRET_ARN' | 'INACCESSIBLE_VPC_ENDPOINT' | 'INCOMPATIBLE_NETWORK' | 'MERGING' | 'MODIFYING' | 'SPLITTING' | 'COPYING' | 'STARTING' | 'STOPPING' | 'STOPPED' | 'MAINTENANCE' | 'INACCESSIBLE_ENCRYPTION_CREDENTIALS_RECOVERABLE', required — The status of the elastic cluster.
    - `subnetIds` String[], required — The Amazon EC2 subnet IDs for the elastic cluster.
    - `vpcSecurityGroupIds` String[], required — A list of EC2 VPC security groups associated with thie elastic cluster.

## Other responses

- `480` — ThrottlingException
- `481` — ValidationException
- `482` — ConflictException
- `483` — InternalServerException
- `484` — ResourceNotFoundException
- `485` — AccessDeniedException

---

[API](https://skmtc.net/aws/apis/docdb-elastic.md) · [All operations](https://skmtc.net/aws/apis/docdb-elastic/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/docdb-elastic/versions/71417e1f0c94/schema)