google-cloud-artifact_registry-v1 1.0.1 → 1.2.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (32) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +30 -20
  3. data/lib/google/cloud/artifact_registry/v1/artifact_registry/client.rb +1794 -333
  4. data/lib/google/cloud/artifact_registry/v1/artifact_registry/operations.rb +12 -15
  5. data/lib/google/cloud/artifact_registry/v1/artifact_registry/paths.rb +42 -0
  6. data/lib/google/cloud/artifact_registry/v1/artifact_registry/rest/client.rb +1680 -310
  7. data/lib/google/cloud/artifact_registry/v1/artifact_registry/rest/operations.rb +43 -38
  8. data/lib/google/cloud/artifact_registry/v1/artifact_registry/rest/service_stub.rb +1106 -223
  9. data/lib/google/cloud/artifact_registry/v1/version.rb +1 -1
  10. data/lib/google/devtools/artifactregistry/v1/attachment_pb.rb +52 -0
  11. data/lib/google/devtools/artifactregistry/v1/file_pb.rb +5 -1
  12. data/lib/google/devtools/artifactregistry/v1/generic_pb.rb +47 -0
  13. data/lib/google/devtools/artifactregistry/v1/package_pb.rb +4 -1
  14. data/lib/google/devtools/artifactregistry/v1/repository_pb.rb +11 -1
  15. data/lib/google/devtools/artifactregistry/v1/rule_pb.rb +57 -0
  16. data/lib/google/devtools/artifactregistry/v1/service_pb.rb +3 -1
  17. data/lib/google/devtools/artifactregistry/v1/service_services_pb.rb +31 -0
  18. data/lib/google/devtools/artifactregistry/v1/settings_pb.rb +1 -1
  19. data/lib/google/devtools/artifactregistry/v1/version_pb.rb +4 -1
  20. data/proto_docs/google/api/client.rb +39 -0
  21. data/proto_docs/google/devtools/artifactregistry/v1/artifact.rb +4 -4
  22. data/proto_docs/google/devtools/artifactregistry/v1/attachment.rb +152 -0
  23. data/proto_docs/google/devtools/artifactregistry/v1/file.rb +80 -7
  24. data/proto_docs/google/devtools/artifactregistry/v1/generic.rb +48 -0
  25. data/proto_docs/google/devtools/artifactregistry/v1/package.rb +76 -0
  26. data/proto_docs/google/devtools/artifactregistry/v1/repository.rb +188 -1
  27. data/proto_docs/google/devtools/artifactregistry/v1/rule.rb +149 -0
  28. data/proto_docs/google/devtools/artifactregistry/v1/settings.rb +10 -0
  29. data/proto_docs/google/devtools/artifactregistry/v1/tag.rb +23 -5
  30. data/proto_docs/google/devtools/artifactregistry/v1/version.rb +74 -1
  31. data/proto_docs/google/longrunning/operations.rb +19 -14
  32. metadata +11 -5
@@ -179,14 +179,26 @@ module Google
179
179
  universe_domain: @config.universe_domain,
180
180
  channel_args: @config.channel_args,
181
181
  interceptors: @config.interceptors,
182
- channel_pool_config: @config.channel_pool
182
+ channel_pool_config: @config.channel_pool,
183
+ logger: @config.logger
183
184
  )
184
185
 
186
+ @artifact_registry_stub.stub_logger&.info do |entry|
187
+ entry.set_system_name
188
+ entry.set_service
189
+ entry.message = "Created client for #{entry.service}"
190
+ entry.set_credentials_fields credentials
191
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
192
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
193
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
194
+ end
195
+
185
196
  @location_client = Google::Cloud::Location::Locations::Client.new do |config|
186
197
  config.credentials = credentials
187
198
  config.quota_project = @quota_project_id
188
199
  config.endpoint = @artifact_registry_stub.endpoint
189
200
  config.universe_domain = @artifact_registry_stub.universe_domain
201
+ config.logger = @artifact_registry_stub.logger if config.respond_to? :logger=
190
202
  end
191
203
  end
192
204
 
@@ -204,6 +216,15 @@ module Google
204
216
  #
205
217
  attr_reader :location_client
206
218
 
219
+ ##
220
+ # The logger used for request/response debug logging.
221
+ #
222
+ # @return [Logger]
223
+ #
224
+ def logger
225
+ @artifact_registry_stub.logger
226
+ end
227
+
207
228
  # Service calls
208
229
 
209
230
  ##
@@ -228,7 +249,7 @@ module Google
228
249
  # Required. The name of the parent resource whose docker images will be
229
250
  # listed.
230
251
  # @param page_size [::Integer]
231
- # The maximum number of artifacts to return.
252
+ # The maximum number of artifacts to return. Maximum page size is 1,000.
232
253
  # @param page_token [::String]
233
254
  # The next_page_token value returned from a previous list request, if any.
234
255
  # @param order_by [::String]
@@ -298,7 +319,7 @@ module Google
298
319
  @artifact_registry_stub.call_rpc :list_docker_images, request, options: options do |response, operation|
299
320
  response = ::Gapic::PagedEnumerable.new @artifact_registry_stub, :list_docker_images, request, response, operation, options
300
321
  yield response, operation if block_given?
301
- return response
322
+ throw :response, response
302
323
  end
303
324
  rescue ::GRPC::BadStatus => e
304
325
  raise ::Google::Cloud::Error.from_error(e)
@@ -384,7 +405,6 @@ module Google
384
405
 
385
406
  @artifact_registry_stub.call_rpc :get_docker_image, request, options: options do |response, operation|
386
407
  yield response, operation if block_given?
387
- return response
388
408
  end
389
409
  rescue ::GRPC::BadStatus => e
390
410
  raise ::Google::Cloud::Error.from_error(e)
@@ -412,7 +432,7 @@ module Google
412
432
  # Required. The name of the parent resource whose maven artifacts will be
413
433
  # listed.
414
434
  # @param page_size [::Integer]
415
- # The maximum number of artifacts to return.
435
+ # The maximum number of artifacts to return. Maximum page size is 1,000.
416
436
  # @param page_token [::String]
417
437
  # The next_page_token value returned from a previous list request, if any.
418
438
  #
@@ -480,7 +500,7 @@ module Google
480
500
  @artifact_registry_stub.call_rpc :list_maven_artifacts, request, options: options do |response, operation|
481
501
  response = ::Gapic::PagedEnumerable.new @artifact_registry_stub, :list_maven_artifacts, request, response, operation, options
482
502
  yield response, operation if block_given?
483
- return response
503
+ throw :response, response
484
504
  end
485
505
  rescue ::GRPC::BadStatus => e
486
506
  raise ::Google::Cloud::Error.from_error(e)
@@ -566,7 +586,6 @@ module Google
566
586
 
567
587
  @artifact_registry_stub.call_rpc :get_maven_artifact, request, options: options do |response, operation|
568
588
  yield response, operation if block_given?
569
- return response
570
589
  end
571
590
  rescue ::GRPC::BadStatus => e
572
591
  raise ::Google::Cloud::Error.from_error(e)
@@ -594,7 +613,7 @@ module Google
594
613
  # Required. The name of the parent resource whose npm packages will be
595
614
  # listed.
596
615
  # @param page_size [::Integer]
597
- # The maximum number of artifacts to return.
616
+ # The maximum number of artifacts to return. Maximum page size is 1,000.
598
617
  # @param page_token [::String]
599
618
  # The next_page_token value returned from a previous list request, if any.
600
619
  #
@@ -662,7 +681,7 @@ module Google
662
681
  @artifact_registry_stub.call_rpc :list_npm_packages, request, options: options do |response, operation|
663
682
  response = ::Gapic::PagedEnumerable.new @artifact_registry_stub, :list_npm_packages, request, response, operation, options
664
683
  yield response, operation if block_given?
665
- return response
684
+ throw :response, response
666
685
  end
667
686
  rescue ::GRPC::BadStatus => e
668
687
  raise ::Google::Cloud::Error.from_error(e)
@@ -748,7 +767,6 @@ module Google
748
767
 
749
768
  @artifact_registry_stub.call_rpc :get_npm_package, request, options: options do |response, operation|
750
769
  yield response, operation if block_given?
751
- return response
752
770
  end
753
771
  rescue ::GRPC::BadStatus => e
754
772
  raise ::Google::Cloud::Error.from_error(e)
@@ -776,7 +794,7 @@ module Google
776
794
  # Required. The name of the parent resource whose python packages will be
777
795
  # listed.
778
796
  # @param page_size [::Integer]
779
- # The maximum number of artifacts to return.
797
+ # The maximum number of artifacts to return. Maximum page size is 1,000.
780
798
  # @param page_token [::String]
781
799
  # The next_page_token value returned from a previous list request, if any.
782
800
  #
@@ -844,7 +862,7 @@ module Google
844
862
  @artifact_registry_stub.call_rpc :list_python_packages, request, options: options do |response, operation|
845
863
  response = ::Gapic::PagedEnumerable.new @artifact_registry_stub, :list_python_packages, request, response, operation, options
846
864
  yield response, operation if block_given?
847
- return response
865
+ throw :response, response
848
866
  end
849
867
  rescue ::GRPC::BadStatus => e
850
868
  raise ::Google::Cloud::Error.from_error(e)
@@ -930,7 +948,6 @@ module Google
930
948
 
931
949
  @artifact_registry_stub.call_rpc :get_python_package, request, options: options do |response, operation|
932
950
  yield response, operation if block_given?
933
- return response
934
951
  end
935
952
  rescue ::GRPC::BadStatus => e
936
953
  raise ::Google::Cloud::Error.from_error(e)
@@ -1029,7 +1046,7 @@ module Google
1029
1046
  @artifact_registry_stub.call_rpc :import_apt_artifacts, request, options: options do |response, operation|
1030
1047
  response = ::Gapic::Operation.new response, @operations_client, options: options
1031
1048
  yield response, operation if block_given?
1032
- return response
1049
+ throw :response, response
1033
1050
  end
1034
1051
  rescue ::GRPC::BadStatus => e
1035
1052
  raise ::Google::Cloud::Error.from_error(e)
@@ -1128,7 +1145,7 @@ module Google
1128
1145
  @artifact_registry_stub.call_rpc :import_yum_artifacts, request, options: options do |response, operation|
1129
1146
  response = ::Gapic::Operation.new response, @operations_client, options: options
1130
1147
  yield response, operation if block_given?
1131
- return response
1148
+ throw :response, response
1132
1149
  end
1133
1150
  rescue ::GRPC::BadStatus => e
1134
1151
  raise ::Google::Cloud::Error.from_error(e)
@@ -1147,7 +1164,7 @@ module Google
1147
1164
  # @param options [::Gapic::CallOptions, ::Hash]
1148
1165
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1149
1166
  #
1150
- # @overload list_repositories(parent: nil, page_size: nil, page_token: nil)
1167
+ # @overload list_repositories(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil)
1151
1168
  # Pass arguments to `list_repositories` via keyword arguments. Note that at
1152
1169
  # least one keyword argument is required. To specify no parameters, or to keep all
1153
1170
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -1159,6 +1176,28 @@ module Google
1159
1176
  # The maximum number of repositories to return. Maximum page size is 1,000.
1160
1177
  # @param page_token [::String]
1161
1178
  # The next_page_token value returned from a previous list request, if any.
1179
+ # @param filter [::String]
1180
+ # Optional. An expression for filtering the results of the request. Filter
1181
+ # rules are case insensitive. The fields eligible for filtering are:
1182
+ #
1183
+ # * `name`
1184
+ #
1185
+ # Examples of using a filter:
1186
+ #
1187
+ # To filter the results of your request to repositories with the name
1188
+ # `my-repo` in project `my-project` in the `us-central` region, append the
1189
+ # following filter expression to your request:
1190
+ #
1191
+ # * `name="projects/my-project/locations/us-central1/repositories/my-repo"`
1192
+ #
1193
+ # You can also use wildcards to match any number of characters before or
1194
+ # after the value:
1195
+ #
1196
+ # * `name="projects/my-project/locations/us-central1/repositories/my-*"`
1197
+ # * `name="projects/my-project/locations/us-central1/repositories/*repo"`
1198
+ # * `name="projects/my-project/locations/us-central1/repositories/*repo*"`
1199
+ # @param order_by [::String]
1200
+ # Optional. The field to order the results by.
1162
1201
  #
1163
1202
  # @yield [response, operation] Access the result along with the RPC operation
1164
1203
  # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::ArtifactRegistry::V1::Repository>]
@@ -1224,7 +1263,7 @@ module Google
1224
1263
  @artifact_registry_stub.call_rpc :list_repositories, request, options: options do |response, operation|
1225
1264
  response = ::Gapic::PagedEnumerable.new @artifact_registry_stub, :list_repositories, request, response, operation, options
1226
1265
  yield response, operation if block_given?
1227
- return response
1266
+ throw :response, response
1228
1267
  end
1229
1268
  rescue ::GRPC::BadStatus => e
1230
1269
  raise ::Google::Cloud::Error.from_error(e)
@@ -1310,7 +1349,6 @@ module Google
1310
1349
 
1311
1350
  @artifact_registry_stub.call_rpc :get_repository, request, options: options do |response, operation|
1312
1351
  yield response, operation if block_given?
1313
- return response
1314
1352
  end
1315
1353
  rescue ::GRPC::BadStatus => e
1316
1354
  raise ::Google::Cloud::Error.from_error(e)
@@ -1410,7 +1448,7 @@ module Google
1410
1448
  @artifact_registry_stub.call_rpc :create_repository, request, options: options do |response, operation|
1411
1449
  response = ::Gapic::Operation.new response, @operations_client, options: options
1412
1450
  yield response, operation if block_given?
1413
- return response
1451
+ throw :response, response
1414
1452
  end
1415
1453
  rescue ::GRPC::BadStatus => e
1416
1454
  raise ::Google::Cloud::Error.from_error(e)
@@ -1500,7 +1538,6 @@ module Google
1500
1538
 
1501
1539
  @artifact_registry_stub.call_rpc :update_repository, request, options: options do |response, operation|
1502
1540
  yield response, operation if block_given?
1503
- return response
1504
1541
  end
1505
1542
  rescue ::GRPC::BadStatus => e
1506
1543
  raise ::Google::Cloud::Error.from_error(e)
@@ -1596,7 +1633,7 @@ module Google
1596
1633
  @artifact_registry_stub.call_rpc :delete_repository, request, options: options do |response, operation|
1597
1634
  response = ::Gapic::Operation.new response, @operations_client, options: options
1598
1635
  yield response, operation if block_given?
1599
- return response
1636
+ throw :response, response
1600
1637
  end
1601
1638
  rescue ::GRPC::BadStatus => e
1602
1639
  raise ::Google::Cloud::Error.from_error(e)
@@ -1615,7 +1652,7 @@ module Google
1615
1652
  # @param options [::Gapic::CallOptions, ::Hash]
1616
1653
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1617
1654
  #
1618
- # @overload list_packages(parent: nil, page_size: nil, page_token: nil)
1655
+ # @overload list_packages(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil)
1619
1656
  # Pass arguments to `list_packages` via keyword arguments. Note that at
1620
1657
  # least one keyword argument is required. To specify no parameters, or to keep all
1621
1658
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -1626,6 +1663,54 @@ module Google
1626
1663
  # The maximum number of packages to return. Maximum page size is 1,000.
1627
1664
  # @param page_token [::String]
1628
1665
  # The next_page_token value returned from a previous list request, if any.
1666
+ # @param filter [::String]
1667
+ # Optional. An expression for filtering the results of the request. Filter
1668
+ # rules are case insensitive. The fields eligible for filtering are:
1669
+ #
1670
+ # * `name`
1671
+ # * `annotations`
1672
+ #
1673
+ # Examples of using a filter:
1674
+ #
1675
+ # To filter the results of your request to packages with the name
1676
+ # `my-package` in project `my-project` in the `us-central` region, in
1677
+ # repository `my-repo`, append the following filter expression to your
1678
+ # request:
1679
+ #
1680
+ # * `name="projects/my-project/locations/us-central1/repositories/my-repo/packages/my-package"`
1681
+ #
1682
+ # You can also use wildcards to match any number of characters before or
1683
+ # after the value:
1684
+ #
1685
+ # * `name="projects/my-project/locations/us-central1/repositories/my-repo/packages/my-*"`
1686
+ # * `name="projects/my-project/locations/us-central1/repositories/my-repo/packages/*package"`
1687
+ # * `name="projects/my-project/locations/us-central1/repositories/my-repo/packages/*pack*"`
1688
+ #
1689
+ # To filter the results of your request to packages with the annotation
1690
+ # key-value pair [`external_link`: `external_link_value`], append the
1691
+ # following filter expression to your request":
1692
+ #
1693
+ # * `"annotations.external_link:external_link_value"`
1694
+ #
1695
+ # To filter the results just for a specific annotation key `external_link`,
1696
+ # append the following filter expression to your request:
1697
+ #
1698
+ # * `"annotations.external_link"`
1699
+ #
1700
+ # If the annotation key or value contains special characters, you can escape
1701
+ # them by surrounding the value with backticks. For example, to filter the
1702
+ # results of your request to packages with the annotation key-value pair
1703
+ # [`external.link`:`https://example.com/my-package`], append the following
1704
+ # filter expression to your request:
1705
+ #
1706
+ # * `` "annotations.`external.link`:`https://example.com/my-package`" ``
1707
+ #
1708
+ # You can also filter with annotations with a wildcard to
1709
+ # match any number of characters before or after the value:
1710
+ #
1711
+ # * `` "annotations.*_link:`*example.com*`" ``
1712
+ # @param order_by [::String]
1713
+ # Optional. The field to order the results by.
1629
1714
  #
1630
1715
  # @yield [response, operation] Access the result along with the RPC operation
1631
1716
  # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::ArtifactRegistry::V1::Package>]
@@ -1691,7 +1776,7 @@ module Google
1691
1776
  @artifact_registry_stub.call_rpc :list_packages, request, options: options do |response, operation|
1692
1777
  response = ::Gapic::PagedEnumerable.new @artifact_registry_stub, :list_packages, request, response, operation, options
1693
1778
  yield response, operation if block_given?
1694
- return response
1779
+ throw :response, response
1695
1780
  end
1696
1781
  rescue ::GRPC::BadStatus => e
1697
1782
  raise ::Google::Cloud::Error.from_error(e)
@@ -1777,7 +1862,6 @@ module Google
1777
1862
 
1778
1863
  @artifact_registry_stub.call_rpc :get_package, request, options: options do |response, operation|
1779
1864
  yield response, operation if block_given?
