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.
| Field | Type | Description |
|---|---|---|
_id | string | Snapshot ID. |
name | string | Snapshot name. |
createdAt | string (date-time) | Timestamp when the snapshot was created. |
prevState | string | ID 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 status | Exit code | Error code | Meaning |
|---|---|---|---|
| 400 | 30 | VALIDATION_ERROR | The arguments or request body were rejected. Review the command's flags and payload. |
| 401 | 10 | AUTHENTICATION_FAILED | Not signed in, or the API token is invalid. Run dci login or check DCI_API_KEY. |
| 403 | 11 | PERMISSION_DENIED | The DoiT user or the active customer context does not have access. |
Aliases: getclouddiagramlayersnapshot