google-apis-apigeeregistry_v1 0.6.0 → 0.7.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -122,14 +122,14 @@ module Google
122
122
  execute_or_queue_command(command, &block)
123
123
  end
124
124
 
125
- # CreateApi creates a specified API.
125
+ # Creates a specified API.
126
126
  # @param [String] parent
127
- # Required. The parent, which owns this collection of APIs. Format: projects/*/
128
- # locations/*
127
+ # Required. The parent, which owns this collection of APIs. Format: `projects/*/
128
+ # locations/*`
129
129
  # @param [Google::Apis::ApigeeregistryV1::Api] api_object
130
130
  # @param [String] api_id
131
- # Required. The ID to use for the api, which will become the final component of
132
- # the api's resource name. This value should be 4-63 characters, and valid
131
+ # Required. The ID to use for the API, which will become the final component of
132
+ # the API's resource name. This value should be 4-63 characters, and valid
133
133
  # characters are /a-z-/. Following AIP-162, IDs must not have the form of a UUID.
134
134
  # @param [String] fields
135
135
  # Selector specifying which fields to include in a partial response.
@@ -161,9 +161,10 @@ module Google
161
161
  execute_or_queue_command(command, &block)
162
162
  end
163
163
 
164
- # DeleteApi removes a specified API and all of the resources that it owns.
164
+ # Removes a specified API and all of the resources that it owns.
165
165
  # @param [String] name
166
- # Required. The name of the API to delete. Format: projects/*/locations/*/apis/*
166
+ # Required. The name of the API to delete. Format: `projects/*/locations/*/apis/*
167
+ # `
167
168
  # @param [Boolean] force
168
169
  # If set to true, any child resources will also be deleted. (Otherwise, the
169
170
  # request will only work if there are no child resources.)
@@ -195,10 +196,10 @@ module Google
195
196
  execute_or_queue_command(command, &block)
196
197
  end
197
198
 
198
- # GetApi returns a specified API.
199
+ # Returns a specified API.
199
200
  # @param [String] name
200
- # Required. The name of the API to retrieve. Format: projects/*/locations/*/apis/
201
- # *
201
+ # Required. The name of the API to retrieve. Format: `projects/*/locations/*/
202
+ # apis/*`
202
203
  # @param [String] fields
203
204
  # Selector specifying which fields to include in a partial response.
204
205
  # @param [String] quota_user
@@ -271,13 +272,16 @@ module Google
271
272
  execute_or_queue_command(command, &block)
272
273
  end
273
274
 
274
- # ListApis returns matching APIs.
275
+ # Returns matching APIs.
275
276
  # @param [String] parent
276
- # Required. The parent, which owns this collection of APIs. Format: projects/*/
277
- # locations/*
277
+ # Required. The parent, which owns this collection of APIs. Format: `projects/*/
278
+ # locations/*`
278
279
  # @param [String] filter
279
280
  # An expression that can be used to filter the list. Filters use the Common
280
281
  # Expression Language and can refer to all message fields.
282
+ # @param [String] order_by
283
+ # A comma-separated list of fields, e.g. "foo,bar" Fields can be sorted in
284
+ # descending order using the "desc" identifier, e.g. "foo desc,bar"
281
285
  # @param [Fixnum] page_size
282
286
  # The maximum number of APIs to return. The service may return fewer than this
283
287
  # value. If unspecified, at most 50 values will be returned. The maximum is 1000;
@@ -303,12 +307,13 @@ module Google
303
307
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
304
308
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
305
309
  # @raise [Google::Apis::AuthorizationError] Authorization is required