1780
- return response
1781
1865
  end
1782
1866
  rescue ::GRPC::BadStatus => e
1783
1867
  raise ::Google::Cloud::Error.from_error(e)
@@ -1872,7 +1956,7 @@ module Google
1872
1956
  @artifact_registry_stub.call_rpc :delete_package, request, options: options do |response, operation|
1873
1957
  response = ::Gapic::Operation.new response, @operations_client, options: options
1874
1958
  yield response, operation if block_given?
1875
- return response
1959
+ throw :response, response
1876
1960
  end
1877
1961
  rescue ::GRPC::BadStatus => e
1878
1962
  raise ::Google::Cloud::Error.from_error(e)
@@ -1891,7 +1975,7 @@ module Google
1891
1975
  # @param options [::Gapic::CallOptions, ::Hash]
1892
1976
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1893
1977
  #
1894
- # @overload list_versions(parent: nil, page_size: nil, page_token: nil, view: nil, order_by: nil)
1978
+ # @overload list_versions(parent: nil, page_size: nil, page_token: nil, view: nil, order_by: nil, filter: nil)
1895
1979
  # Pass arguments to `list_versions` via keyword arguments. Note that at
1896
1980
  # least one keyword argument is required. To specify no parameters, or to keep all
1897
1981
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -1906,6 +1990,52 @@ module Google
1906
1990
  # The view that should be returned in the response.
1907
1991
  # @param order_by [::String]
1908
1992
  # Optional. The field to order the results by.
1993
+ # @param filter [::String]
1994
+ # Optional. An expression for filtering the results of the request. Filter
1995
+ # rules are case insensitive. The fields eligible for filtering are:
1996
+ #
1997
+ # * `name`
1998
+ # * `annotations`
1999
+ #
2000
+ # Examples of using a filter:
2001
+ #
2002
+ # To filter the results of your request to versions with the name
2003
+ # `my-version` in project `my-project` in the `us-central` region, in
2004
+ # repository `my-repo`, append the following filter expression to your
2005
+ # request:
2006
+ #
2007
+ # * `name="projects/my-project/locations/us-central1/repositories/my-repo/packages/my-package/versions/my-version"`
2008
+ #
2009
+ # You can also use wildcards to match any number of characters before or
2010
+ # after the value:
2011
+ #
2012
+ # * `name="projects/my-project/locations/us-central1/repositories/my-repo/packages/my-package/versions/*version"`
2013
+ # * `name="projects/my-project/locations/us-central1/repositories/my-repo/packages/my-package/versions/my*"`
2014
+ # * `name="projects/my-project/locations/us-central1/repositories/my-repo/packages/my-package/versions/*version*"`
2015
+ #
2016
+ # To filter the results of your request to versions with the annotation
2017
+ # key-value pair [`external_link`: `external_link_value`], append the
2018
+ # following filter expression to your request:
2019
+ #
2020
+ # * `"annotations.external_link:external_link_value"`
2021
+ #
2022
+ # To filter just for a specific annotation key `external_link`, append the
2023
+ # following filter expression to your request:
2024
+ #
2025
+ # * `"annotations.external_link"`
2026
+ #
2027
+ # If the annotation key or value contains special characters, you can escape
2028
+ # them by surrounding the value with backticks. For example, to filter the
2029
+ # results of your request to versions with the annotation key-value pair
2030
+ # [`external.link`:`https://example.com/my-version`], append the following
2031
+ # filter expression to your request:
2032
+ #
2033
+ # * `` "annotations.`external.link`:`https://example.com/my-version`" ``
2034
+ #
2035
+ # You can also filter with annotations with a wildcard to
2036
+ # match any number of characters before or after the value:
2037
+ #
2038
+ # * `` "annotations.*_link:`*example.com*`" ``
1909
2039
  #
1910
2040
  # @yield [response, operation] Access the result along with the RPC operation
1911
2041
  # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::ArtifactRegistry::V1::Version>]
@@ -1971,7 +2101,7 @@ module Google
1971
2101
  @artifact_registry_stub.call_rpc :list_versions, request, options: options do |response, operation|
1972
2102
  response = ::Gapic::PagedEnumerable.new @artifact_registry_stub, :list_versions, request, response, operation, options
1973
2103
  yield response, operation if block_given?
1974
- return response
2104
+ throw :response, response
1975
2105
  end
1976
2106
  rescue ::GRPC::BadStatus => e
1977
2107
  raise ::Google::Cloud::Error.from_error(e)
@@ -2059,7 +2189,6 @@ module Google
2059
2189
 
2060
2190
  @artifact_registry_stub.call_rpc :get_version, request, options: options do |response, operation|
2061
2191
  yield response, operation if block_given?
2062
- return response
2063
2192
  end
2064
2193
  rescue ::GRPC::BadStatus => e
2065
2194
  raise ::Google::Cloud::Error.from_error(e)
@@ -2157,7 +2286,7 @@ module Google
2157
2286
  @artifact_registry_stub.call_rpc :delete_version, request, options: options do |response, operation|
2158
2287
  response = ::Gapic::Operation.new response, @operations_client, options: options
2159
2288
  yield response, operation if block_given?
2160
- return response
2289
+ throw :response, response
2161
2290
  end
2162
2291
  rescue ::GRPC::BadStatus => e
2163
2292
  raise ::Google::Cloud::Error.from_error(e)
@@ -2257,7 +2386,96 @@ module Google
2257
2386
  @artifact_registry_stub.call_rpc :batch_delete_versions, request, options: options do |response, operation|
2258
2387
  response = ::Gapic::Operation.new response, @operations_client, options: options
2259
2388
  yield response, operation if block_given?
2260
- return response
2389
+ throw :response, response
2390
+ end
2391
+ rescue ::GRPC::BadStatus => e
2392
+ raise ::Google::Cloud::Error.from_error(e)
2393
+ end
2394
+
2395
+ ##
2396
+ # Updates a version.
2397
+ #
2398
+ # @overload update_version(request, options = nil)
2399
+ # Pass arguments to `update_version` via a request object, either of type
2400
+ # {::Google::Cloud::ArtifactRegistry::V1::UpdateVersionRequest} or an equivalent Hash.
2401
+ #
2402
+ # @param request [::Google::Cloud::ArtifactRegistry::V1::UpdateVersionRequest, ::Hash]
2403
+ # A request object representing the call parameters. Required. To specify no
2404
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2405
+ # @param options [::Gapic::CallOptions, ::Hash]
2406
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2407
+ #
2408
+ # @overload update_version(version: nil, update_mask: nil)
2409
+ # Pass arguments to `update_version` via keyword arguments. Note that at
2410
+ # least one keyword argument is required. To specify no parameters, or to keep all
2411
+ # the default parameter values, pass an empty Hash as a request object (see above).
2412
+ #
2413
+ # @param version [::Google::Cloud::ArtifactRegistry::V1::Version, ::Hash]
2414
+ # Required. The Version that replaces the resource on the server.
2415
+ # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
2416
+ # The update mask applies to the resource. For the `FieldMask` definition,
2417
+ # see
2418
+ # https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask
2419
+ #
2420
+ # @yield [response, operation] Access the result along with the RPC operation
2421
+ # @yieldparam response [::Google::Cloud::ArtifactRegistry::V1::Version]
2422
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
2423
+ #
2424
+ # @return [::Google::Cloud::ArtifactRegistry::V1::Version]
2425
+ #
2426
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
2427
+ #
2428
+ # @example Basic example
2429
+ # require "google/cloud/artifact_registry/v1"
2430
+ #
2431
+ # # Create a client object. The client can be reused for multiple calls.
2432
+ # client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Client.new
2433
+ #
2434
+ # # Create a request. To set request fields, pass in keyword arguments.
2435
+ # request = Google::Cloud::ArtifactRegistry::V1::UpdateVersionRequest.new
2436
+ #
2437
+ # # Call the update_version method.
2438
+ # result = client.update_version request
2439
+ #
2440
+ # # The returned object is of type Google::Cloud::ArtifactRegistry::V1::Version.
2441
+ # p result
2442
+ #
2443
+ def update_version request, options = nil
2444
+ raise ::ArgumentError, "request must be provided" if request.nil?
2445
+
2446
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ArtifactRegistry::V1::UpdateVersionRequest
2447
+
2448
+ # Converts hash and nil to an options object
2449
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2450
+
2451
+ # Customize the options with defaults
2452
+ metadata = @config.rpcs.update_version.metadata.to_h
2453
+
2454
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2455
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2456
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2457
+ gapic_version: ::Google::Cloud::ArtifactRegistry::V1::VERSION
2458
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2459
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2460
+
2461
+ header_params = {}
2462
+ if request.version&.name
2463
+ header_params["version.name"] = request.version.name
2464
+ end
2465
+
2466
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
2467
+ metadata[:"x-goog-request-params"] ||= request_params_header
2468
+
2469
+ options.apply_defaults timeout: @config.rpcs.update_version.timeout,
2470
+ metadata: metadata,
2471
+ retry_policy: @config.rpcs.update_version.retry_policy
2472
+
2473
+ options.apply_defaults timeout: @config.timeout,
2474
+ metadata: @config.metadata,
2475
+ retry_policy: @config.retry_policy
2476
+
2477
+ @artifact_registry_stub.call_rpc :update_version, request, options: options do |response, operation|
2478
+ yield response, operation if block_given?
2261
2479
  end
2262
2480
  rescue ::GRPC::BadStatus => e
2263
2481
  raise ::Google::Cloud::Error.from_error(e)
@@ -2290,15 +2508,53 @@ module Google
2290
2508
  #
2291
2509
  # * `name`
2292
2510
  # * `owner`
2511
+ # * `annotations`
2512
+ #
2513
+ # Examples of using a filter:
2514
+ #
2515
+ # To filter the results of your request to files with the name `my_file.txt`
2516
+ # in project `my-project` in the `us-central` region, in repository
2517
+ # `my-repo`, append the following filter expression to your request:
2518
+ #
2519
+ # * `name="projects/my-project/locations/us-central1/repositories/my-repo/files/my-file.txt"`
2520
+ #
2521
+ # You can also use wildcards to match any number of characters before or
2522
+ # after the value:
2523
+ #
2524
+ # * `name="projects/my-project/locations/us-central1/repositories/my-repo/files/my-*"`
2525
+ # * `name="projects/my-project/locations/us-central1/repositories/my-repo/files/*file.txt"`
2526
+ # * `name="projects/my-project/locations/us-central1/repositories/my-repo/files/*file*"`
2527
+ #
2528
+ # To filter the results of your request to files owned by the version `1.0`
2529
+ # in package `pkg1`, append the following filter expression to your request:
2530
+ #
2531
+ # * `owner="projects/my-project/locations/us-central1/repositories/my-repo/packages/my-package/versions/1.0"`
2532
+ #
2533
+ # To filter the results of your request to files with the annotation
2534
+ # key-value pair [`external_link`: `external_link_value`], append the
2535
+ # following filter expression to your request:
2293
2536
  #
2294
- # An example of using a filter:
2537
+ # * `"annotations.external_link:external_link_value"`
2295
2538
  #
2296
- # * `name="projects/p1/locations/us-central1/repositories/repo1/files/a/b/*"` --> Files with an
2297
- # ID starting with "a/b/".
2298
- # * `owner="projects/p1/locations/us-central1/repositories/repo1/packages/pkg1/versions/1.0"` -->
2299
- # Files owned by the version `1.0` in package `pkg1`.
2539
+ # To filter just for a specific annotation key `external_link`, append the
2540
+ # following filter expression to your request:
2541
+ #
2542
+ # * `"annotations.external_link"`
2543
+ #
2544
+ # If the annotation key or value contains special characters, you can escape
2545
+ # them by surrounding the value with backticks. For example, to filter the
2546
+ # results of your request to files with the annotation key-value pair
2547
+ # [`external.link`:`https://example.com/my-file`], append the following
2548
+ # filter expression to your request:
2549
+ #
2550
+ # * `` "annotations.`external.link`:`https://example.com/my-file`" ``
2551
+ #
2552
+ # You can also filter with annotations with a wildcard to
2553
+ # match any number of characters before or after the value:
2554
+ #
2555
+ # * `` "annotations.*_link:`*example.com*`" ``
2300
2556
  # @param page_size [::Integer]
2301
- # The maximum number of files to return.
2557
+ # The maximum number of files to return. Maximum page size is 1,000.
2302
2558
  # @param page_token [::String]
2303
2559
  # The next_page_token value returned from a previous list request, if any.
2304
2560
  # @param order_by [::String]
@@ -2368,7 +2624,7 @@ module Google
2368
2624
  @artifact_registry_stub.call_rpc :list_files, request, options: options do |response, operation|
2369
2625
  response = ::Gapic::PagedEnumerable.new @artifact_registry_stub, :list_files, request, response, operation, options
2370
2626
  yield response, operation if block_given?
2371
- return response
2627
+ throw :response, response
2372
2628
  end
2373
2629
  rescue ::GRPC::BadStatus => e
2374
2630
  raise ::Google::Cloud::Error.from_error(e)
@@ -2454,54 +2710,39 @@ module Google
2454
2710
 
2455
2711
  @artifact_registry_stub.call_rpc :get_file, request, options: options do |response, operation|
2456
2712
  yield response, operation if block_given?
2457
- return response
2458
2713
  end
2459
2714
  rescue ::GRPC::BadStatus => e
2460
2715
  raise ::Google::Cloud::Error.from_error(e)
2461
2716
  end
2462
2717
 
2463
2718
  ##
2464
- # Lists tags.
2719
+ # Deletes a file and all of its content. It is only allowed on generic
2720
+ # repositories. The returned operation will complete once the file has been
2721
+ # deleted.
2465
2722
  #
2466
- # @overload list_tags(request, options = nil)
2467
- # Pass arguments to `list_tags` via a request object, either of type
2468
- # {::Google::Cloud::ArtifactRegistry::V1::ListTagsRequest} or an equivalent Hash.
2723
+ # @overload delete_file(request, options = nil)
2724
+ # Pass arguments to `delete_file` via a request object, either of type
2725
+ # {::Google::Cloud::ArtifactRegistry::V1::DeleteFileRequest} or an equivalent Hash.
2469
2726
  #
2470
- # @param request [::Google::Cloud::ArtifactRegistry::V1::ListTagsRequest, ::Hash]
2727
+ # @param request [::Google::Cloud::ArtifactRegistry::V1::DeleteFileRequest, ::Hash]
2471
2728
  # A request object representing the call parameters. Required. To specify no
2472
2729
  # parameters, or to keep all the default parameter values, pass an empty Hash.
2473
2730
  # @param options [::Gapic::CallOptions, ::Hash]
2474
2731
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2475
2732
  #
2476
- # @overload list_tags(parent: nil, filter: nil, page_size: nil, page_token: nil)
2477
- # Pass arguments to `list_tags` via keyword arguments. Note that at
2733
+ # @overload delete_file(name: nil)
2734
+ # Pass arguments to `delete_file` via keyword arguments. Note that at
2478
2735
  # least one keyword argument is required. To specify no parameters, or to keep all
2479
2736
  # the default parameter values, pass an empty Hash as a request object (see above).
2480
2737
  #
2481
- # @param parent [::String]
2482
- # The name of the parent package whose tags will be listed.
2483
- # For example:
2484
- # `projects/p1/locations/us-central1/repositories/repo1/packages/pkg1`.
2485
- # @param filter [::String]
2486
- # An expression for filtering the results of the request. Filter rules are
2487
- # case insensitive. The fields eligible for filtering are:
2488
- #
2489
- # * `version`
2490
- #
2491
- # An example of using a filter:
2492
- #
2493
- # * `version="projects/p1/locations/us-central1/repositories/repo1/packages/pkg1/versions/1.0"`
2494
- # --> Tags that are applied to the version `1.0` in package `pkg1`.
2495
- # @param page_size [::Integer]
2496
- # The maximum number of tags to return. Maximum page size is 10,000.
2497
- # @param page_token [::String]
2498
- # The next_page_token value returned from a previous list request, if any.
2738
+ # @param name [::String]
2739
+ # Required. The name of the file to delete.
2499
2740
  #
2500
2741
  # @yield [response, operation] Access the result along with the RPC operation
2501
- # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::ArtifactRegistry::V1::Tag>]
2742
+ # @yieldparam response [::Gapic::Operation]
2502
2743
  # @yieldparam operation [::GRPC::ActiveCall::Operation]
2503
2744
  #
2504
- # @return [::Gapic::PagedEnumerable<::Google::Cloud::ArtifactRegistry::V1::Tag>]
2745
+ # @return [::Gapic::Operation]
2505
2746
  #
2506
2747
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
2507
2748
  #
@@ -2512,28 +2753,31 @@ module Google
2512
2753
  # client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Client.new
2513
2754
  #
2514
2755
  # # Create a request. To set request fields, pass in keyword arguments.
2515
- # request = Google::Cloud::ArtifactRegistry::V1::ListTagsRequest.new
2756
+ # request = Google::Cloud::ArtifactRegistry::V1::DeleteFileRequest.new
2516
2757
  #
2517
- # # Call the list_tags method.
2518
- # result = client.list_tags request
2758
+ # # Call the delete_file method.
2759
+ # result = client.delete_file request
2519
2760
  #
2520
- # # The returned object is of type Gapic::PagedEnumerable. You can iterate
2521
- # # over elements, and API calls will be issued to fetch pages as needed.
2522
- # result.each do |item|
2523
- # # Each element is of type ::Google::Cloud::ArtifactRegistry::V1::Tag.
2524
- # p item
2761
+ # # The returned object is of type Gapic::Operation. You can use it to
2762
+ # # check the status of an operation, cancel it, or wait for results.
2763
+ # # Here is how to wait for a response.
2764
+ # result.wait_until_done! timeout: 60
2765
+ # if result.response?
2766
+ # p result.response
2767
+ # else
2768
+ # puts "No response received."
2525
2769
  # end
2526
2770
  #
2527
- def list_tags request, options = nil
2771
+ def delete_file request, options = nil
2528
2772
  raise ::ArgumentError, "request must be provided" if request.nil?
2529
2773
 
2530
- request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ArtifactRegistry::V1::ListTagsRequest
2774
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ArtifactRegistry::V1::DeleteFileRequest
2531
2775
 
2532
2776
  # Converts hash and nil to an options object
2533
2777
  options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2534
2778
 
2535
2779
  # Customize the options with defaults
2536
- metadata = @config.rpcs.list_tags.metadata.to_h
2780
+ metadata = @config.rpcs.delete_file.metadata.to_h
2537
2781
 
2538
2782
  # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2539
