google-apis-apigeeregistry_v1 0.4.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,13 @@ 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
+ # `
168
+ # @param [Boolean] force
169
+ # If set to true, any child resources will also be deleted. (Otherwise, the
170
+ # request will only work if there are no child resources.)
167
171
  # @param [String] fields
168
172
  # Selector specifying which fields to include in a partial response.
169
173
  # @param [String] quota_user
@@ -181,20 +185,21 @@ module Google
181
185
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
182
186
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
183
187
  # @raise [Google::Apis::AuthorizationError] Authorization is required
184
- def delete_project_location_api(name, fields: nil, quota_user: nil, options: nil, &block)
188
+ def delete_project_location_api(name, force: nil, fields: nil, quota_user: nil, options: nil, &block)
185
189
  command = make_simple_command(:delete, 'v1/{+name}', options)
186
190
  command.response_representation = Google::Apis::ApigeeregistryV1::Empty::Representation
187
191
  command.response_class = Google::Apis::ApigeeregistryV1::Empty
188
192
  command.params['name'] = name unless name.nil?
193
+ command.query['force'] = force unless force.nil?
189
194
  command.query['fields'] = fields unless fields.nil?
190
195
  command.query['quotaUser'] = quota_user unless quota_user.nil?
191
196
  execute_or_queue_command(command, &block)
192
197
  end
193
198
 
194
- # GetApi returns a specified API.
199
+ # Returns a specified API.
195
200
  # @param [String] name
196
- # Required. The name of the API to retrieve. Format: projects/*/locations/*/apis/
197
- # *
201
+ # Required. The name of the API to retrieve. Format: `projects/*/locations/*/
202
+ # apis/*`
198
203
  # @param [String] fields
199
204
  # Selector specifying which fields to include in a partial response.
200
205
  # @param [String] quota_user
@@ -267,13 +272,16 @@ module Google
267
272
  execute_or_queue_command(command, &block)
268
273
  end
269
274
 
270
- # ListApis returns matching APIs.
275
+ # Returns matching APIs.
271
276
  # @param [String] parent
272
- # Required. The parent, which owns this collection of APIs. Format: projects/*/
273
- # locations/*
277
+ # Required. The parent, which owns this collection of APIs. Format: `projects/*/
278
+ # locations/*`
274
279
  # @param [String] filter
275
280
  # An expression that can be used to filter the list. Filters use the Common
276
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"
277
285
  # @param [Fixnum] page_size
278
286
  # The maximum number of APIs to return. The service may return fewer than this
279
287
  # value. If unspecified, at most 50 values will be returned. The maximum is 1000;
@@ -299,12 +307,13 @@ module Google
299
307
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
300
308
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
301
309
  # @raise [Google::Apis::AuthorizationError] Authorization is required
302
- 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)
303
311
  command = make_simple_command(:get, 'v1/{+parent}/apis', options)
304
312
  command.response_representation = Google::Apis::ApigeeregistryV1::ListApisResponse::Representation
305
313
  command.response_class = Google::Apis::ApigeeregistryV1::ListApisResponse
306
314
  command.params['parent'] = parent unless parent.nil?
307
315
  command.query['filter'] = filter unless filter.nil?
316
+ command.query['orderBy'] = order_by unless order_by.nil?
308
317
  command.query['pageSize'] = page_size unless page_size.nil?
309
318
  command.query['pageToken'] = page_token unless page_token.nil?
310
319
  command.query['fields'] = fields unless fields.nil?
@@ -312,18 +321,18 @@ module Google
312
321
  execute_or_queue_command(command, &block)
313
322
  end
314
323
 
315
- # UpdateApi can be used to modify a specified API.
324
+ # Used to modify a specified API.
316
325
  # @param [String] name
317
326
  # Resource name.
318
327
  # @param [Google::Apis::ApigeeregistryV1::Api] api_object
319
328
  # @param [Boolean] allow_missing
320
- # 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
321
330
  # situation, `update_mask` is ignored.
322
331
  # @param [String] update_mask
323
332
  # The list of fields to be updated. If omitted, all fields are updated that are
324
- # set in the request message (fields set to default values are ignored). If a "*"
325
- # is specified, all fields are updated, including fields that are unspecified/
326
- # 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.
327
336
  # @param [String] fields
328
337
  # Selector specifying which fields to include in a partial response.
329
338
  # @param [String] quota_user
@@ -431,9 +440,10 @@ module Google
431
440
  execute_or_queue_command(command, &block)
432
441
  end
433
442
 
434
- # CreateArtifact creates a specified artifact.
443
+ # Creates a specified artifact.
435
444
  # @param [String] parent
436
- # Required. The parent, which owns this collection of artifacts. Format: `parent`
445
+ # Required. The parent, which owns this collection of artifacts. Format: ``
446
+ # parent``
437
447
  # @param [Google::Apis::ApigeeregistryV1::Artifact] artifact_object
438
448
  # @param [String] artifact_id
439
449
  # Required. The ID to use for the artifact, which will become the final
@@ -470,9 +480,9 @@ module Google
470
480
  execute_or_queue_command(command, &block)
471
481
  end
472
482
 
473
- # DeleteArtifact removes a specified artifact.
483
+ # Removes a specified artifact.
474
484
  # @param [String] name
475
- # Required. The name of the artifact to delete. Format: `parent`/artifacts/*
485
+ # Required. The name of the artifact to delete. Format: ``parent`/artifacts/*`
476
486
  # @param [String] fields
477
487
  # Selector specifying which fields to include in a partial response.
478
488
  # @param [String] quota_user
@@ -500,9 +510,9 @@ module Google
500
510
  execute_or_queue_command(command, &block)
501
511
  end
502
512
 
503
- # GetArtifact returns a specified artifact.
513
+ # Returns a specified artifact.
504
514
  # @param [String] name
505
- # Required. The name of the artifact to retrieve. Format: `parent`/artifacts/*
515
+ # Required. The name of the artifact to retrieve. Format: ``parent`/artifacts/*`
506
516
  # @param [String] fields
507
517
  # Selector specifying which fields to include in a partial response.
508
518
  # @param [String] quota_user
@@ -530,13 +540,12 @@ module Google
530
540
  execute_or_queue_command(command, &block)
