aws-sdk-licensemanagerlinuxsubscriptions 1.17.0 → 1.19.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f0161e01ec2dc95c9535714ab64ad6d089dc83fb787d7cd2c42baa9693bf2b7c
-  data.tar.gz: b05809ac69eb5bca506502f5845a40f4dc4d0318e2d5081fc1cfe7cb5df406c1
+  metadata.gz: 69deb26f692ebab83e784f1296b462bf3462f387ce01ca5d31f31af6fba48263
+  data.tar.gz: cb04eafa01b94cda3deea28813cbbab9175d85dd3e88fa4e45389b2ef3a72d77
 SHA512:
-  metadata.gz: 0f3ca5221d18ced90c72baca8ff7fd3740bb99fb6e6c10555876610bcc9f331af6af25f360407838c88600da8536a470e4b5519694e5d089184054975cca6a99
-  data.tar.gz: a58b9b56561b74d07ea679e52cf6120521805a07d0dea9bbe0846cb136d5abaaa566c773361b45d14be0a606fed13b8039597868a17be4128dfff9c4f684deca
+  metadata.gz: a7675d58cb32e4483e16a5597022037a909a3f4719d66d90f68c391fa51e1c1ef57db010ab46280236ed50f9c2af31aa53a7678e9538957bff88c0811b74d397
+  data.tar.gz: 29cf81fcbe33c0200be4e68aa6ba846de3c793a9d59a307122d1f3feae64dc89e95a99bf1fbb232ff715cdcc228c43f385ae63145cf4d8b41ac08054fa5800a1

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.19.0 (2024-09-03)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.18.0 (2024-07-10)
+------------------
+
+* Feature - Add support for third party subscription providers, starting with RHEL subscriptions through Red Hat Subscription Manager (RHSM). Additionally, add support for tagging subscription provider resources, and detect when an instance has more than one Linux subscription and notify the customer.
+
 1.17.0 (2024-07-02)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.17.0
+1.19.0

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

@@ -32,6 +32,7 @@ require 'aws-sdk-core/plugins/checksum_algorithm.rb'
 require 'aws-sdk-core/plugins/request_compression.rb'
 require 'aws-sdk-core/plugins/defaults_mode.rb'
 require 'aws-sdk-core/plugins/recursion_detection.rb'
+require 'aws-sdk-core/plugins/telemetry.rb'
 require 'aws-sdk-core/plugins/sign.rb'
 require 'aws-sdk-core/plugins/protocols/rest_json.rb'
 
@@ -83,6 +84,7 @@ module Aws::LicenseManagerLinuxSubscriptions
     add_plugin(Aws::Plugins::RequestCompression)
     add_plugin(Aws::Plugins::DefaultsMode)
     add_plugin(Aws::Plugins::RecursionDetection)
+    add_plugin(Aws::Plugins::Telemetry)
     add_plugin(Aws::Plugins::Sign)
     add_plugin(Aws::Plugins::Protocols::RestJson)
     add_plugin(Aws::LicenseManagerLinuxSubscriptions::Plugins::Endpoints)
@@ -330,6 +332,16 @@ module Aws::LicenseManagerLinuxSubscriptions
     #     ** Please note ** When response stubbing is enabled, no HTTP
     #     requests are made, and retries are disabled.
     #
+    #   @option options [Aws::Telemetry::TelemetryProviderBase] :telemetry_provider (Aws::Telemetry::NoOpTelemetryProvider)
+    #     Allows you to provide a telemetry provider, which is used to
+    #     emit telemetry data. By default, uses `NoOpTelemetryProvider` which
+    #     will not record or emit any telemetry data. The SDK supports the
+    #     following telemetry providers:
+    #
+    #     * OpenTelemetry (OTel) - To use the OTel provider, install and require the
+    #     `opentelemetry-sdk` gem and then, pass in an instance of a
+    #     `Aws::Telemetry::OTelProvider` for telemetry provider.
+    #
     #   @option options [Aws::TokenProvider] :token_provider
     #     A Bearer Token Provider. This can be an instance of any one of the
     #     following classes:
@@ -425,7 +437,71 @@ module Aws::LicenseManagerLinuxSubscriptions
 
     # @!group API Operations
 
