This endpoint is available from version 2.1.0^.
THIS ENDPOINT IS STILL UNDER DEVELOPMENT.
Import functionality for stages, pipelines, endpoints and configuration files.
You can set the overwriting capabilities from the config file inside the "IMPORT/EXPORT" section. If enabled, then all the files coming from the .gea file will overwrite the old ones inside the API instance.
'import_export': { 'enable': True, 'import_overwrite': False }
This endpoint allows you to import files exported from another GAIA API instance.
Parameter | Type | Description |
---|---|---|
file | file | The .gea file to import, can be a stage, pipeline, endpoint or all files. |
overwrite | string | If you want to overwrite files at the time of importing. (OPTIONAL) |
The Parameters above needs to be part of a form (form-data), otherwise, the operation will fail.
IMPORTANT
If you use this endpoint, after importing the .gea file, you need to RESTART the API in order to load the new files that were imported, so, if you have requests pending or it is being used at the moment, wait for those processes to end and restart the server using the Shutdown Endpoint.
POST /es/api/v1/_import
Import successful
{ "detail": [ { "loc": ["body", "file"], "msg": "Field required", "type": "value_error.missing" } ] }
Export functionality for stages, pipelines, endpoints and configuration files.
We create .gea files in memory with all the files requested to export.
These .gea files may or may not have nested .gea files representing nested stages or pipelines related between each other.
After the .geas are completed the compressed file is returned as a stream of data in the response of the endpoint request. You may need to save that stream as a file afterwards.
This endpoint allows you to export all stages, pipelines, endpoints enabled and configuration files into a .gea file that can be imported into another instance of GAIA API.
This endpoint does not require parameters.
GET /es/api/v1/export/all
Export successful
This endpoint allows you to export all the stages into a .gea file.
This endpoint does not require parameters.
GET /es/api/v1/export/stage/all
Export successful
This endpoint allows you to export a specific stage into a .gea file by its name.
Parameter | Type | Description |
---|---|---|
stage_name | string | The name of the stage to export. |
GET /es/api/v1/export/stage/{stage_name}
Export successful
This endpoint allows you to export all the pipelines into a .gea file with its own stages (if the pipeline has stages configured).
This endpoint does not require parameters.
GET /es/api/v1/export/pipeline/all
Export successful
This endpoint allows you to export a specific pipeline into a .gea file by its name alongside its stages configured (if it has stages).
Parameter | Type | Description |
---|---|---|
pipeline_name | string | The name of the pipeline to export. |
GET /es/api/v1/export/pipeline/{pipeline_name}
Export successful
This endpoint allows you to export all the endpoints into a .gea file with its own pipelines and stages (if the endpoint has a pipeline wrapper configured).
This endpoint does not require parameters.
GET /es/api/v1/export/endpoint/all
Export successful
This endpoint allows you to export a specific endpoint into a .gea file by its name alongside its pipeline/stages configured (if it has a pipeline wrapper).
Parameter | Type | Description |
---|---|---|
endpoint_name | string | The name of the endpoint to export. |
GET /es/api/v1/export/endpoint/{endpoint_name}
Export successful
This endpoint allows you to export all config files into a .gea file (exluding pipelines and files not needed to start the server).
This endpoint does not require parameters.
Example
GET /es/api/v1/export/config
Export successful