|
| 1 | +# ConfigApi |
| 2 | + |
| 3 | +All URIs are relative to *http://localhost/v1.41* |
| 4 | + |
| 5 | +Method | HTTP request | Description | Integration tests |
| 6 | +------------- | ------------- | ------------- | --- |
| 7 | +[**configCreate**](ConfigApi.md#configCreate) | **POST** /configs/create | Create a config | ✅ |
| 8 | +[**configDelete**](ConfigApi.md#configDelete) | **DELETE** /configs/{id} | Delete a config | ✅ |
| 9 | +[**configInspect**](ConfigApi.md#configInspect) | **GET** /configs/{id} | Inspect a config | ✅ |
| 10 | +[**configList**](ConfigApi.md#configList) | **GET** /configs | List configs | ✅ |
| 11 | +[**configUpdate**](ConfigApi.md#configUpdate) | **POST** /configs/{id}/update | Update a Config | ✅ |
| 12 | + |
| 13 | + |
| 14 | +<a name="configCreate"></a> |
| 15 | +# **configCreate** |
| 16 | +> IdResponse configCreate(body) |
| 17 | +
|
| 18 | +Create a config |
| 19 | + |
| 20 | +### Example |
| 21 | +```kotlin |
| 22 | +// Import classes: |
| 23 | +//import de.gesellix.docker.engine.client.infrastructure.* |
| 24 | +//import de.gesellix.docker.engine.model.* |
| 25 | + |
| 26 | +val apiInstance = ConfigApi() |
| 27 | +val body : UNKNOWN_BASE_TYPE = // UNKNOWN_BASE_TYPE | |
| 28 | +try { |
| 29 | + val result : IdResponse = apiInstance.configCreate(body) |
| 30 | + println(result) |
| 31 | +} catch (e: ClientException) { |
| 32 | + println("4xx response calling ConfigApi#configCreate") |
| 33 | + e.printStackTrace() |
| 34 | +} catch (e: ServerException) { |
| 35 | + println("5xx response calling ConfigApi#configCreate") |
| 36 | + e.printStackTrace() |
| 37 | +} |
| 38 | +``` |
| 39 | + |
| 40 | +### Parameters |
| 41 | + |
| 42 | +Name | Type | Description | Notes |
| 43 | +------------- | ------------- | ------------- | ------------- |
| 44 | + **body** | [**UNKNOWN_BASE_TYPE**](UNKNOWN_BASE_TYPE.md)| | [optional] |
| 45 | + |
| 46 | +### Return type |
| 47 | + |
| 48 | +[**IdResponse**](IdResponse.md) |
| 49 | + |
| 50 | +### Authorization |
| 51 | + |
| 52 | +No authorization required |
| 53 | + |
| 54 | +### HTTP request headers |
| 55 | + |
| 56 | + - **Content-Type**: application/json |
| 57 | + - **Accept**: application/json |
| 58 | + |
| 59 | +<a name="configDelete"></a> |
| 60 | +# **configDelete** |
| 61 | +> configDelete(id) |
| 62 | +
|
| 63 | +Delete a config |
| 64 | + |
| 65 | +### Example |
| 66 | +```kotlin |
| 67 | +// Import classes: |
| 68 | +//import de.gesellix.docker.engine.client.infrastructure.* |
| 69 | +//import de.gesellix.docker.engine.model.* |
| 70 | + |
| 71 | +val apiInstance = ConfigApi() |
| 72 | +val id : kotlin.String = id_example // kotlin.String | ID of the config |
| 73 | +try { |
| 74 | + apiInstance.configDelete(id) |
| 75 | +} catch (e: ClientException) { |
| 76 | + println("4xx response calling ConfigApi#configDelete") |
| 77 | + e.printStackTrace() |
| 78 | +} catch (e: ServerException) { |
| 79 | + println("5xx response calling ConfigApi#configDelete") |
| 80 | + e.printStackTrace() |
| 81 | +} |
| 82 | +``` |
| 83 | + |
| 84 | +### Parameters |
| 85 | + |
| 86 | +Name | Type | Description | Notes |
| 87 | +------------- | ------------- | ------------- | ------------- |
| 88 | + **id** | **kotlin.String**| ID of the config | |
| 89 | + |
| 90 | +### Return type |
| 91 | + |
| 92 | +null (empty response body) |
| 93 | + |
| 94 | +### Authorization |
| 95 | + |
| 96 | +No authorization required |
| 97 | + |
| 98 | +### HTTP request headers |
| 99 | + |
| 100 | + - **Content-Type**: Not defined |
| 101 | + - **Accept**: application/json |
| 102 | + |
| 103 | +<a name="configInspect"></a> |
| 104 | +# **configInspect** |
| 105 | +> Config configInspect(id) |
| 106 | +
|
| 107 | +Inspect a config |
| 108 | + |
| 109 | +### Example |
| 110 | +```kotlin |
| 111 | +// Import classes: |
| 112 | +//import de.gesellix.docker.engine.client.infrastructure.* |
| 113 | +//import de.gesellix.docker.engine.model.* |
| 114 | + |
| 115 | +val apiInstance = ConfigApi() |
| 116 | +val id : kotlin.String = id_example // kotlin.String | ID of the config |
| 117 | +try { |
| 118 | + val result : Config = apiInstance.configInspect(id) |
| 119 | + println(result) |
| 120 | +} catch (e: ClientException) { |
| 121 | + println("4xx response calling ConfigApi#configInspect") |
| 122 | + e.printStackTrace() |
| 123 | +} catch (e: ServerException) { |
| 124 | + println("5xx response calling ConfigApi#configInspect") |
| 125 | + e.printStackTrace() |
| 126 | +} |
| 127 | +``` |
| 128 | + |
| 129 | +### Parameters |
| 130 | + |
| 131 | +Name | Type | Description | Notes |
| 132 | +------------- | ------------- | ------------- | ------------- |
| 133 | + **id** | **kotlin.String**| ID of the config | |
| 134 | + |
| 135 | +### Return type |
| 136 | + |
| 137 | +[**Config**](Config.md) |
| 138 | + |
| 139 | +### Authorization |
| 140 | + |
| 141 | +No authorization required |
| 142 | + |
| 143 | +### HTTP request headers |
| 144 | + |
| 145 | + - **Content-Type**: Not defined |
| 146 | + - **Accept**: application/json |
| 147 | + |
| 148 | +<a name="configList"></a> |
| 149 | +# **configList** |
| 150 | +> kotlin.collections.List<Config> configList(filters) |
| 151 | +
|
| 152 | +List configs |
| 153 | + |
| 154 | +### Example |
| 155 | +```kotlin |
| 156 | +// Import classes: |
| 157 | +//import de.gesellix.docker.engine.client.infrastructure.* |
| 158 | +//import de.gesellix.docker.engine.model.* |
| 159 | + |
| 160 | +val apiInstance = ConfigApi() |
| 161 | +val filters : kotlin.String = filters_example // kotlin.String | A JSON encoded value of the filters (a `map[string][]string`) to process on the configs list. Available filters: - `id=<config id>` - `label=<key> or label=<key>=value` - `name=<config name>` - `names=<config name>` |
| 162 | +try { |
| 163 | + val result : kotlin.collections.List<Config> = apiInstance.configList(filters) |
| 164 | + println(result) |
| 165 | +} catch (e: ClientException) { |
| 166 | + println("4xx response calling ConfigApi#configList") |
| 167 | + e.printStackTrace() |
| 168 | +} catch (e: ServerException) { |
| 169 | + println("5xx response calling ConfigApi#configList") |
| 170 | + e.printStackTrace() |
| 171 | +} |
| 172 | +``` |
| 173 | + |
| 174 | +### Parameters |
| 175 | + |
| 176 | +Name | Type | Description | Notes |
| 177 | +------------- | ------------- | ------------- | ------------- |
| 178 | + **filters** | **kotlin.String**| A JSON encoded value of the filters (a `map[string][]string`) to process on the configs list. Available filters: - `id=<config id>` - `label=<key> or label=<key>=value` - `name=<config name>` - `names=<config name>` | [optional] |
| 179 | + |
| 180 | +### Return type |
| 181 | + |
| 182 | +[**kotlin.collections.List<Config>**](Config.md) |
| 183 | + |
| 184 | +### Authorization |
| 185 | + |
| 186 | +No authorization required |
| 187 | + |
| 188 | +### HTTP request headers |
| 189 | + |
| 190 | + - **Content-Type**: Not defined |
| 191 | + - **Accept**: application/json |
| 192 | + |
| 193 | +<a name="configUpdate"></a> |
| 194 | +# **configUpdate** |
| 195 | +> configUpdate(id, version, body) |
| 196 | +
|
| 197 | +Update a Config |
| 198 | + |
| 199 | +### Example |
| 200 | +```kotlin |
| 201 | +// Import classes: |
| 202 | +//import de.gesellix.docker.engine.client.infrastructure.* |
| 203 | +//import de.gesellix.docker.engine.model.* |
| 204 | + |
| 205 | +val apiInstance = ConfigApi() |
| 206 | +val id : kotlin.String = id_example // kotlin.String | The ID or name of the config |
| 207 | +val version : kotlin.Long = 789 // kotlin.Long | The version number of the config object being updated. This is required to avoid conflicting writes. |
| 208 | +val body : ConfigSpec = // ConfigSpec | The spec of the config to update. Currently, only the Labels field can be updated. All other fields must remain unchanged from the [ConfigInspect endpoint](#operation/ConfigInspect) response values. |
| 209 | +try { |
| 210 | + apiInstance.configUpdate(id, version, body) |
| 211 | +} catch (e: ClientException) { |
| 212 | + println("4xx response calling ConfigApi#configUpdate") |
| 213 | + e.printStackTrace() |
| 214 | +} catch (e: ServerException) { |
| 215 | + println("5xx response calling ConfigApi#configUpdate") |
| 216 | + e.printStackTrace() |
| 217 | +} |
| 218 | +``` |
| 219 | + |
| 220 | +### Parameters |
| 221 | + |
| 222 | +Name | Type | Description | Notes |
| 223 | +------------- | ------------- | ------------- | ------------- |
| 224 | + **id** | **kotlin.String**| The ID or name of the config | |
| 225 | + **version** | **kotlin.Long**| The version number of the config object being updated. This is required to avoid conflicting writes. | |
| 226 | + **body** | [**ConfigSpec**](ConfigSpec.md)| The spec of the config to update. Currently, only the Labels field can be updated. All other fields must remain unchanged from the [ConfigInspect endpoint](#operation/ConfigInspect) response values. | [optional] |
| 227 | + |
| 228 | +### Return type |
| 229 | + |
| 230 | +null (empty response body) |
| 231 | + |
| 232 | +### Authorization |
| 233 | + |
| 234 | +No authorization required |
| 235 | + |
| 236 | +### HTTP request headers |
| 237 | + |
| 238 | + - **Content-Type**: application/json, text/plain |
| 239 | + - **Accept**: application/json, text/plain |
| 240 | + |
0 commit comments