google-cloud-apigee_registry-v1 0.2.0 → 0.3.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (11) hide show
  1. checksums.yaml +4 -4
  2. data/lib/google/cloud/apigee_registry/v1/provisioning/client.rb +1 -1
  3. data/lib/google/cloud/apigee_registry/v1/registry/client.rb +88 -82
  4. data/lib/google/cloud/apigee_registry/v1/version.rb +1 -1
  5. data/lib/google/cloud/apigeeregistry/v1/registry_service_pb.rb +2 -0
  6. data/lib/google/cloud/apigeeregistry/v1/registry_service_services_pb.rb +37 -37
  7. data/proto_docs/google/cloud/apigeeregistry/v1/provisioning_service.rb +1 -1
  8. data/proto_docs/google/cloud/apigeeregistry/v1/registry_models.rb +22 -22
  9. data/proto_docs/google/cloud/apigeeregistry/v1/registry_service.rb +50 -42
  10. data/proto_docs/google/protobuf/empty.rb +0 -2
  11. metadata +2 -2
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 597a9e86df6b3c785bf391387bbeb8310dd5362e784d965b984632fce98e374f
4
- data.tar.gz: 23211fee51972ed393c7371a4b19457d6e610b119a3a3b25e41eb82263d0df18
3
+ metadata.gz: 7012cd6d477eea878a01cfd064edb058bc520988f79d9060625a41d75bfa816e
4
+ data.tar.gz: 60a7d7093c4e2b88be3b67267b7fcd55abe56205a64745f15bd9689c91239d32
5
5
  SHA512:
6
- metadata.gz: 56ab1e6d4b52c8f308f349bf430f049fa65af96fca514ce776bd6f302fb0cc305e3beb40baf83c7cf13d6f268105a9d222a29ad78cdbbaf93145ef994ff76421
7
- data.tar.gz: c0887694ed3d447c34c2addc1f2d943044aa8aa568ebb1caed1c16ed496f300743158afc27ef63c29391deea44608bf8e3b92cdbd71c7c88679b7e6c939f9830
6
+ metadata.gz: fcb419ddd225adb649da9890a0394a1ba2a85950f7c5597602d97e4c8e0ce856aba3c4d37172623aa1843d853eefa018ffa8658958fc3db2bcae1e9e0e1208ba
7
+ data.tar.gz: 47a6b92fdae0513a0025f3bfd164b1dbf75642ccd8fdd7f6c1cbf250d8da7c577481a60e1d541451e274ce54702c071ba8521cebc214e20eb066b23fe4b2cbaa
data/lib/google/cloud/apigee_registry/v1/provisioning/client.rb CHANGED
@@ -19,7 +19,7 @@
19
19
  require "google/cloud/errors"
20
20
  require "google/cloud/apigeeregistry/v1/provisioning_service_pb"
21
21
  require "google/cloud/location"
22
- require "google/iam/v1/iam_policy"
22
+ require "google/iam/v1"
23
23
 
24
24
  module Google
25
25
  module Cloud
data/lib/google/cloud/apigee_registry/v1/registry/client.rb CHANGED
@@ -19,7 +19,7 @@
19
19
  require "google/cloud/errors"
20
20
  require "google/cloud/apigeeregistry/v1/registry_service_pb"
21
21
  require "google/cloud/location"
22
- require "google/iam/v1/iam_policy"
22
+ require "google/iam/v1"
23
23
 
24
24
  module Google
25
25
  module Cloud
@@ -342,7 +342,7 @@ module Google
342
342
  # Service calls
343
343
 
344
344
  ##
345
- # ListApis returns matching APIs.
345
+ # Returns matching APIs.
346
346
  #
347
347
  # @overload list_apis(request, options = nil)
348
348
  # Pass arguments to `list_apis` via a request object, either of type
@@ -361,7 +361,7 @@ module Google
361
361
  #
362
362
  # @param parent [::String]
363
363
  # Required. The parent, which owns this collection of APIs.
364
- # Format: projects/*/locations/*
364
+ # Format: `projects/*/locations/*`
365
365
  # @param page_size [::Integer]
366
366
  # The maximum number of APIs to return.
367
367
  # The service may return fewer than this value.
@@ -449,7 +449,7 @@ module Google
449
449
  end
450
450
 
451
451
  ##
452
- # GetApi returns a specified API.
452
+ # Returns a specified API.
453
453
  #
454
454
  # @overload get_api(request, options = nil)
455
455
  # Pass arguments to `get_api` via a request object, either of type
