aws-sdk-ec2 1.443.0 → 1.444.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 984ec6937889a106c81b27b988385abfc900a395cee92376a56a0d15f922214f
-  data.tar.gz: c037f163548ede1fec6a55da26290d364b37250ed8708ff433c5bf58c1e197c9
+  metadata.gz: 841e89e019070b27212d99b17d625185c9ee861576e914bdfa86e718edc6af71
+  data.tar.gz: cddf12db85a8c9e03f544eef7195004b8b229c4dd54c3c500b2b1f0bd41a87b7
 SHA512:
-  metadata.gz: 0b64aecbd53e8a3994980a44cd1af70ee06cbf39b9d293c0e89050c56d1e21cae52a8b7663ac991463f9c4092e2378c159b5919886deca3a7936ba147904a462
-  data.tar.gz: 1fd963e996681b13f92572c93f850bf03a4ebc5ebded7c6c693bfd03cefda47663efbf2f6a427cf0bdbfe31b4e481e5a94ed3b1e78ed0e397781902c9392f6c4
+  metadata.gz: 07bd9a41706f0b593751c716f68a9acf39b3d8afa458e53f8bb253352ad8efe4105e1e75cf5cf748f8bb76b4d1b792f92e708ffb23e99c5b00412594616fb9b5
+  data.tar.gz: c92c3c61aff7e187aada0c6a6cf78e8fe518f5035f603daeaa62a34ebff379be849c1c217117ba77e2f40adb1290ee3085c4289c8a9c9ee9f3ff741e4e43f998

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.444.0 (2024-03-19)
+------------------
+
+* Feature - This release adds the new DescribeMacHosts API operation for getting information about EC2 Mac Dedicated Hosts. Users can now see the latest macOS versions that their underlying Apple Mac can support without needing to be updated.
+
 1.443.0 (2024-03-15)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.443.0
+1.444.0

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

@@ -27776,6 +27776,69 @@ module Aws::EC2
       req.send_request(options)
     end
 
+    # Describes the specified EC2 Mac Dedicated Host or all of your EC2 Mac
+    # Dedicated Hosts.
+    #
+    # @option params [Array<Types::Filter>] :filters
+    #   The filters.
+    #
+    #   * `availability-zone` - The Availability Zone of the EC2 Mac Dedicated
+    #     Host.
+    #
+    #   * `instance-type` - The instance type size that the EC2 Mac Dedicated
+    #     Host is configured to support.
+    #
+    # @option params [Array<String>] :host_ids
+    #   The IDs of the EC2 Mac Dedicated Hosts.
+    #
+    # @option params [Integer] :max_results
+    #   The maximum number of results to return for the request in a single
+    #   page. The remaining results can be seen by sending another request
+    #   with the returned `nextToken` value. This value can be between 5 and
+    #   500. If `maxResults` is given a larger value than 500, you receive an
+    #   error.
+    #
+    # @option params [String] :next_token
+    #   The token to use to retrieve the next page of results.
+    #
+    # @return [Types::DescribeMacHostsResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DescribeMacHostsResult#mac_hosts #mac_hosts} => Array&lt;Types::MacHost&gt;
+    #   * {Types::DescribeMacHostsResult#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.describe_mac_hosts({
+    #     filters: [
+    #       {
+    #         name: "String",
+    #         values: ["String"],
+    #       },
+    #     ],
+    #     host_ids: ["DedicatedHostId"],
+    #     max_results: 1,
+    #     next_token: "String",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.mac_hosts #=> Array
+    #   resp.mac_hosts[0].host_id #=> String
+    #   resp.mac_hosts[0].mac_os_latest_supported_versions #=> Array
+    #   resp.mac_hosts[0].mac_os_latest_supported_versions[0] #=> String
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/DescribeMacHosts AWS API Documentation
+    #
+    # @overload describe_mac_hosts(params = {})
+    # @param [Hash] params ({})
+    def describe_mac_hosts(params = {}, options = {})
+      req = build_request(:describe_mac_hosts, params)
+      req.send_request(options)
+    end
+
     # Describes your managed prefix lists and any Amazon Web
     # Services-managed prefix lists.
     #
