From 32d790028ea56a10c8e158a3717e481cd5241b7c Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 28 Jan 2025 01:35:40 +0000 Subject: [PATCH] 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 --- discovery/file-v1.json | 60 ++++++++++++++++++++++------------- discovery/file-v1beta1.json | 62 ++++++++++++++++++++++++------------- src/apis/file/v1.ts | 50 ++++++++++++++++++------------ src/apis/file/v1beta1.ts | 52 +++++++++++++++++++------------ 4 files changed, 142 insertions(+), 82 deletions(-) diff --git a/discovery/file-v1.json b/discovery/file-v1.json index 576e7ee5b2..6c677a80c3 100644 --- a/discovery/file-v1.json +++ b/discovery/file-v1.json @@ -726,6 +726,11 @@ "pattern": "^projects/[^/]+/locations/[^/]+/instances/[^/]+$", "required": true, "type": "string" + }, + "returnPartialSuccess": { + "description": "Optional. If true, allow partial responses for multi-regional Aggregated List requests.", + "location": "query", + "type": "boolean" } }, "path": "v1/{+parent}/snapshots", @@ -777,7 +782,7 @@ "operations": { "methods": { "cancel": { - "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`.", + "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`.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}:cancel", "httpMethod": "POST", "id": "file.projects.locations.operations.cancel", @@ -902,7 +907,7 @@ } } }, - "revision": "20240905", + "revision": "20250106", "rootUrl": "https://file.googleapis.com/", "schemas": { "Backup": { @@ -1038,7 +1043,7 @@ "additionalProperties": { "type": "string" }, - "description": "Optional. Input only. Immutable. Tag key-value pairs are bound to this resource. For example: \"123/environment\": \"production\", \"123/costCenter\": \"marketing\"", + "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", "type": "object" } }, @@ -1144,8 +1149,8 @@ "description": "Fixed IOPS (input/output operations per second) parameters.", "id": "FixedIOPS", "properties": { - "maxReadIops": { - "description": "Required. Maximum raw read IOPS.", + "maxIops": { + "description": "Required. Maximum IOPS.", "format": "int64", "type": "string" } @@ -1431,8 +1436,8 @@ "description": "IOPS per TB. Filestore defines TB as 1024^4 bytes (TiB).", "id": "IOPSPerTB", "properties": { - "maxReadIopsPerTb": { - "description": "Required. Maximum read IOPS per TiB.", + "maxIopsPerTb": { + "description": "Required. Maximum IOPS per TiB.", "format": "int64", "type": "string" } @@ -1443,17 +1448,17 @@ "description": "A Filestore instance.", "id": "Instance", "properties": { - "configurablePerformanceEnabled": { - "description": "Output only. Indicates whether this instance's performance is configurable. If enabled, adjust it using the 'performance_config' field.", - "readOnly": true, - "type": "boolean" - }, "createTime": { "description": "Output only. The time when the instance was created.", "format": "google-datetime", "readOnly": true, "type": "string" }, + "customPerformanceSupported": { + "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.", + "readOnly": true, + "type": "boolean" + }, "deletionProtectionEnabled": { "description": "Optional. Indicates whether the instance is protected against deletion.", "type": "boolean" @@ -1595,7 +1600,7 @@ "additionalProperties": { "type": "string" }, - "description": "Optional. Input only. Immutable. Tag key-value pairs are bound to this resource. For example: \"123/environment\": \"production\", \"123/costCenter\": \"marketing\"", + "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", "type": "object" }, "tier": { @@ -1643,7 +1648,7 @@ "type": "string" }, "unreachable": { - "description": "Locations that could not be reached.", + "description": "Unordered list. Locations that could not be reached.", "items": { "type": "string" }, @@ -1668,7 +1673,7 @@ "type": "string" }, "unreachable": { - "description": "Locations that could not be reached.", + "description": "Unordered list. Locations that could not be reached.", "items": { "type": "string" }, @@ -1727,6 +1732,13 @@ "$ref": "Snapshot" }, "type": "array" + }, + "unreachable": { + "description": "Unordered list. Locations that could not be reached.", + "items": { + "type": "string" + }, + "type": "array" } }, "type": "object" @@ -1979,7 +1991,7 @@ "type": "string" }, "cancelRequested": { - "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`.", + "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`.", "readOnly": true, "type": "boolean" }, @@ -2032,6 +2044,12 @@ "description": "The enforced performance limits, calculated from the instance's performance configuration.", "id": "PerformanceLimits", "properties": { + "maxIops": { + "description": "Output only. The max IOPS.", + "format": "int64", + "readOnly": true, + "type": "string" + }, "maxReadIops": { "description": "Output only. The max read IOPS.", "format": "int64", @@ -2264,7 +2282,7 @@ "additionalProperties": { "type": "string" }, - "description": "Optional. Input only. Immutable. Tag key-value pairs are bound to this resource. For example: \"123/environment\": \"production\", \"123/costCenter\": \"marketing\"", + "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", "type": "object" } }, @@ -2302,22 +2320,22 @@ "id": "TimeOfDay", "properties": { "hours": { - "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.", + "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.", "format": "int32", "type": "integer" }, "minutes": { - "description": "Minutes of hour of day. Must be from 0 to 59.", + "description": "Minutes of an hour. Must be greater than or equal to 0 and less than or equal to 59.", "format": "int32", "type": "integer" }, "nanos": { - "description": "Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.", + "description": "Fractions of seconds, in nanoseconds. Must be greater than or equal to 0 and less than or equal to 999,999,999.", "format": "int32", "type": "integer" }, "seconds": { - "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.", + "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.", "format": "int32", "type": "integer" } diff --git a/discovery/file-v1beta1.json b/discovery/file-v1beta1.json index 22b3110e59..225fee228f 100644 --- a/discovery/file-v1beta1.json +++ b/discovery/file-v1beta1.json @@ -893,6 +893,11 @@ "pattern": "^projects/[^/]+/locations/[^/]+/instances/[^/]+$", "required": true, "type": "string" + }, + "returnPartialSuccess": { + "description": "Optional. If true, allow partial responses for multi-regional Aggregated List requests.", + "location": "query", + "type": "boolean" } }, "path": "v1beta1/{+parent}/snapshots", @@ -944,7 +949,7 @@ "operations": { "methods": { "cancel": { - "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`.", + "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`.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}:cancel", "httpMethod": "POST", "id": "file.projects.locations.operations.cancel", @@ -1069,7 +1074,7 @@ } } }, - "revision": "20240905", + "revision": "20250106", "rootUrl": "https://file.googleapis.com/", "schemas": { "Backup": { @@ -1205,7 +1210,7 @@ "additionalProperties": { "type": "string" }, - "description": "Optional. Input only. Immutable. Tag key-value pairs are bound to this resource. For example: \"123/environment\": \"production\", \"123/costCenter\": \"marketing\"", + "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", "type": "object" } }, @@ -1322,8 +1327,8 @@ "description": "Fixed IOPS (input/output operations per second) parameters.", "id": "FixedIOPS", "properties": { - "maxReadIops": { - "description": "Required. Maximum raw read IOPS.", + "maxIops": { + "description": "Required. Maximum IOPS.", "format": "int64", "type": "string" } @@ -1609,8 +1614,8 @@ "description": "IOPS per TB. Filestore defines TB as 1024^4 bytes (TiB).", "id": "IOPSPerTB", "properties": { - "maxReadIopsPerTb": { - "description": "Required. Maximum read IOPS per TiB.", + "maxIopsPerTb": { + "description": "Required. Maximum IOPS per TiB.", "format": "int64", "type": "string" } @@ -1632,17 +1637,17 @@ "readOnly": true, "type": "string" }, - "configurablePerformanceEnabled": { - "description": "Output only. Indicates whether this instance's performance is configurable. If enabled, adjust it using the 'performance_config' field.", - "readOnly": true, - "type": "boolean" - }, "createTime": { "description": "Output only. The time when the instance was created.", "format": "google-datetime", "readOnly": true, "type": "string" }, + "customPerformanceSupported": { + "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.", + "readOnly": true, + "type": "boolean" + }, "deletionProtectionEnabled": { "description": "Optional. Indicates whether the instance is protected against deletion.", "type": "boolean" @@ -1803,7 +1808,7 @@ "additionalProperties": { "type": "string" }, - "description": "Optional. Input only. Immutable. Tag key-value pairs are bound to this resource. For example: \"123/environment\": \"production\", \"123/costCenter\": \"marketing\"", + "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", "type": "object" }, "tier": { @@ -1851,7 +1856,7 @@ "type": "string" }, "unreachable": { - "description": "Locations that could not be reached.", + "description": "Unordered list. Locations that could not be reached.", "items": { "type": "string" }, @@ -1876,7 +1881,7 @@ "type": "string" }, "unreachable": { - "description": "Locations that could not be reached.", + "description": "Unordered list. Locations that could not be reached.", "items": { "type": "string" }, @@ -1937,7 +1942,7 @@ "type": "array" }, "unreachable": { - "description": "Locations that could not be reached.", + "description": "Unordered list. Locations that could not be reached.", "items": { "type": "string" }, @@ -1960,6 +1965,13 @@ "$ref": "Snapshot" }, "type": "array" + }, + "unreachable": { + "description": "Unordered list. Locations that could not be reached.", + "items": { + "type": "string" + }, + "type": "array" } }, "type": "object" @@ -2248,7 +2260,7 @@ "type": "string" }, "cancelRequested": { - "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`.", + "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`.", "readOnly": true, "type": "boolean" }, @@ -2301,6 +2313,12 @@ "description": "The enforced performance limits, calculated from the instance's performance configuration.", "id": "PerformanceLimits", "properties": { + "maxIops": { + "description": "Output only. The max IOPS.", + "format": "int64", + "readOnly": true, + "type": "string" + }, "maxReadIops": { "description": "Output only. The max read IOPS.", "format": "int64", @@ -2601,7 +2619,7 @@ "additionalProperties": { "type": "string" }, - "description": "Optional. Input only. Immutable. Tag key-value pairs are bound to this resource. For example: \"123/environment\": \"production\", \"123/costCenter\": \"marketing\"", + "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", "type": "object" } }, @@ -2639,22 +2657,22 @@ "id": "TimeOfDay", "properties": { "hours": { - "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.", + "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.", "format": "int32", "type": "integer" }, "minutes": { - "description": "Minutes of hour of day. Must be from 0 to 59.", + "description": "Minutes of an hour. Must be greater than or equal to 0 and less than or equal to 59.", "format": "int32", "type": "integer" }, "nanos": { - "description": "Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.", + "description": "Fractions of seconds, in nanoseconds. Must be greater than or equal to 0 and less than or equal to 999,999,999.", "format": "int32", "type": "integer" }, "seconds": { - "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.", + "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.", "format": "int32", "type": "integer" } diff --git a/src/apis/file/v1.ts b/src/apis/file/v1.ts index 03889cea3c..9b0b9ccbbd 100644 --- a/src/apis/file/v1.ts +++ b/src/apis/file/v1.ts @@ -189,7 +189,7 @@ export namespace file_v1 { */ storageBytes?: string | null; /** - * Optional. Input only. Immutable. Tag key-value pairs are bound to this resource. For example: "123/environment": "production", "123/costCenter": "marketing" + * 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 */ tags?: {[key: string]: string} | null; } @@ -274,9 +274,9 @@ export namespace file_v1 { */ export interface Schema$FixedIOPS { /** - * Required. Maximum raw read IOPS. + * Required. Maximum IOPS. */ - maxReadIops?: string | null; + maxIops?: string | null; } /** * Instance represents the interface for SLM services to actuate the state of control plane resources. Example Instance in JSON, where consumer-project-number=123456, producer-project-id=cloud-sql: ```json Instance: { "name": "projects/123456/locations/us-east1/instances/prod-instance", "create_time": { "seconds": 1526406431, \}, "labels": { "env": "prod", "foo": "bar" \}, "state": READY, "software_versions": { "software_update": "cloud-sql-09-28-2018", \}, "maintenance_policy_names": { "UpdatePolicy": "projects/123456/locations/us-east1/maintenancePolicies/prod-update-policy", \} "tenant_project_id": "cloud-sql-test-tenant", "producer_metadata": { "cloud-sql-tier": "basic", "cloud-sql-instance-size": "1G", \}, "provisioned_resources": [ { "resource-type": "compute-instance", "resource-url": "https://www.googleapis.com/compute/v1/projects/cloud-sql/zones/us-east1-b/instances/vm-1", \} ], "maintenance_schedules": { "csa_rollout": { "start_time": { "seconds": 1526406431, \}, "end_time": { "seconds": 1535406431, \}, \}, "ncsa_rollout": { "start_time": { "seconds": 1526406431, \}, "end_time": { "seconds": 1535406431, \}, \} \}, "consumer_defined_name": "my-sql-instance1", \} ``` LINT.IfChange @@ -487,14 +487,14 @@ export namespace file_v1 { * A Filestore instance. */ export interface Schema$Instance { - /** - * Output only. Indicates whether this instance's performance is configurable. If enabled, adjust it using the 'performance_config' field. - */ - configurablePerformanceEnabled?: boolean | null; /** * Output only. The time when the instance was created. */ createTime?: string | null; + /** + * 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. + */ + customPerformanceSupported?: boolean | null; /** * Optional. Indicates whether the instance is protected against deletion. */ @@ -568,7 +568,7 @@ export namespace file_v1 { */ suspensionReasons?: string[] | null; /** - * Optional. Input only. Immutable. Tag key-value pairs are bound to this resource. For example: "123/environment": "production", "123/costCenter": "marketing" + * 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 */ tags?: {[key: string]: string} | null; /** @@ -581,9 +581,9 @@ export namespace file_v1 { */ export interface Schema$IOPSPerTB { /** - * Required. Maximum read IOPS per TiB. + * Required. Maximum IOPS per TiB. */ - maxReadIopsPerTb?: string | null; + maxIopsPerTb?: string | null; } /** * ListBackupsResponse is the result of ListBackupsRequest. @@ -598,7 +598,7 @@ export namespace file_v1 { */ nextPageToken?: string | null; /** - * Locations that could not be reached. + * Unordered list. Locations that could not be reached. */ unreachable?: string[] | null; } @@ -615,7 +615,7 @@ export namespace file_v1 { */ nextPageToken?: string | null; /** - * Locations that could not be reached. + * Unordered list. Locations that could not be reached. */ unreachable?: string[] | null; } @@ -657,6 +657,10 @@ export namespace file_v1 { * A list of snapshots in the project for the specified instance. */ snapshots?: Schema$Snapshot[]; + /** + * Unordered list. Locations that could not be reached. + */ + unreachable?: string[] | null; } /** * A resource that represents a Google Cloud location. @@ -813,7 +817,7 @@ export namespace file_v1 { */ apiVersion?: string | null; /** - * 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`. + * 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`. */ cancelRequested?: boolean | null; /** @@ -854,6 +858,10 @@ export namespace file_v1 { * The enforced performance limits, calculated from the instance's performance configuration. */ export interface Schema$PerformanceLimits { + /** + * Output only. The max IOPS. + */ + maxIops?: string | null; /** * Output only. The max read IOPS. */ @@ -977,7 +985,7 @@ export namespace file_v1 { */ state?: string | null; /** - * Optional. Input only. Immutable. Tag key-value pairs are bound to this resource. For example: "123/environment": "production", "123/costCenter": "marketing" + * 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 */ tags?: {[key: string]: string} | null; } @@ -1003,19 +1011,19 @@ export namespace file_v1 { */ export interface Schema$TimeOfDay { /** - * 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. + * 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. */ hours?: number | null; /** - * Minutes of hour of day. Must be from 0 to 59. + * Minutes of an hour. Must be greater than or equal to 0 and less than or equal to 59. */ minutes?: number | null; /** - * Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999. + * Fractions of seconds, in nanoseconds. Must be greater than or equal to 0 and less than or equal to 999,999,999. */ nanos?: number | null; /** - * 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. + * 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. */ seconds?: number | null; } @@ -3109,6 +3117,10 @@ export namespace file_v1 { * Required. The instance for which to retrieve snapshot information, in the format `projects/{project_id\}/locations/{location\}/instances/{instance_id\}`. */ parent?: string; + /** + * Optional. If true, allow partial responses for multi-regional Aggregated List requests. + */ + returnPartialSuccess?: boolean; } export interface Params$Resource$Projects$Locations$Instances$Snapshots$Patch extends StandardParameters { @@ -3134,7 +3146,7 @@ export namespace file_v1 { } /** - * 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`. + * 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`. * * @param params - Parameters for request * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. diff --git a/src/apis/file/v1beta1.ts b/src/apis/file/v1beta1.ts index 368ecc20d7..d6b530b1a7 100644 --- a/src/apis/file/v1beta1.ts +++ b/src/apis/file/v1beta1.ts @@ -189,7 +189,7 @@ export namespace file_v1beta1 { */ storageBytes?: string | null; /** - * Optional. Input only. Immutable. Tag key-value pairs are bound to this resource. For example: "123/environment": "production", "123/costCenter": "marketing" + * 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 */ tags?: {[key: string]: string} | null; } @@ -283,9 +283,9 @@ export namespace file_v1beta1 { */ export interface Schema$FixedIOPS { /** - * Required. Maximum raw read IOPS. + * Required. Maximum IOPS. */ - maxReadIops?: string | null; + maxIops?: string | null; } /** * Instance represents the interface for SLM services to actuate the state of control plane resources. Example Instance in JSON, where consumer-project-number=123456, producer-project-id=cloud-sql: ```json Instance: { "name": "projects/123456/locations/us-east1/instances/prod-instance", "create_time": { "seconds": 1526406431, \}, "labels": { "env": "prod", "foo": "bar" \}, "state": READY, "software_versions": { "software_update": "cloud-sql-09-28-2018", \}, "maintenance_policy_names": { "UpdatePolicy": "projects/123456/locations/us-east1/maintenancePolicies/prod-update-policy", \} "tenant_project_id": "cloud-sql-test-tenant", "producer_metadata": { "cloud-sql-tier": "basic", "cloud-sql-instance-size": "1G", \}, "provisioned_resources": [ { "resource-type": "compute-instance", "resource-url": "https://www.googleapis.com/compute/v1/projects/cloud-sql/zones/us-east1-b/instances/vm-1", \} ], "maintenance_schedules": { "csa_rollout": { "start_time": { "seconds": 1526406431, \}, "end_time": { "seconds": 1535406431, \}, \}, "ncsa_rollout": { "start_time": { "seconds": 1526406431, \}, "end_time": { "seconds": 1535406431, \}, \} \}, "consumer_defined_name": "my-sql-instance1", \} ``` LINT.IfChange @@ -504,14 +504,14 @@ export namespace file_v1beta1 { * Output only. The increase/decrease capacity step size. */ capacityStepSizeGb?: string | null; - /** - * Output only. Indicates whether this instance's performance is configurable. If enabled, adjust it using the 'performance_config' field. - */ - configurablePerformanceEnabled?: boolean | null; /** * Output only. The time when the instance was created. */ createTime?: string | null; + /** + * 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. + */ + customPerformanceSupported?: boolean | null; /** * Optional. Indicates whether the instance is protected against deletion. */ @@ -601,7 +601,7 @@ export namespace file_v1beta1 { */ suspensionReasons?: string[] | null; /** - * Optional. Input only. Immutable. Tag key-value pairs are bound to this resource. For example: "123/environment": "production", "123/costCenter": "marketing" + * 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 */ tags?: {[key: string]: string} | null; /** @@ -614,9 +614,9 @@ export namespace file_v1beta1 { */ export interface Schema$IOPSPerTB { /** - * Required. Maximum read IOPS per TiB. + * Required. Maximum IOPS per TiB. */ - maxReadIopsPerTb?: string | null; + maxIopsPerTb?: string | null; } /** * ListBackupsResponse is the result of ListBackupsRequest. @@ -631,7 +631,7 @@ export namespace file_v1beta1 { */ nextPageToken?: string | null; /** - * Locations that could not be reached. + * Unordered list. Locations that could not be reached. */ unreachable?: string[] | null; } @@ -648,7 +648,7 @@ export namespace file_v1beta1 { */ nextPageToken?: string | null; /** - * Locations that could not be reached. + * Unordered list. Locations that could not be reached. */ unreachable?: string[] | null; } @@ -691,7 +691,7 @@ export namespace file_v1beta1 { */ shares?: Schema$Share[]; /** - * Locations that could not be reached. + * Unordered list. Locations that could not be reached. */ unreachable?: string[] | null; } @@ -707,6 +707,10 @@ export namespace file_v1beta1 { * A list of snapshots in the project for the specified instance. */ snapshots?: Schema$Snapshot[]; + /** + * Unordered list. Locations that could not be reached. + */ + unreachable?: string[] | null; } /** * A resource that represents a Google Cloud location. @@ -880,7 +884,7 @@ export namespace file_v1beta1 { */ apiVersion?: string | null; /** - * 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`. + * 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`. */ cancelRequested?: boolean | null; /** @@ -921,6 +925,10 @@ export namespace file_v1beta1 { * The enforced performance limits, calculated from the instance's performance configuration. */ export interface Schema$PerformanceLimits { + /** + * Output only. The max IOPS. + */ + maxIops?: string | null; /** * Output only. The max read IOPS. */ @@ -1089,7 +1097,7 @@ export namespace file_v1beta1 { */ state?: string | null; /** - * Optional. Input only. Immutable. Tag key-value pairs are bound to this resource. For example: "123/environment": "production", "123/costCenter": "marketing" + * 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 */ tags?: {[key: string]: string} | null; } @@ -1115,19 +1123,19 @@ export namespace file_v1beta1 { */ export interface Schema$TimeOfDay { /** - * 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. + * 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. */ hours?: number | null; /** - * Minutes of hour of day. Must be from 0 to 59. + * Minutes of an hour. Must be greater than or equal to 0 and less than or equal to 59. */ minutes?: number | null; /** - * Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999. + * Fractions of seconds, in nanoseconds. Must be greater than or equal to 0 and less than or equal to 999,999,999. */ nanos?: number | null; /** - * 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. + * 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. */ seconds?: number | null; } @@ -3742,6 +3750,10 @@ export namespace file_v1beta1 { * Required. The instance for which to retrieve snapshot information, in the format `projects/{project_id\}/locations/{location\}/instances/{instance_id\}`. */ parent?: string; + /** + * Optional. If true, allow partial responses for multi-regional Aggregated List requests. + */ + returnPartialSuccess?: boolean; } export interface Params$Resource$Projects$Locations$Instances$Snapshots$Patch extends StandardParameters { @@ -3767,7 +3779,7 @@ export namespace file_v1beta1 { } /** - * 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`. + * 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`. * * @param params - Parameters for request * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.