@@ -468,7 +468,7 @@ module Google
468
468
  #
469
469
  # @param name [::String]
470
470
  # Required. The name of the API to retrieve.
471
- # Format: projects/*/locations/*/apis/*
471
+ # Format: `projects/*/locations/*/apis/*`
472
472
  #
473
473
  # @yield [response, operation] Access the result along with the RPC operation
474
474
  # @yieldparam response [::Google::Cloud::ApigeeRegistry::V1::Api]
@@ -535,7 +535,7 @@ module Google
535
535
  end
536
536
 
537
537
  ##
538
- # CreateApi creates a specified API.
538
+ # Creates a specified API.
539
539
  #
540
540
  # @overload create_api(request, options = nil)
541
541
  # Pass arguments to `create_api` via a request object, either of type
@@ -554,12 +554,12 @@ module Google
554
554
  #
555
555
  # @param parent [::String]
556
556
  # Required. The parent, which owns this collection of APIs.
557
- # Format: projects/*/locations/*
557
+ # Format: `projects/*/locations/*`
558
558
  # @param api [::Google::Cloud::ApigeeRegistry::V1::Api, ::Hash]
559
559
  # Required. The API to create.
560
560
  # @param api_id [::String]
561
- # Required. The ID to use for the api, which will become the final component of
562
- # the api's resource name.
561
+ # Required. The ID to use for the API, which will become the final component of
562
+ # the API's resource name.
563
563
  #
564
564
  # This value should be 4-63 characters, and valid characters
565
565
  # are /[a-z][0-9]-/.
@@ -631,7 +631,7 @@ module Google
631
631
  end
632
632
 
633
633
  ##
634
- # UpdateApi can be used to modify a specified API.
634
+ # Used to modify a specified API.
635
635
  #
636
636
  # @overload update_api(request, options = nil)
637
637
  # Pass arguments to `update_api` via a request object, either of type
@@ -652,14 +652,14 @@ module Google
652
652
  # Required. The API to update.
653
653
  #
654
654
  # The `name` field is used to identify the API to update.
655
- # Format: projects/*/locations/*/apis/*
655
+ # Format: `projects/*/locations/*/apis/*`
656
656
  # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
657
657
  # The list of fields to be updated. If omitted, all fields are updated that
658
658
  # are set in the request message (fields set to default values are ignored).
659
- # If a "*" is specified, all fields are updated, including fields that are
660
- # unspecified/default in the request.
659
+ # If an asterisk "*" is specified, all fields are updated, including fields
660
+ # that are unspecified/default in the request.
661
661
  # @param allow_missing [::Boolean]
662
- # If set to true, and the api is not found, a new api will be created.
662
+ # If set to true, and the API is not found, a new API will be created.
663
663
  # In this situation, `update_mask` is ignored.
664
664
  #
665
665
  # @yield [response, operation] Access the result along with the RPC operation
@@ -727,7 +727,7 @@ module Google
727
727
  end
728
728
 
729
729
  ##
730
- # DeleteApi removes a specified API and all of the resources that it
730
+ # Removes a specified API and all of the resources that it
731
731
  # owns.
732
732
  #
733
733
  # @overload delete_api(request, options = nil)
@@ -740,14 +740,17 @@ module Google
740
740
  # @param options [::Gapic::CallOptions, ::Hash]
741
741
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
742
742
  #
743
- # @overload delete_api(name: nil)
743
+ # @overload delete_api(name: nil, force: nil)
744
744
  # Pass arguments to `delete_api` via keyword arguments. Note that at
745
745
  # least one keyword argument is required. To specify no parameters, or to keep all
746
746
  # the default parameter values, pass an empty Hash as a request object (see above).
747
747
  #
748
748
  # @param name [::String]
749
749
  # Required. The name of the API to delete.
750
- # Format: projects/*/locations/*/apis/*
750
+ # Format: `projects/*/locations/*/apis/*`
751
+ # @param force [::Boolean]
752
+ # If set to true, any child resources will also be deleted.
753
+ # (Otherwise, the request will only work if there are no child resources.)
751
754
  #
752
755
  # @yield [response, operation] Access the result along with the RPC operation
753
756
  # @yieldparam response [::Google::Protobuf::Empty]
@@ -814,7 +817,7 @@ module Google
814
817
  end
815
818
 
816
819
  ##
817
- # ListApiVersions returns matching versions.
820
+ # Returns matching versions.
818
821
  #
819
822
  # @overload list_api_versions(request, options = nil)
820
823
  # Pass arguments to `list_api_versions` via a request object, either of type
