aws-sdk-mediaconvert 1.129.0 → 1.130.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 011bd5c6def3f79afb1ee387da535cef1528a5eb2941a8cfa89ffd67a0514537
-  data.tar.gz: 78b3e4af4867bff0cc7cebf14dbdafe18bdc61ef9c0900c69ad66d071b3aa43d
+  metadata.gz: 86c6c279d8d816d532b7eb09686ef13b8017e3e0703b7a8f96533a94c305a905
+  data.tar.gz: 69acbcf9f371177274e08ea6d053b6442b63e28bb3bfec16521179d450b7d129
 SHA512:
-  metadata.gz: 2d60a230ad516496f3aea3e949a86e79a14c846d9afc13fb00b5e23859e4d76c87ac95f726d28edd7a361e6f94d6d5d97b8c92795ad544bd139cfa0d04c48067
-  data.tar.gz: 478835fe90ba2f40da823832c562aed037feb3347e617d4c28eafe00a899a82f19a477b46552655e5915e7f716f83389b61034506b05c6fa10272300ba78b1a6
+  metadata.gz: e3a7b304a36af7336a4bb7c6115e352601170011a3abbf805709146907d9c8f332ff9052277b7289b1a07815293d3f34f25d486697897ca11b475ad9c74e15ab
+  data.tar.gz: 94b5b1a15a69b066c5d8a343cd5e052f6422db0683e87b9a543198e7af04b9c7267075b30e39971d028599a423b45ad6e6d0160b41b79ba8fe32a9719a1d0978

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.130.0 (2024-06-14)
+------------------
+
+* Feature - This release adds the ability to search for historical job records within the management console using a search box and/or via the SDK/CLI with partial string matching search on input file name.
+
 1.129.0 (2024-06-05)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.129.0
+1.130.0

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

@@ -2247,8 +2247,10 @@ module Aws::MediaConvert
       req.send_request(options)
     end
 
-    # Send an request with an empty body to the regional API endpoint to get
-    # your account API endpoint.
+    # Send a request with an empty body to the regional API endpoint to get
+    # your account API endpoint. Note that DescribeEndpoints is no longer
+    # required. We recommend that you send your requests directly to the
+    # regional endpoint instead.
     #
     # @option params [Integer] :max_results
     #   Optional. Max number of endpoints, up to twenty, that will be returned
@@ -4018,6 +4020,63 @@ module Aws::MediaConvert
       req.send_request(options)
     end
 
+    # Retrieve a JSON array that includes job details for up to twenty of
+    # your most recent jobs. Optionally filter results further according to
+    # input file, queue, or status. To retrieve the twenty next most recent
+    # jobs, use the nextToken string returned with the array.
+    #
+    # @option params [String] :input_file
+    #   Optional. Provide your input file URL or your partial input file name.
+    #   The maximum length for an input file is 300 characters.
+    #
+    # @option params [Integer] :max_results
+    #   Optional. Number of jobs, up to twenty, that will be returned at one
+    #   time.
+    #
+    # @option params [String] :next_token
+    #   Optional. Use this string, provided with the response to a previous
+    #   request, to request the next batch of jobs.
+    #
+    # @option params [String] :order
+    #   Optional. When you request lists of resources, you can specify whether
+    #   they are sorted in ASCENDING or DESCENDING order. Default varies by
+    #   resource.
+    #
+    # @option params [String] :queue
+    #   Optional. Provide a queue name, or a queue ARN, to return only jobs
+    #   from that queue.
+    #
+    # @option params [String] :status
+    #   Optional. A job's status can be SUBMITTED, PROGRESSING, COMPLETE,
+    #   CANCELED, or ERROR.
+    #
+    # @return [Types::SearchJobsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::SearchJobsResponse#jobs #jobs} => Array<Types::Job>
+    #   * {Types::SearchJobsResponse#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.search_jobs({
+    #     input_file: "__string",
+    #     max_results: 1,
+    #     next_token: "__string",
+    #     order: "ASCENDING", # accepts ASCENDING, DESCENDING
+    #     queue: "__string",
+    #     status: "SUBMITTED", # accepts SUBMITTED, PROGRESSING, COMPLETE, CANCELED, ERROR
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/mediaconvert-2017-08-29/SearchJobs AWS API Documentation
+    #
+    # @overload search_jobs(params = {})
+    # @param [Hash] params ({})
+    def search_jobs(params = {}, options = {})
+      req = build_request(:search_jobs, params)
+      req.send_request(options)
+    end
+
     # Add tags to a MediaConvert queue, preset, or job template. For
     # information about tagging, see the User Guide at
     # https://docs.aws.amazon.com/mediaconvert/latest/ug/tagging-resources.html