@@ -58918,7 +58981,7 @@ module Aws::EC2
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-ec2'
-      context[:gem_version] = '1.443.0'
+      context[:gem_version] = '1.444.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -938,6 +938,9 @@ module Aws::EC2
     DescribeLockedSnapshotsMaxResults = Shapes::IntegerShape.new(name: 'DescribeLockedSnapshotsMaxResults')
     DescribeLockedSnapshotsRequest = Shapes::StructureShape.new(name: 'DescribeLockedSnapshotsRequest')
     DescribeLockedSnapshotsResult = Shapes::StructureShape.new(name: 'DescribeLockedSnapshotsResult')
+    DescribeMacHostsRequest = Shapes::StructureShape.new(name: 'DescribeMacHostsRequest')
+    DescribeMacHostsRequestMaxResults = Shapes::IntegerShape.new(name: 'DescribeMacHostsRequestMaxResults')
+    DescribeMacHostsResult = Shapes::StructureShape.new(name: 'DescribeMacHostsResult')
     DescribeManagedPrefixListsRequest = Shapes::StructureShape.new(name: 'DescribeManagedPrefixListsRequest')
     DescribeManagedPrefixListsResult = Shapes::StructureShape.new(name: 'DescribeManagedPrefixListsResult')
     DescribeMovingAddressesMaxResults = Shapes::IntegerShape.new(name: 'DescribeMovingAddressesMaxResults')
@@ -2026,6 +2029,9 @@ module Aws::EC2
     LockedSnapshotsInfoList = Shapes::ListShape.new(name: 'LockedSnapshotsInfoList')
     LogDestinationType = Shapes::StringShape.new(name: 'LogDestinationType')
     Long = Shapes::IntegerShape.new(name: 'Long')
+    MacHost = Shapes::StructureShape.new(name: 'MacHost')
+    MacHostList = Shapes::ListShape.new(name: 'MacHostList')
+    MacOSVersionStringList = Shapes::ListShape.new(name: 'MacOSVersionStringList')
     MaintenanceDetails = Shapes::StructureShape.new(name: 'MaintenanceDetails')
     ManagedPrefixList = Shapes::StructureShape.new(name: 'ManagedPrefixList')
     ManagedPrefixListSet = Shapes::ListShape.new(name: 'ManagedPrefixListSet')
@@ -6990,6 +6996,16 @@ module Aws::EC2
     DescribeLockedSnapshotsResult.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "nextToken"))
     DescribeLockedSnapshotsResult.struct_class = Types::DescribeLockedSnapshotsResult
 
+    DescribeMacHostsRequest.add_member(:filters, Shapes::ShapeRef.new(shape: FilterList, location_name: "Filter"))
+    DescribeMacHostsRequest.add_member(:host_ids, Shapes::ShapeRef.new(shape: RequestHostIdList, location_name: "HostId"))
+    DescribeMacHostsRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: DescribeMacHostsRequestMaxResults, location_name: "MaxResults"))
+    DescribeMacHostsRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "NextToken"))
+    DescribeMacHostsRequest.struct_class = Types::DescribeMacHostsRequest
+
+    DescribeMacHostsResult.add_member(:mac_hosts, Shapes::ShapeRef.new(shape: MacHostList, location_name: "macHostSet"))
+    DescribeMacHostsResult.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "nextToken"))
+    DescribeMacHostsResult.struct_class = Types::DescribeMacHostsResult
+
     DescribeManagedPrefixListsRequest.add_member(:dry_run, Shapes::ShapeRef.new(shape: Boolean, location_name: "DryRun"))
     DescribeManagedPrefixListsRequest.add_member(:filters, Shapes::ShapeRef.new(shape: FilterList, location_name: "Filter"))
     DescribeManagedPrefixListsRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: PrefixListMaxResults, location_name: "MaxResults"))
@@ -11203,6 +11219,14 @@ module Aws::EC2
 
     LockedSnapshotsInfoList.member = Shapes::ShapeRef.new(shape: LockedSnapshotsInfo, location_name: "item")
 
