google-apis-cloudresourcemanager_v3 0.23.0 → 0.26.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 428c2e34e033207d76da8c223a2f6917483ec4bf9555d99bc4cc3cc7160619bf
4
- data.tar.gz: 683322e925f18fd1445cff142afe678da66c5440ccabbc215f6a5b82f335e6ac
3
+ metadata.gz: 14c92538cd11ecabcfe4f147d04c3d4949448c372ecd95039ab7194845dd7a91
4
+ data.tar.gz: ac8de21f79f9b958b050bd2bc7ab86920b85dcacb2981a1ecbb8160b2f0dd689
5
5
  SHA512:
6
- metadata.gz: ae9960b78d0eec8e581136d63cfea06223029545be033e8577c3cee5e6ba892a4fbe6ceae65f02a097a006f1404a3033f40a5f6af3b65efe6821e32a9f5b5342
7
- data.tar.gz: 613820dcd2608562e20e11448365aa9639944f6410400a55e83af940a4c4ab529f498ebf84ea4d8ef728c5ac0aaa156d53d267f6e3c46fe7647867467c08cd7a
6
+ metadata.gz: 55a9895a61fed217ac7c669ccb111f38dc4395f12ebc5cc67b5c55645a791bf4cdf31ad7e71ea9f66b80c802f08c7c10af87a99699a161a00d8df500a31ea030
7
+ data.tar.gz: 7ea8778b40e26de64516fda643a12c237337e60ccc752fc84ea754519ebdaa7cb2391689614243f8f4b04297a3cf4cc22b31924e4ca62e03b0bbc3139b8a2d7f
data/CHANGELOG.md CHANGED
@@ -1,5 +1,17 @@
1
1
  # Release history for google-apis-cloudresourcemanager_v3
2
2
 
3
+ ### v0.26.0 (2022-05-05)
4
+
5
+ * Regenerated from discovery document revision 20220501
6
+
7
+ ### v0.25.0 (2022-04-28)
8
+
9
+ * Regenerated from discovery document revision 20220424
10
+
11
+ ### v0.24.0 (2022-04-07)
12
+
13
+ * Regenerated from discovery document revision 20220403
14
+
3
15
  ### v0.23.0 (2022-03-24)
4
16
 
5
17
  * Regenerated from discovery document revision 20220320
@@ -35,8 +35,8 @@ module Google
35
35
  # "audit_log_configs": [ ` "log_type": "DATA_READ" `, ` "log_type": "DATA_WRITE"
36
36
  # , "exempted_members": [ "user:aliya@example.com" ] ` ] ` ] ` For sampleservice,
37
37
  # this policy enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also
38
- # exempts jose@example.com from DATA_READ logging, and aliya@example.com from
39
- # DATA_WRITE logging.
38
+ # exempts `jose@example.com` from DATA_READ logging, and `aliya@example.com`
39
+ # from DATA_WRITE logging.
40
40
  class AuditConfig
41
41
  include Google::Apis::Core::Hashable
42
42
 
@@ -116,7 +116,7 @@ module Google
116
116
  # @return [Google::Apis::CloudresourcemanagerV3::Expr]
117
117
  attr_accessor :condition
118
118
 
119
- # Specifies the principals requesting access for a Cloud Platform resource. `
119
+ # Specifies the principals requesting access for a Google Cloud resource. `
120
120
  # members` can have the following values: * `allUsers`: A special identifier
121
121
  # that represents anyone who is on the internet; with or without a Google
122
122
  # account. * `allAuthenticatedUsers`: A special identifier that represents
@@ -424,6 +424,59 @@ module Google
424
424
  end
425
425
  end
426
426
 
427
+ # An EffectiveTag represents a tag that applies to a resource during policy
428
+ # evaluation. Tags can be either directly bound to a resource or inherited from
429
+ # its ancestor. EffectiveTag contains the name and namespaced_name of the tag
430
+ # value and tag key, with additional fields of `inherited` to indicate the
431
+ # inheritance status of the effective tag.
432
+ class EffectiveTag
433
+ include Google::Apis::Core::Hashable
434
+
435
+ # Indicates the inheritance status of a tag value attached to the given resource.
436
+ # If the tag value is inherited from one of the resource's ancestors, inherited
437
+ # will be true. If false, then the tag value is directly attached to the
438
+ # resource, inherited will be false.
439
+ # Corresponds to the JSON property `inherited`
440
+ # @return [Boolean]
441
+ attr_accessor :inherited
442
+ alias_method :inherited?, :inherited
443
+
444
+ # The namespaced_name of the TagKey, in the format of ``organization_id`/`
445
+ # tag_key_short_name``
446
+ # Corresponds to the JSON property `namespacedTagKey`
447
+ # @return [String]
448
+ attr_accessor :namespaced_tag_key
449
+
450
+ # Namespaced name of the TagValue. Must be in the format ``organization_id`/`
451
+ # tag_key_short_name`/`tag_value_short_name``.
452
+ # Corresponds to the JSON property `namespacedTagValue`
453
+ # @return [String]
454
+ attr_accessor :namespaced_tag_value
455
+
456
+ # The name of the TagKey, in the format `tagKeys/`id``, such as `tagKeys/123`.
457
+ # Corresponds to the JSON property `tagKey`
458
+ # @return [String]
459
+ attr_accessor :tag_key
460
+
461
+ # Resource name for TagValue in the format `tagValues/456`.
462
+ # Corresponds to the JSON property `tagValue`
463
+ # @return [String]
464
+ attr_accessor :tag_value
465
+
466
+ def initialize(**args)
467
+ update!(**args)
468
+ end
469
+
470
+ # Update properties of this object
471
+ def update!(**args)
472
+ @inherited = args[:inherited] if args.key?(:inherited)
473
+ @namespaced_tag_key = args[:namespaced_tag_key] if args.key?(:namespaced_tag_key)
474
+ @namespaced_tag_value = args[:namespaced_tag_value] if args.key?(:namespaced_tag_value)
475
+ @tag_key = args[:tag_key] if args.key?(:tag_key)
476
+ @tag_value = args[:tag_value] if args.key?(:tag_value)
477
+ end
478
+ end
479
+
427
480
  # A generic empty message that you can re-use to avoid defining duplicated empty