@@ -833,7 +836,7 @@ module Google
833
836
  #
834
837
  # @param parent [::String]
835
838
  # Required. The parent, which owns this collection of versions.
836
- # Format: projects/*/locations/*/apis/*
839
+ # Format: `projects/*/locations/*/apis/*`
837
840
  # @param page_size [::Integer]
838
841
  # The maximum number of versions to return.
839
842
  # The service may return fewer than this value.
@@ -921,7 +924,7 @@ module Google
921
924
  end
922
925
 
923
926
  ##
924
- # GetApiVersion returns a specified version.
927
+ # Returns a specified version.
925
928
  #
926
929
  # @overload get_api_version(request, options = nil)
927
930
  # Pass arguments to `get_api_version` via a request object, either of type
@@ -940,7 +943,7 @@ module Google
940
943
  #
941
944
  # @param name [::String]
942
945
  # Required. The name of the version to retrieve.
943
- # Format: projects/*/locations/*/apis/*/versions/*
946
+ # Format: `projects/*/locations/*/apis/*/versions/*`
944
947
  #
945
948
  # @yield [response, operation] Access the result along with the RPC operation
946
949
  # @yieldparam response [::Google::Cloud::ApigeeRegistry::V1::ApiVersion]
@@ -1007,7 +1010,7 @@ module Google
1007
1010
  end
1008
1011
 
1009
1012
  ##
1010
- # CreateApiVersion creates a specified version.
1013
+ # Creates a specified version.
1011
1014
  #
1012
1015
  # @overload create_api_version(request, options = nil)
1013
1016
  # Pass arguments to `create_api_version` via a request object, either of type
@@ -1026,7 +1029,7 @@ module Google
1026
1029
  #
1027
1030
  # @param parent [::String]
1028
1031
  # Required. The parent, which owns this collection of versions.
1029
- # Format: projects/*/locations/*/apis/*
1032
+ # Format: `projects/*/locations/*/apis/*`
1030
1033
  # @param api_version [::Google::Cloud::ApigeeRegistry::V1::ApiVersion, ::Hash]
1031
1034
  # Required. The version to create.
1032
1035
  # @param api_version_id [::String]
@@ -1103,7 +1106,7 @@ module Google
1103
1106
  end
1104
1107
 
1105
1108
  ##
1106
- # UpdateApiVersion can be used to modify a specified version.
1109
+ # Used to modify a specified version.
1107
1110
  #
1108
1111
  # @overload update_api_version(request, options = nil)
1109
1112
  # Pass arguments to `update_api_version` via a request object, either of type
@@ -1124,12 +1127,12 @@ module Google
1124
1127
  # Required. The version to update.
1125
1128
  #
1126
1129
  # The `name` field is used to identify the version to update.
1127
- # Format: projects/*/locations/*/apis/*/versions/*
1130
+ # Format: `projects/*/locations/*/apis/*/versions/*`
1128
1131
  # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
1129
1132
  # The list of fields to be updated. If omitted, all fields are updated that
1130
1133
  # are set in the request message (fields set to default values are ignored).
1131
- # If a "*" is specified, all fields are updated, including fields that are
1132
- # unspecified/default in the request.
1134
+ # If an asterisk "*" is specified, all fields are updated, including fields
1135
+ # that are unspecified/default in the request.
1133
1136
  # @param allow_missing [::Boolean]
1134
1137
  # If set to true, and the version is not found, a new version will be
1135
1138
  # created. In this situation, `update_mask` is ignored.
@@ -1199,7 +1202,7 @@ module Google
1199
1202
  end
1200
1203
 
1201
1204
  ##
1202
- # DeleteApiVersion removes a specified version and all of the resources that
1205
+ # Removes a specified version and all of the resources that
1203
1206
  # it owns.
1204
1207
  #
1205
1208
  # @overload delete_api_version(request, options = nil)
@@ -1212,14 +1215,17 @@ module Google
1212
1215
  # @param options [::Gapic::CallOptions, ::Hash]
1213
1216
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1214
1217
  #
1215
- # @overload delete_api_version(name: nil)
1218
+ # @overload delete_api_version(name: nil, force: nil)
1216
1219
  # Pass arguments to `delete_api_version` via keyword arguments. Note that at
1217
1220
  # least one keyword argument is required. To specify no parameters, or to keep all
1218
1221
  # the default parameter values, pass an empty Hash as a request object (see above).
1219
1222
  #
1220
1223
  # @param name [::String]
1221
1224
  # Required. The name of the version to delete.
