Skip to content

Commit 6d74002

Browse files
author
awstools
committed
feat(client-glue): To support customer-managed encryption in Data Quality to allow customers encrypt data with their own KMS key, we will add a DataQualityEncryption field to the SecurityConfiguration API where customers can provide their KMS keys.
1 parent 97520fc commit 6d74002

13 files changed

+218
-114
lines changed

clients/client-glue/src/commands/CreateSecurityConfigurationCommand.ts

+4
Original file line numberDiff line numberDiff line change
@@ -54,6 +54,10 @@ export interface CreateSecurityConfigurationCommandOutput
5454
* JobBookmarksEncryptionMode: "DISABLED" || "CSE-KMS",
5555
* KmsKeyArn: "STRING_VALUE",
5656
* },
57+
* DataQualityEncryption: { // DataQualityEncryption
58+
* DataQualityEncryptionMode: "DISABLED" || "SSE-KMS",
59+
* KmsKeyArn: "STRING_VALUE",
60+
* },
5761
* },
5862
* };
5963
* const command = new CreateSecurityConfigurationCommand(input);

clients/client-glue/src/commands/CreateTriggerCommand.ts

+1
Original file line numberDiff line numberDiff line change
@@ -29,6 +29,7 @@ export interface CreateTriggerCommandOutput extends CreateTriggerResponse, __Met
2929

