google-apis-apigeeregistry_v1 0.6.0 → 0.7.0

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