aws-sdk-glue 1.178.0 → 1.179.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 292432521ca18ed4bdcf7e8ac43235c16dc408afb9a161f96d1743802749b243
-  data.tar.gz: 49291f5da066aad5275357e2e969ab57023cedbedb832fc11101e0c7240c6ce7
+  metadata.gz: 4219986e9bea5e3bbd1ed0a0b4f2cb436ecc9046efc8d1a39c589c9b32691ff9
+  data.tar.gz: 6b23c8a36504d930662db691233e8fefbb084b71b08bedd8f3992663dc68fe91
 SHA512:
-  metadata.gz: 3c9699231d525bb117efc042fd309b620c64aa74ae4fe211f374397377398fd03d6336201fa0881d1302b153f5ad702dee751aabdd938a709ceb1a34e1925ada
-  data.tar.gz: 504fced69766bbbf92890f10dfde26ac448709d3690da36c70cb7497fa580368ac838463b158ebc551daef6aef11c5051c4ccbb6dc76df11520b0b8186351622
+  metadata.gz: f0be801e08eca16f6f18a8c4e965bff4777ba5a5d49668e0f273566145200491a2c55e3a43ec1c44202d43967ee5d637064d46ad4a76b588206798a432ec2afd
+  data.tar.gz: b6dcc741a0b42bdddb31d3a1cfd548a4f41fcf24e37d1b3eafda1a00a27fe15ba944a28e31c33767063a4db0e73b49719acb4891a145847a67edaaeb7ec8a5cf

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.179.0 (2024-06-17)
+------------------
+
+* Feature - This release introduces a new feature, Usage profiles. Usage profiles allow the AWS Glue admin to create different profiles for various classes of users within the account, enforcing limits and defaults for jobs and sessions.
+
 1.178.0 (2024-06-13)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.178.0
+1.179.0

data/lib/aws-sdk-glue/client.rb

@@ -1971,6 +1971,7 @@ module Aws::Glue
     #   resp.jobs[0].source_control_details.auth_strategy #=> String, one of "PERSONAL_ACCESS_TOKEN", "AWS_SECRETS_MANAGER"
     #   resp.jobs[0].source_control_details.auth_token #=> String
     #   resp.jobs[0].maintenance_window #=> String
+    #   resp.jobs[0].profile_name #=> String
     #   resp.jobs_not_found #=> Array
     #   resp.jobs_not_found[0] #=> String
     #
@@ -2307,6 +2308,7 @@ module Aws::Glue
     #   resp.workflows[0].last_run.graph.nodes[0].job_details.job_runs[0].dpu_seconds #=> Float
     #   resp.workflows[0].last_run.graph.nodes[0].job_details.job_runs[0].execution_class #=> String, one of "FLEX", "STANDARD"
     #   resp.workflows[0].last_run.graph.nodes[0].job_details.job_runs[0].maintenance_window #=> String
+    #   resp.workflows[0].last_run.graph.nodes[0].job_details.job_runs[0].profile_name #=> String
     #   resp.workflows[0].last_run.graph.nodes[0].crawler_details.crawls #=> Array
     #   resp.workflows[0].last_run.graph.nodes[0].crawler_details.crawls[0].state #=> String, one of "RUNNING", "CANCELLING", "CANCELLED", "SUCCEEDED", "FAILED", "ERROR"
     #   resp.workflows[0].last_run.graph.nodes[0].crawler_details.crawls[0].started_on #=> Time
@@ -2377,6 +2379,7 @@ module Aws::Glue
     #   resp.workflows[0].graph.nodes[0].job_details.job_runs[0].dpu_seconds #=> Float
     #   resp.workflows[0].graph.nodes[0].job_details.job_runs[0].execution_class #=> String, one of "FLEX", "STANDARD"
     #   resp.workflows[0].graph.nodes[0].job_details.job_runs[0].maintenance_window #=> String
