# The FailoverGroup object

A failover group manages disaster recovery across workspace sets,
 coordinating Unity Catalog and workspace assets replication.

## Attributes

- `name` (string)
  Fully qualified resource name in the format
   accounts/{account_id}/failover-groups/{failover_group_id}.
- `effective_primary_region` (string)
  Current effective primary region. Replication flows FROM workspaces in this region.
   Changes after a successful failover.
- `regions` (array of string)
  List of all regions participating in this failover group.
- `workspace_sets` (array of object)
  Workspace sets, each containing workspaces that replicate to each other.
  - `name` (string)
    Resource name for this workspace set.
    Example: `accounting`
  - `workspace_ids` (array of string)
    Workspace IDs in this set. The system derives and validates regions.
     All workspaces must be in the Mission Critical tier.
  - `replicate_workspace_assets` (boolean)
    Whether to enable control plane DR (notebooks, jobs, clusters, etc.) for this set.
     Defaults to false.
  - `stable_url_names` (array of string)
    Resource names of stable URLs associated with this workspace set.
     Format: accounts/{account_id}/stable-urls/{stable_url_id}.
     The referenced stable URLs must already exist (via CreateStableUrl).
- `unity_catalog_assets` (object)
  Unity Catalog replication configuration.
  - `location_mappings` (array of object)
    Location mappings - storage URI per region for each location.
    - `name` (string)
      Resource name for this location.
      Example: `main-storage`
    - `uri_by_region` (array of object)
      URI for each region. Each entry maps a region name to a storage URI.
      - `region` (string)
        The region name.
        Example: `us-east-1`
      - `uri` (string)
        The storage URI for this region.
        Example: `s3://east/data`
  - `catalogs` (array of object)
    UC catalogs to replicate.
    - `name` (string)
      The name of the UC catalog to replicate.
  - `data_replication_workspace_set` (string)
    The workspace set whose workspaces will be used for data replication
     of all UC catalogs' underlying storage.
    Example: `accounting`
- `state` (string)
  Aggregate state of the failover group.
  Possible values: `STATE_UNSPECIFIED`, `CREATING`, `CREATION_FAILED`, `INITIAL_REPLICATION`, `ACTIVE`, `FAILING_OVER`, `DELETING`, `FAILOVER_FAILED`, `DELETION_FAILED`
- `etag` (string)
  Opaque version string for optimistic locking. Server-generated and returned in responses.
- `create_time` (string)
  Time at which this failover group was created.
- `update_time` (string)
  Time at which this failover group was last modified.
- `replication_point` (string)
  The latest point in time to which data has been replicated.
- `initial_primary_region` (string)
  Initial primary region. Used only in Create requests to set the starting
   primary region. Not returned in responses.

## Example

```json
{
  "name": "string",
  "effective_primary_region": "string",
  "regions": [
    "string"
  ],
  "workspace_sets": [
    {
      "name": "accounting",
      "workspace_ids": [
        "string"
      ],
      "replicate_workspace_assets": true,
      "stable_url_names": [
        "string"
      ]
    }
  ],
  "unity_catalog_assets": {
    "location_mappings": [
      {}
    ],
    "catalogs": [
      {}
    ],
    "data_replication_workspace_set": "accounting"
  },
  "state": "string",
  "etag": "string",
  "create_time": "string",
  "update_time": "string",
  "replication_point": "string",
  "initial_primary_region": "string"
}
```