---
title: "POST /v1/{+parent}/managementServers"
method: POST
path: "/v1/{+parent}/managementServers"
tags: ["projects"]
---

# POST /v1/{+parent}/managementServers

`POST /v1/{+parent}/managementServers`

Creates a new ManagementServer in a given project and location.

## Path parameters

- `parent` string, required

## Query parameters

- `managementServerId` string
- `requestId` string

## Request body

- ManagementServer — ManagementServer describes a single BackupDR ManagementServer instance.
  - `etag` string — Optional. Server specified ETag for the ManagementServer resource to prevent simultaneous updates from overwiting each other.
  - `satisfiesPzs` boolean — Output only. Reserved for future use.
  - `createTime` string, google-datetime — Output only. The time when the instance was created.
  - `type` 'INSTANCE_TYPE_UNSPECIFIED' | 'BACKUP_RESTORE' — Optional. The type of the ManagementServer resource.
  - `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.
  - `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
    - `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.
    - `network` string — Optional. The resource name of the Google Compute Engine VPC network to which the ManagementServer instance is connected.
  - `baProxyUri` string[] — Output only. The hostname or ip address of the exposed AGM endpoints, used by BAs to connect to BA proxy.
  - `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.
  - `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.
  - `updateTime` string, google-datetime — Output only. The time when the instance was updated.
  - `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).
  - `description` string — Optional. The description of the ManagementServer instance (2048 characters or less).
  - `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.
  - `state` 'INSTANCE_STATE_UNSPECIFIED' | 'CREATING' | 'READY' | 'UPDATING' | 'DELETING' | 'REPAIRING' | 'MAINTENANCE' | 'ERROR' — Output only. The ManagementServer state.
  - `satisfiesPzi` boolean — Output only. Reserved for future use.

## Response `200`

Successful response

---

[API](https://skmtc.dev/google/apis/backupdr.md) · [All operations](https://skmtc.dev/google/apis/backupdr/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/backupdr/revisions/b432f73f0b98/schema)