Skip to content

Commit a7b08f5

Browse files
yoshi-automationyoshi-automation
committed
feat(tpu): update the API
#### tpu:v1alpha1 The following keys were added: - resources.projects.resources.locations.methods.list.parameters.extraLocationTypes.description - resources.projects.resources.locations.methods.list.parameters.extraLocationTypes.location - resources.projects.resources.locations.methods.list.parameters.extraLocationTypes.repeated - resources.projects.resources.locations.methods.list.parameters.extraLocationTypes.type #### tpu:v2alpha1 The following keys were added: - resources.projects.resources.locations.methods.list.parameters.extraLocationTypes.description - resources.projects.resources.locations.methods.list.parameters.extraLocationTypes.location - resources.projects.resources.locations.methods.list.parameters.extraLocationTypes.repeated - resources.projects.resources.locations.methods.list.parameters.extraLocationTypes.type - schemas.BootDiskConfig.properties.diskSizeGb.description - schemas.BootDiskConfig.properties.diskSizeGb.format - schemas.BootDiskConfig.properties.diskSizeGb.type - schemas.BootDiskConfig.properties.provisionedIops.description - schemas.BootDiskConfig.properties.provisionedIops.format - schemas.BootDiskConfig.properties.provisionedIops.type - schemas.BootDiskConfig.properties.provisionedThroughput.description - schemas.BootDiskConfig.properties.provisionedThroughput.format - schemas.BootDiskConfig.properties.provisionedThroughput.type - schemas.BootDiskConfig.properties.sourceImage.description - schemas.BootDiskConfig.properties.sourceImage.type - schemas.QueuedResource.properties.provisioningModel.description - schemas.QueuedResource.properties.provisioningModel.enum - schemas.QueuedResource.properties.provisioningModel.enumDescriptions - schemas.QueuedResource.properties.provisioningModel.type - schemas.QueuedResource.properties.runDuration.$ref - schemas.QueuedResource.properties.runDuration.description - schemas.RunDuration.description - schemas.RunDuration.id - schemas.RunDuration.properties.maxRunDuration.description - schemas.RunDuration.properties.maxRunDuration.format - schemas.RunDuration.properties.maxRunDuration.type - schemas.RunDuration.properties.terminationTime.description - schemas.RunDuration.properties.terminationTime.format - schemas.RunDuration.properties.terminationTime.type - schemas.RunDuration.type - schemas.SchedulingConfig.properties.provisioningModel.description - schemas.SchedulingConfig.properties.provisioningModel.enum - schemas.SchedulingConfig.properties.provisioningModel.enumDescriptions - schemas.SchedulingConfig.properties.provisioningModel.type #### tpu:v1 The following keys were added: - resources.projects.resources.locations.methods.list.parameters.extraLocationTypes.description - resources.projects.resources.locations.methods.list.parameters.extraLocationTypes.location - resources.projects.resources.locations.methods.list.parameters.extraLocationTypes.repeated - resources.projects.resources.locations.methods.list.parameters.extraLocationTypes.type #### tpu:v2 The following keys were added: - resources.projects.resources.locations.methods.list.parameters.extraLocationTypes.description - resources.projects.resources.locations.methods.list.parameters.extraLocationTypes.location - resources.projects.resources.locations.methods.list.parameters.extraLocationTypes.repeated - resources.projects.resources.locations.methods.list.parameters.extraLocationTypes.type - schemas.Node.properties.upcomingMaintenance.$ref - schemas.Node.properties.upcomingMaintenance.description - schemas.Node.properties.upcomingMaintenance.readOnly - schemas.UpcomingMaintenance.description - schemas.UpcomingMaintenance.id - schemas.UpcomingMaintenance.properties.canReschedule.description - schemas.UpcomingMaintenance.properties.canReschedule.type - schemas.UpcomingMaintenance.properties.latestWindowStartTime.description - schemas.UpcomingMaintenance.properties.latestWindowStartTime.type - schemas.UpcomingMaintenance.properties.maintenanceStatus.description - schemas.UpcomingMaintenance.properties.maintenanceStatus.enum - schemas.UpcomingMaintenance.properties.maintenanceStatus.enumDescriptions - schemas.UpcomingMaintenance.properties.maintenanceStatus.type - schemas.UpcomingMaintenance.properties.type.description - schemas.UpcomingMaintenance.properties.type.enum - schemas.UpcomingMaintenance.properties.type.enumDescriptions - schemas.UpcomingMaintenance.properties.type.type - schemas.UpcomingMaintenance.properties.windowEndTime.description - schemas.UpcomingMaintenance.properties.windowEndTime.type - schemas.UpcomingMaintenance.properties.windowStartTime.description - schemas.UpcomingMaintenance.properties.windowStartTime.type - schemas.UpcomingMaintenance.type
1 parent 3275bbb commit a7b08f5

