Skip to main content

list-cloud-diagram-layer-snapshots 

dci list-cloud-diagram-layer-snapshots id [flags]

Returns the list of saved snapshots for the specified diagram layer.

Flags​

--offset: (integer)

--limit: (integer)

--sort: (string)

Responses​

200 (application/json)​

OK - Snapshots returned.

{
  "type": "array",
  "items": {
    "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."
      }
    }
  }
}

400 (application/json)​

Bad Request - The server cannot process the request, often due to a malformed request.

{
  "type": "object",
  "description": "Standard error response structure.",
  "properties": {
    "error": {
      "type": "string",
      "description": "Detailed error message."
    }
  }
}

401 (application/json)​

Unauthorized - Invalid API key.

{
  "type": "object",
  "description": "Standard error response structure.",
  "properties": {
    "error": {
      "type": "string",
      "description": "Detailed error message."
    }
  }
}

403 (application/json)​

Forbidden - Either the resource does not exist, or the caller is not authorized to access it. These two cases are deliberately indistinguishable to avoid information disclosure: the access guard runs before any existence check, so callers receive 403 (not 404) for unknown IDs on this endpoint. Used by Cloud Diagrams routes keyed by a path-param resource id (e.g. /clouddiagrams/v1/statussheet/\{id\}/...).

{
  "type": "object",
  "description": "Standard error response structure.",
  "properties": {
    "error": {
      "type": "string",
      "description": "Detailed error message."
    }
  }
}

Aliases: list-cloud-diagram-layer-snapshots, listclouddiagramlayersnapshots