3030
/**
3131
* <p>Creates a new trigger.</p>
32+
* <p>Job arguments may be logged. Do not pass plaintext secrets as arguments. Retrieve secrets from a Glue Connection, Amazon Web Services Secrets Manager or other secret management mechanism if you intend to keep them within the Job.</p>
3233
* @example
3334
* Use a bare-bones client and the command you need to make an API call.
3435
* ```javascript

clients/client-glue/src/commands/GetJobRunCommand.ts

+1-1
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ export interface GetJobRunCommandInput extends GetJobRunRequest {}
2828
export interface GetJobRunCommandOutput extends GetJobRunResponse, __MetadataBearer {}
2929

3030
/**
31-
* <p>Retrieves the metadata for a given job run. Job run history is accessible for 90 days for your workflow and job run.</p>
31+
* <p>Retrieves the metadata for a given job run. Job run history is accessible for 365 days for your workflow and job run.</p>
3232
* @example
3333
* Use a bare-bones client and the command you need to make an API call.
3434
* ```javascript

clients/client-glue/src/commands/GetJobRunsCommand.ts

+2
Original file line numberDiff line numberDiff line change
@@ -29,6 +29,8 @@ export interface GetJobRunsCommandOutput extends GetJobRunsResponse, __MetadataB
2929

3030
/**
3131
* <p>Retrieves metadata for all runs of a given job definition.</p>
32+
* <p>
33+
* <code>GetJobRuns</code> returns the job runs in chronological order, with the newest jobs returned first.</p>
3234
* @example
3335
* Use a bare-bones client and the command you need to make an API call.
3436
* ```javascript

clients/client-glue/src/commands/GetSecurityConfigurationCommand.ts

+4
Original file line numberDiff line numberDiff line change
@@ -59,6 +59,10 @@ export interface GetSecurityConfigurationCommandOutput extends GetSecurityConfig
5959
* // JobBookmarksEncryptionMode: "DISABLED" || "CSE-KMS",
6060
* // KmsKeyArn: "STRING_VALUE",
6161
* // },
62+
* // DataQualityEncryption: { // DataQualityEncryption
63+
* // DataQualityEncryptionMode: "DISABLED" || "SSE-KMS",
64+
* // KmsKeyArn: "STRING_VALUE",
65+
* // },
6266
* // },
6367
* // },
6468
* // };

clients/client-glue/src/commands/GetSecurityConfigurationsCommand.ts

+4
Original file line numberDiff line numberDiff line change
@@ -61,6 +61,10 @@ export interface GetSecurityConfigurationsCommandOutput extends GetSecurityConfi
6161
* // JobBookmarksEncryptionMode: "DISABLED" || "CSE-KMS",
6262
* // KmsKeyArn: "STRING_VALUE",
6363
* // },
64+
* // DataQualityEncryption: { // DataQualityEncryption
65+
* // DataQualityEncryptionMode: "DISABLED" || "SSE-KMS",
66+
* // KmsKeyArn: "STRING_VALUE",
67+
* // },
6468
* // },
6569
* // },
6670
* // ],

clients/client-glue/src/commands/UpdateTriggerCommand.ts

+1
Original file line numberDiff line numberDiff line change
@@ -29,6 +29,7 @@ export interface UpdateTriggerCommandOutput extends UpdateTriggerResponse, __Met
2929

3030
/**
3131
* <p>Updates a trigger definition.</p>
32+
* <p>Job arguments may be logged. Do not pass plaintext secrets as arguments. Retrieve secrets from a Glue Connection, Amazon Web Services Secrets Manager or other secret management mechanism if you intend to keep them within the Job.</p>
3233
* @example
3334
* Use a bare-bones client and the command you need to make an API call.
3435
* ```javascript

clients/client-glue/src/models/models_0.ts

+6-6
Original file line numberDiff line numberDiff line change
@@ -8823,22 +8823,22 @@ export interface JobRun {
88238823
* G.1X, G.2X, G.4X, G.8X or G.025X for Spark jobs. Accepts the value Z.2X for Ray jobs.</p>
88248824
* <ul>
88258825
* <li>
8826-
* <p>For the <code>G.1X</code> worker type, each worker maps to 1 DPU (4 vCPUs, 16 GB of memory) with 84GB disk (approximately 34GB free), and provides 1 executor per worker. We recommend this worker type for workloads such as data transforms, joins, and queries, to offers a scalable and cost effective way to run most jobs.</p>
8826+
* <p>For the <code>G.1X</code> worker type, each worker maps to 1 DPU (4 vCPUs, 16 GB of memory) with 94GB disk, and provides 1 executor per worker. We recommend this worker type for workloads such as data transforms, joins, and queries, to offers a scalable and cost effective way to run most jobs.</p>
88278827
* </li>
88288828
* <li>
8829-
* <p>For the <code>G.2X</code> worker type, each worker maps to 2 DPU (8 vCPUs, 32 GB of memory) with 128GB disk (approximately 77GB free), and provides 1 executor per worker. We recommend this worker type for workloads such as data transforms, joins, and queries, to offers a scalable and cost effective way to run most jobs.</p>
8829+
* <p>For the <code>G.2X</code> worker type, each worker maps to 2 DPU (8 vCPUs, 32 GB of memory) with 138GB disk, and provides 1 executor per worker. We recommend this worker type for workloads such as data transforms, joins, and queries, to offers a scalable and cost effective way to run most jobs.</p>
88308830
* </li>
88318831
* <li>
8832-
* <p>For the <code>G.4X</code> worker type, each worker maps to 4 DPU (16 vCPUs, 64 GB of memory) with 256GB disk (approximately 235GB free), and provides 1 executor per worker. We recommend this worker type for jobs whose workloads contain your most demanding transforms, aggregations, joins, and queries. This worker type is available only for Glue version 3.0 or later Spark ETL jobs in the following Amazon Web Services Regions: US East (Ohio), US East (N. Virginia), US West (Oregon), Asia Pacific (Singapore), Asia Pacific (Sydney), Asia Pacific (Tokyo), Canada (Central), Europe (Frankfurt), Europe (Ireland), and Europe (Stockholm).</p>
8832+
* <p>For the <code>G.4X</code> worker type, each worker maps to 4 DPU (16 vCPUs, 64 GB of memory) with 256GB disk, and provides 1 executor per worker. We recommend this worker type for jobs whose workloads contain your most demanding transforms, aggregations, joins, and queries. This worker type is available only for Glue version 3.0 or later Spark ETL jobs in the following Amazon Web Services Regions: US East (Ohio), US East (N. Virginia), US West (Oregon), Asia Pacific (Singapore), Asia Pacific (Sydney), Asia Pacific (Tokyo), Canada (Central), Europe (Frankfurt), Europe (Ireland), and Europe (Stockholm).</p>
88338833
* </li>
88348834
* <li>
8835-
* <p>For the <code>G.8X</code> worker type, each worker maps to 8 DPU (32 vCPUs, 128 GB of memory) with 512GB disk (approximately 487GB free), and provides 1 executor per worker. We recommend this worker type for jobs whose workloads contain your most demanding transforms, aggregations, joins, and queries. This worker type is available only for Glue version 3.0 or later Spark ETL jobs, in the same Amazon Web Services Regions as supported for the <code>G.4X</code> worker type.</p>
8835+
* <p>For the <code>G.8X</code> worker type, each worker maps to 8 DPU (32 vCPUs, 128 GB of memory) with 512GB disk, and provides 1 executor per worker. We recommend this worker type for jobs whose workloads contain your most demanding transforms, aggregations, joins, and queries. This worker type is available only for Glue version 3.0 or later Spark ETL jobs, in the same Amazon Web Services Regions as supported for the <code>G.4X</code> worker type.</p>
88368836
* </li>
88378837
* <li>
8838-
* <p>For the <code>G.025X</code> worker type, each worker maps to 0.25 DPU (2 vCPUs, 4 GB of memory) with 84GB disk (approximately 34GB free), and provides 1 executor per worker. We recommend this worker type for low volume streaming jobs. This worker type is only available for Glue version 3.0 streaming jobs.</p>
8838+
* <p>For the <code>G.025X</code> worker type, each worker maps to 0.25 DPU (2 vCPUs, 4 GB of memory) with 84GB disk, and provides 1 executor per worker. We recommend this worker type for low volume streaming jobs. This worker type is only available for Glue version 3.0 or later streaming jobs.</p>
88398839
* </li>
88408840
* <li>
8841-
* <p>For the <code>Z.2X</code> worker type, each worker maps to 2 M-DPU (8vCPUs, 64 GB of memory) with 128 GB disk (approximately 120GB free), and provides up to 8 Ray workers based on the autoscaler.</p>
8841+
* <p>For the <code>Z.2X</code> worker type, each worker maps to 2 M-DPU (8vCPUs, 64 GB of memory) with 128 GB disk, and provides up to 8 Ray workers based on the autoscaler.</p>
88428842
* </li>
88438843
* </ul>
88448844
* @public

clients/client-glue/src/models/models_1.ts

+45-33
Original file line numberDiff line numberDiff line change
@@ -3496,6 +3496,39 @@ export interface CloudWatchEncryption {
34963496
KmsKeyArn?: string | undefined;
34973497
}
34983498

3499+
/**
3500+
* @public
3501+
* @enum
3502+
*/
3503+
export const DataQualityEncryptionMode = {
3504+
DISABLED: "DISABLED",
3505+
SSEKMS: "SSE-KMS",
3506+
} as const;
3507+
3508+
/**
3509+
* @public
3510+
*/
3511+
export type DataQualityEncryptionMode = (typeof DataQualityEncryptionMode)[keyof typeof DataQualityEncryptionMode];
3512+
3513+
/**
3514+
* <p>Specifies how Data Quality assets in your account should be encrypted.</p>
3515+
* @public
3516+
*/
3517+
export interface DataQualityEncryption {
3518+
/**
3519+
* <p>The encryption mode to use for encrypting Data Quality assets. These assets include data quality rulesets, results, statistics, anomaly detection models and observations.</p>
3520+
* <p>Valid values are <code>SSEKMS</code> for encryption using a customer-managed KMS key, or <code>DISABLED</code>.</p>
3521+
* @public
3522+
*/
3523+
DataQualityEncryptionMode?: DataQualityEncryptionMode | undefined;
3524+
3525+
/**
3526+
* <p>The Amazon Resource Name (ARN) of the KMS key to be used to encrypt the data.</p>
3527+
* @public
3528+
*/
3529+
KmsKeyArn?: string | undefined;
3530+
}
3531+
34993532
/**
35003533
* @public
35013534
* @enum
@@ -3583,6 +3616,12 @@ export interface EncryptionConfiguration {
35833616
* @public
35843617
*/
35853618
JobBookmarksEncryption?: JobBookmarksEncryption | undefined;
3619+
3620+
/**
3621+
* <p>The encryption configuration for Glue Data Quality assets.</p>
3622+
* @public
3623+
*/
3624+
DataQualityEncryption?: DataQualityEncryption | undefined;
35863625
}
35873626

