Skip to content

Commit e063dee

Browse files
yoshi-automationfeywind
yoshi-automation
authored and
feywind
committed
feat(managedkafka): update the API
#### managedkafka:v1 The following keys were added: - resources.projects.resources.locations.resources.clusters.methods.get.parameters.view.description - resources.projects.resources.locations.resources.clusters.methods.get.parameters.view.enum - resources.projects.resources.locations.resources.clusters.methods.get.parameters.view.enumDescriptions - resources.projects.resources.locations.resources.clusters.methods.get.parameters.view.location - resources.projects.resources.locations.resources.clusters.methods.get.parameters.view.type - schemas.BrokerDetails.description - schemas.BrokerDetails.id - schemas.BrokerDetails.properties.brokerIndex.description - schemas.BrokerDetails.properties.brokerIndex.format - schemas.BrokerDetails.properties.brokerIndex.readOnly - schemas.BrokerDetails.properties.brokerIndex.type - schemas.BrokerDetails.properties.nodeId.description - schemas.BrokerDetails.properties.nodeId.format - schemas.BrokerDetails.properties.nodeId.readOnly - schemas.BrokerDetails.properties.nodeId.type - schemas.BrokerDetails.properties.rack.description - schemas.BrokerDetails.properties.rack.readOnly - schemas.BrokerDetails.properties.rack.type - schemas.BrokerDetails.type - schemas.Cluster.properties.brokerDetails.description - schemas.Cluster.properties.brokerDetails.items.$ref - schemas.Cluster.properties.brokerDetails.readOnly - schemas.Cluster.properties.brokerDetails.type - schemas.Cluster.properties.kafkaVersion.description - schemas.Cluster.properties.kafkaVersion.readOnly - schemas.Cluster.properties.kafkaVersion.type
1 parent ca7829e commit e063dee

File tree

2 files changed

+90
-1
lines changed

2 files changed

+90
-1
lines changed

‎discovery/managedkafka-v1.json‎

