software.amazon.awscdk.services.rds

Class SnapshotCredentials

java.lang.Object

software.amazon.jsii.JsiiObject

software.amazon.awscdk.services.rds.SnapshotCredentials

All Implemented Interfaces:

software.amazon.jsii.JsiiSerializable

@Generated(value="jsii-pacmak/1.29.0 (build 41df200)",
           date="2021-06-02T09:55:32.031Z")
 @Stability(value=Experimental)
public abstract class SnapshotCredentials
extends software.amazon.jsii.JsiiObject

(experimental) Credentials to update the password for a ``DatabaseInstanceFromSnapshot``.

Nested Class Summary

Nested classes/interfaces inherited from class software.amazon.jsii.JsiiObject

software.amazon.jsii.JsiiObject.InitializationMode

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	SnapshotCredentials()
protected	SnapshotCredentials(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	SnapshotCredentials(software.amazon.jsii.JsiiObjectRef objRef)

Method Summary

Modifier and Type	Method and Description
static SnapshotCredentials	fromGeneratedSecret(String username) (experimental) Generate a new password for the snapshot, using the existing username and an optional encryption key.
static SnapshotCredentials	fromGeneratedSecret(String username, SnapshotCredentialsFromGeneratedPasswordOptions options) (experimental) Generate a new password for the snapshot, using the existing username and an optional encryption key.
static SnapshotCredentials	fromPassword(SecretValue password) (experimental) Update the snapshot login with an existing password.
static SnapshotCredentials	fromSecret(Secret secret) (experimental) Update the snapshot login with an existing password from a Secret.
abstract IKey	getEncryptionKey() (experimental) KMS encryption key to encrypt the generated secret.
abstract String	getExcludeCharacters() (experimental) The characters to exclude from the generated password.
abstract Boolean	getGeneratePassword() (experimental) Whether a new password should be generated.
abstract SecretValue	getPassword() (experimental) The master user password.
abstract Boolean	getReplaceOnPasswordCriteriaChanges() (experimental) Whether to replace the generated secret when the criteria for the password change.
abstract Secret	getSecret() (experimental) Secret used to instantiate this Login.
abstract String	getUsername() (experimental) The master user name.

Methods inherited from class software.amazon.jsii.JsiiObject

jsiiAsyncCall, jsiiAsyncCall, jsiiCall, jsiiCall, jsiiGet, jsiiGet, jsiiSet, jsiiStaticCall, jsiiStaticCall, jsiiStaticGet, jsiiStaticGet, jsiiStaticSet, jsiiStaticSet

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Constructor Detail

SnapshotCredentials

protected SnapshotCredentials(software.amazon.jsii.JsiiObjectRef objRef)

SnapshotCredentials

protected SnapshotCredentials(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)

SnapshotCredentials

@Stability(value=Experimental)
protected SnapshotCredentials()

Method Detail

fromGeneratedSecret

@Stability(value=Experimental)
 @NotNull
public static SnapshotCredentials fromGeneratedSecret(@NotNull
                                                                                               String username,
                                                                                               @Nullable
                                                                                               SnapshotCredentialsFromGeneratedPasswordOptions options)

(experimental) Generate a new password for the snapshot, using the existing username and an optional encryption key.

The new credentials are stored in Secrets Manager.

Note - The username must match the existing master username of the snapshot.

Parameters:

username - This parameter is required.

options -

fromGeneratedSecret

@Stability(value=Experimental)
 @NotNull
public static SnapshotCredentials fromGeneratedSecret(@NotNull
                                                                                               String username)

(experimental) Generate a new password for the snapshot, using the existing username and an optional encryption key.

The new credentials are stored in Secrets Manager.

Note - The username must match the existing master username of the snapshot.

Parameters:

username - This parameter is required.

fromPassword

@Stability(value=Experimental)
 @NotNull
public static SnapshotCredentials fromPassword(@NotNull
                                                                                        SecretValue password)

(experimental) Update the snapshot login with an existing password.

Parameters:

password - This parameter is required.

fromSecret

@Stability(value=Experimental)
 @NotNull
public static SnapshotCredentials fromSecret(@NotNull
                                                                                      Secret secret)

(experimental) Update the snapshot login with an existing password from a Secret.

The Secret must be a JSON string with a password field:

 {
    ...
    "password": <required: password>,
 }
 

Parameters:

secret - This parameter is required.

getGeneratePassword

@Stability(value=Experimental)
 @NotNull
public abstract Boolean getGeneratePassword()

(experimental) Whether a new password should be generated.

getEncryptionKey

@Stability(value=Experimental)
 @Nullable
public abstract IKey getEncryptionKey()

(experimental) KMS encryption key to encrypt the generated secret.

Default: - default master key

getExcludeCharacters

@Stability(value=Experimental)
 @Nullable
public abstract String getExcludeCharacters()

(experimental) The characters to exclude from the generated password.

Only used if {@link generatePassword} if true.

Default: - the DatabaseSecret default exclude character set (" %+~`#$&*()|[]{}:;<>?!'/

getPassword

@Stability(value=Experimental)
 @Nullable
public abstract SecretValue getPassword()

(experimental) The master user password.

Do not put passwords in your CDK code directly.

Default: - the existing password from the snapshot

getReplaceOnPasswordCriteriaChanges

@Stability(value=Experimental)
 @Nullable
public abstract Boolean getReplaceOnPasswordCriteriaChanges()

(experimental) Whether to replace the generated secret when the criteria for the password change.

Default: false

getSecret

@Stability(value=Experimental)
 @Nullable
public abstract Secret getSecret()

(experimental) Secret used to instantiate this Login.

Default: - none

getUsername

@Stability(value=Experimental)
 @Nullable
public abstract String getUsername()

(experimental) The master user name.

Must be the current master user name of the snapshot. It is not possible to change the master user name of a RDS instance.

Default: - the existing username from the snapshot