428
481
  # messages in your APIs. A typical example is to use it as the request or the
429
482
  # response type of an API method. For instance: service Foo ` rpc Bar(google.
@@ -729,6 +782,36 @@ module Google
729
782
  end
730
783
  end
731
784
 
785
+ # The response of ListEffectiveTags.
786
+ class ListEffectiveTagsResponse
787
+ include Google::Apis::Core::Hashable
788
+
789
+ # A possibly paginated list of effective tags for the specified resource.
790
+ # Corresponds to the JSON property `effectiveTags`
791
+ # @return [Array<Google::Apis::CloudresourcemanagerV3::EffectiveTag>]
792
+ attr_accessor :effective_tags
793
+
794
+ # Pagination token. If the result set is too large to fit in a single response,
795
+ # this token is returned. It encodes the position of the current result cursor.
796
+ # Feeding this value into a new list request with the `page_token` parameter
797
+ # gives the next page of the results. When `next_page_token` is not filled in,
798
+ # there is no next page and the list returned is the last page in the result set.
799
+ # Pagination tokens have a limited lifetime.
800
+ # Corresponds to the JSON property `nextPageToken`
801
+ # @return [String]
802
+ attr_accessor :next_page_token
803
+
804
+ def initialize(**args)
805
+ update!(**args)
806
+ end
807
+
808
+ # Update properties of this object
809
+ def update!(**args)
810
+ @effective_tags = args[:effective_tags] if args.key?(:effective_tags)
811
+ @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
812
+ end
813
+ end
814
+
732
815
  # The ListFolders response message.
733
816
  class ListFoldersResponse
734
817
  include Google::Apis::Core::Hashable
@@ -846,6 +929,36 @@ module Google
846
929
  end
847
930
  end
848
931
 
932
+ # The ListTagHolds response.
933
+ class ListTagHoldsResponse
934
+ include Google::Apis::Core::Hashable
935
+
936
+ # Pagination token. If the result set is too large to fit in a single response,
937
+ # this token is returned. It encodes the position of the current result cursor.
938
+ # Feeding this value into a new list request with the `page_token` parameter
939
+ # gives the next page of the results. When `next_page_token` is not filled in,
940
+ # there is no next page and the list returned is the last page in the result set.
941
+ # Pagination tokens have a limited lifetime.
942
+ # Corresponds to the JSON property `nextPageToken`
943
+ # @return [String]
944
+ attr_accessor :next_page_token
945
+
946
+ # A possibly paginated list of TagHolds.
947
+ # Corresponds to the JSON property `tagHolds`
948
+ # @return [Array<Google::Apis::CloudresourcemanagerV3::TagHold>]
949
+ attr_accessor :tag_holds
950
+
951
+ def initialize(**args)
952
+ update!(**args)
953
+ end
954
+
955
+ # Update properties of this object
956
+ def update!(**args)
957
+ @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
958
+ @tag_holds = args[:tag_holds] if args.key?(:tag_holds)
959
+ end
960
+ end
961
+
849
962
  # The ListTagKeys response message.
850
963
  class ListTagKeysResponse
851
964
  include Google::Apis::Core::Hashable
@@ -1553,6 +1666,59 @@ module Google
1553
1666
  end
1554
1667
  end
1555
1668
 