531
541
  end
532
542
 
533
- # GetArtifactContents returns the contents of a specified artifact. If artifacts
534
- # are stored with GZip compression, the default behavior is to return the
535
- # artifact uncompressed (the mime_type response field indicates the exact format
536
- # 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).
537
546
  # @param [String] name
538
547
  # Required. The name of the artifact whose contents should be retrieved. Format:
539
- # `parent`/artifacts/*
548
+ # ``parent`/artifacts/*`
540
549
  # @param [String] fields
541
550
  # Selector specifying which fields to include in a partial response.
542
551
  # @param [String] quota_user
@@ -609,12 +618,16 @@ module Google
609
618
  execute_or_queue_command(command, &block)
610
619
  end
611
620
 
612
- # ListArtifacts returns matching artifacts.
621
+ # Returns matching artifacts.
613
622
  # @param [String] parent
614
- # Required. The parent, which owns this collection of artifacts. Format: `parent`
623
+ # Required. The parent, which owns this collection of artifacts. Format: ``
624
+ # parent``
615
625
  # @param [String] filter
616
626
  # An expression that can be used to filter the list. Filters use the Common
617
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"
618
631
  # @param [Fixnum] page_size
619
632
  # The maximum number of artifacts to return. The service may return fewer than
620
633
  # this value. If unspecified, at most 50 values will be returned. The maximum is
@@ -640,12 +653,13 @@ module Google
640
653
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
641
654
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
642
655
  # @raise [Google::Apis::AuthorizationError] Authorization is required
643
- 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)
644
657
  command = make_simple_command(:get, 'v1/{+parent}/artifacts', options)
645
658
  command.response_representation = Google::Apis::ApigeeregistryV1::ListArtifactsResponse::Representation
646
659
  command.response_class = Google::Apis::ApigeeregistryV1::ListArtifactsResponse
647
660
  command.params['parent'] = parent unless parent.nil?
648
661
  command.query['filter'] = filter unless filter.nil?
662
+ command.query['orderBy'] = order_by unless order_by.nil?
649
663
  command.query['pageSize'] = page_size unless page_size.nil?
650
664
  command.query['pageToken'] = page_token unless page_token.nil?
651
665
  command.query['fields'] = fields unless fields.nil?
@@ -653,7 +667,7 @@ module Google
653
667
  execute_or_queue_command(command, &block)
654
668
  end
655
669
 
656
- # ReplaceArtifact can be used to replace a specified artifact.
670
+ # Used to replace a specified artifact.
657
671
  # @param [String] name
658
672
  # Resource name.
659
673
  # @param [Google::Apis::ApigeeregistryV1::Artifact] artifact_object
@@ -762,10 +776,10 @@ module Google
762
776
  execute_or_queue_command(command, &block)
763
777
  end
764
778
 
765
- # CreateApiDeployment creates a specified deployment.
779
+ # Creates a specified deployment.
766
780
  # @param [String] parent
767
- # Required. The parent, which owns this collection of deployments. Format:
768
- # projects/*/locations/*/apis/*
781
+ # Required. The parent, which owns this collection of deployments. Format: `
782
+ # projects/*/locations/*/apis/*`
769
783
  # @param [Google::Apis::ApigeeregistryV1::ApiDeployment] api_deployment_object
770
784
  # @param [String] api_deployment_id
771
785
  # Required. The ID to use for the deployment, which will become the final
@@ -802,11 +816,11 @@ module Google
802
816
  execute_or_queue_command(command, &block)
803
817
  end
804
818
 
805
- # DeleteApiDeployment removes a specified deployment, all revisions, and all
806
- # child resources (e.g. artifacts).
819
+ # Removes a specified deployment, all revisions, and all child resources (e.g.,
820
+ # artifacts).
807
821
  # @param [String] name
808
- # Required. The name of the deployment to delete. Format: projects/*/locations/*/
809
- # apis/*/deployments/*
822
+ # Required. The name of the deployment to delete. Format: `projects/*/locations/*
823
+ # /apis/*/deployments/*`
810
824
  # @param [Boolean] force
811
825
  # If set to true, any child resources will also be deleted. (Otherwise, the
812
826
  # request will only work if there are no child resources.)
@@ -838,11 +852,11 @@ module Google
838
852
  execute_or_queue_command(command, &block)
839
853
  end
840
854
 
841
- # DeleteApiDeploymentRevision deletes a revision of a deployment.
855
+ # Deletes a revision of a deployment.
842
856
  # @param [String] name
843
857
  # Required. The name of the deployment revision to be deleted, with a revision
844
- # ID explicitly included. Example: projects/sample/locations/global/apis/
845
- # petstore/deployments/prod@c7cfa2a8
858
+ # ID explicitly included. Example: `projects/sample/locations/global/apis/
859
+ # petstore/deployments/prod@c7cfa2a8`
846
860
  # @param [String] fields
847
861
  # Selector specifying which fields to include in a partial response.
848
862
  # @param [String] quota_user
@@ -870,10 +884,10 @@ module Google
870
884
  execute_or_queue_command(command, &block)
871
885
  end
872
886
 
873
- # GetApiDeployment returns a specified deployment.
887
+ # Returns a specified deployment.
874
888
  # @param [String] name
875
- # Required. The name of the deployment to retrieve. Format: projects/*/locations/
876
- # */apis/*/deployments/*
889
+ # Required. The name of the deployment to retrieve. Format: `projects/*/
890
+ # locations/*/apis/*/deployments/*`
877
891
  # @param [String] fields
878
892
  # Selector specifying which fields to include in a partial response.
879
893
  # @param [String] quota_user
@@ -946,13 +960,16 @@ module Google
946
960
  execute_or_queue_command(command, &block)
947
961
  end
948
962
 
949
- # ListApiDeployments returns matching deployments.
963
+ # Returns matching deployments.
950
964
  # @param [String] parent
951
- # Required. The parent, which owns this collection of deployments. Format:
952
- # projects/*/locations/*/apis/*
965
+ # Required. The parent, which owns this collection of deployments. Format: `
966
+ # projects/*/locations/*/apis/*`
953
967
  # @param [String] filter
954
968
  # An expression that can be used to filter the list. Filters use the Common
