Skip to main content

get-cloud-diagram-layer-snapshot

dci get-cloud-diagram-layer-snapshot id [flags]

Returns a single snapshot of the specified diagram layer identified by its ID.

Flags

--snapshot-id: (string)

Output

OK - Snapshot returned.

By default dci renders the result as a table. Use --output json to get the full structure described below — see Output formats.

FieldTypeDescription
_idstringSnapshot ID.
namestringSnapshot name.
createdAtstring (date-time)Timestamp when the snapshot was created.
prevStatestringID of the previous snapshot in the chain.
Raw JSON schema
{
"type": "object",
"required": [
"_id",
"createdAt"
],
"description": "A saved snapshot of a diagram layer's state.",
"properties": {
"_id": {
"type": "string",
"description": "Snapshot ID."
},
"name": {
"type": "string",
"description": "Snapshot name."
},
"createdAt": {
"type": "string",
"format": "date-time",
"description": "Timestamp when the snapshot was created."
},
"prevState": {
"type": "string",
"description": "ID of the previous snapshot in the chain."
}
}
}

Errors

On failure, dci prints a single error message — with a hint when one is available — and exits with a typed code your scripts can branch on. See Errors and exit codes for the full contract.

HTTP statusExit codeError codeMeaning
40030VALIDATION_ERRORThe arguments or request body were rejected. Review the command's flags and payload.
40110AUTHENTICATION_FAILEDNot signed in, or the API token is invalid. Run dci login or check DCI_API_KEY.
40311PERMISSION_DENIEDThe DoiT user or the active customer context does not have access.

Aliases: getclouddiagramlayersnapshot