aws-sdk-ram 1.35.0 → 1.36.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 51ef2e78f421e30ed210d8b657ba4a09ec06d29513f81bf2d098a49eec22a0aa
-  data.tar.gz: a55db117461296b2753b7d9cc8671e4fb582e5195790b61f76807b309d8f90b5
+  metadata.gz: 472b32e157dd694c328a9c5c74059317cbb6c3cf66983bbf8b63cfc8a5b63599
+  data.tar.gz: 8765d9a071640505dff4f49af1a7f6cabe4c5fab40953a7f168279e6aacef988
 SHA512:
-  metadata.gz: 61c313b926cdabeb4fa659b0ca7821c17a501f711807bbd031e5a782a0d9709cb8f99e5fc508fe6e3e954f28b56f4450db0ad278ede13c879617ad2d772c2fa1
-  data.tar.gz: f1cd519d658d7993aa97d412e77c668a5113cc919f3ef9bd790f1c097902f1b990d1d02492030652b72f5e3a15ca7928e11c4ff85457625a1723be6cc2fd3136
+  metadata.gz: 764f8950bed887248dee51710e11130cc2523bd01e3e6c1ec26a545a4752c65bbcf5811e2f55cf95c05c701ccc6f9432f831c84eb933b70149a363c4b0c6436a
+  data.tar.gz: dfdcedea948a8baf1217efadd290744f77a4d671bb7c9f3f53dd4b827d0eb99f197aee0b5bd5978ebea6a16122094c32e2c4dd8c383108a24dae1a39b31c7abe

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.36.0 (2022-01-14)
+------------------
+
+* Feature - This release adds the ListPermissionVersions API which lists the versions for a given permission.
+
 1.35.0 (2021-12-21)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.35.0
+1.36.0

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

@@ -585,7 +585,9 @@ module Aws::RAM
     # @option params [Integer] :permission_version
     #   Specifies the version of the RAM permission to associate with the
     #   resource share. If you don't specify this parameter, the operation
-    #   uses the version designated as the default.
+    #   uses the version designated as the default. You can use the
+    #   ListPermissionVersions operation to discover the available versions of
+    #   a permission.
     #
     # @return [Types::AssociateResourceSharePermissionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1516,6 +1518,75 @@ module Aws::RAM
       req.send_request(options)
     end
 
+    # Lists the available versions of the specified RAM permission.
+    #
+    # @option params [required, String] :permission_arn
+    #   Specifies the [Amazon Resoure Name (ARN)][1] of the RAM permission
+    #   whose versions you want to list. You can use the `permissionVersion`
+    #   parameter on the AssociateResourceSharePermission operation to specify
+    #   a non-default version to attach.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html
+    #
+    # @option params [String] :next_token
+    #   Specifies that you want to receive the next page of results. Valid
+    #   only if you received a `NextToken` response in the previous request.
+    #   If you did, it indicates that more output is available. Set this
+    #   parameter to the value provided by the previous call's `NextToken`
+    #   response to request the next page of results.
+    #
+    # @option params [Integer] :max_results
+    #   Specifies the total number of results that you want included on each
+    #   page of the response. If you do not include this parameter, it
+    #   defaults to a value that is specific to the operation. If additional
+    #   items exist beyond the number you specify, the `NextToken` response
+    #   element is returned with a value (not null). Include the specified
+    #   value as the `NextToken` request parameter in the next call to the
+    #   operation to get the next part of the results. Note that the service
+    #   might return fewer results than the maximum even when there are more
+    #   results available. You should check `NextToken` after every operation
+    #   to ensure that you receive all of the results.
+    #
+    # @return [Types::ListPermissionVersionsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListPermissionVersionsResponse#permissions #permissions} => Array<Types::ResourceSharePermissionSummary>
+    #   * {Types::ListPermissionVersionsResponse#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_permission_versions({
+    #     permission_arn: "String", # required
+    #     next_token: "String",
+    #     max_results: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.permissions #=> Array
+    #   resp.permissions[0].arn #=> String
+    #   resp.permissions[0].version #=> String
+    #   resp.permissions[0].default_version #=> Boolean
+    #   resp.permissions[0].name #=> String
+    #   resp.permissions[0].resource_type #=> String
+    #   resp.permissions[0].status #=> String
+    #   resp.permissions[0].creation_time #=> Time
+    #   resp.permissions[0].last_updated_time #=> Time
+    #   resp.permissions[0].is_resource_type_default #=> Boolean
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ram-2018-01-04/ListPermissionVersions AWS API Documentation
+    #
+    # @overload list_permission_versions(params = {})
+    # @param [Hash] params ({})
+    def list_permission_versions(params = {}, options = {})
+      req = build_request(:list_permission_versions, params)
+      req.send_request(options)
+    end
+
     # Retrieves a list of available RAM permissions that you can use for the
     # supported resource types.
     #