35883627
/**
@@ -3716,19 +3755,19 @@ export interface CreateSessionRequest {
37163755
* G.1X, G.2X, G.4X, or G.8X for Spark jobs. Accepts the value Z.2X for Ray notebooks.</p>
37173756
* <ul>
37183757
* <li>
3719-
* <p>For the <code>G.1X</code> worker type, each worker maps to 1 DPU (4 vCPUs, 16 GB of memory) with 84GB disk (approximately 34GB free), and provides 1 executor per worker. We recommend this worker type for workloads such as data transforms, joins, and queries, to offers a scalable and cost effective way to run most jobs.</p>
3758+
* <p>For the <code>G.1X</code> worker type, each worker maps to 1 DPU (4 vCPUs, 16 GB of memory) with 94GB disk, and provides 1 executor per worker. We recommend this worker type for workloads such as data transforms, joins, and queries, to offers a scalable and cost effective way to run most jobs.</p>
37203759
* </li>
37213760
* <li>
3722-
* <p>For the <code>G.2X</code> worker type, each worker maps to 2 DPU (8 vCPUs, 32 GB of memory) with 128GB disk (approximately 77GB free), and provides 1 executor per worker. We recommend this worker type for workloads such as data transforms, joins, and queries, to offers a scalable and cost effective way to run most jobs.</p>
3761+
* <p>For the <code>G.2X</code> worker type, each worker maps to 2 DPU (8 vCPUs, 32 GB of memory) with 138GB disk, and provides 1 executor per worker. We recommend this worker type for workloads such as data transforms, joins, and queries, to offers a scalable and cost effective way to run most jobs.</p>
37233762
* </li>
37243763
* <li>
3725-
* <p>For the <code>G.4X</code> worker type, each worker maps to 4 DPU (16 vCPUs, 64 GB of memory) with 256GB disk (approximately 235GB free), and provides 1 executor per worker. We recommend this worker type for jobs whose workloads contain your most demanding transforms, aggregations, joins, and queries. This worker type is available only for Glue version 3.0 or later Spark ETL jobs in the following Amazon Web Services Regions: US East (Ohio), US East (N. Virginia), US West (Oregon), Asia Pacific (Singapore), Asia Pacific (Sydney), Asia Pacific (Tokyo), Canada (Central), Europe (Frankfurt), Europe (Ireland), and Europe (Stockholm).</p>
3764+
* <p>For the <code>G.4X</code> worker type, each worker maps to 4 DPU (16 vCPUs, 64 GB of memory) with 256GB disk, and provides 1 executor per worker. We recommend this worker type for jobs whose workloads contain your most demanding transforms, aggregations, joins, and queries. This worker type is available only for Glue version 3.0 or later Spark ETL jobs in the following Amazon Web Services Regions: US East (Ohio), US East (N. Virginia), US West (Oregon), Asia Pacific (Singapore), Asia Pacific (Sydney), Asia Pacific (Tokyo), Canada (Central), Europe (Frankfurt), Europe (Ireland), and Europe (Stockholm).</p>
37263765
* </li>
37273766
* <li>
3728-
* <p>For the <code>G.8X</code> worker type, each worker maps to 8 DPU (32 vCPUs, 128 GB of memory) with 512GB disk (approximately 487GB free), and provides 1 executor per worker. We recommend this worker type for jobs whose workloads contain your most demanding transforms, aggregations, joins, and queries. This worker type is available only for Glue version 3.0 or later Spark ETL jobs, in the same Amazon Web Services Regions as supported for the <code>G.4X</code> worker type.</p>
3767+
* <p>For the <code>G.8X</code> worker type, each worker maps to 8 DPU (32 vCPUs, 128 GB of memory) with 512GB disk, and provides 1 executor per worker. We recommend this worker type for jobs whose workloads contain your most demanding transforms, aggregations, joins, and queries. This worker type is available only for Glue version 3.0 or later Spark ETL jobs, in the same Amazon Web Services Regions as supported for the <code>G.4X</code> worker type.</p>
37293768
* </li>
37303769
* <li>
3731-
* <p>For the <code>Z.2X</code> worker type, each worker maps to 2 M-DPU (8vCPUs, 64 GB of memory) with 128 GB disk (approximately 120GB free), and provides up to 8 Ray workers based on the autoscaler.</p>
3770+
* <p>For the <code>Z.2X</code> worker type, each worker maps to 2 M-DPU (8vCPUs, 64 GB of memory) with 128 GB disk, and provides up to 8 Ray workers based on the autoscaler.</p>
37323771
* </li>
37333772
* </ul>
37343773
* @public
@@ -4606,6 +4645,7 @@ export interface CreateWorkflowRequest {
46064645

46074646
/**
46084647
* <p>A collection of properties to be used as part of each execution of the workflow.</p>
4648+
* <p>Run properties may be logged. Do not pass plaintext secrets as properties. Retrieve secrets from a Glue Connection, Amazon Web Services Secrets Manager or other secret management mechanism if you intend to use them within the workflow run.</p>
46094649
* @public
46104650
*/
46114651
DefaultRunProperties?: Record<string, string> | undefined;
@@ -7880,34 +7920,6 @@ export interface ExecutionAttempt {
78807920
ErrorMessage?: string | undefined;
78817921
}
78827922

