google-apis-cloudresourcemanager_v3 0.23.0 → 0.24.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 428c2e34e033207d76da8c223a2f6917483ec4bf9555d99bc4cc3cc7160619bf
-  data.tar.gz: 683322e925f18fd1445cff142afe678da66c5440ccabbc215f6a5b82f335e6ac
+  metadata.gz: 10ca112d52fd9ada80459dc82a2d444bea7a47357facfcd4551ba98f903ce2ff
+  data.tar.gz: 8d4a059dd13f5672e211028f03d23ebdfdd44b81621ccfc720da547a1cbedbc1
 SHA512:
-  metadata.gz: ae9960b78d0eec8e581136d63cfea06223029545be033e8577c3cee5e6ba892a4fbe6ceae65f02a097a006f1404a3033f40a5f6af3b65efe6821e32a9f5b5342
-  data.tar.gz: 613820dcd2608562e20e11448365aa9639944f6410400a55e83af940a4c4ab529f498ebf84ea4d8ef728c5ac0aaa156d53d267f6e3c46fe7647867467c08cd7a
+  metadata.gz: 65042ea4a5ef5ad31a9bfc2621d0a386d984f6fe45d41196edb068d82d73f146b5abeb096b33ced412b73811cf63c474a27eee3bd4f7801c9dcc17058bda33a6
+  data.tar.gz: 5a8a4cf2a04edfed17830e1f2bc1e9a7c8d796ce7b153a1c4a4a3355bb5fbd30eaae543a703027874c0fa681611650a61b357a9f7be8359e9d4bdc6b1865fb62

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Release history for google-apis-cloudresourcemanager_v3
 
+### v0.24.0 (2022-04-07)
+
+* Regenerated from discovery document revision 20220403
+
 ### v0.23.0 (2022-03-24)
 
 * Regenerated from discovery document revision 20220320

data/lib/google/apis/cloudresourcemanager_v3/classes.rb

@@ -116,7 +116,7 @@ module Google
         # @return [Google::Apis::CloudresourcemanagerV3::Expr]
         attr_accessor :condition
       
-        # Specifies the principals requesting access for a Cloud Platform resource. `
+        # Specifies the principals requesting access for a Google Cloud resource. `
         # members` can have the following values: * `allUsers`: A special identifier
         # that represents anyone who is on the internet; with or without a Google
         # account. * `allAuthenticatedUsers`: A special identifier that represents
@@ -846,6 +846,36 @@ module Google
         end
       end
       
+      # The ListTagHolds response.
+      class ListTagHoldsResponse
+        include Google::Apis::Core::Hashable
+      
+        # Pagination token. If the result set is too large to fit in a single response,
+        # this token is returned. It encodes the position of the current result cursor.
+        # Feeding this value into a new list request with the `page_token` parameter
+        # gives the next page of the results. When `next_page_token` is not filled in,
+        # there is no next page and the list returned is the last page in the result set.
+        # Pagination tokens have a limited lifetime.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+      
+        # A possibly paginated list of TagHolds.
+        # Corresponds to the JSON property `tagHolds`
+        # @return [Array<Google::Apis::CloudresourcemanagerV3::TagHold>]
+        attr_accessor :tag_holds
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+          @tag_holds = args[:tag_holds] if args.key?(:tag_holds)
+        end
+      end
+      
       # The ListTagKeys response message.
       class ListTagKeysResponse
         include Google::Apis::Core::Hashable
@@ -1553,6 +1583,59 @@ module Google
         end
       end
       
+      # A TagHold represents the use of a TagValue that is not captured by TagBindings.
+      # If a TagValue has any TagHolds, deletion will be blocked. This resource is
+      # intended to be created in the same cloud location as the `holder`.
+      class TagHold
+        include Google::Apis::Core::Hashable
+      
+        # Output only. The time this TagHold was created.
+        # Corresponds to the JSON property `createTime`
+        # @return [String]
+        attr_accessor :create_time
+      
+        # Optional. A URL where an end user can learn more about removing this hold. E.g.
+        # `https://cloud.google.com/resource-manager/docs/tags/tags-creating-and-
+        # managing`
+        # Corresponds to the JSON property `helpLink`
+        # @return [String]
+        attr_accessor :help_link
+      
+        # Required. The name of the resource where the TagValue is being used. Must be
+        # less than 200 characters. E.g. `//compute.googleapis.com/compute/projects/
+        # myproject/regions/us-east-1/instanceGroupManagers/instance-group`
+        # Corresponds to the JSON property `holder`
+        # @return [String]
+        attr_accessor :holder
+      
+        # Output only. The resource name of a TagHold. This is a String of the form: `
+        # tagValues/`tag-value-id`/tagHolds/`tag-hold-id`` (e.g. `tagValues/123/tagHolds/
+        # 456`). This resource name is generated by the server.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # Optional. An optional string representing the origin of this request. This
+        # field should include human-understandable information to distinguish origins
+        # from each other. Must be less than 200 characters. E.g. `migs-35678234`
+        # Corresponds to the JSON property `origin`
+        # @return [String]
+        attr_accessor :origin
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @create_time = args[:create_time] if args.key?(:create_time)
+          @help_link = args[:help_link] if args.key?(:help_link)
+          @holder = args[:holder] if args.key?(:holder)
+          @name = args[:name] if args.key?(:name)
+          @origin = args[:origin] if args.key?(:origin)
+        end
+      end
+      
       # A TagKey, used to group a set of TagValues.
       class TagKey
         include Google::Apis::Core::Hashable
@@ -1697,7 +1780,7 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The set of permissions to check for the `resource`. Permissions with wildcards
-        # (such as '*' or 'storage.*') are not allowed. For more information see [IAM
+        # (such as `*` or `storage.*`) are not allowed. For more information see [IAM
         # Overview](https://cloud.google.com/iam/docs/overview#permissions).
         # Corresponds to the JSON property `permissions`
         # @return [Array<String>]