2783
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
@@ -2543,56 +2787,60 @@ module Google
2543
2787
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2544
2788
 
2545
2789
  header_params = {}
2546
- if request.parent
2547
- header_params["parent"] = request.parent
2790
+ if request.name
2791
+ header_params["name"] = request.name
2548
2792
  end
2549
2793
 
2550
2794
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
2551
2795
  metadata[:"x-goog-request-params"] ||= request_params_header
2552
2796
 
2553
- options.apply_defaults timeout: @config.rpcs.list_tags.timeout,
2797
+ options.apply_defaults timeout: @config.rpcs.delete_file.timeout,
2554
2798
  metadata: metadata,
2555
- retry_policy: @config.rpcs.list_tags.retry_policy
2799
+ retry_policy: @config.rpcs.delete_file.retry_policy
2556
2800
 
2557
2801
  options.apply_defaults timeout: @config.timeout,
2558
2802
  metadata: @config.metadata,
2559
2803
  retry_policy: @config.retry_policy
2560
2804
 
2561
- @artifact_registry_stub.call_rpc :list_tags, request, options: options do |response, operation|
2562
- response = ::Gapic::PagedEnumerable.new @artifact_registry_stub, :list_tags, request, response, operation, options
2805
+ @artifact_registry_stub.call_rpc :delete_file, request, options: options do |response, operation|
2806
+ response = ::Gapic::Operation.new response, @operations_client, options: options
2563
2807
  yield response, operation if block_given?
2564
- return response
2808
+ throw :response, response
2565
2809
  end
2566
2810
  rescue ::GRPC::BadStatus => e
2567
2811
  raise ::Google::Cloud::Error.from_error(e)
2568
2812
  end
2569
2813
 
2570
2814
  ##
2571
- # Gets a tag.
2815
+ # Updates a file.
2572
2816
  #
2573
- # @overload get_tag(request, options = nil)
2574
- # Pass arguments to `get_tag` via a request object, either of type
2575
- # {::Google::Cloud::ArtifactRegistry::V1::GetTagRequest} or an equivalent Hash.
2817
+ # @overload update_file(request, options = nil)
2818
+ # Pass arguments to `update_file` via a request object, either of type
2819
+ # {::Google::Cloud::ArtifactRegistry::V1::UpdateFileRequest} or an equivalent Hash.
2576
2820
  #
2577
- # @param request [::Google::Cloud::ArtifactRegistry::V1::GetTagRequest, ::Hash]
2821
+ # @param request [::Google::Cloud::ArtifactRegistry::V1::UpdateFileRequest, ::Hash]
2578
2822
  # A request object representing the call parameters. Required. To specify no
2579
2823
  # parameters, or to keep all the default parameter values, pass an empty Hash.
2580
2824
  # @param options [::Gapic::CallOptions, ::Hash]
2581
2825
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2582
2826
  #
2583
- # @overload get_tag(name: nil)
2584
- # Pass arguments to `get_tag` via keyword arguments. Note that at
2827
+ # @overload update_file(file: nil, update_mask: nil)
2828
+ # Pass arguments to `update_file` via keyword arguments. Note that at
2585
2829
  # least one keyword argument is required. To specify no parameters, or to keep all
2586
2830
  # the default parameter values, pass an empty Hash as a request object (see above).
2587
2831
  #
2588
- # @param name [::String]
2589
- # The name of the tag to retrieve.
2832
+ # @param file [::Google::Cloud::ArtifactRegistry::V1::File, ::Hash]
2833
+ # Required. The File that replaces the resource on the server.
2834
+ # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
2835
+ # Required. The update mask applies to the resource. For the `FieldMask`
2836
+ # definition, see
2837
+ # https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask
2590
2838
  #
2591
2839
  # @yield [response, operation] Access the result along with the RPC operation
2592
- # @yieldparam response [::Google::Cloud::ArtifactRegistry::V1::Tag]
2840
+ # @yieldparam response [::Google::Cloud::ArtifactRegistry::V1::File]
2593
2841
  # @yieldparam operation [::GRPC::ActiveCall::Operation]
2594
2842
  #
2595
- # @return [::Google::Cloud::ArtifactRegistry::V1::Tag]
2843
+ # @return [::Google::Cloud::ArtifactRegistry::V1::File]
2596
2844
  #
2597
2845
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
2598
2846
  #
@@ -2603,24 +2851,24 @@ module Google
2603
2851
  # client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Client.new
2604
2852
  #
2605
2853
  # # Create a request. To set request fields, pass in keyword arguments.
2606
- # request = Google::Cloud::ArtifactRegistry::V1::GetTagRequest.new
2854
+ # request = Google::Cloud::ArtifactRegistry::V1::UpdateFileRequest.new
2607
2855
  #
2608
- # # Call the get_tag method.
2609
- # result = client.get_tag request
2856
+ # # Call the update_file method.
2857
+ # result = client.update_file request
2610
2858
  #
2611
- # # The returned object is of type Google::Cloud::ArtifactRegistry::V1::Tag.
2859
+ # # The returned object is of type Google::Cloud::ArtifactRegistry::V1::File.
2612
2860
  # p result
2613
2861
  #
2614
- def get_tag request, options = nil
2862
+ def update_file request, options = nil
2615
2863
  raise ::ArgumentError, "request must be provided" if request.nil?
2616
2864
 
2617
- request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ArtifactRegistry::V1::GetTagRequest
2865
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ArtifactRegistry::V1::UpdateFileRequest
2618
2866
 
2619
2867
  # Converts hash and nil to an options object
2620
2868
  options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2621
2869
 
2622
2870
  # Customize the options with defaults
2623
- metadata = @config.rpcs.get_tag.metadata.to_h
2871
+ metadata = @config.rpcs.update_file.metadata.to_h
2624
2872
 
2625
2873
  # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2626
2874
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
@@ -2630,75 +2878,284 @@ module Google
2630
2878
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2631
2879
 
2632
2880
  header_params = {}
2633
- if request.name
2634
- header_params["name"] = request.name
2881
+ if request.file&.name
2882
+ header_params["file.name"] = request.file.name
2635
2883
  end
2636
2884
 
2637
2885
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
2638
2886
  metadata[:"x-goog-request-params"] ||= request_params_header
2639
2887
 
2640
- options.apply_defaults timeout: @config.rpcs.get_tag.timeout,
2888
+ options.apply_defaults timeout: @config.rpcs.update_file.timeout,
2641
2889
  metadata: metadata,
2642
- retry_policy: @config.rpcs.get_tag.retry_policy
2890
+ retry_policy: @config.rpcs.update_file.retry_policy
2643
2891
 
2644
2892
  options.apply_defaults timeout: @config.timeout,
2645
2893
  metadata: @config.metadata,
2646
2894
  retry_policy: @config.retry_policy
2647
2895
 
2648
- @artifact_registry_stub.call_rpc :get_tag, request, options: options do |response, operation|
2896
+ @artifact_registry_stub.call_rpc :update_file, request, options: options do |response, operation|
2649
2897
  yield response, operation if block_given?
2650
- return response
2651
2898
  end
2652
2899
  rescue ::GRPC::BadStatus => e
2653
2900
  raise ::Google::Cloud::Error.from_error(e)
2654
2901
  end
2655
2902
 
2656
2903
  ##
2657
- # Creates a tag.
2904
+ # Lists tags.
2658
2905
  #
2659
- # @overload create_tag(request, options = nil)
2660
- # Pass arguments to `create_tag` via a request object, either of type
2661
- # {::Google::Cloud::ArtifactRegistry::V1::CreateTagRequest} or an equivalent Hash.
2906
+ # @overload list_tags(request, options = nil)
2907
+ # Pass arguments to `list_tags` via a request object, either of type
2908
+ # {::Google::Cloud::ArtifactRegistry::V1::ListTagsRequest} or an equivalent Hash.
2662
2909
  #
2663
- # @param request [::Google::Cloud::ArtifactRegistry::V1::CreateTagRequest, ::Hash]
2910
+ # @param request [::Google::Cloud::ArtifactRegistry::V1::ListTagsRequest, ::Hash]
2664
2911
  # A request object representing the call parameters. Required. To specify no
2665
2912
  # parameters, or to keep all the default parameter values, pass an empty Hash.
2666
2913
  # @param options [::Gapic::CallOptions, ::Hash]
2667
2914
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2668
2915
  #
2669
- # @overload create_tag(parent: nil, tag_id: nil, tag: nil)
2670
- # Pass arguments to `create_tag` via keyword arguments. Note that at
2916
+ # @overload list_tags(parent: nil, filter: nil, page_size: nil, page_token: nil)
2917
+ # Pass arguments to `list_tags` via keyword arguments. Note that at
2671
2918
  # least one keyword argument is required. To specify no parameters, or to keep all
2672
2919
  # the default parameter values, pass an empty Hash as a request object (see above).
2673
2920
  #
2674
2921
  # @param parent [::String]
2675
- # The name of the parent resource where the tag will be created.
2676
- # @param tag_id [::String]
2677
- # The tag id to use for this repository.
2678
- # @param tag [::Google::Cloud::ArtifactRegistry::V1::Tag, ::Hash]
2679
- # The tag to be created.
2922
+ # The name of the parent package whose tags will be listed.
2923
+ # For example:
2924
+ # `projects/p1/locations/us-central1/repositories/repo1/packages/pkg1`.
2925
+ # @param filter [::String]
2926
+ # An expression for filtering the results of the request. Filter rules are
2927
+ # case insensitive. The fields eligible for filtering are:
2680
2928
  #
2681
- # @yield [response, operation] Access the result along with the RPC operation
2682
- # @yieldparam response [::Google::Cloud::ArtifactRegistry::V1::Tag]
2683
- # @yieldparam operation [::GRPC::ActiveCall::Operation]
2929
+ # * `name`
2930
+ # * `version`
2684
2931
  #
2685
- # @return [::Google::Cloud::ArtifactRegistry::V1::Tag]
2932
+ # Examples of using a filter:
2686
2933
  #
2687
- # @raise [::Google::Cloud::Error] if the RPC is aborted.
2934
+ # To filter the results of your request to tags with the name `my-tag` in
2935
+ # package `my-package` in repository `my-repo` in project "`y-project` in
2936
+ # the us-central region, append the following filter expression to your
2937
+ # request:
2688
2938
  #
2689
- # @example Basic example
2690
- # require "google/cloud/artifact_registry/v1"
2939
+ # * `name="projects/my-project/locations/us-central1/repositories/my-repo/packages/my-package/tags/my-tag"`
2691
2940
  #
2692
- # # Create a client object. The client can be reused for multiple calls.
2693
- # client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Client.new
2941
+ # You can also use wildcards to match any number of characters before or
2942
+ # after the value:
2694
2943
  #
2695
- # # Create a request. To set request fields, pass in keyword arguments.
2696
- # request = Google::Cloud::ArtifactRegistry::V1::CreateTagRequest.new
2944
+ # * `name="projects/my-project/locations/us-central1/repositories/my-repo/packages/my-package/tags/my*"`
2945
+ # * `name="projects/my-project/locations/us-central1/repositories/my-repo/packages/my-package/tags/*tag"`
2946
+ # * `name="projects/my-project/locations/us-central1/repositories/my-repo/packages/my-package/tags/*tag*"`
2697
2947
  #
2698
- # # Call the create_tag method.
2699
- # result = client.create_tag request
2948
+ # To filter the results of your request to tags applied to the version
2949
+ # `1.0` in package `my-package`, append the following filter expression to
2950
+ # your request:
2700
2951
  #
2701
- # # The returned object is of type Google::Cloud::ArtifactRegistry::V1::Tag.
2952
+ # * `version="projects/my-project/locations/us-central1/repositories/my-repo/packages/my-package/versions/1.0"`
2953
+ # @param page_size [::Integer]
2954
+ # The maximum number of tags to return. Maximum page size is 1,000.
2955
+ # @param page_token [::String]
2956
+ # The next_page_token value returned from a previous list request, if any.
2957
+ #
2958
+ # @yield [response, operation] Access the result along with the RPC operation
2959
+ # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::ArtifactRegistry::V1::Tag>]
2960
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
2961
+ #
2962
+ # @return [::Gapic::PagedEnumerable<::Google::Cloud::ArtifactRegistry::V1::Tag>]
2963
+ #
2964
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
2965
+ #
2966
+ # @example Basic example
2967
+ # require "google/cloud/artifact_registry/v1"
2968
+ #
2969
+ # # Create a client object. The client can be reused for multiple calls.
2970
+ # client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Client.new
2971
+ #
2972
+ # # Create a request. To set request fields, pass in keyword arguments.
2973
+ # request = Google::Cloud::ArtifactRegistry::V1::ListTagsRequest.new
2974
+ #
2975
+ # # Call the list_tags method.
2976
+ # result = client.list_tags request
2977
+ #
2978
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
2979
+ # # over elements, and API calls will be issued to fetch pages as needed.
2980
+ # result.each do |item|
2981
+ # # Each element is of type ::Google::Cloud::ArtifactRegistry::V1::Tag.
2982
+ # p item
2983
+ # end
2984
+ #
2985
+ def list_tags request, options = nil
2986
+ raise ::ArgumentError, "request must be provided" if request.nil?
2987
+
2988
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ArtifactRegistry::V1::ListTagsRequest
2989
+
2990
+ # Converts hash and nil to an options object
2991
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2992
+
2993
+ # Customize the options with defaults
2994
+ metadata = @config.rpcs.list_tags.metadata.to_h
2995
+
2996
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2997
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2998
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2999
+ gapic_version: ::Google::Cloud::ArtifactRegistry::V1::VERSION
3000
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
3001
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
3002
+
3003
+ header_params = {}
3004
+ if request.parent
3005
+ header_params["parent"] = request.parent
3006
+ end
3007
+
3008
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
3009
+ metadata[:"x-goog-request-params"] ||= request_params_header
3010
+
3011
+ options.apply_defaults timeout: @config.rpcs.list_tags.timeout,
3012
+ metadata: metadata,
3013
+ retry_policy: @config.rpcs.list_tags.retry_policy
3014
+
3015
+ options.apply_defaults timeout: @config.timeout,
3016
+ metadata: @config.metadata,
3017
+ retry_policy: @config.retry_policy
3018
+
3019
+ @artifact_registry_stub.call_rpc :list_tags, request, options: options do |response, operation|
3020
+ response = ::Gapic::PagedEnumerable.new @artifact_registry_stub, :list_tags, request, response, operation, options
3021
+ yield response, operation if block_given?
3022
+ throw :response, response
3023
+ end
3024
+ rescue ::GRPC::BadStatus => e
3025
+ raise ::Google::Cloud::Error.from_error(e)
3026
+ end
3027
+
3028
+ ##
3029
+ # Gets a tag.
3030
+ #
3031
+ # @overload get_tag(request, options = nil)
3032
+ # Pass arguments to `get_tag` via a request object, either of type
3033
+ # {::Google::Cloud::ArtifactRegistry::V1::GetTagRequest} or an equivalent Hash.
3034
+ #
3035
+ # @param request [::Google::Cloud::ArtifactRegistry::V1::GetTagRequest, ::Hash]
3036
+ # A request object representing the call parameters. Required. To specify no
3037
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
3038
+ # @param options [::Gapic::CallOptions, ::Hash]
3039
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
3040
+ #
3041
+ # @overload get_tag(name: nil)
3042
+ # Pass arguments to `get_tag` via keyword arguments. Note that at
3043
+ # least one keyword argument is required. To specify no parameters, or to keep all
3044
+ # the default parameter values, pass an empty Hash as a request object (see above).
3045
+ #
3046
+ # @param name [::String]
3047
+ # The name of the tag to retrieve.
3048
+ #
3049
+ # @yield [response, operation] Access the result along with the RPC operation
3050
+ # @yieldparam response [::Google::Cloud::ArtifactRegistry::V1::Tag]
3051
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
3052
+ #
3053
+ # @return [::Google::Cloud::ArtifactRegistry::V1::Tag]
3054
+ #
3055
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
3056
+ #
3057
+ # @example Basic example
3058
+ # require "google/cloud/artifact_registry/v1"
3059
+ #
3060
+ # # Create a client object. The client can be reused for multiple calls.
3061
+ # client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Client.new
3062
+ #
3063
+ # # Create a request. To set request fields, pass in keyword arguments.
3064
+ # request = Google::Cloud::ArtifactRegistry::V1::GetTagRequest.new
3065
+ #
3066
+ # # Call the get_tag method.
3067
+ # result = client.get_tag request
3068
+ #
3069
+ # # The returned object is of type Google::Cloud::ArtifactRegistry::V1::Tag.
3070
+ # p result
3071
+ #
3072
+ def get_tag request, options = nil
3073
+ raise ::ArgumentError, "request must be provided" if request.nil?
3074
+
3075
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ArtifactRegistry::V1::GetTagRequest
3076
+
3077
+ # Converts hash and nil to an options object
3078
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
3079
+
3080
+ # Customize the options with defaults
3081
+ metadata = @config.rpcs.get_tag.metadata.to_h
3082
+
3083
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
3084
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
3085
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
3086
+ gapic_version: ::Google::Cloud::ArtifactRegistry::V1::VERSION
3087
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
3088
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
3089
+
3090
+ header_params = {}
3091
+ if request.name
3092
+ header_params["name"] = request.name
3093
+ end
3094
+
3095
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
3096
+ metadata[:"x-goog-request-params"] ||= request_params_header
3097
+
3098
+ options.apply_defaults timeout: @config.rpcs.get_tag.timeout,
3099
+ metadata: metadata,
3100
+ retry_policy: @config.rpcs.get_tag.retry_policy
3101
+
3102
+ options.apply_defaults timeout: @config.timeout,
3103
+ metadata: @config.metadata,
3104
+ retry_policy: @config.retry_policy
3105
+
3106
+ @artifact_registry_stub.call_rpc :get_tag, request, options: options do |response, operation|
3107
+ yield response, operation if block_given?
3108
+ end
3109
+ rescue ::GRPC::BadStatus => e
3110
+ raise ::Google::Cloud::Error.from_error(e)
3111
+ end
3112
+
3113
+ ##
3114
+ # Creates a tag.
3115
+ #
3116
+ # @overload create_tag(request, options = nil)
3117
+ # Pass arguments to `create_tag` via a request object, either of type
3118
+ # {::Google::Cloud::ArtifactRegistry::V1::CreateTagRequest} or an equivalent Hash.
3119
+ #
3120
+ # @param request [::Google::Cloud::ArtifactRegistry::V1::CreateTagRequest, ::Hash]
3121
+ # A request object representing the call parameters. Required. To specify no
3122
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
3123
+ # @param options [::Gapic::CallOptions, ::Hash]
3124
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
3125
+ #
3126
+ # @overload create_tag(parent: nil, tag_id: nil, tag: nil)
3127
+ # Pass arguments to `create_tag` via keyword arguments. Note that at
3128
+ # least one keyword argument is required. To specify no parameters, or to keep all
3129
+ # the default parameter values, pass an empty Hash as a request object (see above).
3130
+ #
3131
+ # @param parent [::String]
3132
+ # The name of the parent resource where the tag will be created.
3133
+ # @param tag_id [::String]
3134
+ # The tag id to use for this repository.
3135
+ # @param tag [::Google::Cloud::ArtifactRegistry::V1::Tag, ::Hash]
3136
+ # The tag to be created.
3137
+ #
3138
+ # @yield [response, operation] Access the result along with the RPC operation
3139
+ # @yieldparam response [::Google::Cloud::ArtifactRegistry::V1::Tag]
3140
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
3141
+ #
3142
+ # @return [::Google::Cloud::ArtifactRegistry::V1::Tag]
3143
+ #
3144
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
3145
+ #
3146
+ # @example Basic example
3147
+ # require "google/cloud/artifact_registry/v1"
3148
+ #
3149
+ # # Create a client object. The client can be reused for multiple calls.
3150
+ # client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Client.new
3151
+ #
3152
+ # # Create a request. To set request fields, pass in keyword arguments.
3153
+ # request = Google::Cloud::ArtifactRegistry::V1::CreateTagRequest.new
3154
+ #
3155
+ # # Call the create_tag method.
3156
+ # result = client.create_tag request
3157
+ #
3158
+ # # The returned object is of type Google::Cloud::ArtifactRegistry::V1::Tag.
2702
3159
  # p result