1669
+ # A TagHold represents the use of a TagValue that is not captured by TagBindings.
1670
+ # If a TagValue has any TagHolds, deletion will be blocked. This resource is
1671
+ # intended to be created in the same cloud location as the `holder`.
1672
+ class TagHold
1673
+ include Google::Apis::Core::Hashable
1674
+
1675
+ # Output only. The time this TagHold was created.
1676
+ # Corresponds to the JSON property `createTime`
1677
+ # @return [String]
1678
+ attr_accessor :create_time
1679
+
1680
+ # Optional. A URL where an end user can learn more about removing this hold. E.g.
1681
+ # `https://cloud.google.com/resource-manager/docs/tags/tags-creating-and-
1682
+ # managing`
1683
+ # Corresponds to the JSON property `helpLink`
1684
+ # @return [String]
1685
+ attr_accessor :help_link
1686
+
1687
+ # Required. The name of the resource where the TagValue is being used. Must be
1688
+ # less than 200 characters. E.g. `//compute.googleapis.com/compute/projects/
1689
+ # myproject/regions/us-east-1/instanceGroupManagers/instance-group`
1690
+ # Corresponds to the JSON property `holder`
1691
+ # @return [String]
1692
+ attr_accessor :holder
1693
+
1694
+ # Output only. The resource name of a TagHold. This is a String of the form: `
1695
+ # tagValues/`tag-value-id`/tagHolds/`tag-hold-id`` (e.g. `tagValues/123/tagHolds/
1696
+ # 456`). This resource name is generated by the server.
1697
+ # Corresponds to the JSON property `name`
1698
+ # @return [String]
1699
+ attr_accessor :name
1700
+
1701
+ # Optional. An optional string representing the origin of this request. This
1702
+ # field should include human-understandable information to distinguish origins
1703
+ # from each other. Must be less than 200 characters. E.g. `migs-35678234`
1704
+ # Corresponds to the JSON property `origin`
1705
+ # @return [String]
1706
+ attr_accessor :origin
1707
+
1708
+ def initialize(**args)
1709
+ update!(**args)
1710
+ end
1711
+
1712
+ # Update properties of this object
1713
+ def update!(**args)
1714
+ @create_time = args[:create_time] if args.key?(:create_time)
1715
+ @help_link = args[:help_link] if args.key?(:help_link)
1716
+ @holder = args[:holder] if args.key?(:holder)
1717
+ @name = args[:name] if args.key?(:name)
1718
+ @origin = args[:origin] if args.key?(:origin)
1719
+ end
1720
+ end
1721
+
1556
1722
  # A TagKey, used to group a set of TagValues.
1557
1723
  class TagKey
1558
1724
  include Google::Apis::Core::Hashable
@@ -1697,7 +1863,7 @@ module Google
1697
1863
  include Google::Apis::Core::Hashable
1698
1864
 
1699
1865
  # The set of permissions to check for the `resource`. Permissions with wildcards
1700
- # (such as '*' or 'storage.*') are not allowed. For more information see [IAM
1866
+ # (such as `*` or `storage.*`) are not allowed. For more information see [IAM
1701
1867
  # Overview](https://cloud.google.com/iam/docs/overview#permissions).
1702
1868
  # Corresponds to the JSON property `permissions`
1703
1869
  # @return [Array<String>]
@@ -16,13 +16,13 @@ module Google
16
16
  module Apis
17
17
  module CloudresourcemanagerV3
18
18
  # Version of the google-apis-cloudresourcemanager_v3 gem
19
- GEM_VERSION = "0.23.0"
19
+ GEM_VERSION = "0.26.0"
20
20
 
21
21
  # Version of the code generator used to generate this client
22
22
  GENERATOR_VERSION = "0.4.1"
23
23
 
24
24
  # Revision of the discovery document this client was generated from
25
- REVISION = "20220320"
25
+ REVISION = "20220501"
26
26
  end
27
27
  end
28
28
  end
@@ -118,6 +118,12 @@ module Google
118
118
  include Google::Apis::Core::JsonObjectSupport
119
119
  end
120
120
 
121
+ class EffectiveTag
122
+ class Representation < Google::Apis::Core::JsonRepresentation; end
123
+
124
+ include Google::Apis::Core::JsonObjectSupport
125
+ end
126
+
121
127
  class Empty
122
128
  class Representation < Google::Apis::Core::JsonRepresentation; end
123
129
 
@@ -166,6 +172,12 @@ module Google
166
172
  include Google::Apis::Core::JsonObjectSupport
167
173
  end
168
174
 
175
+ class ListEffectiveTagsResponse
176
+ class Representation < Google::Apis::Core::JsonRepresentation; end
177
+
178
+ include Google::Apis::Core::JsonObjectSupport
179
+ end
180
+
169
181
  class ListFoldersResponse
170
182
  class Representation < Google::Apis::Core::JsonRepresentation; end
171
183
 
@@ -190,6 +202,12 @@ module Google
190
202
  include Google::Apis::Core::JsonObjectSupport
191
203
  end
192
204
 
205
+ class ListTagHoldsResponse
206
+ class Representation < Google::Apis::Core::JsonRepresentation; end
207
+
208
+ include Google::Apis::Core::JsonObjectSupport
209
+ end
210
+
193
211
  class ListTagKeysResponse
194
212
  class Representation < Google::Apis::Core::JsonRepresentation; end
195
213
 
@@ -292,6 +310,12 @@ module Google
292
310
  include Google::Apis::Core::JsonObjectSupport