955
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"
956
973
  # @param [Fixnum] page_size
957
974
  # The maximum number of deployments to return. The service may return fewer than
958
975
  # this value. If unspecified, at most 50 values will be returned. The maximum is
@@ -979,12 +996,13 @@ module Google
979
996
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
980
997
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
981
998
  # @raise [Google::Apis::AuthorizationError] Authorization is required
982
- 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)
983
1000
  command = make_simple_command(:get, 'v1/{+parent}/deployments', options)
984
1001
  command.response_representation = Google::Apis::ApigeeregistryV1::ListApiDeploymentsResponse::Representation
985
1002
  command.response_class = Google::Apis::ApigeeregistryV1::ListApiDeploymentsResponse
986
1003
  command.params['parent'] = parent unless parent.nil?
987
1004
  command.query['filter'] = filter unless filter.nil?
1005
+ command.query['orderBy'] = order_by unless order_by.nil?
988
1006
  command.query['pageSize'] = page_size unless page_size.nil?
989
1007
  command.query['pageToken'] = page_token unless page_token.nil?
990
1008
  command.query['fields'] = fields unless fields.nil?
@@ -992,8 +1010,8 @@ module Google
992
1010
  execute_or_queue_command(command, &block)
993
1011
  end
994
1012
 
995
- # ListApiDeploymentRevisions lists all revisions of a deployment. Revisions are
996
- # 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.
997
1015
  # @param [String] name
998
1016
  # Required. The name of the deployment to list revisions for.
999
1017
  # @param [Fixnum] page_size
@@ -1030,7 +1048,7 @@ module Google
1030
1048
  execute_or_queue_command(command, &block)
1031
1049
  end
1032
1050
 
1033
- # UpdateApiDeployment can be used to modify a specified deployment.
1051
+ # Used to modify a specified deployment.
1034
1052
  # @param [String] name
1035
1053
  # Resource name.
1036
1054
  # @param [Google::Apis::ApigeeregistryV1::ApiDeployment] api_deployment_object
@@ -1039,9 +1057,9 @@ module Google
1039
1057
  # created. In this situation, `update_mask` is ignored.
1040
1058
  # @param [String] update_mask
1041
1059
  # The list of fields to be updated. If omitted, all fields are updated that are
1042
- # set in the request message (fields set to default values are ignored). If a "*"
1043
- # is specified, all fields are updated, including fields that are unspecified/
1044
- # 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.
1045
1063
  # @param [String] fields
1046
1064
  # Selector specifying which fields to include in a partial response.
1047
1065
  # @param [String] quota_user
@@ -1073,8 +1091,8 @@ module Google
1073
1091
  execute_or_queue_command(command, &block)
1074
1092
  end
1075
1093
 
1076
- # RollbackApiDeployment sets the current revision to a specified prior revision.
1077
- # 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.
1078
1096
  # @param [String] name
1079
1097
  # Required. The deployment being rolled back.
1080
1098
  # @param [Google::Apis::ApigeeregistryV1::RollbackApiDeploymentRequest] rollback_api_deployment_request_object
@@ -1144,7 +1162,7 @@ module Google
1144
1162
  execute_or_queue_command(command, &block)
1145
1163
  end
1146
1164
 
1147
- # TagApiDeploymentRevision adds a tag to a specified revision of a deployment.
1165
+ # Adds a tag to a specified revision of a deployment.
1148
1166
  # @param [String] name
1149
1167
  # Required. The name of the deployment to be tagged, including the revision ID.
1150
1168
  # @param [Google::Apis::ApigeeregistryV1::TagApiDeploymentRevisionRequest] tag_api_deployment_revision_request_object
@@ -1216,9 +1234,10 @@ module Google
1216
1234
  execute_or_queue_command(command, &block)
1217
1235
  end
1218
1236
 
1219
- # CreateArtifact creates a specified artifact.
1237
+ # Creates a specified artifact.
1220
1238
  # @param [String] parent
1221
- # Required. The parent, which owns this collection of artifacts. Format: `parent`
1239
+ # Required. The parent, which owns this collection of artifacts. Format: ``
1240
+ # parent``
1222
1241
  # @param [Google::Apis::ApigeeregistryV1::Artifact] artifact_object
1223
1242
  # @param [String] artifact_id
1224
1243
  # Required. The ID to use for the artifact, which will become the final
@@ -1255,9 +1274,9 @@ module Google
1255
1274
  execute_or_queue_command(command, &block)
1256
1275
  end
1257
1276
 
1258
- # DeleteArtifact removes a specified artifact.
1277
+ # Removes a specified artifact.
1259
1278
  # @param [String] name
1260
- # Required. The name of the artifact to delete. Format: `parent`/artifacts/*
1279
+ # Required. The name of the artifact to delete. Format: ``parent`/artifacts/*`
1261
1280
  # @param [String] fields
1262
1281
  # Selector specifying which fields to include in a partial response.
1263
1282
  # @param [String] quota_user
@@ -1285,9 +1304,9 @@ module Google
1285
1304
  execute_or_queue_command(command, &block)
1286
1305
  end
1287
1306
 
1288
- # GetArtifact returns a specified artifact.
1307
+ # Returns a specified artifact.
1289
1308
  # @param [String] name
1290
- # Required. The name of the artifact to retrieve. Format: `parent`/artifacts/*
1309
+ # Required. The name of the artifact to retrieve. Format: ``parent`/artifacts/*`
1291
1310
  # @param [String] fields
1292
1311
  # Selector specifying which fields to include in a partial response.
1293
1312
  # @param [String] quota_user
@@ -1315,13 +1334,12 @@ module Google
1315
1334
  execute_or_queue_command(command, &block)
1316
1335
  end
1317
1336
 
1318
- # GetArtifactContents returns the contents of a specified artifact. If artifacts
1319
- # are stored with GZip compression, the default behavior is to return the
1320
- # artifact uncompressed (the mime_type response field indicates the exact format
1321
- # 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).
1322
1340
  # @param [String] name
1323
1341
  # Required. The name of the artifact whose contents should be retrieved. Format:
1324
- # `parent`/artifacts/*
1342
+ # ``parent`/artifacts/*`
1325
1343
  # @param [String] fields