@@ -5675,7 +5734,7 @@ module Aws::MediaConvert
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-mediaconvert'
-      context[:gem_version] = '1.129.0'
+      context[:gem_version] = '1.130.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-mediaconvert/client_api.rb

@@ -571,6 +571,8 @@ module Aws::MediaConvert
     ScalingBehavior = Shapes::StringShape.new(name: 'ScalingBehavior')
     SccDestinationFramerate = Shapes::StringShape.new(name: 'SccDestinationFramerate')
     SccDestinationSettings = Shapes::StructureShape.new(name: 'SccDestinationSettings')
+    SearchJobsRequest = Shapes::StructureShape.new(name: 'SearchJobsRequest')
+    SearchJobsResponse = Shapes::StructureShape.new(name: 'SearchJobsResponse')
     SimulateReservedQueue = Shapes::StringShape.new(name: 'SimulateReservedQueue')
     SpekeKeyProvider = Shapes::StructureShape.new(name: 'SpekeKeyProvider')
     SpekeKeyProviderCmaf = Shapes::StructureShape.new(name: 'SpekeKeyProviderCmaf')
@@ -2400,6 +2402,18 @@ module Aws::MediaConvert
     SccDestinationSettings.add_member(:framerate, Shapes::ShapeRef.new(shape: SccDestinationFramerate, location_name: "framerate"))
     SccDestinationSettings.struct_class = Types::SccDestinationSettings
 
+    SearchJobsRequest.add_member(:input_file, Shapes::ShapeRef.new(shape: __string, location: "querystring", location_name: "inputFile"))
+    SearchJobsRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: __integerMin1Max20, location: "querystring", location_name: "maxResults"))
+    SearchJobsRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: __string, location: "querystring", location_name: "nextToken"))
+    SearchJobsRequest.add_member(:order, Shapes::ShapeRef.new(shape: Order, location: "querystring", location_name: "order"))
+    SearchJobsRequest.add_member(:queue, Shapes::ShapeRef.new(shape: __string, location: "querystring", location_name: "queue"))
+    SearchJobsRequest.add_member(:status, Shapes::ShapeRef.new(shape: JobStatus, location: "querystring", location_name: "status"))
+    SearchJobsRequest.struct_class = Types::SearchJobsRequest
+
+    SearchJobsResponse.add_member(:jobs, Shapes::ShapeRef.new(shape: __listOfJob, location_name: "jobs"))
+    SearchJobsResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: __string, location_name: "nextToken"))
+    SearchJobsResponse.struct_class = Types::SearchJobsResponse
+
     SpekeKeyProvider.add_member(:certificate_arn, Shapes::ShapeRef.new(shape: __stringPatternArnAwsUsGovAcm, location_name: "certificateArn"))
     SpekeKeyProvider.add_member(:resource_id, Shapes::ShapeRef.new(shape: __string, location_name: "resourceId"))
     SpekeKeyProvider.add_member(:system_ids, Shapes::ShapeRef.new(shape: __listOf__stringPattern09aFAF809aFAF409aFAF409aFAF409aFAF12, location_name: "systemIds"))