293
311
  end
294
312
 
313
+ class TagHold
314
+ class Representation < Google::Apis::Core::JsonRepresentation; end
315
+
316
+ include Google::Apis::Core::JsonObjectSupport
317
+ end
318
+
295
319
  class TagKey
296
320
  class Representation < Google::Apis::Core::JsonRepresentation; end
297
321
 
@@ -488,6 +512,17 @@ module Google
488
512
  end
489
513
  end
490
514
 
515
+ class EffectiveTag
516
+ # @private
517
+ class Representation < Google::Apis::Core::JsonRepresentation
518
+ property :inherited, as: 'inherited'
519
+ property :namespaced_tag_key, as: 'namespacedTagKey'
520
+ property :namespaced_tag_value, as: 'namespacedTagValue'
521
+ property :tag_key, as: 'tagKey'
522
+ property :tag_value, as: 'tagValue'
523
+ end
524
+ end
525
+
491
526
  class Empty
492
527
  # @private
493
528
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -562,6 +597,15 @@ module Google
562
597
  end
563
598
  end
564
599
 
600
+ class ListEffectiveTagsResponse
601
+ # @private
602
+ class Representation < Google::Apis::Core::JsonRepresentation
603
+ collection :effective_tags, as: 'effectiveTags', class: Google::Apis::CloudresourcemanagerV3::EffectiveTag, decorator: Google::Apis::CloudresourcemanagerV3::EffectiveTag::Representation
604
+
605
+ property :next_page_token, as: 'nextPageToken'
606
+ end
607
+ end
608
+
565
609
  class ListFoldersResponse
566
610
  # @private
567
611
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -598,6 +642,15 @@ module Google
598
642
  end
599
643
  end
600
644
 
645
+ class ListTagHoldsResponse
646
+ # @private
647
+ class Representation < Google::Apis::Core::JsonRepresentation
648
+ property :next_page_token, as: 'nextPageToken'
649
+ collection :tag_holds, as: 'tagHolds', class: Google::Apis::CloudresourcemanagerV3::TagHold, decorator: Google::Apis::CloudresourcemanagerV3::TagHold::Representation
650
+
651
+ end
652
+ end
653
+
601
654
  class ListTagKeysResponse
602
655
  # @private
603
656
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -762,6 +815,17 @@ module Google
762
815
  end
763
816
  end
764
817
 
818
+ class TagHold
819
+ # @private
820
+ class Representation < Google::Apis::Core::JsonRepresentation
821
+ property :create_time, as: 'createTime'
822
+ property :help_link, as: 'helpLink'
823
+ property :holder, as: 'holder'
824
+ property :name, as: 'name'
825
+ property :origin, as: 'origin'
826
+ end
827
+ end
828
+
765
829
  class TagKey
766
830
  # @private
767
831
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -50,6 +50,47 @@ module Google
50
50
  @batch_path = 'batch'
51
51
  end
52
52
 
53
+ # Return a list of effective tags for the given cloud resource, as specified in `
54
+ # parent`.
55
+ # @param [Fixnum] page_size
56
+ # Optional. The maximum number of effective tags to return in the response. The
57
+ # server allows a maximum of 300 effective tags to return in a single page. If
58
+ # unspecified, the server will use 100 as the default.
59
+ # @param [String] page_token
60
+ # Optional. A pagination token returned from a previous call to `
61
+ # ListEffectiveTags` that indicates from where this listing should continue.
62
+ # @param [String] parent
63
+ # Required. The full resource name of a resource for which you want to list the
64
+ # effective tags. E.g. "//cloudresourcemanager.googleapis.com/projects/123"
65
+ # @param [String] fields
66
+ # Selector specifying which fields to include in a partial response.
67
+ # @param [String] quota_user
68
+ # Available to use for quota purposes for server-side applications. Can be any
69
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
70
+ # @param [Google::Apis::RequestOptions] options
71
+ # Request-specific options
72
+ #
73
+ # @yield [result, err] Result & error if block supplied
74
+ # @yieldparam result [Google::Apis::CloudresourcemanagerV3::ListEffectiveTagsResponse] parsed result object
75
+ # @yieldparam err [StandardError] error object if request failed
76
+ #
77
+ # @return [Google::Apis::CloudresourcemanagerV3::ListEffectiveTagsResponse]
78
+ #
79
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
80
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
81
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
82
+ def list_effective_tags(page_size: nil, page_token: nil, parent: nil, fields: nil, quota_user: nil, options: nil, &block)
83
+ command = make_simple_command(:get, 'v3/effectiveTags', options)
84
+ command.response_representation = Google::Apis::CloudresourcemanagerV3::ListEffectiveTagsResponse::Representation
85
+ command.response_class = Google::Apis::CloudresourcemanagerV3::ListEffectiveTagsResponse
86
+ command.query['pageSize'] = page_size unless page_size.nil?
87
+ command.query['pageToken'] = page_token unless page_token.nil?
88
+ command.query['parent'] = parent unless parent.nil?
89
+ command.query['fields'] = fields unless fields.nil?
90
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
91
+ execute_or_queue_command(command, &block)
92
+ end
93
+
53
94
  # Creates a folder in the resource hierarchy. Returns an `Operation` which can