2703
3160
  #
2704
3161
  def create_tag request, options = nil
@@ -2737,7 +3194,6 @@ module Google
2737
3194
 
2738
3195
  @artifact_registry_stub.call_rpc :create_tag, request, options: options do |response, operation|
2739
3196
  yield response, operation if block_given?
2740
- return response
2741
3197
  end
2742
3198
  rescue ::GRPC::BadStatus => e
2743
3199
  raise ::Google::Cloud::Error.from_error(e)
@@ -2827,7 +3283,6 @@ module Google
2827
3283
 
2828
3284
  @artifact_registry_stub.call_rpc :update_tag, request, options: options do |response, operation|
2829
3285
  yield response, operation if block_given?
2830
- return response
2831
3286
  end
2832
3287
  rescue ::GRPC::BadStatus => e
2833
3288
  raise ::Google::Cloud::Error.from_error(e)
@@ -2913,50 +3368,41 @@ module Google
2913
3368
 
2914
3369
  @artifact_registry_stub.call_rpc :delete_tag, request, options: options do |response, operation|
2915
3370
  yield response, operation if block_given?
2916
- return response
2917
3371
  end
2918
3372
  rescue ::GRPC::BadStatus => e
2919
3373
  raise ::Google::Cloud::Error.from_error(e)
2920
3374
  end
2921
3375
 
2922
3376
  ##
2923
- # Updates the IAM policy for a given resource.
3377
+ # Creates a rule.
2924
3378
  #
2925
- # @overload set_iam_policy(request, options = nil)
2926
- # Pass arguments to `set_iam_policy` via a request object, either of type
2927
- # {::Google::Iam::V1::SetIamPolicyRequest} or an equivalent Hash.
3379
+ # @overload create_rule(request, options = nil)
3380
+ # Pass arguments to `create_rule` via a request object, either of type
3381
+ # {::Google::Cloud::ArtifactRegistry::V1::CreateRuleRequest} or an equivalent Hash.
2928
3382
  #
2929
- # @param request [::Google::Iam::V1::SetIamPolicyRequest, ::Hash]
3383
+ # @param request [::Google::Cloud::ArtifactRegistry::V1::CreateRuleRequest, ::Hash]
2930
3384
  # A request object representing the call parameters. Required. To specify no
2931
3385
  # parameters, or to keep all the default parameter values, pass an empty Hash.
2932
3386
  # @param options [::Gapic::CallOptions, ::Hash]
2933
3387
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2934
3388
  #
2935
- # @overload set_iam_policy(resource: nil, policy: nil, update_mask: nil)
2936
- # Pass arguments to `set_iam_policy` via keyword arguments. Note that at
3389
+ # @overload create_rule(parent: nil, rule_id: nil, rule: nil)
3390
+ # Pass arguments to `create_rule` via keyword arguments. Note that at
2937
3391
  # least one keyword argument is required. To specify no parameters, or to keep all
2938
3392
  # the default parameter values, pass an empty Hash as a request object (see above).
2939
3393
  #
2940
- # @param resource [::String]
2941
- # REQUIRED: The resource for which the policy is being specified.
2942
- # See the operation documentation for the appropriate value for this field.
2943
- # @param policy [::Google::Iam::V1::Policy, ::Hash]
2944
- # REQUIRED: The complete policy to be applied to the `resource`. The size of
2945
- # the policy is limited to a few 10s of KB. An empty policy is a
2946
- # valid policy but certain Cloud Platform services (such as Projects)
2947
- # might reject them.
2948
- # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
2949
- # OPTIONAL: A FieldMask specifying which fields of the policy to modify. Only
2950
- # the fields in the mask will be modified. If no mask is provided, the
2951
- # following default mask is used:
2952
- #
2953
- # `paths: "bindings, etag"`
3394
+ # @param parent [::String]
3395
+ # Required. The name of the parent resource where the rule will be created.
3396
+ # @param rule_id [::String]
3397
+ # The rule id to use for this repository.
3398
+ # @param rule [::Google::Cloud::ArtifactRegistry::V1::Rule, ::Hash]
3399
+ # The rule to be created.
2954
3400
  #
2955
3401
  # @yield [response, operation] Access the result along with the RPC operation
2956
- # @yieldparam response [::Google::Iam::V1::Policy]
3402
+ # @yieldparam response [::Google::Cloud::ArtifactRegistry::V1::Rule]
2957
3403
  # @yieldparam operation [::GRPC::ActiveCall::Operation]
2958
3404
  #
2959
- # @return [::Google::Iam::V1::Policy]
3405
+ # @return [::Google::Cloud::ArtifactRegistry::V1::Rule]
2960
3406
  #
2961
3407
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
2962
3408
  #
@@ -2967,24 +3413,24 @@ module Google
2967
3413
  # client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Client.new
2968
3414
  #
2969
3415
  # # Create a request. To set request fields, pass in keyword arguments.
2970
- # request = Google::Iam::V1::SetIamPolicyRequest.new
3416
+ # request = Google::Cloud::ArtifactRegistry::V1::CreateRuleRequest.new
2971
3417
  #
2972
- # # Call the set_iam_policy method.
2973
- # result = client.set_iam_policy request
3418
+ # # Call the create_rule method.
3419
+ # result = client.create_rule request
2974
3420
  #
2975
- # # The returned object is of type Google::Iam::V1::Policy.
3421
+ # # The returned object is of type Google::Cloud::ArtifactRegistry::V1::Rule.
2976
3422
  # p result
2977
3423
  #
2978
- def set_iam_policy request, options = nil
3424
+ def create_rule request, options = nil
2979
3425
  raise ::ArgumentError, "request must be provided" if request.nil?
2980
3426
 
2981
- request = ::Gapic::Protobuf.coerce request, to: ::Google::Iam::V1::SetIamPolicyRequest
3427
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ArtifactRegistry::V1::CreateRuleRequest
2982
3428
 
2983
3429
  # Converts hash and nil to an options object
2984
3430
  options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2985
3431
 
2986
3432
  # Customize the options with defaults
2987
- metadata = @config.rpcs.set_iam_policy.metadata.to_h
3433
+ metadata = @config.rpcs.create_rule.metadata.to_h
2988
3434
 
2989
3435
  # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2990
3436
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
@@ -2994,59 +3440,946 @@ module Google
2994
3440
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2995
3441
 
2996
3442
  header_params = {}
2997
- if request.resource
2998
- header_params["resource"] = request.resource
3443
+ if request.parent
3444
+ header_params["parent"] = request.parent
2999
3445
  end
3000
3446
 
3001
3447
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
3002
3448
  metadata[:"x-goog-request-params"] ||= request_params_header
3003
3449
 
3004
- options.apply_defaults timeout: @config.rpcs.set_iam_policy.timeout,
3450
+ options.apply_defaults timeout: @config.rpcs.create_rule.timeout,
3005
3451
  metadata: metadata,
3006
- retry_policy: @config.rpcs.set_iam_policy.retry_policy
3452
+ retry_policy: @config.rpcs.create_rule.retry_policy
3007
3453
 
3008
3454
  options.apply_defaults timeout: @config.timeout,
3009
3455
  metadata: @config.metadata,
3010
3456
  retry_policy: @config.retry_policy
3011
3457
 
3012
- @artifact_registry_stub.call_rpc :set_iam_policy, request, options: options do |response, operation|
3458
+ @artifact_registry_stub.call_rpc :create_rule, request, options: options do |response, operation|
3013
3459
  yield response, operation if block_given?
3014
- return response
3015
3460
  end
3016
3461
  rescue ::GRPC::BadStatus => e
3017
3462
  raise ::Google::Cloud::Error.from_error(e)
3018
3463
  end
3019
3464
 
3020
3465
  ##
3021
- # Gets the IAM policy for a given resource.
3466
+ # Lists rules.
3022
3467
  #
3023
- # @overload get_iam_policy(request, options = nil)
3024
- # Pass arguments to `get_iam_policy` via a request object, either of type
3025
- # {::Google::Iam::V1::GetIamPolicyRequest} or an equivalent Hash.
3468
+ # @overload list_rules(request, options = nil)
3469
+ # Pass arguments to `list_rules` via a request object, either of type
3470
+ # {::Google::Cloud::ArtifactRegistry::V1::ListRulesRequest} or an equivalent Hash.
3026
3471
  #
3027
- # @param request [::Google::Iam::V1::GetIamPolicyRequest, ::Hash]
3472
+ # @param request [::Google::Cloud::ArtifactRegistry::V1::ListRulesRequest, ::Hash]
3028
3473
  # A request object representing the call parameters. Required. To specify no
3029
3474
  # parameters, or to keep all the default parameter values, pass an empty Hash.
3030
3475
  # @param options [::Gapic::CallOptions, ::Hash]
3031
3476
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
3032
3477
  #
3033
- # @overload get_iam_policy(resource: nil, options: nil)
3034
- # Pass arguments to `get_iam_policy` via keyword arguments. Note that at
3478
+ # @overload list_rules(parent: nil, page_size: nil, page_token: nil)
3479
+ # Pass arguments to `list_rules` via keyword arguments. Note that at
3035
3480
  # least one keyword argument is required. To specify no parameters, or to keep all
3036
3481
  # the default parameter values, pass an empty Hash as a request object (see above).
3037
3482
  #