1222
- # Format: projects/*/locations/*/apis/*/versions/*
1225
+ # Format: `projects/*/locations/*/apis/*/versions/*`
1226
+ # @param force [::Boolean]
1227
+ # If set to true, any child resources will also be deleted.
1228
+ # (Otherwise, the request will only work if there are no child resources.)
1223
1229
  #
1224
1230
  # @yield [response, operation] Access the result along with the RPC operation
1225
1231
  # @yieldparam response [::Google::Protobuf::Empty]
@@ -1286,7 +1292,7 @@ module Google
1286
1292
  end
1287
1293
 
1288
1294
  ##
1289
- # ListApiSpecs returns matching specs.
1295
+ # Returns matching specs.
1290
1296
  #
1291
1297
  # @overload list_api_specs(request, options = nil)
1292
1298
  # Pass arguments to `list_api_specs` via a request object, either of type
@@ -1305,7 +1311,7 @@ module Google
1305
1311
  #
1306
1312
  # @param parent [::String]
1307
1313
  # Required. The parent, which owns this collection of specs.
1308
- # Format: projects/*/locations/*/apis/*/versions/*
1314
+ # Format: `projects/*/locations/*/apis/*/versions/*`
1309
1315
  # @param page_size [::Integer]
1310
1316
  # The maximum number of specs to return.
1311
1317
  # The service may return fewer than this value.
@@ -1393,7 +1399,7 @@ module Google
1393
1399
  end
1394
1400
 
1395
1401
  ##
1396
- # GetApiSpec returns a specified spec.
1402
+ # Returns a specified spec.
1397
1403
  #
1398
1404
  # @overload get_api_spec(request, options = nil)
1399
1405
  # Pass arguments to `get_api_spec` via a request object, either of type
@@ -1412,7 +1418,7 @@ module Google
1412
1418
  #
1413
1419
  # @param name [::String]
1414
1420
  # Required. The name of the spec to retrieve.
1415
- # Format: projects/*/locations/*/apis/*/versions/*/specs/*
1421
+ # Format: `projects/*/locations/*/apis/*/versions/*/specs/*`
1416
1422
  #
1417
1423
  # @yield [response, operation] Access the result along with the RPC operation
1418
1424
  # @yieldparam response [::Google::Cloud::ApigeeRegistry::V1::ApiSpec]
@@ -1479,7 +1485,7 @@ module Google
1479
1485
  end
1480
1486
 
1481
1487
  ##
1482
- # GetApiSpecContents returns the contents of a specified spec.
1488
+ # Returns the contents of a specified spec.
1483
1489
  # If specs are stored with GZip compression, the default behavior
1484
1490
  # is to return the spec uncompressed (the mime_type response field
1485
1491
  # indicates the exact format returned).
@@ -1501,7 +1507,7 @@ module Google
1501
1507
  #
1502
1508
  # @param name [::String]
1503
1509
  # Required. The name of the spec whose contents should be retrieved.
1504
- # Format: projects/*/locations/*/apis/*/versions/*/specs/*
1510
+ # Format: `projects/*/locations/*/apis/*/versions/*/specs/*`
1505
1511
  #
1506
1512
  # @yield [response, operation] Access the result along with the RPC operation
1507
1513
  # @yieldparam response [::Google::Api::HttpBody]
@@ -1568,7 +1574,7 @@ module Google
1568
1574
  end
1569
1575
 
1570
1576
  ##
1571
- # CreateApiSpec creates a specified spec.
1577
+ # Creates a specified spec.
1572
1578
  #
1573
1579
  # @overload create_api_spec(request, options = nil)
1574
1580
  # Pass arguments to `create_api_spec` via a request object, either of type
@@ -1587,7 +1593,7 @@ module Google
1587
1593
  #
1588
1594
  # @param parent [::String]
1589
1595
  # Required. The parent, which owns this collection of specs.
1590
- # Format: projects/*/locations/*/apis/*/versions/*
1596
+ # Format: `projects/*/locations/*/apis/*/versions/*`
1591
1597
  # @param api_spec [::Google::Cloud::ApigeeRegistry::V1::ApiSpec, ::Hash]
1592
1598
  # Required. The spec to create.
1593
1599
  # @param api_spec_id [::String]
@@ -1664,7 +1670,7 @@ module Google
1664
1670
  end
1665
1671
 
1666
1672
  ##
1667
- # UpdateApiSpec can be used to modify a specified spec.
1673
+ # Used to modify a specified spec.
1668
1674
  #
1669
1675
  # @overload update_api_spec(request, options = nil)