54
95
  # be used to track the progress of the folder creation workflow. Upon success,
55
96
  # the `Operation.response` field will be populated with the created Folder. In
@@ -172,8 +213,9 @@ module Google
172
213
  # folder's resource name, for example: "folders/1234". The caller must have `
173
214
  # resourcemanager.folders.getIamPolicy` permission on the identified folder.
174
215
  # @param [String] resource
175
- # REQUIRED: The resource for which the policy is being requested. See the
176
- # operation documentation for the appropriate value for this field.
216
+ # REQUIRED: The resource for which the policy is being requested. See [Resource
217
+ # names](https://cloud.google.com/apis/design/resource_names) for the
218
+ # appropriate value for this field.
177
219
  # @param [Google::Apis::CloudresourcemanagerV3::GetIamPolicyRequest] get_iam_policy_request_object
178
220
  # @param [String] fields
179
221
  # Selector specifying which fields to include in a partial response.
@@ -409,8 +451,9 @@ module Google
409
451
  # 1234". The caller must have `resourcemanager.folders.setIamPolicy` permission
410
452
  # on the identified folder.
411
453
  # @param [String] resource
412
- # REQUIRED: The resource for which the policy is being specified. See the
413
- # operation documentation for the appropriate value for this field.
454
+ # REQUIRED: The resource for which the policy is being specified. See [Resource
455
+ # names](https://cloud.google.com/apis/design/resource_names) for the
456
+ # appropriate value for this field.
414
457
  # @param [Google::Apis::CloudresourcemanagerV3::SetIamPolicyRequest] set_iam_policy_request_object
415
458
  # @param [String] fields
416
459
  # Selector specifying which fields to include in a partial response.
@@ -445,8 +488,9 @@ module Google
445
488
  # field should be the folder's resource name, for example: "folders/1234". There
446
489
  # are no permissions required for making this API call.
447
490
  # @param [String] resource
448
- # REQUIRED: The resource for which the policy detail is being requested. See the
449
- # operation documentation for the appropriate value for this field.
491
+ # REQUIRED: The resource for which the policy detail is being requested. See [
492
+ # Resource names](https://cloud.google.com/apis/design/resource_names) for the
493
+ # appropriate value for this field.
450
494
  # @param [Google::Apis::CloudresourcemanagerV3::TestIamPermissionsRequest] test_iam_permissions_request_object
451
495
  # @param [String] fields
452
496
  # Selector specifying which fields to include in a partial response.
@@ -727,8 +771,9 @@ module Google
727
771
  # requires the IAM permission `resourcemanager.organizations.getIamPolicy` on
728
772
  # the specified organization.
729
773
  # @param [String] resource
730
- # REQUIRED: The resource for which the policy is being requested. See the
731
- # operation documentation for the appropriate value for this field.
774
+ # REQUIRED: The resource for which the policy is being requested. See [Resource
775
+ # names](https://cloud.google.com/apis/design/resource_names) for the
776
+ # appropriate value for this field.
732
777
  # @param [Google::Apis::CloudresourcemanagerV3::GetIamPolicyRequest] get_iam_policy_request_object
733
778
  # @param [String] fields
734
779
  # Selector specifying which fields to include in a partial response.
@@ -817,8 +862,9 @@ module Google
817
862
  # permission `resourcemanager.organizations.setIamPolicy` on the specified
818
863
  # organization.
819
864
  # @param [String] resource
820
- # REQUIRED: The resource for which the policy is being specified. See the
821
- # operation documentation for the appropriate value for this field.
865
+ # REQUIRED: The resource for which the policy is being specified. See [Resource
866
+ # names](https://cloud.google.com/apis/design/resource_names) for the
867
+ # appropriate value for this field.
822
868
  # @param [Google::Apis::CloudresourcemanagerV3::SetIamPolicyRequest] set_iam_policy_request_object
823
869
  # @param [String] fields
824
870
  # Selector specifying which fields to include in a partial response.
@@ -853,8 +899,9 @@ module Google
853
899
  # resource` field should be the organization's resource name, for example: "
854
900
  # organizations/123". There are no permissions required for making this API call.
855
901
  # @param [String] resource
856
- # REQUIRED: The resource for which the policy detail is being requested. See the
857
- # operation documentation for the appropriate value for this field.
902
+ # REQUIRED: The resource for which the policy detail is being requested. See [
903
+ # Resource names](https://cloud.google.com/apis/design/resource_names) for the
904
+ # appropriate value for this field.
858
905
  # @param [Google::Apis::CloudresourcemanagerV3::TestIamPermissionsRequest] test_iam_permissions_request_object
859
906
  # @param [String] fields
860
907
  # Selector specifying which fields to include in a partial response.
