Get Advisory

Get Advisory

Get the advisory with the specified id.

Request
URI
GET
https://{api_host}/cloudapi/1.0.0/advisories/{advisoryId}
COPY
Path Parameters
string
advisoryId
Required

advisory URN

string
advisoryId
Required

advisory URN

Authentication
This operation uses the following authentication methods.
Responses
200

OK

Returns Advisory of type(s) application/json;version=38.1 
{
    "id": "string",
    "targetId": "string",
    "message": "string",
    "priority": "string",
    "displayStart": "string",
    "displayEnd": "string",
    "source": "string"
}
string
id
Optional

A unique identifier for the advisory (read-only).

string
targetId
Required

The id reference to the target entity this advisory is for.

string
message
Required

A localized message for this advisory.

string
priority
Optional

Priority for an advisory that indicates the level of urgency. These priorities are listed in ascending sort order.

  • MANDATORY: A mandatory message which is always displayed; these advisories cannot be snoozed or dismissed (see documentation on displayStart and displayEnd)
  • CRITICAL: A high priority, potentially actionable message which can be snoozed or dismissed
  • IMPORTANT: A potentially actionable message which can be snoozed or dismissed
  • NOTICE: An informational message which can be dismissed (but not snoozed)
string As date-time As date-time
displayStart
Optional

The ISO-8601 timestamp from which this advisory is applicable. Defaults to the server's current time if unspecified. If permissible, users may update this value to a time in the future to snooze this advisory.

string As date-time As date-time
displayEnd
Required

The ISO-8601 timestamp representing when this advisory is no longer applicable. If permissible, users may update this value to a time in the past to dismiss this advisory. The displayEnd timestamp must be >= displayStart.

string
source
Optional

Represents where the advisory is being generated from. This is a read-only field. Can be of type USER or INTERNAL.


Availability
Added in 35.0
On This Page
Advisory Operations
POST
Create Advisory Definition
DELETE
Delete Advisory Definition
GET
Get Advisory
GET
Get Advisory Definition
GET
Query Advisories
GET
Query Advisory Definitions
PUT
Update Advisory