306
- def list_project_location_apis(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
310
+ def list_project_location_apis(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
307
311
  command = make_simple_command(:get, 'v1/{+parent}/apis', options)
308
312
  command.response_representation = Google::Apis::ApigeeregistryV1::ListApisResponse::Representation
309
313
  command.response_class = Google::Apis::ApigeeregistryV1::ListApisResponse
310
314
  command.params['parent'] = parent unless parent.nil?
311
315
  command.query['filter'] = filter unless filter.nil?
316
+ command.query['orderBy'] = order_by unless order_by.nil?
312
317
  command.query['pageSize'] = page_size unless page_size.nil?
313
318
  command.query['pageToken'] = page_token unless page_token.nil?
314
319
  command.query['fields'] = fields unless fields.nil?
@@ -316,18 +321,18 @@ module Google
316
321
  execute_or_queue_command(command, &block)
317
322
  end
318
323
 
319
- # UpdateApi can be used to modify a specified API.
324
+ # Used to modify a specified API.
320
325
  # @param [String] name
321
326
  # Resource name.
322
327
  # @param [Google::Apis::ApigeeregistryV1::Api] api_object
323
328
  # @param [Boolean] allow_missing
324
- # If set to true, and the api is not found, a new api will be created. In this
329
+ # If set to true, and the API is not found, a new API will be created. In this
325
330
  # situation, `update_mask` is ignored.
326
331
  # @param [String] update_mask
327
332
  # The list of fields to be updated. If omitted, all fields are updated that are
328
- # set in the request message (fields set to default values are ignored). If a "*"
329
- # is specified, all fields are updated, including fields that are unspecified/
330
- # default in the request.
333
+ # set in the request message (fields set to default values are ignored). If an
334
+ # asterisk "*" is specified, all fields are updated, including fields that are
335
+ # unspecified/default in the request.
331
336
  # @param [String] fields
332
337
  # Selector specifying which fields to include in a partial response.
333
338
  # @param [String] quota_user
@@ -435,9 +440,10 @@ module Google
435
440
  execute_or_queue_command(command, &block)
436
441
  end
437
442
 
438
- # CreateArtifact creates a specified artifact.
443
+ # Creates a specified artifact.
439
444
  # @param [String] parent
440
- # Required. The parent, which owns this collection of artifacts. Format: `parent`
445
+ # Required. The parent, which owns this collection of artifacts. Format: ``
446
+ # parent``
441
447
  # @param [Google::Apis::ApigeeregistryV1::Artifact] artifact_object
442
448
  # @param [String] artifact_id
443
449
  # Required. The ID to use for the artifact, which will become the final
@@ -474,9 +480,9 @@ module Google
474
480
  execute_or_queue_command(command, &block)
475
481
  end
476
482
 
477
- # DeleteArtifact removes a specified artifact.
483
+ # Removes a specified artifact.
478
484
  # @param [String] name
479
- # Required. The name of the artifact to delete. Format: `parent`/artifacts/*
485
+ # Required. The name of the artifact to delete. Format: ``parent`/artifacts/*`
480
486
  # @param [String] fields
481
487
  # Selector specifying which fields to include in a partial response.
482
488
  # @param [String] quota_user
@@ -504,9 +510,9 @@ module Google
504
510
  execute_or_queue_command(command, &block)
505
511
  end
506
512
 
507
- # GetArtifact returns a specified artifact.
513
+ # Returns a specified artifact.
508
514
  # @param [String] name
509
- # Required. The name of the artifact to retrieve. Format: `parent`/artifacts/*
515
+ # Required. The name of the artifact to retrieve. Format: ``parent`/artifacts/*`
510
516
  # @param [String] fields
511
517
  # Selector specifying which fields to include in a partial response.
512
518
  # @param [String] quota_user
@@ -534,13 +540,12 @@ module Google
534
540
  execute_or_queue_command(command, &block)
535
541
  end
536
542
 
537
- # GetArtifactContents returns the contents of a specified artifact. If artifacts
538
- # are stored with GZip compression, the default behavior is to return the
539
- # artifact uncompressed (the mime_type response field indicates the exact format
540
- # returned).
543
+ # Returns the contents of a specified artifact. If artifacts are stored with
544
+ # GZip compression, the default behavior is to return the artifact uncompressed (
545
+ # the mime_type response field indicates the exact format returned).
541
546
  # @param [String] name
542
547
  # Required. The name of the artifact whose contents should be retrieved. Format:
543
- # `parent`/artifacts/*
548
+ # ``parent`/artifacts/*`
544
549
  # @param [String] fields
545
550
  # Selector specifying which fields to include in a partial response.
546
551
  # @param [String] quota_user
@@ -613,12 +618,16 @@ module Google
613
618
  execute_or_queue_command(command, &block)
614
619
  end
615
620
 
616
- # ListArtifacts returns matching artifacts.
621
+ # Returns matching artifacts.
617
622
  # @param [String] parent
618
- # Required. The parent, which owns this collection of artifacts. Format: `parent`
623
+ # Required. The parent, which owns this collection of artifacts. Format: ``
624
+ # parent``
619
625
  # @param [String] filter
620
626
  # An expression that can be used to filter the list. Filters use the Common
621
627
  # Expression Language and can refer to all message fields except contents.
628
+ # @param [String] order_by
629
+ # A comma-separated list of fields, e.g. "foo,bar" Fields can be sorted in
630
+ # descending order using the "desc" identifier, e.g. "foo desc,bar"
622
631
  # @param [Fixnum] page_size
623
632
  # The maximum number of artifacts to return. The service may return fewer than
624
633
  # this value. If unspecified, at most 50 values will be returned. The maximum is
@@ -644,12 +653,13 @@ module Google
644
653
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
645
654
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
646
655
  # @raise [Google::Apis::AuthorizationError] Authorization is required
647
- def list_project_location_api_artifacts(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
656
+ def list_project_location_api_artifacts(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
648
657
  command = make_simple_command(:get, 'v1/{+parent}/artifacts', options)
649
658
  command.response_representation = Google::Apis::ApigeeregistryV1::ListArtifactsResponse::Representation
650
659
  command.response_class = Google::Apis::ApigeeregistryV1::ListArtifactsResponse
651
660
  command.params['parent'] = parent unless parent.nil?
652
661
  command.query['filter'] = filter unless filter.nil?
662
+ command.query['orderBy'] = order_by unless order_by.nil?
653
663
  command.query['pageSize'] = page_size unless page_size.nil?
654
664
  command.query['pageToken'] = page_token unless page_token.nil?
655
665
  command.query['fields'] = fields unless fields.nil?
@@ -657,7 +667,7 @@ module Google
657
667
  execute_or_queue_command(command, &block)
658
668
  end
659
669
 
660
- # ReplaceArtifact can be used to replace a specified artifact.
670
+ # Used to replace a specified artifact.
661
671
  # @param [String] name
662
672
  # Resource name.
663
673
  # @param [Google::Apis::ApigeeregistryV1::Artifact] artifact_object
@@ -766,10 +776,10 @@ module Google
766
776
  execute_or_queue_command(command, &block)
767
777
  end
768
778
 
769
- # CreateApiDeployment creates a specified deployment.
779
+ # Creates a specified deployment.
770
780
  # @param [String] parent
771
- # Required. The parent, which owns this collection of deployments. Format:
772
- # projects/*/locations/*/apis/*
781
+ # Required. The parent, which owns this collection of deployments. Format: `
782
+ # projects/*/locations/*/apis/*`
773
783
  # @param [Google::Apis::ApigeeregistryV1::ApiDeployment] api_deployment_object
774
784
  # @param [String] api_deployment_id
775
785
  # Required. The ID to use for the deployment, which will become the final
@@ -806,11 +816,11 @@ module Google
806
816
  execute_or_queue_command(command, &block)
807
817
  end
808
818
 
809
- # DeleteApiDeployment removes a specified deployment, all revisions, and all
810
- # child resources (e.g. artifacts).
819
+ # Removes a specified deployment, all revisions, and all child resources (e.g.,
820
+ # artifacts).
811
821
  # @param [String] name
812
- # Required. The name of the deployment to delete. Format: projects/*/locations/*/
813
- # apis/*/deployments/*
822
+ # Required. The name of the deployment to delete. Format: `projects/*/locations/*
823
+ # /apis/*/deployments/*`
814
824
  # @param [Boolean] force
815
825
  # If set to true, any child resources will also be deleted. (Otherwise, the
816
826
  # request will only work if there are no child resources.)
@@ -842,11 +852,11 @@ module Google
842
852
  execute_or_queue_command(command, &block)
843
853
  end
844
854
 
845
- # DeleteApiDeploymentRevision deletes a revision of a deployment.
855
+ # Deletes a revision of a deployment.
846
856
  # @param [String] name
847
857
  # Required. The name of the deployment revision to be deleted, with a revision
848
- # ID explicitly included. Example: projects/sample/locations/global/apis/
849
- # petstore/deployments/prod@c7cfa2a8
858
+ # ID explicitly included. Example: `projects/sample/locations/global/apis/
859
+ # petstore/deployments/prod@c7cfa2a8`
850
860
  # @param [String] fields
851
861
  # Selector specifying which fields to include in a partial response.
852
862
  # @param [String] quota_user
@@ -874,10 +884,10 @@ module Google
874
884
  execute_or_queue_command(command, &block)
875
885
  end
876
886
 
877
- # GetApiDeployment returns a specified deployment.
887
+ # Returns a specified deployment.
878
888
  # @param [String] name
879
- # Required. The name of the deployment to retrieve. Format: projects/*/locations/
880
- # */apis/*/deployments/*
889
+ # Required. The name of the deployment to retrieve. Format: `projects/*/
890
+ # locations/*/apis/*/deployments/*`
881
891
  # @param [String] fields
882
892
  # Selector specifying which fields to include in a partial response.
883
893
  # @param [String] quota_user
@@ -950,13 +960,16 @@ module Google
950
960
  execute_or_queue_command(command, &block)
951
961
  end
952
962
 
953
- # ListApiDeployments returns matching deployments.
963
+ # Returns matching deployments.
954
964
  # @param [String] parent
955
- # Required. The parent, which owns this collection of deployments. Format:
956
- # projects/*/locations/*/apis/*
965
+ # Required. The parent, which owns this collection of deployments. Format: `
966
+ # projects/*/locations/*/apis/*`
957
967
  # @param [String] filter
958
968
  # An expression that can be used to filter the list. Filters use the Common
959
969
  # Expression Language and can refer to all message fields.
970
+ # @param [String] order_by
971
+ # A comma-separated list of fields, e.g. "foo,bar" Fields can be sorted in
972
+ # descending order using the "desc" identifier, e.g. "foo desc,bar"
960
973
  # @param [Fixnum] page_size
961
974
  # The maximum number of deployments to return. The service may return fewer than
962
975
  # this value. If unspecified, at most 50 values will be returned. The maximum is
@@ -983,12 +996,13 @@ module Google
983
996
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
984
997
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
985
998
  # @raise [Google::Apis::AuthorizationError] Authorization is required
986
- def list_project_location_api_deployments(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
999
+ def list_project_location_api_deployments(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
987
1000
  command = make_simple_command(:get, 'v1/{+parent}/deployments', options)
988
1001
  command.response_representation = Google::Apis::ApigeeregistryV1::ListApiDeploymentsResponse::Representation
989
1002
  command.response_class = Google::Apis::ApigeeregistryV1::ListApiDeploymentsResponse
990
1003
  command.params['parent'] = parent unless parent.nil?
991
1004
  command.query['filter'] = filter unless filter.nil?
1005
+ command.query['orderBy'] = order_by unless order_by.nil?
992
1006
  command.query['pageSize'] = page_size unless page_size.nil?
993
1007
  command.query['pageToken'] = page_token unless page_token.nil?
994
1008
  command.query['fields'] = fields unless fields.nil?
@@ -996,8 +1010,8 @@ module Google
996
1010
  execute_or_queue_command(command, &block)
997
1011
  end
998
1012
 
999
- # ListApiDeploymentRevisions lists all revisions of a deployment. Revisions are
1000
- # returned in descending order of revision creation time.
1013
+ # Lists all revisions of a deployment. Revisions are returned in descending
1014
+ # order of revision creation time.
1001
1015
  # @param [String] name
1002
1016
  # Required. The name of the deployment to list revisions for.
1003
1017
  # @param [Fixnum] page_size
@@ -1034,7 +1048,7 @@ module Google
1034
1048
  execute_or_queue_command(command, &block)
1035
1049
  end
1036
1050
 
1037
- # UpdateApiDeployment can be used to modify a specified deployment.
1051
+ # Used to modify a specified deployment.
1038
1052
  # @param [String] name
1039
1053
  # Resource name.
1040
1054
  # @param [Google::Apis::ApigeeregistryV1::ApiDeployment] api_deployment_object
@@ -1043,9 +1057,9 @@ module Google
1043
1057
  # created. In this situation, `update_mask` is ignored.
1044
1058
  # @param [String] update_mask
1045
1059
  # The list of fields to be updated. If omitted, all fields are updated that are
1046
- # set in the request message (fields set to default values are ignored). If a "*"
1047
- # is specified, all fields are updated, including fields that are unspecified/
1048
- # default in the request.
1060
+ # set in the request message (fields set to default values are ignored). If an
1061
+ # asterisk "*" is specified, all fields are updated, including fields that are
1062
+ # unspecified/default in the request.
1049
1063
  # @param [String] fields
1050
1064
  # Selector specifying which fields to include in a partial response.
1051
1065
  # @param [String] quota_user
@@ -1077,8 +1091,8 @@ module Google
1077
1091
  execute_or_queue_command(command, &block)
1078
1092
  end
1079
1093
 
1080
- # RollbackApiDeployment sets the current revision to a specified prior revision.
1081
- # Note that this creates a new revision with a new revision ID.
1094
+ # Sets the current revision to a specified prior revision. Note that this
1095
+ # creates a new revision with a new revision ID.
1082
1096
  # @param [String] name
1083
1097
  # Required. The deployment being rolled back.
1084
1098
  # @param [Google::Apis::ApigeeregistryV1::RollbackApiDeploymentRequest] rollback_api_deployment_request_object
@@ -1148,7 +1162,7 @@ module Google
1148
1162
  execute_or_queue_command(command, &block)
1149
1163
  end
1150
1164
 
1151
- # TagApiDeploymentRevision adds a tag to a specified revision of a deployment.
1165
+ # Adds a tag to a specified revision of a deployment.
1152
1166
  # @param [String] name
1153
1167
  # Required. The name of the deployment to be tagged, including the revision ID.
1154
1168
  # @param [Google::Apis::ApigeeregistryV1::TagApiDeploymentRevisionRequest] tag_api_deployment_revision_request_object
@@ -1220,9 +1234,10 @@ module Google
1220
1234
  execute_or_queue_command(command, &block)
1221
1235
  end
1222
1236
 
1223
- # CreateArtifact creates a specified artifact.
1237
+ # Creates a specified artifact.
1224
1238
  # @param [String] parent
1225
- # Required. The parent, which owns this collection of artifacts. Format: `parent`
1239
+ # Required. The parent, which owns this collection of artifacts. Format: ``
1240
+ # parent``
1226
1241
  # @param [Google::Apis::ApigeeregistryV1::Artifact] artifact_object
1227
1242
  # @param [String] artifact_id
1228
1243
  # Required. The ID to use for the artifact, which will become the final
@@ -1259,9 +1274,9 @@ module Google
1259
1274
  execute_or_queue_command(command, &block)
1260
1275
  end
1261
1276
 
1262
- # DeleteArtifact removes a specified artifact.
1277
+ # Removes a specified artifact.
1263
1278
  # @param [String] name
1264
- # Required. The name of the artifact to delete. Format: `parent`/artifacts/*
1279
+ # Required. The name of the artifact to delete. Format: ``parent`/artifacts/*`
1265
1280
  # @param [String] fields
1266
1281
  # Selector specifying which fields to include in a partial response.
1267
1282
  # @param [String] quota_user
@@ -1289,9 +1304,9 @@ module Google
1289
1304
  execute_or_queue_command(command, &block)
1290
1305
  end
1291
1306
 
1292
- # GetArtifact returns a specified artifact.
1307
+ # Returns a specified artifact.
1293
1308
  # @param [String] name
1294
- # Required. The name of the artifact to retrieve. Format: `parent`/artifacts/*
1309
+ # Required. The name of the artifact to retrieve. Format: ``parent`/artifacts/*`
1295
1310
  # @param [String] fields
1296
1311
  # Selector specifying which fields to include in a partial response.
1297
1312
  # @param [String] quota_user
@@ -1319,13 +1334,12 @@ module Google
1319
1334
  execute_or_queue_command(command, &block)
1320
1335
  end
1321
1336
 
1322
- # GetArtifactContents returns the contents of a specified artifact. If artifacts
1323
- # are stored with GZip compression, the default behavior is to return the
1324
- # artifact uncompressed (the mime_type response field indicates the exact format
1325
- # returned).
1337
+ # Returns the contents of a specified artifact. If artifacts are stored with
1338
+ # GZip compression, the default behavior is to return the artifact uncompressed (
1339
+ # the mime_type response field indicates the exact format returned).
1326
1340
  # @param [String] name
1327
1341
  # Required. The name of the artifact whose contents should be retrieved. Format:
1328
- # `parent`/artifacts/*
1342
+ # ``parent`/artifacts/*`
1329
1343
  # @param [String] fields
1330
1344
  # Selector specifying which fields to include in a partial response.
1331
1345
  # @param [String] quota_user
@@ -1353,12 +1367,16 @@ module Google
1353
1367
  execute_or_queue_command(command, &block)
1354
1368
  end
1355
1369
 
1356
- # ListArtifacts returns matching artifacts.
1370
+ # Returns matching artifacts.
1357
1371
  # @param [String] parent
1358
- # Required. The parent, which owns this collection of artifacts. Format: `parent`
1372
+ # Required. The parent, which owns this collection of artifacts. Format: ``
1373
+ # parent``
1359
1374
  # @param [String] filter
1360
1375
  # An expression that can be used to filter the list. Filters use the Common
1361
1376
  # Expression Language and can refer to all message fields except contents.
1377
+ # @param [String] order_by
1378
+ # A comma-separated list of fields, e.g. "foo,bar" Fields can be sorted in
1379
+ # descending order using the "desc" identifier, e.g. "foo desc,bar"
1362
1380
  # @param [Fixnum] page_size
1363
1381
  # The maximum number of artifacts to return. The service may return fewer than
1364
1382
  # this value. If unspecified, at most 50 values will be returned. The maximum is
@@ -1384,12 +1402,13 @@ module Google
1384
1402
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1385
1403
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1386
1404
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1387
- def list_project_location_api_deployment_artifacts(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1405
+ def list_project_location_api_deployment_artifacts(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1388
1406
  command = make_simple_command(:get, 'v1/{+parent}/artifacts', options)
1389
1407
  command.response_representation = Google::Apis::ApigeeregistryV1::ListArtifactsResponse::Representation
1390
1408
  command.response_class = Google::Apis::ApigeeregistryV1::ListArtifactsResponse
1391
1409
  command.params['parent'] = parent unless parent.nil?
1392
1410
  command.query['filter'] = filter unless filter.nil?
1411
+ command.query['orderBy'] = order_by unless order_by.nil?
1393
1412
  command.query['pageSize'] = page_size unless page_size.nil?
1394
1413
  command.query['pageToken'] = page_token unless page_token.nil?
1395
1414
  command.query['fields'] = fields unless fields.nil?
@@ -1397,7 +1416,7 @@ module Google
1397
1416
  execute_or_queue_command(command, &block)
1398
1417
  end
1399
1418
 
1400
- # ReplaceArtifact can be used to replace a specified artifact.
1419
+ # Used to replace a specified artifact.
1401
1420
  # @param [String] name
1402
1421
  # Resource name.
1403
1422
  # @param [Google::Apis::ApigeeregistryV1::Artifact] artifact_object
@@ -1430,10 +1449,10 @@ module Google
1430
1449
  execute_or_queue_command(command, &block)
1431
1450
  end
1432
1451
 
1433
- # CreateApiVersion creates a specified version.
1452
+ # Creates a specified version.
1434
1453
  # @param [String] parent
1435
- # Required. The parent, which owns this collection of versions. Format: projects/
1436
- # */locations/*/apis/*
1454
+ # Required. The parent, which owns this collection of versions. Format: `
1455
+ # projects/*/locations/*/apis/*`
1437
1456
  # @param [Google::Apis::ApigeeregistryV1::ApiVersion] api_version_object
1438
1457
  # @param [String] api_version_id
1439
1458
  # Required. The ID to use for the version, which will become the final component
@@ -1470,11 +1489,10 @@ module Google
1470
1489
  execute_or_queue_command(command, &block)
1471
1490
  end
1472
1491
 
1473
- # DeleteApiVersion removes a specified version and all of the resources that it
1474
- # owns.
1492
+ # Removes a specified version and all of the resources that it owns.
1475
1493
  # @param [String] name
1476
- # Required. The name of the version to delete. Format: projects/*/locations/*/
1477
- # apis/*/versions/*
1494
+ # Required. The name of the version to delete. Format: `projects/*/locations/*/
1495
+ # apis/*/versions/*`
1478
1496
  # @param [Boolean] force
1479
1497
  # If set to true, any child resources will also be deleted. (Otherwise, the
1480
1498
  # request will only work if there are no child resources.)
@@ -1506,10 +1524,10 @@ module Google
1506
1524
  execute_or_queue_command(command, &block)
1507
1525
  end
1508
1526
 
1509
- # GetApiVersion returns a specified version.
1527
+ # Returns a specified version.
1510
1528
  # @param [String] name
1511
- # Required. The name of the version to retrieve. Format: projects/*/locations/*/
1512
- # apis/*/versions/*
1529
+ # Required. The name of the version to retrieve. Format: `projects/*/locations/*/
1530
+ # apis/*/versions/*`
1513
1531
  # @param [String] fields
1514
1532
  # Selector specifying which fields to include in a partial response.
1515
1533
  # @param [String] quota_user
@@ -1582,13 +1600,16 @@ module Google
1582
1600
  execute_or_queue_command(command, &block)
1583
1601
  end
1584
1602
 
1585
- # ListApiVersions returns matching versions.
1603
+ # Returns matching versions.
1586
1604
  # @param [String] parent
1587
- # Required. The parent, which owns this collection of versions. Format: projects/
1588
- # */locations/*/apis/*
1605
+ # Required. The parent, which owns this collection of versions. Format: `
1606
+ # projects/*/locations/*/apis/*`
1589
1607
  # @param [String] filter
1590
1608
  # An expression that can be used to filter the list. Filters use the Common
1591
1609
  # Expression Language and can refer to all message fields.
1610
+ # @param [String] order_by
1611
+ # A comma-separated list of fields, e.g. "foo,bar" Fields can be sorted in
1612
+ # descending order using the "desc" identifier, e.g. "foo desc,bar"
1592
1613
  # @param [Fixnum] page_size
1593
1614
  # The maximum number of versions to return. The service may return fewer than
1594
1615
  # this value. If unspecified, at most 50 values will be returned. The maximum is
@@ -1614,12 +1635,13 @@ module Google
1614
1635
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1615
1636
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1616
1637
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1617
- def list_project_location_api_versions(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1638
+ def list_project_location_api_versions(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1618
1639
  command = make_simple_command(:get, 'v1/{+parent}/versions', options)
1619
1640
  command.response_representation = Google::Apis::ApigeeregistryV1::ListApiVersionsResponse::Representation
1620
1641
  command.response_class = Google::Apis::ApigeeregistryV1::ListApiVersionsResponse
1621
1642
  command.params['parent'] = parent unless parent.nil?
1622
1643
  command.query['filter'] = filter unless filter.nil?
1644
+ command.query['orderBy'] = order_by unless order_by.nil?
1623
1645
  command.query['pageSize'] = page_size unless page_size.nil?
1624
1646
  command.query['pageToken'] = page_token unless page_token.nil?
1625
1647
  command.query['fields'] = fields unless fields.nil?
@@ -1627,7 +1649,7 @@ module Google
1627
1649
  execute_or_queue_command(command, &block)
1628
1650
  end
1629
1651
 
1630
- # UpdateApiVersion can be used to modify a specified version.
1652
+ # Used to modify a specified version.
1631
1653
  # @param [String] name
1632
1654
  # Resource name.
1633
1655
  # @param [Google::Apis::ApigeeregistryV1::ApiVersion] api_version_object
@@ -1636,9 +1658,9 @@ module Google
1636
1658
  # In this situation, `update_mask` is ignored.
1637
1659
  # @param [String] update_mask
1638
1660
  # The list of fields to be updated. If omitted, all fields are updated that are
1639
- # set in the request message (fields set to default values are ignored). If a "*"
1640
- # is specified, all fields are updated, including fields that are unspecified/
1641
- # default in the request.
1661
+ # set in the request message (fields set to default values are ignored). If an
1662
+ # asterisk "*" is specified, all fields are updated, including fields that are
1663
+ # unspecified/default in the request.
1642
1664
  # @param [String] fields
1643
1665
  # Selector specifying which fields to include in a partial response.
1644
1666
  # @param [String] quota_user
@@ -1746,9 +1768,10 @@ module Google
1746
1768
  execute_or_queue_command(command, &block)
1747
1769
  end
1748
1770
 
1749
- # CreateArtifact creates a specified artifact.
1771
+ # Creates a specified artifact.
1750
1772
  # @param [String] parent
1751
- # Required. The parent, which owns this collection of artifacts. Format: `parent`
1773
+ # Required. The parent, which owns this collection of artifacts. Format: ``
1774
+ # parent``
1752
1775
  # @param [Google::Apis::ApigeeregistryV1::Artifact] artifact_object
1753
1776
  # @param [String] artifact_id
1754
1777
  # Required. The ID to use for the artifact, which will become the final
@@ -1785,9 +1808,9 @@ module Google
1785
1808
  execute_or_queue_command(command, &block)
1786
1809
  end
1787
1810
 
1788
- # DeleteArtifact removes a specified artifact.
1811
+ # Removes a specified artifact.
1789
1812
  # @param [String] name
1790
- # Required. The name of the artifact to delete. Format: `parent`/artifacts/*
1813
+ # Required. The name of the artifact to delete. Format: ``parent`/artifacts/*`
1791
1814
  # @param [String] fields
1792
1815
  # Selector specifying which fields to include in a partial response.
1793
1816
  # @param [String] quota_user
@@ -1815,9 +1838,9 @@ module Google
1815
1838
  execute_or_queue_command(command, &block)
1816
1839
  end
1817
1840
 
1818
- # GetArtifact returns a specified artifact.
1841
+ # Returns a specified artifact.
1819
1842
  # @param [String] name
1820
- # Required. The name of the artifact to retrieve. Format: `parent`/artifacts/*
1843
+ # Required. The name of the artifact to retrieve. Format: ``parent`/artifacts/*`
1821
1844
  # @param [String] fields
1822
1845
  # Selector specifying which fields to include in a partial response.
1823
1846
  # @param [String] quota_user
@@ -1845,13 +1868,12 @@ module Google
1845
1868
  execute_or_queue_command(command, &block)
1846
1869
  end
1847
1870
 
1848
- # GetArtifactContents returns the contents of a specified artifact. If artifacts
1849
- # are stored with GZip compression, the default behavior is to return the
1850
- # artifact uncompressed (the mime_type response field indicates the exact format
1851
- # returned).
1871
+ # Returns the contents of a specified artifact. If artifacts are stored with
1872
+ # GZip compression, the default behavior is to return the artifact uncompressed (
1873
+ # the mime_type response field indicates the exact format returned).
1852
1874
  # @param [String] name
1853
1875
  # Required. The name of the artifact whose contents should be retrieved. Format:
1854
- # `parent`/artifacts/*
1876
+ # ``parent`/artifacts/*`
1855
1877
  # @param [String] fields
1856
1878
  # Selector specifying which fields to include in a partial response.
1857
1879
  # @param [String] quota_user
@@ -1924,12 +1946,16 @@ module Google
1924
1946
  execute_or_queue_command(command, &block)
1925
1947
  end
1926
1948
 
1927
- # ListArtifacts returns matching artifacts.
1949
+ # Returns matching artifacts.
1928
1950
  # @param [String] parent
1929
- # Required. The parent, which owns this collection of artifacts. Format: `parent`
1951
+ # Required. The parent, which owns this collection of artifacts. Format: ``
1952
+ # parent``
1930
1953
  # @param [String] filter
1931
1954
  # An expression that can be used to filter the list. Filters use the Common
1932
1955
  # Expression Language and can refer to all message fields except contents.
1956
+ # @param [String] order_by
1957
+ # A comma-separated list of fields, e.g. "foo,bar" Fields can be sorted in
1958
+ # descending order using the "desc" identifier, e.g. "foo desc,bar"
1933
1959
  # @param [Fixnum] page_size
1934
1960
  # The maximum number of artifacts to return. The service may return fewer than
1935
1961
  # this value. If unspecified, at most 50 values will be returned. The maximum is
@@ -1955,12 +1981,13 @@ module Google
1955
1981
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1956
1982
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1957
1983
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1958
- def list_project_location_api_version_artifacts(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1984
+ def list_project_location_api_version_artifacts(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1959
1985
  command = make_simple_command(:get, 'v1/{+parent}/artifacts', options)
1960
1986
  command.response_representation = Google::Apis::ApigeeregistryV1::ListArtifactsResponse::Representation
1961
1987
  command.response_class = Google::Apis::ApigeeregistryV1::ListArtifactsResponse
1962
1988
  command.params['parent'] = parent unless parent.nil?
1963
1989
  command.query['filter'] = filter unless filter.nil?
1990
+ command.query['orderBy'] = order_by unless order_by.nil?
1964
1991
  command.query['pageSize'] = page_size unless page_size.nil?
1965
1992
  command.query['pageToken'] = page_token unless page_token.nil?
1966
1993
  command.query['fields'] = fields unless fields.nil?
@@ -1968,7 +1995,7 @@ module Google
1968
1995
  execute_or_queue_command(command, &block)
1969
1996
  end
1970
1997
 
1971
- # ReplaceArtifact can be used to replace a specified artifact.
1998
+ # Used to replace a specified artifact.
1972
1999
  # @param [String] name
1973
2000
  # Resource name.
1974
2001
  # @param [Google::Apis::ApigeeregistryV1::Artifact] artifact_object
@@ -2077,10 +2104,10 @@ module Google
2077
2104
  execute_or_queue_command(command, &block)
2078
2105
  end
2079
2106
 
2080
- # CreateApiSpec creates a specified spec.
2107
+ # Creates a specified spec.
2081
2108
  # @param [String] parent
2082
- # Required. The parent, which owns this collection of specs. Format: projects/*/
2083
- # locations/*/apis/*/versions/*
2109
+ # Required. The parent, which owns this collection of specs. Format: `projects/*/
2110
+ # locations/*/apis/*/versions/*`
2084
2111
  # @param [Google::Apis::ApigeeregistryV1::ApiSpec] api_spec_object
2085
2112
  # @param [String] api_spec_id
2086
2113
  # Required. The ID to use for the spec, which will become the final component of
@@ -2116,11 +2143,11 @@ module Google
2116
2143
  execute_or_queue_command(command, &block)
2117
2144
  end
2118
2145
 
2119
- # DeleteApiSpec removes a specified spec, all revisions, and all child resources
2120
- # (e.g. artifacts).
2146
+ # Removes a specified spec, all revisions, and all child resources (e.g.,
2147
+ # artifacts).
2121
2148
  # @param [String] name
2122
- # Required. The name of the spec to delete. Format: projects/*/locations/*/apis/*
2123
- # /versions/*/specs/*
2149
+ # Required. The name of the spec to delete. Format: `projects/*/locations/*/apis/
2150
+ # */versions/*/specs/*`
2124
2151
  # @param [Boolean] force
2125
2152
  # If set to true, any child resources will also be deleted. (Otherwise, the
2126
2153
  # request will only work if there are no child resources.)
@@ -2152,11 +2179,11 @@ module Google
2152
2179
  execute_or_queue_command(command, &block)
2153
2180
  end
2154
2181
 
2155
- # DeleteApiSpecRevision deletes a revision of a spec.
2182
+ # Deletes a revision of a spec.
2156
2183
  # @param [String] name
2157
2184
  # Required. The name of the spec revision to be deleted, with a revision ID
2158
- # explicitly included. Example: projects/sample/locations/global/apis/petstore/
2159
- # versions/1.0.0/specs/openapi.yaml@c7cfa2a8
2185
+ # explicitly included. Example: `projects/sample/locations/global/apis/petstore/
2186
+ # versions/1.0.0/specs/openapi.yaml@c7cfa2a8`
2160
2187
  # @param [String] fields
2161
2188
  # Selector specifying which fields to include in a partial response.
2162
2189
  # @param [String] quota_user
@@ -2184,10 +2211,10 @@ module Google
2184
2211
  execute_or_queue_command(command, &block)
2185
2212
  end
2186
2213
 
2187
- # GetApiSpec returns a specified spec.
2214
+ # Returns a specified spec.
2188
2215
  # @param [String] name
2189
- # Required. The name of the spec to retrieve. Format: projects/*/locations/*/
2190
- # apis/*/versions/*/specs/*
2216
+ # Required. The name of the spec to retrieve. Format: `projects/*/locations/*/
2217
+ # apis/*/versions/*/specs/*`
2191
2218
  # @param [String] fields
2192
2219
  # Selector specifying which fields to include in a partial response.
2193
2220
  # @param [String] quota_user
@@ -2215,13 +2242,12 @@ module Google
2215
2242
  execute_or_queue_command(command, &block)
2216
2243
  end
2217
2244
 
2218
- # GetApiSpecContents returns the contents of a specified spec. If specs are
2219
- # stored with GZip compression, the default behavior is to return the spec
2220
- # uncompressed (the mime_type response field indicates the exact format returned)
2221
- # .
2245
+ # Returns the contents of a specified spec. If specs are stored with GZip
2246
+ # compression, the default behavior is to return the spec uncompressed (the
2247
+ # mime_type response field indicates the exact format returned).
2222
2248
  # @param [String] name
2223
- # Required. The name of the spec whose contents should be retrieved. Format:
2224
- # projects/*/locations/*/apis/*/versions/*/specs/*
2249
+ # Required. The name of the spec whose contents should be retrieved. Format: `
2250
+ # projects/*/locations/*/apis/*/versions/*/specs/*`
2225
2251
  # @param [String] fields
2226
2252
  # Selector specifying which fields to include in a partial response.
2227
2253
  # @param [String] quota_user
@@ -2294,13 +2320,16 @@ module Google
2294
2320
  execute_or_queue_command(command, &block)
2295
2321
  end
2296
2322
 
2297
- # ListApiSpecs returns matching specs.
2323
+ # Returns matching specs.
2298
2324
  # @param [String] parent
2299
- # Required. The parent, which owns this collection of specs. Format: projects/*/
2300
- # locations/*/apis/*/versions/*
2325
+ # Required. The parent, which owns this collection of specs. Format: `projects/*/
2326
+ # locations/*/apis/*/versions/*`
2301
2327
  # @param [String] filter
2302
2328
  # An expression that can be used to filter the list. Filters use the Common
2303
2329
  # Expression Language and can refer to all message fields except contents.
2330
+ # @param [String] order_by
2331
+ # A comma-separated list of fields, e.g. "foo,bar" Fields can be sorted in
2332
+ # descending order using the "desc" identifier, e.g. "foo desc,bar"
2304
2333
  # @param [Fixnum] page_size
2305
2334
  # The maximum number of specs to return. The service may return fewer than this
2306
2335
  # value. If unspecified, at most 50 values will be returned. The maximum is 1000;
@@ -2326,12 +2355,13 @@ module Google
2326
2355
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2327
2356
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2328
2357
  # @raise [Google::Apis::AuthorizationError] Authorization is required
2329
- def list_project_location_api_version_specs(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
2358
+ def list_project_location_api_version_specs(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
2330
2359
  command = make_simple_command(:get, 'v1/{+parent}/specs', options)
2331
2360
  command.response_representation = Google::Apis::ApigeeregistryV1::ListApiSpecsResponse::Representation
2332
2361
  command.response_class = Google::Apis::ApigeeregistryV1::ListApiSpecsResponse
2333
2362
  command.params['parent'] = parent unless parent.nil?
2334
2363
  command.query['filter'] = filter unless filter.nil?
2364
+ command.query['orderBy'] = order_by unless order_by.nil?
2335
2365
  command.query['pageSize'] = page_size unless page_size.nil?
2336
2366
  command.query['pageToken'] = page_token unless page_token.nil?
2337
2367
  command.query['fields'] = fields unless fields.nil?
@@ -2339,8 +2369,8 @@ module Google
2339
2369
  execute_or_queue_command(command, &block)
2340
2370
  end
2341
2371
 
2342
- # ListApiSpecRevisions lists all revisions of a spec. Revisions are returned in
2343
- # descending order of revision creation time.
2372
+ # Lists all revisions of a spec. Revisions are returned in descending order of
2373
+ # revision creation time.
2344
2374
  # @param [String] name
2345
2375
  # Required. The name of the spec to list revisions for.
2346
2376
  # @param [Fixnum] page_size
@@ -2377,7 +2407,7 @@ module Google
2377
2407
  execute_or_queue_command(command, &block)
2378
2408
  end
2379
2409
 
2380
- # UpdateApiSpec can be used to modify a specified spec.
2410
+ # Used to modify a specified spec.
2381
2411
  # @param [String] name
2382
2412
  # Resource name.
2383
2413
  # @param [Google::Apis::ApigeeregistryV1::ApiSpec] api_spec_object
@@ -2386,9 +2416,9 @@ module Google
2386
2416
  # situation, `update_mask` is ignored.
2387
2417
  # @param [String] update_mask
2388
2418
  # The list of fields to be updated. If omitted, all fields are updated that are
2389
- # set in the request message (fields set to default values are ignored). If a "*"
2390
- # is specified, all fields are updated, including fields that are unspecified/
2391
- # default in the request.
2419
+ # set in the request message (fields set to default values are ignored). If an
2420
+ # asterisk "*" is specified, all fields are updated, including fields that are
2421
+ # unspecified/default in the request.
2392
2422
  # @param [String] fields
2393
2423
  # Selector specifying which fields to include in a partial response.
2394
2424
  # @param [String] quota_user
@@ -2420,8 +2450,8 @@ module Google
2420
2450
  execute_or_queue_command(command, &block)
2421
2451
  end
2422
2452
 
2423
- # RollbackApiSpec sets the current revision to a specified prior revision. Note
2424
- # that this creates a new revision with a new revision ID.
2453
+ # Sets the current revision to a specified prior revision. Note that this
2454
+ # creates a new revision with a new revision ID.
2425
2455
  # @param [String] name
2426
2456
  # Required. The spec being rolled back.
2427
2457
  # @param [Google::Apis::ApigeeregistryV1::RollbackApiSpecRequest] rollback_api_spec_request_object
@@ -2491,7 +2521,7 @@ module Google
2491
2521
  execute_or_queue_command(command, &block)
2492
2522
  end
2493
2523
 
2494
- # TagApiSpecRevision adds a tag to a specified revision of a spec.
2524
+ # Adds a tag to a specified revision of a spec.
2495
2525
  # @param [String] name
2496
2526
  # Required. The name of the spec to be tagged, including the revision ID.
2497
2527
  # @param [Google::Apis::ApigeeregistryV1::TagApiSpecRevisionRequest] tag_api_spec_revision_request_object
@@ -2563,9 +2593,10 @@ module Google
2563
2593
  execute_or_queue_command(command, &block)
2564
2594
  end
2565
2595
 
2566
- # CreateArtifact creates a specified artifact.
2596
+ # Creates a specified artifact.
2567
2597
  # @param [String] parent
2568
- # Required. The parent, which owns this collection of artifacts. Format: `parent`
2598
+ # Required. The parent, which owns this collection of artifacts. Format: ``
2599
+ # parent``
2569
2600
  # @param [Google::Apis::ApigeeregistryV1::Artifact] artifact_object
2570
2601
  # @param [String] artifact_id
2571
2602
  # Required. The ID to use for the artifact, which will become the final
@@ -2602,9 +2633,9 @@ module Google
2602
2633
  execute_or_queue_command(command, &block)
2603
2634
  end
2604
2635
 
2605
- # DeleteArtifact removes a specified artifact.
2636
+ # Removes a specified artifact.
2606
2637
  # @param [String] name
2607
- # Required. The name of the artifact to delete. Format: `parent`/artifacts/*
2638
+ # Required. The name of the artifact to delete. Format: ``parent`/artifacts/*`
2608
2639
  # @param [String] fields
2609
2640
  # Selector specifying which fields to include in a partial response.
2610
2641
  # @param [String] quota_user
@@ -2632,9 +2663,9 @@ module Google
2632
2663
  execute_or_queue_command(command, &block)
2633
2664
  end
2634
2665
 
2635
- # GetArtifact returns a specified artifact.
2666
+ # Returns a specified artifact.
2636
2667
  # @param [String] name
2637
- # Required. The name of the artifact to retrieve. Format: `parent`/artifacts/*
2668
+ # Required. The name of the artifact to retrieve. Format: ``parent`/artifacts/*`
2638
2669
  # @param [String] fields
2639
2670
  # Selector specifying which fields to include in a partial response.
2640
2671
  # @param [String] quota_user
@@ -2662,13 +2693,12 @@ module Google
2662
2693
  execute_or_queue_command(command, &block)
2663
2694
  end
2664
2695
 
2665
- # GetArtifactContents returns the contents of a specified artifact. If artifacts
2666
- # are stored with GZip compression, the default behavior is to return the
2667
- # artifact uncompressed (the mime_type response field indicates the exact format
2668
- # returned).
2696
+ # Returns the contents of a specified artifact. If artifacts are stored with
2697
+ # GZip compression, the default behavior is to return the artifact uncompressed (
2698
+ # the mime_type response field indicates the exact format returned).
2669
2699
  # @param [String] name
2670
2700
  # Required. The name of the artifact whose contents should be retrieved. Format:
2671
- # `parent`/artifacts/*
2701
+ # ``parent`/artifacts/*`
2672
2702
  # @param [String] fields
2673
2703
  # Selector specifying which fields to include in a partial response.
2674
2704
  # @param [String] quota_user
@@ -2741,12 +2771,16 @@ module Google
2741
2771
  execute_or_queue_command(command, &block)
2742
2772
  end
2743
2773
 
2744
- # ListArtifacts returns matching artifacts.
2774
+ # Returns matching artifacts.
2745
2775
  # @param [String] parent
2746
- # Required. The parent, which owns this collection of artifacts. Format: `parent`
2776
+ # Required. The parent, which owns this collection of artifacts. Format: ``
2777
+ # parent``
2747
2778
  # @param [String] filter
2748
2779
  # An expression that can be used to filter the list. Filters use the Common
2749
2780
  # Expression Language and can refer to all message fields except contents.
2781
+ # @param [String] order_by
2782
+ # A comma-separated list of fields, e.g. "foo,bar" Fields can be sorted in
2783
+ # descending order using the "desc" identifier, e.g. "foo desc,bar"
2750
2784
  # @param [Fixnum] page_size
2751
2785
  # The maximum number of artifacts to return. The service may return fewer than
2752
2786
  # this value. If unspecified, at most 50 values will be returned. The maximum is
@@ -2772,12 +2806,13 @@ module Google
2772
2806
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2773
2807
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2774
2808
  # @raise [Google::Apis::AuthorizationError] Authorization is required
2775
- def list_project_location_api_version_spec_artifacts(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
2809
+ def list_project_location_api_version_spec_artifacts(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
2776
2810
  command = make_simple_command(:get, 'v1/{+parent}/artifacts', options)
2777
2811
  command.response_representation = Google::Apis::ApigeeregistryV1::ListArtifactsResponse::Representation
2778
2812
  command.response_class = Google::Apis::ApigeeregistryV1::ListArtifactsResponse
2779
2813
  command.params['parent'] = parent unless parent.nil?
2780
2814
  command.query['filter'] = filter unless filter.nil?
2815
+ command.query['orderBy'] = order_by unless order_by.nil?
2781
2816
  command.query['pageSize'] = page_size unless page_size.nil?
2782
2817
  command.query['pageToken'] = page_token unless page_token.nil?
2783
2818
  command.query['fields'] = fields unless fields.nil?
@@ -2785,7 +2820,7 @@ module Google
2785
2820
  execute_or_queue_command(command, &block)
2786
2821
  end
2787
2822
 
2788
- # ReplaceArtifact can be used to replace a specified artifact.
2823
+ # Used to replace a specified artifact.
2789
2824
  # @param [String] name
2790
2825
  # Resource name.
2791
2826
  # @param [Google::Apis::ApigeeregistryV1::Artifact] artifact_object
@@ -2894,9 +2929,10 @@ module Google
2894
2929
  execute_or_queue_command(command, &block)
2895
2930
  end
2896
2931
 
2897
- # CreateArtifact creates a specified artifact.
2932
+ # Creates a specified artifact.
2898
2933
  # @param [String] parent
2899
- # Required. The parent, which owns this collection of artifacts. Format: `parent`
2934
+ # Required. The parent, which owns this collection of artifacts. Format: ``
2935
+ # parent``
2900
2936
  # @param [Google::Apis::ApigeeregistryV1::Artifact] artifact_object
2901
2937
  # @param [String] artifact_id
2902
2938
  # Required. The ID to use for the artifact, which will become the final
@@ -2933,9 +2969,9 @@ module Google
2933
2969
  execute_or_queue_command(command, &block)
2934
2970
  end
2935
2971
 
2936
- # DeleteArtifact removes a specified artifact.
2972
+ # Removes a specified artifact.
2937
2973
  # @param [String] name
2938
- # Required. The name of the artifact to delete. Format: `parent`/artifacts/*
2974
+ # Required. The name of the artifact to delete. Format: ``parent`/artifacts/*`
2939
2975
  # @param [String] fields
2940
2976
  # Selector specifying which fields to include in a partial response.
2941
2977
  # @param [String] quota_user
@@ -2963,9 +2999,9 @@ module Google
2963
2999
  execute_or_queue_command(command, &block)
2964
3000
  end
2965
3001
 
2966
- # GetArtifact returns a specified artifact.
3002
+ # Returns a specified artifact.
2967
3003
  # @param [String] name
2968
- # Required. The name of the artifact to retrieve. Format: `parent`/artifacts/*
3004
+ # Required. The name of the artifact to retrieve. Format: ``parent`/artifacts/*`
2969
3005
  # @param [String] fields
2970
3006
  # Selector specifying which fields to include in a partial response.
2971
3007
  # @param [String] quota_user
@@ -2993,13 +3029,12 @@ module Google
2993
3029
  execute_or_queue_command(command, &block)
2994
3030
  end
2995
3031
 
2996
- # GetArtifactContents returns the contents of a specified artifact. If artifacts
2997
- # are stored with GZip compression, the default behavior is to return the
2998
- # artifact uncompressed (the mime_type response field indicates the exact format
2999
- # returned).
3032
+ # Returns the contents of a specified artifact. If artifacts are stored with
3033
+ # GZip compression, the default behavior is to return the artifact uncompressed (
3034
+ # the mime_type response field indicates the exact format returned).
3000
3035
  # @param [String] name
3001
3036
  # Required. The name of the artifact whose contents should be retrieved. Format:
3002
- # `parent`/artifacts/*
3037
+ # ``parent`/artifacts/*`
3003
3038
  # @param [String] fields
3004
3039
  # Selector specifying which fields to include in a partial response.
3005
3040
  # @param [String] quota_user
@@ -3072,12 +3107,16 @@ module Google
3072
3107
  execute_or_queue_command(command, &block)
3073
3108
  end
3074
3109
 
3075
- # ListArtifacts returns matching artifacts.
3110
+ # Returns matching artifacts.
3076
3111
  # @param [String] parent
3077
- # Required. The parent, which owns this collection of artifacts. Format: `parent`
3112
+ # Required. The parent, which owns this collection of artifacts. Format: ``
3113
+ # parent``
3078
3114
  # @param [String] filter
3079
3115
  # An expression that can be used to filter the list. Filters use the Common
3080
3116
  # Expression Language and can refer to all message fields except contents.
3117
+ # @param [String] order_by
3118
+ # A comma-separated list of fields, e.g. "foo,bar" Fields can be sorted in
3119
+ # descending order using the "desc" identifier, e.g. "foo desc,bar"
3081
3120
  # @param [Fixnum] page_size
3082
3121
  # The maximum number of artifacts to return. The service may return fewer than
3083
3122
  # this value. If unspecified, at most 50 values will be returned. The maximum is
@@ -3103,12 +3142,13 @@ module Google
3103
3142
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3104
3143
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3105
3144
  # @raise [Google::Apis::AuthorizationError] Authorization is required
3106
- def list_project_location_artifacts(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
3145
+ def list_project_location_artifacts(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
3107
3146
  command = make_simple_command(:get, 'v1/{+parent}/artifacts', options)
3108
3147
  command.response_representation = Google::Apis::ApigeeregistryV1::ListArtifactsResponse::Representation
3109
3148
  command.response_class = Google::Apis::ApigeeregistryV1::ListArtifactsResponse
3110
3149
  command.params['parent'] = parent unless parent.nil?
3111
3150
  command.query['filter'] = filter unless filter.nil?
3151
+ command.query['orderBy'] = order_by unless order_by.nil?
3112
3152
  command.query['pageSize'] = page_size unless page_size.nil?
3113
3153
  command.query['pageToken'] = page_token unless page_token.nil?
3114
3154
  command.query['fields'] = fields unless fields.nil?
@@ -3116,7 +3156,7 @@ module Google
3116
3156
  execute_or_queue_command(command, &block)
3117
3157
  end
3118
3158
 
3119
- # ReplaceArtifact can be used to replace a specified artifact.
3159
+ # Used to replace a specified artifact.
3120
3160
  # @param [String] name
3121
3161
  # Resource name.
3122
3162
  # @param [Google::Apis::ApigeeregistryV1::Artifact] artifact_object