-    # Lists the Linux subscriptions service settings.
+    # Remove a third-party subscription provider from the Bring Your Own
+    # License (BYOL) subscriptions registered to your account.
+    #
+    # @option params [required, String] :subscription_provider_arn
+    #   The Amazon Resource Name (ARN) of the subscription provider resource
+    #   to deregister.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.deregister_subscription_provider({
+    #     subscription_provider_arn: "SubscriptionProviderArn", # required
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/license-manager-linux-subscriptions-2018-05-10/DeregisterSubscriptionProvider AWS API Documentation
+    #
+    # @overload deregister_subscription_provider(params = {})
+    # @param [Hash] params ({})
+    def deregister_subscription_provider(params = {}, options = {})
+      req = build_request(:deregister_subscription_provider, params)
+      req.send_request(options)
+    end
+
+    # Get details for a Bring Your Own License (BYOL) subscription that's
+    # registered to your account.
+    #
+    # @option params [required, String] :subscription_provider_arn
+    #   The Amazon Resource Name (ARN) of the BYOL registration resource to
+    #   get details for.
+    #
+    # @return [Types::GetRegisteredSubscriptionProviderResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetRegisteredSubscriptionProviderResponse#last_successful_data_retrieval_time #last_successful_data_retrieval_time} => String
+    #   * {Types::GetRegisteredSubscriptionProviderResponse#secret_arn #secret_arn} => String
+    #   * {Types::GetRegisteredSubscriptionProviderResponse#subscription_provider_arn #subscription_provider_arn} => String
+    #   * {Types::GetRegisteredSubscriptionProviderResponse#subscription_provider_source #subscription_provider_source} => String
+    #   * {Types::GetRegisteredSubscriptionProviderResponse#subscription_provider_status #subscription_provider_status} => String
+    #   * {Types::GetRegisteredSubscriptionProviderResponse#subscription_provider_status_message #subscription_provider_status_message} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_registered_subscription_provider({
+    #     subscription_provider_arn: "SubscriptionProviderArn", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.last_successful_data_retrieval_time #=> String
+    #   resp.secret_arn #=> String
+    #   resp.subscription_provider_arn #=> String
+    #   resp.subscription_provider_source #=> String, one of "RedHat"
+    #   resp.subscription_provider_status #=> String, one of "ACTIVE", "INVALID", "PENDING"
+    #   resp.subscription_provider_status_message #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/license-manager-linux-subscriptions-2018-05-10/GetRegisteredSubscriptionProvider AWS API Documentation
+    #
+    # @overload get_registered_subscription_provider(params = {})
+    # @param [Hash] params ({})
+    def get_registered_subscription_provider(params = {}, options = {})
+      req = build_request(:get_registered_subscription_provider, params)
+      req.send_request(options)
+    end
+
+    # Lists the Linux subscriptions service settings for your account.
     #
     # @return [Types::GetServiceSettingsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -460,31 +536,34 @@ module Aws::LicenseManagerLinuxSubscriptions
     # commercial Linux subscriptions.
     #
     # @option params [Array<Types::Filter>] :filters
-    #   An array of structures that you can use to filter the results to those
-    #   that match one or more sets of key-value pairs that you specify. For
-    #   example, you can filter by the name of `AmiID` with an optional
-    #   operator to see subscriptions that match, partially match, or don't
-    #   match a certain Amazon Machine Image (AMI) ID.
+    #   An array of structures that you can use to filter the results by your
+    #   specified criteria. For example, you can specify `Region` in the
+    #   `Name`, with the `contains` operator to list all subscriptions that
+    #   match a partial string in the `Value`, such as `us-west`.
     #
-    #   The valid names for this filter are:
+    #   For each filter, you can specify one of the following values for the
+    #   `Name` key to streamline results:
+    #
+    #   * `AccountID`
     #
     #   * `AmiID`
     #
+    #   * `DualSubscription`
+    #
     #   * `InstanceID`
     #
-    #   * `AccountID`
+    #   * `InstanceType`
     #
-    #   * `Status`
+    #   * `ProductCode`
     #
     #   * `Region`
     #
-    #   * `UsageOperation`
-    #
-    #   * `ProductCode`
+    #   * `Status`
     #
-    #   * `InstanceType`
+    #   * `UsageOperation`
     #
-    #   The valid Operators for this filter are:
+    #   For each filter, you can use one of the following `Operator` values to
+    #   define the behavior of the filter:
     #
     #   * `contains`
     #
@@ -493,10 +572,11 @@ module Aws::LicenseManagerLinuxSubscriptions
     #   * `Notequal`
     #
     # @option params [Integer] :max_results
-    #   Maximum number of results to return in a single call.
+    #   The maximum items to return in a request.
     #
     # @option params [String] :next_token
-    #   Token for the next set of results.
+    #   A token to specify where to start paginating. This is the nextToken
+    #   from a previously truncated response.
     #
     # @return [Types::ListLinuxSubscriptionInstancesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -524,14 +604,19 @@ module Aws::LicenseManagerLinuxSubscriptions
     #   resp.instances #=> Array
     #   resp.instances[0].account_id #=> String
     #   resp.instances[0].ami_id #=> String
