Skip to content

Commit 8e7e44a

Browse files
chore(openapi): update connector-mgmt/v1 OpenAPI document (#174)
1 parent a2478b6 commit 8e7e44a

41 files changed

Lines changed: 760 additions & 490 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.openapi/connector_mgmt.yaml

Lines changed: 6 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -226,11 +226,7 @@ paths:
226226
parameters:
227227
- $ref: "#/components/parameters/page"
228228
- $ref: "#/components/parameters/size"
229-
- in: query
230-
name: kafka_id
231-
description: The kafka cluster id
232-
schema:
233-
type: string
229+
234230
responses:
235231
"200":
236232
content:
@@ -260,11 +256,6 @@ paths:
260256
"/api/connector_mgmt/v1/kafka_connectors/{id}":
261257
parameters:
262258
- $ref: "#/components/parameters/id"
263-
- in: query
264-
name: kafka_id
265-
description: The kafka cluster id
266-
schema:
267-
type: string
268259
get:
269260
tags:
270261
- Connectors
@@ -360,16 +351,17 @@ paths:
360351
requestBody:
361352
description: Data to patch the connector with
362353
content:
363-
application/json:
364-
schema:
365-
$ref: "#/components/schemas/ConnectorRequest"
366354
application/merge-patch+json:
367355
schema:
368-
$ref: "#/components/schemas/ConnectorRequest"
356+
type: object
369357
application/json-patch+json:
370358
schema:
371359
description: A JSON Patch, RFC 6902 - https://tools.ietf.org/html/rfc6902
372360
type: object
361+
application/json:
362+
schema:
363+
$ref: "#/components/schemas/ConnectorRequest"
364+
373365
required: true
374366
responses:
375367
"202":
@@ -822,18 +814,6 @@ components:
822814
allOf:
823815
- $ref: "#/components/schemas/ObjectReference"
824816

825-
ServiceStatus:
826-
description: Schema for the service status response body
827-
example:
828-
kafkas:
829-
max_capacity_reached: true
830-
type: object
831-
properties:
832-
# TODO: what to show here ?
833-
clusters:
834-
description: The connector to upgrade
835-
type: string
836-
837817
#
838818
# Services
839819
#

openapitools.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,6 @@
22
"$schema": "node_modules/@openapitools/openapi-generator-cli/config.schema.json",
33
"spaces": 2,
44
"generator-cli": {
5-
"version": "5.3.1"
5+
"version": "5.4.0"
66
}
77
}

packages/connector-management-sdk/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -168,12 +168,12 @@ Class | Method | HTTP request | Description
168168
- [Error](docs/Error.md)
169169
- [ErrorAllOf](docs/ErrorAllOf.md)
170170
- [KafkaConnectionSettings](docs/KafkaConnectionSettings.md)
171+
- [ModelList](docs/ModelList.md)
171172
- [ObjectMeta](docs/ObjectMeta.md)
172173
- [ObjectReference](docs/ObjectReference.md)
173174
- [SchemaRegistryConnectionSettings](docs/SchemaRegistryConnectionSettings.md)
174175
- [ServiceAccount](docs/ServiceAccount.md)
175176
- [ServiceConnectionSettings](docs/ServiceConnectionSettings.md)
176-
- [ServiceStatus](docs/ServiceStatus.md)
177177
- [VersionMetadata](docs/VersionMetadata.md)
178178
- [VersionMetadataAllOf](docs/VersionMetadataAllOf.md)
179179

packages/connector-management-sdk/api/openapi.yaml