@@ -996,8 +1043,9 @@ module Google
996
1043
  # `projects/`ProjectIdOrNumber`` e.g. projects/123. Permission is denied if the
997
1044
  # policy or the resource do not exist.
998
1045
  # @param [String] resource
999
- # REQUIRED: The resource for which the policy is being requested. See the
1000
- # operation documentation for the appropriate value for this field.
1046
+ # REQUIRED: The resource for which the policy is being requested. See [Resource
1047
+ # names](https://cloud.google.com/apis/design/resource_names) for the
1048
+ # appropriate value for this field.
1001
1049
  # @param [Google::Apis::CloudresourcemanagerV3::GetIamPolicyRequest] get_iam_policy_request_object
1002
1050
  # @param [String] fields
1003
1051
  # Selector specifying which fields to include in a partial response.
@@ -1252,8 +1300,9 @@ module Google
1252
1300
  # organization inaccessible. + Calling this method requires enabling the App
1253
1301
  # Engine Admin API.
1254
1302
  # @param [String] resource
1255
- # REQUIRED: The resource for which the policy is being specified. See the
1256
- # operation documentation for the appropriate value for this field.
1303
+ # REQUIRED: The resource for which the policy is being specified. See [Resource
1304
+ # names](https://cloud.google.com/apis/design/resource_names) for the
1305
+ # appropriate value for this field.
1257
1306
  # @param [Google::Apis::CloudresourcemanagerV3::SetIamPolicyRequest] set_iam_policy_request_object
1258
1307
  # @param [String] fields
1259
1308
  # Selector specifying which fields to include in a partial response.
@@ -1287,8 +1336,9 @@ module Google
1287
1336
  # Returns permissions that a caller has on the specified project, in the format `
1288
1337
  # projects/`ProjectIdOrNumber`` e.g. projects/123..
1289
1338
  # @param [String] resource
1290
- # REQUIRED: The resource for which the policy detail is being requested. See the
1291
- # operation documentation for the appropriate value for this field.
1339
+ # REQUIRED: The resource for which the policy detail is being requested. See [
1340
+ # Resource names](https://cloud.google.com/apis/design/resource_names) for the
1341
+ # appropriate value for this field.
1292
1342
  # @param [Google::Apis::CloudresourcemanagerV3::TestIamPermissionsRequest] test_iam_permissions_request_object
1293
1343
  # @param [String] fields
1294
1344
  # Selector specifying which fields to include in a partial response.
@@ -1581,8 +1631,9 @@ module Google
1581
1631
  # cloudresourcemanager.googleapis.com/tagKeys.getIamPolicy` permission on the
1582
1632
  # specified TagKey.
1583
1633
  # @param [String] resource
1584
- # REQUIRED: The resource for which the policy is being requested. See the
1585
- # operation documentation for the appropriate value for this field.
1634
+ # REQUIRED: The resource for which the policy is being requested. See [Resource
1635
+ # names](https://cloud.google.com/apis/design/resource_names) for the
1636
+ # appropriate value for this field.
1586
1637
  # @param [Google::Apis::CloudresourcemanagerV3::GetIamPolicyRequest] get_iam_policy_request_object
1587
1638
  # @param [String] fields
1588
1639
  # Selector specifying which fields to include in a partial response.
@@ -1700,8 +1751,9 @@ module Google
1700
1751
  # 1234". The caller must have `resourcemanager.tagKeys.setIamPolicy` permission
1701
1752
  # on the identified tagValue.
1702
1753
  # @param [String] resource
1703
- # REQUIRED: The resource for which the policy is being specified. See the
1704
- # operation documentation for the appropriate value for this field.
1754
+ # REQUIRED: The resource for which the policy is being specified. See [Resource
1755
+ # names](https://cloud.google.com/apis/design/resource_names) for the
1756
+ # appropriate value for this field.
1705
1757
  # @param [Google::Apis::CloudresourcemanagerV3::SetIamPolicyRequest] set_iam_policy_request_object
1706
1758
  # @param [String] fields
1707
1759
  # Selector specifying which fields to include in a partial response.
@@ -1736,8 +1788,9 @@ module Google
1736
1788
  # field should be the TagKey's resource name. For example, "tagKeys/1234". There
1737
1789
  # are no permissions required for making this API call.
1738
1790
  # @param [String] resource
1739
- # REQUIRED: The resource for which the policy detail is being requested. See the
1740
- # operation documentation for the appropriate value for this field.
1791
+ # REQUIRED: The resource for which the policy detail is being requested. See [
1792
+ # Resource names](https://cloud.google.com/apis/design/resource_names) for the
1793
+ # appropriate value for this field.
1741
1794
  # @param [Google::Apis::CloudresourcemanagerV3::TestIamPermissionsRequest] test_iam_permissions_request_object
1742
1795
  # @param [String] fields
1743
1796
  # Selector specifying which fields to include in a partial response.
@@ -1882,8 +1935,9 @@ module Google
1882
1935
  # the `cloudresourcemanager.googleapis.com/tagValues.getIamPolicy` permission on