3038
- # @param resource [::String]
3039
- # REQUIRED: The resource for which the policy is being requested.
3040
- # See the operation documentation for the appropriate value for this field.
3041
- # @param options [::Google::Iam::V1::GetPolicyOptions, ::Hash]
3042
- # OPTIONAL: A `GetPolicyOptions` object for specifying options to
3043
- # `GetIamPolicy`.
3483
+ # @param parent [::String]
3484
+ # Required. The name of the parent repository whose rules will be listed.
3485
+ # For example:
3486
+ # `projects/p1/locations/us-central1/repositories/repo1`.
3487
+ # @param page_size [::Integer]
3488
+ # The maximum number of rules to return. Maximum page size is 1,000.
3489
+ # @param page_token [::String]
3490
+ # The next_page_token value returned from a previous list request, if any.
3491
+ #
3492
+ # @yield [response, operation] Access the result along with the RPC operation
3493
+ # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::ArtifactRegistry::V1::Rule>]
3494
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
3495
+ #
3496
+ # @return [::Gapic::PagedEnumerable<::Google::Cloud::ArtifactRegistry::V1::Rule>]
3497
+ #
3498
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
3499
+ #
3500
+ # @example Basic example
3501
+ # require "google/cloud/artifact_registry/v1"
3502
+ #
3503
+ # # Create a client object. The client can be reused for multiple calls.
3504
+ # client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Client.new
3505
+ #
3506
+ # # Create a request. To set request fields, pass in keyword arguments.
3507
+ # request = Google::Cloud::ArtifactRegistry::V1::ListRulesRequest.new
3508
+ #
3509
+ # # Call the list_rules method.
3510
+ # result = client.list_rules request
3511
+ #
3512
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
3513
+ # # over elements, and API calls will be issued to fetch pages as needed.
3514
+ # result.each do |item|
3515
+ # # Each element is of type ::Google::Cloud::ArtifactRegistry::V1::Rule.
3516
+ # p item
3517
+ # end
3518
+ #
3519
+ def list_rules request, options = nil
3520
+ raise ::ArgumentError, "request must be provided" if request.nil?
3521
+
3522
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ArtifactRegistry::V1::ListRulesRequest
3523
+
3524
+ # Converts hash and nil to an options object
3525
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
3526
+
3527
+ # Customize the options with defaults
3528
+ metadata = @config.rpcs.list_rules.metadata.to_h
3529
+
3530
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
3531
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
3532
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
3533
+ gapic_version: ::Google::Cloud::ArtifactRegistry::V1::VERSION
3534
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
3535
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
3536
+
3537
+ header_params = {}
3538
+ if request.parent
3539
+ header_params["parent"] = request.parent
3540
+ end
3541
+
3542
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
3543
+ metadata[:"x-goog-request-params"] ||= request_params_header
3544
+
3545
+ options.apply_defaults timeout: @config.rpcs.list_rules.timeout,
3546
+ metadata: metadata,
3547
+ retry_policy: @config.rpcs.list_rules.retry_policy
3548
+
3549
+ options.apply_defaults timeout: @config.timeout,
3550
+ metadata: @config.metadata,
3551
+ retry_policy: @config.retry_policy
3552
+
3553
+ @artifact_registry_stub.call_rpc :list_rules, request, options: options do |response, operation|
3554
+ response = ::Gapic::PagedEnumerable.new @artifact_registry_stub, :list_rules, request, response, operation, options
3555
+ yield response, operation if block_given?
3556
+ throw :response, response
3557
+ end
3558
+ rescue ::GRPC::BadStatus => e
3559
+ raise ::Google::Cloud::Error.from_error(e)
3560
+ end
3561
+
3562
+ ##
3563
+ # Gets a rule.
3564
+ #
3565
+ # @overload get_rule(request, options = nil)
3566
+ # Pass arguments to `get_rule` via a request object, either of type
3567
+ # {::Google::Cloud::ArtifactRegistry::V1::GetRuleRequest} or an equivalent Hash.
3568
+ #
3569
+ # @param request [::Google::Cloud::ArtifactRegistry::V1::GetRuleRequest, ::Hash]
3570
+ # A request object representing the call parameters. Required. To specify no
3571
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
3572
+ # @param options [::Gapic::CallOptions, ::Hash]
3573
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
3574
+ #
3575
+ # @overload get_rule(name: nil)
3576
+ # Pass arguments to `get_rule` via keyword arguments. Note that at
3577
+ # least one keyword argument is required. To specify no parameters, or to keep all
3578
+ # the default parameter values, pass an empty Hash as a request object (see above).
3579
+ #
3580
+ # @param name [::String]
3581
+ # Required. The name of the rule to retrieve.
3582
+ #
3583
+ # @yield [response, operation] Access the result along with the RPC operation
3584
+ # @yieldparam response [::Google::Cloud::ArtifactRegistry::V1::Rule]
3585
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
3586
+ #
3587
+ # @return [::Google::Cloud::ArtifactRegistry::V1::Rule]
3588
+ #
3589
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
3590
+ #
3591
+ # @example Basic example
3592
+ # require "google/cloud/artifact_registry/v1"
3593
+ #
3594
+ # # Create a client object. The client can be reused for multiple calls.
3595
+ # client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Client.new
3596
+ #
3597
+ # # Create a request. To set request fields, pass in keyword arguments.
3598
+ # request = Google::Cloud::ArtifactRegistry::V1::GetRuleRequest.new
3599
+ #
3600
+ # # Call the get_rule method.
3601
+ # result = client.get_rule request
3602
+ #
3603
+ # # The returned object is of type Google::Cloud::ArtifactRegistry::V1::Rule.
3604
+ # p result
3605
+ #
3606
+ def get_rule request, options = nil
3607
+ raise ::ArgumentError, "request must be provided" if request.nil?
3608
+
3609
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ArtifactRegistry::V1::GetRuleRequest
3610
+
3611
+ # Converts hash and nil to an options object
3612
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
3613
+
3614
+ # Customize the options with defaults
3615
+ metadata = @config.rpcs.get_rule.metadata.to_h
3616
+
3617
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
3618
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
3619
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
3620
+ gapic_version: ::Google::Cloud::ArtifactRegistry::V1::VERSION
3621
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
3622
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
3623
+
3624
+ header_params = {}
3625
+ if request.name
3626
+ header_params["name"] = request.name
3627
+ end
3628
+
3629
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
3630
+ metadata[:"x-goog-request-params"] ||= request_params_header
3631
+
3632
+ options.apply_defaults timeout: @config.rpcs.get_rule.timeout,
3633
+ metadata: metadata,
3634
+ retry_policy: @config.rpcs.get_rule.retry_policy
3635
+
3636
+ options.apply_defaults timeout: @config.timeout,
3637
+ metadata: @config.metadata,
3638
+ retry_policy: @config.retry_policy
3639
+
3640
+ @artifact_registry_stub.call_rpc :get_rule, request, options: options do |response, operation|
3641
+ yield response, operation if block_given?
3642
+ end
3643
+ rescue ::GRPC::BadStatus => e
3644
+ raise ::Google::Cloud::Error.from_error(e)
3645
+ end
3646
+
3647
+ ##
3648
+ # Updates a rule.
3649
+ #
3650
+ # @overload update_rule(request, options = nil)
3651
+ # Pass arguments to `update_rule` via a request object, either of type
3652
+ # {::Google::Cloud::ArtifactRegistry::V1::UpdateRuleRequest} or an equivalent Hash.
3653
+ #
3654
+ # @param request [::Google::Cloud::ArtifactRegistry::V1::UpdateRuleRequest, ::Hash]
3655
+ # A request object representing the call parameters. Required. To specify no
3656
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
3657
+ # @param options [::Gapic::CallOptions, ::Hash]
3658
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
3659
+ #
3660
+ # @overload update_rule(rule: nil, update_mask: nil)
3661
+ # Pass arguments to `update_rule` via keyword arguments. Note that at
3662
+ # least one keyword argument is required. To specify no parameters, or to keep all
3663
+ # the default parameter values, pass an empty Hash as a request object (see above).
3664
+ #
3665
+ # @param rule [::Google::Cloud::ArtifactRegistry::V1::Rule, ::Hash]
3666
+ # The rule that replaces the resource on the server.
3667
+ # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
3668
+ # The update mask applies to the resource. For the `FieldMask` definition,
3669
+ # see
3670
+ # https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask
3671
+ #
3672
+ # @yield [response, operation] Access the result along with the RPC operation
3673
+ # @yieldparam response [::Google::Cloud::ArtifactRegistry::V1::Rule]
3674
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
3675
+ #
3676
+ # @return [::Google::Cloud::ArtifactRegistry::V1::Rule]
3677
+ #
3678
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
3679
+ #
3680
+ # @example Basic example
3681
+ # require "google/cloud/artifact_registry/v1"
3682
+ #
3683
+ # # Create a client object. The client can be reused for multiple calls.
3684
+ # client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Client.new
3685
+ #
3686
+ # # Create a request. To set request fields, pass in keyword arguments.
3687
+ # request = Google::Cloud::ArtifactRegistry::V1::UpdateRuleRequest.new
3688
+ #
3689
+ # # Call the update_rule method.
3690
+ # result = client.update_rule request
3691
+ #
3692
+ # # The returned object is of type Google::Cloud::ArtifactRegistry::V1::Rule.
3693
+ # p result
3694
+ #
3695
+ def update_rule request, options = nil
3696
+ raise ::ArgumentError, "request must be provided" if request.nil?
3697
+
3698
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ArtifactRegistry::V1::UpdateRuleRequest
3699
+
3700
+ # Converts hash and nil to an options object
3701
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
3702
+
3703
+ # Customize the options with defaults
3704
+ metadata = @config.rpcs.update_rule.metadata.to_h
3705
+
3706
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
3707
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
3708
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
3709
+ gapic_version: ::Google::Cloud::ArtifactRegistry::V1::VERSION
3710
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
3711
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
3712
+
3713
+ header_params = {}
3714
+ if request.rule&.name
3715
+ header_params["rule.name"] = request.rule.name
3716
+ end
3717
+
3718
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
3719
+ metadata[:"x-goog-request-params"] ||= request_params_header
3720
+
3721
+ options.apply_defaults timeout: @config.rpcs.update_rule.timeout,
3722
+ metadata: metadata,
3723
+ retry_policy: @config.rpcs.update_rule.retry_policy
3724
+
3725
+ options.apply_defaults timeout: @config.timeout,
3726
+ metadata: @config.metadata,
3727
+ retry_policy: @config.retry_policy
3728
+
3729
+ @artifact_registry_stub.call_rpc :update_rule, request, options: options do |response, operation|
3730
+ yield response, operation if block_given?
3731
+ end
3732
+ rescue ::GRPC::BadStatus => e
3733
+ raise ::Google::Cloud::Error.from_error(e)
3734
+ end
3735
+
3736
+ ##
3737
+ # Deletes a rule.
3738
+ #
3739
+ # @overload delete_rule(request, options = nil)
3740
+ # Pass arguments to `delete_rule` via a request object, either of type
3741
+ # {::Google::Cloud::ArtifactRegistry::V1::DeleteRuleRequest} or an equivalent Hash.
3742
+ #
3743
+ # @param request [::Google::Cloud::ArtifactRegistry::V1::DeleteRuleRequest, ::Hash]
3744
+ # A request object representing the call parameters. Required. To specify no
3745
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
3746
+ # @param options [::Gapic::CallOptions, ::Hash]
3747
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
3748
+ #
3749
+ # @overload delete_rule(name: nil)
3750
+ # Pass arguments to `delete_rule` via keyword arguments. Note that at
3751
+ # least one keyword argument is required. To specify no parameters, or to keep all
3752
+ # the default parameter values, pass an empty Hash as a request object (see above).
3753
+ #
3754
+ # @param name [::String]
3755
+ # Required. The name of the rule to delete.
3756
+ #
3757
+ # @yield [response, operation] Access the result along with the RPC operation
3758
+ # @yieldparam response [::Google::Protobuf::Empty]
3759
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
3760
+ #
3761
+ # @return [::Google::Protobuf::Empty]
3762
+ #
3763
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
3764
+ #
3765
+ # @example Basic example
3766
+ # require "google/cloud/artifact_registry/v1"
3767
+ #
3768
+ # # Create a client object. The client can be reused for multiple calls.
3769
+ # client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Client.new
3770
+ #
3771
+ # # Create a request. To set request fields, pass in keyword arguments.
3772
+ # request = Google::Cloud::ArtifactRegistry::V1::DeleteRuleRequest.new
3773
+ #
3774
+ # # Call the delete_rule method.
3775
+ # result = client.delete_rule request
3776
+ #
3777
+ # # The returned object is of type Google::Protobuf::Empty.
3778
+ # p result
3779
+ #
3780
+ def delete_rule request, options = nil
3781
+ raise ::ArgumentError, "request must be provided" if request.nil?
3782
+
3783
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ArtifactRegistry::V1::DeleteRuleRequest
3784
+
3785
+ # Converts hash and nil to an options object
3786
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
3787
+
3788
+ # Customize the options with defaults
3789
+ metadata = @config.rpcs.delete_rule.metadata.to_h
3790
+
3791
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
3792
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
3793
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
3794
+ gapic_version: ::Google::Cloud::ArtifactRegistry::V1::VERSION
3795
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
3796
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
3797
+
3798
+ header_params = {}
3799
+ if request.name
3800
+ header_params["name"] = request.name
3801
+ end
3802
+
3803
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
3804
+ metadata[:"x-goog-request-params"] ||= request_params_header
3805
+
3806
+ options.apply_defaults timeout: @config.rpcs.delete_rule.timeout,
3807
+ metadata: metadata,
3808
+ retry_policy: @config.rpcs.delete_rule.retry_policy
3809
+
3810
+ options.apply_defaults timeout: @config.timeout,
3811
+ metadata: @config.metadata,
3812
+ retry_policy: @config.retry_policy
3813
+
3814
+ @artifact_registry_stub.call_rpc :delete_rule, request, options: options do |response, operation|
3815
+ yield response, operation if block_given?
3816
+ end
3817
+ rescue ::GRPC::BadStatus => e
3818
+ raise ::Google::Cloud::Error.from_error(e)
3819
+ end
3820
+
3821
+ ##
3822
+ # Updates the IAM policy for a given resource.
3823
+ #
3824
+ # @overload set_iam_policy(request, options = nil)
3825
+ # Pass arguments to `set_iam_policy` via a request object, either of type
3826
+ # {::Google::Iam::V1::SetIamPolicyRequest} or an equivalent Hash.
3827
+ #
3828
+ # @param request [::Google::Iam::V1::SetIamPolicyRequest, ::Hash]
3829
+ # A request object representing the call parameters. Required. To specify no
3830
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
3831
+ # @param options [::Gapic::CallOptions, ::Hash]
3832
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
3833
+ #
3834
+ # @overload set_iam_policy(resource: nil, policy: nil, update_mask: nil)
3835
+ # Pass arguments to `set_iam_policy` via keyword arguments. Note that at
3836
+ # least one keyword argument is required. To specify no parameters, or to keep all
3837
+ # the default parameter values, pass an empty Hash as a request object (see above).
3838
+ #
3839
+ # @param resource [::String]
3840
+ # REQUIRED: The resource for which the policy is being specified.
3841
+ # See the operation documentation for the appropriate value for this field.
3842
+ # @param policy [::Google::Iam::V1::Policy, ::Hash]
3843
+ # REQUIRED: The complete policy to be applied to the `resource`. The size of
3844
+ # the policy is limited to a few 10s of KB. An empty policy is a
3845
+ # valid policy but certain Cloud Platform services (such as Projects)
3846
+ # might reject them.
3847
+ # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
3848
+ # OPTIONAL: A FieldMask specifying which fields of the policy to modify. Only
3849
+ # the fields in the mask will be modified. If no mask is provided, the
3850
+ # following default mask is used:
3851
+ #
3852
+ # `paths: "bindings, etag"`
3853
+ #
3854
+ # @yield [response, operation] Access the result along with the RPC operation
3855
+ # @yieldparam response [::Google::Iam::V1::Policy]
3856
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
3857
+ #
3858
+ # @return [::Google::Iam::V1::Policy]
3859
+ #
3860
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
3861
+ #
3862
+ # @example Basic example
3863
+ # require "google/cloud/artifact_registry/v1"
3864
+ #
3865
+ # # Create a client object. The client can be reused for multiple calls.
3866
+ # client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Client.new
3867
+ #
3868
+ # # Create a request. To set request fields, pass in keyword arguments.
3869
+ # request = Google::Iam::V1::SetIamPolicyRequest.new
3870
+ #
3871
+ # # Call the set_iam_policy method.
3872
+ # result = client.set_iam_policy request
3873
+ #
3874
+ # # The returned object is of type Google::Iam::V1::Policy.
3875
+ # p result
3876
+ #
3877
+ def set_iam_policy request, options = nil
3878
+ raise ::ArgumentError, "request must be provided" if request.nil?
3879
+
3880
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Iam::V1::SetIamPolicyRequest
3881
+
3882
+ # Converts hash and nil to an options object
3883
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
3884
+
3885
+ # Customize the options with defaults
3886
+ metadata = @config.rpcs.set_iam_policy.metadata.to_h
3887
+
3888
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
3889
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
3890
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
3891
+ gapic_version: ::Google::Cloud::ArtifactRegistry::V1::VERSION
3892
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
3893
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
3894
+
3895
+ header_params = {}
3896
+ if request.resource
3897
+ header_params["resource"] = request.resource
3898
+ end
3899
+
3900
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
3901
+ metadata[:"x-goog-request-params"] ||= request_params_header
3902
+
3903
+ options.apply_defaults timeout: @config.rpcs.set_iam_policy.timeout,
3904
+ metadata: metadata,
3905
+ retry_policy: @config.rpcs.set_iam_policy.retry_policy
3906
+
3907
+ options.apply_defaults timeout: @config.timeout,
3908
+ metadata: @config.metadata,
3909
+ retry_policy: @config.retry_policy
3910
+
3911
+ @artifact_registry_stub.call_rpc :set_iam_policy, request, options: options do |response, operation|
3912
+ yield response, operation if block_given?
3913
+ end
3914
+ rescue ::GRPC::BadStatus => e
3915
+ raise ::Google::Cloud::Error.from_error(e)
3916
+ end
3917
+
3918
+ ##
3919
+ # Gets the IAM policy for a given resource.
3920
+ #
3921
+ # @overload get_iam_policy(request, options = nil)
3922
+ # Pass arguments to `get_iam_policy` via a request object, either of type
3923
+ # {::Google::Iam::V1::GetIamPolicyRequest} or an equivalent Hash.
3924
+ #
3925
+ # @param request [::Google::Iam::V1::GetIamPolicyRequest, ::Hash]
3926
+ # A request object representing the call parameters. Required. To specify no
3927
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
3928
+ # @param options [::Gapic::CallOptions, ::Hash]
3929
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
3930
+ #
3931
+ # @overload get_iam_policy(resource: nil, options: nil)
3932
+ # Pass arguments to `get_iam_policy` via keyword arguments. Note that at
3933
+ # least one keyword argument is required. To specify no parameters, or to keep all
3934
+ # the default parameter values, pass an empty Hash as a request object (see above).
3935
+ #
3936
+ # @param resource [::String]
3937
+ # REQUIRED: The resource for which the policy is being requested.
3938
+ # See the operation documentation for the appropriate value for this field.
3939
+ # @param options [::Google::Iam::V1::GetPolicyOptions, ::Hash]
3940
+ # OPTIONAL: A `GetPolicyOptions` object for specifying options to
3941
+ # `GetIamPolicy`.
3942
+ #
3943
+ # @yield [response, operation] Access the result along with the RPC operation
3944
+ # @yieldparam response [::Google::Iam::V1::Policy]
3945
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
3946
+ #
3947
+ # @return [::Google::Iam::V1::Policy]
3948
+ #
3949
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
3950
+ #
3951
+ # @example Basic example
3952
+ # require "google/cloud/artifact_registry/v1"
3953
+ #
3954
+ # # Create a client object. The client can be reused for multiple calls.
3955
+ # client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Client.new
3956
+ #
3957
+ # # Create a request. To set request fields, pass in keyword arguments.
3958
+ # request = Google::Iam::V1::GetIamPolicyRequest.new
3959
+ #
3960
+ # # Call the get_iam_policy method.
3961
+ # result = client.get_iam_policy request
3962
+ #
3963
+ # # The returned object is of type Google::Iam::V1::Policy.
3964
+ # p result
3965
+ #
3966
+ def get_iam_policy request, options = nil
3967
+ raise ::ArgumentError, "request must be provided" if request.nil?
3968
+
3969
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Iam::V1::GetIamPolicyRequest
3970
+
3971
+ # Converts hash and nil to an options object
3972
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
3973
+
3974
+ # Customize the options with defaults
3975
+ metadata = @config.rpcs.get_iam_policy.metadata.to_h
3976
+
3977
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
3978
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
3979
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
3980
+ gapic_version: ::Google::Cloud::ArtifactRegistry::V1::VERSION
3981
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
3982
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
3983
+
3984
+ header_params = {}
3985
+ if request.resource
3986
+ header_params["resource"] = request.resource
3987
+ end
3988
+
3989
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
3990
+ metadata[:"x-goog-request-params"] ||= request_params_header
3991
+
3992
+ options.apply_defaults timeout: @config.rpcs.get_iam_policy.timeout,
3993
+ metadata: metadata,
3994
+ retry_policy: @config.rpcs.get_iam_policy.retry_policy
3995
+
3996
+ options.apply_defaults timeout: @config.timeout,
3997
+ metadata: @config.metadata,
3998
+ retry_policy: @config.retry_policy
3999
+
4000
+ @artifact_registry_stub.call_rpc :get_iam_policy, request, options: options do |response, operation|
4001
+ yield response, operation if block_given?
4002
+ end
4003
+ rescue ::GRPC::BadStatus => e
4004
+ raise ::Google::Cloud::Error.from_error(e)
4005
+ end
4006
+
4007
+ ##
4008
+ # Tests if the caller has a list of permissions on a resource.
4009
+ #
4010
+ # @overload test_iam_permissions(request, options = nil)
4011
+ # Pass arguments to `test_iam_permissions` via a request object, either of type
4012
+ # {::Google::Iam::V1::TestIamPermissionsRequest} or an equivalent Hash.
4013
+ #
4014
+ # @param request [::Google::Iam::V1::TestIamPermissionsRequest, ::Hash]
4015
+ # A request object representing the call parameters. Required. To specify no
4016
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
4017
+ # @param options [::Gapic::CallOptions, ::Hash]
4018
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
4019
+ #
4020
+ # @overload test_iam_permissions(resource: nil, permissions: nil)
4021
+ # Pass arguments to `test_iam_permissions` via keyword arguments. Note that at
4022
+ # least one keyword argument is required. To specify no parameters, or to keep all
4023
+ # the default parameter values, pass an empty Hash as a request object (see above).
4024
+ #
4025
+ # @param resource [::String]
4026
+ # REQUIRED: The resource for which the policy detail is being requested.
4027
+ # See the operation documentation for the appropriate value for this field.
4028
+ # @param permissions [::Array<::String>]
4029
+ # The set of permissions to check for the `resource`. Permissions with
4030
+ # wildcards (such as '*' or 'storage.*') are not allowed. For more
4031
+ # information see
4032
+ # [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
4033
+ #
4034
+ # @yield [response, operation] Access the result along with the RPC operation
4035
+ # @yieldparam response [::Google::Iam::V1::TestIamPermissionsResponse]
4036
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
4037
+ #
4038
+ # @return [::Google::Iam::V1::TestIamPermissionsResponse]
4039
+ #
4040
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
4041
+ #
4042
+ # @example Basic example
4043
+ # require "google/cloud/artifact_registry/v1"
4044
+ #
4045
+ # # Create a client object. The client can be reused for multiple calls.
4046
+ # client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Client.new
4047
+ #
4048
+ # # Create a request. To set request fields, pass in keyword arguments.
4049
+ # request = Google::Iam::V1::TestIamPermissionsRequest.new
4050
+ #
4051
+ # # Call the test_iam_permissions method.
4052
+ # result = client.test_iam_permissions request
4053
+ #
4054
+ # # The returned object is of type Google::Iam::V1::TestIamPermissionsResponse.
4055
+ # p result
4056
+ #
4057
+ def test_iam_permissions request, options = nil
4058
+ raise ::ArgumentError, "request must be provided" if request.nil?
4059
+
4060
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Iam::V1::TestIamPermissionsRequest
4061
+
4062
+ # Converts hash and nil to an options object
4063
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
4064
+
4065
+ # Customize the options with defaults
4066
+ metadata = @config.rpcs.test_iam_permissions.metadata.to_h
4067
+
4068
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
4069
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
4070
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
4071
+ gapic_version: ::Google::Cloud::ArtifactRegistry::V1::VERSION
4072
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
4073
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
4074
+
4075
+ header_params = {}
4076
+ if request.resource
4077
+ header_params["resource"] = request.resource
4078
+ end
4079
+
4080
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
4081
+ metadata[:"x-goog-request-params"] ||= request_params_header
4082
+
4083
+ options.apply_defaults timeout: @config.rpcs.test_iam_permissions.timeout,
4084
+ metadata: metadata,
4085
+ retry_policy: @config.rpcs.test_iam_permissions.retry_policy
4086
+
4087
+ options.apply_defaults timeout: @config.timeout,
4088
+ metadata: @config.metadata,
4089
+ retry_policy: @config.retry_policy
4090
+
4091
+ @artifact_registry_stub.call_rpc :test_iam_permissions, request, options: options do |response, operation|
4092
+ yield response, operation if block_given?
4093
+ end
4094
+ rescue ::GRPC::BadStatus => e
4095
+ raise ::Google::Cloud::Error.from_error(e)
4096
+ end
4097
+
4098
+ ##
4099
+ # Retrieves the Settings for the Project.
4100
+ #
4101
+ # @overload get_project_settings(request, options = nil)
4102
+ # Pass arguments to `get_project_settings` via a request object, either of type
4103
+ # {::Google::Cloud::ArtifactRegistry::V1::GetProjectSettingsRequest} or an equivalent Hash.
4104
+ #
4105
+ # @param request [::Google::Cloud::ArtifactRegistry::V1::GetProjectSettingsRequest, ::Hash]
4106
+ # A request object representing the call parameters. Required. To specify no
4107
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
4108
+ # @param options [::Gapic::CallOptions, ::Hash]
4109
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
4110
+ #
4111
+ # @overload get_project_settings(name: nil)
4112
+ # Pass arguments to `get_project_settings` via keyword arguments. Note that at
4113
+ # least one keyword argument is required. To specify no parameters, or to keep all
4114
+ # the default parameter values, pass an empty Hash as a request object (see above).
4115
+ #
4116
+ # @param name [::String]
4117
+ # Required. The name of the projectSettings resource.
4118
+ #
4119
+ # @yield [response, operation] Access the result along with the RPC operation
4120
+ # @yieldparam response [::Google::Cloud::ArtifactRegistry::V1::ProjectSettings]
4121
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
4122
+ #
4123
+ # @return [::Google::Cloud::ArtifactRegistry::V1::ProjectSettings]
4124
+ #
4125
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
4126
+ #
4127
+ # @example Basic example
4128
+ # require "google/cloud/artifact_registry/v1"
4129
+ #
4130
+ # # Create a client object. The client can be reused for multiple calls.
4131
+ # client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Client.new
4132
+ #
4133
+ # # Create a request. To set request fields, pass in keyword arguments.
4134
+ # request = Google::Cloud::ArtifactRegistry::V1::GetProjectSettingsRequest.new
4135
+ #
4136
+ # # Call the get_project_settings method.
4137
+ # result = client.get_project_settings request
4138
+ #
4139
+ # # The returned object is of type Google::Cloud::ArtifactRegistry::V1::ProjectSettings.
4140
+ # p result
4141
+ #
4142
+ def get_project_settings request, options = nil
4143
+ raise ::ArgumentError, "request must be provided" if request.nil?
4144
+
4145
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ArtifactRegistry::V1::GetProjectSettingsRequest
4146
+
4147
+ # Converts hash and nil to an options object
4148
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
4149
+
4150
+ # Customize the options with defaults
4151
+ metadata = @config.rpcs.get_project_settings.metadata.to_h
4152
+
4153
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
4154
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
4155
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
4156
+ gapic_version: ::Google::Cloud::ArtifactRegistry::V1::VERSION
4157
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
4158
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
4159
+
4160
+ header_params = {}
4161
+ if request.name
4162
+ header_params["name"] = request.name
4163
+ end
4164
+
4165
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
4166
+ metadata[:"x-goog-request-params"] ||= request_params_header
4167
+
4168
+ options.apply_defaults timeout: @config.rpcs.get_project_settings.timeout,
4169
+ metadata: metadata,
4170
+ retry_policy: @config.rpcs.get_project_settings.retry_policy
4171
+
4172
+ options.apply_defaults timeout: @config.timeout,
4173
+ metadata: @config.metadata,
4174
+ retry_policy: @config.retry_policy
4175
+
4176
+ @artifact_registry_stub.call_rpc :get_project_settings, request, options: options do |response, operation|
4177
+ yield response, operation if block_given?
4178
+ end
4179
+ rescue ::GRPC::BadStatus => e
4180
+ raise ::Google::Cloud::Error.from_error(e)
4181
+ end
4182
+
4183
+ ##
4184
+ # Updates the Settings for the Project.
4185
+ #
4186
+ # @overload update_project_settings(request, options = nil)
4187
+ # Pass arguments to `update_project_settings` via a request object, either of type
4188
+ # {::Google::Cloud::ArtifactRegistry::V1::UpdateProjectSettingsRequest} or an equivalent Hash.
4189
+ #
4190
+ # @param request [::Google::Cloud::ArtifactRegistry::V1::UpdateProjectSettingsRequest, ::Hash]
4191
+ # A request object representing the call parameters. Required. To specify no
4192
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
4193
+ # @param options [::Gapic::CallOptions, ::Hash]
4194
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
4195
+ #
4196
+ # @overload update_project_settings(project_settings: nil, update_mask: nil)
4197
+ # Pass arguments to `update_project_settings` via keyword arguments. Note that at
4198
+ # least one keyword argument is required. To specify no parameters, or to keep all
4199
+ # the default parameter values, pass an empty Hash as a request object (see above).
4200
+ #
4201
+ # @param project_settings [::Google::Cloud::ArtifactRegistry::V1::ProjectSettings, ::Hash]
4202
+ # The project settings.
4203
+ # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
4204
+ # Field mask to support partial updates.
4205
+ #
4206
+ # @yield [response, operation] Access the result along with the RPC operation
4207
+ # @yieldparam response [::Google::Cloud::ArtifactRegistry::V1::ProjectSettings]
4208
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
4209
+ #
4210
+ # @return [::Google::Cloud::ArtifactRegistry::V1::ProjectSettings]
4211
+ #
4212
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
4213
+ #
4214
+ # @example Basic example
4215
+ # require "google/cloud/artifact_registry/v1"
4216
+ #
4217
+ # # Create a client object. The client can be reused for multiple calls.
4218
+ # client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Client.new
4219
+ #
4220
+ # # Create a request. To set request fields, pass in keyword arguments.
4221
+ # request = Google::Cloud::ArtifactRegistry::V1::UpdateProjectSettingsRequest.new
4222
+ #
4223
+ # # Call the update_project_settings method.
4224
+ # result = client.update_project_settings request
4225
+ #
4226
+ # # The returned object is of type Google::Cloud::ArtifactRegistry::V1::ProjectSettings.
4227
+ # p result
4228
+ #
4229
+ def update_project_settings request, options = nil
4230
+ raise ::ArgumentError, "request must be provided" if request.nil?
4231
+
4232
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ArtifactRegistry::V1::UpdateProjectSettingsRequest
4233
+
4234
+ # Converts hash and nil to an options object
4235
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
4236
+
4237
+ # Customize the options with defaults
4238
+ metadata = @config.rpcs.update_project_settings.metadata.to_h
4239
+
4240
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
4241
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
4242
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
4243
+ gapic_version: ::Google::Cloud::ArtifactRegistry::V1::VERSION
4244
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
4245
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
4246
+
4247
+ header_params = {}
4248
+ if request.project_settings&.name
4249
+ header_params["project_settings.name"] = request.project_settings.name
4250
+ end
4251
+
4252
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
4253
+ metadata[:"x-goog-request-params"] ||= request_params_header
4254
+
4255
+ options.apply_defaults timeout: @config.rpcs.update_project_settings.timeout,
4256
+ metadata: metadata,
4257
+ retry_policy: @config.rpcs.update_project_settings.retry_policy
4258
+
4259
+ options.apply_defaults timeout: @config.timeout,
4260
+ metadata: @config.metadata,
4261
+ retry_policy: @config.retry_policy
4262
+
4263
+ @artifact_registry_stub.call_rpc :update_project_settings, request, options: options do |response, operation|
4264
+ yield response, operation if block_given?
4265
+ end
4266
+ rescue ::GRPC::BadStatus => e
4267
+ raise ::Google::Cloud::Error.from_error(e)
4268
+ end
4269
+
4270
+ ##
4271
+ # Retrieves the VPCSC Config for the Project.
4272
+ #
4273
+ # @overload get_vpcsc_config(request, options = nil)
4274
+ # Pass arguments to `get_vpcsc_config` via a request object, either of type
4275
+ # {::Google::Cloud::ArtifactRegistry::V1::GetVPCSCConfigRequest} or an equivalent Hash.
4276
+ #
4277
+ # @param request [::Google::Cloud::ArtifactRegistry::V1::GetVPCSCConfigRequest, ::Hash]
4278
+ # A request object representing the call parameters. Required. To specify no
4279
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
4280
+ # @param options [::Gapic::CallOptions, ::Hash]
4281
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
4282
+ #
4283
+ # @overload get_vpcsc_config(name: nil)
4284
+ # Pass arguments to `get_vpcsc_config` via keyword arguments. Note that at
4285
+ # least one keyword argument is required. To specify no parameters, or to keep all
4286
+ # the default parameter values, pass an empty Hash as a request object (see above).
4287
+ #
4288
+ # @param name [::String]
4289
+ # Required. The name of the VPCSCConfig resource.
4290
+ #
4291
+ # @yield [response, operation] Access the result along with the RPC operation
4292
+ # @yieldparam response [::Google::Cloud::ArtifactRegistry::V1::VPCSCConfig]
4293
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
4294
+ #
4295
+ # @return [::Google::Cloud::ArtifactRegistry::V1::VPCSCConfig]
4296
+ #
4297
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
4298
+ #
4299
+ # @example Basic example
4300
+ # require "google/cloud/artifact_registry/v1"
4301
+ #
4302
+ # # Create a client object. The client can be reused for multiple calls.
4303
+ # client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Client.new
4304
+ #
4305
+ # # Create a request. To set request fields, pass in keyword arguments.
4306
+ # request = Google::Cloud::ArtifactRegistry::V1::GetVPCSCConfigRequest.new
4307
+ #
4308
+ # # Call the get_vpcsc_config method.
4309
+ # result = client.get_vpcsc_config request
4310
+ #
4311
+ # # The returned object is of type Google::Cloud::ArtifactRegistry::V1::VPCSCConfig.
4312
+ # p result
4313
+ #
4314
+ def get_vpcsc_config request, options = nil
4315
+ raise ::ArgumentError, "request must be provided" if request.nil?
4316
+
4317
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ArtifactRegistry::V1::GetVPCSCConfigRequest
4318
+
4319
+ # Converts hash and nil to an options object
4320
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
4321
+
4322
+ # Customize the options with defaults
4323
+ metadata = @config.rpcs.get_vpcsc_config.metadata.to_h
4324
+
4325
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
4326
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
4327
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
4328
+ gapic_version: ::Google::Cloud::ArtifactRegistry::V1::VERSION
4329
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
4330
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
4331
+
4332
+ header_params = {}
4333
+ if request.name
4334
+ header_params["name"] = request.name
4335
+ end
4336
+
4337
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
4338
+ metadata[:"x-goog-request-params"] ||= request_params_header
4339
+
4340
+ options.apply_defaults timeout: @config.rpcs.get_vpcsc_config.timeout,
4341
+ metadata: metadata,
4342
+ retry_policy: @config.rpcs.get_vpcsc_config.retry_policy
4343
+
4344
+ options.apply_defaults timeout: @config.timeout,
4345
+ metadata: @config.metadata,
4346
+ retry_policy: @config.retry_policy
4347
+
4348
+ @artifact_registry_stub.call_rpc :get_vpcsc_config, request, options: options do |response, operation|
4349
+ yield response, operation if block_given?
4350
+ end
4351
+ rescue ::GRPC::BadStatus => e
4352
+ raise ::Google::Cloud::Error.from_error(e)
4353
+ end
4354
+
4355
+ ##
4356
+ # Updates the VPCSC Config for the Project.
4357
+ #
4358
+ # @overload update_vpcsc_config(request, options = nil)
4359
+ # Pass arguments to `update_vpcsc_config` via a request object, either of type
4360
+ # {::Google::Cloud::ArtifactRegistry::V1::UpdateVPCSCConfigRequest} or an equivalent Hash.
4361
+ #
4362
+ # @param request [::Google::Cloud::ArtifactRegistry::V1::UpdateVPCSCConfigRequest, ::Hash]
4363
+ # A request object representing the call parameters. Required. To specify no
4364
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
4365
+ # @param options [::Gapic::CallOptions, ::Hash]
4366
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
4367
+ #
4368
+ # @overload update_vpcsc_config(vpcsc_config: nil, update_mask: nil)
4369
+ # Pass arguments to `update_vpcsc_config` via keyword arguments. Note that at
4370
+ # least one keyword argument is required. To specify no parameters, or to keep all
4371
+ # the default parameter values, pass an empty Hash as a request object (see above).
4372
+ #
4373
+ # @param vpcsc_config [::Google::Cloud::ArtifactRegistry::V1::VPCSCConfig, ::Hash]
4374
+ # The project config.
4375
+ # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
4376
+ # Field mask to support partial updates.
3044
4377
  #
