During Public Preview you can use the Team plan for free, and get an early-adopter discount at GA. Sign in
locally chaos virtualmachines
This page is part of the CLI Reference and is generated from the CLI's own help output, so it matches what locally chaos virtualmachines --help prints.
For more information see Chaos Engineering and Virtual Machines Emulator.
locally chaos virtualmachines
Simulate Virtual Machines (data plane) failure modes.
Simulate Virtual Machines (data plane) failure modes. A fault command sets the fault's rate. With a scope flag (--location / --name) it adds or edits a rule instead. Examples: locally chaos virtualmachines <fault> --percentage N locally chaos virtualmachines <fault> reset locally chaos virtualmachines show locally chaos virtualmachines reset
Usage
locally chaos virtualmachines [flags] locally chaos virtualmachines [command]
Flags
-h, --help[=true|false] help for virtualmachines
Subcommands
- locally chaos virtualmachines disconnect - Close live connections cleanly, in the protocol's own terms, so the client has to reconnect.
- locally chaos virtualmachines drop-connection - Close the connection without answering.
- locally chaos virtualmachines exit - Kill virtual machines on a schedule, as a host crash would.
- locally chaos virtualmachines freeze - Pause virtual machines on a schedule.
- locally chaos virtualmachines latency - Hold requests for a random delay before they are handled.
- locally chaos virtualmachines outage - Fail requests for as long as the rule is armed, like a region or service that is down.
- locally chaos virtualmachines reset - Zero every Virtual Machines (data plane) fault and drop every rule.
- locally chaos virtualmachines restart - Restart virtual machines on a schedule.
- locally chaos virtualmachines show - Print the current Virtual Machines (data plane) chaos configuration.
locally chaos virtualmachines disconnect
Close live connections cleanly, in the protocol's own terms, so the client has to reconnect.
Close live connections cleanly, in the protocol's own terms, so the client has to reconnect. Every interval each open connection is rolled for. Compare drop-connection, which cuts them with nothing said. Without scope flags this sets the fault's rate on Virtual Machines (data plane). With --location / --name it adds or edits one rule, leaving the rate and other rules alone. A rule can be lower than the rate: "everywhere except one place" is a rate of 100 plus a rule at 0. --name acct1 matches that resource in any resource group; --name rg1/acct1 matches only rg1's. --interval is how often the fault starts, such as 10m. It is required whenever the fault fires: nothing else sets it off. A value flag left out keeps what the row already has; a new rule starts with none. 'reset' clears a row. Examples: locally chaos virtualmachines disconnect --percentage 25 --interval 10m locally chaos virtualmachines disconnect --percentage 100 --interval 10m --location london locally chaos virtualmachines disconnect reset --location london locally chaos virtualmachines disconnect --percentage 100 --interval 10m --name acct1
Usage
locally chaos virtualmachines disconnect [flags] locally chaos virtualmachines disconnect [command]
Flags
-h, --help[=true|false] help for disconnect
--interval string How often this fault rolls for each resource, e.g. 10m; the first roll lands at a random point within the first interval (required when it fires)
--location string Scope this rule to one location, e.g. london
--name string Scope this rule to one resource by name, e.g. acct1, or rg1/acct1 for one resource group's
--percentage int How often this fault fires, 0-100 (required)
--subscription string Subscription UUID (defaults to the configured default)
Subcommands
- locally chaos virtualmachines disconnect reset - Remove one disconnect rule, or put the whole fault back to zero.
locally chaos virtualmachines disconnect reset
Remove one disconnect rule, or put the whole fault back to zero.
Reset the disconnect fault. With a scope flag, removes that rule so those requests use the fault's rate. Without one, removes every rule and sets the rate to 0. 'reset --location X' removes the rule; '--percentage 0 --location X' keeps a rule that never fires, which is how to say "everywhere except X".
Usage
locally chaos virtualmachines disconnect reset [flags]
Flags
-h, --help[=true|false] help for reset
--location string Scope this rule to one location, e.g. london
--name string Scope this rule to one resource by name, e.g. acct1, or rg1/acct1 for one resource group's
--subscription string Subscription UUID (defaults to the configured default)
locally chaos virtualmachines drop-connection
Close the connection without answering.
Close the connection without answering. The client sees the connection reset, with no status code or error body. With --interval it also cuts live connections: every interval each is rolled for, and on a hit it is reset with nothing said - no close frame or goodbye. For a clean close, use disconnect. Without scope flags this sets the fault's rate on Virtual Machines (data plane). With --location / --name it adds or edits one rule, leaving the rate and other rules alone. A rule can be lower than the rate: "everywhere except one place" is a rate of 100 plus a rule at 0. --name acct1 matches that resource in any resource group; --name rg1/acct1 matches only rg1's. --interval adds periodic action on live connections, such as every 30s, to the fault's per-request behaviour, which carries on as before. For periodic cuts with no per-request drops, arm disconnect instead. A value flag left out keeps what the row already has; a new rule starts with none. 'reset' clears a row. Examples: locally chaos virtualmachines drop-connection --percentage 25 locally chaos virtualmachines drop-connection --percentage 25 --interval 30s locally chaos virtualmachines drop-connection --percentage 100 --location london locally chaos virtualmachines drop-connection reset --location london locally chaos virtualmachines drop-connection --percentage 100 --name acct1
Usage
locally chaos virtualmachines drop-connection [flags] locally chaos virtualmachines drop-connection [command]
Flags
-h, --help[=true|false] help for drop-connection
--interval string Also act on live connections this often, e.g. 30s or 10m (adds to the per-request fault; use disconnect for periodic cuts only)
--location string Scope this rule to one location, e.g. london
--name string Scope this rule to one resource by name, e.g. acct1, or rg1/acct1 for one resource group's
--percentage int How often this fault fires, 0-100 (required)
--subscription string Subscription UUID (defaults to the configured default)
Subcommands
- locally chaos virtualmachines drop-connection reset - Remove one drop-connection rule, or put the whole fault back to zero.
locally chaos virtualmachines drop-connection reset
Remove one drop-connection rule, or put the whole fault back to zero.
Reset the drop-connection fault. With a scope flag, removes that rule so those requests use the fault's rate. Without one, removes every rule and sets the rate to 0. 'reset --location X' removes the rule; '--percentage 0 --location X' keeps a rule that never fires, which is how to say "everywhere except X".
Usage
locally chaos virtualmachines drop-connection reset [flags]
Flags
-h, --help[=true|false] help for reset
--location string Scope this rule to one location, e.g. london
--name string Scope this rule to one resource by name, e.g. acct1, or rg1/acct1 for one resource group's
--subscription string Subscription UUID (defaults to the configured default)
locally chaos virtualmachines exit
Kill virtual machines on a schedule, as a host crash would.
Kill virtual machines on a schedule, as a host crash would. Every interval each VM is rolled for; on a hit its guest is killed outright, with no shutdown. Without scope flags this sets the fault's rate on Virtual Machines (data plane). With --location / --name it adds or edits one rule, leaving the rate and other rules alone. A rule can be lower than the rate: "everywhere except one place" is a rate of 100 plus a rule at 0. --name acct1 matches that resource in any resource group; --name rg1/acct1 matches only rg1's. --interval is how often the fault starts, such as 10m. It is required whenever the fault fires: nothing else sets it off. A value flag left out keeps what the row already has; a new rule starts with none. 'reset' clears a row. Examples: locally chaos virtualmachines exit --percentage 25 --interval 10m locally chaos virtualmachines exit --percentage 100 --interval 10m --location london locally chaos virtualmachines exit reset --location london locally chaos virtualmachines exit --percentage 100 --interval 10m --name acct1
Usage
locally chaos virtualmachines exit [flags] locally chaos virtualmachines exit [command]
Flags
-h, --help[=true|false] help for exit
--interval string How often this fault rolls for each resource, e.g. 10m; the first roll lands at a random point within the first interval (required when it fires)
--location string Scope this rule to one location, e.g. london
--name string Scope this rule to one resource by name, e.g. acct1, or rg1/acct1 for one resource group's
--percentage int How often this fault fires, 0-100 (required)
--subscription string Subscription UUID (defaults to the configured default)
Subcommands
- locally chaos virtualmachines exit reset - Remove one exit rule, or put the whole fault back to zero.
locally chaos virtualmachines exit reset
Remove one exit rule, or put the whole fault back to zero.
Reset the exit fault. With a scope flag, removes that rule so those requests use the fault's rate. Without one, removes every rule and sets the rate to 0. 'reset --location X' removes the rule; '--percentage 0 --location X' keeps a rule that never fires, which is how to say "everywhere except X".
Usage
locally chaos virtualmachines exit reset [flags]
Flags
-h, --help[=true|false] help for reset
--location string Scope this rule to one location, e.g. london
--name string Scope this rule to one resource by name, e.g. acct1, or rg1/acct1 for one resource group's
--subscription string Subscription UUID (defaults to the configured default)
locally chaos virtualmachines freeze
Pause virtual machines on a schedule.
Pause virtual machines on a schedule. Every interval each VM is rolled for; on a hit its guest is paused for the rolled duration, then unpaused. Nothing is closed, so open sessions just go quiet. Without scope flags this sets the fault's rate on Virtual Machines (data plane). With --location / --name it adds or edits one rule, leaving the rate and other rules alone. A rule can be lower than the rate: "everywhere except one place" is a rate of 100 plus a rule at 0. --name acct1 matches that resource in any resource group; --name rg1/acct1 matches only rg1's. --seconds and --millis set the duration. A bare number is in the flag's unit; one with its own suffix, such as 250ms or 1.5s, means what it says. One value N picks 0 to N each time; MIN-MAX, such as 30-120, picks within that range. A duration is required whenever the fault fires. --interval is how often the fault starts, such as 10m. It is required whenever the fault fires: nothing else sets it off. A value flag left out keeps what the row already has; a new rule starts with none. 'reset' clears a row. Examples: locally chaos virtualmachines freeze --percentage 25 --seconds 30-120 --interval 10m locally chaos virtualmachines freeze --percentage 100 --seconds 30-120 --interval 10m --location london locally chaos virtualmachines freeze reset --location london locally chaos virtualmachines freeze --percentage 100 --seconds 30-120 --interval 10m --name acct1
Usage
locally chaos virtualmachines freeze [flags] locally chaos virtualmachines freeze [command]
Flags
-h, --help[=true|false] help for freeze
--interval string How often this fault rolls for each resource, e.g. 10m; the first roll lands at a random point within the first interval (required when it fires)
--location string Scope this rule to one location, e.g. london
--millis string Duration in milliseconds, e.g. 250; N for 0 to N, or MIN-MAX for a range
--name string Scope this rule to one resource by name, e.g. acct1, or rg1/acct1 for one resource group's
--percentage int How often this fault fires, 0-100 (required)
--seconds string Duration in seconds, e.g. 30 or 1.5; N for 0 to N, or MIN-MAX for a range
--subscription string Subscription UUID (defaults to the configured default)
Subcommands
- locally chaos virtualmachines freeze reset - Remove one freeze rule, or put the whole fault back to zero.
locally chaos virtualmachines freeze reset
Remove one freeze rule, or put the whole fault back to zero.
Reset the freeze fault. With a scope flag, removes that rule so those requests use the fault's rate. Without one, removes every rule and sets the rate to 0. 'reset --location X' removes the rule; '--percentage 0 --location X' keeps a rule that never fires, which is how to say "everywhere except X".
Usage
locally chaos virtualmachines freeze reset [flags]
Flags
-h, --help[=true|false] help for reset
--location string Scope this rule to one location, e.g. london
--name string Scope this rule to one resource by name, e.g. acct1, or rg1/acct1 for one resource group's
--subscription string Subscription UUID (defaults to the configured default)
locally chaos virtualmachines latency
Hold requests for a random delay before they are handled.
Hold requests for a random delay before they are handled. The response is unchanged, just late. Without scope flags this sets the fault's rate on Virtual Machines (data plane). With --location / --name it adds or edits one rule, leaving the rate and other rules alone. A rule can be lower than the rate: "everywhere except one place" is a rate of 100 plus a rule at 0. --name acct1 matches that resource in any resource group; --name rg1/acct1 matches only rg1's. --seconds and --millis set the duration. A bare number is in the flag's unit; one with its own suffix, such as 250ms or 1.5s, means what it says. The value is a maximum: each firing picks 0 to N. A duration is required whenever the fault fires. A value flag left out keeps what the row already has; a new rule starts with none. 'reset' clears a row. Examples: locally chaos virtualmachines latency --percentage 25 --seconds 30 locally chaos virtualmachines latency --percentage 100 --seconds 30 --location london locally chaos virtualmachines latency reset --location london locally chaos virtualmachines latency --percentage 100 --seconds 30 --name acct1
Usage
locally chaos virtualmachines latency [flags] locally chaos virtualmachines latency [command]
Flags
-h, --help[=true|false] help for latency
--location string Scope this rule to one location, e.g. london
--millis string Duration in milliseconds, e.g. 250; the maximum: each firing picks 0 to N
--name string Scope this rule to one resource by name, e.g. acct1, or rg1/acct1 for one resource group's
--percentage int How often this fault fires, 0-100 (required)
--seconds string Duration in seconds, e.g. 30 or 1.5; the maximum: each firing picks 0 to N
--subscription string Subscription UUID (defaults to the configured default)
Subcommands
- locally chaos virtualmachines latency reset - Remove one latency rule, or put the whole fault back to zero.
locally chaos virtualmachines latency reset
Remove one latency rule, or put the whole fault back to zero.
Reset the latency fault. With a scope flag, removes that rule so those requests use the fault's rate. Without one, removes every rule and sets the rate to 0. 'reset --location X' removes the rule; '--percentage 0 --location X' keeps a rule that never fires, which is how to say "everywhere except X".
Usage
locally chaos virtualmachines latency reset [flags]
Flags
-h, --help[=true|false] help for reset
--location string Scope this rule to one location, e.g. london
--name string Scope this rule to one resource by name, e.g. acct1, or rg1/acct1 for one resource group's
--subscription string Subscription UUID (defaults to the configured default)
locally chaos virtualmachines outage
Fail requests for as long as the rule is armed, like a region or service that is down.
Fail requests for as long as the rule is armed, like a region or service that is down. Each request rolls against the percentage, so at 100 every request fails until the fault is turned off. Each service answers in its own terms, usually 503 Service Unavailable, and a protocol with live connections also closes the ones open when the outage starts. For downtime that ends by itself, see incident. Without scope flags this sets the fault's rate on Virtual Machines (data plane). With --location / --name it adds or edits one rule, leaving the rate and other rules alone. A rule can be lower than the rate: "everywhere except one place" is a rate of 100 plus a rule at 0. --name acct1 matches that resource in any resource group; --name rg1/acct1 matches only rg1's. Examples: locally chaos virtualmachines outage --percentage 25 locally chaos virtualmachines outage --percentage 100 --location london locally chaos virtualmachines outage reset --location london locally chaos virtualmachines outage --percentage 100 --name acct1
Usage
locally chaos virtualmachines outage [flags] locally chaos virtualmachines outage [command]
Flags
-h, --help[=true|false] help for outage
--location string Scope this rule to one location, e.g. london
--name string Scope this rule to one resource by name, e.g. acct1, or rg1/acct1 for one resource group's
--percentage int How often this fault fires, 0-100 (required)
--subscription string Subscription UUID (defaults to the configured default)
Subcommands
- locally chaos virtualmachines outage reset - Remove one outage rule, or put the whole fault back to zero.
locally chaos virtualmachines outage reset
Remove one outage rule, or put the whole fault back to zero.
Reset the outage fault. With a scope flag, removes that rule so those requests use the fault's rate. Without one, removes every rule and sets the rate to 0. 'reset --location X' removes the rule; '--percentage 0 --location X' keeps a rule that never fires, which is how to say "everywhere except X".
Usage
locally chaos virtualmachines outage reset [flags]
Flags
-h, --help[=true|false] help for reset
--location string Scope this rule to one location, e.g. london
--name string Scope this rule to one resource by name, e.g. acct1, or rg1/acct1 for one resource group's
--subscription string Subscription UUID (defaults to the configured default)
locally chaos virtualmachines reset
Zero every Virtual Machines (data plane) fault and drop every rule.
Zero every Virtual Machines (data plane) fault and drop every rule. Examples: locally chaos virtualmachines reset
Usage
locally chaos virtualmachines reset [flags]
Flags
-h, --help[=true|false] help for reset
--subscription string Subscription UUID (defaults to the configured default)
locally chaos virtualmachines restart
Restart virtual machines on a schedule.
Restart virtual machines on a schedule. Every interval each VM is rolled for; on a hit its guest is stopped and started again, dropping its connections. Without scope flags this sets the fault's rate on Virtual Machines (data plane). With --location / --name it adds or edits one rule, leaving the rate and other rules alone. A rule can be lower than the rate: "everywhere except one place" is a rate of 100 plus a rule at 0. --name acct1 matches that resource in any resource group; --name rg1/acct1 matches only rg1's. --interval is how often the fault starts, such as 10m. It is required whenever the fault fires: nothing else sets it off. A value flag left out keeps what the row already has; a new rule starts with none. 'reset' clears a row. Examples: locally chaos virtualmachines restart --percentage 25 --interval 10m locally chaos virtualmachines restart --percentage 100 --interval 10m --location london locally chaos virtualmachines restart reset --location london locally chaos virtualmachines restart --percentage 100 --interval 10m --name acct1
Usage
locally chaos virtualmachines restart [flags] locally chaos virtualmachines restart [command]
Flags
-h, --help[=true|false] help for restart
--interval string How often this fault rolls for each resource, e.g. 10m; the first roll lands at a random point within the first interval (required when it fires)
--location string Scope this rule to one location, e.g. london
--name string Scope this rule to one resource by name, e.g. acct1, or rg1/acct1 for one resource group's
--percentage int How often this fault fires, 0-100 (required)
--subscription string Subscription UUID (defaults to the configured default)
Subcommands
- locally chaos virtualmachines restart reset - Remove one restart rule, or put the whole fault back to zero.
locally chaos virtualmachines restart reset
Remove one restart rule, or put the whole fault back to zero.
Reset the restart fault. With a scope flag, removes that rule so those requests use the fault's rate. Without one, removes every rule and sets the rate to 0. 'reset --location X' removes the rule; '--percentage 0 --location X' keeps a rule that never fires, which is how to say "everywhere except X".
Usage
locally chaos virtualmachines restart reset [flags]
Flags
-h, --help[=true|false] help for reset
--location string Scope this rule to one location, e.g. london
--name string Scope this rule to one resource by name, e.g. acct1, or rg1/acct1 for one resource group's
--subscription string Subscription UUID (defaults to the configured default)
locally chaos virtualmachines show
Print the current Virtual Machines (data plane) chaos configuration.
Print the current Virtual Machines (data plane) chaos configuration. Examples: locally chaos virtualmachines show
Usage
locally chaos virtualmachines show [flags]
Flags
-h, --help[=true|false] help for show
--subscription string Subscription UUID (defaults to the configured default)
During Public Preview you can use the Team plan for free, and get an early-adopter discount at GA. Sign in