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

# POST /v1/{+parent}/partitions

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

Create a metadata partition.

## Path parameters

- `parent` string, required

## Query parameters

- `validateOnly` boolean

## Request body

- GoogleCloudDataplexV1Partition — Represents partition metadata contained within entity instances.
  - `name` string — Output only. Partition values used in the HTTP URL must be double encoded. For example, url_encode(url_encode(value)) can be used to encode "US:CA/CA#Sunnyvale so that the request URL ends with "/partitions/US%253ACA/CA%2523Sunnyvale". The name field in the response retains the encoded format.
  - `etag` string — Optional. The etag for this partition.
  - `values` string[] — Required. Immutable. The set of values representing the partition, which correspond to the partition schema defined in the parent entity.
  - `location` string — Required. Immutable. The location of the entity data within the partition, for example, gs://bucket/path/to/entity/key1=value1/key2=value2. Or projects//datasets//tables/

## Response `200`

Successful response

---

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