メインコンテンツへスキップ

get-statussheet-components

dci get-statussheet-components <id> [body] [flags]

Returns the specified components of a diagram layer. Provide at least one component type with one or more IDs in the request body (for example, node or element).

  • id — Layer ID: the ssid of a layer listed by dci get-cloud-diagram-components (also the ss_id field in dci get-cloud-diagrams-stats and dci search-cloud-diagrams results).

Pass the request body as name: value arguments or pipe JSON on stdin — see Command structure.

Examples

# Fetch specific nodes of a layer by component ID (IDs come from `dci search-cloud-diagrams` or `dci export-cloud-diagram-json`).
dci get-statussheet-components <layer-id> node: [<node-id>]
# Nodes and groups in one call, projected to a few fields.
dci get-statussheet-components <layer-id> --p "name cld_id cld_type" node: [<node-id>], group: [<group-id>]
# A longer selection read from a file.
dci get-statussheet-components <layer-id> < components.json
# components.json
{"node": ["<node-id>", "<node-id>"], "element": ["<element-id>"], "link": ["<link-id>"]}

Request

Content-Type: application/json

FieldTypeRequiredDescription
nodearray of stringNode IDs to fetch.
elementarray of stringElement IDs to fetch.
linkarray of stringLink IDs to fetch.
grouparray of stringGroup IDs to fetch.
attachmentarray of stringAttachment IDs to fetch.
notearray of stringNote IDs to fetch.
combinerarray of stringCombiner IDs to fetch.
Raw JSON schema
{
"type": "object",
"description": "Request body for getting layer components. At least one component type must be\nprovided with one or more IDs.",
"minProperties": 1,
"properties": {
"node": {
"type": "array",
"minItems": 1,
"description": "Node IDs to fetch.",
"items": {
"type": "string"
}
},
"element": {
"type": "array",
"minItems": 1,
"description": "Element IDs to fetch.",
"items": {
"type": "string"
}
},
"link": {
"type": "array",
"minItems": 1,
"description": "Link IDs to fetch.",
"items": {
"type": "string"
}
},
"group": {
"type": "array",
"minItems": 1,
"description": "Group IDs to fetch.",
"items": {
"type": "string"
}
},
"attachment": {
"type": "array",
"minItems": 1,
"description": "Attachment IDs to fetch.",
"items": {
"type": "string"
}
},
"note": {
"type": "array",
"minItems": 1,
"description": "Note IDs to fetch.",
"items": {
"type": "string"
}
},
"combiner": {
"type": "array",
"minItems": 1,
"description": "Combiner IDs to fetch.",
"items": {
"type": "string"
}
}
}
}

Flags

FlagTypeDefaultExampleDescription
--pstringSpace-separated projection fields for component documents.

Every command also accepts the CLI-wide flags for output shaping — see Output formats and Table output options.

Output

OK - Layer components returned.

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

