create

This command creates an annotation to associate a human-readable description or value with a specific technical attestation key.

Usage

vhsm nitride annotation create @values.json [flags]

• @values.json: The JSON file containing the annotation payload

Structure: @values.json

• "key": The attestation value you want to label (e.g., a hash, PCR, measurement).

• "value": A human‑readable description for that value.

• "created" (optional): Unix timestamp; if omitted, the server sets it.

Flags

• Global HTTP Options

• Output Options

• Command Options

Example JSON:

{
  "key": "8aFCxTWG5+IiPsdOX00aSUKVax/ZrHj6/N+FEXqjRdo=",
  "value": "Kernel Command Line / Enclaive Buckypaper v1.0.0 / 2025-06-20"
}

Detailed Explanation

• "key": The exact attestation value you want to annotate. Can be plain text or base64; if it contains reserved URL characters (/, +, =), you may need to URL‑encode it when reading.

• "value": A clear, human‑readable label to make raw values understandable.

Example

Create an annotation

vhsm nitride annotation create @values.json

Output

Key        Value
---        -----
created    1755497783
key        8aFCxTWG5+IiPsdOX00aSUKVax/ZrHj6/N+FEXqjRdo=
value      Kernel Command Line / Enclaive Buckypaper v1.0.0 / 2025-06-20

Note: Keys containing “/” are treated like paths in listings. Use the full key when reading/deleting.