@@ -2224,7 +2295,7 @@ module Aws::RAM
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-ram'
-      context[:gem_version] = '1.35.0'
+      context[:gem_version] = '1.36.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -51,6 +51,8 @@ module Aws::RAM
     InvalidStateTransitionException = Shapes::StructureShape.new(name: 'InvalidStateTransitionException')
     ListPendingInvitationResourcesRequest = Shapes::StructureShape.new(name: 'ListPendingInvitationResourcesRequest')
     ListPendingInvitationResourcesResponse = Shapes::StructureShape.new(name: 'ListPendingInvitationResourcesResponse')
+    ListPermissionVersionsRequest = Shapes::StructureShape.new(name: 'ListPermissionVersionsRequest')
+    ListPermissionVersionsResponse = Shapes::StructureShape.new(name: 'ListPermissionVersionsResponse')
     ListPermissionsRequest = Shapes::StructureShape.new(name: 'ListPermissionsRequest')
     ListPermissionsResponse = Shapes::StructureShape.new(name: 'ListPermissionsResponse')
     ListPrincipalsRequest = Shapes::StructureShape.new(name: 'ListPrincipalsRequest')
@@ -287,6 +289,15 @@ module Aws::RAM
     ListPendingInvitationResourcesResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "nextToken"))
     ListPendingInvitationResourcesResponse.struct_class = Types::ListPendingInvitationResourcesResponse
 
+    ListPermissionVersionsRequest.add_member(:permission_arn, Shapes::ShapeRef.new(shape: String, required: true, location_name: "permissionArn"))
+    ListPermissionVersionsRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "nextToken"))
+    ListPermissionVersionsRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxResults, location_name: "maxResults"))
+    ListPermissionVersionsRequest.struct_class = Types::ListPermissionVersionsRequest
+
+    ListPermissionVersionsResponse.add_member(:permissions, Shapes::ShapeRef.new(shape: ResourceSharePermissionList, location_name: "permissions"))
+    ListPermissionVersionsResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "nextToken"))
+    ListPermissionVersionsResponse.struct_class = Types::ListPermissionVersionsResponse
+
     ListPermissionsRequest.add_member(:resource_type, Shapes::ShapeRef.new(shape: String, location_name: "resourceType"))
     ListPermissionsRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "nextToken"))
     ListPermissionsRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxResults, location_name: "maxResults"))
@@ -816,6 +827,27 @@ module Aws::RAM
         )
       end)
 