FieldTypeDescription
nodemap of objectMap of node ID to node component.
node.*._idstringNode ID.
node.*.namestringComponent name.
node.*.propsobjectCustom component properties (key-value pairs).
node.*.cld_idstringCloud resource ID (set on cloud-imported components).
node.*.cld_typestringCloud account type. One of: "AWS", "GCP", "AZURE".
node.*.cld_syncbooleanWhether this component is synced with cloud.
node.*.cld_accountstringCloud account ID.
node.*.tagsarray of stringTags assigned to the component.
node.*.colorstringNode color.
node.*.iconstringNode icon identifier.
node.*.parentstringParent node ID.
node.*.infra_nodeobjectReference to a linked infrastructure node in another diagram.
node.*.infra_node._idstringInfrastructure node ID.
node.*.infra_node.scheme_idstringParent diagram ID.
node.*.infra_node.ss_idstringParent layer ID.
node.*.instance_countintegerNumber of instances represented by this node.
node.*.runningbooleanWhether the node is currently running.
node.*.issuesarray of objectIssues associated with this node.
node.*.issues[]._idstringIssue reference ID.
node.*.issues[].commentstringOptional comment on the issue.
node.*.issues[].snoozednumberSnooze duration in seconds.
node.*.issues[].jirastringLinked Jira ticket key or URL.
elementmap of objectMap of element ID to element component.
element.*._idstringElement ID.
element.*.namestringComponent name.
element.*.propsobjectCustom component properties (key-value pairs).
element.*.cld_idstringCloud resource ID (set on cloud-imported components).
element.*.cld_typestringCloud account type. One of: "AWS", "GCP", "AZURE".
element.*.cld_syncbooleanWhether this component is synced with cloud.
element.*.cld_accountstringCloud account ID.
element.*.tagsarray of stringTags assigned to the component.
element.*.colorstringElement color.
element.*.iconstringElement icon identifier.
element.*.parentstringParent element ID.
element.*.issuesarray of objectIssues associated with this element.
element.*.issues[]._idstringIssue reference ID.
element.*.issues[].commentstringOptional comment on the issue.
element.*.issues[].snoozednumberSnooze duration in seconds.
element.*.issues[].jirastringLinked Jira ticket key or URL.
groupmap of objectMap of group ID to group component.
group.*._idstringGroup ID.
group.*.namestringComponent name.
group.*.propsobjectCustom component properties (key-value pairs).
group.*.cld_idstringCloud resource ID (set on cloud-imported components).
group.*.cld_typestringCloud account type. One of: "AWS", "GCP", "AZURE".
group.*.cld_syncbooleanWhether this component is synced with cloud.
group.*.cld_accountstringCloud account ID.
group.*.tagsarray of stringTags assigned to the component.
group.*.group_typestringGroup type. One of: "account", "az", "azure_subscription", "customer_gateway", "ecs", "eks", "aks", "k8s_namespace", "k8s_pod", "k8s_deployment", "k8s_daemon_set", "k8s_replica_set", ….
group.*.colorstringGroup color.
group.*.iconstringGroup icon identifier.
group.*.itemsarray of objectComponents contained in the group.
group.*.items[]._idstringComponent ID.
group.*.items[].typestringComponent type. One of: "attachment", "combiner", "element", "group", "link", "node", "note", "scheme", "statussheet".
group.*.issuesarray of objectIssues associated with this group.
group.*.issues[]._idstringIssue reference ID.
group.*.issues[].commentstringOptional comment on the issue.
group.*.issues[].snoozednumberSnooze duration in seconds.
group.*.issues[].jirastringLinked Jira ticket key or URL.
linkmap of objectMap of link ID to link component.
link.*._idstringLink ID.
link.*.namestringComponent name.
link.*.propsobjectCustom component properties (key-value pairs).
link.*.cld_idstringCloud resource ID (set on cloud-imported components).
link.*.cld_typestringCloud account type. One of: "AWS", "GCP", "AZURE".
link.*.cld_syncbooleanWhether this component is synced with cloud.
link.*.cld_accountstringCloud account ID.
link.*.tagsarray of stringTags assigned to the component.
link.*.connection_typestringLink connection type. One of: "normal", "tunnel", "private", "VPN", "VPC Peering", "Network Connectivity Center", "Private Service Connect", "Private Google Access", "Serverless VPC", "Serverless VPC Access Connector", "Cross Cloud Interconnect", "Partner Interconnect", ….
link.*.originobjectReference to a diagram component, including its parent diagram and layer.
link.*.origin._idstringComponent ID.
link.*.origin.typestringComponent type. One of: "attachment", "combiner", "element", "group", "link", "node", "note", "scheme", "statussheet".
link.*.origin.scheme_idstringParent diagram ID.
link.*.origin.ss_idstringParent layer ID.
link.*.destinationobjectReference to a diagram component, including its parent diagram and layer.
link.*.destination._idstringComponent ID.
link.*.destination.typestringComponent type. One of: "attachment", "combiner", "element", "group", "link", "node", "note", "scheme", "statussheet".
link.*.destination.scheme_idstringParent diagram ID.
link.*.destination.ss_idstringParent layer ID.
link.*.owner_ss_idstringOwner layer ID for cross-diagram links.
link.*.issuesarray of objectIssues associated with this link.
link.*.issues[]._idstringIssue reference ID.
link.*.issues[].commentstringOptional comment on the issue.
link.*.issues[].snoozednumberSnooze duration in seconds.
link.*.issues[].jirastringLinked Jira ticket key or URL.
attachmentmap of objectMap of attachment ID to attachment component.
attachment.*._idstringAttachment ID.
attachment.*.namestringComponent name.
attachment.*.propsobjectCustom component properties (key-value pairs).
attachment.*.cld_idstringCloud resource ID (set on cloud-imported components).
attachment.*.cld_typestringCloud account type. One of: "AWS", "GCP", "AZURE".
attachment.*.cld_syncbooleanWhether this component is synced with cloud.
attachment.*.cld_accountstringCloud account ID.
attachment.*.tagsarray of stringTags assigned to the component.
attachment.*.colorstringAttachment color.
attachment.*.iconstringAttachment icon identifier.
attachment.*.groupstringParent group ID.
attachment.*.issuesarray of objectIssues associated with this attachment.
attachment.*.issues[]._idstringIssue reference ID.
注意

