google-apis-cloudresourcemanager_v3 0.23.0 → 0.26.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
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: []