List of annotations for the incident
get
https://EM_HOST:EM_CONSOLE_HTTPS_PORT/em/api/incidents/{incidentId}/annotations
Returns a list of annotations for the incident with the most recent ones listed first by default.
Request
Path Parameters
-
incidentId(required): string(raw)
ID of the incident
Query Parameters
-
limit: integer(int32)
Limits number of items returned in current call. Use the self/previous/next links from the response to fetch additional items.Default Value:
50
-
page: string
Identifies the set of items to be fetched; "href" element from "links" list of the response provides encoded value for this parameter. "href" element value should be used "as is" for fetching respective set of items.Default Value:
Base64 encode value of 0 i.e MA==
-
sort: string
Sort results by supported resource attributes such as id, message, type, timeCreated and createdByExample:
type:ASC,timeCreated:DESC
There's no request body for this operation.
Back to TopResponse
Supported Media Types
- application/json
200 Response
Successful operation - Fetch all the related annotations to the incident
Root Schema : AnnotationCollection
Type:
object
List of annotations
Show Source
-
count: integer
(int32)
Number of rows returnedExample:
1
-
items(required): array
items
List of the annotation summary
-
links: object
links
Read Only:
true
URL links to paginated resource(s).
Nested Schema : items
Type:
array
List of the annotation summary
Show Source
-
Array of:
object AnnotationSummary
Details of an annotation
Nested Schema : links
Type:
object
Read Only:
true
URL links to paginated resource(s).
Show Source
-
next: object
Link
Represents a link(could be self, previous or next)
-
previous: object
Link
Represents a link(could be self, previous or next)
-
self(required): object
Link
Represents a link(could be self, previous or next)
Example:
{
"self":{
"href":"/em/api/incidents/C4E214A1172A2F19E053860E4B645AC7/annotations?page=MQ%3D%3D&limit=50"
},
"next":{
"href":"/em/api/incidents/C4E214A1172A2F19E053860E4B645AC7/annotations?page=Mg%3D%3D&limit=50"
},
"previous":{
"href":"/em/api/incidents/C4E214A1172A2F19E053860E4B645AC7/annotations?page=MA%3D%3D&limit=50"
}
}
Nested Schema : AnnotationSummary
Type:
object
Details of an annotation
Show Source
-
createdBy: string
Read Only:
true
Creator of the annotation - User or SYSTEMExample:SYSMAN
-
id: string
Read Only:
true
Unique identifier of the annotation in context of the current objectExample:131
-
message(required): string
Minimum Length:
1
Maximum Length:4000
Text for the annotationExample:Suppression removed as the underlying issue resolved
-
timeCreated: string
(datetime)
Read Only:
true
Time when the annotation is createdExample:2021-07-21T06:25:43.000Z
-
type(required): string
Allowed Values:
[ "USER_COMMENT", "NOTIFICATION", "SYSTEM" ]
Annotation typeExample:USER_COMMENT
Nested Schema : Link
Type:
object
Represents a link(could be self, previous or next)
Show Source
-
href: string
URL for LinkExample:
/em/api/<resources>?page=b2Zmc2V0OjA&limit=0
400 Response
Bad Request
Root Schema : ErrorResponse
Type:
object
Error response
Show Source
-
code(required): string
A short error code that defines the error, meant for programmatic parsing
-
message(required): string
A human-readable error string
401 Response
Unauthorized
Root Schema : ErrorResponse
Type:
object
Error response
Show Source
-
code(required): string
A short error code that defines the error, meant for programmatic parsing
-
message(required): string
A human-readable error string
404 Response
Not Found
Root Schema : ErrorResponse
Type:
object
Error response
Show Source
-
code(required): string
A short error code that defines the error, meant for programmatic parsing
-
message(required): string
A human-readable error string
500 Response
Internal Server Error
Root Schema : ErrorResponse
Type:
object
Error response
Show Source
-
code(required): string
A short error code that defines the error, meant for programmatic parsing
-
message(required): string
A human-readable error string
503 Response
Service Unavailable
Root Schema : ErrorResponse
Type:
object
Error response
Show Source
-
code(required): string
A short error code that defines the error, meant for programmatic parsing
-
message(required): string
A human-readable error string