1670
1676
  # Pass arguments to `update_api_spec` via a request object, either of type
@@ -1685,12 +1691,12 @@ module Google
1685
1691
  # Required. The spec to update.
1686
1692
  #
1687
1693
  # The `name` field is used to identify the spec to update.
1688
- # Format: projects/*/locations/*/apis/*/versions/*/specs/*
1694
+ # Format: `projects/*/locations/*/apis/*/versions/*/specs/*`
1689
1695
  # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
1690
1696
  # The list of fields to be updated. If omitted, all fields are updated that
1691
1697
  # are set in the request message (fields set to default values are ignored).
1692
- # If a "*" is specified, all fields are updated, including fields that are
1693
- # unspecified/default in the request.
1698
+ # If an asterisk "*" is specified, all fields are updated, including fields
1699
+ # that are unspecified/default in the request.
1694
1700
  # @param allow_missing [::Boolean]
1695
1701
  # If set to true, and the spec is not found, a new spec will be created.
1696
1702
  # In this situation, `update_mask` is ignored.
@@ -1760,8 +1766,8 @@ module Google
1760
1766
  end
1761
1767
 
1762
1768
  ##
1763
- # DeleteApiSpec removes a specified spec, all revisions, and all child
1764
- # resources (e.g. artifacts).
1769
+ # Removes a specified spec, all revisions, and all child
1770
+ # resources (e.g., artifacts).
1765
1771
  #
1766
1772
  # @overload delete_api_spec(request, options = nil)
1767
1773
  # Pass arguments to `delete_api_spec` via a request object, either of type
@@ -1780,7 +1786,7 @@ module Google
1780
1786
  #
1781
1787
  # @param name [::String]
1782
1788
  # Required. The name of the spec to delete.
1783
- # Format: projects/*/locations/*/apis/*/versions/*/specs/*
1789
+ # Format: `projects/*/locations/*/apis/*/versions/*/specs/*`
1784
1790
  # @param force [::Boolean]
1785
1791
  # If set to true, any child resources will also be deleted.
1786
1792
  # (Otherwise, the request will only work if there are no child resources.)
@@ -1850,7 +1856,7 @@ module Google
1850
1856
  end
1851
1857
 
1852
1858
  ##
1853
- # TagApiSpecRevision adds a tag to a specified revision of a spec.
1859
+ # Adds a tag to a specified revision of a spec.
1854
1860
  #
1855
1861
  # @overload tag_api_spec_revision(request, options = nil)
1856
1862
  # Pass arguments to `tag_api_spec_revision` via a request object, either of type
@@ -1938,7 +1944,7 @@ module Google
1938
1944
  end
1939
1945
 
1940
1946
  ##
1941
- # ListApiSpecRevisions lists all revisions of a spec.
1947
+ # Lists all revisions of a spec.
1942
1948
  # Revisions are returned in descending order of revision creation time.
1943
1949
  #
1944
1950
  # @overload list_api_spec_revisions(request, options = nil)
@@ -2036,7 +2042,7 @@ module Google
2036
2042
  end
2037
2043
 
2038
2044
  ##
2039
- # RollbackApiSpec sets the current revision to a specified prior revision.
2045
+ # Sets the current revision to a specified prior revision.
2040
2046
  # Note that this creates a new revision with a new revision ID.
2041
2047
  #
2042
2048
  # @overload rollback_api_spec(request, options = nil)
@@ -2060,7 +2066,7 @@ module Google
2060
2066
  # Required. The revision ID to roll back to.
2061
2067
  # It must be a revision of the same spec.
2062
2068
  #
2063
- # Example: c7cfa2a8
2069
+ # Example: `c7cfa2a8`
2064
2070
  #
2065
2071
  # @yield [response, operation] Access the result along with the RPC operation
2066
2072
  # @yieldparam response [::Google::Cloud::ApigeeRegistry::V1::ApiSpec]
@@ -2127,7 +2133,7 @@ module Google
2127
2133
  end
2128
2134
 
2129
2135
  ##
2130
- # DeleteApiSpecRevision deletes a revision of a spec.
2136
+ # Deletes a revision of a spec.
2131
2137
  #
2132
2138
  # @overload delete_api_spec_revision(request, options = nil)
2133
2139
  # Pass arguments to `delete_api_spec_revision` via a request object, either of type
@@ -2149,7 +2155,7 @@ module Google
2149
2155
  # with a revision ID explicitly included.
2150
2156
  #
2151
2157
  # Example:
2152
- # projects/sample/locations/global/apis/petstore/versions/1.0.0/specs/openapi.yaml@c7cfa2a8
2158
+ # `projects/sample/locations/global/apis/petstore/versions/1.0.0/specs/openapi.yaml@c7cfa2a8`
2153
2159
  #
2154
2160
  # @yield [response, operation] Access the result along with the RPC operation
2155
2161
  # @yieldparam response [::Google::Cloud::ApigeeRegistry::V1::ApiSpec]
@@ -2216,7 +2222,7 @@ module Google
2216
2222
  end
2217
2223
 
2218
2224
  ##
2219
- # ListApiDeployments returns matching deployments.
2225
+ # Returns matching deployments.
2220
2226
  #
2221
2227
  # @overload list_api_deployments(request, options = nil)
2222
2228
  # Pass arguments to `list_api_deployments` via a request object, either of type
@@ -2235,7 +2241,7 @@ module Google
2235
2241
  #
2236
2242
  # @param parent [::String]
2237
2243
  # Required. The parent, which owns this collection of deployments.
2238
- # Format: projects/*/locations/*/apis/*
2244
+ # Format: `projects/*/locations/*/apis/*`
2239
2245
  # @param page_size [::Integer]
2240
2246
  # The maximum number of deployments to return.
2241
2247
  # The service may return fewer than this value.
@@ -2323,7 +2329,7 @@ module Google
2323
2329
  end
2324
2330
 
2325
2331
  ##
2326
- # GetApiDeployment returns a specified deployment.
2332
+ # Returns a specified deployment.
2327
2333
  #
2328
2334
  # @overload get_api_deployment(request, options = nil)
2329
2335
  # Pass arguments to `get_api_deployment` via a request object, either of type
@@ -2342,7 +2348,7 @@ module Google
2342
2348
  #
2343
2349
  # @param name [::String]
2344
2350
  # Required. The name of the deployment to retrieve.
2345
- # Format: projects/*/locations/*/apis/*/deployments/*
2351
+ # Format: `projects/*/locations/*/apis/*/deployments/*`
2346
2352
  #
2347
2353
  # @yield [response, operation] Access the result along with the RPC operation
2348
2354
  # @yieldparam response [::Google::Cloud::ApigeeRegistry::V1::ApiDeployment]
@@ -2409,7 +2415,7 @@ module Google
2409
2415
  end
2410
2416
 
2411
2417
  ##
2412
- # CreateApiDeployment creates a specified deployment.
2418
+ # Creates a specified deployment.
2413
2419
  #
2414
2420
  # @overload create_api_deployment(request, options = nil)
2415
2421
  # Pass arguments to `create_api_deployment` via a request object, either of type
@@ -2428,7 +2434,7 @@ module Google
2428
2434
  #
2429
2435
  # @param parent [::String]
2430
2436
  # Required. The parent, which owns this collection of deployments.
2431
- # Format: projects/*/locations/*/apis/*
2437
+ # Format: `projects/*/locations/*/apis/*`
2432
2438
  # @param api_deployment [::Google::Cloud::ApigeeRegistry::V1::ApiDeployment, ::Hash]
2433
2439
  # Required. The deployment to create.
2434
2440
  # @param api_deployment_id [::String]
@@ -2505,7 +2511,7 @@ module Google
2505
2511
  end
2506
2512
 
2507
2513
  ##
2508
- # UpdateApiDeployment can be used to modify a specified deployment.
2514
+ # Used to modify a specified deployment.
2509
2515
  #
2510
2516
  # @overload update_api_deployment(request, options = nil)
2511
2517
  # Pass arguments to `update_api_deployment` via a request object, either of type
@@ -2526,12 +2532,12 @@ module Google
2526
2532
  # Required. The deployment to update.
2527
2533
  #
2528
2534
  # The `name` field is used to identify the deployment to update.
2529
- # Format: projects/*/locations/*/apis/*/deployments/*
2535
+ # Format: `projects/*/locations/*/apis/*/deployments/*`
2530
2536
  # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
2531
2537
  # The list of fields to be updated. If omitted, all fields are updated that
2532
2538
  # are set in the request message (fields set to default values are ignored).
2533
- # If a "*" is specified, all fields are updated, including fields that are
2534
- # unspecified/default in the request.
2539
+ # If an asterisk "*" is specified, all fields are updated, including fields
2540
+ # that are unspecified/default in the request.
2535
2541
  # @param allow_missing [::Boolean]
2536
2542
  # If set to true, and the deployment is not found, a new deployment will be
2537
2543
  # created. In this situation, `update_mask` is ignored.
