The below requirements are needed on the host that executes this module.
| Parameter | Choices/Defaults | Comments | 
|---|---|---|
|   api_key    - / required    |    Circonus API key   |  |
|   category    - / required    |    Annotation Category   |  |
|   description    - / required    |    Description of annotation   |  |
|   duration    -    |   Default: 0   |    Duration in seconds of annotation   |  
|   start    -    |   Default: "I(now)"   |    Unix timestamp of event start   |  
|   stop    -    |   Default: "I(now) + I(duration)"   |    Unix timestamp of event end   |  
|   title    - / required    |    Title of annotation   |  
Note
# Create a simple annotation event with a source, defaults to start and end time of now
- circonus_annotation:
    api_key: XXXXXXXXXXXXXXXXX
    title: App Config Change
    description: This is a detailed description of the config change
    category: This category groups like annotations
# Create an annotation with a duration of 5 minutes and a default start time of now
- circonus_annotation:
    api_key: XXXXXXXXXXXXXXXXX
    title: App Config Change
    description: This is a detailed description of the config change
    category: This category groups like annotations
    duration: 300
# Create an annotation with a start_time and end_time
- circonus_annotation:
    api_key: XXXXXXXXXXXXXXXXX
    title: App Config Change
    description: This is a detailed description of the config change
    category: This category groups like annotations
    start_time: 1395940006
    end_time: 1395954407
   Common return values are documented here, the following are the fields unique to this module:
| Key | Returned | Description | |
|---|---|---|---|
|   annotation    complex    |  success |   details about the created annotation   |  |
|   _cid    string    |  success |   annotation identifier  Sample:  /annotation/100000   |  |
|   _created    integer    |  success |   creation timestamp  Sample:  1502236928   |  |
|   _last_modified    integer    |  success |   last modification timestamp  Sample:  1502236928   |  |
|   _last_modified_by    string    |  success |   last modified by  Sample:  /user/1000   |  |
|   category    string    |  success |   category of the created annotation  Sample:  alerts   |  |
|   description    string    |  success |   description of the created annotation  Sample:  Host is down.   |  |
|   rel_metrics    list    |  success |   Array of metrics related to this annotation, each metrics is a string.  Sample:  ['54321_kbps']   |  |
|   start    integer    |  success |   timestamp, since annotation applies  Sample:  Host is down.   |  |
|   stop    string    |  success |   timestamp, since annotation ends  Sample:  Host is down.   |  |
|   title    string    |  success |   title of the created annotation  Sample:  WARNING   |  |
Hint
If you notice any issues in this documentation, you can edit this document to improve it.
    © 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
    https://docs.ansible.com/ansible/2.9/modules/circonus_annotation_module.html