+    #   resp.instances[0].dual_subscription #=> String
     #   resp.instances[0].instance_id #=> String
     #   resp.instances[0].instance_type #=> String
     #   resp.instances[0].last_updated_time #=> String
+    #   resp.instances[0].os_version #=> String
     #   resp.instances[0].product_code #=> Array
     #   resp.instances[0].product_code[0] #=> String
     #   resp.instances[0].region #=> String
+    #   resp.instances[0].registered_with_subscription_provider #=> String
     #   resp.instances[0].status #=> String
     #   resp.instances[0].subscription_name #=> String
+    #   resp.instances[0].subscription_provider_create_time #=> String
+    #   resp.instances[0].subscription_provider_update_time #=> String
     #   resp.instances[0].usage_operation #=> String
     #   resp.next_token #=> String
     #
@@ -570,10 +655,11 @@ module Aws::LicenseManagerLinuxSubscriptions
     #   * `Notequal`
     #
     # @option params [Integer] :max_results
-    #   Maximum number of results to return in a single call.
+    #   The maximum items to return in a request.
     #
     # @option params [String] :next_token
-    #   Token for the next set of results.
+    #   A token to specify where to start paginating. This is the nextToken
+    #   from a previously truncated response.
     #
     # @return [Types::ListLinuxSubscriptionsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -613,6 +699,191 @@ module Aws::LicenseManagerLinuxSubscriptions
       req.send_request(options)
     end
 
