ReadonlybucketOptional ReadonlycreateFlag controlling CloudFormation output and stack export creation for construct resources
Optional ReadonlycreateFlag controlling SSM parameter creation for construct resource references enabling
ReadonlydomainDataZone domain ID in which the connection is created.
Optional ReadonlyenvironmentDataZone environment ID in which the connection is created. Required for SMUS (SageMaker Unified Studio) projects; omit for DataZone (non-SMUS) projects.
Optional ReadonlygrantARN of an IAM role to grant read access (list + get object) on bucketName/prefix.
Typically the DataZone/SMUS project's environment user role. Unlike the Glue data source
path, DataZone does not grant Lake Formation permissions for a raw S3 connection, so this
is MDAA's default access-control mechanism for a raw S3 connection — both L3 callers
(sagemaker-project, dataops-project) always pass the project's environment role here,
matching the Glue path's always-on Lake Formation grant. registerS3AccessGrantLocation
above is an optional, additional layer on top of this, not a substitute for it.
This grant alone cannot make objects readable on every bucket: it adds no KMS access (see
kmsKeyArn below), and it cannot override a bucket policy that denies access by default.
A bucket with a default-deny policy, such as an MDAA data lake bucket's accessPolicies,
must also list this role on its own policy for reads to actually succeed.
Optional ReadonlykmsARN of the KMS key used to encrypt bucketName, if SSE-KMS. When set alongside
grantReadRoleArn, grants that role kms:Decrypt on this key, scoped to calls made
through the S3 service. Without this, grantReadRoleArn cannot decrypt objects in an
SSE-KMS bucket even though it can list and get them.
ReadonlynameName used to generate the DataZone connection's resource name.
ReadonlynamingMDAA naming implementation for consistent resource naming across all MDAA constructs
Optional ReadonlyprefixKey prefix within the bucket to register, e.g. raw/. Registers the whole bucket when
omitted.
ReadonlyprojectDataZone project ID that will own the connection.
Optional ReadonlyregisterWhether to register an S3 Access Grants location for the connection. This is an
additional, optional governance layer on top of grantReadRoleArn (below), which is
MDAA's default, unconditional access control for this construct. When enabled, SageMaker
Unified Studio registers the S3 Access Grants location itself — creating an S3 Access
Grants instance first if none exists in the account/region — which requires
s3:CreateAccessGrantsLocation, s3:CreateAccessGrant, and related Access Grants
permissions on the caller. MDAA does not grant these permissions to any role, so enabling
this flag only works if that caller already has them from outside this construct.
Optional Readonlys3S3 Access Grants location ID to associate with the connection.
Name of the S3 bucket to register as the connection's data source. Accepts a literal bucket name or an MDAA
ssm-org:/ssm-domain:reference to a bucket created by another module (e.g.ssm-org:/shared/datalake/bucket/research/name).