It is time to say goodbye: This version of Elastic Cloud Enterprise has reached end-of-life (EOL) and is no longer supported.

The documentation for this version is no longer being maintained. If you are running this version, we strongly advise you to upgrade. For the latest information, see the current release documentation.

« Get stack versions Delete stack version »
Elastic Docs ›Elastic Cloud Enterprise Reference [2.8] ›RESTful API ›API reference ›Stack - Versions - CRUD

Upload stack pack

edit

Upload stack pack

edit

Creates or updates an Elastic Stack pack and template. The endpoint supports multipart/form-data requests, as well as application/zip and application/octet-stream requests with a binary body. The maximum size of the payload is 1Mb. When the archive contains an Elastic Stack configuration that is available through the API, the configuration and template are overwritten.

Request

edit

POST /api/v1/stack/versions

Form Parameters

edit
Name Type Required Description

file

file

Y

Zip file that contains one or multiple stack configurations

Responses

edit
200

(StackVersionArchiveProcessingResult) The Elastic Stack pack successfully processed.

400

(StackVersionArchiveProcessingResult) * There is an error in the file. Choose a different file, then try again. (code: stackpack.bad_archive) * Some unexpected error occurred. (code: stackpack.unknown_internal_error)

Headers

x-cloud-error-codes (string; allowed values: [stackpack.bad_archive, stackpack.unknown_internal_error])
The error codes associated with the response

To perform this operation, you must be authenticated by means of one of the following methods: apiKey, basicAuth.

Request example

edit
curl -XPOST https://{{hostname}}/api/v1/stack/versions \
-H "Authorization: ApiKey $ECE_API_KEY" \
-H 'Content-Type: multipart/form-data'
« Get stack versions Delete stack version »