Migrate a single agent

POST /api/fleet/agents/{agentId}/migrate
Api key auth Basic auth

Spaces method and path for this operation:

post /s/{space_id}/api/fleet/agents/{agentId}/migrate

Refer to Spaces for more information.

Migrate a single agent to another cluster.

[Required authorization] Route required privileges: fleet-agents-all.

Headers

  • kbn-xsrf string Required

    A required header to protect against CSRF attacks

Path parameters

  • agentId string Required

    The agent ID

application/json

Body

  • enrollment_token string Required
  • settings object

    Additional properties are NOT allowed.

    Hide settings attributes Show settings attributes object
    • ca_sha256 string
    • certificate_authorities string
    • elastic_agent_cert string
    • elastic_agent_cert_key string
    • elastic_agent_cert_key_passphrase string
    • headers object
      Hide headers attribute Show headers attribute object
      • * string Additional properties
    • insecure boolean
    • proxy_disabled boolean
    • proxy_headers object
      Hide proxy_headers attribute Show proxy_headers attribute object
      • * string Additional properties
    • proxy_url string
    • replace_token string
    • staging string
    • tags array[string]

      Not more than 10 elements.

  • uri string(uri) Required

Responses

  • 200 application/json

    Successful response

    Hide response attribute Show response attribute object
    • actionId string Required
  • 400 application/json

    Bad Request

    Hide response attributes Show response attributes object
    • error string
    • errorType string
    • message string Required
    • statusCode number
POST /api/fleet/agents/{agentId}/migrate 
curl \
 --request POST 'https://localhost:5601/api/fleet/agents/{agentId}/migrate' \
 --header "Authorization: $API_KEY" \
 --header "Content-Type: application/json" \
 --header "kbn-xsrf: true" \
 --data '"{\n  \"enrollment_token\": \"enrollment-token-value\",\n  \"settings\": {\n    \"retry_max\": 5\n  },\n  \"uri\": \"https://fleet-server.example.com:8220\"\n}"'
Request example
Migrate a single agent to another cluster 
{
  "enrollment_token": "enrollment-token-value",
  "settings": {
    "retry_max": 5
  },
  "uri": "https://fleet-server.example.com:8220"
}
Response examples (200)
Agent migration initiated 
{
  "actionId": "action-id-1"
}
Response examples (400)
Example of a generic error response 
{
  "error": "Bad Request",
  "message": "An error message describing what went wrong",
  "statusCode": 400
}