aws-sdk-glue 1.93.0 → 1.94.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b19dff0cbd8219274788ddd57a4a5c2ef7c571e068b12d88dcb0004ed472294f
-  data.tar.gz: 4cc7e65fc4d1ffcacf0eec6ed9cb13f154de5d56e832d07246dba8f19a5d089c
+  metadata.gz: c7738455b01f04a98f675f45b8a8f409e319435132ec0c4687f3f4ec74c35ab1
+  data.tar.gz: 38b6555226ad227c12c40c4ba2293e47919250801976f20176c1357547252ace
 SHA512:
-  metadata.gz: 799d54fc879768e2f88c335e7726f7ab073daca5c0f246ae53dfab250590ae11d6d2bb967aef0b7092b677c6f2899822fabcc4cf66c72741eb3d173236582bd6
-  data.tar.gz: 5334a81610f4040dd27724513cb8bac009df0726bb7b146577a5153429fa16be2553f6219127f9277182258690e06b7002d3932bce38576bf530004205263545
+  metadata.gz: 4d774fa7c27759f66cc95ebc7dd21658f5021ffb3c5d8042941e6b253df845630339a4e2747256f88c6a6b2fd7fe9443855143bc9c74ad368a9063dd66d48bb7
+  data.tar.gz: f31870b2ddab21f594e6b75f7f87264f5ce07a36c8c86c431ebf090c1c77072e21875a8bb31dbf34735e09ebbe630668c0b7789b6a1c2f98c8de2d58940e57cf

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.94.0 (2021-08-23)
+------------------
+
+* Feature - Add support for Custom Blueprints
+
 1.93.0 (2021-08-03)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.93.0
+1.94.0

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

@@ -637,6 +637,60 @@ module Aws::Glue
       req.send_request(options)
     end
 