data/lib/google/apis/cloudresourcemanager_v3/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module CloudresourcemanagerV3
       # Version of the google-apis-cloudresourcemanager_v3 gem
-      GEM_VERSION = "0.23.0"
+      GEM_VERSION = "0.24.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.4.1"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20220320"
+      REVISION = "20220403"
     end
   end
 end

data/lib/google/apis/cloudresourcemanager_v3/representations.rb

@@ -190,6 +190,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class ListTagHoldsResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class ListTagKeysResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -292,6 +298,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class TagHold
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class TagKey
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -598,6 +610,15 @@ module Google
         end
       end
       
+      class ListTagHoldsResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :next_page_token, as: 'nextPageToken'
+          collection :tag_holds, as: 'tagHolds', class: Google::Apis::CloudresourcemanagerV3::TagHold, decorator: Google::Apis::CloudresourcemanagerV3::TagHold::Representation
+      
+        end
+      end
+      
       class ListTagKeysResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -762,6 +783,17 @@ module Google
         end
       end
       
+      class TagHold
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :create_time, as: 'createTime'
+          property :help_link, as: 'helpLink'
+          property :holder, as: 'holder'
+          property :name, as: 'name'
+          property :origin, as: 'origin'
+        end
+      end
+      
       class TagKey
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

data/lib/google/apis/cloudresourcemanager_v3/service.rb

@@ -2066,6 +2066,130 @@ module Google
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
         end
+        
+        # Creates a TagHold. Returns ALREADY_EXISTS if a TagHold with the same resource
+        # and origin exists under the same TagValue.
+        # @param [String] parent
+        #   Required. The resource name of the TagHold's parent TagValue. Must be of the
+        #   form: `tagValues/`tag-value-id``.
+        # @param [Google::Apis::CloudresourcemanagerV3::TagHold] tag_hold_object
+        # @param [Boolean] validate_only
+        #   Optional. Set to true to perform the validations necessary for creating the
+        #   resource, but not actually perform the action.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::CloudresourcemanagerV3::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudresourcemanagerV3::Operation]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def create_tag_value_tag_hold(parent, tag_hold_object = nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v3/{+parent}/tagHolds', options)
+          command.request_representation = Google::Apis::CloudresourcemanagerV3::TagHold::Representation
+          command.request_object = tag_hold_object
+          command.response_representation = Google::Apis::CloudresourcemanagerV3::Operation::Representation
+          command.response_class = Google::Apis::CloudresourcemanagerV3::Operation
+          command.params['parent'] = parent unless parent.nil?
+          command.query['validateOnly'] = validate_only unless validate_only.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Deletes a TagHold.
+        # @param [String] name
+        #   Required. The resource name of the TagHold to delete. Must be of the form: `
+        #   tagValues/`tag-value-id`/tagHolds/`tag-hold-id``.
+        # @param [Boolean] validate_only
+        #   Optional. Set to true to perform the validations necessary for deleting the
+        #   resource, but not actually perform the action.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::CloudresourcemanagerV3::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudresourcemanagerV3::Operation]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def delete_tag_value_tag_hold(name, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:delete, 'v3/{+name}', options)
+          command.response_representation = Google::Apis::CloudresourcemanagerV3::Operation::Representation
+          command.response_class = Google::Apis::CloudresourcemanagerV3::Operation
+          command.params['name'] = name unless name.nil?
+          command.query['validateOnly'] = validate_only unless validate_only.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Lists TagHolds under a TagValue.
+        # @param [String] parent
+        #   Required. The resource name of the parent TagValue. Must be of the form: `
+        #   tagValues/`tag-value-id``.
+        # @param [String] filter
+        #   Optional. Criteria used to select a subset of TagHolds parented by the
+        #   TagValue to return. This field follows the syntax defined by aip.dev/160; the `
+        #   holder` and `origin` fields are supported for filtering. Currently only `AND`
+        #   syntax is supported. Some example queries are: * `holder = //compute.
+        #   googleapis.com/compute/projects/myproject/regions/us-east-1/
+        #   instanceGroupManagers/instance-group` * `origin = 35678234` * `holder = //
+        #   compute.googleapis.com/compute/projects/myproject/regions/us-east-1/
+        #   instanceGroupManagers/instance-group AND origin = 35678234`
+        # @param [Fixnum] page_size
+        #   Optional. The maximum number of TagHolds to return in the response. The server
+        #   allows a maximum of 300 TagHolds to return. If unspecified, the server will
+        #   use 100 as the default.
+        # @param [String] page_token
+        #   Optional. A pagination token returned from a previous call to `ListTagHolds`
+        #   that indicates where this listing should continue from.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::CloudresourcemanagerV3::ListTagHoldsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudresourcemanagerV3::ListTagHoldsResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def list_tag_value_tag_holds(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v3/{+parent}/tagHolds', options)
+          command.response_representation = Google::Apis::CloudresourcemanagerV3::ListTagHoldsResponse::Representation
+          command.response_class = Google::Apis::CloudresourcemanagerV3::ListTagHoldsResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['filter'] = filter unless filter.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
 
         protected
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-cloudresourcemanager_v3
 version: !ruby/object:Gem::Version
-  version: 0.23.0
+  version: 0.24.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-03-28 00:00:00.000000000 Z
+date: 2022-04-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -58,7 +58,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-cloudresourcemanager_v3/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-cloudresourcemanager_v3/v0.23.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-cloudresourcemanager_v3/v0.24.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-cloudresourcemanager_v3
 post_install_message: 
 rdoc_options: []