Lines changed: 5 additions & 47 deletions
Original file line numberDiff line numberDiff line change
@@ -238,14 +238,6 @@ paths:
238238
schema:
239239
type: string
240240
style: form
241-
- description: The kafka cluster id
242-
explode: true
243-
in: query
244-
name: kafka_id
245-
required: false
246-
schema:
247-
type: string
248-
style: form
249241
responses:
250242
"200":
251243
content:
@@ -362,14 +354,6 @@ paths:
362354
schema:
363355
type: string
364356
style: simple
365-
- description: The kafka cluster id
366-
explode: true
367-
in: query
368-
name: kafka_id
369-
required: false
370-
schema:
371-
type: string
372-
style: form
373357
responses:
374358
"204":
375359
content:
@@ -422,14 +406,6 @@ paths:
422406
schema:
423407
type: string
424408
style: simple
425-
- description: The kafka cluster id
426-
explode: true
427-
in: query
428-
name: kafka_id
429-
required: false
430-
schema:
431-
type: string
432-
style: form
433409
responses:
434410
"200":
435411
content:
@@ -482,26 +458,18 @@ paths:
482458
schema:
483459
type: string
484460
style: simple
485-
- description: The kafka cluster id
486-
explode: true
487-
in: query
488-
name: kafka_id
489-
required: false
490-
schema:
491-
type: string
492-
style: form
493461
requestBody:
494462
content:
495-
application/json:
496-
schema:
497-
$ref: '#/components/schemas/ConnectorRequest'
498463
application/merge-patch+json:
499464
schema:
500-
$ref: '#/components/schemas/ConnectorRequest'
465+
type: object
501466
application/json-patch+json:
502467
schema:
503468
description: A JSON Patch, RFC 6902 - https://tools.ietf.org/html/rfc6902
504469
type: object
470+
application/json:
471+
schema:
472+
$ref: '#/components/schemas/ConnectorRequest'
505473
description: Data to patch the connector with
506474
required: true
507475
responses:
@@ -543,7 +511,7 @@ paths:
543511
summary: Patch a connector
544512
tags:
545513
- Connectors
546-
x-contentType: application/json
514+
x-contentType: application/merge-patch+json
547515
x-accepts: application/json
548516
/api/connector_mgmt/v1/kafka_connector_clusters:
549517
get:
@@ -1278,16 +1246,6 @@ components:
12781246
allOf:
12791247
- $ref: '#/components/schemas/ObjectReference'
12801248
- $ref: '#/components/schemas/VersionMetadata_allOf'
1281-
ServiceStatus:
1282-
description: Schema for the service status response body
1283-
example:
1284-
kafkas:
1285-
max_capacity_reached: true
1286-
properties:
1287-
clusters:
1288-
description: The connector to upgrade
1289-
type: string
1290-
type: object
12911249
KafkaConnectionSettings:
12921250
allOf:
12931251
- $ref: '#/components/schemas/ServiceConnectionSettings'
Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
2+
3+
# ConnectorPatch
4+
5+
6+
## Properties
7+
8+
Name | Type | Description | Notes
9+
------------ | ------------- | ------------- | -------------
10+
**name** | **String** | |
11+
**connectorTypeId** | **String** | |
12+
**channel** | **Channel** | | [optional]
13+
**deploymentLocation** | [**DeploymentLocation**](DeploymentLocation.md) | |
14+
**desiredState** | **ConnectorDesiredState** | |
15+
**kafka** | [**KafkaConnectionSettings**](KafkaConnectionSettings.md) | |
16+
**serviceAccount** | [**ServiceAccount**](ServiceAccount.md) | |
17+
**schemaRegistry** | [**SchemaRegistryConnectionSettings**](SchemaRegistryConnectionSettings.md) | | [optional]
18+
**connector** | **Object** | |
19+
20+
21+

packages/connector-management-sdk/docs/ConnectorsApi.md

Lines changed: 11 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -91,7 +91,7 @@ Name | Type | Description | Notes
9191

9292
## deleteConnector
9393

94-
> Error deleteConnector(id, kafkaId)
94+
> Error deleteConnector(id)
9595
9696
Delete a connector
9797

