diff --git a/discovery/tpu-v1.json b/discovery/tpu-v1.json index 603dbc140d..e97703fbc6 100644 --- a/discovery/tpu-v1.json +++ b/discovery/tpu-v1.json @@ -462,7 +462,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": "tpu.projects.locations.operations.cancel", @@ -659,7 +659,7 @@ } } }, - "revision": "20230803", + "revision": "20241126", "rootUrl": "https://tpu.googleapis.com/", "schemas": { "AcceleratorType": { @@ -968,7 +968,8 @@ "TERMINATED", "HIDING", "HIDDEN", - "UNHIDING" + "UNHIDING", + "UNKNOWN" ], "enumDescriptions": [ "TPU node state is not known/set.", @@ -985,7 +986,8 @@ "TPU node has been terminated due to maintenance or has reached the end of its life cycle (for preemptible nodes).", "TPU node is currently hiding.", "TPU node has been hidden.", - "TPU node is currently unhiding." + "TPU node is currently unhiding.", + "TPU node has unknown state after a failed repair." ], "readOnly": true, "type": "string" diff --git a/discovery/tpu-v1alpha1.json b/discovery/tpu-v1alpha1.json index 681b0d24d2..4cdfd9862e 100644 --- a/discovery/tpu-v1alpha1.json +++ b/discovery/tpu-v1alpha1.json @@ -472,7 +472,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": "v1alpha1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}:cancel", "httpMethod": "POST", "id": "tpu.projects.locations.operations.cancel", @@ -669,7 +669,7 @@ } } }, - "revision": "20230803", + "revision": "20241126", "rootUrl": "https://tpu.googleapis.com/", "schemas": { "AcceleratorType": { @@ -978,7 +978,8 @@ "TERMINATED", "HIDING", "HIDDEN", - "UNHIDING" + "UNHIDING", + "UNKNOWN" ], "enumDescriptions": [ "TPU node state is not known/set.", @@ -995,7 +996,8 @@ "TPU node has been terminated due to maintenance or has reached the end of its life cycle (for preemptible nodes).", "TPU node is currently hiding.", "TPU node has been hidden.", - "TPU node is currently unhiding." + "TPU node is currently unhiding.", + "TPU node has unknown state after a failed repair." ], "readOnly": true, "type": "string" diff --git a/discovery/tpu-v2.json b/discovery/tpu-v2.json index b08e1371e8..ff4b8adef4 100644 --- a/discovery/tpu-v2.json +++ b/discovery/tpu-v2.json @@ -524,7 +524,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": "v2/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}:cancel", "httpMethod": "POST", "id": "tpu.projects.locations.operations.cancel", @@ -887,7 +887,7 @@ } } }, - "revision": "20240613", + "revision": "20250116", "rootUrl": "https://tpu.googleapis.com/", "schemas": { "AcceleratorConfig": { @@ -906,7 +906,8 @@ "V3", "V4", "V5LITE_POD", - "V5P" + "V5P", + "V6E" ], "enumDescriptions": [ "Unspecified version.", @@ -914,7 +915,8 @@ "TPU v3.", "TPU v4.", "TPU v5lite pod.", - "TPU v5p" + "TPU v5p.", + "TPU v6e." ], "type": "string" } @@ -1323,7 +1325,7 @@ "id": "MultisliceParams", "properties": { "nodeCount": { - "description": "Required. Number of nodes with this spec. The system will attempt to provison \"node_count\" nodes as part of the request. This needs to be > 1.", + "description": "Required. Number of nodes with this spec. The system will attempt to provision \"node_count\" nodes as part of the request. This needs to be > 1.", "format": "int32", "type": "integer" }, @@ -1489,7 +1491,14 @@ }, "networkConfig": { "$ref": "NetworkConfig", - "description": "Network configurations for the TPU node." + "description": "Network configurations for the TPU node. network_config and network_configs are mutually exclusive, you can only specify one of them. If both are specified, an error will be returned." + }, + "networkConfigs": { + "description": "Optional. Repeated network configurations for the TPU node. This field is used to specify multiple networks configs for the TPU node. network_config and network_configs are mutually exclusive, you can only specify one of them. If both are specified, an error will be returned.", + "items": { + "$ref": "NetworkConfig" + }, + "type": "array" }, "networkEndpoints": { "description": "Output only. The network endpoints where TPU workers can be accessed and sent work. It is recommended that runtime clients of the node reach out to the 0th entry in this map first.", @@ -1537,7 +1546,8 @@ "TERMINATED", "HIDING", "HIDDEN", - "UNHIDING" + "UNHIDING", + "UNKNOWN" ], "enumDescriptions": [ "TPU node state is not known/set.", @@ -1554,7 +1564,8 @@ "TPU node has been terminated due to maintenance or has reached the end of its life cycle (for preemptible nodes).", "TPU node is currently hiding.", "TPU node has been hidden.", - "TPU node is currently unhiding." + "TPU node is currently unhiding.", + "TPU node has unknown state after a failed repair." ], "readOnly": true, "type": "string" diff --git a/discovery/tpu-v2alpha1.json b/discovery/tpu-v2alpha1.json index 8615ae6957..ec793b0bcb 100644 --- a/discovery/tpu-v2alpha1.json +++ b/discovery/tpu-v2alpha1.json @@ -473,6 +473,34 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, + "performMaintenance": { + "description": "Perform manual maintenance on a node.", + "flatPath": "v2alpha1/projects/{projectsId}/locations/{locationsId}/nodes/{nodesId}:performMaintenance", + "httpMethod": "POST", + "id": "tpu.projects.locations.nodes.performMaintenance", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The resource name.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/nodes/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2alpha1/{+name}:performMaintenance", + "request": { + "$ref": "PerformMaintenanceRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "simulateMaintenanceEvent": { "description": "Simulates a maintenance event.", "flatPath": "v2alpha1/projects/{projectsId}/locations/{locationsId}/nodes/{nodesId}:simulateMaintenanceEvent", @@ -562,7 +590,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": "v2alpha1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}:cancel", "httpMethod": "POST", "id": "tpu.projects.locations.operations.cancel", @@ -815,6 +843,34 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, + "performMaintenanceQueuedResource": { + "description": "Perform manual maintenance on specific nodes of a QueuedResource.", + "flatPath": "v2alpha1/projects/{projectsId}/locations/{locationsId}/queuedResources/{queuedResourcesId}:performMaintenanceQueuedResource", + "httpMethod": "POST", + "id": "tpu.projects.locations.queuedResources.performMaintenanceQueuedResource", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The name of the QueuedResource which holds the nodes to perform maintenance on.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/queuedResources/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2alpha1/{+name}:performMaintenanceQueuedResource", + "request": { + "$ref": "PerformMaintenanceQueuedResourceRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "reset": { "description": "Resets a QueuedResource TPU instance", "flatPath": "v2alpha1/projects/{projectsId}/locations/{locationsId}/queuedResources/{queuedResourcesId}:reset", @@ -857,7 +913,7 @@ ], "parameters": { "pageSize": { - "description": "The maximum number of items to return.", + "description": "The maximum number of items to return. Defaults to 0 if not specified, which means no limit.", "format": "int32", "location": "query", "type": "integer" @@ -965,7 +1021,7 @@ } } }, - "revision": "20240916", + "revision": "20250116", "rootUrl": "https://tpu.googleapis.com/", "schemas": { "AcceleratorConfig": { @@ -984,7 +1040,8 @@ "V3", "V4", "V5LITE_POD", - "V5P" + "V5P", + "V6E" ], "enumDescriptions": [ "Unspecified version.", @@ -992,7 +1049,8 @@ "TPU v3.", "TPU v4.", "TPU v5lite pod.", - "TPU v5." + "TPU v5.", + "TPU v6e." ], "type": "string" } @@ -1461,6 +1519,20 @@ "nodeIdPrefix": { "description": "Prefix of node_ids in case of multi-node request Should follow the `^[A-Za-z0-9_.~+%-]+$` regex format. If node_count = 3 and node_id_prefix = \"np\", node ids of nodes created will be \"np-0\", \"np-1\", \"np-2\". If this field is not provided we use queued_resource_id as the node_id_prefix.", "type": "string" + }, + "workloadType": { + "description": "Optional. The workload type for the multi-node request.", + "enum": [ + "WORKLOAD_TYPE_UNSPECIFIED", + "THROUGHPUT_OPTIMIZED", + "AVAILABILITY_OPTIMIZED" + ], + "enumDescriptions": [ + "Not specified.", + "All of the nodes are available most of the time. Recommended for training workloads.", + "Most of the nodes are available all of the time. Recommended for serving workloads." + ], + "type": "string" } }, "type": "object" @@ -1626,10 +1698,10 @@ }, "networkConfig": { "$ref": "NetworkConfig", - "description": "Network configurations for the TPU node." + "description": "Network configurations for the TPU node. network_config and network_configs are mutually exclusive, you can only specify one of them. If both are specified, an error will be returned." }, "networkConfigs": { - "description": "Optional. Repeated network configurations for the TPU node.", + "description": "Optional. Repeated network configurations for the TPU node. This field is used to specify multiple networks configs for the TPU node. network_config and network_configs are mutually exclusive, you can only specify one of them. If both are specified, an error will be returned.", "items": { "$ref": "NetworkConfig" }, @@ -1681,7 +1753,8 @@ "TERMINATED", "HIDING", "HIDDEN", - "UNHIDING" + "UNHIDING", + "UNKNOWN" ], "enumDescriptions": [ "TPU node state is not known/set.", @@ -1698,7 +1771,8 @@ "TPU node has been terminated due to maintenance or has reached the end of its life cycle (for preemptible nodes).", "TPU node is currently hiding.", "TPU node has been hidden.", - "TPU node is currently unhiding." + "TPU node is currently unhiding.", + "TPU node has unknown state after a failed repair." ], "readOnly": true, "type": "string" @@ -1717,6 +1791,11 @@ "type": "string" }, "type": "array" + }, + "upcomingMaintenance": { + "$ref": "UpcomingMaintenance", + "description": "Output only. Upcoming maintenance on this TPU node.", + "readOnly": true } }, "type": "object" @@ -1816,6 +1895,26 @@ }, "type": "object" }, + "PerformMaintenanceQueuedResourceRequest": { + "description": "Request for PerformMaintenanceQueuedResource.", + "id": "PerformMaintenanceQueuedResourceRequest", + "properties": { + "nodeNames": { + "description": "The names of the nodes to perform maintenance on.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "PerformMaintenanceRequest": { + "description": "Request for PerformMaintenance.", + "id": "PerformMaintenanceRequest", + "properties": {}, + "type": "object" + }, "ProvisioningData": { "description": "Further data for the provisioning state.", "id": "ProvisioningData", @@ -1991,7 +2090,8 @@ "type": "string" }, "standard": { - "$ref": "Standard" + "$ref": "Standard", + "description": "A standard reservation." }, "state": { "description": "Output only. The state of the Reservation.", @@ -2120,9 +2220,11 @@ "type": "object" }, "Standard": { + "description": "Details of a standard reservation.", "id": "Standard", "properties": { "capacityUnits": { + "description": "Capacity units this reservation is measured in.", "enum": [ "CAPACITY_UNITS_UNSPECIFIED", "CORES", @@ -2149,7 +2251,8 @@ "type": "integer" }, "usage": { - "$ref": "Usage" + "$ref": "Usage", + "description": "The current usage of the reservation." } }, "type": "object" @@ -2261,7 +2364,59 @@ }, "type": "object" }, + "UpcomingMaintenance": { + "description": "Upcoming Maintenance notification information.", + "id": "UpcomingMaintenance", + "properties": { + "canReschedule": { + "description": "Indicates if the maintenance can be customer triggered.", + "type": "boolean" + }, + "latestWindowStartTime": { + "description": "The latest time for the planned maintenance window to start. This timestamp value is in RFC3339 text format.", + "type": "string" + }, + "maintenanceStatus": { + "description": "The status of the maintenance.", + "enum": [ + "UNKNOWN", + "PENDING", + "ONGOING" + ], + "enumDescriptions": [ + "Unknown maintenance status. Do not use this value.", + "There is pending maintenance.", + "There is ongoing maintenance on this VM." + ], + "type": "string" + }, + "type": { + "description": "Defines the type of maintenance.", + "enum": [ + "UNKNOWN_TYPE", + "SCHEDULED", + "UNSCHEDULED" + ], + "enumDescriptions": [ + "No type specified. Do not use this value.", + "Scheduled maintenance (e.g. maintenance after uptime guarantee is complete).", + "Unscheduled maintenance (e.g. emergency maintenance during uptime guarantee)." + ], + "type": "string" + }, + "windowEndTime": { + "description": "The time by which the maintenance disruption will be completed. This timestamp value is in RFC3339 text format.", + "type": "string" + }, + "windowStartTime": { + "description": "The current start time of the maintenance window. This timestamp value is in RFC3339 text format.", + "type": "string" + } + }, + "type": "object" + }, "Usage": { + "description": "Usage details of a reservation.", "id": "Usage", "properties": { "total": { diff --git a/src/apis/tpu/v1.ts b/src/apis/tpu/v1.ts index 0563a85717..590d11f114 100644 --- a/src/apis/tpu/v1.ts +++ b/src/apis/tpu/v1.ts @@ -1634,7 +1634,7 @@ export namespace tpu_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/tpu/v1alpha1.ts b/src/apis/tpu/v1alpha1.ts index b4d2d4b3ac..7d392e699d 100644 --- a/src/apis/tpu/v1alpha1.ts +++ b/src/apis/tpu/v1alpha1.ts @@ -1648,7 +1648,7 @@ export namespace tpu_v1alpha1 { } /** - * 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/tpu/v2.ts b/src/apis/tpu/v2.ts index 04a8d69fb7..4624ce87a0 100644 --- a/src/apis/tpu/v2.ts +++ b/src/apis/tpu/v2.ts @@ -425,7 +425,7 @@ export namespace tpu_v2 { */ export interface Schema$MultisliceParams { /** - * Required. Number of nodes with this spec. The system will attempt to provison "node_count" nodes as part of the request. This needs to be \> 1. + * Required. Number of nodes with this spec. The system will attempt to provision "node_count" nodes as part of the request. This needs to be \> 1. */ nodeCount?: number | null; /** @@ -536,9 +536,13 @@ export namespace tpu_v2 { */ name?: string | null; /** - * Network configurations for the TPU node. + * Network configurations for the TPU node. network_config and network_configs are mutually exclusive, you can only specify one of them. If both are specified, an error will be returned. */ networkConfig?: Schema$NetworkConfig; + /** + * Optional. Repeated network configurations for the TPU node. This field is used to specify multiple networks configs for the TPU node. network_config and network_configs are mutually exclusive, you can only specify one of them. If both are specified, an error will be returned. + */ + networkConfigs?: Schema$NetworkConfig[]; /** * Output only. The network endpoints where TPU workers can be accessed and sent work. It is recommended that runtime clients of the node reach out to the 0th entry in this map first. */ @@ -2280,7 +2284,7 @@ export namespace tpu_v2 { } /** - * 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/tpu/v2alpha1.ts b/src/apis/tpu/v2alpha1.ts index dc5666fe18..a4f4f7a183 100644 --- a/src/apis/tpu/v2alpha1.ts +++ b/src/apis/tpu/v2alpha1.ts @@ -475,6 +475,10 @@ export namespace tpu_v2alpha1 { * Prefix of node_ids in case of multi-node request Should follow the `^[A-Za-z0-9_.~+%-]+$` regex format. If node_count = 3 and node_id_prefix = "np", node ids of nodes created will be "np-0", "np-1", "np-2". If this field is not provided we use queued_resource_id as the node_id_prefix. */ nodeIdPrefix?: string | null; + /** + * Optional. The workload type for the multi-node request. + */ + workloadType?: string | null; } /** * Network related configurations. @@ -587,11 +591,11 @@ export namespace tpu_v2alpha1 { */ name?: string | null; /** - * Network configurations for the TPU node. + * Network configurations for the TPU node. network_config and network_configs are mutually exclusive, you can only specify one of them. If both are specified, an error will be returned. */ networkConfig?: Schema$NetworkConfig; /** - * Optional. Repeated network configurations for the TPU node. + * Optional. Repeated network configurations for the TPU node. This field is used to specify multiple networks configs for the TPU node. network_config and network_configs are mutually exclusive, you can only specify one of them. If both are specified, an error will be returned. */ networkConfigs?: Schema$NetworkConfig[]; /** @@ -630,6 +634,10 @@ export namespace tpu_v2alpha1 { * Tags to apply to the TPU Node. Tags are used to identify valid sources or targets for network firewalls. */ tags?: string[] | null; + /** + * Output only. Upcoming maintenance on this TPU node. + */ + upcomingMaintenance?: Schema$UpcomingMaintenance; } /** * Details of the TPU node(s) being requested. Users can request either a single node or multiple nodes. NodeSpec provides the specification for node(s) to be created. @@ -710,6 +718,19 @@ export namespace tpu_v2alpha1 { */ verb?: string | null; } + /** + * Request for PerformMaintenanceQueuedResource. + */ + export interface Schema$PerformMaintenanceQueuedResourceRequest { + /** + * The names of the nodes to perform maintenance on. + */ + nodeNames?: string[] | null; + } + /** + * Request for PerformMaintenance. + */ + export interface Schema$PerformMaintenanceRequest {} /** * Further data for the provisioning state. */ @@ -833,6 +854,9 @@ export namespace tpu_v2alpha1 { * The reservation name with the format: projects/{projectID\}/locations/{location\}/reservations/{reservationID\} */ name?: string | null; + /** + * A standard reservation. + */ standard?: Schema$Standard; /** * Output only. The state of the Reservation. @@ -917,7 +941,13 @@ export namespace tpu_v2alpha1 { * Spot tier definition. */ export interface Schema$Spot {} + /** + * Details of a standard reservation. + */ export interface Schema$Standard { + /** + * Capacity units this reservation is measured in. + */ capacityUnits?: string | null; /** * The start and end time of the reservation. @@ -931,6 +961,9 @@ export namespace tpu_v2alpha1 { * The size of the reservation, in the units specified in the 'capacity_units' field. */ size?: number | null; + /** + * The current usage of the reservation. + */ usage?: Schema$Usage; } /** @@ -996,6 +1029,38 @@ export namespace tpu_v2alpha1 { */ nodeSpec?: Schema$NodeSpec[]; } + /** + * Upcoming Maintenance notification information. + */ + export interface Schema$UpcomingMaintenance { + /** + * Indicates if the maintenance can be customer triggered. + */ + canReschedule?: boolean | null; + /** + * The latest time for the planned maintenance window to start. This timestamp value is in RFC3339 text format. + */ + latestWindowStartTime?: string | null; + /** + * The status of the maintenance. + */ + maintenanceStatus?: string | null; + /** + * Defines the type of maintenance. + */ + type?: string | null; + /** + * The time by which the maintenance disruption will be completed. This timestamp value is in RFC3339 text format. + */ + windowEndTime?: string | null; + /** + * The current start time of the maintenance window. This timestamp value is in RFC3339 text format. + */ + windowStartTime?: string | null; + } + /** + * Usage details of a reservation. + */ export interface Schema$Usage { /** * The real-time value of usage within the reservation, with the unit specified in field capacity_units. @@ -2111,6 +2176,95 @@ export namespace tpu_v2alpha1 { } } + /** + * Perform manual maintenance on a node. + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + performMaintenance( + params: Params$Resource$Projects$Locations$Nodes$Performmaintenance, + options: StreamMethodOptions + ): GaxiosPromise; + performMaintenance( + params?: Params$Resource$Projects$Locations$Nodes$Performmaintenance, + options?: MethodOptions + ): GaxiosPromise; + performMaintenance( + params: Params$Resource$Projects$Locations$Nodes$Performmaintenance, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + performMaintenance( + params: Params$Resource$Projects$Locations$Nodes$Performmaintenance, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + performMaintenance( + params: Params$Resource$Projects$Locations$Nodes$Performmaintenance, + callback: BodyResponseCallback + ): void; + performMaintenance(callback: BodyResponseCallback): void; + performMaintenance( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Nodes$Performmaintenance + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): void | GaxiosPromise | GaxiosPromise { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Nodes$Performmaintenance; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Projects$Locations$Nodes$Performmaintenance; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://tpu.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v2alpha1/{+name}:performMaintenance').replace( + /([^:]\/)\/+/g, + '$1' + ), + method: 'POST', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['name'], + pathParams: ['name'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + /** * Simulates a maintenance event. * @@ -2459,6 +2613,18 @@ export namespace tpu_v2alpha1 { */ requestBody?: Schema$Node; } + export interface Params$Resource$Projects$Locations$Nodes$Performmaintenance + extends StandardParameters { + /** + * Required. The resource name. + */ + name?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$PerformMaintenanceRequest; + } export interface Params$Resource$Projects$Locations$Nodes$Simulatemaintenanceevent extends StandardParameters { /** @@ -2503,7 +2669,7 @@ export namespace tpu_v2alpha1 { } /** - * 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`. @@ -3256,6 +3422,96 @@ export namespace tpu_v2alpha1 { } } + /** + * Perform manual maintenance on specific nodes of a QueuedResource. + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + performMaintenanceQueuedResource( + params: Params$Resource$Projects$Locations$Queuedresources$Performmaintenancequeuedresource, + options: StreamMethodOptions + ): GaxiosPromise; + performMaintenanceQueuedResource( + params?: Params$Resource$Projects$Locations$Queuedresources$Performmaintenancequeuedresource, + options?: MethodOptions + ): GaxiosPromise; + performMaintenanceQueuedResource( + params: Params$Resource$Projects$Locations$Queuedresources$Performmaintenancequeuedresource, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + performMaintenanceQueuedResource( + params: Params$Resource$Projects$Locations$Queuedresources$Performmaintenancequeuedresource, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + performMaintenanceQueuedResource( + params: Params$Resource$Projects$Locations$Queuedresources$Performmaintenancequeuedresource, + callback: BodyResponseCallback + ): void; + performMaintenanceQueuedResource( + callback: BodyResponseCallback + ): void; + performMaintenanceQueuedResource( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Queuedresources$Performmaintenancequeuedresource + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): void | GaxiosPromise | GaxiosPromise { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Queuedresources$Performmaintenancequeuedresource; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Projects$Locations$Queuedresources$Performmaintenancequeuedresource; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://tpu.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: ( + rootUrl + '/v2alpha1/{+name}:performMaintenanceQueuedResource' + ).replace(/([^:]\/)\/+/g, '$1'), + method: 'POST', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['name'], + pathParams: ['name'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + /** * Resets a QueuedResource TPU instance * @@ -3402,6 +3658,18 @@ export namespace tpu_v2alpha1 { */ parent?: string; } + export interface Params$Resource$Projects$Locations$Queuedresources$Performmaintenancequeuedresource + extends StandardParameters { + /** + * Required. The name of the QueuedResource which holds the nodes to perform maintenance on. + */ + name?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$PerformMaintenanceQueuedResourceRequest; + } export interface Params$Resource$Projects$Locations$Queuedresources$Reset extends StandardParameters { /** @@ -3518,7 +3786,7 @@ export namespace tpu_v2alpha1 { export interface Params$Resource$Projects$Locations$Reservations$List extends StandardParameters { /** - * The maximum number of items to return. + * The maximum number of items to return. Defaults to 0 if not specified, which means no limit. */ pageSize?: number; /**