locally chaos servicebus

Preview

During Public Preview you can use the Team plan for free, and get an early-adopter discount at GA. Sign in

locally chaos servicebus

This page is part of the CLI Reference and is generated from the CLI's own help output, so it matches what locally chaos servicebus --help prints.

For more information see Chaos Engineering and Service Bus Emulator.

locally chaos servicebus

Simulate Service Bus (data plane) failure modes.

Simulate Service Bus (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 servicebus <fault> --percentage N
  locally chaos servicebus <fault> reset
  locally chaos servicebus show
  locally chaos servicebus reset

Usage

locally chaos servicebus [flags]
  locally chaos servicebus [command]

Flags

-h, --help[=true|false]   help for servicebus

Subcommands

locally chaos servicebus 403

Answer requests with 403, as when a role assignment has not replicated yet.

Answer requests with 403, as when a role assignment has not replicated yet. On
the control plane the error code is AuthorizationFailed; on a database the
engine's own equivalent error is sent instead.

Without scope flags this sets the fault's rate on Service Bus (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 servicebus 403 --percentage 25
  locally chaos servicebus 403 --percentage 100 --location london
  locally chaos servicebus 403 reset --location london
  locally chaos servicebus 403 --percentage 100 --name acct1

Usage

locally chaos servicebus 403 [flags]
  locally chaos servicebus 403 [command]

Flags

-h, --help[=true|false]     help for 403
      --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 servicebus 403 reset

Remove one 403 rule, or put the whole fault back to zero.

Reset the 403 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 servicebus 403 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 servicebus 429

Answer requests with 429 Too Many Requests and a retry hint.

Answer requests with 429 Too Many Requests and a retry hint. On a database the
engine's own throttling error is sent instead.

Without scope flags this sets the fault's rate on Service Bus (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.

--retry-after sets the Retry-After header the fault answers with, such as 5s.
Without one the service's usual hint is sent.

A value flag left out keeps what the row already has; a new rule starts with
none. 'reset' clears a row.

Examples:
locally chaos servicebus 429 --percentage 25
  locally chaos servicebus 429 --percentage 25 --retry-after 5s
  locally chaos servicebus 429 --percentage 100 --location london
  locally chaos servicebus 429 reset --location london
  locally chaos servicebus 429 --percentage 100 --name acct1

Usage

locally chaos servicebus 429 [flags]
  locally chaos servicebus 429 [command]

Flags

-h, --help[=true|false]     help for 429
      --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)
      --retry-after string    Retry-After this fault answers with, e.g. 5s or 500ms (the service's usual hint when omitted)
      --subscription string   Subscription UUID (defaults to the configured default)

Subcommands

locally chaos servicebus 429 reset

Remove one 429 rule, or put the whole fault back to zero.

Reset the 429 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 servicebus 429 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 servicebus 500

Answer requests with 500 Internal Server Error.

Answer requests with 500 Internal Server Error. On a database the engine's own
equivalent error is sent instead.

Without scope flags this sets the fault's rate on Service Bus (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 servicebus 500 --percentage 25
  locally chaos servicebus 500 --percentage 100 --location london
  locally chaos servicebus 500 reset --location london
  locally chaos servicebus 500 --percentage 100 --name acct1

Usage

locally chaos servicebus 500 [flags]
  locally chaos servicebus 500 [command]

Flags

-h, --help[=true|false]     help for 500
      --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 servicebus 500 reset

Remove one 500 rule, or put the whole fault back to zero.

Reset the 500 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 servicebus 500 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 servicebus delivery-delay

Hold messages, events or triggers for the rolled duration before delivering them.

Hold messages, events or triggers for the rolled duration before delivering
them.

Without scope flags this sets the fault's rate on Service Bus (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.

A value flag left out keeps what the row already has; a new rule starts with
none. 'reset' clears a row.

Examples:
locally chaos servicebus delivery-delay --percentage 25 --seconds 30-120
  locally chaos servicebus delivery-delay --percentage 100 --seconds 30-120 --location london
  locally chaos servicebus delivery-delay reset --location london
  locally chaos servicebus delivery-delay --percentage 100 --seconds 30-120 --name acct1

Usage

locally chaos servicebus delivery-delay [flags]
  locally chaos servicebus delivery-delay [command]

Flags

-h, --help[=true|false]     help for delivery-delay
      --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 servicebus delivery-delay reset

Remove one delivery-delay rule, or put the whole fault back to zero.

Reset the delivery-delay 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 servicebus delivery-delay 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 servicebus 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 Service Bus (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 servicebus disconnect --percentage 25 --interval 10m
  locally chaos servicebus disconnect --percentage 100 --interval 10m --location london
  locally chaos servicebus disconnect reset --location london
  locally chaos servicebus disconnect --percentage 100 --interval 10m --name acct1

Usage

locally chaos servicebus disconnect [flags]
  locally chaos servicebus 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 servicebus 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 servicebus 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 servicebus 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 Service Bus (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 servicebus drop-connection --percentage 25
  locally chaos servicebus drop-connection --percentage 25 --interval 30s
  locally chaos servicebus drop-connection --percentage 100 --location london
  locally chaos servicebus drop-connection reset --location london
  locally chaos servicebus drop-connection --percentage 100 --name acct1

Usage

locally chaos servicebus drop-connection [flags]
  locally chaos servicebus 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 servicebus 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 servicebus 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 servicebus duplicate-delivery

Deliver some messages, events or triggers twice.

Deliver some messages, events or triggers twice.

Without scope flags this sets the fault's rate on Service Bus (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 servicebus duplicate-delivery --percentage 25
  locally chaos servicebus duplicate-delivery --percentage 100 --location london
  locally chaos servicebus duplicate-delivery reset --location london
  locally chaos servicebus duplicate-delivery --percentage 100 --name acct1

Usage

locally chaos servicebus duplicate-delivery [flags]
  locally chaos servicebus duplicate-delivery [command]

Flags

-h, --help[=true|false]     help for duplicate-delivery
      --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 servicebus duplicate-delivery reset

Remove one duplicate-delivery rule, or put the whole fault back to zero.

Reset the duplicate-delivery 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 servicebus duplicate-delivery 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 servicebus entity-disabled

Refuse requests because the entity is disabled.

Refuse requests because the entity is disabled. The error is
MessagingEntityDisabled for a queue, topic or event hub, and DeviceDisabled for
an IoT device.

Without scope flags this sets the fault's rate on Service Bus (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 servicebus entity-disabled --percentage 25
  locally chaos servicebus entity-disabled --percentage 100 --location london
  locally chaos servicebus entity-disabled reset --location london
  locally chaos servicebus entity-disabled --percentage 100 --name acct1

Usage

locally chaos servicebus entity-disabled [flags]
  locally chaos servicebus entity-disabled [command]

Flags

-h, --help[=true|false]     help for entity-disabled
      --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 servicebus entity-disabled reset

Remove one entity-disabled rule, or put the whole fault back to zero.

Reset the entity-disabled 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 servicebus entity-disabled 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 servicebus 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. With --interval it also stalls live connections: every
interval each is rolled for, and on a hit nothing crosses it in either direction
until the rolled delay has passed. Nothing is dropped; it all arrives late.

Without scope flags this sets the fault's rate on Service Bus (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.

--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 servicebus latency --percentage 25 --seconds 30
  locally chaos servicebus latency --percentage 25 --seconds 30 --interval 30s
  locally chaos servicebus latency --percentage 100 --seconds 30 --location london
  locally chaos servicebus latency reset --location london
  locally chaos servicebus latency --percentage 100 --seconds 30 --name acct1

Usage

locally chaos servicebus latency [flags]
  locally chaos servicebus latency [command]

Flags

-h, --help[=true|false]     help for latency
      --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
      --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 servicebus 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 servicebus 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)

Detach live AMQP receiver links as stolen, as when another receiver takes over the entity or partition.

Detach live AMQP receiver links as stolen, as when another receiver takes over
the entity or partition. The connection stays up; the link is closed with
amqp:link:stolen.

Without scope flags this sets the fault's rate on Service Bus (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 servicebus link-stolen --percentage 25 --interval 10m
  locally chaos servicebus link-stolen --percentage 100 --interval 10m --location london
  locally chaos servicebus link-stolen reset --location london
  locally chaos servicebus link-stolen --percentage 100 --interval 10m --name acct1

Usage

locally chaos servicebus link-stolen [flags]
  locally chaos servicebus link-stolen [command]

Flags

-h, --help[=true|false]     help for link-stolen
      --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

Remove one link-stolen rule, or put the whole fault back to zero.

Reset the link-stolen 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 servicebus link-stolen 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 servicebus lock-lost

Report that a lock or lease the client holds is gone.

Report that a lock or lease the client holds is gone. It applies to requests
that use one, such as completing a Service Bus message or writing to a leased
blob.

Without scope flags this sets the fault's rate on Service Bus (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 servicebus lock-lost --percentage 25
  locally chaos servicebus lock-lost --percentage 100 --location london
  locally chaos servicebus lock-lost reset --location london
  locally chaos servicebus lock-lost --percentage 100 --name acct1

Usage

locally chaos servicebus lock-lost [flags]
  locally chaos servicebus lock-lost [command]

Flags

-h, --help[=true|false]     help for lock-lost
      --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 servicebus lock-lost reset

Remove one lock-lost rule, or put the whole fault back to zero.

Reset the lock-lost 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 servicebus lock-lost 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 servicebus 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 Service Bus (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.

--retry-after sets the Retry-After header the fault answers with, such as 5s.
Without one the service's usual hint is sent.

A value flag left out keeps what the row already has; a new rule starts with
none. 'reset' clears a row.

Examples:
locally chaos servicebus outage --percentage 25
  locally chaos servicebus outage --percentage 25 --retry-after 5s
  locally chaos servicebus outage --percentage 100 --location london
  locally chaos servicebus outage reset --location london
  locally chaos servicebus outage --percentage 100 --name acct1

Usage

locally chaos servicebus outage [flags]
  locally chaos servicebus 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)
      --retry-after string    Retry-After this fault answers with, e.g. 5s or 500ms (the service's usual hint when omitted)
      --subscription string   Subscription UUID (defaults to the configured default)

Subcommands

locally chaos servicebus 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 servicebus 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 servicebus quota-exceeded

Refuse requests because a quota is full.

Refuse requests because a quota is full. On the control plane a resource
creation (PUT) gets 409 Conflict with QuotaExceeded; on a data plane the
service's own quota error is sent, such as a full Service Bus queue.

Without scope flags this sets the fault's rate on Service Bus (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 servicebus quota-exceeded --percentage 25
  locally chaos servicebus quota-exceeded --percentage 100 --location london
  locally chaos servicebus quota-exceeded reset --location london
  locally chaos servicebus quota-exceeded --percentage 100 --name acct1

Usage

locally chaos servicebus quota-exceeded [flags]
  locally chaos servicebus quota-exceeded [command]

Flags

-h, --help[=true|false]     help for quota-exceeded
      --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 servicebus quota-exceeded reset

Remove one quota-exceeded rule, or put the whole fault back to zero.

Reset the quota-exceeded 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 servicebus quota-exceeded 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 servicebus reorder

Swap messages or events with the next one in their batch, so they arrive out of order.

Swap messages or events with the next one in their batch, so they arrive out of
order.

Without scope flags this sets the fault's rate on Service Bus (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 servicebus reorder --percentage 25
  locally chaos servicebus reorder --percentage 100 --location london
  locally chaos servicebus reorder reset --location london
  locally chaos servicebus reorder --percentage 100 --name acct1

Usage

locally chaos servicebus reorder [flags]
  locally chaos servicebus reorder [command]

Flags

-h, --help[=true|false]     help for reorder
      --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 servicebus reorder reset

Remove one reorder rule, or put the whole fault back to zero.

Reset the reorder 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 servicebus reorder 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 servicebus reset

Zero every Service Bus (data plane) fault and drop every rule.

Zero every Service Bus (data plane) fault and drop every rule.

Examples:
locally chaos servicebus reset

Usage

locally chaos servicebus reset [flags]

Flags

-h, --help[=true|false]     help for reset
      --subscription string   Subscription UUID (defaults to the configured default)

locally chaos servicebus show

Print the current Service Bus (data plane) chaos configuration.

Print the current Service Bus (data plane) chaos configuration.

Examples:
locally chaos servicebus show

Usage

locally chaos servicebus show [flags]

Flags

-h, --help[=true|false]     help for show
      --subscription string   Subscription UUID (defaults to the configured default)
Preview

During Public Preview you can use the Team plan for free, and get an early-adopter discount at GA. Sign in

A local cloud for you and your AI agents.

Your Azure infrastructure, running on your machine. Deploy in seconds, break things freely, and ship to Azure when you're ready.