Skip to content

Commit 3b77ed9

Browse files
committed
✨ Automatic changes -> ✨ New server autogenerated files [ci skip]
1 parent b20d599 commit 3b77ed9

File tree

8 files changed

+359
-227
lines changed

8 files changed

+359
-227
lines changed

changes/20251119143814.feature

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
Updated client due to schema changes

client/README.md

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -141,10 +141,11 @@ Class | Method | HTTP request | Description
141141
*FPGAAdminAPI* | [**AddFPGAAdmin**](docs/FPGAAdminAPI.md#addfpgaadmin) | **Post** /fpga-admins | Add a user to the FPGA admin group
142142
*FPGAAdminAPI* | [**ListFPGAAdmins**](docs/FPGAAdminAPI.md#listfpgaadmins) | **Get** /fpga-admins | List all the members of the FPGA admin group
143143
*FPGAAdminAPI* | [**RemoveFPGAAdmin**](docs/FPGAAdminAPI.md#removefpgaadmin) | **Delete** /fpga-admins/{fpgaAdminName} | Remove a user from the FPGA admin group
144-
*FPGAConnectionAPI* | [**GetFpgaConnection**](docs/FPGAConnectionAPI.md#getfpgaconnection) | **Get** /fpga-connections/{connectionName} | Get connection information
144+
*FPGAConnectionAPI* | [**GetFpgaConnection**](docs/FPGAConnectionAPI.md#getfpgaconnection) | **Get** /fpga-connections/{fpgaName} | Get connection information
145145
*FPGAConnectionAPI* | [**ListFpgaConnections**](docs/FPGAConnectionAPI.md#listfpgaconnections) | **Get** /fpga-connections/ | List available FPGA connections.
146-
*FPGAConnectionAPI* | [**StartFpgaConnection**](docs/FPGAConnectionAPI.md#startfpgaconnection) | **Get** /fpga-connections/{connectionName}/connect | starts a websocket connection
147-
*FPGAConnectionAPI* | [**TerminateFpgaConnection**](docs/FPGAConnectionAPI.md#terminatefpgaconnection) | **Post** /fpga-connections/{connectionName}/terminate | Terminates all websocket connections to the application running on the FPGA
146+
*FPGAConnectionAPI* | [**StartFpgaConnection**](docs/FPGAConnectionAPI.md#startfpgaconnection) | **Get** /fpga-connections/{fpgaName}/job/{jobName}/connect | starts a websocket connection
147+
*FPGAConnectionAPI* | [**StartFpgaConnectionRegardlessOfJob**](docs/FPGAConnectionAPI.md#startfpgaconnectionregardlessofjob) | **Get** /fpga-connections/{fpgaName}/connect | starts a websocket connection
148+
*FPGAConnectionAPI* | [**TerminateFpgaConnection**](docs/FPGAConnectionAPI.md#terminatefpgaconnection) | **Post** /fpga-connections/{fpgaName}/terminate | Terminates all websocket connections to the application running on the FPGA
148149
*FPGAEntitlementsAPI* | [**GetFPGAEntitlement**](docs/FPGAEntitlementsAPI.md#getfpgaentitlement) | **Get** /fpga-entitlements/{fpgaEntitlementName} | Return details of specific FPGA entitlement.
149150
*FPGAEntitlementsAPI* | [**ListFPGAEntitlements**](docs/FPGAEntitlementsAPI.md#listfpgaentitlements) | **Get** /fpga-entitlements | List all the entitlements that are managable by the FPGA admin group.
150151
*FPGAEntitlementsAPI* | [**RemoveFPGAEntitlement**](docs/FPGAEntitlementsAPI.md#removefpgaentitlement) | **Delete** /fpga-entitlements/{fpgaEntitlementName} | Remove all the permissions associated with an FPGA entitlement

client/api_fpga_connection.go

Lines changed: 240 additions & 26 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

client/docs/FPGAConnectionAPI.md

Lines changed: 98 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -8,16 +8,17 @@ All URIs are relative to *https://all.api.keil.arm.com*
88

99
Method | HTTP request | Description
1010
------------- | ------------- | -------------
11-
[**GetFpgaConnection**](FPGAConnectionAPI.md#GetFpgaConnection) | **Get** /fpga-connections/{connectionName} | Get connection information
11+
[**GetFpgaConnection**](FPGAConnectionAPI.md#GetFpgaConnection) | **Get** /fpga-connections/{fpgaName} | Get connection information
1212
[**ListFpgaConnections**](FPGAConnectionAPI.md#ListFpgaConnections) | **Get** /fpga-connections/ | List available FPGA connections.
13-
[**StartFpgaConnection**](FPGAConnectionAPI.md#StartFpgaConnection) | **Get** /fpga-connections/{connectionName}/connect | starts a websocket connection
14-
[**TerminateFpgaConnection**](FPGAConnectionAPI.md#TerminateFpgaConnection) | **Post** /fpga-connections/{connectionName}/terminate | Terminates all websocket connections to the application running on the FPGA
13+
[**StartFpgaConnection**](FPGAConnectionAPI.md#StartFpgaConnection) | **Get** /fpga-connections/{fpgaName}/job/{jobName}/connect | starts a websocket connection
14+
[**StartFpgaConnectionRegardlessOfJob**](FPGAConnectionAPI.md#StartFpgaConnectionRegardlessOfJob) | **Get** /fpga-connections/{fpgaName}/connect | starts a websocket connection
15+
[**TerminateFpgaConnection**](FPGAConnectionAPI.md#TerminateFpgaConnection) | **Post** /fpga-connections/{fpgaName}/terminate | Terminates all websocket connections to the application running on the FPGA
1516

1617

1718

1819
## GetFpgaConnection
1920

20-
> FPGAConnectionItem GetFpgaConnection(ctx, connectionName).AcceptVersion(acceptVersion).Execute()
21+
> FPGAConnectionItem GetFpgaConnection(ctx, fpgaName).AcceptVersion(acceptVersion).Execute()
2122
2223
Get connection information
2324

@@ -36,12 +37,12 @@ import (
3637
)
3738

3839
func main() {
39-
connectionName := "connectionName_example" // string | The identifier of the connection
40+
fpgaName := "8b0c18e3-9330-485d-86fb-090dd9c435cb" // string | The FPGA to initiate an interactive session with
4041
acceptVersion := "1.0.0" // string | Versioning: Optional header to request a specific version of the API. While it is possible to specify a particular major, minor or patch version it is not recommended for production use cases. Only the major version number should be specified as minor and patch versions can be updated without warning. (optional)
4142

4243
configuration := openapiclient.NewConfiguration()
4344
apiClient := openapiclient.NewAPIClient(configuration)
44-
resp, r, err := apiClient.FPGAConnectionAPI.GetFpgaConnection(context.Background(), connectionName).AcceptVersion(acceptVersion).Execute()
45+
resp, r, err := apiClient.FPGAConnectionAPI.GetFpgaConnection(context.Background(), fpgaName).AcceptVersion(acceptVersion).Execute()
4546
if err != nil {
4647
fmt.Fprintf(os.Stderr, "Error when calling `FPGAConnectionAPI.GetFpgaConnection``: %v\n", err)
4748
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
@@ -57,7 +58,7 @@ func main() {
5758
Name | Type | Description | Notes
5859
------------- | ------------- | ------------- | -------------
5960
**ctx** | **context.Context** | context for authentication, logging, cancellation, deadlines, tracing, etc.
60-
**connectionName** | **string** | The identifier of the connection |
61+
**fpgaName** | **string** | The FPGA to initiate an interactive session with |
6162

6263
### Other Parameters
6364

@@ -163,7 +164,7 @@ Name | Type | Description | Notes
163164

164165
## StartFpgaConnection
165166

166-
> *os.File StartFpgaConnection(ctx, connectionName).Upgrade(upgrade).Connection(connection).SecWebSocketProtocol(secWebSocketProtocol).AcceptVersion(acceptVersion).Execute()
167+
> *os.File StartFpgaConnection(ctx, fpgaName, jobName).Connection(connection).Upgrade(upgrade).SecWebSocketProtocol(secWebSocketProtocol).AcceptVersion(acceptVersion).Execute()
167168
168169
starts a websocket connection
169170

@@ -182,15 +183,16 @@ import (
182183
)
183184

184185
func main() {
185-
connectionName := "connectionName_example" // string | The identifier of the connection
186-
upgrade := "upgrade_example" // string | Header used to upgrade an already-established client/server connection to a different protocol (https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Upgrade). It is for instance used when establishing a Websocket connection (https://en.wikipedia.org/wiki/WebSocket#Opening_handshake) (default to "WebSocket")
187186
connection := "connection_example" // string | Header controlling whether the network connection (https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Connection). It is for instance used when establishing a Websocket connection (https://en.wikipedia.org/wiki/WebSocket#Opening_handshake) (default to "Upgrade")
187+
fpgaName := "8b0c18e3-9330-485d-86fb-090dd9c435cb" // string | The FPGA to initiate an interactive session with
188+
jobName := "bb4605bb-c9af-4abf-b9c3-c6aac47b4ac8" // string | The interactive job this connection is associated with
189+
upgrade := "upgrade_example" // string | Header used to upgrade an already-established client/server connection to a different protocol (https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Upgrade). It is for instance used when establishing a Websocket connection (https://en.wikipedia.org/wiki/WebSocket#Opening_handshake) (default to "WebSocket")
188190
secWebSocketProtocol := "secWebSocketProtocol_example" // string | Header used to define a sub protocol to use in the communication (https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Sec-WebSocket-Protocol). It is for instance used when establishing a Websocket connection (https://en.wikipedia.org/wiki/WebSocket#Opening_handshake) (optional)
189191
acceptVersion := "1.0.0" // string | Versioning: Optional header to request a specific version of the API. While it is possible to specify a particular major, minor or patch version it is not recommended for production use cases. Only the major version number should be specified as minor and patch versions can be updated without warning. (optional)
190192

191193
configuration := openapiclient.NewConfiguration()
192194
apiClient := openapiclient.NewAPIClient(configuration)
193-
resp, r, err := apiClient.FPGAConnectionAPI.StartFpgaConnection(context.Background(), connectionName).Upgrade(upgrade).Connection(connection).SecWebSocketProtocol(secWebSocketProtocol).AcceptVersion(acceptVersion).Execute()
195+
resp, r, err := apiClient.FPGAConnectionAPI.StartFpgaConnection(context.Background(), fpgaName, jobName).Connection(connection).Upgrade(upgrade).SecWebSocketProtocol(secWebSocketProtocol).AcceptVersion(acceptVersion).Execute()
194196
if err != nil {
195197
fmt.Fprintf(os.Stderr, "Error when calling `FPGAConnectionAPI.StartFpgaConnection``: %v\n", err)
196198
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
@@ -206,7 +208,8 @@ func main() {
206208
Name | Type | Description | Notes
207209
------------- | ------------- | ------------- | -------------
208210
**ctx** | **context.Context** | context for authentication, logging, cancellation, deadlines, tracing, etc.
209-
**connectionName** | **string** | The identifier of the connection |
211+
**fpgaName** | **string** | The FPGA to initiate an interactive session with |
212+
**jobName** | **string** | The interactive job this connection is associated with |
210213

211214
### Other Parameters
212215

@@ -215,9 +218,88 @@ Other parameters are passed through a pointer to a apiStartFpgaConnectionRequest
215218

216219
Name | Type | Description | Notes
217220
------------- | ------------- | ------------- | -------------
221+
**connection** | **string** | Header controlling whether the network connection (https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Connection). It is for instance used when establishing a Websocket connection (https://en.wikipedia.org/wiki/WebSocket#Opening_handshake) | [default to "Upgrade"]
222+
218223

219224
**upgrade** | **string** | Header used to upgrade an already-established client/server connection to a different protocol (https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Upgrade). It is for instance used when establishing a Websocket connection (https://en.wikipedia.org/wiki/WebSocket#Opening_handshake) | [default to "WebSocket"]
225+
**secWebSocketProtocol** | **string** | Header used to define a sub protocol to use in the communication (https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Sec-WebSocket-Protocol). It is for instance used when establishing a Websocket connection (https://en.wikipedia.org/wiki/WebSocket#Opening_handshake) |
226+
**acceptVersion** | **string** | Versioning: Optional header to request a specific version of the API. While it is possible to specify a particular major, minor or patch version it is not recommended for production use cases. Only the major version number should be specified as minor and patch versions can be updated without warning. |
227+
228+
### Return type
229+
230+
[***os.File**](*os.File.md)
231+
232+
### Authorization
233+
234+
[TokenAuth](../README.md#TokenAuth)
235+
236+
### HTTP request headers
237+
238+
- **Content-Type**: Not defined
239+
- **Accept**: text/plain, application/json
240+
241+
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints)
242+
[[Back to Model list]](../README.md#documentation-for-models)
243+
[[Back to README]](../README.md)
244+
245+
246+
## StartFpgaConnectionRegardlessOfJob
247+
248+
> *os.File StartFpgaConnectionRegardlessOfJob(ctx, fpgaName).Connection(connection).Upgrade(upgrade).SecWebSocketProtocol(secWebSocketProtocol).AcceptVersion(acceptVersion).Execute()
249+
250+
starts a websocket connection
251+
252+
253+
254+
### Example
255+
256+
```go
257+
package main
258+
259+
import (
260+
"context"
261+
"fmt"
262+
"os"
263+
openapiclient "github.com/ARM-software/embedded-development-services-client/client"
264+
)
265+
266+
func main() {
267+
connection := "connection_example" // string | Header controlling whether the network connection (https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Connection). It is for instance used when establishing a Websocket connection (https://en.wikipedia.org/wiki/WebSocket#Opening_handshake) (default to "Upgrade")
268+
fpgaName := "8b0c18e3-9330-485d-86fb-090dd9c435cb" // string | The FPGA to initiate an interactive session with
269+
upgrade := "upgrade_example" // string | Header used to upgrade an already-established client/server connection to a different protocol (https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Upgrade). It is for instance used when establishing a Websocket connection (https://en.wikipedia.org/wiki/WebSocket#Opening_handshake) (default to "WebSocket")
270+
secWebSocketProtocol := "secWebSocketProtocol_example" // string | Header used to define a sub protocol to use in the communication (https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Sec-WebSocket-Protocol). It is for instance used when establishing a Websocket connection (https://en.wikipedia.org/wiki/WebSocket#Opening_handshake) (optional)
271+
acceptVersion := "1.0.0" // string | Versioning: Optional header to request a specific version of the API. While it is possible to specify a particular major, minor or patch version it is not recommended for production use cases. Only the major version number should be specified as minor and patch versions can be updated without warning. (optional)
272+
273+
configuration := openapiclient.NewConfiguration()
274+
apiClient := openapiclient.NewAPIClient(configuration)
275+
resp, r, err := apiClient.FPGAConnectionAPI.StartFpgaConnectionRegardlessOfJob(context.Background(), fpgaName).Connection(connection).Upgrade(upgrade).SecWebSocketProtocol(secWebSocketProtocol).AcceptVersion(acceptVersion).Execute()
276+
if err != nil {
277+
fmt.Fprintf(os.Stderr, "Error when calling `FPGAConnectionAPI.StartFpgaConnectionRegardlessOfJob``: %v\n", err)
278+
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
279+
}
280+
// response from `StartFpgaConnectionRegardlessOfJob`: *os.File
281+
fmt.Fprintf(os.Stdout, "Response from `FPGAConnectionAPI.StartFpgaConnectionRegardlessOfJob`: %v\n", resp)
282+
}
283+
```
284+
285+
### Path Parameters
286+
287+
288+
Name | Type | Description | Notes
289+
------------- | ------------- | ------------- | -------------
290+
**ctx** | **context.Context** | context for authentication, logging, cancellation, deadlines, tracing, etc.
291+
**fpgaName** | **string** | The FPGA to initiate an interactive session with |
292+
293+
### Other Parameters
294+
295+
Other parameters are passed through a pointer to a apiStartFpgaConnectionRegardlessOfJobRequest struct via the builder pattern
296+
297+
298+
Name | Type | Description | Notes
299+
------------- | ------------- | ------------- | -------------
220300
**connection** | **string** | Header controlling whether the network connection (https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Connection). It is for instance used when establishing a Websocket connection (https://en.wikipedia.org/wiki/WebSocket#Opening_handshake) | [default to "Upgrade"]
301+
302+
**upgrade** | **string** | Header used to upgrade an already-established client/server connection to a different protocol (https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Upgrade). It is for instance used when establishing a Websocket connection (https://en.wikipedia.org/wiki/WebSocket#Opening_handshake) | [default to "WebSocket"]
221303
**secWebSocketProtocol** | **string** | Header used to define a sub protocol to use in the communication (https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Sec-WebSocket-Protocol). It is for instance used when establishing a Websocket connection (https://en.wikipedia.org/wiki/WebSocket#Opening_handshake) |
222304
**acceptVersion** | **string** | Versioning: Optional header to request a specific version of the API. While it is possible to specify a particular major, minor or patch version it is not recommended for production use cases. Only the major version number should be specified as minor and patch versions can be updated without warning. |
223305

@@ -241,7 +323,7 @@ Name | Type | Description | Notes
241323

242324
## TerminateFpgaConnection
243325

244-
> FPGAConnectionItem TerminateFpgaConnection(ctx, connectionName).AcceptVersion(acceptVersion).Execute()
326+
> FPGAConnectionItem TerminateFpgaConnection(ctx, fpgaName).AcceptVersion(acceptVersion).Execute()
245327
246328
Terminates all websocket connections to the application running on the FPGA
247329

@@ -260,12 +342,12 @@ import (
260342
)
261343

262344
func main() {
263-
connectionName := "connectionName_example" // string | The identifier of the connection
345+
fpgaName := "8b0c18e3-9330-485d-86fb-090dd9c435cb" // string | The FPGA to initiate an interactive session with
264346
acceptVersion := "1.0.0" // string | Versioning: Optional header to request a specific version of the API. While it is possible to specify a particular major, minor or patch version it is not recommended for production use cases. Only the major version number should be specified as minor and patch versions can be updated without warning. (optional)
265347

266348
configuration := openapiclient.NewConfiguration()
267349
apiClient := openapiclient.NewAPIClient(configuration)
268-
resp, r, err := apiClient.FPGAConnectionAPI.TerminateFpgaConnection(context.Background(), connectionName).AcceptVersion(acceptVersion).Execute()
350+
resp, r, err := apiClient.FPGAConnectionAPI.TerminateFpgaConnection(context.Background(), fpgaName).AcceptVersion(acceptVersion).Execute()
269351
if err != nil {
270352
fmt.Fprintf(os.Stderr, "Error when calling `FPGAConnectionAPI.TerminateFpgaConnection``: %v\n", err)
271353
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
@@ -281,7 +363,7 @@ func main() {
281363
Name | Type | Description | Notes
282364
------------- | ------------- | ------------- | -------------
283365
**ctx** | **context.Context** | context for authentication, logging, cancellation, deadlines, tracing, etc.
284-
**connectionName** | **string** | The identifier of the connection |
366+
**fpgaName** | **string** | The FPGA to initiate an interactive session with |
285367

286368
### Other Parameters
287369

0 commit comments

Comments
 (0)