- Elastic Cloud Control - The Command-Line Interface for Elasticsearch Service and ECE:
- Overview
- Installing
- Configuring
- Usage examples
- Command reference
- ecctl
- ecctl auth
- ecctl auth key
- ecctl auth key create
- ecctl auth key delete
- ecctl auth key list
- ecctl auth key show
- ecctl comment
- ecctl comment create
- ecctl comment delete
- ecctl comment list
- ecctl comment show
- ecctl comment update
- ecctl deployment
- ecctl deployment create
- ecctl deployment delete
- ecctl deployment elasticsearch
- ecctl deployment elasticsearch keystore
- ecctl deployment elasticsearch keystore show
- ecctl deployment elasticsearch keystore update
- ecctl deployment extension
- ecctl deployment extension create
- ecctl deployment extension delete
- ecctl deployment extension list
- ecctl deployment extension show
- ecctl deployment extension update
- ecctl deployment list
- ecctl deployment plan
- ecctl deployment plan cancel
- ecctl deployment resource
- ecctl deployment resource delete
- ecctl deployment resource restore
- ecctl deployment resource shutdown
- ecctl deployment resource start-maintenance
- ecctl deployment resource start
- ecctl deployment resource stop-maintenance
- ecctl deployment resource stop
- ecctl deployment resource upgrade
- ecctl deployment restore
- ecctl deployment resync
- ecctl deployment search
- ecctl deployment show
- ecctl deployment shutdown
- ecctl deployment template
- ecctl deployment template create
- ecctl deployment template delete
- ecctl deployment template list
- ecctl deployment template show
- ecctl deployment template update
- ecctl deployment traffic-filter
- ecctl deployment traffic-filter association
- ecctl deployment traffic-filter association create
- ecctl deployment traffic-filter association delete
- ecctl deployment traffic-filter create
- ecctl deployment traffic-filter delete
- ecctl deployment traffic-filter list
- ecctl deployment traffic-filter show
- ecctl deployment traffic-filter update
- ecctl deployment update
- ecctl generate
- ecctl generate completions
- ecctl generate docs
- ecctl init
- ecctl platform
- ecctl platform allocator
- ecctl platform allocator list
- ecctl platform allocator maintenance
- ecctl platform allocator metadata
- ecctl platform allocator metadata delete
- ecctl platform allocator metadata set
- ecctl platform allocator metadata show
- ecctl platform allocator search
- ecctl platform allocator show
- ecctl platform allocator vacate
- ecctl platform constructor
- ecctl platform constructor list
- ecctl platform constructor maintenance
- ecctl platform constructor resync
- ecctl platform constructor show
- ecctl platform enrollment-token
- ecctl platform enrollment-token create
- ecctl platform enrollment-token delete
- ecctl platform enrollment-token list
- ecctl platform info
- ecctl platform instance-configuration
- ecctl platform instance-configuration create
- ecctl platform instance-configuration delete
- ecctl platform instance-configuration list
- ecctl platform instance-configuration pull
- ecctl platform instance-configuration show
- ecctl platform instance-configuration update
- ecctl platform proxy
- ecctl platform proxy filtered-group
- ecctl platform proxy filtered-group create
- ecctl platform proxy filtered-group delete
- ecctl platform proxy filtered-group list
- ecctl platform proxy filtered-group show
- ecctl platform proxy filtered-group update
- ecctl platform proxy list
- ecctl platform proxy settings
- ecctl platform proxy settings show
- ecctl platform proxy settings update
- ecctl platform proxy show
- ecctl platform repository
- ecctl platform repository create
- ecctl platform repository delete
- ecctl platform repository list
- ecctl platform repository show
- ecctl platform role
- ecctl platform role create
- ecctl platform role delete
- ecctl platform role list
- ecctl platform role show
- ecctl platform role update
- ecctl platform runner
- ecctl platform runner list
- ecctl platform runner resync
- ecctl platform runner search
- ecctl platform runner show
- ecctl stack
- ecctl stack delete
- ecctl stack list
- ecctl stack show
- ecctl stack upload
- ecctl user
- ecctl user create
- ecctl user delete
- ecctl user disable
- ecctl user enable
- ecctl user key
- ecctl user key delete
- ecctl user key list
- ecctl user key show
- ecctl user list
- ecctl user show
- ecctl user update
- ecctl version
- Contributing
- Release notes
ecctl platform allocator vacate
editecctl platform allocator vacate
editMoves all the resources from the specified allocator (Available for ECE only)
ecctl platform allocator vacate <allocator-id> [flags]
Examples
editecctl platform allocator vacate i-05e245252362f7f1d # Move everything from multiple allocators ecctl platform allocator vacate i-05e245252362f7f1d i-2362f7f1d252362f7 # filter by a resource kind ecctl platform allocator vacate -k kibana i-05e245252362f7f1d # Only move specific resource IDs ecctl platform allocator vacate -r f521dedb07194c478fbbc6624f3bbf8f -r f404eea372cc4ea5bd553d47a09705cd i-05e245252362f7f1d # Specify multiple allocator targets ecctl platform allocator vacate -t i-05e245252362f7f2d -t i-2362f7f1d252362f7 i-05e245252362f7f1d ecctl platform allocator vacate --target i-05e245252362f7f2d --target i-2362f7f1d252362f7 --kind kibana i-05e245252362f7f1d # Set the allocators to maintenance mode before vacating them ecctl platform allocator vacate --maintenance -t i-05e245252362f7f2d -t i-2362f7f1d252362f7 i-05e245252362f7f1d # Set the amount of maximum moves to happen at any time ecctl platform allocator vacate --concurrency 10 i-05e245252362f7f1d # Override the allocator health auto discovery ecctl platform allocator vacate --allocator-down=true i-05e245252362f7f1d # Override the skip_snapshot setting ecctl platform allocator vacate --skip-snapshot=true i-05e245252362f7f1d -r f521dedb07194c478fbbc6624f3bbf8f # Override the skip_data_migration setting ecctl platform allocator vacate --skip-data-migration=true i-05e245252362f7f1d -r f521dedb07194c478fbbc6624f3bbf8f # Skips tracking the vacate progress which will cause the command to return almost immediately. # Not recommended since it can lead to failed vacates without the operator knowing about them. ecctl platform allocator vacate --skip-tracking i-05e245252362f7f1d
Options
edit--allocator-down string Disables the allocator health auto-discovery, setting the allocator-down to either [true|false] --concurrency uint Maximum number of concurrent moves to perform at any time (default 8) -h, --help help for vacate -k, --kind string Kind of workload to vacate (elasticsearch|kibana|apm|appsearch|enterprise_search) -m, --maintenance Whether to set the allocator(s) in maintenance before performing the vacate --max-poll-retries int Optional maximum plan tracking retries (default 2) --move-only Keeps the resource in its current -possibly broken- state and just does the bare minimum to move the requested instances across to another allocator. [true|false] (default true) --override-failsafe If false (the default) then the plan will fail out if it believes the requested sequence of operations can result in data loss - this flag will override some of these restraints. [true|false] --poll-frequency duration Optional polling frequency to check for plan change updates (default 10s) -r, --resource-id strings Resource IDs to include in the vacate --skip-data-migration string Skips the data-migration operation on the specified resource IDs. ONLY available when the resource IDs are specified and --move-only is true. [true|false] --skip-snapshot string Skips the snapshot operation on the specified resource IDs. ONLY available when the resource IDs are specified. [true|false] --skip-tracking Skips tracking the vacate progress causing the command to return after the move operation has been executed. Not recommended. -t, --target strings Target allocator(s) on which to place the vacated workload
Options inherited from parent commands
edit--api-key string API key to use to authenticate (If empty will look for EC_API_KEY environment variable) --config string Config name, used to have multiple configs in $HOME/.ecctl/<env> (default "config") --force Do not ask for confirmation --format string Formats the output using a Go template --host string Base URL to use --insecure Skips all TLS validation --message string A message to set on cluster operation --output string Output format [text|json] (default "text") --pass string Password to use to authenticate (If empty will look for EC_PASS environment variable) --pprof Enables pprofing and saves the profile to pprof-20060102150405 -q, --quiet Suppresses the configuration file used for the run, if any --region string Elasticsearch Service region --timeout duration Timeout to use on all HTTP calls (default 30s) --trace Enables tracing saves the trace to trace-20060102150405 --user string Username to use to authenticate (If empty will look for EC_USER environment variable) --verbose Enable verbose mode --verbose-credentials When set, Authorization headers on the request/response trail will be displayed as plain text --verbose-file string When set, the verbose request/response trail will be written to the defined file
SEE ALSO
edit-
ecctl platform allocator - Manages allocators
(Available for ECE only)
Was this helpful?
Thank you for your feedback.