File tree

8 files changed

+248
-4
lines changed

8 files changed

+248
-4
lines changed

‎discovery/tpu-v1.json

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -143,6 +143,12 @@
143143
"name"
144144
],
145145
"parameters": {
146+
"extraLocationTypes": {
147+
"description": "Optional. A list of extra location types that should be used as conditions for controlling the visibility of the locations.",
148+
"location": "query",
149+
"repeated": true,
150+
"type": "string"
151+
},
146152
"filter": {
147153
"description": "A filter to narrow down results to a preferred subset. The filtering language accepts strings like `\"displayName=tokyo\"`, and is documented in more detail in [AIP-160](https://google.aip.dev/160).",
148154
"location": "query",
@@ -659,7 +665,7 @@
659665
}
660666
}
661667
},
662-
"revision": "20241126",
668+
"revision": "20250320",
663669
"rootUrl": "https://tpu.googleapis.com/",
664670
"schemas": {
665671
"AcceleratorType": {

‎discovery/tpu-v1alpha1.json

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -143,6 +143,12 @@
143143
"name"
144144
],
145145
"parameters": {
146+
"extraLocationTypes": {
147+
"description": "Optional. A list of extra location types that should be used as conditions for controlling the visibility of the locations.",
148+
"location": "query",
149+
"repeated": true,
150+
"type": "string"
151+
},
146152
"filter": {
147153
"description": "A filter to narrow down results to a preferred subset. The filtering language accepts strings like `\"displayName=tokyo\"`, and is documented in more detail in [AIP-160](https://google.aip.dev/160).",
148154
"location": "query",
@@ -669,7 +675,7 @@
669675
}
670676
}
671677
},
672-
"revision": "20241126",
678+
"revision": "20250320",
673679
"rootUrl": "https://tpu.googleapis.com/",
674680
"schemas": {
675681
"AcceleratorType": {

‎discovery/tpu-v2.json

Lines changed: 63 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -171,6 +171,12 @@
171171
"name"
172172
],
173173
"parameters": {
174+
"extraLocationTypes": {
175+
"description": "Optional. A list of extra location types that should be used as conditions for controlling the visibility of the locations.",
176+
"location": "query",
177+
"repeated": true,
178+
"type": "string"
179+
},
174180
"filter": {
175181
"description": "A filter to narrow down results to a preferred subset. The filtering language accepts strings like `\"displayName=tokyo\"`, and is documented in more detail in [AIP-160](https://google.aip.dev/160).",
176182
"location": "query",
@@ -887,7 +893,7 @@
887893
}
888894
}
889895
},
890-
"revision": "20250116",
896+
"revision": "20250410",
891897
"rootUrl": "https://tpu.googleapis.com/",
892898
"schemas": {
893899
"AcceleratorConfig": {
@@ -1584,6 +1590,11 @@
15841590
"type": "string"
15851591
},
15861592
"type": "array"
1593+
},
1594+
"upcomingMaintenance": {
1595+
"$ref": "UpcomingMaintenance",
1596+
"description": "Output only. Upcoming maintenance on this TPU node.",
1597+
"readOnly": true
15871598
}
15881599
},
15891600
"type": "object"
@@ -2046,6 +2057,57 @@
20462057
}
20472058
},
20482059
"type": "object"
2060+
},
2061+
"UpcomingMaintenance": {
2062+
"description": "Upcoming Maintenance notification information.",
2063+
"id": "UpcomingMaintenance",
2064+
"properties": {
2065+
"canReschedule": {
2066+
"description": "Indicates if the maintenance can be customer triggered.",
2067+
"type": "boolean"
2068+
},
2069+
"latestWindowStartTime": {
2070+
"description": "The latest time for the planned maintenance window to start. This timestamp value is in RFC3339 text format.",
2071+
"type": "string"
2072+
},
2073+
"maintenanceStatus": {
2074+
"description": "The status of the maintenance.",
2075+
"enum": [
2076+
"UNKNOWN",
2077+
"PENDING",
2078+
"ONGOING"
2079+
],
2080+
"enumDescriptions": [
2081+
"Unknown maintenance status. Do not use this value.",
2082+
"There is pending maintenance.",
2083+
"There is ongoing maintenance on this VM."
2084+
],
2085+
"type": "string"
2086+
},
2087+
"type": {
2088+
"description": "Defines the type of maintenance.",
2089+
"enum": [
2090+
"UNKNOWN_TYPE",
2091+
"SCHEDULED",
2092+
"UNSCHEDULED"
2093+
],
2094+
"enumDescriptions": [
2095+
"No type specified. Do not use this value.",
2096+
"Scheduled maintenance (e.g. maintenance after uptime guarantee is complete).",
2097+
"Unscheduled maintenance (e.g. emergency maintenance during uptime guarantee)."
2098+
],
2099+
"type": "string"
2100+
},
2101+
"windowEndTime": {
2102+
"description": "The time by which the maintenance disruption will be completed. This timestamp value is in RFC3339 text format.",
2103+
"type": "string"
2104+
},
2105+
"windowStartTime": {
2106+
"description": "The current start time of the maintenance window. This timestamp value is in RFC3339 text format.",
2107+
"type": "string"
2108+
}
2109+
},
2110+
"type": "object"
20492111
}
20502112
},
20512113
"servicePath": "",