1326
1344
  # Selector specifying which fields to include in a partial response.
1327
1345
  # @param [String] quota_user
@@ -1349,12 +1367,16 @@ module Google
1349
1367
  execute_or_queue_command(command, &block)
1350
1368
  end
1351
1369
 
1352
- # ListArtifacts returns matching artifacts.
1370
+ # Returns matching artifacts.
1353
1371
  # @param [String] parent
1354
- # Required. The parent, which owns this collection of artifacts. Format: `parent`
1372
+ # Required. The parent, which owns this collection of artifacts. Format: ``
1373
+ # parent``
1355
1374
  # @param [String] filter
1356
1375
  # An expression that can be used to filter the list. Filters use the Common
1357
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"
1358
1380
  # @param [Fixnum] page_size
1359
1381
  # The maximum number of artifacts to return. The service may return fewer than
1360
1382
  # this value. If unspecified, at most 50 values will be returned. The maximum is
@@ -1380,12 +1402,13 @@ module Google
1380
1402
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1381
1403
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1382
1404
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1383
- 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)
1384
1406
  command = make_simple_command(:get, 'v1/{+parent}/artifacts', options)
1385
1407
  command.response_representation = Google::Apis::ApigeeregistryV1::ListArtifactsResponse::Representation
1386
1408
  command.response_class = Google::Apis::ApigeeregistryV1::ListArtifactsResponse
1387
1409
  command.params['parent'] = parent unless parent.nil?
1388
1410
  command.query['filter'] = filter unless filter.nil?
1411
+ command.query['orderBy'] = order_by unless order_by.nil?
1389
1412
  command.query['pageSize'] = page_size unless page_size.nil?
1390
1413
  command.query['pageToken'] = page_token unless page_token.nil?
1391
1414
  command.query['fields'] = fields unless fields.nil?
@@ -1393,7 +1416,7 @@ module Google
1393
1416
  execute_or_queue_command(command, &block)
1394
1417
  end
1395
1418
 
1396
- # ReplaceArtifact can be used to replace a specified artifact.
1419
+ # Used to replace a specified artifact.
1397
1420
  # @param [String] name
1398
1421
  # Resource name.
1399
1422
  # @param [Google::Apis::ApigeeregistryV1::Artifact] artifact_object
@@ -1426,10 +1449,10 @@ module Google
1426
1449
  execute_or_queue_command(command, &block)
1427
1450
  end
1428
1451
 
1429
- # CreateApiVersion creates a specified version.
1452
+ # Creates a specified version.
1430
1453
  # @param [String] parent
1431
- # Required. The parent, which owns this collection of versions. Format: projects/
1432
- # */locations/*/apis/*
1454
+ # Required. The parent, which owns this collection of versions. Format: `
1455
+ # projects/*/locations/*/apis/*`
1433
1456
  # @param [Google::Apis::ApigeeregistryV1::ApiVersion] api_version_object
1434
1457
  # @param [String] api_version_id
1435
1458
  # Required. The ID to use for the version, which will become the final component
@@ -1466,11 +1489,13 @@ module Google
1466
1489
  execute_or_queue_command(command, &block)
1467
1490
  end
1468
1491
 
1469
- # DeleteApiVersion removes a specified version and all of the resources that it
1470
- # owns.
1492
+ # Removes a specified version and all of the resources that it owns.
1471
1493
  # @param [String] name
1472
- # Required. The name of the version to delete. Format: projects/*/locations/*/
1473
- # apis/*/versions/*
1494
+ # Required. The name of the version to delete. Format: `projects/*/locations/*/
1495
+ # apis/*/versions/*`
1496
+ # @param [Boolean] force
1497
+ # If set to true, any child resources will also be deleted. (Otherwise, the
1498
+ # request will only work if there are no child resources.)
1474
1499
  # @param [String] fields
1475
1500
  # Selector specifying which fields to include in a partial response.
1476
1501
  # @param [String] quota_user
@@ -1488,20 +1513,21 @@ module Google
1488
1513
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1489
1514
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1490
1515
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1491
- def delete_project_location_api_version(name, fields: nil, quota_user: nil, options: nil, &block)
1516
+ def delete_project_location_api_version(name, force: nil, fields: nil, quota_user: nil, options: nil, &block)
1492
1517
  command = make_simple_command(:delete, 'v1/{+name}', options)
1493
1518
  command.response_representation = Google::Apis::ApigeeregistryV1::Empty::Representation
1494
1519
  command.response_class = Google::Apis::ApigeeregistryV1::Empty
1495
1520
  command.params['name'] = name unless name.nil?
1521
+ command.query['force'] = force unless force.nil?
1496
1522
  command.query['fields'] = fields unless fields.nil?
1497
1523
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1498
1524
  execute_or_queue_command(command, &block)
1499
1525
  end
1500
1526
 
1501
- # GetApiVersion returns a specified version.
1527
+ # Returns a specified version.
1502
1528
  # @param [String] name
1503
- # Required. The name of the version to retrieve. Format: projects/*/locations/*/
1504
- # apis/*/versions/*
1529
+ # Required. The name of the version to retrieve. Format: `projects/*/locations/*/
1530
+ # apis/*/versions/*`
1505
1531
  # @param [String] fields
1506
1532
  # Selector specifying which fields to include in a partial response.
1507
1533
  # @param [String] quota_user
@@ -1574,13 +1600,16 @@ module Google
1574
1600
  execute_or_queue_command(command, &block)
1575
1601
  end
1576
1602
 
1577
- # ListApiVersions returns matching versions.
1603
+ # Returns matching versions.
1578
1604
  # @param [String] parent
1579
- # Required. The parent, which owns this collection of versions. Format: projects/
1580
- # */locations/*/apis/*
1605
+ # Required. The parent, which owns this collection of versions. Format: `
1606
+ # projects/*/locations/*/apis/*`
1581
1607
  # @param [String] filter
1582
1608
  # An expression that can be used to filter the list. Filters use the Common
1583
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"
1584
1613
  # @param [Fixnum] page_size
1585
1614
  # The maximum number of versions to return. The service may return fewer than
1586
1615
  # this value. If unspecified, at most 50 values will be returned. The maximum is
