36 lines
1.3 KiB
YAML
36 lines
1.3 KiB
YAML
- release_tracks: [ALPHA]
|
|
help_text:
|
|
brief: Initiate the failover of the virtual machine (VM) instance to a designated failover zone.
|
|
description: Initiate the failover of the VM to a designated zone by using a High Availability (HA) Controller. Regional disks attached to the other preconfigured zone are included in this failover.
|
|
examples: |
|
|
To trigger the failover of HA Controller `my-ha-controller` to zone `us-central1-a`, run the following command:
|
|
|
|
$ {command} my-ha-controller \
|
|
--region=us-central1 \
|
|
--failover-to-zone=us-central1-a
|
|
|
|
request:
|
|
api_version: alpha
|
|
collection: compute.haControllers
|
|
method: failover
|
|
|
|
async:
|
|
collection: compute.regionOperations
|
|
response_name_field: selfLink
|
|
state:
|
|
field: status
|
|
success_values: ['DONE']
|
|
|
|
arguments:
|
|
resource:
|
|
help_text: The HA Controller that you want to failover.
|
|
spec: !REF googlecloudsdk.command_lib.compute.ha_controllers.resources:ha_controller
|
|
is_positional: true
|
|
|
|
params:
|
|
- arg_name: failover-to-zone
|
|
api_field: haControllersFailoverRequest.failoverToZone
|
|
required: true
|
|
help_text: |
|
|
The destination zone for the failover. This must be the pre-configured secondary zone for the HA Controller.
|