3045
4378
  # @yield [response, operation] Access the result along with the RPC operation
3046
- # @yieldparam response [::Google::Iam::V1::Policy]
4379
+ # @yieldparam response [::Google::Cloud::ArtifactRegistry::V1::VPCSCConfig]
3047
4380
  # @yieldparam operation [::GRPC::ActiveCall::Operation]
3048
4381
  #
3049
- # @return [::Google::Iam::V1::Policy]
4382
+ # @return [::Google::Cloud::ArtifactRegistry::V1::VPCSCConfig]
3050
4383
  #
3051
4384
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
3052
4385
  #
@@ -3057,24 +4390,24 @@ module Google
3057
4390
  # client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Client.new
3058
4391
  #
3059
4392
  # # Create a request. To set request fields, pass in keyword arguments.
3060
- # request = Google::Iam::V1::GetIamPolicyRequest.new
4393
+ # request = Google::Cloud::ArtifactRegistry::V1::UpdateVPCSCConfigRequest.new
3061
4394
  #
3062
- # # Call the get_iam_policy method.
3063
- # result = client.get_iam_policy request
4395
+ # # Call the update_vpcsc_config method.
4396
+ # result = client.update_vpcsc_config request
3064
4397
  #
3065
- # # The returned object is of type Google::Iam::V1::Policy.
4398
+ # # The returned object is of type Google::Cloud::ArtifactRegistry::V1::VPCSCConfig.
3066
4399
  # p result
3067
4400
  #
3068
- def get_iam_policy request, options = nil
4401
+ def update_vpcsc_config request, options = nil
3069
4402
  raise ::ArgumentError, "request must be provided" if request.nil?
3070
4403
 
3071
- request = ::Gapic::Protobuf.coerce request, to: ::Google::Iam::V1::GetIamPolicyRequest
4404
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ArtifactRegistry::V1::UpdateVPCSCConfigRequest
3072
4405
 
3073
4406
  # Converts hash and nil to an options object
3074
4407
  options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
3075
4408
 
3076
4409
  # Customize the options with defaults
3077
- metadata = @config.rpcs.get_iam_policy.metadata.to_h
4410
+ metadata = @config.rpcs.update_vpcsc_config.metadata.to_h
3078
4411
 
3079
4412
  # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
3080
4413
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
@@ -3084,61 +4417,58 @@ module Google
3084
4417
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
3085
4418
 
3086
4419
  header_params = {}
3087
- if request.resource
3088
- header_params["resource"] = request.resource
4420
+ if request.vpcsc_config&.name
4421
+ header_params["vpcsc_config.name"] = request.vpcsc_config.name
3089
4422
  end
3090
4423
 
3091
4424
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
3092
4425
  metadata[:"x-goog-request-params"] ||= request_params_header
3093
4426
 
3094
- options.apply_defaults timeout: @config.rpcs.get_iam_policy.timeout,
4427
+ options.apply_defaults timeout: @config.rpcs.update_vpcsc_config.timeout,
3095
4428
  metadata: metadata,
3096
- retry_policy: @config.rpcs.get_iam_policy.retry_policy
4429
+ retry_policy: @config.rpcs.update_vpcsc_config.retry_policy
3097
4430
 
3098
4431
  options.apply_defaults timeout: @config.timeout,
3099
4432
  metadata: @config.metadata,
3100
4433
  retry_policy: @config.retry_policy
3101
4434
 
3102
- @artifact_registry_stub.call_rpc :get_iam_policy, request, options: options do |response, operation|
4435
+ @artifact_registry_stub.call_rpc :update_vpcsc_config, request, options: options do |response, operation|
3103
4436
  yield response, operation if block_given?
3104
- return response
3105
4437
  end
3106
4438
  rescue ::GRPC::BadStatus => e
3107
4439
  raise ::Google::Cloud::Error.from_error(e)
3108
4440
  end
3109
4441
 
3110
4442
  ##
3111
- # Tests if the caller has a list of permissions on a resource.
4443
+ # Updates a package.
3112
4444
  #
3113
- # @overload test_iam_permissions(request, options = nil)
3114
- # Pass arguments to `test_iam_permissions` via a request object, either of type
3115
- # {::Google::Iam::V1::TestIamPermissionsRequest} or an equivalent Hash.
4445
+ # @overload update_package(request, options = nil)
4446
+ # Pass arguments to `update_package` via a request object, either of type
4447
+ # {::Google::Cloud::ArtifactRegistry::V1::UpdatePackageRequest} or an equivalent Hash.
3116
4448
  #
3117
- # @param request [::Google::Iam::V1::TestIamPermissionsRequest, ::Hash]
4449
+ # @param request [::Google::Cloud::ArtifactRegistry::V1::UpdatePackageRequest, ::Hash]
3118
4450
  # A request object representing the call parameters. Required. To specify no
3119
4451
  # parameters, or to keep all the default parameter values, pass an empty Hash.
3120
4452
  # @param options [::Gapic::CallOptions, ::Hash]
3121
4453
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
3122
4454
  #
3123
- # @overload test_iam_permissions(resource: nil, permissions: nil)
3124
- # Pass arguments to `test_iam_permissions` via keyword arguments. Note that at
4455
+ # @overload update_package(package: nil, update_mask: nil)
4456
+ # Pass arguments to `update_package` via keyword arguments. Note that at
3125
4457
  # least one keyword argument is required. To specify no parameters, or to keep all
3126
4458
  # the default parameter values, pass an empty Hash as a request object (see above).
3127
4459
  #
3128
- # @param resource [::String]
3129
- # REQUIRED: The resource for which the policy detail is being requested.
3130
- # See the operation documentation for the appropriate value for this field.
3131
- # @param permissions [::Array<::String>]
3132
- # The set of permissions to check for the `resource`. Permissions with
3133
- # wildcards (such as '*' or 'storage.*') are not allowed. For more
3134
- # information see
3135
- # [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
4460
+ # @param package [::Google::Cloud::ArtifactRegistry::V1::Package, ::Hash]
4461
+ # The package that replaces the resource on the server.
4462
+ # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
4463
+ # The update mask applies to the resource. For the `FieldMask` definition,
4464
+ # see
4465
+ # https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask
3136
4466
  #
3137
4467
  # @yield [response, operation] Access the result along with the RPC operation
3138
- # @yieldparam response [::Google::Iam::V1::TestIamPermissionsResponse]
4468
+ # @yieldparam response [::Google::Cloud::ArtifactRegistry::V1::Package]
3139
4469
  # @yieldparam operation [::GRPC::ActiveCall::Operation]
3140
4470
  #
