Class: Aws::DatabaseMigrationService::Types::DocDbSettings

Inherits:
Struct
  • Object
show all
Includes:
Structure
Defined in:
lib/aws-sdk-databasemigrationservice/types.rb

Overview

Provides information that defines a DocumentDB endpoint.

Constant Summary collapse

SENSITIVE =
[:password]

Instance Attribute Summary collapse

Instance Attribute Details

#database_nameString

The database name on the DocumentDB source endpoint.

Returns:

  • (String)


5279
5280
5281
5282
5283
5284
5285
5286
5287
5288
5289
5290
5291
5292
5293
5294
5295
# File 'lib/aws-sdk-databasemigrationservice/types.rb', line 5279

class DocDbSettings < Struct.new(
  :username,
  :password,
  :server_name,
  :port,
  :database_name,
  :nesting_level,
  :extract_doc_id,
  :docs_to_investigate,
  :kms_key_id,
  :secrets_manager_access_role_arn,
  :secrets_manager_secret_id,
  :use_update_look_up,
  :replicate_shard_collections)
  SENSITIVE = [:password]
  include Aws::Structure
end

#docs_to_investigateInteger

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`.

Returns:

  • (Integer)


5279
5280
5281
5282
5283
5284
5285
5286
5287
5288
5289
5290
5291
5292
5293
5294
5295
# File 'lib/aws-sdk-databasemigrationservice/types.rb', line 5279

class DocDbSettings < Struct.new(
  :username,
  :password,
  :server_name,
  :port,
  :database_name,
  :nesting_level,
  :extract_doc_id,
  :docs_to_investigate,
  :kms_key_id,
  :secrets_manager_access_role_arn,
  :secrets_manager_secret_id,
  :use_update_look_up,
  :replicate_shard_collections)
  SENSITIVE = [:password]
  include Aws::Structure
end

#extract_doc_idBoolean

Specifies the document ID. Use this setting when ‘NestingLevel` is set to `“none”`.

Default value is ‘“false”`.

Returns:

  • (Boolean)


5279
5280
5281
5282
5283
5284
5285
5286
5287
5288
5289
5290
5291
5292
5293
5294
5295
# File 'lib/aws-sdk-databasemigrationservice/types.rb', line 5279

class DocDbSettings < Struct.new(
  :username,
  :password,
  :server_name,
  :port,
  :database_name,
  :nesting_level,
  :extract_doc_id,
  :docs_to_investigate,
  :kms_key_id,
  :secrets_manager_access_role_arn,
  :secrets_manager_secret_id,
  :use_update_look_up,
  :replicate_shard_collections)
  SENSITIVE = [:password]
  include Aws::Structure
end

#kms_key_idString

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.

Returns:

  • (String)


5279
5280
5281
5282
5283
5284
5285
5286
5287
5288
5289
5290
5291
5292
5293
5294
5295
# File 'lib/aws-sdk-databasemigrationservice/types.rb', line 5279

class DocDbSettings < Struct.new(
  :username,
  :password,
  :server_name,
  :port,
  :database_name,
  :nesting_level,
  :extract_doc_id,
  :docs_to_investigate,
  :kms_key_id,
  :secrets_manager_access_role_arn,
  :secrets_manager_secret_id,
  :use_update_look_up,
  :replicate_shard_collections)
  SENSITIVE = [:password]
  include Aws::Structure
end

#nesting_levelString

Specifies either document or table mode.

Default value is ‘“none”`. Specify `“none”` to use document mode. Specify `“one”` to use table mode.

Returns:

  • (String)


5279
5280
5281
5282
5283
5284
5285
5286
5287
5288
5289
5290
5291
5292
5293
5294
5295
# File 'lib/aws-sdk-databasemigrationservice/types.rb', line 5279

class DocDbSettings < Struct.new(
  :username,
  :password,
  :server_name,
  :port,
  :database_name,
  :nesting_level,
  :extract_doc_id,
  :docs_to_investigate,
  :kms_key_id,
  :secrets_manager_access_role_arn,
  :secrets_manager_secret_id,
  :use_update_look_up,
  :replicate_shard_collections)
  SENSITIVE = [:password]
  include Aws::Structure
end

#passwordString

The password for the user account you use to access the DocumentDB source endpoint.

Returns:

  • (String)


5279
5280
5281
5282
5283
5284
5285
5286
5287
5288
5289
5290
5291
5292
5293
5294
5295
# File 'lib/aws-sdk-databasemigrationservice/types.rb', line 5279

class DocDbSettings < Struct.new(
  :username,
  :password,
  :server_name,
  :port,
  :database_name,
  :nesting_level,
  :extract_doc_id,
  :docs_to_investigate,
  :kms_key_id,
  :secrets_manager_access_role_arn,
  :secrets_manager_secret_id,
  :use_update_look_up,
  :replicate_shard_collections)
  SENSITIVE = [:password]
  include Aws::Structure
end

#portInteger

The port value for the DocumentDB source endpoint.

Returns:

  • (Integer)


5279
5280
5281
5282
5283
5284
5285
5286
5287
5288
5289
5290
5291
5292
5293
5294
5295
# File 'lib/aws-sdk-databasemigrationservice/types.rb', line 5279