+      api.add_operation(:list_permission_versions, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "ListPermissionVersions"
+        o.http_method = "POST"
+        o.http_request_uri = "/listpermissionversions"
+        o.input = Shapes::ShapeRef.new(shape: ListPermissionVersionsRequest)
+        o.output = Shapes::ShapeRef.new(shape: ListPermissionVersionsResponse)
+        o.errors << Shapes::ShapeRef.new(shape: MalformedArnException)
+        o.errors << Shapes::ShapeRef.new(shape: UnknownResourceException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidNextTokenException)
+        o.errors << Shapes::ShapeRef.new(shape: ServerInternalException)
+        o.errors << Shapes::ShapeRef.new(shape: ServiceUnavailableException)
+        o.errors << Shapes::ShapeRef.new(shape: OperationNotPermittedException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidParameterException)
+        o[:pager] = Aws::Pager.new(
+          limit_key: "max_results",
+          tokens: {
+            "next_token" => "next_token"
+          }
+        )
+      end)
+
       api.add_operation(:list_permissions, Seahorse::Model::Operation.new.tap do |o|
         o.name = "ListPermissions"
         o.http_method = "POST"

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

@@ -140,7 +140,9 @@ module Aws::RAM
     # @!attribute [rw] permission_version
     #   Specifies the version of the RAM permission to associate with the
     #   resource share. If you don't specify this parameter, the operation
-    #   uses the version designated as the default.
+    #   uses the version designated as the default. You can use the
+    #   ListPermissionVersions operation to discover the available versions
+    #   of a permission.
     #   @return [Integer]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ram-2018-01-04/AssociateResourceSharePermissionRequest AWS API Documentation
@@ -1340,6 +1342,80 @@ module Aws::RAM
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass ListPermissionVersionsRequest
+    #   data as a hash:
+    #
+    #       {
+    #         permission_arn: "String", # required
+    #         next_token: "String",
+    #         max_results: 1,
+    #       }
+    #
+    # @!attribute [rw] permission_arn
+    #   Specifies the [Amazon Resoure Name (ARN)][1] of the RAM permission
+    #   whose versions you want to list. You can use the `permissionVersion`
+    #   parameter on the AssociateResourceSharePermission operation to
+    #   specify a non-default version to attach.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html
+    #   @return [String]
+    #
+    # @!attribute [rw] next_token
+    #   Specifies that you want to receive the next page of results. Valid
+    #   only if you received a `NextToken` response in the previous request.
+    #   If you did, it indicates that more output is available. Set this
+    #   parameter to the value provided by the previous call's `NextToken`
+    #   response to request the next page of results.
+    #   @return [String]
+    #
+    # @!attribute [rw] max_results
+    #   Specifies the total number of results that you want included on each
+    #   page of the response. If you do not include this parameter, it
+    #   defaults to a value that is specific to the operation. If additional
+    #   items exist beyond the number you specify, the `NextToken` response
+    #   element is returned with a value (not null). Include the specified
+    #   value as the `NextToken` request parameter in the next call to the
+    #   operation to get the next part of the results. Note that the service
+    #   might return fewer results than the maximum even when there are more
+    #   results available. You should check `NextToken` after every
+    #   operation to ensure that you receive all of the results.
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ram-2018-01-04/ListPermissionVersionsRequest AWS API Documentation
+    #
+    class ListPermissionVersionsRequest < Struct.new(
+      :permission_arn,
+      :next_token,
+      :max_results)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] permissions
+    #   An array of objects that contain details for each of the available
+    #   versions.
+    #   @return [Array<Types::ResourceSharePermissionSummary>]
+    #
+    # @!attribute [rw] next_token
+    #   If present, this value indicates that more output is available than
+    #   is included in the current response. Use this value in the
+    #   `NextToken` request parameter in a subsequent call to the operation
+    #   to get the next part of the output. You should repeat this until the
+    #   `NextToken` response element comes back as `null`. This indicates
+    #   that this is the last page of results.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ram-2018-01-04/ListPermissionVersionsResponse AWS API Documentation
+    #
+    class ListPermissionVersionsResponse < Struct.new(
+      :permissions,
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass ListPermissionsRequest
     #   data as a hash:
     #

data/lib/aws-sdk-ram.rb

@@ -48,6 +48,6 @@ require_relative 'aws-sdk-ram/customizations'
 # @!group service
 module Aws::RAM
 
-  GEM_VERSION = '1.35.0'
+  GEM_VERSION = '1.36.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-ram
 version: !ruby/object:Gem::Version
-  version: 1.35.0
+  version: 1.36.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-12-21 00:00:00.000000000 Z
+date: 2022-01-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core