+    # List Bring Your Own License (BYOL) subscription registration resources
+    # for your account.
+    #
+    # @option params [Integer] :max_results
+    #   The maximum items to return in a request.
+    #
+    # @option params [String] :next_token
+    #   A token to specify where to start paginating. This is the nextToken
+    #   from a previously truncated response.
+    #
+    # @option params [Array<String>] :subscription_provider_sources
+    #   To filter your results, specify which subscription providers to return
+    #   in the list.
+    #
+    # @return [Types::ListRegisteredSubscriptionProvidersResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListRegisteredSubscriptionProvidersResponse#next_token #next_token} => String
+    #   * {Types::ListRegisteredSubscriptionProvidersResponse#registered_subscription_providers #registered_subscription_providers} => Array&lt;Types::RegisteredSubscriptionProvider&gt;
+    #
+    # 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_registered_subscription_providers({
+    #     max_results: 1,
+    #     next_token: "String",
+    #     subscription_provider_sources: ["RedHat"], # accepts RedHat
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.next_token #=> String
+    #   resp.registered_subscription_providers #=> Array
+    #   resp.registered_subscription_providers[0].last_successful_data_retrieval_time #=> String
+    #   resp.registered_subscription_providers[0].secret_arn #=> String
+    #   resp.registered_subscription_providers[0].subscription_provider_arn #=> String
+    #   resp.registered_subscription_providers[0].subscription_provider_source #=> String, one of "RedHat"
+    #   resp.registered_subscription_providers[0].subscription_provider_status #=> String, one of "ACTIVE", "INVALID", "PENDING"
+    #   resp.registered_subscription_providers[0].subscription_provider_status_message #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/license-manager-linux-subscriptions-2018-05-10/ListRegisteredSubscriptionProviders AWS API Documentation
+    #
+    # @overload list_registered_subscription_providers(params = {})
+    # @param [Hash] params ({})
+    def list_registered_subscription_providers(params = {}, options = {})
+      req = build_request(:list_registered_subscription_providers, params)
+      req.send_request(options)
+    end
+
+    # List the metadata tags that are assigned to the specified Amazon Web
+    # Services resource.
+    #
+    # @option params [required, String] :resource_arn
+    #   The Amazon Resource Name (ARN) of the resource for which to list
+    #   metadata tags.
+    #
+    # @return [Types::ListTagsForResourceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListTagsForResourceResponse#tags #tags} => Hash&lt;String,String&gt;
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_tags_for_resource({
+    #     resource_arn: "SubscriptionProviderArn", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.tags #=> Hash
+    #   resp.tags["String"] #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/license-manager-linux-subscriptions-2018-05-10/ListTagsForResource AWS API Documentation
+    #
+    # @overload list_tags_for_resource(params = {})
+    # @param [Hash] params ({})
+    def list_tags_for_resource(params = {}, options = {})
+      req = build_request(:list_tags_for_resource, params)
+      req.send_request(options)
+    end
+
+    # Register the supported third-party subscription provider for your
+    # Bring Your Own License (BYOL) subscription.
+    #
+    # @option params [required, String] :secret_arn
+    #   The Amazon Resource Name (ARN) of the secret where you've stored your
+    #   subscription provider's access token. For RHEL subscriptions managed
+    #   through the Red Hat Subscription Manager (RHSM), the secret contains
+    #   your Red Hat Offline token.
+    #
+    # @option params [required, String] :subscription_provider_source
+    #   The supported Linux subscription provider to register.
+    #
+    # @option params [Hash<String,String>] :tags
+    #   The metadata tags to assign to your registered Linux subscription
+    #   provider resource.
+    #
+    # @return [Types::RegisterSubscriptionProviderResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::RegisterSubscriptionProviderResponse#subscription_provider_arn #subscription_provider_arn} => String
+    #   * {Types::RegisterSubscriptionProviderResponse#subscription_provider_source #subscription_provider_source} => String
+    #   * {Types::RegisterSubscriptionProviderResponse#subscription_provider_status #subscription_provider_status} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.register_subscription_provider({
+    #     secret_arn: "SecretArn", # required
+    #     subscription_provider_source: "RedHat", # required, accepts RedHat
+    #     tags: {
+    #       "String" => "String",
+    #     },
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.subscription_provider_arn #=> String
+    #   resp.subscription_provider_source #=> String, one of "RedHat"
+    #   resp.subscription_provider_status #=> String, one of "ACTIVE", "INVALID", "PENDING"
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/license-manager-linux-subscriptions-2018-05-10/RegisterSubscriptionProvider AWS API Documentation
+    #
+    # @overload register_subscription_provider(params = {})
+    # @param [Hash] params ({})
+    def register_subscription_provider(params = {}, options = {})
+      req = build_request(:register_subscription_provider, params)
+      req.send_request(options)
+    end
+
+    # Add metadata tags to the specified Amazon Web Services resource.
+    #
+    # @option params [required, String] :resource_arn
+    #   The Amazon Resource Name (ARN) of the Amazon Web Services resource to
+    #   which to add the specified metadata tags.
+    #
+    # @option params [required, Hash<String,String>] :tags
+    #   The metadata tags to assign to the Amazon Web Services resource. Tags
+    #   are formatted as key value pairs.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.tag_resource({
+    #     resource_arn: "SubscriptionProviderArn", # required
+    #     tags: { # required
+    #       "String" => "String",
+    #     },
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/license-manager-linux-subscriptions-2018-05-10/TagResource AWS API Documentation
+    #
+    # @overload tag_resource(params = {})
+    # @param [Hash] params ({})
+    def tag_resource(params = {}, options = {})
+      req = build_request(:tag_resource, params)
+      req.send_request(options)
+    end
+
+    # Remove one or more metadata tag from the specified Amazon Web Services
+    # resource.
+    #
+    # @option params [required, String] :resource_arn
+    #   The Amazon Resource Name (ARN) of the Amazon Web Services resource to
+    #   remove the metadata tags from.
+    #
+    # @option params [required, Array<String>] :tag_keys
+    #   A list of metadata tag keys to remove from the requested resource.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.untag_resource({
+    #     resource_arn: "SubscriptionProviderArn", # required
+    #     tag_keys: ["String"], # required
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/license-manager-linux-subscriptions-2018-05-10/UntagResource AWS API Documentation
+    #
+    # @overload untag_resource(params = {})
+    # @param [Hash] params ({})
+    def untag_resource(params = {}, options = {})
+      req = build_request(:untag_resource, params)
+      req.send_request(options)
+    end
+
     # Updates the service settings for Linux subscriptions.
     #
     # @option params [Boolean] :allow_update
@@ -674,14 +945,19 @@ module Aws::LicenseManagerLinuxSubscriptions
     # @api private
     def build_request(operation_name, params = {})
       handlers = @handlers.for(operation_name)
+      tracer = config.telemetry_provider.tracer_provider.tracer(
+        Aws::Telemetry.module_to_tracer_name('Aws::LicenseManagerLinuxSubscriptions')
+      )
       context = Seahorse::Client::RequestContext.new(
         operation_name: operation_name,
         operation: config.api.operation(operation_name),
         client: self,
         params: params,
-        config: config)
+        config: config,
+        tracer: tracer
+      )
       context[:gem_name] = 'aws-sdk-licensemanagerlinuxsubscriptions'
-      context[:gem_version] = '1.17.0'
+      context[:gem_version] = '1.19.0'
       Seahorse::Client::Request.new(handlers, context)
     end