Skip to content

Commit 9907b5b

Browse files
author
AWS
committed
Amazon DataZone Update: Amazon DataZone now supports exporting Catalog datasets as Amazon S3 tables, and provides automatic business glossary term suggestions for data assets.
1 parent c17670b commit 9907b5b

File tree

2 files changed

+226
-9
lines changed

2 files changed

+226
-9
lines changed

‎.changes/next-release/feature-AmazonDataZone-ffc8b6c.json‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
{
2+
"type": "feature",
3+
"category": "Amazon DataZone",
4+
"contributor": "",
5+
"description": "Amazon DataZone now supports exporting Catalog datasets as Amazon S3 tables, and provides automatic business glossary term suggestions for data assets."
6+
}

‎services/datazone/src/main/resources/codegen-resources/service-2.json‎

Lines changed: 220 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1468,6 +1468,25 @@
14681468
],
14691469
"documentation":"<p>Gets a connection. In Amazon DataZone, a connection enables you to connect your resources (domains, projects, and environments) to external resources and services.</p>"
14701470
},
1471+
"GetDataExportConfiguration":{
1472+
"name":"GetDataExportConfiguration",
1473+
"http":{
1474+
"method":"GET",
1475+
"requestUri":"/v2/domains/{domainIdentifier}/data-export-configuration",
1476+
"responseCode":200
1477+
},
1478+
"input":{"shape":"GetDataExportConfigurationInput"},
1479+
"output":{"shape":"GetDataExportConfigurationOutput"},
1480+
"errors":[
1481+
{"shape":"InternalServerException"},
1482+
{"shape":"ResourceNotFoundException"},
1483+
{"shape":"AccessDeniedException"},
1484+
{"shape":"ThrottlingException"},
1485+
{"shape":"ValidationException"},
1486+
{"shape":"UnauthorizedException"}
1487+
],
1488+
"documentation":"<p>Gets data export configuration details.</p>"
1489+
},
14711490
"GetDataProduct":{
14721491
"name":"GetDataProduct",
14731492
"http":{
@@ -2712,6 +2731,28 @@
27122731
"documentation":"<p>Posts time series data points to Amazon DataZone for the specified asset.</p>",
27132732
"idempotent":true
27142733
},
2734+
"PutDataExportConfiguration":{
2735+
"name":"PutDataExportConfiguration",
2736+
"http":{
2737+
"method":"PUT",
2738+
"requestUri":"/v2/domains/{domainIdentifier}/data-export-configuration",
2739+
"responseCode":200
2740+
},
2741+
"input":{"shape":"PutDataExportConfigurationInput"},
2742+
"output":{"shape":"PutDataExportConfigurationOutput"},
2743+
"errors":[
2744+
{"shape":"InternalServerException"},
2745+
{"shape":"ResourceNotFoundException"},
2746+
{"shape":"AccessDeniedException"},
2747+
{"shape":"ThrottlingException"},
2748+
{"shape":"ServiceQuotaExceededException"},
2749+
{"shape":"ConflictException"},
2750+
{"shape":"ValidationException"},
2751+
{"shape":"UnauthorizedException"}
2752+
],
2753+
"documentation":"<p>Creates data export configuration details.</p> <p>In the current release, you can enable exporting asset metadata only for one domain per Amazon Web Services account per region. If you disable exporting asset metadata feature for a domain where it's already enabled, you cannot enable this feature for another domain in the same Amazon Web Services account and region.</p>",
2754+
"idempotent":true
2755+
},
27152756
"PutEnvironmentBlueprintConfiguration":{
27162757
"name":"PutEnvironmentBlueprintConfiguration",
27172758
"http":{
@@ -2968,7 +3009,7 @@
29683009
{"shape":"ValidationException"},
29693010
{"shape":"UnauthorizedException"}
29703011
],
2971-
"documentation":"<p>Starts the metadata generation run.</p> <p>Prerequisites:</p> <ul> <li> <p>Asset must be created and belong to the specified domain and project. </p> </li> <li> <p>Asset type must be supported for metadata generation (e.g., Amazon Web Services Glue table).</p> </li> <li> <p>Asset must have a structured schema with valid rows and columns.</p> </li> <li> <p>Valid values for --type: BUSINESS_DESCRIPTIONS, BUSINESS_NAMES.</p> </li> <li> <p>The user must have permission to run metadata generation in the domain/project.</p> </li> </ul>",
3012+
"documentation":"<p>Starts the metadata generation run.</p> <p>Prerequisites:</p> <ul> <li> <p>Asset must be created and belong to the specified domain and project. </p> </li> <li> <p>Asset type must be supported for metadata generation (e.g., Amazon Web Services Glue table).</p> </li> <li> <p>Asset must have a structured schema with valid rows and columns.</p> </li> <li> <p>Valid values for --type: BUSINESS_DESCRIPTIONS, BUSINESS_NAMES, BUSINESS_GLOSSARY_ASSOCIATIONS.</p> </li> <li> <p>The user must have permission to run metadata generation in the domain/project.</p> </li> </ul>",
29723013
"idempotent":true
29733014
},
29743015
"TagResource":{
@@ -5435,6 +5476,13 @@
54355476
},
54365477
"documentation":"<p>The configurable action of a Amazon DataZone environment.</p>"
54375478
},
5479+
"ConfigurationStatus":{
5480+
"type":"string",
5481+
"enum":[
5482+
"COMPLETED",
5483+
"FAILED"
5484+
]
5485+
},
54385486
"ConflictException":{
54395487
"type":"structure",
54405488
"required":["message"],
@@ -10667,6 +10715,20 @@
1066710715
"member":{"shape":"RegionName"},
1066810716
"min":0
1066910717
},
10718+
"EncryptionConfiguration":{
10719+
"type":"structure",
10720+
"members":{
10721+
"kmsKeyArn":{
10722+
"shape":"String",
10723+
"documentation":"<p>The Amazon Resource Name (ARN) of the KMS key to use for encryption. This field is required only when <code>sseAlgorithm</code> is set to <code>aws:kms</code>.</p>"
10724+
},
10725+
"sseAlgorithm":{
10726+
"shape":"String",
10727+
"documentation":"<p>The server-side encryption algorithm to use. Valid values are AES256 for S3-managed encryption keys, or aws:kms for Amazon Web Services KMS-managed encryption keys. If you choose SSE-KMS encryption you must grant the S3 Tables maintenance principal access to your KMS key. For more information, see <a href=\"https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-kms-permissions.html\">Permissions requirements for S3 Tables SSE-KMS encryption</a>.</p>"
10728+
}
10729+
},
10730+
"documentation":"<p>The encryption configuration details.</p>"
10731+
},
1067010732
"EntityId":{
1067110733
"type":"string",
1067210734
"pattern":"^[a-zA-Z0-9_-]{1,36}$"
@@ -12064,6 +12126,47 @@
1206412126
}
1206512127
}
1206612128
},
12129+
"GetDataExportConfigurationInput":{
12130+
"type":"structure",
12131+
"required":["domainIdentifier"],
12132+
"members":{
12133+
"domainIdentifier":{
12134+
"shape":"DomainId",
12135+
"documentation":"<p>The ID of the domain where you want to get the data export configuration details.</p>",
12136+
"location":"uri",
12137+
"locationName":"domainIdentifier"
12138+
}
12139+
}
12140+
},
12141+
"GetDataExportConfigurationOutput":{
12142+
"type":"structure",
12143+
"members":{
12144+
"createdAt":{
12145+
"shape":"CreatedAt",
12146+
"documentation":"<p>The timestamp at which the data export configuration report was created.</p>"
12147+
},
12148+
"encryptionConfiguration":{
12149+
"shape":"EncryptionConfiguration",
12150+
"documentation":"<p>The encryption configuration as part of the data export configuration details.</p>"
12151+
},
12152+
"isExportEnabled":{
12153+
"shape":"Boolean",
12154+
"documentation":"<p>Specifies whether the export is enabled.</p>"
12155+
},
12156+
"s3TableBucketArn":{
12157+
"shape":"String",
12158+
"documentation":"<p>The Amazon S3 table bucket ARN as part of the data export configuration details.</p>"
12159+
},
12160+
"status":{
12161+
"shape":"ConfigurationStatus",
12162+
"documentation":"<p>The status of the data export configuration.</p>"
12163+
},
12164+
"updatedAt":{
12165+
"shape":"UpdatedAt",
12166+
"documentation":"<p>The timestamp at which the data export configuration report was updated.</p>"
12167+
}
12168+
}
12169+
},
1206712170
"GetDataProductInput":{
1206812171
"type":"structure",
1206912172
"required":[
@@ -13634,6 +13737,12 @@
1363413737
"documentation":"<p>The identifier of the metadata generation run.</p>",
1363513738
"location":"uri",
1363613739
"locationName":"identifier"
13740+
},
13741+
"type":{
13742+
"shape":"MetadataGenerationRunType",
13743+
"documentation":"<p>The type of the metadata generation run.</p>",
13744+
"location":"querystring",
13745+
"locationName":"type"
1363713746
}
1363813747
}
1363913748
},
@@ -13675,7 +13784,17 @@
1367513784
},
1367613785
"type":{
1367713786
"shape":"MetadataGenerationRunType",
13678-
"documentation":"<p>The type of metadata generation run.</p>"
13787+
"documentation":"<p>The type of metadata generation run.</p>",
13788+
"deprecated":true,
13789+
"deprecatedMessage":"This field is going to be deprecated, please use the 'types' field to provide the MetadataGenerationRun types"
13790+
},
13791+
"typeStats":{
13792+
"shape":"MetadataGenerationRunTypeStats",
13793+
"documentation":"<p>The type stats included in the metadata generation run output details.</p>"
13794+
},
13795+
"types":{
13796+
"shape":"MetadataGenerationRunTypes",
13797+
"documentation":"<p>The types of the metadata generation run.</p>"
1367913798
}
1368013799
}
1368113800
},
@@ -17019,6 +17138,12 @@
1701917138
"location":"querystring",
1702017139
"locationName":"status"
1702117140
},
17141+
"targetIdentifier":{
17142+
"shape":"EntityId",
17143+
"documentation":"<p>The target ID for which you want to list metadata generation runs.</p>",
17144+
"location":"querystring",
17145+
"locationName":"targetIdentifier"
17146+
},
1702217147
"type":{
1702317148
"shape":"MetadataGenerationRunType",
1702417149
"documentation":"<p>The type of the metadata generation runs.</p>",
@@ -18212,7 +18337,13 @@
1821218337
},
1821318338
"type":{
1821418339
"shape":"MetadataGenerationRunType",
18215-
"documentation":"<p>The type of the metadata generation run.</p>"
18340+
"documentation":"<p>The type of the metadata generation run.</p>",
18341+
"deprecated":true,
18342+
"deprecatedMessage":"This field is going to be deprecated, please use the 'types' field to provide the MetadataGenerationRun types"
18343+
},
18344+
"types":{
18345+
"shape":"MetadataGenerationRunTypes",
18346+
"documentation":"<p>The types of the metadata generation run.</p>"
1821618347
}
1821718348
},
1821818349
"documentation":"<p>The metadata generation run.</p>"
@@ -18224,7 +18355,8 @@
1822418355
"IN_PROGRESS",
1822518356
"CANCELED",
1822618357
"SUCCEEDED",
18227-
"FAILED"
18358+
"FAILED",
18359+
"PARTIALLY_SUCCEEDED"
1822818360
]
1822918361
},
1823018362
"MetadataGenerationRunTarget":{
@@ -18251,7 +18383,43 @@
1825118383
},
1825218384
"MetadataGenerationRunType":{
1825318385
"type":"string",
18254-
"enum":["BUSINESS_DESCRIPTIONS"]
18386+
"enum":[
18387+
"BUSINESS_DESCRIPTIONS",
18388+
"BUSINESS_NAMES",
18389+
"BUSINESS_GLOSSARY_ASSOCIATIONS"
18390+
]
18391+
},
18392+
"MetadataGenerationRunTypeStat":{
18393+
"type":"structure",
18394+
"required":[
18395+
"status",
18396+
"type"
18397+
],
18398+
"members":{
18399+
"errorMessage":{
18400+
"shape":"String",
18401+
"documentation":"<p>The error message displayed if the action fails to run.</p>"
18402+
},
18403+
"status":{
18404+
"shape":"MetadataGenerationRunStatus",
18405+
"documentation":"<p>The status of the metadata generation run type statistics.</p>"
18406+
},
18407+
"type":{
18408+
"shape":"MetadataGenerationRunType",
18409+
"documentation":"<p>The type of the metadata generation run type statistics.</p>"
18410+
}
18411+
},
18412+
"documentation":"<p>The statistics of the metadata generation run type.</p>"
18413+
},
18414+
"MetadataGenerationRunTypeStats":{
18415+
"type":"list",
18416+
"member":{"shape":"MetadataGenerationRunTypeStat"}
18417+
},
18418+
"MetadataGenerationRunTypes":{
18419+
"type":"list",
18420+
"member":{"shape":"MetadataGenerationRunType"},
18421+
"max":2,
18422+
"min":1
1825518423
},
1825618424
"MetadataGenerationRuns":{
1825718425
"type":"list",
@@ -19330,6 +19498,38 @@
1933019498
"documentation":"<p>The provisioning properties of an environment blueprint.</p>",
1933119499
"union":true
1933219500
},
19501+
"PutDataExportConfigurationInput":{
19502+
"type":"structure",
19503+
"required":[
19504+
"domainIdentifier",
19505+
"enableExport"
19506+
],
19507+
"members":{
19508+
"clientToken":{
19509+
"shape":"ClientToken",
19510+
"documentation":"<p>A unique, case-sensitive identifier to ensure idempotency of the request. This field is automatically populated if not provided.</p>",
19511+
"idempotencyToken":true
19512+
},
19513+
"domainIdentifier":{
19514+
"shape":"DomainId",
19515+
"documentation":"<p>The domain ID where you want to create data export configuration details.</p>",
19516+
"location":"uri",
19517+
"locationName":"domainIdentifier"
19518+
},
19519+
"enableExport":{
19520+
"shape":"Boolean",
19521+
"documentation":"<p>Specifies that the export is to be enabled as part of creating data export configuration details.</p>"
19522+
},
19523+
"encryptionConfiguration":{
19524+
"shape":"EncryptionConfiguration",
19525+
"documentation":"<p>The encryption configuration as part of creating data export configuration details.</p> <p>The KMS key provided here as part of encryptionConfiguration must have the required permissions as described in <a href=\"https://docs.aws.amazon.com/sagemaker-unified-studio/latest/adminguide/sagemaker-unified-studio-export-asset-metadata-kms-permissions.html\">KMS permissions for exporting asset metadata in Amazon SageMaker Unified Studio</a>.</p>"
19526+
}
19527+
}
19528+
},
19529+
"PutDataExportConfigurationOutput":{
19530+
"type":"structure",
19531+
"members":{}
19532+
},
1933319533
"PutEnvironmentBlueprintConfigurationInput":{
1933419534
"type":"structure",
1933519535
"required":[
@@ -21792,8 +21992,7 @@
2179221992
"required":[
2179321993
"domainIdentifier",
2179421994
"owningProjectIdentifier",
21795-
"target",
21796-
"type"
21995+
"target"
2179721996
],
2179821997
"members":{
2179921998
"clientToken":{
@@ -21817,7 +22016,13 @@
2181722016
},
2181822017
"type":{
2181922018
"shape":"MetadataGenerationRunType",
21820-
"documentation":"<p>The type of the metadata generation run.</p>"
22019+
"documentation":"<p>The type of the metadata generation run.</p>",
22020+
"deprecated":true,
22021+
"deprecatedMessage":"This field is going to be deprecated, please use the 'types' field to provide the MetadataGenerationRun types"
22022+
},
22023+
"types":{
22024+
"shape":"MetadataGenerationRunTypes",
22025+
"documentation":"<p>The types of the metadata generation run.</p>"
2182122026
}
2182222027
}
2182322028
},
@@ -21854,7 +22059,13 @@
2185422059
},
2185522060
"type":{
2185622061
"shape":"MetadataGenerationRunType",
21857-
"documentation":"<p>The type of the metadata generation run.</p>"
22062+
"documentation":"<p>The type of the metadata generation run.</p>",
22063+
"deprecated":true,
22064+
"deprecatedMessage":"This field is going to be deprecated, please use the 'types' field to provide the MetadataGenerationRun types"
22065+
},
22066+
"types":{
22067+
"shape":"MetadataGenerationRunTypes",
22068+
"documentation":"<p>The types of the metadata generation run.</p>"
2185822069
}
2185922070
}
2186022071
},

0 commit comments

Comments
 (0)