google-apis-apigeeregistry_v1 0.4.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,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