@@ -1606,12 +1635,13 @@ module Google
1606
1635
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1607
1636
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1608
1637
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1609
- 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)
1610
1639
  command = make_simple_command(:get, 'v1/{+parent}/versions', options)
1611
1640
  command.response_representation = Google::Apis::ApigeeregistryV1::ListApiVersionsResponse::Representation
1612
1641
  command.response_class = Google::Apis::ApigeeregistryV1::ListApiVersionsResponse
1613
1642
  command.params['parent'] = parent unless parent.nil?
1614
1643
  command.query['filter'] = filter unless filter.nil?
1644
+ command.query['orderBy'] = order_by unless order_by.nil?
1615
1645
  command.query['pageSize'] = page_size unless page_size.nil?
1616
1646
  command.query['pageToken'] = page_token unless page_token.nil?
1617
1647
  command.query['fields'] = fields unless fields.nil?
@@ -1619,7 +1649,7 @@ module Google
1619
1649
  execute_or_queue_command(command, &block)
1620
1650
  end
1621
1651
 
1622
- # UpdateApiVersion can be used to modify a specified version.
1652
+ # Used to modify a specified version.
1623
1653
  # @param [String] name
1624
1654
  # Resource name.
1625
1655
  # @param [Google::Apis::ApigeeregistryV1::ApiVersion] api_version_object
@@ -1628,9 +1658,9 @@ module Google
1628
1658
  # In this situation, `update_mask` is ignored.
1629
1659
  # @param [String] update_mask
1630
1660
  # The list of fields to be updated. If omitted, all fields are updated that are
1631
- # set in the request message (fields set to default values are ignored). If a "*"
1632
- # is specified, all fields are updated, including fields that are unspecified/
1633
- # 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.
1634
1664
  # @param [String] fields
1635
1665
  # Selector specifying which fields to include in a partial response.
1636
1666
  # @param [String] quota_user
@@ -1738,9 +1768,10 @@ module Google
1738
1768
  execute_or_queue_command(command, &block)
1739
1769
  end
1740
1770
 
1741
- # CreateArtifact creates a specified artifact.
1771
+ # Creates a specified artifact.
1742
1772
  # @param [String] parent
1743
- # Required. The parent, which owns this collection of artifacts. Format: `parent`
1773
+ # Required. The parent, which owns this collection of artifacts. Format: ``
1774
+ # parent``
1744
1775
  # @param [Google::Apis::ApigeeregistryV1::Artifact] artifact_object
1745
1776
  # @param [String] artifact_id
1746
1777
  # Required. The ID to use for the artifact, which will become the final
@@ -1777,9 +1808,9 @@ module Google
1777
1808
  execute_or_queue_command(command, &block)
1778
1809
  end
1779
1810
 
1780
- # DeleteArtifact removes a specified artifact.
1811
+ # Removes a specified artifact.
1781
1812
  # @param [String] name
1782
- # Required. The name of the artifact to delete. Format: `parent`/artifacts/*
1813
+ # Required. The name of the artifact to delete. Format: ``parent`/artifacts/*`
1783
1814
  # @param [String] fields
1784
1815
  # Selector specifying which fields to include in a partial response.
1785
1816
  # @param [String] quota_user
@@ -1807,9 +1838,9 @@ module Google
1807
1838
  execute_or_queue_command(command, &block)
1808
1839
  end
1809
1840
 
1810
- # GetArtifact returns a specified artifact.
1841
+ # Returns a specified artifact.
1811
1842
  # @param [String] name
1812
- # Required. The name of the artifact to retrieve. Format: `parent`/artifacts/*
1843
+ # Required. The name of the artifact to retrieve. Format: ``parent`/artifacts/*`
1813
1844
  # @param [String] fields
1814
1845
  # Selector specifying which fields to include in a partial response.
1815
1846
  # @param [String] quota_user
@@ -1837,13 +1868,12 @@ module Google
1837
1868
  execute_or_queue_command(command, &block)
1838
1869
  end
1839
1870
 
1840
- # GetArtifactContents returns the contents of a specified artifact. If artifacts
1841
- # are stored with GZip compression, the default behavior is to return the
1842
- # artifact uncompressed (the mime_type response field indicates the exact format
1843
- # 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).
1844
1874
  # @param [String] name
1845
1875
  # Required. The name of the artifact whose contents should be retrieved. Format:
1846
- # `parent`/artifacts/*
1876
+ # ``parent`/artifacts/*`
1847
1877
  # @param [String] fields
1848
1878
  # Selector specifying which fields to include in a partial response.
1849
1879
  # @param [String] quota_user
@@ -1916,12 +1946,16 @@ module Google
1916
1946
  execute_or_queue_command(command, &block)
1917
1947
  end
1918
1948
 
1919
- # ListArtifacts returns matching artifacts.
1949
+ # Returns matching artifacts.
1920
1950
  # @param [String] parent
1921
- # Required. The parent, which owns this collection of artifacts. Format: `parent`
1951
+ # Required. The parent, which owns this collection of artifacts. Format: ``
1952
+ # parent``
1922
1953
  # @param [String] filter
1923
1954
  # An expression that can be used to filter the list. Filters use the Common
1924
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"
1925
1959
  # @param [Fixnum] page_size
1926
1960
  # The maximum number of artifacts to return. The service may return fewer than
1927
1961
  # this value. If unspecified, at most 50 values will be returned. The maximum is
@@ -1947,12 +1981,13 @@ module Google
1947
1981
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1948
1982
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1949
1983
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1950
- 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)
1951
1985
  command = make_simple_command(:get, 'v1/{+parent}/artifacts', options)
1952
1986
  command.response_representation = Google::Apis::ApigeeregistryV1::ListArtifactsResponse::Representation
1953
1987
  command.response_class = Google::Apis::ApigeeregistryV1::ListArtifactsResponse
1954
1988
  command.params['parent'] = parent unless parent.nil?
1955
1989
  command.query['filter'] = filter unless filter.nil?
1990
+ command.query['orderBy'] = order_by unless order_by.nil?
1956
1991
  command.query['pageSize'] = page_size unless page_size.nil?
1957
1992
  command.query['pageToken'] = page_token unless page_token.nil?
