Skip to content

Commit 32d7900

Browse files
yoshi-automationsofisl
authored andcommitted
feat(file)!: update the API
BREAKING CHANGE: This release has breaking changes. #### file:v1beta1 The following keys were deleted: - schemas.FixedIOPS.properties.maxReadIops.description - schemas.FixedIOPS.properties.maxReadIops.format - schemas.FixedIOPS.properties.maxReadIops.type - schemas.IOPSPerTB.properties.maxReadIopsPerTb.description - schemas.IOPSPerTB.properties.maxReadIopsPerTb.format - schemas.IOPSPerTB.properties.maxReadIopsPerTb.type - schemas.Instance.properties.configurablePerformanceEnabled.description - schemas.Instance.properties.configurablePerformanceEnabled.readOnly - schemas.Instance.properties.configurablePerformanceEnabled.type The following keys were added: - resources.projects.resources.locations.resources.instances.resources.snapshots.methods.list.parameters.returnPartialSuccess.description - resources.projects.resources.locations.resources.instances.resources.snapshots.methods.list.parameters.returnPartialSuccess.location - resources.projects.resources.locations.resources.instances.resources.snapshots.methods.list.parameters.returnPartialSuccess.type - schemas.FixedIOPS.properties.maxIops.description - schemas.FixedIOPS.properties.maxIops.format - schemas.FixedIOPS.properties.maxIops.type - schemas.IOPSPerTB.properties.maxIopsPerTb.description - schemas.IOPSPerTB.properties.maxIopsPerTb.format - schemas.IOPSPerTB.properties.maxIopsPerTb.type - schemas.Instance.properties.customPerformanceSupported.description - schemas.Instance.properties.customPerformanceSupported.readOnly - schemas.Instance.properties.customPerformanceSupported.type - schemas.ListSnapshotsResponse.properties.unreachable.description - schemas.ListSnapshotsResponse.properties.unreachable.items.type - schemas.ListSnapshotsResponse.properties.unreachable.type - schemas.PerformanceLimits.properties.maxIops.description - schemas.PerformanceLimits.properties.maxIops.format - schemas.PerformanceLimits.properties.maxIops.readOnly - schemas.PerformanceLimits.properties.maxIops.type The following keys were changed: - resources.projects.resources.locations.resources.operations.methods.cancel.description - schemas.Backup.properties.tags.description - schemas.Instance.properties.tags.description - schemas.ListBackupsResponse.properties.unreachable.description - schemas.ListInstancesResponse.properties.unreachable.description - schemas.ListSharesResponse.properties.unreachable.description - schemas.OperationMetadata.properties.cancelRequested.description - schemas.Snapshot.properties.tags.description - schemas.TimeOfDay.properties.hours.description - schemas.TimeOfDay.properties.minutes.description - schemas.TimeOfDay.properties.nanos.description - schemas.TimeOfDay.properties.seconds.description #### file:v1 The following keys were deleted: - schemas.FixedIOPS.properties.maxReadIops.description - schemas.FixedIOPS.properties.maxReadIops.format - schemas.FixedIOPS.properties.maxReadIops.type - schemas.IOPSPerTB.properties.maxReadIopsPerTb.description - schemas.IOPSPerTB.properties.maxReadIopsPerTb.format - schemas.IOPSPerTB.properties.maxReadIopsPerTb.type - schemas.Instance.properties.configurablePerformanceEnabled.description - schemas.Instance.properties.configurablePerformanceEnabled.readOnly - schemas.Instance.properties.configurablePerformanceEnabled.type The following keys were added: - resources.projects.resources.locations.resources.instances.resources.snapshots.methods.list.parameters.returnPartialSuccess.description - resources.projects.resources.locations.resources.instances.resources.snapshots.methods.list.parameters.returnPartialSuccess.location - resources.projects.resources.locations.resources.instances.resources.snapshots.methods.list.parameters.returnPartialSuccess.type - schemas.FixedIOPS.properties.maxIops.description - schemas.FixedIOPS.properties.maxIops.format - schemas.FixedIOPS.properties.maxIops.type - schemas.IOPSPerTB.properties.maxIopsPerTb.description - schemas.IOPSPerTB.properties.maxIopsPerTb.format - schemas.IOPSPerTB.properties.maxIopsPerTb.type - schemas.Instance.properties.customPerformanceSupported.description - schemas.Instance.properties.customPerformanceSupported.readOnly - schemas.Instance.properties.customPerformanceSupported.type - schemas.ListSnapshotsResponse.properties.unreachable.description - schemas.ListSnapshotsResponse.properties.unreachable.items.type - schemas.ListSnapshotsResponse.properties.unreachable.type - schemas.PerformanceLimits.properties.maxIops.description - schemas.PerformanceLimits.properties.maxIops.format - schemas.PerformanceLimits.properties.maxIops.readOnly - schemas.PerformanceLimits.properties.maxIops.type The following keys were changed: - resources.projects.resources.locations.resources.operations.methods.cancel.description - schemas.Backup.properties.tags.description - schemas.Instance.properties.tags.description - schemas.ListBackupsResponse.properties.unreachable.description - schemas.ListInstancesResponse.properties.unreachable.description - schemas.OperationMetadata.properties.cancelRequested.description - schemas.Snapshot.properties.tags.description - schemas.TimeOfDay.properties.hours.description - schemas.TimeOfDay.properties.minutes.description - schemas.TimeOfDay.properties.nanos.description - schemas.TimeOfDay.properties.seconds.description
1 parent 2e42883 commit 32d7900

