Skip to main content
POST
/
v1
/
instances
/
{instance}
/
databases
/
{database}
/
revisions
cURL
curl --request POST \
  --url https://api.example.com/v1/instances/{instance}/databases/{database}/revisions \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "release": "<string>",
  "file": "<string>",
  "version": "<string>",
  "sheet": "<string>",
  "taskRun": "<string>",
  "type": "TYPE_UNSPECIFIED"
}
'
{
  "name": "<string>",
  "release": "<string>",
  "createTime": "2023-11-07T05:31:56Z",
  "deleter": "<string>",
  "deleteTime": "2023-11-07T05:31:56Z",
  "file": "<string>",
  "version": "<string>",
  "sheet": "<string>",
  "sheetSha256": "<string>",
  "statement": "<string>",
  "statementSize": "<string>",
  "taskRun": "<string>",
  "type": "TYPE_UNSPECIFIED"
}

Path Parameters

​
instance
string
required

The instance id.

​
database
string
required

The database id.

Body

application/json
​
name
string

Format: instances/{instance}/databases/{database}/revisions/{revision}

​
release
string

Format: projects/{project}/releases/{release} Can be empty.

​
file
string

Format: projects/{project}/releases/{release}/files/{id} Can be empty.

​
version
string

The schema version string for this revision.

​
sheet
string

The sheet that holds the content. Format: projects/{project}/sheets/{sheet}

​
taskRun
string

The task run associated with the revision. Can be empty. Format: projects/{project}/rollouts/{rollout}/stages/{stage}/tasks/{task}/taskRuns/{taskRun}

​
type
enum<string>

The type of the revision.

Available options:
TYPE_UNSPECIFIED,
VERSIONED,
DECLARATIVE

Response

OK

​
name
string

Format: instances/{instance}/databases/{database}/revisions/{revision}

​
release
string

Format: projects/{project}/releases/{release} Can be empty.

​
createTime
string<date-time>
​
deleter
string

Format: users/[email protected] Can be empty.

​
deleteTime
string<date-time>

Can be empty.

​
file
string

Format: projects/{project}/releases/{release}/files/{id} Can be empty.

​
version
string

The schema version string for this revision.

​
sheet
string

The sheet that holds the content. Format: projects/{project}/sheets/{sheet}

​
sheetSha256
string

The SHA256 hash value of the sheet.

​
statement
string

The statement is used for preview purpose.

​
statementSize
string

The size of the statement in bytes.

​
taskRun
string

The task run associated with the revision. Can be empty. Format: projects/{project}/rollouts/{rollout}/stages/{stage}/tasks/{task}/taskRuns/{taskRun}

​
type
enum<string>

The type of the revision.

Available options:
TYPE_UNSPECIFIED,
VERSIONED,
DECLARATIVE