The field list above is truncated. Expand the raw JSON schema below for the full structure.

Raw JSON schema
{
"type": "object",
"description": "Component collections of a diagram layer, keyed by component ID.",
"properties": {
"node": {
"type": "object",
"description": "Map of node ID to node component.",
"additionalProperties": {
"type": "object",
"required": [
"_id"
],
"description": "A node component (host, service, or application component).",
"properties": {
"_id": {
"type": "string",
"description": "Node ID."
},
"name": {
"type": "string",
"description": "Component name."
},
"props": {
"type": "object",
"additionalProperties": true,
"description": "Custom component properties (key-value pairs)."
},
"cld_id": {
"type": "string",
"description": "Cloud resource ID (set on cloud-imported components)."
},
"cld_type": {
"type": "string",
"enum": [
"AWS",
"GCP",
"AZURE"
],
"description": "Cloud account type."
},
"cld_sync": {
"type": "boolean",
"description": "Whether this component is synced with cloud."
},
"cld_account": {
"type": "string",
"description": "Cloud account ID."
},
"tags": {
"type": "array",
"description": "Tags assigned to the component.",
"items": {
"type": "string"
}
},
"color": {
"type": "string",
"description": "Node color."
},
"icon": {
"type": "string",
"description": "Node icon identifier."
},
"parent": {
"type": "string",
"description": "Parent node ID."
},
"infra_node": {
"type": "object",
"required": [
"_id",
"scheme_id",
"ss_id"
],
"description": "Reference to a linked infrastructure node in another diagram.",
"properties": {
"_id": {
"type": "string",
"description": "Infrastructure node ID."
},
"scheme_id": {
"type": "string",
"description": "Parent diagram ID."
},
"ss_id": {
"type": "string",
"description": "Parent layer ID."
}
}
},
"instance_count": {
"type": "integer",
"description": "Number of instances represented by this node."
},
"running": {
"type": "boolean",
"description": "Whether the node is currently running."
},
"issues": {
"type": "array",
"description": "Issues associated with this node.",
"items": {
"type": "object",
"description": "Issue annotation linked to a component.",
"properties": {
"_id": {
"type": "string",
"description": "Issue reference ID."
},
"comment": {
"type": "string",
"description": "Optional comment on the issue."
},
"snoozed": {
"type": "number",
"description": "Snooze duration in seconds."
},
"jira": {
"type": "string",
"description": "Linked Jira ticket key or URL."
}
}
}
}
}
}
},
"element": {
"type": "object",
"description": "Map of element ID to element component.",
"additionalProperties": {
"type": "object",
"required": [
"_id"
],
"description": "An element component (application-layer component).",
"properties": {
"_id": {
"type": "string",
"description": "Element ID."
},
"name": {
"type": "string",
"description": "Component name."
},
"props": {
"type": "object",
"additionalProperties": true,
"description": "Custom component properties (key-value pairs)."
},
"cld_id": {
"type": "string",
"description": "Cloud resource ID (set on cloud-imported components)."
},
"cld_type": {
"type": "string",
"enum": [
"AWS",
"GCP",
"AZURE"
],
"description": "Cloud account type."
},
"cld_sync": {
"type": "boolean",
"description": "Whether this component is synced with cloud."
},
"cld_account": {
"type": "string",
"description": "Cloud account ID."
},
"tags": {
"type": "array",
"description": "Tags assigned to the component.",
"items": {
"type": "string"
}
},
"color": {
"type": "string",
"description": "Element color."
},
"icon": {
"type": "string",
"description": "Element icon identifier."
},
"parent": {
"type": "string",
"description": "Parent element ID."
},
"issues": {
"type": "array",
"description": "Issues associated with this element.",
"items": {
"type": "object",
"description": "Issue annotation linked to a component.",
"properties": {
"_id": {
"type": "string",
"description": "Issue reference ID."
},
"comment": {
"type": "string",
"description": "Optional comment on the issue."
},
"snoozed": {
"type": "number",
"description": "Snooze duration in seconds."
},
"jira": {
"type": "string",
"description": "Linked Jira ticket key or URL."
}
}
}
}
}
}
},
"group": {
"type": "object",
"description": "Map of group ID to group component.",
"additionalProperties": {
"type": "object",
"required": [
"_id"
],
"description": "A group component (VPC, subnet, region, cluster, etc.).",
"properties": {
"_id": {
"type": "string",
"description": "Group ID."
},
"name": {
"type": "string",
"description": "Component name."
},
"props": {
"type": "object",
"additionalProperties": true,
"description": "Custom component properties (key-value pairs)."
},
"cld_id": {
"type": "string",
"description": "Cloud resource ID (set on cloud-imported components)."
},
"cld_type": {
"type": "string",
"enum": [
"AWS",
"GCP",
"AZURE"
],
"description": "Cloud account type."
},
"cld_sync": {
"type": "boolean",
"description": "Whether this component is synced with cloud."
},
"cld_account": {
"type": "string",
"description": "Cloud account ID."
},
"tags": {
"type": "array",
"description": "Tags assigned to the component.",
"items": {
"type": "string"
}
},
"group_type": {
"type": "string",
"enum": [
"account",
"az",
"azure_subscription",
"customer_gateway",
"ecs",
"eks",
"aks",
"k8s_namespace",
"k8s_pod",
"k8s_deployment",
"k8s_daemon_set",
"k8s_replica_set",
"k8s_stateful_set",
"project",
"region",
"security_group",
"subnet",
"vpc",
"gcp_instance_group",
"gcp_managed_zone",
"gke_cluster",
"azure_dns_zone",
"azure_cdn_profile",
"azure_resource_group"
],
"description": "Group type."
},
"color": {
"type": "string",
"description": "Group color."
},
"icon": {
"type": "string",
"description": "Group icon identifier."
},
"items": {
"type": "array",
"description": "Components contained in the group.",
"items": {
"type": "object",
"required": [
"_id",
"type"
],
"description": "Reference to a component contained within a group.",
"properties": {
"_id": {
"type": "string",
"description": "Component ID."
},
"type": {
"type": "string",
"enum": [
"attachment",
"combiner",
"element",
"group",
"link",
"node",
"note",
"scheme",
"statussheet"
],
"description": "Component type."
}
}
}
},
"issues": {
"type": "array",
"description": "Issues associated with this group.",
"items": {
"type": "object",
"description": "Issue annotation linked to a component.",
"properties": {
"_id": {
"type": "string",
"description": "Issue reference ID."
},
"comment": {
"type": "string",
"description": "Optional comment on the issue."
},
"snoozed": {
"type": "number",
"description": "Snooze duration in seconds."
},
"jira": {
"type": "string",
"description": "Linked Jira ticket key or URL."
}
}
}
}
}
}
},
"link": {
"type": "object",
"description": "Map of link ID to link component.",
"additionalProperties": {
"type": "object",
"required": [
"_id",
"origin",
"destination"
],
"description": "A link component connecting two nodes or groups.",
"properties": {
"_id": {
"type": "string",
"description": "Link ID."
},
"name": {
"type": "string",
"description": "Component name."
},
"props": {
"type": "object",
"additionalProperties": true,
"description": "Custom component properties (key-value pairs)."
},
"cld_id": {
"type": "string",
"description": "Cloud resource ID (set on cloud-imported components)."
},
"cld_type": {
"type": "string",
"enum": [
"AWS",
"GCP",
"AZURE"
],
"description": "Cloud account type."
},
"cld_sync": {
"type": "boolean",
"description": "Whether this component is synced with cloud."
},
"cld_account": {
"type": "string",
"description": "Cloud account ID."
},
"tags": {
"type": "array",
"description": "Tags assigned to the component.",
"items": {
"type": "string"
}
},
"connection_type": {
"type": "string",
"enum": [
"normal",
"tunnel",
"private",
"VPN",
"VPC Peering",
"Network Connectivity Center",
"Private Service Connect",
"Private Google Access",
"Serverless VPC",
"Serverless VPC Access Connector",
"Cross Cloud Interconnect",
"Partner Interconnect",
"Dedicated Interconnect"
],
"description": "Link connection type."
},
"origin": {
"type": "object",
"required": [
"_id",
"type",
"scheme_id",
"ss_id"
],
"description": "Reference to a diagram component, including its parent diagram and layer.",
"properties": {
"_id": {
"type": "string",
"description": "Component ID."
},
"type": {
"type": "string",
"enum": [
"attachment",
"combiner",
"element",
"group",
"link",
"node",
"note",
"scheme",
"statussheet"
],
"description": "Component type."
},
"scheme_id": {
"type": "string",
"description": "Parent diagram ID."
},
"ss_id": {
"type": "string",
"description": "Parent layer ID."
}
}
},
"destination": {
"type": "object",
"required": [
"_id",
"type",
"scheme_id",
"ss_id"
],
"description": "Reference to a diagram component, including its parent diagram and layer.",
"properties": {
"_id": {
"type": "string",
"description": "Component ID."
},
"type": {
"type": "string",
"enum": [
"attachment",
"combiner",
"element",
"group",
"link",
"node",
"note",
"scheme",
"statussheet"
],
"description": "Component type."
},
"scheme_id": {
"type": "string",
"description": "Parent diagram ID."
},
"ss_id": {
"type": "string",
"description": "Parent layer ID."
}
}
},
"owner_ss_id": {
"type": "string",
"description": "Owner layer ID for cross-diagram links."
},
"issues": {
"type": "array",
"description": "Issues associated with this link.",
"items": {
"type": "object",
"description": "Issue annotation linked to a component.",
"properties": {
"_id": {
"type": "string",
"description": "Issue reference ID."
},
"comment": {
"type": "string",
"description": "Optional comment on the issue."
},
"snoozed": {
"type": "number",
"description": "Snooze duration in seconds."
},
"jira": {
"type": "string",
"description": "Linked Jira ticket key or URL."
}
}
}
}
}
}
},
"attachment": {
"type": "object",
"description": "Map of attachment ID to attachment component.",
"additionalProperties": {
"type": "object",
"required": [
"_id"
],
"description": "An attachment component added to a group.",
"properties": {
"_id": {
"type": "string",
"description": "Attachment ID."
},
"name": {
"type": "string",
"description": "Component name."
},
"props": {
"type": "object",
"additionalProperties": true,
"description": "Custom component properties (key-value pairs)."
},
"cld_id": {
"type": "string",
"description": "Cloud resource ID (set on cloud-imported components)."
},
"cld_type": {
"type": "string",
"enum": [
"AWS",
"GCP",
"AZURE"
],
"description": "Cloud account type."
},
"cld_sync": {
"type": "boolean",
"description": "Whether this component is synced with cloud."
},
"cld_account": {
"type": "string",
"description": "Cloud account ID."
},
"tags": {
"type": "array",
"description": "Tags assigned to the component.",
"items": {
"type": "string"
}
},
"color": {
"type": "string",
"description": "Attachment color."
},
"icon": {
"type": "string",
"description": "Attachment icon identifier."
},
"group": {
"type": "string",
"description": "Parent group ID."
},
"issues": {
"type": "array",
"description": "Issues associated with this attachment.",
"items": {
"type": "object",
"description": "Issue annotation linked to a component.",
"properties": {
"_id": {
"type": "string",
"description": "Issue reference ID."
},
"comment": {
"type": "string",
"description": "Optional comment on the issue."
},
"snoozed": {
"type": "number",
"description": "Snooze duration in seconds."
},
"jira": {
"type": "string",
"description": "Linked Jira ticket key or URL."
}
}
}
}
}
}
},
"combiner": {
"type": "object",
"description": "Map of combiner ID to combiner component.",
"additionalProperties": {
"type": "object",
"required": [
"_id"
],
"description": "A combiner component that visually groups multiple components.",
"properties": {
"_id": {
"type": "string",
"description": "Combiner ID."
},
"name": {
"type": "string",
"description": "Combiner name."
},
"color": {
"type": "string",
"description": "Combiner color."
},
"icon": {
"type": "string",
"description": "Combiner icon identifier."
},
"items": {
"type": "array",
"description": "Components contained in the combiner.",
"items": {
"type": "object",
"required": [
"_id",
"type"
],
"description": "A component reference contained within a combiner.",
"properties": {
"_id": {
"type": "string",
"description": "Component ID."
},
"type": {
"type": "string",
"enum": [
"attachment",
"combiner",
"element",
"group",
"link",
"node",
"note",
"scheme",
"statussheet"
],
"description": "Component type."
}
}
}
}
}
}
},
"note": {
"type": "object",
"description": "Map of note ID to note component.",
"additionalProperties": {
"type": "object",
"required": [
"_id"
],
"description": "A text note placed on the diagram.",
"properties": {
"_id": {
"type": "string",
"description": "Note ID."
},
"text": {
"type": "string",
"description": "Note text content."
},
"color": {
"type": "string",
"description": "Note background color."
},
"font_size": {
"type": "number",
"description": "Note font size."
}
}
}
}
}
}

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 to exit code mapping
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: getstatussheetcomponents