@@ -2601,8 +2607,8 @@ module Google
2601
2607
  end
2602
2608
 
2603
2609
  ##
2604
- # DeleteApiDeployment removes a specified deployment, all revisions, and all
2605
- # child resources (e.g. artifacts).
2610
+ # Removes a specified deployment, all revisions, and all
2611
+ # child resources (e.g., artifacts).
2606
2612
  #
2607
2613
  # @overload delete_api_deployment(request, options = nil)
2608
2614
  # Pass arguments to `delete_api_deployment` via a request object, either of type
@@ -2621,7 +2627,7 @@ module Google
2621
2627
  #
2622
2628
  # @param name [::String]
2623
2629
  # Required. The name of the deployment to delete.
2624
- # Format: projects/*/locations/*/apis/*/deployments/*
2630
+ # Format: `projects/*/locations/*/apis/*/deployments/*`
2625
2631
  # @param force [::Boolean]
2626
2632
  # If set to true, any child resources will also be deleted.
2627
2633
  # (Otherwise, the request will only work if there are no child resources.)
@@ -2691,7 +2697,7 @@ module Google
2691
2697
  end
2692
2698
 
2693
2699
  ##
2694
- # TagApiDeploymentRevision adds a tag to a specified revision of a
2700
+ # Adds a tag to a specified revision of a
2695
2701
  # deployment.
2696
2702
  #
2697
2703
  # @overload tag_api_deployment_revision(request, options = nil)
@@ -2780,7 +2786,7 @@ module Google
2780
2786
  end
2781
2787
 
2782
2788
  ##
2783
- # ListApiDeploymentRevisions lists all revisions of a deployment.
2789
+ # Lists all revisions of a deployment.
2784
2790
  # Revisions are returned in descending order of revision creation time.
2785
2791
  #
2786
2792
  # @overload list_api_deployment_revisions(request, options = nil)
@@ -2878,7 +2884,7 @@ module Google
2878
2884
  end
2879
2885
 
2880
2886
  ##
2881
- # RollbackApiDeployment sets the current revision to a specified prior
2887
+ # Sets the current revision to a specified prior
2882
2888
  # revision. Note that this creates a new revision with a new revision ID.
2883
2889
  #
2884
2890
  # @overload rollback_api_deployment(request, options = nil)
@@ -2902,7 +2908,7 @@ module Google
2902
2908
  # Required. The revision ID to roll back to.
2903
2909
  # It must be a revision of the same deployment.
2904
2910
  #
2905
- # Example: c7cfa2a8
2911
+ # Example: `c7cfa2a8`
2906
2912
  #
2907
2913
  # @yield [response, operation] Access the result along with the RPC operation
2908
2914
  # @yieldparam response [::Google::Cloud::ApigeeRegistry::V1::ApiDeployment]
@@ -2969,7 +2975,7 @@ module Google
2969
2975
  end
2970
2976
 
2971
2977
  ##
2972
- # DeleteApiDeploymentRevision deletes a revision of a deployment.
2978
+ # Deletes a revision of a deployment.
2973
2979
  #
2974
2980
  # @overload delete_api_deployment_revision(request, options = nil)
2975
2981
  # Pass arguments to `delete_api_deployment_revision` via a request object, either of type
@@ -2991,7 +2997,7 @@ module Google
2991
2997
  # with a revision ID explicitly included.
2992
2998
  #
2993
2999
  # Example:
2994
- # projects/sample/locations/global/apis/petstore/deployments/prod@c7cfa2a8
3000
+ # `projects/sample/locations/global/apis/petstore/deployments/prod@c7cfa2a8`
2995
3001
  #
2996
3002
  # @yield [response, operation] Access the result along with the RPC operation
2997
3003
  # @yieldparam response [::Google::Cloud::ApigeeRegistry::V1::ApiDeployment]
@@ -3058,7 +3064,7 @@ module Google
3058
3064
  end
3059
3065
 
3060
3066
  ##
3061
- # ListArtifacts returns matching artifacts.
3067
+ # Returns matching artifacts.
3062
3068
  #
3063
3069
  # @overload list_artifacts(request, options = nil)
3064
3070
  # Pass arguments to `list_artifacts` via a request object, either of type
@@ -3077,7 +3083,7 @@ module Google
3077
3083
  #
3078
3084
  # @param parent [::String]
3079
3085
  # Required. The parent, which owns this collection of artifacts.
3080
- # Format: \\{parent}
3086
+ # Format: `{parent}`
3081
3087
  # @param page_size [::Integer]
3082
3088
  # The maximum number of artifacts to return.