+    #   resp.workflows[0].graph.nodes[0].job_details.job_runs[0].profile_name #=> String
     #   resp.workflows[0].graph.nodes[0].crawler_details.crawls #=> Array
     #   resp.workflows[0].graph.nodes[0].crawler_details.crawls[0].state #=> String, one of "RUNNING", "CANCELLING", "CANCELLED", "SUCCEEDED", "FAILED", "ERROR"
     #   resp.workflows[0].graph.nodes[0].crawler_details.crawls[0].started_on #=> Time
@@ -4515,6 +4518,7 @@ module Aws::Glue
     #   resp.session.execution_time #=> Float
     #   resp.session.dpu_seconds #=> Float
     #   resp.session.idle_timeout #=> Integer
+    #   resp.session.profile_name #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/glue-2017-03-31/CreateSession AWS API Documentation
     #
@@ -4832,6 +4836,66 @@ module Aws::Glue
       req.send_request(options)
     end
 
+    # Creates an Glue usage profile.
+    #
+    # @option params [required, String] :name
+    #   The name of the usage profile.
+    #
+    # @option params [String] :description
+    #   A description of the usage profile.
+    #
+    # @option params [required, Types::ProfileConfiguration] :configuration
+    #   A `ProfileConfiguration` object specifying the job and session values
+    #   for the profile.
+    #
+    # @option params [Hash<String,String>] :tags
+    #   A list of tags applied to the usage profile.
+    #
+    # @return [Types::CreateUsageProfileResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::CreateUsageProfileResponse#name #name} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.create_usage_profile({
+    #     name: "NameString", # required
+    #     description: "DescriptionString",
+    #     configuration: { # required
+    #       session_configuration: {
+    #         "NameString" => {
+    #           default_value: "ConfigValueString",
+    #           allowed_values: ["ConfigValueString"],
+    #           min_value: "ConfigValueString",
+    #           max_value: "ConfigValueString",
+    #         },
+    #       },
+    #       job_configuration: {
+    #         "NameString" => {
+    #           default_value: "ConfigValueString",
+    #           allowed_values: ["ConfigValueString"],
+    #           min_value: "ConfigValueString",
+    #           max_value: "ConfigValueString",
+    #         },
+    #       },
+    #     },
+    #     tags: {
+    #       "TagKey" => "TagValue",
+    #     },
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.name #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/glue-2017-03-31/CreateUsageProfile AWS API Documentation
+    #
+    # @overload create_usage_profile(params = {})
+    # @param [Hash] params ({})
+    def create_usage_profile(params = {}, options = {})
+      req = build_request(:create_usage_profile, params)
+      req.send_request(options)
+    end
+
     # Creates a new function definition in the Data Catalog.
     #
     # @option params [String] :catalog_id
@@ -5738,6 +5802,28 @@ module Aws::Glue
       req.send_request(options)
     end
 
+    # Deletes the Glue specified usage profile.
+    #
+    # @option params [required, String] :name
+    #   The name of the usage profile to delete.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.delete_usage_profile({
+    #     name: "NameString", # required
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/glue-2017-03-31/DeleteUsageProfile AWS API Documentation
+    #
+    # @overload delete_usage_profile(params = {})
+    # @param [Hash] params ({})
+    def delete_usage_profile(params = {}, options = {})
+      req = build_request(:delete_usage_profile, params)
+      req.send_request(options)
+    end
+
     # Deletes an existing function definition from the Data Catalog.
     #
     # @option params [String] :catalog_id
@@ -8301,6 +8387,7 @@ module Aws::Glue
     #   resp.job.source_control_details.auth_strategy #=> String, one of "PERSONAL_ACCESS_TOKEN", "AWS_SECRETS_MANAGER"
     #   resp.job.source_control_details.auth_token #=> String
     #   resp.job.maintenance_window #=> String
+    #   resp.job.profile_name #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/glue-2017-03-31/GetJob AWS API Documentation
     #
@@ -8363,7 +8450,8 @@ module Aws::Glue
       req.send_request(options)
     end
 