3141
- # @return [::Google::Iam::V1::TestIamPermissionsResponse]
4471
+ # @return [::Google::Cloud::ArtifactRegistry::V1::Package]
3142
4472
  #
3143
4473
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
3144
4474
  #
@@ -3149,24 +4479,24 @@ module Google
3149
4479
  # client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Client.new
3150
4480
  #
3151
4481
  # # Create a request. To set request fields, pass in keyword arguments.
3152
- # request = Google::Iam::V1::TestIamPermissionsRequest.new
4482
+ # request = Google::Cloud::ArtifactRegistry::V1::UpdatePackageRequest.new
3153
4483
  #
3154
- # # Call the test_iam_permissions method.
3155
- # result = client.test_iam_permissions request
4484
+ # # Call the update_package method.
4485
+ # result = client.update_package request
3156
4486
  #
3157
- # # The returned object is of type Google::Iam::V1::TestIamPermissionsResponse.
4487
+ # # The returned object is of type Google::Cloud::ArtifactRegistry::V1::Package.
3158
4488
  # p result
3159
4489
  #
3160
- def test_iam_permissions request, options = nil
4490
+ def update_package request, options = nil
3161
4491
  raise ::ArgumentError, "request must be provided" if request.nil?
3162
4492
 
3163
- request = ::Gapic::Protobuf.coerce request, to: ::Google::Iam::V1::TestIamPermissionsRequest
4493
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ArtifactRegistry::V1::UpdatePackageRequest
3164
4494
 
3165
4495
  # Converts hash and nil to an options object
3166
4496
  options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
3167
4497
 
3168
4498
  # Customize the options with defaults
3169
- metadata = @config.rpcs.test_iam_permissions.metadata.to_h
4499
+ metadata = @config.rpcs.update_package.metadata.to_h
3170
4500
 
3171
4501
  # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
3172
4502
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
@@ -3176,55 +4506,65 @@ module Google
3176
4506
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
3177
4507
 
3178
4508
  header_params = {}
3179
- if request.resource
3180
- header_params["resource"] = request.resource
4509
+ if request.package&.name
4510
+ header_params["package.name"] = request.package.name
3181
4511
  end
3182
4512
 
3183
4513
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
3184
4514
  metadata[:"x-goog-request-params"] ||= request_params_header
3185
4515
 
3186
- options.apply_defaults timeout: @config.rpcs.test_iam_permissions.timeout,
4516
+ options.apply_defaults timeout: @config.rpcs.update_package.timeout,
3187
4517
  metadata: metadata,
3188
- retry_policy: @config.rpcs.test_iam_permissions.retry_policy
4518
+ retry_policy: @config.rpcs.update_package.retry_policy
3189
4519
 
3190
4520
  options.apply_defaults timeout: @config.timeout,
3191
4521
  metadata: @config.metadata,
3192
4522
  retry_policy: @config.retry_policy
3193
4523
 
3194
- @artifact_registry_stub.call_rpc :test_iam_permissions, request, options: options do |response, operation|
4524
+ @artifact_registry_stub.call_rpc :update_package, request, options: options do |response, operation|
3195
4525
  yield response, operation if block_given?
3196
- return response
3197
4526
  end
3198
4527
  rescue ::GRPC::BadStatus => e
3199
4528
  raise ::Google::Cloud::Error.from_error(e)
3200
4529
  end
3201
4530
 
3202
4531
  ##
3203
- # Retrieves the Settings for the Project.
4532
+ # Lists attachments.
3204
4533
  #
3205
- # @overload get_project_settings(request, options = nil)
3206
- # Pass arguments to `get_project_settings` via a request object, either of type
3207
- # {::Google::Cloud::ArtifactRegistry::V1::GetProjectSettingsRequest} or an equivalent Hash.
4534
+ # @overload list_attachments(request, options = nil)
4535
+ # Pass arguments to `list_attachments` via a request object, either of type
4536
+ # {::Google::Cloud::ArtifactRegistry::V1::ListAttachmentsRequest} or an equivalent Hash.
3208
4537
  #
3209
- # @param request [::Google::Cloud::ArtifactRegistry::V1::GetProjectSettingsRequest, ::Hash]
4538
+ # @param request [::Google::Cloud::ArtifactRegistry::V1::ListAttachmentsRequest, ::Hash]
3210
4539
  # A request object representing the call parameters. Required. To specify no
3211
4540
  # parameters, or to keep all the default parameter values, pass an empty Hash.
3212
4541
  # @param options [::Gapic::CallOptions, ::Hash]
3213
4542
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
3214
4543
  #
3215
- # @overload get_project_settings(name: nil)
3216
- # Pass arguments to `get_project_settings` via keyword arguments. Note that at
4544
+ # @overload list_attachments(parent: nil, filter: nil, page_size: nil, page_token: nil)
4545
+ # Pass arguments to `list_attachments` via keyword arguments. Note that at
3217
4546
  # least one keyword argument is required. To specify no parameters, or to keep all
3218
4547
  # the default parameter values, pass an empty Hash as a request object (see above).
3219
4548
  #
3220
- # @param name [::String]
3221
- # Required. The name of the projectSettings resource.
4549
+ # @param parent [::String]
4550
+ # Required. The name of the parent resource whose attachments will be listed.
4551
+ # @param filter [::String]
4552
+ # Optional. An expression for filtering the results of the request. Filter
4553
+ # rules are case insensitive. The fields eligible for filtering are:
4554
+ #
4555
+ # * `target`
4556
+ # * `type`
4557
+ # * `attachment_namespace`
4558
+ # @param page_size [::Integer]
4559
+ # The maximum number of attachments to return. Maximum page size is 1,000.
4560
+ # @param page_token [::String]
4561
+ # The next_page_token value returned from a previous list request, if any.
3222
4562
  #
3223
4563
  # @yield [response, operation] Access the result along with the RPC operation
3224
- # @yieldparam response [::Google::Cloud::ArtifactRegistry::V1::ProjectSettings]
4564
+ # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::ArtifactRegistry::V1::Attachment>]
3225
4565
  # @yieldparam operation [::GRPC::ActiveCall::Operation]
3226
4566
  #
3227
- # @return [::Google::Cloud::ArtifactRegistry::V1::ProjectSettings]
4567
+ # @return [::Gapic::PagedEnumerable<::Google::Cloud::ArtifactRegistry::V1::Attachment>]
3228
4568
  #
3229
4569
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
3230
4570
  #
@@ -3235,24 +4575,28 @@ module Google
3235
4575
  # client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Client.new
3236
4576
  #
3237
4577
  # # Create a request. To set request fields, pass in keyword arguments.
3238
- # request = Google::Cloud::ArtifactRegistry::V1::GetProjectSettingsRequest.new
4578
+ # request = Google::Cloud::ArtifactRegistry::V1::ListAttachmentsRequest.new
3239
4579
  #
3240
- # # Call the get_project_settings method.
3241
- # result = client.get_project_settings request
4580
+ # # Call the list_attachments method.
4581
+ # result = client.list_attachments request
3242
4582
  #
3243
- # # The returned object is of type Google::Cloud::ArtifactRegistry::V1::ProjectSettings.
3244
- # p result
4583
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
4584
+ # # over elements, and API calls will be issued to fetch pages as needed.
4585
+ # result.each do |item|
4586
+ # # Each element is of type ::Google::Cloud::ArtifactRegistry::V1::Attachment.
4587
+ # p item
4588
+ # end
3245
4589
  #
3246
- def get_project_settings request, options = nil
4590
+ def list_attachments request, options = nil
3247
4591
  raise ::ArgumentError, "request must be provided" if request.nil?
3248
4592
 
3249
- request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ArtifactRegistry::V1::GetProjectSettingsRequest
4593
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ArtifactRegistry::V1::ListAttachmentsRequest
3250
4594
 
3251
4595
  # Converts hash and nil to an options object
3252
4596
  options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
3253
4597
 
3254
4598
  # Customize the options with defaults
3255
- metadata = @config.rpcs.get_project_settings.metadata.to_h
4599
+ metadata = @config.rpcs.list_attachments.metadata.to_h
3256
4600
 
3257
4601
  # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
3258
4602
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
@@ -3262,57 +4606,56 @@ module Google
3262
4606
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
3263
4607
 
3264
4608
  header_params = {}
3265
- if request.name
3266
- header_params["name"] = request.name
4609
+ if request.parent
4610
+ header_params["parent"] = request.parent
3267
4611
  end
3268
4612
 
3269
4613
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
3270
4614
  metadata[:"x-goog-request-params"] ||= request_params_header
3271
4615
 
3272
- options.apply_defaults timeout: @config.rpcs.get_project_settings.timeout,
4616
+ options.apply_defaults timeout: @config.rpcs.list_attachments.timeout,
3273
4617
  metadata: metadata,
3274
- retry_policy: @config.rpcs.get_project_settings.retry_policy
4618
+ retry_policy: @config.rpcs.list_attachments.retry_policy
3275
4619
 
3276
4620
  options.apply_defaults timeout: @config.timeout,
3277
4621
  metadata: @config.metadata,
3278
4622
  retry_policy: @config.retry_policy
3279
4623
 
3280
- @artifact_registry_stub.call_rpc :get_project_settings, request, options: options do |response, operation|
4624
+ @artifact_registry_stub.call_rpc :list_attachments, request, options: options do |response, operation|
4625
+ response = ::Gapic::PagedEnumerable.new @artifact_registry_stub, :list_attachments, request, response, operation, options
3281
4626
  yield response, operation if block_given?
3282
- return response
4627
+ throw :response, response
3283
4628
  end
3284
4629
  rescue ::GRPC::BadStatus => e
3285
4630
  raise ::Google::Cloud::Error.from_error(e)
3286
4631
  end
3287
4632
 
3288
4633
  ##
3289
- # Updates the Settings for the Project.
4634
+ # Gets an attachment.
3290
4635
  #
3291
- # @overload update_project_settings(request, options = nil)
3292
- # Pass arguments to `update_project_settings` via a request object, either of type
3293
- # {::Google::Cloud::ArtifactRegistry::V1::UpdateProjectSettingsRequest} or an equivalent Hash.
4636
+ # @overload get_attachment(request, options = nil)
4637
+ # Pass arguments to `get_attachment` via a request object, either of type
4638
+ # {::Google::Cloud::ArtifactRegistry::V1::GetAttachmentRequest} or an equivalent Hash.
3294
4639
  #
3295
- # @param request [::Google::Cloud::ArtifactRegistry::V1::UpdateProjectSettingsRequest, ::Hash]
4640
+ # @param request [::Google::Cloud::ArtifactRegistry::V1::GetAttachmentRequest, ::Hash]
3296
4641
  # A request object representing the call parameters. Required. To specify no
3297
4642
  # parameters, or to keep all the default parameter values, pass an empty Hash.
3298
4643
  # @param options [::Gapic::CallOptions, ::Hash]
3299
4644
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
3300
4645
  #
3301
- # @overload update_project_settings(project_settings: nil, update_mask: nil)
3302
- # Pass arguments to `update_project_settings` via keyword arguments. Note that at
4646
+ # @overload get_attachment(name: nil)
4647
+ # Pass arguments to `get_attachment` via keyword arguments. Note that at
3303
4648
  # least one keyword argument is required. To specify no parameters, or to keep all
3304
4649
  # the default parameter values, pass an empty Hash as a request object (see above).
3305
4650
  #
3306
- # @param project_settings [::Google::Cloud::ArtifactRegistry::V1::ProjectSettings, ::Hash]
3307
- # The project settings.
3308
- # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
3309
- # Field mask to support partial updates.
4651
+ # @param name [::String]
4652
+ # Required. The name of the attachment to retrieve.
3310
4653
  #
3311
4654
  # @yield [response, operation] Access the result along with the RPC operation
3312
- # @yieldparam response [::Google::Cloud::ArtifactRegistry::V1::ProjectSettings]
4655
+ # @yieldparam response [::Google::Cloud::ArtifactRegistry::V1::Attachment]
3313
4656
  # @yieldparam operation [::GRPC::ActiveCall::Operation]
3314
4657
  #
3315
- # @return [::Google::Cloud::ArtifactRegistry::V1::ProjectSettings]
4658
+ # @return [::Google::Cloud::ArtifactRegistry::V1::Attachment]
3316
4659
  #
3317
4660
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
3318
4661
  #
@@ -3323,24 +4666,24 @@ module Google
3323
4666
  # client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Client.new
3324
4667
  #
3325
4668
  # # Create a request. To set request fields, pass in keyword arguments.
3326
- # request = Google::Cloud::ArtifactRegistry::V1::UpdateProjectSettingsRequest.new
4669
+ # request = Google::Cloud::ArtifactRegistry::V1::GetAttachmentRequest.new
3327
4670
  #
3328
- # # Call the update_project_settings method.
3329
- # result = client.update_project_settings request
4671
+ # # Call the get_attachment method.
4672
+ # result = client.get_attachment request
3330
4673
  #
3331
- # # The returned object is of type Google::Cloud::ArtifactRegistry::V1::ProjectSettings.
4674
+ # # The returned object is of type Google::Cloud::ArtifactRegistry::V1::Attachment.
3332
4675
  # p result
3333
4676
  #
3334
- def update_project_settings request, options = nil
4677
+ def get_attachment request, options = nil
3335
4678
  raise ::ArgumentError, "request must be provided" if request.nil?
3336
4679
 
3337
- request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ArtifactRegistry::V1::UpdateProjectSettingsRequest
4680
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ArtifactRegistry::V1::GetAttachmentRequest
3338
4681
 
3339
4682
  # Converts hash and nil to an options object
3340
4683
  options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
3341
4684
 
3342
4685
  # Customize the options with defaults
3343
- metadata = @config.rpcs.update_project_settings.metadata.to_h
4686
+ metadata = @config.rpcs.get_attachment.metadata.to_h
3344
4687
 
3345
4688
  # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
3346
4689
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
@@ -3350,55 +4693,60 @@ module Google
3350
4693
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
3351
4694
 
3352
4695
  header_params = {}
3353
- if request.project_settings&.name
3354
- header_params["project_settings.name"] = request.project_settings.name
4696
+ if request.name
4697
+ header_params["name"] = request.name
3355
4698
  end
3356
4699
 
3357
4700
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
3358
4701
  metadata[:"x-goog-request-params"] ||= request_params_header
3359
4702
 
3360
- options.apply_defaults timeout: @config.rpcs.update_project_settings.timeout,
4703
+ options.apply_defaults timeout: @config.rpcs.get_attachment.timeout,
3361
4704
  metadata: metadata,
3362
- retry_policy: @config.rpcs.update_project_settings.retry_policy
4705
+ retry_policy: @config.rpcs.get_attachment.retry_policy
3363
4706
 
3364
4707
  options.apply_defaults timeout: @config.timeout,
3365
4708
  metadata: @config.metadata,
3366
4709
  retry_policy: @config.retry_policy
3367
4710
 
3368
- @artifact_registry_stub.call_rpc :update_project_settings, request, options: options do |response, operation|
4711
+ @artifact_registry_stub.call_rpc :get_attachment, request, options: options do |response, operation|
3369
4712
  yield response, operation if block_given?
3370
- return response
3371
4713
  end
3372
4714
  rescue ::GRPC::BadStatus => e
3373
4715
  raise ::Google::Cloud::Error.from_error(e)
3374
4716
  end
3375
4717
 
3376
4718
  ##
3377
- # Retrieves the VPCSC Config for the Project.
4719
+ # Creates an attachment. The returned Operation will finish once the
4720
+ # attachment has been created. Its response will be the created attachment.
3378
4721
  #
3379
- # @overload get_vpcsc_config(request, options = nil)
3380
- # Pass arguments to `get_vpcsc_config` via a request object, either of type
3381
- # {::Google::Cloud::ArtifactRegistry::V1::GetVPCSCConfigRequest} or an equivalent Hash.
4722
+ # @overload create_attachment(request, options = nil)
4723
+ # Pass arguments to `create_attachment` via a request object, either of type
4724
+ # {::Google::Cloud::ArtifactRegistry::V1::CreateAttachmentRequest} or an equivalent Hash.
3382
4725
  #
3383
- # @param request [::Google::Cloud::ArtifactRegistry::V1::GetVPCSCConfigRequest, ::Hash]
4726
+ # @param request [::Google::Cloud::ArtifactRegistry::V1::CreateAttachmentRequest, ::Hash]
3384
4727
  # A request object representing the call parameters. Required. To specify no
3385
4728
  # parameters, or to keep all the default parameter values, pass an empty Hash.
3386
4729
  # @param options [::Gapic::CallOptions, ::Hash]
3387
4730
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
3388
4731
  #
3389
- # @overload get_vpcsc_config(name: nil)
3390
- # Pass arguments to `get_vpcsc_config` via keyword arguments. Note that at
4732
+ # @overload create_attachment(parent: nil, attachment_id: nil, attachment: nil)
4733
+ # Pass arguments to `create_attachment` via keyword arguments. Note that at
3391
4734
  # least one keyword argument is required. To specify no parameters, or to keep all
3392
4735
  # the default parameter values, pass an empty Hash as a request object (see above).
3393
4736
  #
3394
- # @param name [::String]
3395
- # Required. The name of the VPCSCConfig resource.
4737
+ # @param parent [::String]
4738
+ # Required. The name of the parent resource where the attachment will be
4739
+ # created.
4740
+ # @param attachment_id [::String]
4741
+ # Required. The attachment id to use for this attachment.
4742
+ # @param attachment [::Google::Cloud::ArtifactRegistry::V1::Attachment, ::Hash]
4743
+ # Required. The attachment to be created.
3396
4744
  #
3397
4745
  # @yield [response, operation] Access the result along with the RPC operation
3398
- # @yieldparam response [::Google::Cloud::ArtifactRegistry::V1::VPCSCConfig]
4746
+ # @yieldparam response [::Gapic::Operation]
3399
4747
  # @yieldparam operation [::GRPC::ActiveCall::Operation]
3400
4748
  #
3401
- # @return [::Google::Cloud::ArtifactRegistry::V1::VPCSCConfig]
4749
+ # @return [::Gapic::Operation]
3402
4750
  #
3403
4751
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
3404
4752
  #
@@ -3409,24 +4757,31 @@ module Google
3409
4757
  # client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Client.new
3410
4758
  #
3411
4759
  # # Create a request. To set request fields, pass in keyword arguments.
3412
- # request = Google::Cloud::ArtifactRegistry::V1::GetVPCSCConfigRequest.new
4760
+ # request = Google::Cloud::ArtifactRegistry::V1::CreateAttachmentRequest.new
3413
4761
  #
