aws-cdk-lib.aws_dms.CfnEndpoint.DocDbSettingsProperty

interface DocDbSettingsProperty

LanguageType name
.NETAmazon.CDK.AWS.DMS.CfnEndpoint.DocDbSettingsProperty
Gogithub.com/aws/aws-cdk-go/awscdk/v2/awsdms#CfnEndpoint_DocDbSettingsProperty
Javasoftware.amazon.awscdk.services.dms.CfnEndpoint.DocDbSettingsProperty
Pythonaws_cdk.aws_dms.CfnEndpoint.DocDbSettingsProperty
TypeScript aws-cdk-lib » aws_dms » CfnEndpoint » DocDbSettingsProperty

Provides information that defines a DocumentDB endpoint.

This information includes the output format of records applied to the endpoint and details of transaction and control table data information. For more information about other available settings, see Using extra connections attributes with Amazon DocumentDB as a source and Using Amazon DocumentDB as a target for AWS Database Migration Service in the AWS Database Migration Service User Guide .

Example

// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_dms as dms } from 'aws-cdk-lib';
const docDbSettingsProperty: dms.CfnEndpoint.DocDbSettingsProperty = {
  docsToInvestigate: 123,
  extractDocId: false,
  nestingLevel: 'nestingLevel',
  secretsManagerAccessRoleArn: 'secretsManagerAccessRoleArn',
  secretsManagerSecretId: 'secretsManagerSecretId',
};

Properties

NameTypeDescription
docsToInvestigate?numberIndicates the number of documents to preview to determine the document organization.
extractDocId?boolean | IResolvableSpecifies the document ID. Use this setting when NestingLevel is set to "none" .
nestingLevel?stringSpecifies either document or table mode.
secretsManagerAccessRoleArn?stringThe full Amazon Resource Name (ARN) of the IAM role that specifies AWS DMS as the trusted entity and grants the required permissions to access the value in SecretsManagerSecret .
secretsManagerSecretId?stringThe full ARN, partial ARN, or display name of the SecretsManagerSecret that contains the DocumentDB endpoint connection details.

docsToInvestigate?

Type: number (optional)

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 .


extractDocId?

Type: boolean | IResolvable (optional)

Specifies the document ID. Use this setting when NestingLevel is set to "none" .

Default value is "false" .


nestingLevel?

Type: string (optional)

Specifies either document or table mode.

Default value is "none" . Specify "none" to use document mode. Specify "one" to use table mode.


secretsManagerAccessRoleArn?

Type: string (optional)

The full Amazon Resource Name (ARN) of the IAM role that specifies AWS 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 AWS 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 , the corresponding SecretsManagerAccessRoleArn , and the SecretsManagerSecretId that is required to access it, see Using secrets to access AWS Database Migration Service resources in the AWS Database Migration Service User Guide .


secretsManagerSecretId?

Type: string (optional)

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