---
title: "POST /b/{bucket}/relocate"
method: POST
path: "/b/{bucket}/relocate"
tags: ["buckets"]
---

# POST /b/{bucket}/relocate

`POST /b/{bucket}/relocate`

Initiates a long-running Relocate Bucket operation on the specified bucket.

## Path parameters

- `bucket` string, required

## Request body

- RelocateBucketRequest — A Relocate Bucket request.
  - `destinationLocation` string — The new location the bucket will be relocated to.
  - `destinationCustomPlacementConfig` object — The bucket's new custom placement configuration if relocating to a Custom Dual Region.
    - `dataLocations` string[] — The list of regional locations in which data is placed.
  - `validateOnly` boolean — If true, validate the operation, but do not actually relocate the bucket.
  - `destinationKmsKeyName` string — Resource name of a Cloud KMS key, of the form projects/my-project/locations/global/keyRings/my-kr/cryptoKeys/my-key. If set, is used to encrypt all objects in the destination bucket.

## Response `200`

Successful response

---

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