@@ -3171,6 +3185,26 @@ module Aws::MediaConvert
         o.errors << Shapes::ShapeRef.new(shape: ConflictException)
       end)
 
+      api.add_operation(:search_jobs, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "SearchJobs"
+        o.http_method = "GET"
+        o.http_request_uri = "/2017-08-29/search"
+        o.input = Shapes::ShapeRef.new(shape: SearchJobsRequest)
+        o.output = Shapes::ShapeRef.new(shape: SearchJobsResponse)
+        o.errors << Shapes::ShapeRef.new(shape: BadRequestException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerErrorException)
+        o.errors << Shapes::ShapeRef.new(shape: ForbiddenException)
+        o.errors << Shapes::ShapeRef.new(shape: NotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: TooManyRequestsException)
+        o.errors << Shapes::ShapeRef.new(shape: ConflictException)
+        o[:pager] = Aws::Pager.new(
+          limit_key: "max_results",
+          tokens: {
+            "next_token" => "next_token"
+          }
+        )
+      end)
+
       api.add_operation(:tag_resource, Seahorse::Model::Operation.new.tap do |o|
         o.name = "TagResource"
         o.http_method = "POST"

data/lib/aws-sdk-mediaconvert/endpoints.rb

@@ -334,6 +334,20 @@ module Aws::MediaConvert
       end
     end
 
+    class SearchJobs
+      def self.build(context)
+        unless context.config.regional_endpoint
+          endpoint = context.config.endpoint.to_s
+        end
+        Aws::MediaConvert::EndpointParameters.new(
+          region: context.config.region,
+          use_dual_stack: context.config.use_dualstack_endpoint,
+          use_fips: context.config.use_fips_endpoint,
+          endpoint: endpoint,
+        )
+      end
+    end
+
     class TagResource
       def self.build(context)
         unless context.config.regional_endpoint

data/lib/aws-sdk-mediaconvert/plugins/endpoints.rb

@@ -104,6 +104,8 @@ module Aws::MediaConvert
             Aws::MediaConvert::Endpoints::ListTagsForResource.build(context)
           when :put_policy
             Aws::MediaConvert::Endpoints::PutPolicy.build(context)
+          when :search_jobs
+            Aws::MediaConvert::Endpoints::SearchJobs.build(context)
           when :tag_resource
             Aws::MediaConvert::Endpoints::TagResource.build(context)
           when :untag_resource

data/lib/aws-sdk-mediaconvert/types.rb

@@ -3697,8 +3697,10 @@ module Aws::MediaConvert
     #
     class DeleteQueueResponse < Aws::EmptyStructure; end
 
-    # Send an request with an empty body to the regional API endpoint to get
-    # your account API endpoint.
+    # Send a request with an empty body to the regional API endpoint to get
+    # your account API endpoint. Note that DescribeEndpoints is no longer
+    # required. We recommend that you send your requests directly to the
+    # regional endpoint instead.
     #
     # @!attribute [rw] max_results
     #   Optional. Max number of endpoints, up to twenty, that will be
@@ -11648,6 +11650,76 @@ module Aws::MediaConvert
       include Aws::Structure
     end
 
+    # Retrieve a JSON array that includes job details for up to twenty of
+    # your most recent jobs. Optionally filter results further according to
+    # input file, queue, or status. To retrieve the twenty next most recent
+    # jobs, use the nextToken string returned with the array.
+    #
+    # @!attribute [rw] input_file
+    #   Optional. Provide your input file URL or your partial input file
+    #   name. The maximum length for an input file is 300 characters.
+    #   @return [String]
+    #
+    # @!attribute [rw] max_results
+    #   Optional. Number of jobs, up to twenty, that will be returned at one
+    #   time.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] next_token
+    #   Optional. Use this string, provided with the response to a previous
+    #   request, to request the next batch of jobs.
+    #   @return [String]
+    #
+    # @!attribute [rw] order
+    #   Optional. When you request lists of resources, you can specify
+    #   whether they are sorted in ASCENDING or DESCENDING order. Default
+    #   varies by resource.
+    #   @return [String]
+    #
+    # @!attribute [rw] queue
+    #   Optional. Provide a queue name, or a queue ARN, to return only jobs
+    #   from that queue.
+    #   @return [String]
+    #
+    # @!attribute [rw] status
+    #   Optional. A job's status can be SUBMITTED, PROGRESSING, COMPLETE,
+    #   CANCELED, or ERROR.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/mediaconvert-2017-08-29/SearchJobsRequest AWS API Documentation
+    #
+    class SearchJobsRequest < Struct.new(
+      :input_file,
+      :max_results,
+      :next_token,
+      :order,
+      :queue,
+      :status)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Successful search jobs requests return a JSON array of jobs. If you
+    # don't specify how they are ordered, you will receive the most
+    # recently created first.
+    #
+    # @!attribute [rw] jobs
+    #   List of jobs.
+    #   @return [Array<Types::Job>]
+    #
+    # @!attribute [rw] next_token
+    #   Use this string to request the next batch of jobs.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/mediaconvert-2017-08-29/SearchJobsResponse AWS API Documentation
+    #
+    class SearchJobsResponse < Struct.new(
+      :jobs,
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # If your output group type is HLS, DASH, or Microsoft Smooth, use these
     # settings when doing DRM encryption with a SPEKE-compliant key
     # provider. If your output group type is CMAF, use the

data/lib/aws-sdk-mediaconvert.rb

@@ -52,6 +52,6 @@ require_relative 'aws-sdk-mediaconvert/customizations'
 # @!group service
 module Aws::MediaConvert
 
-  GEM_VERSION = '1.129.0'
+  GEM_VERSION = '1.130.0'
 
 end

data/sig/client.rbs

@@ -3926,6 +3926,22 @@ module Aws
                       ) -> _PutPolicyResponseSuccess
                     | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _PutPolicyResponseSuccess
 
+      interface _SearchJobsResponseSuccess
+        include ::Seahorse::Client::_ResponseSuccess[Types::SearchJobsResponse]
+        def jobs: () -> ::Array[Types::Job]
+        def next_token: () -> ::String
+      end
+      # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/MediaConvert/Client.html#search_jobs-instance_method
+      def search_jobs: (
+                         ?input_file: ::String,
+                         ?max_results: ::Integer,
+                         ?next_token: ::String,
+                         ?order: ("ASCENDING" | "DESCENDING"),
+                         ?queue: ::String,
+                         ?status: ("SUBMITTED" | "PROGRESSING" | "COMPLETE" | "CANCELED" | "ERROR")
+                       ) -> _SearchJobsResponseSuccess
+                     | (?Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _SearchJobsResponseSuccess
+
       interface _TagResourceResponseSuccess
         include ::Seahorse::Client::_ResponseSuccess[Types::TagResourceResponse]
       end

data/sig/types.rbs

@@ -1904,6 +1904,22 @@ module Aws::MediaConvert
       SENSITIVE: []
     end
 
+    class SearchJobsRequest
+      attr_accessor input_file: ::String
+      attr_accessor max_results: ::Integer
+      attr_accessor next_token: ::String
+      attr_accessor order: ("ASCENDING" | "DESCENDING")
+      attr_accessor queue: ::String
+      attr_accessor status: ("SUBMITTED" | "PROGRESSING" | "COMPLETE" | "CANCELED" | "ERROR")
+      SENSITIVE: []
+    end
+
+    class SearchJobsResponse
+      attr_accessor jobs: ::Array[Types::Job]
+      attr_accessor next_token: ::String
+      SENSITIVE: []
+    end
+
     class SpekeKeyProvider
       attr_accessor certificate_arn: ::String
       attr_accessor resource_id: ::String

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-mediaconvert
 version: !ruby/object:Gem::Version
-  version: 1.129.0
+  version: 1.130.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-06-05 00:00:00.000000000 Z
+date: 2024-06-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core