AWSKMSCustomKeyStoresListEntry
Objective-C
@interface AWSKMSCustomKeyStoresListEntry
Swift
class AWSKMSCustomKeyStoresListEntry
Contains information about each custom key store in the custom key store list.
-
A unique identifier for the AWS CloudHSM cluster that is associated with the custom key store.
Declaration
Objective-C
@property (nonatomic, strong) NSString *_Nullable cloudHsmClusterId;
Swift
var cloudHsmClusterId: String? { get set }
-
Describes the connection error. This field appears in the response only when the
ConnectionState
isFAILED
. For help resolving these errors, see How to Fix a Connection Failure in AWS Key Management Service Developer Guide.Valid values are:
CLUSTER_NOT_FOUND
- AWS KMS cannot find the AWS CloudHSM cluster with the specified cluster ID.INSUFFICIENT_CLOUDHSM_HSMS
- The associated AWS CloudHSM cluster does not contain any active HSMs. To connect a custom key store to its AWS CloudHSM cluster, the cluster must contain at least one active HSM.INTERNAL_ERROR
- AWS KMS could not complete the request due to an internal error. Retry the request. ForConnectCustomKeyStore
requests, disconnect the custom key store before trying to connect again.INVALID_CREDENTIALS
- AWS KMS does not have the correct password for thekmsuser
crypto user in the AWS CloudHSM cluster. Before you can connect your custom key store to its AWS CloudHSM cluster, you must change thekmsuser
account password and update the key store password value for the custom key store.NETWORK_ERRORS
- Network errors are preventing AWS KMS from connecting to the custom key store.SUBNET_NOT_FOUND
- A subnet in the AWS CloudHSM cluster configuration was deleted. If AWS KMS cannot find all of the subnets in the cluster configuration, attempts to connect the custom key store to the AWS CloudHSM cluster fail. To fix this error, create a cluster from a recent backup and associate it with your custom key store. (This process creates a new cluster configuration with a VPC and private subnets.) For details, see How to Fix a Connection Failure in the AWS Key Management Service Developer Guide.USER_LOCKED_OUT
- Thekmsuser
CU account is locked out of the associated AWS CloudHSM cluster due to too many failed password attempts. Before you can connect your custom key store to its AWS CloudHSM cluster, you must change thekmsuser
account password and update the key store password value for the custom key store.USER_LOGGED_IN
- Thekmsuser
CU account is logged into the the associated AWS CloudHSM cluster. This prevents AWS KMS from rotating thekmsuser
account password and logging into the cluster. Before you can connect your custom key store to its AWS CloudHSM cluster, you must log thekmsuser
CU out of the cluster. If you changed thekmsuser
password to log into the cluster, you must also and update the key store password value for the custom key store. For help, see How to Log Out and Reconnect in the AWS Key Management Service Developer Guide.USER_NOT_FOUND
- AWS KMS cannot find akmsuser
CU account in the associated AWS CloudHSM cluster. Before you can connect your custom key store to its AWS CloudHSM cluster, you must create akmsuser
CU account in the cluster, and then update the key store password value for the custom key store.
Declaration
Objective-C
@property (nonatomic) AWSKMSConnectionErrorCodeType connectionErrorCode;
Swift
var connectionErrorCode: AWSKMSConnectionErrorCodeType { get set }
-
Indicates whether the custom key store is connected to its AWS CloudHSM cluster.
You can create and use CMKs in your custom key stores only when its connection state is
CONNECTED
.The value is
DISCONNECTED
if the key store has never been connected or you use the DisconnectCustomKeyStore operation to disconnect it. If the value isCONNECTED
but you are having trouble using the custom key store, make sure that its associated AWS CloudHSM cluster is active and contains at least one active HSM.A value of
FAILED
indicates that an attempt to connect was unsuccessful. TheConnectionErrorCode
field in the response indicates the cause of the failure. For help resolving a connection failure, see Troubleshooting a Custom Key Store in the AWS Key Management Service Developer Guide.Declaration
Objective-C
@property (nonatomic) AWSKMSConnectionStateType connectionState;
Swift
var connectionState: AWSKMSConnectionStateType { get set }
-
The date and time when the custom key store was created.
Declaration
Objective-C
@property (nonatomic, strong) NSDate *_Nullable creationDate;
Swift
var creationDate: Date? { get set }
-
A unique identifier for the custom key store.
Declaration
Objective-C
@property (nonatomic, strong) NSString *_Nullable customKeyStoreId;
Swift
var customKeyStoreId: String? { get set }
-
The user-specified friendly name for the custom key store.
Declaration
Objective-C
@property (nonatomic, strong) NSString *_Nullable customKeyStoreName;
Swift
var customKeyStoreName: String? { get set }
-
The trust anchor certificate of the associated AWS CloudHSM cluster. When you initialize the cluster, you create this certificate and save it in the
customerCA.crt
file.Declaration
Objective-C
@property (nonatomic, strong) NSString *_Nullable trustAnchorCertificate;
Swift
var trustAnchorCertificate: String? { get set }