1883
1936
  # the identified TagValue to get the access control policy.
1884
1937
  # @param [String] resource
1885
- # REQUIRED: The resource for which the policy is being requested. See the
1886
- # operation documentation for the appropriate value for this field.
1938
+ # REQUIRED: The resource for which the policy is being requested. See [Resource
1939
+ # names](https://cloud.google.com/apis/design/resource_names) for the
1940
+ # appropriate value for this field.
1887
1941
  # @param [Google::Apis::CloudresourcemanagerV3::GetIamPolicyRequest] get_iam_policy_request_object
1888
1942
  # @param [String] fields
1889
1943
  # Selector specifying which fields to include in a partial response.
@@ -1999,8 +2053,9 @@ module Google
1999
2053
  # tagValues/1234`. The caller must have `resourcemanager.tagValues.setIamPolicy`
2000
2054
  # permission on the identified tagValue.
2001
2055
  # @param [String] resource
2002
- # REQUIRED: The resource for which the policy is being specified. See the
2003
- # operation documentation for the appropriate value for this field.
2056
+ # REQUIRED: The resource for which the policy is being specified. See [Resource
2057
+ # names](https://cloud.google.com/apis/design/resource_names) for the
2058
+ # appropriate value for this field.
2004
2059
  # @param [Google::Apis::CloudresourcemanagerV3::SetIamPolicyRequest] set_iam_policy_request_object
2005
2060
  # @param [String] fields
2006
2061
  # Selector specifying which fields to include in a partial response.
@@ -2035,8 +2090,9 @@ module Google
2035
2090
  # field should be the TagValue's resource name. For example: `tagValues/1234`.
2036
2091
  # There are no permissions required for making this API call.
2037
2092
  # @param [String] resource
2038
- # REQUIRED: The resource for which the policy detail is being requested. See the
2039
- # operation documentation for the appropriate value for this field.
2093
+ # REQUIRED: The resource for which the policy detail is being requested. See [
2094
+ # Resource names](https://cloud.google.com/apis/design/resource_names) for the
2095
+ # appropriate value for this field.
2040
2096
  # @param [Google::Apis::CloudresourcemanagerV3::TestIamPermissionsRequest] test_iam_permissions_request_object
2041
2097
  # @param [String] fields
2042
2098
  # Selector specifying which fields to include in a partial response.
@@ -2066,6 +2122,130 @@ module Google
2066
2122
  command.query['quotaUser'] = quota_user unless quota_user.nil?
2067
2123
  execute_or_queue_command(command, &block)
2068
2124
  end