File tree

4 files changed

+142
-82
lines changed

4 files changed

+142
-82
lines changed

‎discovery/file-v1.json

Lines changed: 39 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -726,6 +726,11 @@
726726
"pattern": "^projects/[^/]+/locations/[^/]+/instances/[^/]+$",
727727
"required": true,
728728
"type": "string"
729+
},
730+
"returnPartialSuccess": {
731+
"description": "Optional. If true, allow partial responses for multi-regional Aggregated List requests.",
732+
"location": "query",
733+
"type": "boolean"
729734
}
730735
},
731736
"path": "v1/{+parent}/snapshots",
@@ -777,7 +782,7 @@
777782
"operations": {
778783
"methods": {
779784
"cancel": {
780-
"description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.",
785+
"description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.",
781786
"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}:cancel",
782787
"httpMethod": "POST",
783788
"id": "file.projects.locations.operations.cancel",
@@ -902,7 +907,7 @@
902907
}
903908
}
904909
},
905-
"revision": "20240905",
910+
"revision": "20250106",
906911
"rootUrl": "https://file.googleapis.com/",
907912
"schemas": {
908913
"Backup": {
@@ -1038,7 +1043,7 @@
10381043
"additionalProperties": {
10391044
"type": "string"
10401045
},
1041-
"description": "Optional. Input only. Immutable. Tag key-value pairs are bound to this resource. For example: \"123/environment\": \"production\", \"123/costCenter\": \"marketing\"",
1046+
"description": "Optional. Input only. Immutable. Tag key-value pairs bound to this resource. Each key must be a namespaced name and each value a short name. Example: \"123456789012/environment\" : \"production\", \"123456789013/costCenter\" : \"marketing\" See the documentation for more information: - Namespaced name: https://cloud.google.com/resource-manager/docs/tags/tags-creating-and-managing#retrieving_tag_key - Short name: https://cloud.google.com/resource-manager/docs/tags/tags-creating-and-managing#retrieving_tag_value",
10421047
"type": "object"
10431048
}
10441049
},
@@ -1144,8 +1149,8 @@
11441149
"description": "Fixed IOPS (input/output operations per second) parameters.",
11451150
"id": "FixedIOPS",
11461151
"properties": {
1147-
"maxReadIops": {
1148-
"description": "Required. Maximum raw read IOPS.",
1152+
"maxIops": {
1153+
"description": "Required. Maximum IOPS.",
11491154
"format": "int64",
11501155
"type": "string"
11511156
}
@@ -1431,8 +1436,8 @@
14311436
"description": "IOPS per TB. Filestore defines TB as 1024^4 bytes (TiB).",
14321437
"id": "IOPSPerTB",
14331438
"properties": {
1434-
"maxReadIopsPerTb": {
1435-
"description": "Required. Maximum read IOPS per TiB.",
1439+
"maxIopsPerTb": {
1440+
"description": "Required. Maximum IOPS per TiB.",
14361441
"format": "int64",
14371442
"type": "string"
14381443
}
@@ -1443,17 +1448,17 @@
14431448
"description": "A Filestore instance.",
14441449
"id": "Instance",
14451450
"properties": {
1446-
"configurablePerformanceEnabled": {
1447-
"description": "Output only. Indicates whether this instance's performance is configurable. If enabled, adjust it using the 'performance_config' field.",
1448-
"readOnly": true,
1449-
"type": "boolean"
1450-
},
14511451
"createTime": {
14521452
"description": "Output only. The time when the instance was created.",
14531453
"format": "google-datetime",
14541454
"readOnly": true,
14551455
"type": "string"
14561456
},
1457+
"customPerformanceSupported": {
1458+
"description": "Output only. Indicates whether this instance supports configuring its performance. If true, the user can configure the instance's performance by using the 'performance_config' field.",
1459+
"readOnly": true,
1460+
"type": "boolean"
1461+
},
14571462
"deletionProtectionEnabled": {
14581463
"description": "Optional. Indicates whether the instance is protected against deletion.",
14591464
"type": "boolean"
@@ -1595,7 +1600,7 @@
15951600
"additionalProperties": {
15961601
"type": "string"
15971602
},
1598-
"description": "Optional. Input only. Immutable. Tag key-value pairs are bound to this resource. For example: \"123/environment\": \"production\", \"123/costCenter\": \"marketing\"",
1603+
"description": "Optional. Input only. Immutable. Tag key-value pairs bound to this resource. Each key must be a namespaced name and each value a short name. Example: \"123456789012/environment\" : \"production\", \"123456789013/costCenter\" : \"marketing\" See the documentation for more information: - Namespaced name: https://cloud.google.com/resource-manager/docs/tags/tags-creating-and-managing#retrieving_tag_key - Short name: https://cloud.google.com/resource-manager/docs/tags/tags-creating-and-managing#retrieving_tag_value",
15991604
"type": "object"
16001605
},
16011606
"tier": {
@@ -1643,7 +1648,7 @@
16431648
"type": "string"
16441649
},
16451650
"unreachable": {
1646-
"description": "Locations that could not be reached.",
1651+
"description": "Unordered list. Locations that could not be reached.",
16471652
"items": {
16481653
"type": "string"
16491654
},
@@ -1668,7 +1673,7 @@
16681673
"type": "string"
16691674
},
16701675
"unreachable": {
1671-
"description": "Locations that could not be reached.",
1676+
"description": "Unordered list. Locations that could not be reached.",
16721677
"items": {
16731678
"type": "string"
16741679
},
@@ -1727,6 +1732,13 @@
17271732
"$ref": "Snapshot"
17281733
},
17291734
"type": "array"
1735+
},
1736+
"unreachable": {
1737+
"description": "Unordered list. Locations that could not be reached.",
1738+
"items": {
1739+
"type": "string"
1740+
},
1741+
"type": "array"
17301742
}
17311743
},
17321744
"type": "object"
@@ -1979,7 +1991,7 @@
19791991
"type": "string"
19801992
},
19811993
"cancelRequested": {
1982-
"description": "Output only. Identifies whether the user has requested cancellation of the operation. Operations that have been cancelled successfully have Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.",
1994+
"description": "Output only. Identifies whether the user has requested cancellation of the operation. Operations that have been cancelled successfully have google.longrunning.Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.",
19831995
"readOnly": true,
19841996
"type": "boolean"
19851997
},
@@ -2032,6 +2044,12 @@
20322044
"description": "The enforced performance limits, calculated from the instance's performance configuration.",
20332045
"id": "PerformanceLimits",
20342046
"properties": {
2047+
"maxIops": {
2048+
"description": "Output only. The max IOPS.",
2049+
"format": "int64",
2050+
"readOnly": true,
2051+
"type": "string"
2052+
},
20352053
"maxReadIops": {
20362054
"description": "Output only. The max read IOPS.",
20372055
"format": "int64",
@@ -2264,7 +2282,7 @@
22642282
"additionalProperties": {
22652283
"type": "string"
22662284
},
2267-
"description": "Optional. Input only. Immutable. Tag key-value pairs are bound to this resource. For example: \"123/environment\": \"production\", \"123/costCenter\": \"marketing\"",
2285+
"description": "Optional. Input only. Immutable. Tag key-value pairs bound to this resource. Each key must be a namespaced name and each value a short name. Example: \"123456789012/environment\" : \"production\", \"123456789013/costCenter\" : \"marketing\" See the documentation for more information: - Namespaced name: https://cloud.google.com/resource-manager/docs/tags/tags-creating-and-managing#retrieving_tag_key - Short name: https://cloud.google.com/resource-manager/docs/tags/tags-creating-and-managing#retrieving_tag_value",
22682286
"type": "object"
22692287
}
22702288
},
@@ -2302,22 +2320,22 @@
23022320
"id": "TimeOfDay",
23032321
"properties": {
23042322
"hours": {
2305-
"description": "Hours of day in 24 hour format. Should be from 0 to 23. An API may choose to allow the value \"24:00:00\" for scenarios like business closing time.",
2323+
"description": "Hours of a day in 24 hour format. Must be greater than or equal to 0 and typically must be less than or equal to 23. An API may choose to allow the value \"24:00:00\" for scenarios like business closing time.",
23062324
"format": "int32",
23072325
"type": "integer"
23082326
},
23092327
"minutes": {
2310-
"description": "Minutes of hour of day. Must be from 0 to 59.",
2328+
"description": "Minutes of an hour. Must be greater than or equal to 0 and less than or equal to 59.",
23112329
"format": "int32",
23122330
"type": "integer"
23132331
},
23142332
"nanos": {
2315-
"description": "Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.",
2333+
"description": "Fractions of seconds, in nanoseconds. Must be greater than or equal to 0 and less than or equal to 999,999,999.",
23162334
"format": "int32",
23172335
"type": "integer"
23182336
},
23192337
"seconds": {
2320-
"description": "Seconds of minutes of the time. Must normally be from 0 to 59. An API may allow the value 60 if it allows leap-seconds.",
2338+
"description": "Seconds of a minute. Must be greater than or equal to 0 and typically must be less than or equal to 59. An API may allow the value 60 if it allows leap-seconds.",
23212339
"format": "int32",
23222340
"type": "integer"
23232341
}

0 commit comments

Comments
 (0)