Marks the Project identified by the specified projectId
(for example, my-project-123
) for deletion. This method will only affect the Project if it has a lifecycle state of ACTIVE
.
This method changes the Project's lifecycle state from ACTIVE
to DELETE_REQUESTED
. The deletion starts at an unspecified time, at which point the project is no longer accessible.
Until the deletion completes, you can check the lifecycle state checked by retrieving the Project with projects.get
, and the Project remains visible to projects.list
. However, you cannot update the project.
After the deletion completes, the Project is not retrievable by the projects.get
and projects.list
methods.
The caller must have delete permissions for this Project.
HTTP request
DELETE https://cloudresourcemanager.googleapis.com/v1beta1/projects/{projectId}
The URL uses gRPC Transcoding syntax.
Path parameters
projectId
string
The Project ID (for example, foo-bar-123
).
Authorization requires the following IAM
permission on the specified resource projectId
:
-
resourcemanager.projects.delete
Request body
The request body must be empty.
Response body
If successful, the response body is an empty JSON object.
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 .