class DocDbSettings < Struct.new(
  :username,
  :password,
  :server_name,
  :port,
  :database_name,
  :nesting_level,
  :extract_doc_id,
  :docs_to_investigate,
  :kms_key_id,
  :secrets_manager_access_role_arn,
  :secrets_manager_secret_id,
  :use_update_look_up,
  :replicate_shard_collections)
  SENSITIVE = [:password]
  include Aws::Structure
end

#replicate_shard_collectionsBoolean

If ‘true`, DMS replicates data to shard collections. DMS only uses this setting if the target endpoint is a DocumentDB elastic cluster.

When this setting is ‘true`, note the following:

  • You must set ‘TargetTablePrepMode` to `nothing`.

  • DMS automatically sets ‘useUpdateLookup` to `false`.

Returns:

  • (Boolean)


5279
5280
5281
5282
5283
5284
5285
5286
5287
5288
5289
5290
5291
5292
5293
5294
5295
# File 'lib/aws-sdk-databasemigrationservice/types.rb', line 5279

class DocDbSettings < Struct.new(
  :username,
  :password,
  :server_name,
  :port,
  :database_name,
  :nesting_level,
  :extract_doc_id,
  :docs_to_investigate,
  :kms_key_id,
  :secrets_manager_access_role_arn,
  :secrets_manager_secret_id,
  :use_update_look_up,
  :replicate_shard_collections)
  SENSITIVE = [:password]
  include Aws::Structure
end

#secrets_manager_access_role_arnString

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.

<note markdown=“1”> 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*.

</note>

[1]: docs.aws.amazon.com/dms/latest/userguide/CHAP_Security.html#security-iam-secretsmanager

Returns:

  • (String)


5279
5280
5281
5282
5283
5284
5285
5286
5287
5288
5289
5290
5291
5292
5293
5294
5295
# File 'lib/aws-sdk-databasemigrationservice/types.rb', line 5279

class DocDbSettings < Struct.new(
  :username,
  :password,
  :server_name,
  :port,
  :database_name,
  :nesting_level,
  :extract_doc_id,
  :docs_to_investigate,
  :kms_key_id,
  :secrets_manager_access_role_arn,
  :secrets_manager_secret_id,
  :use_update_look_up,
  :replicate_shard_collections)
  SENSITIVE = [:password]
  include Aws::Structure
end

#secrets_manager_secret_idString

The full ARN, partial ARN, or friendly name of the ‘SecretsManagerSecret` that contains the DocumentDB endpoint connection details.

Returns:

  • (String)


5279
5280
5281
5282
5283
5284
5285
5286
5287
5288
5289
5290
5291
5292
5293
5294
5295
# File 'lib/aws-sdk-databasemigrationservice/types.rb', line 5279

class DocDbSettings < Struct.new(
  :username,
  :password,
  :server_name,
  :port,
  :database_name,
  :nesting_level,
  :extract_doc_id,
  :docs_to_investigate,
  :kms_key_id,
  :secrets_manager_access_role_arn,
  :secrets_manager_secret_id,
  :use_update_look_up,
  :replicate_shard_collections)
  SENSITIVE = [:password]
  include Aws::Structure
end

#server_nameString

The name of the server on the DocumentDB source endpoint.

Returns:

  • (String)


5279
5280
5281
5282
5283
5284
5285
5286
5287
5288
5289
5290
5291
5292
5293
5294
5295
# File 'lib/aws-sdk-databasemigrationservice/types.rb', line 5279

class DocDbSettings < Struct.new(
  :username,
  :password,
  :server_name,
  :port,
  :database_name,
  :nesting_level,
  :extract_doc_id,
  :docs_to_investigate,
  :kms_key_id,
  :secrets_manager_access_role_arn,
  :secrets_manager_secret_id,
  :use_update_look_up,
  :replicate_shard_collections)
  SENSITIVE = [:password]
  include Aws::Structure
end

#use_update_look_upBoolean

If ‘true`, DMS retrieves the entire document from the DocumentDB source during migration. This may cause a migration failure if the server response exceeds bandwidth limits. To fetch only updates and deletes during migration, set this parameter to `false`.

Returns:

  • (Boolean)


5279
5280
5281
5282
5283
5284
5285
5286
5287
5288
5289
5290
5291
5292
5293
5294
5295
# File 'lib/aws-sdk-databasemigrationservice/types.rb', line 5279

class DocDbSettings < Struct.new(
  :username,
  :password,
  :server_name,
  :port,
  :database_name,
  :nesting_level,
  :extract_doc_id,
  :docs_to_investigate,
  :kms_key_id,
  :secrets_manager_access_role_arn,
  :secrets_manager_secret_id,
  :use_update_look_up,
  :replicate_shard_collections)
  SENSITIVE = [:password]
  include Aws::Structure
end

#usernameString

The user name you use to access the DocumentDB source endpoint.

Returns:

  • (String)


5279
5280
5281
5282
5283
5284
5285
5286
5287
5288
5289
5290
5291
5292
5293
5294
5295
# File 'lib/aws-sdk-databasemigrationservice/types.rb', line 5279

class DocDbSettings < Struct.new(
  :username,
  :password,
  :server_name,
  :port,
  :database_name,
  :nesting_level,
  :extract_doc_id,
  :docs_to_investigate,
  :kms_key_id,
  :secrets_manager_access_role_arn,
  :secrets_manager_secret_id,
  :use_update_look_up,
  :replicate_shard_collections)
  SENSITIVE = [:password]
  include Aws::Structure
end