2125
+
2126
+ # Creates a TagHold. Returns ALREADY_EXISTS if a TagHold with the same resource
2127
+ # and origin exists under the same TagValue.
2128
+ # @param [String] parent
2129
+ # Required. The resource name of the TagHold's parent TagValue. Must be of the
2130
+ # form: `tagValues/`tag-value-id``.
2131
+ # @param [Google::Apis::CloudresourcemanagerV3::TagHold] tag_hold_object
2132
+ # @param [Boolean] validate_only
2133
+ # Optional. Set to true to perform the validations necessary for creating the
2134
+ # resource, but not actually perform the action.
2135
+ # @param [String] fields
2136
+ # Selector specifying which fields to include in a partial response.
2137
+ # @param [String] quota_user
2138
+ # Available to use for quota purposes for server-side applications. Can be any
2139
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2140
+ # @param [Google::Apis::RequestOptions] options
2141
+ # Request-specific options
2142
+ #
2143
+ # @yield [result, err] Result & error if block supplied
2144
+ # @yieldparam result [Google::Apis::CloudresourcemanagerV3::Operation] parsed result object
2145
+ # @yieldparam err [StandardError] error object if request failed
2146
+ #
2147
+ # @return [Google::Apis::CloudresourcemanagerV3::Operation]
2148
+ #
2149
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2150
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2151
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2152
+ def create_tag_value_tag_hold(parent, tag_hold_object = nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
2153
+ command = make_simple_command(:post, 'v3/{+parent}/tagHolds', options)
2154
+ command.request_representation = Google::Apis::CloudresourcemanagerV3::TagHold::Representation
2155
+ command.request_object = tag_hold_object
2156
+ command.response_representation = Google::Apis::CloudresourcemanagerV3::Operation::Representation
2157
+ command.response_class = Google::Apis::CloudresourcemanagerV3::Operation
2158
+ command.params['parent'] = parent unless parent.nil?
2159
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
2160
+ command.query['fields'] = fields unless fields.nil?
2161
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2162
+ execute_or_queue_command(command, &block)
2163
+ end
2164
+
2165
+ # Deletes a TagHold.
2166
+ # @param [String] name
2167
+ # Required. The resource name of the TagHold to delete. Must be of the form: `
2168
+ # tagValues/`tag-value-id`/tagHolds/`tag-hold-id``.
2169
+ # @param [Boolean] validate_only
2170
+ # Optional. Set to true to perform the validations necessary for deleting the
2171
+ # resource, but not actually perform the action.
2172
+ # @param [String] fields
2173
+ # Selector specifying which fields to include in a partial response.
2174
+ # @param [String] quota_user
2175
+ # Available to use for quota purposes for server-side applications. Can be any
2176
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2177
+ # @param [Google::Apis::RequestOptions] options
2178
+ # Request-specific options
2179
+ #
2180
+ # @yield [result, err] Result & error if block supplied
2181
+ # @yieldparam result [Google::Apis::CloudresourcemanagerV3::Operation] parsed result object
2182
+ # @yieldparam err [StandardError] error object if request failed
2183
+ #
2184
+ # @return [Google::Apis::CloudresourcemanagerV3::Operation]
2185
+ #
2186
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2187
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2188
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2189
+ def delete_tag_value_tag_hold(name, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
2190
+ command = make_simple_command(:delete, 'v3/{+name}', options)
2191
+ command.response_representation = Google::Apis::CloudresourcemanagerV3::Operation::Representation
2192
+ command.response_class = Google::Apis::CloudresourcemanagerV3::Operation
2193
+ command.params['name'] = name unless name.nil?
2194
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
2195
+ command.query['fields'] = fields unless fields.nil?
2196
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2197
+ execute_or_queue_command(command, &block)
2198
+ end
2199
+
2200
+ # Lists TagHolds under a TagValue.
2201
+ # @param [String] parent
2202
+ # Required. The resource name of the parent TagValue. Must be of the form: `
2203
+ # tagValues/`tag-value-id``.
2204
+ # @param [String] filter
2205
+ # Optional. Criteria used to select a subset of TagHolds parented by the
2206
+ # TagValue to return. This field follows the syntax defined by aip.dev/160; the `
2207
+ # holder` and `origin` fields are supported for filtering. Currently only `AND`
2208
+ # syntax is supported. Some example queries are: * `holder = //compute.
2209
+ # googleapis.com/compute/projects/myproject/regions/us-east-1/
2210
+ # instanceGroupManagers/instance-group` * `origin = 35678234` * `holder = //
2211
+ # compute.googleapis.com/compute/projects/myproject/regions/us-east-1/
2212
+ # instanceGroupManagers/instance-group AND origin = 35678234`
2213
+ # @param [Fixnum] page_size
2214
+ # Optional. The maximum number of TagHolds to return in the response. The server
2215
+ # allows a maximum of 300 TagHolds to return. If unspecified, the server will
2216
+ # use 100 as the default.
2217
+ # @param [String] page_token
2218
+ # Optional. A pagination token returned from a previous call to `ListTagHolds`
2219
+ # that indicates where this listing should continue from.
2220
+ # @param [String] fields
2221
+ # Selector specifying which fields to include in a partial response.
2222
+ # @param [String] quota_user
2223
+ # Available to use for quota purposes for server-side applications. Can be any
2224
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2225
+ # @param [Google::Apis::RequestOptions] options
2226
+ # Request-specific options
2227
+ #
2228
+ # @yield [result, err] Result & error if block supplied
2229
+ # @yieldparam result [Google::Apis::CloudresourcemanagerV3::ListTagHoldsResponse] parsed result object
2230
+ # @yieldparam err [StandardError] error object if request failed
2231
+ #
2232
+ # @return [Google::Apis::CloudresourcemanagerV3::ListTagHoldsResponse]
2233
+ #
2234
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2235
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2236
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2237
+ def list_tag_value_tag_holds(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
2238
+ command = make_simple_command(:get, 'v3/{+parent}/tagHolds', options)
2239
+ command.response_representation = Google::Apis::CloudresourcemanagerV3::ListTagHoldsResponse::Representation
2240
+ command.response_class = Google::Apis::CloudresourcemanagerV3::ListTagHoldsResponse
2241
+ command.params['parent'] = parent unless parent.nil?
2242
+ command.query['filter'] = filter unless filter.nil?
2243
+ command.query['pageSize'] = page_size unless page_size.nil?
2244
+ command.query['pageToken'] = page_token unless page_token.nil?
2245
+ command.query['fields'] = fields unless fields.nil?
2246
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2247
+ execute_or_queue_command(command, &block)
2248
+ end
2069
2249
 
2070
2250
  protected
2071
2251
 
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-apis-cloudresourcemanager_v3
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.23.0
4
+ version: 0.26.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2022-03-28 00:00:00.000000000 Z
11
+ date: 2022-05-09 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: google-apis-core
@@ -58,7 +58,7 @@ licenses:
58
58
  metadata:
59
59
  bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
60
60
  changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-cloudresourcemanager_v3/CHANGELOG.md
61
- documentation_uri: https://googleapis.dev/ruby/google-apis-cloudresourcemanager_v3/v0.23.0
61
+ documentation_uri: https://googleapis.dev/ruby/google-apis-cloudresourcemanager_v3/v0.26.0
62
62
  source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-cloudresourcemanager_v3
63
63
  post_install_message:
64
64
  rdoc_options: []