Method: projects.move

Move a project to another place in your resource hierarchy, under a new resource parent.

Returns an operation which can be used to track the process of the project move workflow. Upon success, the Operation.response field will be populated with the moved project.

The caller must have resourcemanager.projects.update permission on the project and have resourcemanager.projects.move permission on the project's current and proposed new parent.

If project has no current parent, or it currently does not have an associated organization resource, you will also need the resourcemanager.projects.setIamPolicy permission in the project.

HTTP request

POST https://cloudresourcemanager.googleapis.com/v3/{name=projects/*}:move

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
name

string

Required. The name of the project to move.

Authorization requires the following IAM permission on the specified resource name:

  • resourcemanager.projects.move

Request body

The request body contains data with the following structure:

JSON representation
{
  "destinationParent": string
}
Fields
destinationParent

string

Required. The new parent to move the Project under.

Authorization requires the following IAM permission on the specified resource destinationParent:

  • resourcemanager.projects.move

Response body

If successful, the response body contains an instance of Operation.

Authorization Scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloudplatformprojects

For more information, see the Authentication Overview.