---
title: "PATCH /v1/{+name}"
method: PATCH
path: "/v1/{+name}"
tags: ["projects"]
---

# PATCH /v1/{+name}

`PATCH /v1/{+name}`

Updates the fields of a federation.

## Path parameters

- `name` string, required

## Query parameters

- `requestId` string
- `updateMask` string

## Request body

- Federation — Represents a federation of multiple backend metastores.
  - `updateTime` string, google-datetime — Output only. The time when the metastore federation was last updated.
  - `stateMessage` string — Output only. Additional information about the current state of the metastore federation, if available.
  - `version` string — Immutable. The Apache Hive metastore version of the federation. All backend metastore versions must be compatible with the federation version.
  - `createTime` string, google-datetime — Output only. The time when the metastore federation was created.
  - `tags` object — Optional. Input only. Immutable. Tag keys/values directly bound to this resource. For example: "123/environment": "production", "123/costCenter": "marketing"
  - `state` 'STATE_UNSPECIFIED' | 'CREATING' | 'ACTIVE' | 'UPDATING' | 'DELETING' | 'ERROR' — Output only. The current state of the federation.
  - `name` string — Immutable. The relative resource name of the federation, of the form: projects/{project_number}/locations/{location_id}/federations/{federation_id}`.
  - `labels` object — User-defined labels for the metastore federation.
  - `backendMetastores` object — A map from BackendMetastore rank to BackendMetastores from which the federation service serves metadata at query time. The map key represents the order in which BackendMetastores should be evaluated to resolve database names at query time and should be greater than or equal to zero. A BackendMetastore with a lower number will be evaluated before a BackendMetastore with a higher number.
  - `uid` string — Output only. The globally unique resource identifier of the metastore federation.
  - `endpointUri` string — Output only. The federation endpoint.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/metastore.md) · [All operations](https://skmtc.net/google/apis/metastore/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/metastore/versions/303a0939d73e/schema)