1958
1993
  command.query['fields'] = fields unless fields.nil?
@@ -1960,7 +1995,7 @@ module Google
1960
1995
  execute_or_queue_command(command, &block)
1961
1996
  end
1962
1997
 
1963
- # ReplaceArtifact can be used to replace a specified artifact.
1998
+ # Used to replace a specified artifact.
1964
1999
  # @param [String] name
1965
2000
  # Resource name.
1966
2001
  # @param [Google::Apis::ApigeeregistryV1::Artifact] artifact_object
@@ -2069,10 +2104,10 @@ module Google
2069
2104
  execute_or_queue_command(command, &block)
2070
2105
  end
2071
2106
 
2072
- # CreateApiSpec creates a specified spec.
2107
+ # Creates a specified spec.
2073
2108
  # @param [String] parent
2074
- # Required. The parent, which owns this collection of specs. Format: projects/*/
2075
- # locations/*/apis/*/versions/*
2109
+ # Required. The parent, which owns this collection of specs. Format: `projects/*/
2110
+ # locations/*/apis/*/versions/*`
2076
2111
  # @param [Google::Apis::ApigeeregistryV1::ApiSpec] api_spec_object
2077
2112
  # @param [String] api_spec_id
2078
2113
  # Required. The ID to use for the spec, which will become the final component of
@@ -2108,11 +2143,11 @@ module Google
2108
2143
  execute_or_queue_command(command, &block)
2109
2144
  end
2110
2145
 
2111
- # DeleteApiSpec removes a specified spec, all revisions, and all child resources
2112
- # (e.g. artifacts).
2146
+ # Removes a specified spec, all revisions, and all child resources (e.g.,
2147
+ # artifacts).
2113
2148
  # @param [String] name
2114
- # Required. The name of the spec to delete. Format: projects/*/locations/*/apis/*
2115
- # /versions/*/specs/*
2149
+ # Required. The name of the spec to delete. Format: `projects/*/locations/*/apis/
2150
+ # */versions/*/specs/*`
2116
2151
  # @param [Boolean] force
2117
2152
  # If set to true, any child resources will also be deleted. (Otherwise, the
2118
2153
  # request will only work if there are no child resources.)
@@ -2144,11 +2179,11 @@ module Google
2144
2179
  execute_or_queue_command(command, &block)
2145
2180
  end
2146
2181
 
2147
- # DeleteApiSpecRevision deletes a revision of a spec.
2182
+ # Deletes a revision of a spec.
2148
2183
  # @param [String] name
2149
2184
  # Required. The name of the spec revision to be deleted, with a revision ID
2150
- # explicitly included. Example: projects/sample/locations/global/apis/petstore/
2151
- # 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`
2152
2187
  # @param [String] fields
2153
2188
  # Selector specifying which fields to include in a partial response.
2154
2189
  # @param [String] quota_user
@@ -2176,10 +2211,10 @@ module Google
2176
2211
  execute_or_queue_command(command, &block)
2177
2212
  end
2178
2213
 
2179
- # GetApiSpec returns a specified spec.
2214
+ # Returns a specified spec.
2180
2215
  # @param [String] name
2181
- # Required. The name of the spec to retrieve. Format: projects/*/locations/*/
2182
- # apis/*/versions/*/specs/*
2216
+ # Required. The name of the spec to retrieve. Format: `projects/*/locations/*/
2217
+ # apis/*/versions/*/specs/*`
2183
2218
  # @param [String] fields
2184
2219
  # Selector specifying which fields to include in a partial response.
2185
2220
  # @param [String] quota_user
@@ -2207,13 +2242,12 @@ module Google
2207
2242
  execute_or_queue_command(command, &block)
2208
2243
  end
2209
2244
 
2210
- # GetApiSpecContents returns the contents of a specified spec. If specs are
2211
- # stored with GZip compression, the default behavior is to return the spec
2212
- # uncompressed (the mime_type response field indicates the exact format returned)
2213
- # .
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).
2214
2248
  # @param [String] name
2215
- # Required. The name of the spec whose contents should be retrieved. Format:
2216
- # projects/*/locations/*/apis/*/versions/*/specs/*
2249
+ # Required. The name of the spec whose contents should be retrieved. Format: `
2250
+ # projects/*/locations/*/apis/*/versions/*/specs/*`
2217
2251
  # @param [String] fields
2218
2252
  # Selector specifying which fields to include in a partial response.
2219
2253
  # @param [String] quota_user
@@ -2286,13 +2320,16 @@ module Google
2286
2320
  execute_or_queue_command(command, &block)
2287
2321
  end
2288
2322
 
2289
- # ListApiSpecs returns matching specs.
2323
+ # Returns matching specs.
2290
2324
  # @param [String] parent
2291
- # Required. The parent, which owns this collection of specs. Format: projects/*/
2292
- # locations/*/apis/*/versions/*
2325
+ # Required. The parent, which owns this collection of specs. Format: `projects/*/
2326
+ # locations/*/apis/*/versions/*`
2293
2327
  # @param [String] filter
2294
2328
  # An expression that can be used to filter the list. Filters use the Common
2295
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"
2296
2333
  # @param [Fixnum] page_size
2297
2334
  # The maximum number of specs to return. The service may return fewer than this
2298
2335
  # value. If unspecified, at most 50 values will be returned. The maximum is 1000;
@@ -2318,12 +2355,13 @@ module Google
2318
2355
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2319
2356
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2320
2357
  # @raise [Google::Apis::AuthorizationError] Authorization is required
2321
- 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)
2322
2359
  command = make_simple_command(:get, 'v1/{+parent}/specs', options)
2323
2360
  command.response_representation = Google::Apis::ApigeeregistryV1::ListApiSpecsResponse::Representation
2324
2361
  command.response_class = Google::Apis::ApigeeregistryV1::ListApiSpecsResponse
2325
2362
  command.params['parent'] = parent unless parent.nil?
2326
2363
  command.query['filter'] = filter unless filter.nil?
2364
+ command.query['orderBy'] = order_by unless order_by.nil?
2327
2365
  command.query['pageSize'] = page_size unless page_size.nil?
2328
2366
  command.query['pageToken'] = page_token unless page_token.nil?
2329
2367
  command.query['fields'] = fields unless fields.nil?
