---
title: "GET /v1/projects/{projectsId}/locations/{locationsId}/managementServers"
method: GET
path: "/v1/projects/{projectsId}/locations/{locationsId}/managementServers"
tags: ["projects"]
---

# GET /v1/projects/{projectsId}/locations/{locationsId}/managementServers

`GET /v1/projects/{projectsId}/locations/{locationsId}/managementServers`

## Request

- Base URL: `https://backupdr.googleapis.com`
- URL: `https://backupdr.googleapis.com/v1/projects/{projectsId}/locations/{locationsId}/managementServers`
- Auth: one of:
  - OAuth 2 and OAuth 2
    - Implicit: `https://accounts.google.com/o/oauth2/auth`
    - Scopes: `https://www.googleapis.com/auth/cloud-backupdr`
    - Authorization code: `https://accounts.google.com/o/oauth2/auth`
    - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/cloud-backupdr`
  - OAuth 2 and OAuth 2
    - Implicit: `https://accounts.google.com/o/oauth2/auth`
    - Scopes: `https://www.googleapis.com/auth/cloud-platform`
    - Authorization code: `https://accounts.google.com/o/oauth2/auth`
    - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/cloud-platform`

Lists ManagementServers in a given project and location.

## Path parameters

- `projectsId` string, required
- `locationsId` string, required

## Query parameters

- `filter` string
- `orderBy` string
- `pageSize` integer
- `pageToken` string

## Response `200`

Successful response

- ListManagementServersResponse: Response message for listing management servers.
  - `managementServers` ManagementServer[]: The list of ManagementServer instances in the project for the specified location. If the '{location}' value in the request is "-", the response contains a list of instances from all locations. In case any location is unreachable, the response will only return management servers in reachable locations and the 'unreachable' field will be populated with a list of unreachable locations.
    - `baProxyUri` string[]: Output only. The hostname or ip address of the exposed AGM endpoints, used by BAs to connect to BA proxy.
    - `createTime` string, google-datetime: Output only. The time when the instance was created.
    - `description` string: Optional. The description of the ManagementServer instance (2048 characters or less).
    - `etag` string: Optional. Server specified ETag for the ManagementServer resource to prevent simultaneous updates from overwiting each other.
    - `labels` object: Optional. Resource labels to represent user provided metadata. Labels currently defined: 1. migrate_from_go= If set to true, the MS is created in migration ready mode.
    - `managementUri` ManagementURI: ManagementURI for the Management Server resource.
      - `api` string: Output only. The ManagementServer AGM/RD API URL.
      - `webUi` string: Output only. The ManagementServer AGM/RD WebUI URL.
    - `name` string: Output only. Identifier. The resource name.
    - `networks` NetworkConfig[]: Optional. VPC networks to which the ManagementServer instance is connected. For this version, only a single network is supported. This field is optional if MS is created without PSA
      - `network` string: Optional. The resource name of the Google Compute Engine VPC network to which the ManagementServer instance is connected.
      - `peeringMode` 'PEERING_MODE_UNSPECIFIED' | 'PRIVATE_SERVICE_ACCESS': Optional. The network connect mode of the ManagementServer instance. For this version, only PRIVATE_SERVICE_ACCESS is supported.
    - `oauth2ClientId` string: Output only. The OAuth 2.0 client id is required to make API calls to the Backup and DR instance API of this ManagementServer. This is the value that should be provided in the 'aud' field of the OIDC ID Token (see openid specification https://openid.net/specs/openid-connect-core-1_0.html#IDToken).
    - `satisfiesPzi` boolean: Output only. Reserved for future use.
    - `satisfiesPzs` boolean: Output only. Reserved for future use.
    - `state` 'INSTANCE_STATE_UNSPECIFIED' | 'CREATING' | 'READY' | 'UPDATING' | 'DELETING' | 'REPAIRING' | 'MAINTENANCE' | 'ERROR': Output only. The ManagementServer state.
    - `type` 'INSTANCE_TYPE_UNSPECIFIED' | 'BACKUP_RESTORE': Optional. The type of the ManagementServer resource.
    - `updateTime` string, google-datetime: Output only. The time when the instance was updated.
    - `workforceIdentityBasedManagementUri` WorkforceIdentityBasedManagementURI: ManagementURI depending on the Workforce Identity i.e. either 1p or 3p.
      - `firstPartyManagementUri` string: Output only. First party Management URI for Google Identities.
      - `thirdPartyManagementUri` string: Output only. Third party Management URI for External Identity Providers.
    - `workforceIdentityBasedOauth2ClientId` WorkforceIdentityBasedOAuth2ClientID: OAuth Client ID depending on the Workforce Identity i.e. either 1p or 3p,
      - `firstPartyOauth2ClientId` string: Output only. First party OAuth Client ID for Google Identities.
      - `thirdPartyOauth2ClientId` string: Output only. Third party OAuth Client ID for External Identity Providers.
  - `nextPageToken` string: A token identifying a page of results the server should return.
  - `unreachable` string[]: Locations that could not be reached.

## Changes

- **2026-11-05** `da857420b4f6`: 4 info
  - the security scope `https://www.googleapis.com/auth/cloud-backupdr` was added to the endpoint's security scheme `Oauth2`
  - the security scope `https://www.googleapis.com/auth/cloud-backupdr` was added to the endpoint's security scheme `Oauth2c`
  - the security scope `https://www.googleapis.com/auth/cloud-platform` was removed from the endpoint's security scheme `Oauth2`
  - the security scope `https://www.googleapis.com/auth/cloud-platform` was removed from the endpoint's security scheme `Oauth2c`
- **2026-10-29** `3244196e66b0`: 4 info
  - the security scope `https://www.googleapis.com/auth/cloud-backupdr` was added to the endpoint's security scheme `Oauth2`
  - the security scope `https://www.googleapis.com/auth/cloud-backupdr` was added to the endpoint's security scheme `Oauth2c`
  - the security scope `https://www.googleapis.com/auth/cloud-platform` was removed from the endpoint's security scheme `Oauth2`
  - the security scope `https://www.googleapis.com/auth/cloud-platform` was removed from the endpoint's security scheme `Oauth2c`

[Operation history](https://skmtc.dev/google/apis/backupdr/changes/v1/projects/:projectsId/locations/:locationsId/managementServers/get.md)

---

[API](https://skmtc.dev/google/apis/backupdr.md) - [All operations](https://skmtc.dev/google/apis/backupdr/llms.txt) - [OpenAPI document](https://skmtc.dev/google/apis/backupdr/revisions/da857420b4f6?raw)