-    # Retrieves the metadata for a given job run.
+    # Retrieves the metadata for a given job run. Job run history is
+    # accessible for 90 days for your workflow and job run.
     #
     # @option params [required, String] :job_name
     #   Name of the job definition being run.
@@ -8417,6 +8505,7 @@ module Aws::Glue
     #   resp.job_run.dpu_seconds #=> Float
     #   resp.job_run.execution_class #=> String, one of "FLEX", "STANDARD"
     #   resp.job_run.maintenance_window #=> String
+    #   resp.job_run.profile_name #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/glue-2017-03-31/GetJobRun AWS API Documentation
     #
@@ -8485,6 +8574,7 @@ module Aws::Glue
     #   resp.job_runs[0].dpu_seconds #=> Float
     #   resp.job_runs[0].execution_class #=> String, one of "FLEX", "STANDARD"
     #   resp.job_runs[0].maintenance_window #=> String
+    #   resp.job_runs[0].profile_name #=> String
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/glue-2017-03-31/GetJobRuns AWS API Documentation
@@ -9404,6 +9494,7 @@ module Aws::Glue
     #   resp.jobs[0].source_control_details.auth_strategy #=> String, one of "PERSONAL_ACCESS_TOKEN", "AWS_SECRETS_MANAGER"
     #   resp.jobs[0].source_control_details.auth_token #=> String
     #   resp.jobs[0].maintenance_window #=> String
+    #   resp.jobs[0].profile_name #=> String
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/glue-2017-03-31/GetJobs AWS API Documentation
@@ -10794,6 +10885,7 @@ module Aws::Glue
     #   resp.session.execution_time #=> Float
     #   resp.session.dpu_seconds #=> Float
     #   resp.session.idle_timeout #=> Integer
+    #   resp.session.profile_name #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/glue-2017-03-31/GetSession AWS API Documentation
     #
@@ -12164,6 +12256,53 @@ module Aws::Glue
       req.send_request(options)
     end
 