3414
- # # Call the get_vpcsc_config method.
3415
- # result = client.get_vpcsc_config request
4762
+ # # Call the create_attachment method.
4763
+ # result = client.create_attachment request
3416
4764
  #
3417
- # # The returned object is of type Google::Cloud::ArtifactRegistry::V1::VPCSCConfig.
3418
- # p result
4765
+ # # The returned object is of type Gapic::Operation. You can use it to
4766
+ # # check the status of an operation, cancel it, or wait for results.
4767
+ # # Here is how to wait for a response.
4768
+ # result.wait_until_done! timeout: 60
4769
+ # if result.response?
4770
+ # p result.response
4771
+ # else
4772
+ # puts "No response received."
4773
+ # end
3419
4774
  #
3420
- def get_vpcsc_config request, options = nil
4775
+ def create_attachment request, options = nil
3421
4776
  raise ::ArgumentError, "request must be provided" if request.nil?
3422
4777
 
3423
- request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ArtifactRegistry::V1::GetVPCSCConfigRequest
4778
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ArtifactRegistry::V1::CreateAttachmentRequest
3424
4779
 
3425
4780
  # Converts hash and nil to an options object
3426
4781
  options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
3427
4782
 
3428
4783
  # Customize the options with defaults
3429
- metadata = @config.rpcs.get_vpcsc_config.metadata.to_h
4784
+ metadata = @config.rpcs.create_attachment.metadata.to_h
3430
4785
 
3431
4786
  # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
3432
4787
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
@@ -3436,57 +4791,58 @@ module Google
3436
4791
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
3437
4792
 
3438
4793
  header_params = {}
3439
- if request.name
3440
- header_params["name"] = request.name
4794
+ if request.parent
4795
+ header_params["parent"] = request.parent
3441
4796
  end
3442
4797
 
3443
4798
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
3444
4799
  metadata[:"x-goog-request-params"] ||= request_params_header
3445
4800
 
3446
- options.apply_defaults timeout: @config.rpcs.get_vpcsc_config.timeout,
4801
+ options.apply_defaults timeout: @config.rpcs.create_attachment.timeout,
3447
4802
  metadata: metadata,
3448
- retry_policy: @config.rpcs.get_vpcsc_config.retry_policy
4803
+ retry_policy: @config.rpcs.create_attachment.retry_policy
3449
4804
 
3450
4805
  options.apply_defaults timeout: @config.timeout,
3451
4806
  metadata: @config.metadata,
3452
4807
  retry_policy: @config.retry_policy
3453
4808
 
3454
- @artifact_registry_stub.call_rpc :get_vpcsc_config, request, options: options do |response, operation|
4809
+ @artifact_registry_stub.call_rpc :create_attachment, request, options: options do |response, operation|
4810
+ response = ::Gapic::Operation.new response, @operations_client, options: options
3455
4811
  yield response, operation if block_given?
3456
- return response
4812
+ throw :response, response
3457
4813
  end
3458
4814
  rescue ::GRPC::BadStatus => e
3459
4815
  raise ::Google::Cloud::Error.from_error(e)
3460
4816
  end
3461
4817
 
3462
4818
  ##
3463
- # Updates the VPCSC Config for the Project.
4819
+ # Deletes an attachment. The returned Operation will
4820
+ # finish once the attachments has been deleted. It will not have any
4821
+ # Operation metadata and will return a `google.protobuf.Empty` response.
3464
4822
  #
3465
- # @overload update_vpcsc_config(request, options = nil)
3466
- # Pass arguments to `update_vpcsc_config` via a request object, either of type
3467
- # {::Google::Cloud::ArtifactRegistry::V1::UpdateVPCSCConfigRequest} or an equivalent Hash.
4823
+ # @overload delete_attachment(request, options = nil)
4824
+ # Pass arguments to `delete_attachment` via a request object, either of type
4825
+ # {::Google::Cloud::ArtifactRegistry::V1::DeleteAttachmentRequest} or an equivalent Hash.
3468
4826
  #
3469
- # @param request [::Google::Cloud::ArtifactRegistry::V1::UpdateVPCSCConfigRequest, ::Hash]
4827
+ # @param request [::Google::Cloud::ArtifactRegistry::V1::DeleteAttachmentRequest, ::Hash]
3470
4828
  # A request object representing the call parameters. Required. To specify no
3471
4829
  # parameters, or to keep all the default parameter values, pass an empty Hash.
3472
4830
  # @param options [::Gapic::CallOptions, ::Hash]
3473
4831
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
3474
4832
  #
3475
- # @overload update_vpcsc_config(vpcsc_config: nil, update_mask: nil)
3476
- # Pass arguments to `update_vpcsc_config` via keyword arguments. Note that at
4833
+ # @overload delete_attachment(name: nil)
4834
+ # Pass arguments to `delete_attachment` via keyword arguments. Note that at
3477
4835
  # least one keyword argument is required. To specify no parameters, or to keep all
3478
4836
  # the default parameter values, pass an empty Hash as a request object (see above).
3479
4837
  #
3480
- # @param vpcsc_config [::Google::Cloud::ArtifactRegistry::V1::VPCSCConfig, ::Hash]
3481
- # The project config.
3482
- # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
3483
- # Field mask to support partial updates.
4838
+ # @param name [::String]
4839
+ # Required. The name of the attachment to delete.
3484
4840
  #
3485
4841
  # @yield [response, operation] Access the result along with the RPC operation
3486
- # @yieldparam response [::Google::Cloud::ArtifactRegistry::V1::VPCSCConfig]
4842
+ # @yieldparam response [::Gapic::Operation]
3487
4843
  # @yieldparam operation [::GRPC::ActiveCall::Operation]
3488
4844
  #
3489
- # @return [::Google::Cloud::ArtifactRegistry::V1::VPCSCConfig]
4845
+ # @return [::Gapic::Operation]
3490
4846
  #
3491
4847
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
3492
4848
  #
@@ -3497,24 +4853,31 @@ module Google
3497
4853
  # client = Google::Cloud::ArtifactRegistry::V1::ArtifactRegistry::Client.new
3498
4854
  #
3499
4855
  # # Create a request. To set request fields, pass in keyword arguments.
3500
- # request = Google::Cloud::ArtifactRegistry::V1::UpdateVPCSCConfigRequest.new
4856
+ # request = Google::Cloud::ArtifactRegistry::V1::DeleteAttachmentRequest.new
3501
4857
  #
3502
- # # Call the update_vpcsc_config method.
3503
- # result = client.update_vpcsc_config request
4858
+ # # Call the delete_attachment method.
4859
+ # result = client.delete_attachment request
3504
4860
  #
3505
- # # The returned object is of type Google::Cloud::ArtifactRegistry::V1::VPCSCConfig.
3506
- # p result
4861
+ # # The returned object is of type Gapic::Operation. You can use it to
4862
+ # # check the status of an operation, cancel it, or wait for results.
4863
+ # # Here is how to wait for a response.
4864
+ # result.wait_until_done! timeout: 60
4865
+ # if result.response?
4866
+ # p result.response
4867
+ # else
4868
+ # puts "No response received."
4869
+ # end
3507
4870
  #
3508
- def update_vpcsc_config request, options = nil
4871
+ def delete_attachment request, options = nil
3509
4872
  raise ::ArgumentError, "request must be provided" if request.nil?
3510
4873
 
3511
- request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ArtifactRegistry::V1::UpdateVPCSCConfigRequest
4874
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ArtifactRegistry::V1::DeleteAttachmentRequest
3512
4875
 
3513
4876
  # Converts hash and nil to an options object
3514
4877
  options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
3515
4878
 
3516
4879
  # Customize the options with defaults
3517
- metadata = @config.rpcs.update_vpcsc_config.metadata.to_h
4880
+ metadata = @config.rpcs.delete_attachment.metadata.to_h
3518
4881
 
3519
4882
  # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
3520
4883
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
@@ -3524,24 +4887,25 @@ module Google
3524
4887
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
3525
4888
 
3526
4889
  header_params = {}
3527
- if request.vpcsc_config&.name
3528
- header_params["vpcsc_config.name"] = request.vpcsc_config.name
4890
+ if request.name
4891
+ header_params["name"] = request.name
3529
4892
  end
3530
4893
 
3531
4894
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
3532
4895
  metadata[:"x-goog-request-params"] ||= request_params_header
3533
4896
 
3534
- options.apply_defaults timeout: @config.rpcs.update_vpcsc_config.timeout,
4897
+ options.apply_defaults timeout: @config.rpcs.delete_attachment.timeout,
3535
4898
  metadata: metadata,
3536
- retry_policy: @config.rpcs.update_vpcsc_config.retry_policy
4899
+ retry_policy: @config.rpcs.delete_attachment.retry_policy
3537
4900
 
3538
4901
  options.apply_defaults timeout: @config.timeout,
3539
4902
  metadata: @config.metadata,
3540
4903
  retry_policy: @config.retry_policy
3541
4904
 
3542
- @artifact_registry_stub.call_rpc :update_vpcsc_config, request, options: options do |response, operation|
4905
+ @artifact_registry_stub.call_rpc :delete_attachment, request, options: options do |response, operation|
4906
+ response = ::Gapic::Operation.new response, @operations_client, options: options
3543
4907
  yield response, operation if block_given?
3544
- return response
4908
+ throw :response, response
3545
4909
  end
3546
4910
  rescue ::GRPC::BadStatus => e
3547
4911
  raise ::Google::Cloud::Error.from_error(e)
@@ -3630,6 +4994,11 @@ module Google
3630
4994
  # default endpoint URL. The default value of nil uses the environment
3631
4995
  # universe (usually the default "googleapis.com" universe).
3632
4996
  # @return [::String,nil]
4997
+ # @!attribute [rw] logger
4998
+ # A custom logger to use for request/response debug logging, or the value
4999
+ # `:default` (the default) to construct a default logger, or `nil` to
5000
+ # explicitly disable logging.
5001
+ # @return [::Logger,:default,nil]
3633
5002
  #
3634
5003
  class Configuration
3635
5004
  extend ::Gapic::Config
@@ -3654,6 +5023,7 @@ module Google
3654
5023
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
3655
5024
  config_attr :quota_project, nil, ::String, nil
3656
5025
  config_attr :universe_domain, nil, ::String, nil
5026
+ config_attr :logger, :default, ::Logger, nil, :default
3657
5027
 
3658
5028
  # @private
3659
5029
  def initialize parent_config = nil
@@ -3811,6 +5181,11 @@ module Google
3811
5181
  #
3812
5182
  attr_reader :batch_delete_versions
3813
5183
  ##
5184
+ # RPC-specific configuration for `update_version`
5185
+ # @return [::Gapic::Config::Method]
5186
+ #
5187
+ attr_reader :update_version
5188
+ ##
3814
5189
  # RPC-specific configuration for `list_files`
3815
5190
  # @return [::Gapic::Config::Method]
3816
5191
  #
@@ -3821,6 +5196,16 @@ module Google
3821
5196
  #
3822
5197
  attr_reader :get_file
3823
5198
  ##
5199
+ # RPC-specific configuration for `delete_file`
5200
+ # @return [::Gapic::Config::Method]
5201
+ #
5202
+ attr_reader :delete_file
5203
+ ##
5204
+ # RPC-specific configuration for `update_file`
5205
+ # @return [::Gapic::Config::Method]
5206
+ #
5207
+ attr_reader :update_file
5208
+ ##
3824
5209
  # RPC-specific configuration for `list_tags`
3825
5210
  # @return [::Gapic::Config::Method]
3826
5211
  #
@@ -3846,6 +5231,31 @@ module Google
3846
5231
  #
3847
5232
  attr_reader :delete_tag
3848
5233
  ##
5234
+ # RPC-specific configuration for `create_rule`
5235
+ # @return [::Gapic::Config::Method]
5236
+ #
5237
+ attr_reader :create_rule
5238
+ ##
5239
+ # RPC-specific configuration for `list_rules`
5240
+ # @return [::Gapic::Config::Method]
5241
+ #
5242
+ attr_reader :list_rules
5243
+ ##
5244
+ # RPC-specific configuration for `get_rule`
5245
+ # @return [::Gapic::Config::Method]
5246
+ #
5247
+ attr_reader :get_rule
5248
+ ##
5249
+ # RPC-specific configuration for `update_rule`
5250
+ # @return [::Gapic::Config::Method]
5251
+ #
5252
+ attr_reader :update_rule
5253
+ ##
5254
+ # RPC-specific configuration for `delete_rule`
5255
+ # @return [::Gapic::Config::Method]
5256
+ #
5257
+ attr_reader :delete_rule
5258
+ ##
3849
5259
  # RPC-specific configuration for `set_iam_policy`
3850
5260
  # @return [::Gapic::Config::Method]
3851
5261
  #
@@ -3880,6 +5290,31 @@ module Google
3880
5290
  # @return [::Gapic::Config::Method]
3881
5291
  #
3882
5292
  attr_reader :update_vpcsc_config
5293
+ ##
5294
+ # RPC-specific configuration for `update_package`
5295
+ # @return [::Gapic::Config::Method]
5296
+ #
5297
+ attr_reader :update_package
5298
+ ##
5299
+ # RPC-specific configuration for `list_attachments`
5300
+ # @return [::Gapic::Config::Method]
5301
+ #
5302
+ attr_reader :list_attachments
5303
+ ##
5304
+ # RPC-specific configuration for `get_attachment`
5305
+ # @return [::Gapic::Config::Method]
5306
+ #
5307
+ attr_reader :get_attachment
5308
+ ##
5309
+ # RPC-specific configuration for `create_attachment`
5310
+ # @return [::Gapic::Config::Method]
5311
+ #
5312
+ attr_reader :create_attachment
5313
+ ##
5314
+ # RPC-specific configuration for `delete_attachment`
5315
+ # @return [::Gapic::Config::Method]
5316
+ #
5317
+ attr_reader :delete_attachment
3883
5318
 
3884
5319
  # @private
3885
5320
  def initialize parent_rpcs = nil
@@ -3927,10 +5362,16 @@ module Google
3927
5362
  @delete_version = ::Gapic::Config::Method.new delete_version_config
3928
5363
  batch_delete_versions_config = parent_rpcs.batch_delete_versions if parent_rpcs.respond_to? :batch_delete_versions
3929
5364
  @batch_delete_versions = ::Gapic::Config::Method.new batch_delete_versions_config
5365
+ update_version_config = parent_rpcs.update_version if parent_rpcs.respond_to? :update_version
5366
+ @update_version = ::Gapic::Config::Method.new update_version_config
3930
5367
  list_files_config = parent_rpcs.list_files if parent_rpcs.respond_to? :list_files
3931
5368
  @list_files = ::Gapic::Config::Method.new list_files_config
3932
5369
  get_file_config = parent_rpcs.get_file if parent_rpcs.respond_to? :get_file
3933
5370
  @get_file = ::Gapic::Config::Method.new get_file_config
5371
+ delete_file_config = parent_rpcs.delete_file if parent_rpcs.respond_to? :delete_file
5372
+ @delete_file = ::Gapic::Config::Method.new delete_file_config
5373
+ update_file_config = parent_rpcs.update_file if parent_rpcs.respond_to? :update_file
5374
+ @update_file = ::Gapic::Config::Method.new update_file_config
3934
5375
  list_tags_config = parent_rpcs.list_tags if parent_rpcs.respond_to? :list_tags
3935
5376
  @list_tags = ::Gapic::Config::Method.new list_tags_config
3936
5377
  get_tag_config = parent_rpcs.get_tag if parent_rpcs.respond_to? :get_tag
@@ -3941,6 +5382,16 @@ module Google
3941
5382
  @update_tag = ::Gapic::Config::Method.new update_tag_config
3942
5383
  delete_tag_config = parent_rpcs.delete_tag if parent_rpcs.respond_to? :delete_tag
3943
5384
  @delete_tag = ::Gapic::Config::Method.new delete_tag_config
5385
+ create_rule_config = parent_rpcs.create_rule if parent_rpcs.respond_to? :create_rule
5386
+ @create_rule = ::Gapic::Config::Method.new create_rule_config
5387
+ list_rules_config = parent_rpcs.list_rules if parent_rpcs.respond_to? :list_rules
5388
+ @list_rules = ::Gapic::Config::Method.new list_rules_config
5389
+ get_rule_config = parent_rpcs.get_rule if parent_rpcs.respond_to? :get_rule
5390
+ @get_rule = ::Gapic::Config::Method.new get_rule_config
5391
+ update_rule_config = parent_rpcs.update_rule if parent_rpcs.respond_to? :update_rule
5392
+ @update_rule = ::Gapic::Config::Method.new update_rule_config
5393
+ delete_rule_config = parent_rpcs.delete_rule if parent_rpcs.respond_to? :delete_rule
5394
+ @delete_rule = ::Gapic::Config::Method.new delete_rule_config
3944
5395
  set_iam_policy_config = parent_rpcs.set_iam_policy if parent_rpcs.respond_to? :set_iam_policy
3945
5396
  @set_iam_policy = ::Gapic::Config::Method.new set_iam_policy_config
3946
5397
  get_iam_policy_config = parent_rpcs.get_iam_policy if parent_rpcs.respond_to? :get_iam_policy
@@ -3955,6 +5406,16 @@ module Google
3955
5406
  @get_vpcsc_config = ::Gapic::Config::Method.new get_vpcsc_config_config
3956
5407
  update_vpcsc_config_config = parent_rpcs.update_vpcsc_config if parent_rpcs.respond_to? :update_vpcsc_config
3957
5408
  @update_vpcsc_config = ::Gapic::Config::Method.new update_vpcsc_config_config
5409
+ update_package_config = parent_rpcs.update_package if parent_rpcs.respond_to? :update_package
5410
+ @update_package = ::Gapic::Config::Method.new update_package_config
5411
+ list_attachments_config = parent_rpcs.list_attachments if parent_rpcs.respond_to? :list_attachments
5412
+ @list_attachments = ::Gapic::Config::Method.new list_attachments_config
5413
+ get_attachment_config = parent_rpcs.get_attachment if parent_rpcs.respond_to? :get_attachment
5414
+ @get_attachment = ::Gapic::Config::Method.new get_attachment_config
5415
+ create_attachment_config = parent_rpcs.create_attachment if parent_rpcs.respond_to? :create_attachment
5416
+ @create_attachment = ::Gapic::Config::Method.new create_attachment_config
5417
+ delete_attachment_config = parent_rpcs.delete_attachment if parent_rpcs.respond_to? :delete_attachment
5418
+ @delete_attachment = ::Gapic::Config::Method.new delete_attachment_config
3958
5419
 
3959
5420
  yield self if block_given?
3960
5421
  end