Jump to Content

This API Documentation is now deprecated

We are excited to announce our new API Documentation.

Class DescribeClustersCommandProtected

Gets information about AWS CloudHSM clusters.

This is a paginated operation, which means that each response might contain only a subset of all the clusters. When the response contains only a subset of clusters, it includes a NextToken value. Use this value in a subsequent DescribeClusters request to get more clusters. When you receive a response with no NextToken (or an empty or null value), that means there are no more clusters to get.

Example

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

import { CloudHSMV2Client, DescribeClustersCommand } from "@aws-sdk/client-cloudhsm-v2"; // ES Modules import
// const { CloudHSMV2Client, DescribeClustersCommand } = require("@aws-sdk/client-cloudhsm-v2"); // CommonJS import
const client = new CloudHSMV2Client(config);
const input = { // DescribeClustersRequest
Filters: { // Filters
"<keys>": [ // Strings
"STRING_VALUE",
],
},
NextToken: "STRING_VALUE",
MaxResults: Number("int"),
};
const command = new DescribeClustersCommand(input);
const response = await client.send(command);
// { // DescribeClustersResponse
// Clusters: [ // Clusters
// { // Cluster
// BackupPolicy: "DEFAULT",
// BackupRetentionPolicy: { // BackupRetentionPolicy
// Type: "DAYS",
// Value: "STRING_VALUE",
// },
// ClusterId: "STRING_VALUE",
// CreateTimestamp: new Date("TIMESTAMP"),
// Hsms: [ // Hsms
// { // Hsm
// AvailabilityZone: "STRING_VALUE",
// ClusterId: "STRING_VALUE",
// SubnetId: "STRING_VALUE",
// EniId: "STRING_VALUE",
// EniIp: "STRING_VALUE",
// HsmId: "STRING_VALUE", // required
// State: "CREATE_IN_PROGRESS" || "ACTIVE" || "DEGRADED" || "DELETE_IN_PROGRESS" || "DELETED",
// StateMessage: "STRING_VALUE",
// },
// ],
// HsmType: "STRING_VALUE",
// PreCoPassword: "STRING_VALUE",
// SecurityGroup: "STRING_VALUE",
// SourceBackupId: "STRING_VALUE",
// State: "CREATE_IN_PROGRESS" || "UNINITIALIZED" || "INITIALIZE_IN_PROGRESS" || "INITIALIZED" || "ACTIVE" || "UPDATE_IN_PROGRESS" || "DELETE_IN_PROGRESS" || "DELETED" || "DEGRADED",
// StateMessage: "STRING_VALUE",
// SubnetMapping: { // ExternalSubnetMapping
// "<keys>": "STRING_VALUE",
// },
// VpcId: "STRING_VALUE",
// Certificates: { // Certificates
// ClusterCsr: "STRING_VALUE",
// HsmCertificate: "STRING_VALUE",
// AwsHardwareCertificate: "STRING_VALUE",
// ManufacturerHardwareCertificate: "STRING_VALUE",
// ClusterCertificate: "STRING_VALUE",
// },
// TagList: [ // TagList
// { // Tag
// Key: "STRING_VALUE", // required
// Value: "STRING_VALUE", // required
// },
// ],
// },
// ],
// NextToken: "STRING_VALUE",
// };

Param

DescribeClustersCommandInput

Returns

DescribeClustersCommandOutput

See

Throws

CloudHsmAccessDeniedException (client fault)

The request was rejected because the requester does not have permission to perform the requested operation.

Throws

CloudHsmInternalFailureException (server fault)

The request was rejected because of an AWS CloudHSM internal failure. The request can be retried.

Throws

CloudHsmInvalidRequestException (client fault)

The request was rejected because it is not a valid request.

Throws

CloudHsmServiceException (client fault)

The request was rejected because an error occurred.

Throws

CloudHsmTagException (client fault)

The request was rejected because of a tagging failure. Verify the tag conditions in all applicable policies, and then retry the request.

Throws

CloudHSMV2ServiceException

Base exception class for all service exceptions from CloudHSMV2 service.

Hierarchy

Constructors

Properties

Methods

Constructors

Properties

Methods