Release: get attestation by id (#624)

* Add --artifact-id flag to get attestation command

* Tidy up tests and documentation

---------

Co-authored-by: Faye <[email protected]>

Author: jumboduck

docs.kosli.com/assets/metadata.json

@@ -1 +1 @@
-{"currentversion": "v2.11.35"}
+{"currentversion": "v2.11.36"}

docs.kosli.com/content/client_reference/kosli_get_attestation.md

@@ -2,37 +2,39 @@
 title: "kosli get attestation"
 beta: false
 deprecated: false
-summary: "Get attestation by name from a specified trail or artifact.  "
+summary: "Get an attestation using its name or id.  "
 ---
 
 # kosli get attestation
 
 ## Synopsis
 
 ```shell
-kosli get attestation ATTESTATION-NAME [flags]
+kosli get attestation [ATTESTATION-NAME] [flags]
 ```
 
-Get attestation by name from a specified trail or artifact.  
-You can get an attestation from a trail or artifact using its name. The attestation name should be given
-WITHOUT dot-notation.
-
-To get an attestation from a trail, specify the trail name using the --trail flag.  
-To get an attestation from an artifact, specify the artifact fingerprint using the --fingerprint flag.
-
-In both cases the flow must also be specified using the --flow flag.
+Get an attestation using its name or id.  
 
+You can get an attestation from a trail or artifact using its name. The attestation name should be given
+WITHOUT dot-notation.  
+To get an attestation from a trail, specify the trail name using the `--trail` flag.  
+To get an attestation from an artifact, specify the artifact fingerprint using the `--fingerprint` flag.  
+These flags cannot be used together. In both cases the flow must also be specified using the `--flow` flag.  
 If there are multiple attestations with the same name on the trail or artifact, a list of all will be returned.
 
+You can also get an attestation by its id using the `--attestation-id` flag. This cannot be used with the attestation name,
+or any of the `--flow`, `--trail` or `--fingerprint` flags.
+
 
 ## Flags
 | Flag | Description |
 | :--- | :--- |
-|    -F, --fingerprint string  |  [conditional] The fingerprint of the artifact for the attestation. Cannot be used together with --trail.  |
-|    -f, --flow string  |  The Kosli flow name.  |
+|        --attestation-id string  |  [conditional] The unique identifier of the attestation to retrieve. Cannot be used together with ATTESTATION-NAME.  |
+|    -F, --fingerprint string  |  [conditional] The fingerprint of the artifact for the attestation. Cannot be used together with --trail or --attestation-id.  |
+|    -f, --flow string  |  [conditional] The name of the Kosli flow for the attestation. Required if ATTESTATION-NAME provided. Cannot be used together with --attestation-id.  |
 |    -h, --help  |  help for attestation  |
 |    -o, --output string  |  [defaulted] The format of the output. Valid formats are: [table, json]. (default "table")  |
-|    -t, --trail string  |  [conditional] The name of the Kosli trailfor the attestation. Cannot be used together with --fingerprint.  |
+|    -t, --trail string  |  [conditional] The name of the Kosli trail for the attestation. Cannot be used together with --fingerprint or --attestation-id.  |
 
 
 ## Flags inherited from parent commands
@@ -57,17 +59,24 @@ kosli get attestation snyk-container-scan --flow=differ-ci --fingerprint=0cbbe3a
 
 These examples all assume that the flags  `--api-token`, `--org`, `--host`, (and `--flow`, `--trail` when required), are [set/provided](https://docs.kosli.com/getting_started/install/#assigning-flags-via-environment-variables). 
 
-##### get an attestation from a trail (requires the --trail flag)
+##### get an attestation by name from a trail (requires the --trail flag)
 
 ```shell
 kosli get attestation attestationName 
 
 ```
 
-##### get an attestation from an artifact
+##### get an attestation by name from an artifact
 
 ```shell
 kosli get attestation attestationName 
 	--fingerprint fingerprint
+
+```
+
+##### get an attestation by its id
+
+```shell
+kosli get attestation --attestation-id attestationID
 ```
 

docs.kosli.com/content/legacy_ref/v2.11.30/_index.md

@@ -1,7 +1,7 @@
 ---
 title: v2.11.31
 bookCollapseSection: true
-weight: 603
+weight: 604
 ---
 
 # v2.11.31

docs.kosli.com/content/legacy_ref/v2.11.31/_index.md

@@ -1,7 +1,7 @@
 ---
 title: v2.11.32
 bookCollapseSection: true
-weight: 602
+weight: 603
 ---
 
 # v2.11.32

docs.kosli.com/content/legacy_ref/v2.11.32/_index.md

@@ -1,7 +1,7 @@
 ---
 title: v2.11.33
 bookCollapseSection: true
-weight: 601
+weight: 602
 ---
 
 # v2.11.33

docs.kosli.com/content/legacy_ref/v2.11.33/_index.md

@@ -1,7 +1,7 @@
 ---
 title: v2.11.34
 bookCollapseSection: true
-weight: 600
+weight: 601
 ---
 
 # v2.11.34

docs.kosli.com/content/legacy_ref/v2.11.34/_index.md

@@ -0,0 +1,7 @@
+---
+title: v2.11.35
+bookCollapseSection: true
+weight: 600
+---
+
+# v2.11.35