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

# POST /v1/{+parent}/instances

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

Provisions instance resources for the Registry.

## Path parameters

- `parent` string, required

## Query parameters

- `instanceId` string

## Request body

- Instance — An Instance represents the instance resources of the Registry. Currently, only one instance is allowed for each project.
  - `updateTime` string, google-datetime — Output only. Last update timestamp.
  - `name` string — Format: `projects/*/locations/*/instance`. Currently only `locations/global` is supported.
  - `stateMessage` string — Output only. Extra information of Instance.State if the state is `FAILED`.
  - `state` 'STATE_UNSPECIFIED' | 'INACTIVE' | 'CREATING' | 'ACTIVE' | 'UPDATING' | 'DELETING' | 'FAILED' — Output only. The current state of the Instance.
  - `config` Config — Available configurations to provision an Instance.
    - `location` string — Output only. The GCP location where the Instance resides.
    - `cmekKeyName` string — Required. The Customer Managed Encryption Key (CMEK) used for data encryption. The CMEK name should follow the format of `projects/([^/]+)/locations/([^/]+)/keyRings/([^/]+)/cryptoKeys/([^/]+)`, where the `location` must match InstanceConfig.location.
  - `createTime` string, google-datetime — Output only. Creation timestamp.
  - `build` Build — Build information of the Instance if it's in `ACTIVE` state.
    - `repo` string — Output only. Path of the open source repository: github.com/apigee/registry.
    - `commitId` string — Output only. Commit ID of the latest commit in the build.
    - `commitTime` string, google-datetime — Output only. Commit time of the latest commit in the build.

## Response `200`

Successful response

---

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