Method: projects.locations.deployments.exportState

Exports Terraform state file from a given deployment.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



Required. The parent in whose context the statefile is listed. The parent value is in the format: 'projects/{projectId}/locations/{location}/deployments/{deployment}'. It takes the form projects/{project}/locations/{location}/deployments/{deployment}.

Request body

The request body contains data with the following structure:

JSON representation
  "draft": boolean


Optional. If this flag is set to true, the exported deployment state file will be the draft state. This will enable the draft file to be validated before copying it over to the working state on unlock.

Response body

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

Authorization scopes

Requires the following OAuth scope:


For more information, see the Authentication Overview.

IAM Permissions

Requires the following IAM permission on the parent resource:


For more information, see the IAM documentation.