+    MacHost.add_member(:host_id, Shapes::ShapeRef.new(shape: DedicatedHostId, location_name: "hostId"))
+    MacHost.add_member(:mac_os_latest_supported_versions, Shapes::ShapeRef.new(shape: MacOSVersionStringList, location_name: "macOSLatestSupportedVersionSet"))
+    MacHost.struct_class = Types::MacHost
+
+    MacHostList.member = Shapes::ShapeRef.new(shape: MacHost, location_name: "item")
+
+    MacOSVersionStringList.member = Shapes::ShapeRef.new(shape: String, location_name: "item")
+
     MaintenanceDetails.add_member(:pending_maintenance, Shapes::ShapeRef.new(shape: String, location_name: "pendingMaintenance"))
     MaintenanceDetails.add_member(:maintenance_auto_applied_after, Shapes::ShapeRef.new(shape: MillisecondDateTime, location_name: "maintenanceAutoAppliedAfter"))
     MaintenanceDetails.add_member(:last_maintenance_applied, Shapes::ShapeRef.new(shape: MillisecondDateTime, location_name: "lastMaintenanceApplied"))
@@ -18278,6 +18302,20 @@ module Aws::EC2
         o.output = Shapes::ShapeRef.new(shape: DescribeLockedSnapshotsResult)
       end)
 