3083
3089
  # The service may return fewer than this value.
@@ -3165,7 +3171,7 @@ module Google
3165
3171
  end
3166
3172
 
3167
3173
  ##
3168
- # GetArtifact returns a specified artifact.
3174
+ # Returns a specified artifact.
3169
3175
  #
3170
3176
  # @overload get_artifact(request, options = nil)
3171
3177
  # Pass arguments to `get_artifact` via a request object, either of type
@@ -3184,7 +3190,7 @@ module Google
3184
3190
  #
3185
3191
  # @param name [::String]
3186
3192
  # Required. The name of the artifact to retrieve.
3187
- # Format: \\{parent}/artifacts/*
3193
+ # Format: `{parent}/artifacts/*`
3188
3194
  #
3189
3195
  # @yield [response, operation] Access the result along with the RPC operation
3190
3196
  # @yieldparam response [::Google::Cloud::ApigeeRegistry::V1::Artifact]
@@ -3251,7 +3257,7 @@ module Google
3251
3257
  end
3252
3258
 
3253
3259
  ##
3254
- # GetArtifactContents returns the contents of a specified artifact.
3260
+ # Returns the contents of a specified artifact.
3255
3261
  # If artifacts are stored with GZip compression, the default behavior
3256
3262
  # is to return the artifact uncompressed (the mime_type response field
3257
3263
  # indicates the exact format returned).
@@ -3273,7 +3279,7 @@ module Google
3273
3279
  #
3274
3280
  # @param name [::String]
3275
3281
  # Required. The name of the artifact whose contents should be retrieved.
3276
- # Format: \\{parent}/artifacts/*
3282
+ # Format: `{parent}/artifacts/*`
3277
3283
  #
3278
3284
  # @yield [response, operation] Access the result along with the RPC operation
3279
3285
  # @yieldparam response [::Google::Api::HttpBody]
@@ -3340,7 +3346,7 @@ module Google
3340
3346
  end
3341
3347
 
3342
3348
  ##
3343
- # CreateArtifact creates a specified artifact.
3349
+ # Creates a specified artifact.
3344
3350
  #
3345
3351
  # @overload create_artifact(request, options = nil)
3346
3352
  # Pass arguments to `create_artifact` via a request object, either of type
@@ -3359,7 +3365,7 @@ module Google
3359
3365
  #
3360
3366
  # @param parent [::String]
3361
3367
  # Required. The parent, which owns this collection of artifacts.
3362
- # Format: \\{parent}
3368
+ # Format: `{parent}`
3363
3369
  # @param artifact [::Google::Cloud::ApigeeRegistry::V1::Artifact, ::Hash]
3364
3370
  # Required. The artifact to create.
3365
3371
  # @param artifact_id [::String]
@@ -3436,7 +3442,7 @@ module Google
3436
3442
  end
3437
3443
 
3438
3444
  ##
3439
- # ReplaceArtifact can be used to replace a specified artifact.
3445
+ # Used to replace a specified artifact.
3440
3446
  #
3441
3447
  # @overload replace_artifact(request, options = nil)
3442
3448
  # Pass arguments to `replace_artifact` via a request object, either of type
@@ -3457,7 +3463,7 @@ module Google
3457
3463
  # Required. The artifact to replace.
3458
3464
  #
3459
3465
  # The `name` field is used to identify the artifact to replace.
3460
- # Format: \\{parent}/artifacts/*
3466
+ # Format: `{parent}/artifacts/*`
3461
3467
  #
3462
3468
  # @yield [response, operation] Access the result along with the RPC operation
3463
3469
  # @yieldparam response [::Google::Cloud::ApigeeRegistry::V1::Artifact]
@@ -3524,7 +3530,7 @@ module Google
3524
3530
  end
3525
3531
 
3526
3532
  ##
3527
- # DeleteArtifact removes a specified artifact.
3533
+ # Removes a specified artifact.
3528
3534
  #
3529
3535
  # @overload delete_artifact(request, options = nil)
3530
3536
  # Pass arguments to `delete_artifact` via a request object, either of type
@@ -3543,7 +3549,7 @@ module Google
3543
3549
  #
3544
3550
  # @param name [::String]
3545
3551
  # Required. The name of the artifact to delete.
3546
- # Format: \\{parent}/artifacts/*
3552
+ # Format: `{parent}/artifacts/*`
3547
3553
  #
3548
3554
  # @yield [response, operation] Access the result along with the RPC operation
3549
3555
  # @yieldparam response [::Google::Protobuf::Empty]