@@ -2331,8 +2369,8 @@ module Google
2331
2369
  execute_or_queue_command(command, &block)
2332
2370
  end
2333
2371
 
2334
- # ListApiSpecRevisions lists all revisions of a spec. Revisions are returned in
2335
- # descending order of revision creation time.
2372
+ # Lists all revisions of a spec. Revisions are returned in descending order of
2373
+ # revision creation time.
2336
2374
  # @param [String] name
2337
2375
  # Required. The name of the spec to list revisions for.
2338
2376
  # @param [Fixnum] page_size
@@ -2369,7 +2407,7 @@ module Google
2369
2407
  execute_or_queue_command(command, &block)
2370
2408
  end
2371
2409
 
2372
- # UpdateApiSpec can be used to modify a specified spec.
2410
+ # Used to modify a specified spec.
2373
2411
  # @param [String] name
2374
2412
  # Resource name.
2375
2413
  # @param [Google::Apis::ApigeeregistryV1::ApiSpec] api_spec_object
@@ -2378,9 +2416,9 @@ module Google
2378
2416
  # situation, `update_mask` is ignored.
2379
2417
  # @param [String] update_mask
2380
2418
  # The list of fields to be updated. If omitted, all fields are updated that are
2381
- # set in the request message (fields set to default values are ignored). If a "*"
2382
- # is specified, all fields are updated, including fields that are unspecified/
2383
- # 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.
2384
2422
  # @param [String] fields
2385
2423
  # Selector specifying which fields to include in a partial response.
2386
2424
  # @param [String] quota_user
@@ -2412,8 +2450,8 @@ module Google
2412
2450
  execute_or_queue_command(command, &block)
2413
2451
  end
2414
2452
 
2415
- # RollbackApiSpec sets the current revision to a specified prior revision. Note
2416
- # 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.
2417
2455
  # @param [String] name
2418
2456
  # Required. The spec being rolled back.
2419
2457
  # @param [Google::Apis::ApigeeregistryV1::RollbackApiSpecRequest] rollback_api_spec_request_object
@@ -2483,7 +2521,7 @@ module Google
2483
2521
  execute_or_queue_command(command, &block)
2484
2522
  end
2485
2523
 
2486
- # TagApiSpecRevision adds a tag to a specified revision of a spec.
2524
+ # Adds a tag to a specified revision of a spec.
2487
2525
  # @param [String] name
2488
2526
  # Required. The name of the spec to be tagged, including the revision ID.
2489
2527
  # @param [Google::Apis::ApigeeregistryV1::TagApiSpecRevisionRequest] tag_api_spec_revision_request_object
@@ -2555,9 +2593,10 @@ module Google
2555
2593
  execute_or_queue_command(command, &block)
2556
2594
  end
2557
2595
 
2558
- # CreateArtifact creates a specified artifact.
2596
+ # Creates a specified artifact.
2559
2597
  # @param [String] parent
2560
- # Required. The parent, which owns this collection of artifacts. Format: `parent`
2598
+ # Required. The parent, which owns this collection of artifacts. Format: ``
2599
+ # parent``
2561
2600
  # @param [Google::Apis::ApigeeregistryV1::Artifact] artifact_object
2562
2601
  # @param [String] artifact_id
2563
2602
  # Required. The ID to use for the artifact, which will become the final
@@ -2594,9 +2633,9 @@ module Google
2594
2633
  execute_or_queue_command(command, &block)
2595
2634
  end
2596
2635
 
2597
- # DeleteArtifact removes a specified artifact.
2636
+ # Removes a specified artifact.
2598
2637
  # @param [String] name
2599
- # Required. The name of the artifact to delete. Format: `parent`/artifacts/*
2638
+ # Required. The name of the artifact to delete. Format: ``parent`/artifacts/*`
2600
2639
  # @param [String] fields
2601
2640
  # Selector specifying which fields to include in a partial response.
2602
2641
  # @param [String] quota_user
@@ -2624,9 +2663,9 @@ module Google
2624
2663
  execute_or_queue_command(command, &block)
2625
2664
  end
2626
2665
 
2627
- # GetArtifact returns a specified artifact.
2666
+ # Returns a specified artifact.
2628
2667
  # @param [String] name
2629
- # Required. The name of the artifact to retrieve. Format: `parent`/artifacts/*
2668
+ # Required. The name of the artifact to retrieve. Format: ``parent`/artifacts/*`
2630
2669
  # @param [String] fields
2631
2670
  # Selector specifying which fields to include in a partial response.
2632
2671
  # @param [String] quota_user
@@ -2654,13 +2693,12 @@ module Google
2654
2693
  execute_or_queue_command(command, &block)
2655
2694
  end
2656
2695
 
2657
- # GetArtifactContents returns the contents of a specified artifact. If artifacts
2658
- # are stored with GZip compression, the default behavior is to return the
2659
- # artifact uncompressed (the mime_type response field indicates the exact format
2660
- # 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).
2661
2699
  # @param [String] name
2662
2700
  # Required. The name of the artifact whose contents should be retrieved. Format:
2663
- # `parent`/artifacts/*
2701
+ # ``parent`/artifacts/*`
2664
2702
  # @param [String] fields
2665
2703
  # Selector specifying which fields to include in a partial response.
2666
2704
  # @param [String] quota_user
@@ -2733,12 +2771,16 @@ module Google
2733
2771
  execute_or_queue_command(command, &block)
2734
2772
  end
2735
2773
 
2736
- # ListArtifacts returns matching artifacts.
2774
+ # Returns matching artifacts.
2737
2775
  # @param [String] parent
2738
- # Required. The parent, which owns this collection of artifacts. Format: `parent`
2776
+ # Required. The parent, which owns this collection of artifacts. Format: ``
2777
+ # parent``
2739
2778
  # @param [String] filter
2740
2779
  # An expression that can be used to filter the list. Filters use the Common
2741
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"
2742
2784
  # @param [Fixnum] page_size
2743
2785
  # The maximum number of artifacts to return. The service may return fewer than
2744
2786
  # this value. If unspecified, at most 50 values will be returned. The maximum is
