KeyProps.Builder, KeyProps.Jsii$Proxy
Modifier | Constructor and Description |
---|---|
protected |
Jsii$Proxy(software.amazon.jsii.JsiiObjectRef objRef)
Constructor that initializes the object based on values retrieved from the JsiiObject.
|
Modifier and Type | Method and Description |
---|---|
com.fasterxml.jackson.databind.JsonNode |
$jsii$toJson() |
boolean |
equals(java.lang.Object o) |
java.util.List<IPrincipal> |
getAdmins()
A list of principals to add as key administrators to the key policy.
|
java.lang.String |
getAlias()
Initial alias to add to the key.
|
java.lang.String |
getDescription()
A description of the key.
|
java.lang.Boolean |
getEnabled()
Indicates whether the key is available for use.
|
java.lang.Boolean |
getEnableKeyRotation()
Indicates whether AWS KMS rotates the key.
|
KeySpec |
getKeySpec()
The cryptographic configuration of the key.
|
KeyUsage |
getKeyUsage()
The cryptographic operations for which the key can be used.
|
Duration |
getPendingWindow()
Specifies the number of days in the waiting period before AWS KMS deletes a CMK that has been removed from a CloudFormation stack.
|
PolicyDocument |
getPolicy()
Custom policy document to attach to the KMS key.
|
RemovalPolicy |
getRemovalPolicy()
Whether the encryption key should be retained when it is removed from the Stack.
|
java.lang.Boolean |
getTrustAccountIdentities()
(deprecated) Whether the key usage can be granted by IAM policies.
|
int |
hashCode() |
protected Jsii$Proxy(software.amazon.jsii.JsiiObjectRef objRef)
objRef
- Reference to the JSII managed object.public final java.util.List<IPrincipal> getAdmins()
KeyProps
Key administrators have permissions to manage the key (e.g., change permissions, revoke), but do not have permissions to use the key in cryptographic operations (e.g., encrypt, decrypt).
These principals will be added to the default key policy (if none specified), or to the specified policy (if provided).
Default: []
public final java.lang.String getAlias()
KeyProps
More aliases can be added later by calling addAlias
.
Default: - No alias is added for the key.
public final java.lang.String getDescription()
KeyProps
Use a description that helps your users decide whether the key is appropriate for a particular task.
Default: - No description.
getDescription
in interface KeyProps
public final java.lang.Boolean getEnabled()
KeyProps
Default: - Key is enabled.
getEnabled
in interface KeyProps
public final java.lang.Boolean getEnableKeyRotation()
KeyProps
Default: false
getEnableKeyRotation
in interface KeyProps
public final KeySpec getKeySpec()
KeyProps
IMPORTANT: If you change this property of an existing key, the existing key is scheduled for deletion and a new key is created with the specified value.
Default: KeySpec.SYMMETRIC_DEFAULT
getKeySpec
in interface KeyProps
public final KeyUsage getKeyUsage()
KeyProps
IMPORTANT: If you change this property of an existing key, the existing key is scheduled for deletion and a new key is created with the specified value.
Default: KeyUsage.ENCRYPT_DECRYPT
getKeyUsage
in interface KeyProps
public final Duration getPendingWindow()
KeyProps
When you remove a customer master key (CMK) from a CloudFormation stack, AWS KMS schedules the CMK for deletion and starts the mandatory waiting period. The PendingWindowInDays property determines the length of waiting period. During the waiting period, the key state of CMK is Pending Deletion, which prevents the CMK from being used in cryptographic operations. When the waiting period expires, AWS KMS permanently deletes the CMK.
Enter a value between 7 and 30 days.
Default: - 30 days
getPendingWindow
in interface KeyProps
public final PolicyDocument getPolicy()
KeyProps
NOTE - If the @aws-cdk/aws-kms:defaultKeyPolicies
feature flag is set (the default for new projects),
this policy will override the default key policy and become the only key policy for the key. If the
feature flag is not set, this policy will be appended to the default key policy.
Default: - A policy document with permissions for the account root to administer the key will be created.
public final RemovalPolicy getRemovalPolicy()
KeyProps
This is useful when one wants to retain access to data that was encrypted with a key that is being retired.
Default: RemovalPolicy.Retain
getRemovalPolicy
in interface KeyProps
public final java.lang.Boolean getTrustAccountIdentities()
KeyProps
Setting this to true adds a default statement which delegates key access control completely to the identity's IAM policy (similar to how it works for other AWS resources). This matches the default behavior when creating KMS keys via the API or console.
If the @aws-cdk/aws-kms:defaultKeyPolicies
feature flag is set (the default for new projects),
this flag will always be treated as 'true' and does not need to be explicitly set.
Default: - false, unless the `@aws-cdk/aws-kms:defaultKeyPolicies` feature flag is set.
getTrustAccountIdentities
in interface KeyProps
public com.fasterxml.jackson.databind.JsonNode $jsii$toJson()
public final boolean equals(java.lang.Object o)
public final int hashCode()