Copyright | (c) 2013-2023 Brendan Hay |
---|---|
License | Mozilla Public License, v. 2.0. |
Maintainer | Brendan Hay |
Stability | auto-generated |
Portability | non-portable (GHC extensions) |
Safe Haskell | Safe-Inferred |
Language | Haskell2010 |
Synopsis
- data DocDbSettings = DocDbSettings' {
- databaseName :: Maybe Text
- docsToInvestigate :: Maybe Int
- extractDocId :: Maybe Bool
- kmsKeyId :: Maybe Text
- nestingLevel :: Maybe NestingLevelValue
- password :: Maybe (Sensitive Text)
- port :: Maybe Int
- secretsManagerAccessRoleArn :: Maybe Text
- secretsManagerSecretId :: Maybe Text
- serverName :: Maybe Text
- username :: Maybe Text
- newDocDbSettings :: DocDbSettings
- docDbSettings_databaseName :: Lens' DocDbSettings (Maybe Text)
- docDbSettings_docsToInvestigate :: Lens' DocDbSettings (Maybe Int)
- docDbSettings_extractDocId :: Lens' DocDbSettings (Maybe Bool)
- docDbSettings_kmsKeyId :: Lens' DocDbSettings (Maybe Text)
- docDbSettings_nestingLevel :: Lens' DocDbSettings (Maybe NestingLevelValue)
- docDbSettings_password :: Lens' DocDbSettings (Maybe Text)
- docDbSettings_port :: Lens' DocDbSettings (Maybe Int)
- docDbSettings_secretsManagerAccessRoleArn :: Lens' DocDbSettings (Maybe Text)
- docDbSettings_secretsManagerSecretId :: Lens' DocDbSettings (Maybe Text)
- docDbSettings_serverName :: Lens' DocDbSettings (Maybe Text)
- docDbSettings_username :: Lens' DocDbSettings (Maybe Text)
Documentation
data DocDbSettings Source #
Provides information that defines a DocumentDB endpoint.
See: newDocDbSettings
smart constructor.
DocDbSettings' | |
|
Instances
newDocDbSettings :: DocDbSettings Source #
Create a value of DocDbSettings
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:databaseName:DocDbSettings'
, docDbSettings_databaseName
- The database name on the DocumentDB source endpoint.
$sel:docsToInvestigate:DocDbSettings'
, docDbSettings_docsToInvestigate
- Indicates the number of documents to preview to determine the document
organization. Use this setting when NestingLevel
is set to "one"
.
Must be a positive value greater than 0
. Default value is 1000
.
$sel:extractDocId:DocDbSettings'
, docDbSettings_extractDocId
- Specifies the document ID. Use this setting when NestingLevel
is set
to "none"
.
Default value is "false"
.
$sel:kmsKeyId:DocDbSettings'
, docDbSettings_kmsKeyId
- The KMS key identifier that is used to encrypt the content on the
replication instance. If you don't specify a value for the KmsKeyId
parameter, then DMS uses your default encryption key. KMS creates the
default encryption key for your Amazon Web Services account. Your Amazon
Web Services account has a different default encryption key for each
Amazon Web Services Region.
$sel:nestingLevel:DocDbSettings'
, docDbSettings_nestingLevel
- Specifies either document or table mode.
Default value is "none"
. Specify "none"
to use document mode.
Specify "one"
to use table mode.
$sel:password:DocDbSettings'
, docDbSettings_password
- The password for the user account you use to access the DocumentDB
source endpoint.
$sel:port:DocDbSettings'
, docDbSettings_port
- The port value for the DocumentDB source endpoint.
$sel:secretsManagerAccessRoleArn:DocDbSettings'
, docDbSettings_secretsManagerAccessRoleArn
- The full Amazon Resource Name (ARN) of the IAM role that specifies DMS
as the trusted entity and grants the required permissions to access the
value in SecretsManagerSecret
. The role must allow the iam:PassRole
action. SecretsManagerSecret
has the value of the Amazon Web Services
Secrets Manager secret that allows access to the DocumentDB endpoint.
You can specify one of two sets of values for these permissions. You can
specify the values for this setting and SecretsManagerSecretId
. Or you
can specify clear-text values for UserName
, Password
, ServerName
,
and Port
. You can't specify both. For more information on creating
this SecretsManagerSecret
and the SecretsManagerAccessRoleArn
and
SecretsManagerSecretId
required to access it, see
Using secrets to access Database Migration Service resources
in the Database Migration Service User Guide.
$sel:secretsManagerSecretId:DocDbSettings'
, docDbSettings_secretsManagerSecretId
- The full ARN, partial ARN, or friendly name of the
SecretsManagerSecret
that contains the DocumentDB endpoint connection
details.
$sel:serverName:DocDbSettings'
, docDbSettings_serverName
- The name of the server on the DocumentDB source endpoint.
$sel:username:DocDbSettings'
, docDbSettings_username
- The user name you use to access the DocumentDB source endpoint.
docDbSettings_databaseName :: Lens' DocDbSettings (Maybe Text) Source #
The database name on the DocumentDB source endpoint.
docDbSettings_docsToInvestigate :: Lens' DocDbSettings (Maybe Int) Source #
Indicates the number of documents to preview to determine the document
organization. Use this setting when NestingLevel
is set to "one"
.
Must be a positive value greater than 0
. Default value is 1000
.
docDbSettings_extractDocId :: Lens' DocDbSettings (Maybe Bool) Source #
Specifies the document ID. Use this setting when NestingLevel
is set
to "none"
.
Default value is "false"
.
docDbSettings_kmsKeyId :: Lens' DocDbSettings (Maybe Text) Source #
The KMS key identifier that is used to encrypt the content on the
replication instance. If you don't specify a value for the KmsKeyId
parameter, then DMS uses your default encryption key. KMS creates the
default encryption key for your Amazon Web Services account. Your Amazon
Web Services account has a different default encryption key for each
Amazon Web Services Region.
docDbSettings_nestingLevel :: Lens' DocDbSettings (Maybe NestingLevelValue) Source #
Specifies either document or table mode.
Default value is "none"
. Specify "none"
to use document mode.
Specify "one"
to use table mode.
docDbSettings_password :: Lens' DocDbSettings (Maybe Text) Source #
The password for the user account you use to access the DocumentDB source endpoint.
docDbSettings_port :: Lens' DocDbSettings (Maybe Int) Source #
The port value for the DocumentDB source endpoint.
docDbSettings_secretsManagerAccessRoleArn :: Lens' DocDbSettings (Maybe Text) Source #
The full Amazon Resource Name (ARN) of the IAM role that specifies DMS
as the trusted entity and grants the required permissions to access the
value in SecretsManagerSecret
. The role must allow the iam:PassRole
action. SecretsManagerSecret
has the value of the Amazon Web Services
Secrets Manager secret that allows access to the DocumentDB endpoint.
You can specify one of two sets of values for these permissions. You can
specify the values for this setting and SecretsManagerSecretId
. Or you
can specify clear-text values for UserName
, Password
, ServerName
,
and Port
. You can't specify both. For more information on creating
this SecretsManagerSecret
and the SecretsManagerAccessRoleArn
and
SecretsManagerSecretId
required to access it, see
Using secrets to access Database Migration Service resources
in the Database Migration Service User Guide.
docDbSettings_secretsManagerSecretId :: Lens' DocDbSettings (Maybe Text) Source #
The full ARN, partial ARN, or friendly name of the
SecretsManagerSecret
that contains the DocumentDB endpoint connection
details.
docDbSettings_serverName :: Lens' DocDbSettings (Maybe Text) Source #
The name of the server on the DocumentDB source endpoint.
docDbSettings_username :: Lens' DocDbSettings (Maybe Text) Source #
The user name you use to access the DocumentDB source endpoint.