+    # Retrieves information about a list of blueprints.
+    #
+    # @option params [required, Array<String>] :names
+    #   A list of blueprint names.
+    #
+    # @option params [Boolean] :include_blueprint
+    #   Specifies whether or not to include the blueprint in the response.
+    #
+    # @option params [Boolean] :include_parameter_spec
+    #   Specifies whether or not to include the parameters, as a JSON string,
+    #   for the blueprint in the response.
+    #
+    # @return [Types::BatchGetBlueprintsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::BatchGetBlueprintsResponse#blueprints #blueprints} => Array&lt;Types::Blueprint&gt;
+    #   * {Types::BatchGetBlueprintsResponse#missing_blueprints #missing_blueprints} => Array&lt;String&gt;
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.batch_get_blueprints({
+    #     names: ["OrchestrationNameString"], # required
+    #     include_blueprint: false,
+    #     include_parameter_spec: false,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.blueprints #=> Array
+    #   resp.blueprints[0].name #=> String
+    #   resp.blueprints[0].description #=> String
+    #   resp.blueprints[0].created_on #=> Time
+    #   resp.blueprints[0].last_modified_on #=> Time
+    #   resp.blueprints[0].parameter_spec #=> String
+    #   resp.blueprints[0].blueprint_location #=> String
+    #   resp.blueprints[0].blueprint_service_location #=> String
+    #   resp.blueprints[0].status #=> String, one of "CREATING", "ACTIVE", "UPDATING", "FAILED"
+    #   resp.blueprints[0].error_message #=> String
+    #   resp.blueprints[0].last_active_definition.description #=> String
+    #   resp.blueprints[0].last_active_definition.last_modified_on #=> Time
+    #   resp.blueprints[0].last_active_definition.parameter_spec #=> String
+    #   resp.blueprints[0].last_active_definition.blueprint_location #=> String
+    #   resp.blueprints[0].last_active_definition.blueprint_service_location #=> String
+    #   resp.missing_blueprints #=> Array
+    #   resp.missing_blueprints[0] #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/glue-2017-03-31/BatchGetBlueprints AWS API Documentation
+    #
+    # @overload batch_get_blueprints(params = {})
+    # @param [Hash] params ({})
+    def batch_get_blueprints(params = {}, options = {})
+      req = build_request(:batch_get_blueprints, params)
+      req.send_request(options)
+    end
+
     # Returns a list of resource metadata for a given list of crawler names.
     # After calling the `ListCrawlers` operation, you can call this
     # operation to access the data to which you have been granted
@@ -1182,6 +1236,8 @@ module Aws::Glue
     #   resp.workflows[0].graph.edges[0].source_id #=> String
     #   resp.workflows[0].graph.edges[0].destination_id #=> String
     #   resp.workflows[0].max_concurrent_runs #=> Integer
+    #   resp.workflows[0].blueprint_details.blueprint_name #=> String
+    #   resp.workflows[0].blueprint_details.run_id #=> String
     #   resp.missing_workflows #=> Array
     #   resp.missing_workflows[0] #=> String
     #
@@ -1424,6 +1480,48 @@ module Aws::Glue
       req.send_request(options)
     end
 
+    # Registers a blueprint with Glue.
+    #
+    # @option params [required, String] :name
+    #   The name of the blueprint.
+    #
+    # @option params [String] :description
+    #   A description of the blueprint.
+    #
+    # @option params [required, String] :blueprint_location
+    #   Specifies a path in Amazon S3 where the blueprint is published.
+    #
+    # @option params [Hash<String,String>] :tags
+    #   The tags to be applied to this blueprint.
+    #
+    # @return [Types::CreateBlueprintResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::CreateBlueprintResponse#name #name} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.create_blueprint({
+    #     name: "OrchestrationNameString", # required
+    #     description: "Generic512CharString",
+    #     blueprint_location: "OrchestrationS3Location", # required
+    #     tags: {
+    #       "TagKey" => "TagValue",
+    #     },
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.name #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/glue-2017-03-31/CreateBlueprint AWS API Documentation
+    #
+    # @overload create_blueprint(params = {})
+    # @param [Hash] params ({})
+    def create_blueprint(params = {}, options = {})
+      req = build_request(:create_blueprint, params)
+      req.send_request(options)
+    end
+
     # Creates a classifier in the user's account. This can be a
     # `GrokClassifier`, an `XMLClassifier`, a `JsonClassifier`, or a
     # `CsvClassifier`, depending on which field of the request is present.
@@ -3109,6 +3207,34 @@ module Aws::Glue
       req.send_request(options)
     end
 
+    # Deletes an existing blueprint.
+    #
+    # @option params [required, String] :name
+    #   The name of the blueprint to delete.
+    #
+    # @return [Types::DeleteBlueprintResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DeleteBlueprintResponse#name #name} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.delete_blueprint({
+    #     name: "NameString", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.name #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/glue-2017-03-31/DeleteBlueprint AWS API Documentation
+    #
+    # @overload delete_blueprint(params = {})
+    # @param [Hash] params ({})
+    def delete_blueprint(params = {}, options = {})
+      req = build_request(:delete_blueprint, params)
+      req.send_request(options)
+    end
+
     # Removes a classifier from the Data Catalog.
     #
     # @option params [required, String] :name
@@ -3829,6 +3955,146 @@ module Aws::Glue
       req.send_request(options)
     end
 
+    # Retrieves the details of a blueprint.
+    #
+    # @option params [required, String] :name
+    #   The name of the blueprint.
+    #
+    # @option params [Boolean] :include_blueprint
+    #   Specifies whether or not to include the blueprint in the response.
+    #
+    # @option params [Boolean] :include_parameter_spec
+    #   Specifies whether or not to include the parameter specification.
+    #
+    # @return [Types::GetBlueprintResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetBlueprintResponse#blueprint #blueprint} => Types::Blueprint
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_blueprint({
+    #     name: "NameString", # required
+    #     include_blueprint: false,
+    #     include_parameter_spec: false,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.blueprint.name #=> String
+    #   resp.blueprint.description #=> String
+    #   resp.blueprint.created_on #=> Time
+    #   resp.blueprint.last_modified_on #=> Time
+    #   resp.blueprint.parameter_spec #=> String
+    #   resp.blueprint.blueprint_location #=> String
+    #   resp.blueprint.blueprint_service_location #=> String
+    #   resp.blueprint.status #=> String, one of "CREATING", "ACTIVE", "UPDATING", "FAILED"
+    #   resp.blueprint.error_message #=> String
+    #   resp.blueprint.last_active_definition.description #=> String
+    #   resp.blueprint.last_active_definition.last_modified_on #=> Time
+    #   resp.blueprint.last_active_definition.parameter_spec #=> String
+    #   resp.blueprint.last_active_definition.blueprint_location #=> String
+    #   resp.blueprint.last_active_definition.blueprint_service_location #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/glue-2017-03-31/GetBlueprint AWS API Documentation
+    #
+    # @overload get_blueprint(params = {})
+    # @param [Hash] params ({})
+    def get_blueprint(params = {}, options = {})
+      req = build_request(:get_blueprint, params)
+      req.send_request(options)
+    end
+
+    # Retrieves the details of a blueprint run.
+    #
+    # @option params [required, String] :blueprint_name
+    #   The name of the blueprint.
+    #
+    # @option params [required, String] :run_id
+    #   The run ID for the blueprint run you want to retrieve.
+    #
+    # @return [Types::GetBlueprintRunResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetBlueprintRunResponse#blueprint_run #blueprint_run} => Types::BlueprintRun
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_blueprint_run({
+    #     blueprint_name: "OrchestrationNameString", # required
+    #     run_id: "IdString", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.blueprint_run.blueprint_name #=> String
+    #   resp.blueprint_run.run_id #=> String
+    #   resp.blueprint_run.workflow_name #=> String
+    #   resp.blueprint_run.state #=> String, one of "RUNNING", "SUCCEEDED", "FAILED", "ROLLING_BACK"
+    #   resp.blueprint_run.started_on #=> Time
+    #   resp.blueprint_run.completed_on #=> Time
+    #   resp.blueprint_run.error_message #=> String
+    #   resp.blueprint_run.rollback_error_message #=> String
+    #   resp.blueprint_run.parameters #=> String
+    #   resp.blueprint_run.role_arn #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/glue-2017-03-31/GetBlueprintRun AWS API Documentation
+    #
+    # @overload get_blueprint_run(params = {})
+    # @param [Hash] params ({})
+    def get_blueprint_run(params = {}, options = {})
+      req = build_request(:get_blueprint_run, params)
+      req.send_request(options)
+    end
+
+    # Retrieves the details of blueprint runs for a specified blueprint.
+    #
+    # @option params [required, String] :blueprint_name
+    #   The name of the blueprint.
+    #
+    # @option params [String] :next_token
+    #   A continuation token, if this is a continuation request.
+    #
+    # @option params [Integer] :max_results
+    #   The maximum size of a list to return.
+    #
+    # @return [Types::GetBlueprintRunsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetBlueprintRunsResponse#blueprint_runs #blueprint_runs} => Array&lt;Types::BlueprintRun&gt;
+    #   * {Types::GetBlueprintRunsResponse#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.get_blueprint_runs({
+    #     blueprint_name: "NameString", # required
+    #     next_token: "GenericString",
+    #     max_results: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.blueprint_runs #=> Array
+    #   resp.blueprint_runs[0].blueprint_name #=> String
+    #   resp.blueprint_runs[0].run_id #=> String
+    #   resp.blueprint_runs[0].workflow_name #=> String
+    #   resp.blueprint_runs[0].state #=> String, one of "RUNNING", "SUCCEEDED", "FAILED", "ROLLING_BACK"
+    #   resp.blueprint_runs[0].started_on #=> Time
+    #   resp.blueprint_runs[0].completed_on #=> Time
+    #   resp.blueprint_runs[0].error_message #=> String
+    #   resp.blueprint_runs[0].rollback_error_message #=> String
+    #   resp.blueprint_runs[0].parameters #=> String
+    #   resp.blueprint_runs[0].role_arn #=> String
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/glue-2017-03-31/GetBlueprintRuns AWS API Documentation
+    #
+    # @overload get_blueprint_runs(params = {})
+    # @param [Hash] params ({})
+    def get_blueprint_runs(params = {}, options = {})
+      req = build_request(:get_blueprint_runs, params)
+      req.send_request(options)
+    end
+
     # Retrieves the status of a migration operation.
     #
     # @option params [String] :catalog_id
@@ -7250,6 +7516,8 @@ module Aws::Glue
     #   resp.workflow.graph.edges[0].source_id #=> String
     #   resp.workflow.graph.edges[0].destination_id #=> String
     #   resp.workflow.max_concurrent_runs #=> Integer
+    #   resp.workflow.blueprint_details.blueprint_name #=> String
+    #   resp.workflow.blueprint_details.run_id #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/glue-2017-03-31/GetWorkflow AWS API Documentation
     #
@@ -7557,6 +7825,49 @@ module Aws::Glue
       req.send_request(options)
     end
 
+    # Lists all the blueprint names in an account.
+    #
+    # @option params [String] :next_token
+    #   A continuation token, if this is a continuation request.
+    #
+    # @option params [Integer] :max_results
+    #   The maximum size of a list to return.
+    #
+    # @option params [Hash<String,String>] :tags
+    #   Filters the list by an Amazon Web Services resource tag.
+    #
+    # @return [Types::ListBlueprintsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListBlueprintsResponse#blueprints #blueprints} => Array&lt;String&gt;
+    #   * {Types::ListBlueprintsResponse#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_blueprints({
+    #     next_token: "GenericString",
+    #     max_results: 1,
+    #     tags: {
+    #       "TagKey" => "TagValue",
+    #     },
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.blueprints #=> Array
+    #   resp.blueprints[0] #=> String
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/glue-2017-03-31/ListBlueprints AWS API Documentation
+    #
+    # @overload list_blueprints(params = {})
+    # @param [Hash] params ({})
+    def list_blueprints(params = {}, options = {})
+      req = build_request(:list_blueprints, params)
+      req.send_request(options)
+    end
+
     # Retrieves the names of all crawler resources in this Amazon Web
     # Services account, or the resources with the specified tag. This
     # operation allows you to see which resources are available in your
@@ -8686,6 +8997,42 @@ module Aws::Glue
       req.send_request(options)
     end
 
+    # Starts a new run of the specified blueprint.
+    #
+    # @option params [required, String] :blueprint_name
+    #   The name of the blueprint.
+    #
+    # @option params [String] :parameters
+    #   Specifies the parameters as a `BlueprintParameters` object.
+    #
+    # @option params [required, String] :role_arn
+    #   Specifies the IAM role used to create the workflow.
+    #
+    # @return [Types::StartBlueprintRunResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::StartBlueprintRunResponse#run_id #run_id} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.start_blueprint_run({
+    #     blueprint_name: "OrchestrationNameString", # required
+    #     parameters: "BlueprintParameters",
+    #     role_arn: "OrchestrationIAMRoleArn", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.run_id #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/glue-2017-03-31/StartBlueprintRun AWS API Documentation
+    #
+    # @overload start_blueprint_run(params = {})
+    # @param [Hash] params ({})
+    def start_blueprint_run(params = {}, options = {})
+      req = build_request(:start_blueprint_run, params)
+      req.send_request(options)
+    end
+
     # Starts a crawl using the specified crawler, regardless of what is
     # scheduled. If the crawler is already running, returns a
     # [CrawlerRunningException][1].
@@ -9291,6 +9638,42 @@ module Aws::Glue
       req.send_request(options)
     end
 
+    # Updates a registered blueprint.
+    #
+    # @option params [required, String] :name
+    #   The name of the blueprint.
+    #
+    # @option params [String] :description
+    #   A description of the blueprint.
+    #
+    # @option params [required, String] :blueprint_location
+    #   Specifies a path in Amazon S3 where the blueprint is published.
+    #
+    # @return [Types::UpdateBlueprintResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::UpdateBlueprintResponse#name #name} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.update_blueprint({
+    #     name: "OrchestrationNameString", # required
+    #     description: "Generic512CharString",
+    #     blueprint_location: "OrchestrationS3Location", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.name #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/glue-2017-03-31/UpdateBlueprint AWS API Documentation
+    #
+    # @overload update_blueprint(params = {})
+    # @param [Hash] params ({})
+    def update_blueprint(params = {}, options = {})
+      req = build_request(:update_blueprint, params)
+      req.send_request(options)
+    end
+
     # Modifies an existing classifier (a `GrokClassifier`, an
     # `XMLClassifier`, a `JsonClassifier`, or a `CsvClassifier`, depending
     # on which field is present).
@@ -10665,7 +11048,7 @@ module Aws::Glue
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-glue'
-      context[:gem_version] = '1.93.0'
+      context[:gem_version] = '1.94.0'
       Seahorse::Client::Request.new(handlers, context)
     end