@@ -119,9 +119,8 @@ public class Example {
119119

120120
ConnectorsApi apiInstance = new ConnectorsApi(defaultClient);
121121
String id = "id_example"; // String | The ID of record
122-
String kafkaId = "kafkaId_example"; // String | The kafka cluster id
123122
try {
124-
Error result = apiInstance.deleteConnector(id, kafkaId);
123+
Error result = apiInstance.deleteConnector(id);
125124
System.out.println(result);
126125
} catch (ApiException e) {
127126
System.err.println("Exception when calling ConnectorsApi#deleteConnector");
@@ -140,7 +139,6 @@ public class Example {
140139
Name | Type | Description | Notes
141140
------------- | ------------- | ------------- | -------------
142141
**id** | **String**| The ID of record |
143-
**kafkaId** | **String**| The kafka cluster id | [optional]
144142

145143
### Return type
146144

@@ -167,7 +165,7 @@ Name | Type | Description | Notes
167165

168166
## getConnector
169167

170-
> Connector getConnector(id, kafkaId)
168+
> Connector getConnector(id)
171169
172170
Get a connector
173171

@@ -195,9 +193,8 @@ public class Example {
195193

196194
ConnectorsApi apiInstance = new ConnectorsApi(defaultClient);
197195
String id = "id_example"; // String | The ID of record
198-
String kafkaId = "kafkaId_example"; // String | The kafka cluster id
199196
try {
200-
Connector result = apiInstance.getConnector(id, kafkaId);
197+
Connector result = apiInstance.getConnector(id);
201198
System.out.println(result);
202199
} catch (ApiException e) {
203200
System.err.println("Exception when calling ConnectorsApi#getConnector");
@@ -216,7 +213,6 @@ public class Example {
216213
Name | Type | Description | Notes
217214
------------- | ------------- | ------------- | -------------
218215
**id** | **String**| The ID of record |
219-
**kafkaId** | **String**| The kafka cluster id | [optional]
220216

221217
### Return type
222218

@@ -243,7 +239,7 @@ Name | Type | Description | Notes
243239

244240
## listConnectors
245241

246-
> ConnectorList listConnectors(page, size, kafkaId)
242+
> ConnectorList listConnectors(page, size)
247243
248244
Returns a list of connector types
249245

@@ -272,9 +268,8 @@ public class Example {
272268
ConnectorsApi apiInstance = new ConnectorsApi(defaultClient);
273269
String page = "1"; // String | Page index
274270
String size = "100"; // String | Number of items in each page
275-
String kafkaId = "kafkaId_example"; // String | The kafka cluster id
276271
try {
277-
ConnectorList result = apiInstance.listConnectors(page, size, kafkaId);
272+
ConnectorList result = apiInstance.listConnectors(page, size);
278273
System.out.println(result);
279274
} catch (ApiException e) {
280275
System.err.println("Exception when calling ConnectorsApi#listConnectors");
@@ -294,7 +289,6 @@ Name | Type | Description | Notes
294289
------------- | ------------- | ------------- | -------------
295290
**page** | **String**| Page index | [optional]
296291
**size** | **String**| Number of items in each page | [optional]
297-
**kafkaId** | **String**| The kafka cluster id | [optional]
298292

299293
### Return type
300294

@@ -320,7 +314,7 @@ Name | Type | Description | Notes
320314

321315
## patchConnector
322316

323-
> Connector patchConnector(id, connectorRequest, kafkaId)
317+
> Connector patchConnector(id, body)
324318
325319
Patch a connector
326320

@@ -348,10 +342,9 @@ public class Example {
348342

349343
ConnectorsApi apiInstance = new ConnectorsApi(defaultClient);
350344
String id = "id_example"; // String | The ID of record
351-
ConnectorRequest connectorRequest = new ConnectorRequest(); // ConnectorRequest | Data to patch the connector with
352-
String kafkaId = "kafkaId_example"; // String | The kafka cluster id
345+
Object body = null; // Object | Data to patch the connector with
353346
try {
354-
Connector result = apiInstance.patchConnector(id, connectorRequest, kafkaId);
347+
Connector result = apiInstance.patchConnector(id, body);
355348
System.out.println(result);
356349
} catch (ApiException e) {
357350
System.err.println("Exception when calling ConnectorsApi#patchConnector");
@@ -370,8 +363,7 @@ public class Example {
370363
Name | Type | Description | Notes
371364
------------- | ------------- | ------------- | -------------
372365
**id** | **String**| The ID of record |
373-
**connectorRequest** | [**ConnectorRequest**](ConnectorRequest.md)| Data to patch the connector with |
374-
**kafkaId** | **String**| The kafka cluster id | [optional]
366+
**body** | **Object**| Data to patch the connector with |
375367

376368
### Return type
377369

@@ -383,7 +375,7 @@ Name | Type | Description | Notes
383375

384376
### HTTP request headers
385377

386-
- **Content-Type**: application/json, application/merge-patch+json, application/json-patch+json
378+
- **Content-Type**: application/merge-patch+json, application/json-patch+json, application/json
387379
- **Accept**: application/json
388380

389381

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
2+
3+
# ModelList
4+
5+
6+
## Properties
7+
8+
Name | Type | Description | Notes
9+
------------ | ------------- | ------------- | -------------
10+
**kind** | **String** | |
11+
**page** | **Integer** | |
12+
**size** | **Integer** | |
13+
**total** | **Integer** | |
14+
15+
16+

0 commit comments

Comments
 (0)