---
name: "cloud-id"
section: "1"
platform: "linux"
package: "cloud-init"
version: "26.2-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/cloud-id"
---

# cloud-id(1)

Report the canonical cloud-id for this instance

## NAME

cloud-id - Report the canonical cloud-id for this instance

## SYNOPSIS

**cloud-id** \[-h\] \[-j\] \[-l\] \[-i \<INSTANCE\_DATA\>\]

## DESCRIPTION

cloud-id is the lowercase name of the cloud datasource discovered.

The cloud-id will be 'not run' when systemd generator has not run yet. The cloud-id will be 'disabled' when cloud-init is disabled or when ds-identify did not find a valid datasource.

See cloud-init status --long for more information.

## OPTIONS

- **-h, --help**

  Show help message and exit

- **-j, --json**

  Report all standardized cloud-id information as json

- **-l, --long**

  Report extended cloud-id information as tab-delimited string

## EXIT STATUS

- 0

  On success

- 1

  Due to an error

- 2

  Due to cloud-init in a disabled state. See: cloud-init status --long

- 3

  The cloud-init generator and discovery has not yet run.

## COPYRIGHT

Copyright (C) 2021 Canonical Ltd. License GPL-3 or Apache-2.0

## SEE ALSO

Full documentation at: \<https://docs.cloud-init.io\>