7883-
/**
7884-
* @public
7885-
* @enum
7886-
*/
7887-
export const ScheduleType = {
7888-
AUTO: "AUTO",
7889-
CRON: "CRON",
7890-
} as const;
7891-
7892-
/**
7893-
* @public
7894-
*/
7895-
export type ScheduleType = (typeof ScheduleType)[keyof typeof ScheduleType];
7896-
7897-
/**
7898-
* @public
7899-
* @enum
7900-
*/
7901-
export const SettingSource = {
7902-
CATALOG: "CATALOG",
7903-
TABLE: "TABLE",
7904-
} as const;
7905-
7906-
/**
7907-
* @public
7908-
*/
7909-
export type SettingSource = (typeof SettingSource)[keyof typeof SettingSource];
7910-
79117923
/**
79127924
* @internal
79137925
*/

clients/client-glue/src/models/models_2.ts

+29-34
Original file line numberDiff line numberDiff line change
@@ -64,11 +64,9 @@ import {
6464
RegistryId,
6565
RegistryStatus,
6666
ResourceUri,
67-
ScheduleType,
6867
SchemaStatus,
6968
SchemaVersionStatus,
7069
Session,
71-
SettingSource,
7270
SourceProcessingProperties,
7371
SourceTableConfig,
7472
Tag,
@@ -81,6 +79,34 @@ import {
8179
ViewDialect,
8280
} from "./models_1";
8381

82+
/**
83+
* @public
84+
* @enum
85+
*/
86+
export const ScheduleType = {
87+
AUTO: "AUTO",
88+
CRON: "CRON",
89+
} as const;
90+
91+
/**
92+
* @public
93+
*/
94+
export type ScheduleType = (typeof ScheduleType)[keyof typeof ScheduleType];
95+
96+
/**
97+
* @public
98+
* @enum
99+
*/
100+
export const SettingSource = {
101+
CATALOG: "CATALOG",
102+
TABLE: "TABLE",
103+
} as const;
104+
105+
/**
106+
* @public
107+
*/
108+
export type SettingSource = (typeof SettingSource)[keyof typeof SettingSource];
109+
84110
/**
85111
* <p>The settings for a column statistics task.</p>
86112
* @public
@@ -8118,6 +8144,7 @@ export interface PutWorkflowRunPropertiesRequest {
81188144

81198145
/**
81208146
* <p>The properties to put for the specified run.</p>
8147+
* <p>Run properties may be logged. Do not pass plaintext secrets as properties. Retrieve secrets from a Glue Connection, Amazon Web Services Secrets Manager or other secret management mechanism if you intend to use them within the workflow run.</p>
81218148
* @public
81228149
*/
81238150
RunProperties: Record<string, string> | undefined;
@@ -8559,38 +8586,6 @@ export interface PropertyPredicate {
85598586
Comparator?: Comparator | undefined;
85608587
}
85618588

8562-
/**
8563-
* @public
8564-
* @enum
8565-
*/
8566-
export const Sort = {
8567-
ASCENDING: "ASC",
8568-
DESCENDING: "DESC",
8569-
} as const;
8570-
8571-
/**
8572-
* @public
8573-
*/
8574-
export type Sort = (typeof Sort)[keyof typeof Sort];
8575-
8576-
/**
8577-
* <p>Specifies a field to sort by and a sort order.</p>
8578-
* @public
8579-
*/
8580-
export interface SortCriterion {
8581-
/**
8582-
* <p>The name of the field on which to sort.</p>
8583-
* @public
8584-
*/
8585-
FieldName?: string | undefined;
8586-
8587-
/**
8588-
* <p>An ascending or descending sort.</p>
8589-
* @public
8590-
*/
8591-
Sort?: Sort | undefined;
8592-
}
8593-
85948589
/**
85958590
* @internal
85968591
*/

0 commit comments

Comments
 (0)