mirror of
https://github.com/elastic/kibana.git
synced 2025-04-25 02:09:32 -04:00
51e6a009ee
* Modify import APIs to handle special use cases from the previous import process * Cleanup * Add more examples to the docs * Make title come from data inside file * Fix some broken tests * Fix docs * Fix docs wording * Apply PR feedback pt1 * Apply PR feedback pt2
121 lines
4.2 KiB
Text
121 lines
4.2 KiB
Text
[[saved-objects-api-resolve-import-errors]]
|
|
=== Resolve Import Errors
|
|
|
|
experimental[This functionality is *experimental* and may be changed or removed completely in a future release.]
|
|
|
|
The resolve import errors API enables you to resolve errors given by the import API by either retrying certain saved objects, overwriting specific saved objects or changing references to different saved objects.
|
|
|
|
Note: You cannot access this endpoint via the Console in Kibana.
|
|
|
|
==== Request
|
|
|
|
`POST /api/saved_objects/_resolve_import_errors`
|
|
|
|
==== Request body
|
|
|
|
The request body must be of type multipart/form-data.
|
|
|
|
`file`::
|
|
The same file given to the import API.
|
|
|
|
`retries`::
|
|
(array) A list of `type`, `id`, `replaceReferences` and `overwrite` objects to retry importing. The property `replaceReferences` is a list of `type`, `from` and `to` used to change the object's references.
|
|
|
|
==== Response body
|
|
|
|
The response body will have a top level `success` property that indicates
|
|
if resolving errors was successful or not as well as a `successCount` indicating how many records are successfully resolved.
|
|
In the scenario resolving errors wasn't successful, a top level `errors` array will contain the objects that failed to be resolved.
|
|
|
|
==== Examples
|
|
|
|
The following example retries importing a dashboard.
|
|
|
|
[source,js]
|
|
--------------------------------------------------
|
|
POST api/saved_objects/_resolve_import_errors
|
|
Content-Type: multipart/form-data; boundary=EXAMPLE
|
|
--EXAMPLE
|
|
Content-Disposition: form-data; name="file"; filename="export.ndjson"
|
|
Content-Type: application/ndjson
|
|
|
|
{"type":"dashboard","id":"my-dashboard","attributes":{"title":"Look at my dashboard"}}
|
|
--EXAMPLE
|
|
Content-Disposition: form-data; name="retries"
|
|
|
|
[{"type":"dashboard","id":"my-dashboard"}]
|
|
--EXAMPLE--
|
|
--------------------------------------------------
|
|
// KIBANA
|
|
|
|
A successful call returns a response code of `200` and a response body
|
|
containing a JSON structure similar to the following example:
|
|
|
|
[source,js]
|
|
--------------------------------------------------
|
|
{
|
|
"success": true,
|
|
"successCount": 1
|
|
}
|
|
--------------------------------------------------
|
|
|
|
The following example resolves errors for a dashboard. This will cause the dashboard to overwrite the existing saved object.
|
|
|
|
[source,js]
|
|
--------------------------------------------------
|
|
POST api/saved_objects/_resolve_import_errors
|
|
Content-Type: multipart/form-data; boundary=EXAMPLE
|
|
--EXAMPLE
|
|
Content-Disposition: form-data; name="file"; filename="export.ndjson"
|
|
Content-Type: application/ndjson
|
|
|
|
{"type":"index-pattern","id":"my-pattern","attributes":{"title":"my-pattern-*"}}
|
|
{"type":"dashboard","id":"my-dashboard","attributes":{"title":"Look at my dashboard"}}
|
|
--EXAMPLE
|
|
Content-Disposition: form-data; name="retries"
|
|
|
|
[{"type":"dashboard","id":"my-dashboard","overwrite":true}]
|
|
--EXAMPLE--
|
|
--------------------------------------------------
|
|
// KIBANA
|
|
|
|
A successful call returns a response code of `200` and a response body
|
|
containing a JSON structure similar to the following example:
|
|
|
|
[source,js]
|
|
--------------------------------------------------
|
|
{
|
|
"success": true,
|
|
"successCount": 1
|
|
}
|
|
--------------------------------------------------
|
|
|
|
The following example resolves errors for a visualization by replacing the index pattern to another.
|
|
|
|
[source,js]
|
|
--------------------------------------------------
|
|
POST api/saved_objects/_resolve_import_errors
|
|
Content-Type: multipart/form-data; boundary=EXAMPLE
|
|
--EXAMPLE
|
|
Content-Disposition: form-data; name="file"; filename="export.ndjson"
|
|
Content-Type: application/ndjson
|
|
|
|
{"type":"visualization","id":"my-vis","attributes":{"title":"Look at my visualization"},"references":[{"name":"ref_0","type":"index-pattern","id":"missing"}]}
|
|
--EXAMPLE
|
|
Content-Disposition: form-data; name="retries"
|
|
|
|
[{"type":"visualization","id":"my-vis","replaceReferences":[{"type":"index-pattern","from":"missing","to":"existing"}]}]
|
|
--EXAMPLE--
|
|
--------------------------------------------------
|
|
// KIBANA
|
|
|
|
A successful call returns a response code of `200` and a response body
|
|
containing a JSON structure similar to the following example:
|
|
|
|
[source,js]
|
|
--------------------------------------------------
|
|
{
|
|
"success": true,
|
|
"successCount": 1
|
|
}
|
|
--------------------------------------------------
|