@@ -2764,12 +2806,13 @@ module Google
2764
2806
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2765
2807
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2766
2808
  # @raise [Google::Apis::AuthorizationError] Authorization is required
2767
- 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)
2768
2810
  command = make_simple_command(:get, 'v1/{+parent}/artifacts', options)
2769
2811
  command.response_representation = Google::Apis::ApigeeregistryV1::ListArtifactsResponse::Representation
2770
2812
  command.response_class = Google::Apis::ApigeeregistryV1::ListArtifactsResponse
2771
2813
  command.params['parent'] = parent unless parent.nil?
2772
2814
  command.query['filter'] = filter unless filter.nil?
2815
+ command.query['orderBy'] = order_by unless order_by.nil?
2773
2816
  command.query['pageSize'] = page_size unless page_size.nil?
2774
2817
  command.query['pageToken'] = page_token unless page_token.nil?
2775
2818
  command.query['fields'] = fields unless fields.nil?
@@ -2777,7 +2820,7 @@ module Google
2777
2820
  execute_or_queue_command(command, &block)
2778
2821
  end
2779
2822
 
2780
- # ReplaceArtifact can be used to replace a specified artifact.
2823
+ # Used to replace a specified artifact.
2781
2824
  # @param [String] name
2782
2825
  # Resource name.
2783
2826
  # @param [Google::Apis::ApigeeregistryV1::Artifact] artifact_object
@@ -2886,9 +2929,10 @@ module Google
2886
2929
  execute_or_queue_command(command, &block)
2887
2930
  end
2888
2931
 
2889
- # CreateArtifact creates a specified artifact.
2932
+ # Creates a specified artifact.
2890
2933
  # @param [String] parent
2891
- # Required. The parent, which owns this collection of artifacts. Format: `parent`
2934
+ # Required. The parent, which owns this collection of artifacts. Format: ``
2935
+ # parent``
2892
2936
  # @param [Google::Apis::ApigeeregistryV1::Artifact] artifact_object
2893
2937
  # @param [String] artifact_id
2894
2938
  # Required. The ID to use for the artifact, which will become the final
@@ -2925,9 +2969,9 @@ module Google
2925
2969
  execute_or_queue_command(command, &block)
2926
2970
  end
2927
2971
 
2928
- # DeleteArtifact removes a specified artifact.
2972
+ # Removes a specified artifact.
2929
2973
  # @param [String] name
2930
- # Required. The name of the artifact to delete. Format: `parent`/artifacts/*
2974
+ # Required. The name of the artifact to delete. Format: ``parent`/artifacts/*`
2931
2975
  # @param [String] fields
2932
2976
  # Selector specifying which fields to include in a partial response.
2933
2977
  # @param [String] quota_user
@@ -2955,9 +2999,9 @@ module Google
2955
2999
  execute_or_queue_command(command, &block)
2956
3000
  end
2957
3001
 
2958
- # GetArtifact returns a specified artifact.
3002
+ # Returns a specified artifact.
2959
3003
  # @param [String] name
2960
- # Required. The name of the artifact to retrieve. Format: `parent`/artifacts/*
3004
+ # Required. The name of the artifact to retrieve. Format: ``parent`/artifacts/*`
2961
3005
  # @param [String] fields
2962
3006
  # Selector specifying which fields to include in a partial response.
2963
3007
  # @param [String] quota_user
@@ -2985,13 +3029,12 @@ module Google
2985
3029
  execute_or_queue_command(command, &block)
2986
3030
  end
2987
3031
 
2988
- # GetArtifactContents returns the contents of a specified artifact. If artifacts
2989
- # are stored with GZip compression, the default behavior is to return the
2990
- # artifact uncompressed (the mime_type response field indicates the exact format
2991
- # 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).
2992
3035
  # @param [String] name
2993
3036
  # Required. The name of the artifact whose contents should be retrieved. Format:
2994
- # `parent`/artifacts/*
3037
+ # ``parent`/artifacts/*`
2995
3038
  # @param [String] fields
2996
3039
  # Selector specifying which fields to include in a partial response.
2997
3040
  # @param [String] quota_user
@@ -3064,12 +3107,16 @@ module Google
3064
3107
  execute_or_queue_command(command, &block)
3065
3108
  end
3066
3109
 
3067
- # ListArtifacts returns matching artifacts.
3110
+ # Returns matching artifacts.
3068
3111
  # @param [String] parent
3069
- # Required. The parent, which owns this collection of artifacts. Format: `parent`
3112
+ # Required. The parent, which owns this collection of artifacts. Format: ``
3113
+ # parent``
3070
3114
  # @param [String] filter
3071
3115
  # An expression that can be used to filter the list. Filters use the Common
3072
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"
3073
3120
  # @param [Fixnum] page_size
3074
3121
  # The maximum number of artifacts to return. The service may return fewer than
3075
3122
  # this value. If unspecified, at most 50 values will be returned. The maximum is
@@ -3095,12 +3142,13 @@ module Google
3095
3142
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3096
3143
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3097
3144
  # @raise [Google::Apis::AuthorizationError] Authorization is required
3098
- 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)
3099
3146
  command = make_simple_command(:get, 'v1/{+parent}/artifacts', options)
3100
3147
  command.response_representation = Google::Apis::ApigeeregistryV1::ListArtifactsResponse::Representation
3101
3148
  command.response_class = Google::Apis::ApigeeregistryV1::ListArtifactsResponse
3102
3149
  command.params['parent'] = parent unless parent.nil?
3103
3150
  command.query['filter'] = filter unless filter.nil?
3151
+ command.query['orderBy'] = order_by unless order_by.nil?
3104
3152
  command.query['pageSize'] = page_size unless page_size.nil?
3105
3153
  command.query['pageToken'] = page_token unless page_token.nil?
3106
3154
  command.query['fields'] = fields unless fields.nil?
@@ -3108,7 +3156,7 @@ module Google
3108
3156
  execute_or_queue_command(command, &block)
3109
3157
  end
3110
3158
 
3111
- # ReplaceArtifact can be used to replace a specified artifact.
3159
+ # Used to replace a specified artifact.
3112
3160
  # @param [String] name
3113
3161
  # Resource name.
3114
3162
  # @param [Google::Apis::ApigeeregistryV1::Artifact] artifact_object