Lines changed: 53 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -480,6 +480,21 @@
480480
"pattern": "^projects/[^/]+/locations/[^/]+/clusters/[^/]+$",
481481
"required": true,
482482
"type": "string"
483+
},
484+
"view": {
485+
"description": "Optional. Specifies the view of the Cluster resource to be returned. Defaults to CLUSTER_VIEW_BASIC. See the ClusterView enum for possible values.",
486+
"enum": [
487+
"CLUSTER_VIEW_UNSPECIFIED",
488+
"CLUSTER_VIEW_BASIC",
489+
"CLUSTER_VIEW_FULL"
490+
],
491+
"enumDescriptions": [
492+
"The default / unset value. The API will default to the BASIC view.",
493+
"Include the basic metadata of the Cluster. This is the default value (for both ListClusters and GetCluster).",
494+
"Include everything, including data fetched from the Kafka cluster source of truth."
495+
],
496+
"location": "query",
497+
"type": "string"
483498
}
484499
},
485500
"path": "v1/{+name}",
@@ -3166,7 +3181,7 @@
31663181
}
31673182
}
31683183
},
3169-
"revision": "20251204",
3184+
"revision": "20251212",
31703185
"rootUrl": "https://managedkafka.googleapis.com/",
31713186
"schemas": {
31723187
"AccessConfig": {
@@ -3258,6 +3273,30 @@
32583273
},
32593274
"type": "object"
32603275
},
3276+
"BrokerDetails": {
3277+
"description": "Details of a broker in the Kafka cluster.",
3278+
"id": "BrokerDetails",
3279+
"properties": {
3280+
"brokerIndex": {
3281+
"description": "Output only. The index of the broker.",
3282+
"format": "int64",
3283+
"readOnly": true,
3284+
"type": "string"
3285+
},
3286+
"nodeId": {
3287+
"description": "Output only. The node id of the broker.",
3288+
"format": "int64",
3289+
"readOnly": true,
3290+
"type": "string"
3291+
},
3292+
"rack": {
3293+
"description": "Output only. The rack of the broker.",
3294+
"readOnly": true,
3295+
"type": "string"
3296+
}
3297+
},
3298+
"type": "object"
3299+
},
32613300
"CancelOperationRequest": {
32623301
"description": "The request message for Operations.CancelOperation.",
32633302
"id": "CancelOperationRequest",
@@ -3352,6 +3391,14 @@
33523391
"description": "An Apache Kafka cluster deployed in a location.",
33533392
"id": "Cluster",
33543393
"properties": {
3394+
"brokerDetails": {
3395+
"description": "Output only. Only populated when FULL view is requested. Details of each broker in the cluster.",
3396+
"items": {
3397+
"$ref": "BrokerDetails"
3398+
},
3399+
"readOnly": true,
3400+
"type": "array"
3401+
},
33553402
"capacityConfig": {
33563403
"$ref": "CapacityConfig",
33573404
"description": "Required. Capacity configuration for the Kafka cluster."
@@ -3366,6 +3413,11 @@
33663413
"$ref": "GcpConfig",
33673414
"description": "Required. Configuration properties for a Kafka cluster deployed to Google Cloud Platform."
33683415
},
3416+
"kafkaVersion": {
3417+
"description": "Output only. Only populated when FULL view is requested. The Kafka version of the cluster.",
3418+
"readOnly": true,
3419+
"type": "string"
3420+
},
33693421
"labels": {
33703422
"additionalProperties": {
33713423
"type": "string"

‎src/apis/managedkafka/v1.ts‎

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -196,6 +196,23 @@ export namespace managedkafka_v1 {
196196
*/
197197
aclCreated?: boolean | null;
198198
}
199+
/**
200+
* Details of a broker in the Kafka cluster.
201+
*/
202+
export interface Schema$BrokerDetails {
203+
/**
204+
* Output only. The index of the broker.
205+
*/
206+
brokerIndex?: string | null;
207+
/**
208+
* Output only. The node id of the broker.
209+
*/
210+
nodeId?: string | null;
211+
/**
212+
* Output only. The rack of the broker.
213+
*/
214+
rack?: string | null;
215+
}
199216
/**
200217
* The request message for Operations.CancelOperation.
201218
*/
@@ -260,6 +277,10 @@ export namespace managedkafka_v1 {
260277
* An Apache Kafka cluster deployed in a location.
261278
*/
262279
export interface Schema$Cluster {
280+
/**
281+
* Output only. Only populated when FULL view is requested. Details of each broker in the cluster.
282+
*/
283+
brokerDetails?: Schema$BrokerDetails[];
263284
/**
264285
* Required. Capacity configuration for the Kafka cluster.
265286
*/
@@ -272,6 +293,10 @@ export namespace managedkafka_v1 {
272293
* Required. Configuration properties for a Kafka cluster deployed to Google Cloud Platform.
273294
*/
274295
gcpConfig?: Schema$GcpConfig;
296+
/**
297+
* Output only. Only populated when FULL view is requested. The Kafka version of the cluster.
298+
*/
299+
kafkaVersion?: string | null;
275300
/**
276301
* Optional. Labels as key value pairs.
277302
*/
@@ -1460,9 +1485,11 @@ export namespace managedkafka_v1 {
14601485
* requestBody: {
14611486
* // request body parameters
14621487
* // {
1488+
* // "brokerDetails": [],
14631489
* // "capacityConfig": {},
14641490
* // "createTime": "my_createTime",
14651491
* // "gcpConfig": {},
1492+
* // "kafkaVersion": "my_kafkaVersion",
14661493
* // "labels": {},
14671494
* // "name": "my_name",
14681495
* // "rebalanceConfig": {},
@@ -1755,14 +1782,18 @@ export namespace managedkafka_v1 {
17551782
* const res = await managedkafka.projects.locations.clusters.get({
17561783
* // Required. The name of the cluster whose configuration to return.
17571784
* name: 'projects/my-project/locations/my-location/clusters/my-cluster',
1785+
* // Optional. Specifies the view of the Cluster resource to be returned. Defaults to CLUSTER_VIEW_BASIC. See the ClusterView enum for possible values.
1786+
* view: 'placeholder-value',
17581787
* });
17591788
* console.log(res.data);
17601789
*
17611790
* // Example response
17621791
* // {
1792+
* // "brokerDetails": [],
17631793
* // "capacityConfig": {},
17641794
* // "createTime": "my_createTime",
17651795
* // "gcpConfig": {},
1796+
* // "kafkaVersion": "my_kafkaVersion",
17661797
* // "labels": {},
17671798
* // "name": "my_name",
17681799
* // "rebalanceConfig": {},
@@ -2058,9 +2089,11 @@ export namespace managedkafka_v1 {
20582089
* requestBody: {
20592090
* // request body parameters
20602091
* // {
2092+
* // "brokerDetails": [],
20612093
* // "capacityConfig": {},
20622094
* // "createTime": "my_createTime",
20632095
* // "gcpConfig": {},
2096+
* // "kafkaVersion": "my_kafkaVersion",
20642097
* // "labels": {},
20652098
* // "name": "my_name",
20662099
* // "rebalanceConfig": {},
@@ -2212,6 +2245,10 @@ export namespace managedkafka_v1 {
22122245
* Required. The name of the cluster whose configuration to return.
22132246
*/
22142247
name?: string;
2248+
/**
2249+
* Optional. Specifies the view of the Cluster resource to be returned. Defaults to CLUSTER_VIEW_BASIC. See the ClusterView enum for possible values.
2250+
*/
2251+
view?: string;
22152252
}
22162253
export interface Params$Resource$Projects$Locations$Clusters$List extends StandardParameters {
22172254
/**

0 commit comments

Comments
 (0)