+      api.add_operation(:describe_mac_hosts, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "DescribeMacHosts"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: DescribeMacHostsRequest)
+        o.output = Shapes::ShapeRef.new(shape: DescribeMacHostsResult)
+        o[:pager] = Aws::Pager.new(
+          limit_key: "max_results",
+          tokens: {
+            "next_token" => "next_token"
+          }
+        )
+      end)
+
       api.add_operation(:describe_managed_prefix_lists, Seahorse::Model::Operation.new.tap do |o|
         o.name = "DescribeManagedPrefixLists"
         o.http_method = "POST"

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

@@ -4100,6 +4100,20 @@ module Aws::EC2
       end
     end
 
+    class DescribeMacHosts
+      def self.build(context)
+        unless context.config.regional_endpoint
+          endpoint = context.config.endpoint.to_s
+        end
+        Aws::EC2::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 DescribeManagedPrefixLists
       def self.build(context)
         unless context.config.regional_endpoint

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

@@ -642,6 +642,8 @@ module Aws::EC2
             Aws::EC2::Endpoints::DescribeLocalGateways.build(context)
           when :describe_locked_snapshots
             Aws::EC2::Endpoints::DescribeLockedSnapshots.build(context)
+          when :describe_mac_hosts
+            Aws::EC2::Endpoints::DescribeMacHosts.build(context)
           when :describe_managed_prefix_lists
             Aws::EC2::Endpoints::DescribeManagedPrefixLists.build(context)
           when :describe_moving_addresses

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

@@ -22086,6 +22086,60 @@ module Aws::EC2
       include Aws::Structure
     end
 
+    # @!attribute [rw] filters
+    #   The filters.
+    #
+    #   * `availability-zone` - The Availability Zone of the EC2 Mac
+    #     Dedicated Host.
+    #
+    #   * `instance-type` - The instance type size that the EC2 Mac
+    #     Dedicated Host is configured to support.
+    #   @return [Array<Types::Filter>]
+    #
+    # @!attribute [rw] host_ids
+    #   The IDs of the EC2 Mac Dedicated Hosts.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] max_results
+    #   The maximum number of results to return for the request in a single
+    #   page. The remaining results can be seen by sending another request
+    #   with the returned `nextToken` value. This value can be between 5 and
+    #   500. If `maxResults` is given a larger value than 500, you receive
+    #   an error.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] next_token
+    #   The token to use to retrieve the next page of results.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/DescribeMacHostsRequest AWS API Documentation
+    #
+    class DescribeMacHostsRequest < Struct.new(
+      :filters,
+      :host_ids,
+      :max_results,
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] mac_hosts
+    #   Information about the EC2 Mac Dedicated Hosts.
+    #   @return [Array<Types::MacHost>]
+    #
+    # @!attribute [rw] next_token
+    #   The token to use to retrieve the next page of results.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/DescribeMacHostsResult AWS API Documentation
+    #
+    class DescribeMacHostsResult < Struct.new(
+      :mac_hosts,
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] dry_run
     #   Checks whether you have the required permissions for the action,
     #   without actually making the request, and provides an error response.
@@ -46203,6 +46257,26 @@ module Aws::EC2
       include Aws::Structure
     end
 
+    # Information about the EC2 Mac Dedicated Host.
+    #
+    # @!attribute [rw] host_id
+    #   The EC2 Mac Dedicated Host ID.
+    #   @return [String]
+    #
+    # @!attribute [rw] mac_os_latest_supported_versions
+    #   The latest macOS versions that the EC2 Mac Dedicated Host can launch
+    #   without being upgraded.
+    #   @return [Array<String>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/MacHost AWS API Documentation
+    #
+    class MacHost < Struct.new(
+      :host_id,
+      :mac_os_latest_supported_versions)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Details for Site-to-Site VPN tunnel endpoint maintenance events.
     #
     # @!attribute [rw] pending_maintenance

data/lib/aws-sdk-ec2.rb

@@ -76,6 +76,6 @@ require_relative 'aws-sdk-ec2/customizations'
 # @!group service
 module Aws::EC2
 
-  GEM_VERSION = '1.443.0'
+  GEM_VERSION = '1.444.0'
 
 end

data/sig/client.rbs

@@ -6212,6 +6212,25 @@ module Aws
                                      ) -> _DescribeLockedSnapshotsResponseSuccess
                                    | (?Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _DescribeLockedSnapshotsResponseSuccess
 
+      interface _DescribeMacHostsResponseSuccess
+        include ::Seahorse::Client::_ResponseSuccess[Types::DescribeMacHostsResult]
+        def mac_hosts: () -> ::Array[Types::MacHost]
+        def next_token: () -> ::String
+      end
+      # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/EC2/Client.html#describe_mac_hosts-instance_method
+      def describe_mac_hosts: (
+                                ?filters: Array[
+                                  {
+                                    name: ::String?,
+                                    values: Array[::String]?
+                                  },
+                                ],
+                                ?host_ids: Array[::String],
+                                ?max_results: ::Integer,
+                                ?next_token: ::String
+                              ) -> _DescribeMacHostsResponseSuccess
+                            | (?Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _DescribeMacHostsResponseSuccess
+
       interface _DescribeManagedPrefixListsResponseSuccess
         include ::Seahorse::Client::_ResponseSuccess[Types::DescribeManagedPrefixListsResult]
         def next_token: () -> ::String

data/sig/types.rbs

@@ -5000,6 +5000,20 @@ module Aws::EC2
       SENSITIVE: []
     end
 
+    class DescribeMacHostsRequest
+      attr_accessor filters: ::Array[Types::Filter]
+      attr_accessor host_ids: ::Array[::String]
+      attr_accessor max_results: ::Integer
+      attr_accessor next_token: ::String
+      SENSITIVE: []
+    end
+
+    class DescribeMacHostsResult
+      attr_accessor mac_hosts: ::Array[Types::MacHost]
+      attr_accessor next_token: ::String
+      SENSITIVE: []
+    end
+
     class DescribeManagedPrefixListsRequest
       attr_accessor dry_run: bool
       attr_accessor filters: ::Array[Types::Filter]
@@ -10099,6 +10113,12 @@ module Aws::EC2
       SENSITIVE: []
     end
 
+    class MacHost
+      attr_accessor host_id: ::String
+      attr_accessor mac_os_latest_supported_versions: ::Array[::String]
+      SENSITIVE: []
+    end
+
     class MaintenanceDetails
       attr_accessor pending_maintenance: ::String
       attr_accessor maintenance_auto_applied_after: ::Time

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-ec2
 version: !ruby/object:Gem::Version
-  version: 1.443.0
+  version: 1.444.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-03-15 00:00:00.000000000 Z
+date: 2024-03-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core