‎discovery/tpu-v2alpha1.json

Lines changed: 81 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -171,6 +171,12 @@
171171
"name"
172172
],
173173
"parameters": {
174+
"extraLocationTypes": {
175+
"description": "Optional. A list of extra location types that should be used as conditions for controlling the visibility of the locations.",
176+
"location": "query",
177+
"repeated": true,
178+
"type": "string"
179+
},
174180
"filter": {
175181
"description": "A filter to narrow down results to a preferred subset. The filtering language accepts strings like `\"displayName=tokyo\"`, and is documented in more detail in [AIP-160](https://google.aip.dev/160).",
176182
"location": "query",
@@ -1021,7 +1027,7 @@
10211027
}
10221028
}
10231029
},
1024-
"revision": "20250306",
1030+
"revision": "20250423",
10251031
"rootUrl": "https://tpu.googleapis.com/",
10261032
"schemas": {
10271033
"AcceleratorConfig": {
@@ -1149,9 +1155,28 @@
11491155
"$ref": "CustomerEncryptionKey",
11501156
"description": "Optional. Customer encryption key for boot disk."
11511157
},
1158+
"diskSizeGb": {
1159+
"description": "Optional. Size of the boot disk in GB. It must be larger than or equal to the size of the image.",
1160+
"format": "int64",
1161+
"type": "string"
1162+
},
11521163
"enableConfidentialCompute": {
11531164
"description": "Optional. Whether the boot disk will be created with confidential compute mode.",
11541165
"type": "boolean"
1166+
},
1167+
"provisionedIops": {
1168+
"description": "Optional. Indicates how many IOPS to provision for the disk. This sets the number of I/O operations per second that the disk can handle. To learn more about IOPS, see [Provisioning persistent disk performance](https://cloud.google.com/compute/docs/disks/performance#provisioned-iops).",
1169+
"format": "int64",
1170+
"type": "string"
1171+
},
1172+
"provisionedThroughput": {
1173+
"description": "Optional. Indicates how much throughput to provision for the disk. This sets the number of throughput MB per second that the disk can handle.",
1174+
"format": "int64",
1175+
"type": "string"
1176+
},
1177+
"sourceImage": {
1178+
"description": "Optional. Image from which boot disk is to be created. If not specified, the default image for the runtime version will be used. Example: `projects/$PROJECT_ID/global/images/$IMAGE_NAME`.",
1179+
"type": "string"
11551180
}
11561181
},
11571182
"type": "object"
@@ -1951,6 +1976,24 @@
19511976
"readOnly": true,
19521977
"type": "string"
19531978
},
1979+
"provisioningModel": {
1980+
"description": "Optional. The provisioning model for the resource.",
1981+
"enum": [
1982+
"PROVISIONING_MODEL_UNSPECIFIED",
1983+
"STANDARD",
1984+
"SPOT",
1985+
"RESERVATION_BOUND",
1986+
"FLEX_START"
1987+
],
1988+
"enumDescriptions": [
1989+
"Provisioning model is unknown.",
1990+
"Standard provisioning with user controlled runtime.",
1991+
"Spot provisioning with no guaranteed runtime.",
1992+
"Reservation provisioning with runtime bound to the lifetime of the consumed reservation.",
1993+
"Provisioning with DWS Flex Start with max run duration."
1994+
],
1995+
"type": "string"
1996+
},
19541997
"queueingPolicy": {
19551998
"$ref": "QueueingPolicy",
19561999
"description": "The queueing policy of the QueuedRequest."
@@ -1959,6 +2002,10 @@
19592002
"description": "Name of the reservation in which the resource should be provisioned. Format: projects/{project}/locations/{zone}/reservations/{reservation}",
19602003
"type": "string"
19612004
},
2005+
"runDuration": {
2006+
"$ref": "RunDuration",
2007+
"description": "Optional. The duration of the requested resource."
2008+
},
19622009
"spot": {
19632010
"$ref": "Spot",
19642011
"description": "Optional. The Spot tier."
@@ -2132,6 +2179,23 @@
21322179
"properties": {},
21332180
"type": "object"
21342181
},
2182+
"RunDuration": {
2183+
"description": "Defines the maximum lifetime of the requested resource.",
2184+
"id": "RunDuration",
2185+
"properties": {
2186+
"maxRunDuration": {
2187+
"description": "The maximum duration of the requested resource.",
2188+
"format": "google-duration",
2189+
"type": "string"
2190+
},
2191+
"terminationTime": {
2192+
"description": "The time at which the requested resource will be terminated.",
2193+
"format": "google-datetime",
2194+
"type": "string"
2195+
}
2196+
},
2197+
"type": "object"
2198+
},
21352199
"RuntimeVersion": {
21362200
"description": "A runtime version that a Node can be configured with.",
21372201
"id": "RuntimeVersion",
@@ -2155,6 +2219,22 @@
21552219
"description": "Defines whether the node is preemptible.",
21562220
"type": "boolean"
21572221
},
2222+
"provisioningModel": {
2223+
"description": "Optional. Defines the provisioning model for the node.",
2224+
"enum": [
2225+
"PROVISIONING_MODEL_UNSPECIFIED",
2226+
"STANDARD",
2227+
"SPOT",
2228+
"RESERVATION_BOUND"
2229+
],
2230+
"enumDescriptions": [
2231+
"Provisioning model is unknown.",
2232+
"Standard provisioning with user controlled runtime.",
2233+
"Spot provisioning with no guaranteed runtime.",
2234+
"Reservation provisioning with runtime bound to the lifetime of the consumed reservation."
2235+
],
2236+
"type": "string"
2237+
},
21582238
"reserved": {
21592239
"description": "Whether the node is created under a reservation.",
21602240
"type": "boolean"

‎src/apis/tpu/v1.ts

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -693,6 +693,10 @@ export namespace tpu_v1 {
693693
}
694694
export interface Params$Resource$Projects$Locations$List
695695
extends StandardParameters {
696+
/**
697+
* Optional. A list of extra location types that should be used as conditions for controlling the visibility of the locations.
698+
*/
699+
extraLocationTypes?: string[];
696700
/**
697701
* A filter to narrow down results to a preferred subset. The filtering language accepts strings like `"displayName=tokyo"`, and is documented in more detail in [AIP-160](https://google.aip.dev/160).
698702
*/

‎src/apis/tpu/v1alpha1.ts

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -693,6 +693,10 @@ export namespace tpu_v1alpha1 {
693693
}
694694
export interface Params$Resource$Projects$Locations$List
695695
extends StandardParameters {
696+
/**
697+
* Optional. A list of extra location types that should be used as conditions for controlling the visibility of the locations.
698+
*/
699+
extraLocationTypes?: string[];
696700
/**
697701
* A filter to narrow down results to a preferred subset. The filtering language accepts strings like `"displayName=tokyo"`, and is documented in more detail in [AIP-160](https://google.aip.dev/160).
698702
*/

‎src/apis/tpu/v2.ts

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -579,6 +579,10 @@ export namespace tpu_v2 {
579579
* Tags to apply to the TPU Node. Tags are used to identify valid sources or targets for network firewalls.
580580
*/
581581
tags?: string[] | null;
582+
/**
583+
* Output only. Upcoming maintenance on this TPU node.
584+
*/
585+
upcomingMaintenance?: Schema$UpcomingMaintenance;
582586
}
583587
/**
584588
* 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.
@@ -902,6 +906,35 @@ export namespace tpu_v2 {
902906
*/
903907
nodeSpec?: Schema$NodeSpec[];
904908
}
909+
/**
910+
* Upcoming Maintenance notification information.
911+
*/
912+
export interface Schema$UpcomingMaintenance {
913+
/**
914+
* Indicates if the maintenance can be customer triggered.
915+
*/
916+
canReschedule?: boolean | null;
917+
/**
918+
* The latest time for the planned maintenance window to start. This timestamp value is in RFC3339 text format.
919+
*/
920+
latestWindowStartTime?: string | null;
921+
/**
922+
* The status of the maintenance.
923+
*/
924+
maintenanceStatus?: string | null;
925+
/**
926+
* Defines the type of maintenance.
927+
*/
928+
type?: string | null;
929+
/**
930+
* The time by which the maintenance disruption will be completed. This timestamp value is in RFC3339 text format.
931+
*/
932+
windowEndTime?: string | null;
933+
/**
934+
* The current start time of the maintenance window. This timestamp value is in RFC3339 text format.
935+
*/
936+
windowStartTime?: string | null;
937+
}
905938

906939
export class Resource$Projects {
907940
context: APIRequestContext;
@@ -1234,6 +1267,10 @@ export namespace tpu_v2 {
12341267
}
12351268
export interface Params$Resource$Projects$Locations$List
12361269
extends StandardParameters {
1270+
/**
1271+
* Optional. A list of extra location types that should be used as conditions for controlling the visibility of the locations.
1272+
*/
1273+
extraLocationTypes?: string[];
12371274
/**
12381275
* A filter to narrow down results to a preferred subset. The filtering language accepts strings like `"displayName=tokyo"`, and is documented in more detail in [AIP-160](https://google.aip.dev/160).
12391276
*/

0 commit comments

Comments
 (0)