+    # Retrieves information about the specified Glue usage profile.
+    #
+    # @option params [required, String] :name
+    #   The name of the usage profile to retrieve.
+    #
+    # @return [Types::GetUsageProfileResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetUsageProfileResponse#name #name} => String
+    #   * {Types::GetUsageProfileResponse#description #description} => String
+    #   * {Types::GetUsageProfileResponse#configuration #configuration} => Types::ProfileConfiguration
+    #   * {Types::GetUsageProfileResponse#created_on #created_on} => Time
+    #   * {Types::GetUsageProfileResponse#last_modified_on #last_modified_on} => Time
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_usage_profile({
+    #     name: "NameString", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.name #=> String
+    #   resp.description #=> String
+    #   resp.configuration.session_configuration #=> Hash
+    #   resp.configuration.session_configuration["NameString"].default_value #=> String
+    #   resp.configuration.session_configuration["NameString"].allowed_values #=> Array
+    #   resp.configuration.session_configuration["NameString"].allowed_values[0] #=> String
+    #   resp.configuration.session_configuration["NameString"].min_value #=> String
+    #   resp.configuration.session_configuration["NameString"].max_value #=> String
+    #   resp.configuration.job_configuration #=> Hash
+    #   resp.configuration.job_configuration["NameString"].default_value #=> String
+    #   resp.configuration.job_configuration["NameString"].allowed_values #=> Array
+    #   resp.configuration.job_configuration["NameString"].allowed_values[0] #=> String
+    #   resp.configuration.job_configuration["NameString"].min_value #=> String
+    #   resp.configuration.job_configuration["NameString"].max_value #=> String
+    #   resp.created_on #=> Time
+    #   resp.last_modified_on #=> Time
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/glue-2017-03-31/GetUsageProfile AWS API Documentation
+    #
+    # @overload get_usage_profile(params = {})
+    # @param [Hash] params ({})
+    def get_usage_profile(params = {}, options = {})
+      req = build_request(:get_usage_profile, params)
+      req.send_request(options)
+    end
+
     # Retrieves a specified function definition from the Data Catalog.
     #
     # @option params [String] :catalog_id
@@ -12377,6 +12516,7 @@ module Aws::Glue
     #   resp.workflow.last_run.graph.nodes[0].job_details.job_runs[0].dpu_seconds #=> Float
     #   resp.workflow.last_run.graph.nodes[0].job_details.job_runs[0].execution_class #=> String, one of "FLEX", "STANDARD"
     #   resp.workflow.last_run.graph.nodes[0].job_details.job_runs[0].maintenance_window #=> String
+    #   resp.workflow.last_run.graph.nodes[0].job_details.job_runs[0].profile_name #=> String
     #   resp.workflow.last_run.graph.nodes[0].crawler_details.crawls #=> Array
     #   resp.workflow.last_run.graph.nodes[0].crawler_details.crawls[0].state #=> String, one of "RUNNING", "CANCELLING", "CANCELLED", "SUCCEEDED", "FAILED", "ERROR"
     #   resp.workflow.last_run.graph.nodes[0].crawler_details.crawls[0].started_on #=> Time
@@ -12447,6 +12587,7 @@ module Aws::Glue
     #   resp.workflow.graph.nodes[0].job_details.job_runs[0].dpu_seconds #=> Float
     #   resp.workflow.graph.nodes[0].job_details.job_runs[0].execution_class #=> String, one of "FLEX", "STANDARD"
     #   resp.workflow.graph.nodes[0].job_details.job_runs[0].maintenance_window #=> String
+    #   resp.workflow.graph.nodes[0].job_details.job_runs[0].profile_name #=> String
     #   resp.workflow.graph.nodes[0].crawler_details.crawls #=> Array
     #   resp.workflow.graph.nodes[0].crawler_details.crawls[0].state #=> String, one of "RUNNING", "CANCELLING", "CANCELLED", "SUCCEEDED", "FAILED", "ERROR"
     #   resp.workflow.graph.nodes[0].crawler_details.crawls[0].started_on #=> Time
@@ -12470,7 +12611,8 @@ module Aws::Glue
       req.send_request(options)
     end
 
-    # Retrieves the metadata for a given workflow run.
+    # Retrieves the metadata for a given workflow run. Job run history is
+    # accessible for 90 days for your workflow and job run.
     #
     # @option params [required, String] :name
     #   Name of the workflow being run.
@@ -12570,6 +12712,7 @@ module Aws::Glue
     #   resp.run.graph.nodes[0].job_details.job_runs[0].dpu_seconds #=> Float
     #   resp.run.graph.nodes[0].job_details.job_runs[0].execution_class #=> String, one of "FLEX", "STANDARD"
     #   resp.run.graph.nodes[0].job_details.job_runs[0].maintenance_window #=> String
+    #   resp.run.graph.nodes[0].job_details.job_runs[0].profile_name #=> String
     #   resp.run.graph.nodes[0].crawler_details.crawls #=> Array
     #   resp.run.graph.nodes[0].crawler_details.crawls[0].state #=> String, one of "RUNNING", "CANCELLING", "CANCELLED", "SUCCEEDED", "FAILED", "ERROR"
     #   resp.run.graph.nodes[0].crawler_details.crawls[0].started_on #=> Time
@@ -12733,6 +12876,7 @@ module Aws::Glue
     #   resp.runs[0].graph.nodes[0].job_details.job_runs[0].dpu_seconds #=> Float
     #   resp.runs[0].graph.nodes[0].job_details.job_runs[0].execution_class #=> String, one of "FLEX", "STANDARD"
     #   resp.runs[0].graph.nodes[0].job_details.job_runs[0].maintenance_window #=> String
+    #   resp.runs[0].graph.nodes[0].job_details.job_runs[0].profile_name #=> String
     #   resp.runs[0].graph.nodes[0].crawler_details.crawls #=> Array
     #   resp.runs[0].graph.nodes[0].crawler_details.crawls[0].state #=> String, one of "RUNNING", "CANCELLING", "CANCELLED", "SUCCEEDED", "FAILED", "ERROR"
     #   resp.runs[0].graph.nodes[0].crawler_details.crawls[0].started_on #=> Time
@@ -13696,6 +13840,7 @@ module Aws::Glue
     #   resp.sessions[0].execution_time #=> Float
     #   resp.sessions[0].dpu_seconds #=> Float
     #   resp.sessions[0].idle_timeout #=> Integer
+    #   resp.sessions[0].profile_name #=> String
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/glue-2017-03-31/ListSessions AWS API Documentation
@@ -13882,6 +14027,46 @@ module Aws::Glue
       req.send_request(options)
     end
 
+    # List all the Glue usage profiles.
+    #
+    # @option params [String] :next_token
+    #   A continuation token, included if this is a continuation call.
+    #
+    # @option params [Integer] :max_results
+    #   The maximum number of usage profiles to return in a single response.
+    #
+    # @return [Types::ListUsageProfilesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListUsageProfilesResponse#profiles #profiles} => Array&lt;Types::UsageProfileDefinition&gt;
+    #   * {Types::ListUsageProfilesResponse#next_token #next_token} => String
+    #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_usage_profiles({
+    #     next_token: "OrchestrationToken",
+    #     max_results: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.profiles #=> Array
+    #   resp.profiles[0].name #=> String
+    #   resp.profiles[0].description #=> String
+    #   resp.profiles[0].created_on #=> Time
+    #   resp.profiles[0].last_modified_on #=> Time
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/glue-2017-03-31/ListUsageProfiles AWS API Documentation
+    #
+    # @overload list_usage_profiles(params = {})
+    # @param [Hash] params ({})
+    def list_usage_profiles(params = {}, options = {})
+      req = build_request(:list_usage_profiles, params)
+      req.send_request(options)
+    end
+
     # Lists names of workflows created in the account.
     #
     # @option params [String] :next_token
@@ -17205,6 +17390,60 @@ module Aws::Glue
       req.send_request(options)
     end
 
+    # Update an Glue usage profile.
+    #
+    # @option params [required, String] :name
+    #   The name of the usage profile.
+    #
+    # @option params [String] :description
+    #   A description of the usage profile.
+    #
+    # @option params [required, Types::ProfileConfiguration] :configuration
+    #   A `ProfileConfiguration` object specifying the job and session values
+    #   for the profile.
+    #
+    # @return [Types::UpdateUsageProfileResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::UpdateUsageProfileResponse#name #name} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.update_usage_profile({
+    #     name: "NameString", # required
+    #     description: "DescriptionString",
+    #     configuration: { # required
+    #       session_configuration: {
+    #         "NameString" => {
+    #           default_value: "ConfigValueString",
+    #           allowed_values: ["ConfigValueString"],
+    #           min_value: "ConfigValueString",
+    #           max_value: "ConfigValueString",
+    #         },
+    #       },
+    #       job_configuration: {
+    #         "NameString" => {
+    #           default_value: "ConfigValueString",
+    #           allowed_values: ["ConfigValueString"],
+    #           min_value: "ConfigValueString",
+    #           max_value: "ConfigValueString",
+    #         },
+    #       },
+    #     },
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.name #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/glue-2017-03-31/UpdateUsageProfile AWS API Documentation
+    #
+    # @overload update_usage_profile(params = {})
+    # @param [Hash] params ({})
+    def update_usage_profile(params = {}, options = {})
+      req = build_request(:update_usage_profile, params)
+      req.send_request(options)
+    end
+
     # Updates an existing function definition in the Data Catalog.
     #
     # @option params [String] :catalog_id
@@ -17314,7 +17553,7 @@ module Aws::Glue
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-glue'
-      context[:gem_version] = '1.178.0'
+      context[:gem_version] = '1.179.0'
       Seahorse::Client::Request.new(handlers, context)
     end