Get Notification

• Notifications

Client API to get notification by Id

Request

URI

GET

https://stg.skyscraper.vmware.com/api/notification/{orgId}/notifications/{id}

COPY

Path Parameters

string

orgId

Required

Org ID

string

id

Required

Notification ID

---

Authentication

This operation uses the following authentication methods.

BearerTokenAuth

Responses

200

Hide Details

OK

Returns NotificationResponse of type(s) application/json

{
    "created": "string",
    "updated": "string",
    "version": 0,
    "user_name": "string",
    "id": "string",
    "status": "string",
    "notification_type": "string",
    "omnichannels": [
        {
            "name": "string",
            "template_tags_selector": {
                "template_tags_selector": [
                    "string"
                ]
            },
            "email_preferences": {
                "cc": [
                    "string"
                ],
                "bcc": [
                    "string"
                ],
                "operation": "string",
                "recipients": [
                    {
                        "email": "string",
                        "locale": "string"
                    }
                ]
            },
            "visual_components": [
                "string"
            ],
            "allowed_roles": [
                "string"
            ],
            "operation": "string"
        }
    ],
    "initiated_by": "string",
    "client_id": "string",
    "client_created_date": "string",
    "callback": {
        "callback_uri": "string",
        "callback_headers": {
            "callback_headers": "string"
        }
    },
    "payload": {
        "payload": "string"
    },
    "org_id": "string",
    "deployment": "string",
    "provider": "string",
    "resource_type": "string",
    "resource_id": "string",
    "error_message": "string",
    "expiry_date": "string",
    "parent_id": "string",
    "resource_name": "string",
    "category": "string",
    "name": "string",
    "description": "string",
    "priority": "string",
    "translation_id": "string",
    "translated": false,
    "created_by": "[email protected]"
}

string As date-time As date-time

created

Optional

The creation date of entity.

string As date-time As date-time

updated

Optional

The update date of entity.

integer As int32 As int32

version

Optional

Version of this entity.

string

user_name

Optional

user_name

string As uuid As uuid

id

Optional

The id of notification.

string

status

Optional

status

Possible values are : RECEIVED, SENDING, PROCESSING_FAILED, SENT, FAILED, CANCELED, PARTIAL_SENT, SCHEDULED,

string

notification_type

Required

The type of notification.

array of object

omnichannels

Optional

Channel

string

initiated_by

Optional

initiated_by

string As uuid As uuid

client_id

Required

The client Id. For example, Operation Service will send Operation Id

string As date-time As date-time

client_created_date

Optional

Timestamp when the event that triggers the notification was created

object

callback

Optional

callback

object

payload

Optional

External payload of notification.

string As uuid As uuid

org_id

Required

The org id of the notification.

string

deployment

Optional

The deployment type - AWS, Outpost, vSphere, Dimension and CFC

string

provider

Optional

The deployment type - AWS, Outpost, vSphere, Dimension and CFC

string

resource_type

Required

The Resource type of the notification.

string As uuid As uuid

resource_id

Required

The Id of resource that generated the notification.

string

error_message

Optional

Error message provided by client services.

string As date-time As date-time

expiry_date

Optional

Timestamp when the notification will expire(valid only for VMCUI channel)

string As uuid As uuid

parent_id

Optional

The Id of the parent notification if present.

string

resource_name

Optional

Human-readable name of the resource.

string

category

Optional

The category of the notification.

string

name

Optional

Human-readable short representation of notification type.

string

description

Optional

Human-readable long representation of notification type.

string

priority

Optional

The priority of notification. Allowed values - Critical, Warning, Information, Error, Success or their translations for the supported locales

string As uuid As uuid

translation_id

Optional

translation_id

boolean

translated

Optional

translated

string

created_by

Optional

The username of the person/app who created the notification

401

Hide Details

Unauthorized

Returns NotificationResponse of type(s) application/json

"NotificationResponse Object"

string As date-time As date-time

created

Optional

The creation date of entity.

string As date-time As date-time

updated

Optional

The update date of entity.

integer As int32 As int32

version

Optional

Version of this entity.

string

user_name

Optional

user_name

string As uuid As uuid

id

Optional

The id of notification.

string

status

Optional

status

Possible values are : RECEIVED, SENDING, PROCESSING_FAILED, SENT, FAILED, CANCELED, PARTIAL_SENT, SCHEDULED,

string

notification_type

Required

The type of notification.

array of object

omnichannels

Optional

Channel

string

initiated_by

Optional

initiated_by

string As uuid As uuid

client_id

Required

The client Id. For example, Operation Service will send Operation Id

string As date-time As date-time

client_created_date

Optional

Timestamp when the event that triggers the notification was created

object

callback

Optional

callback

object

payload

Optional

External payload of notification.

string As uuid As uuid

org_id

Required

The org id of the notification.

string

deployment

Optional

The deployment type - AWS, Outpost, vSphere, Dimension and CFC

string

provider

Optional

The deployment type - AWS, Outpost, vSphere, Dimension and CFC

string

resource_type

Required

The Resource type of the notification.

string As uuid As uuid

resource_id

Required

The Id of resource that generated the notification.

string

error_message

Optional

Error message provided by client services.

string As date-time As date-time

expiry_date

Optional

Timestamp when the notification will expire(valid only for VMCUI channel)

string As uuid As uuid

parent_id

Optional

The Id of the parent notification if present.

string

resource_name

Optional

Human-readable name of the resource.

string

category

Optional

The category of the notification.

string

name

Optional

Human-readable short representation of notification type.

string

description

Optional

Human-readable long representation of notification type.

string

priority

Optional

The priority of notification. Allowed values - Critical, Warning, Information, Error, Success or their translations for the supported locales

string As uuid As uuid

translation_id

Optional

translation_id

boolean

translated

Optional

translated

string

created_by

Optional

The username of the person/app who created the notification

403

Hide Details

Forbidden

Returns NotificationResponse of type(s) application/json

"NotificationResponse Object"

string As date-time As date-time

created

Optional

The creation date of entity.

string As date-time As date-time

updated

Optional

The update date of entity.

integer As int32 As int32

version

Optional

Version of this entity.

string

user_name

Optional

user_name

string As uuid As uuid

id

Optional

The id of notification.

string

status

Optional

status

Possible values are : RECEIVED, SENDING, PROCESSING_FAILED, SENT, FAILED, CANCELED, PARTIAL_SENT, SCHEDULED,

string

notification_type

Required

The type of notification.

array of object

omnichannels

Optional

Channel

string

initiated_by

Optional

initiated_by

string As uuid As uuid

client_id

Required

The client Id. For example, Operation Service will send Operation Id

string As date-time As date-time

client_created_date

Optional

Timestamp when the event that triggers the notification was created

object

callback

Optional

callback

object

payload

Optional

External payload of notification.

string As uuid As uuid

org_id

Required

The org id of the notification.

string

deployment

Optional

The deployment type - AWS, Outpost, vSphere, Dimension and CFC

string

provider

Optional

The deployment type - AWS, Outpost, vSphere, Dimension and CFC

string

resource_type

Required

The Resource type of the notification.

string As uuid As uuid

resource_id

Required

The Id of resource that generated the notification.

string

error_message

Optional

Error message provided by client services.

string As date-time As date-time

expiry_date

Optional

Timestamp when the notification will expire(valid only for VMCUI channel)

string As uuid As uuid

parent_id

Optional

The Id of the parent notification if present.

string

resource_name

Optional

Human-readable name of the resource.

string

category

Optional

The category of the notification.

string

name

Optional

Human-readable short representation of notification type.

string

description

Optional

Human-readable long representation of notification type.

string

priority

Optional

The priority of notification. Allowed values - Critical, Warning, Information, Error, Success or their translations for the supported locales

string As uuid As uuid

translation_id

Optional

translation_id

boolean

translated

Optional

translated

string

created_by

Optional

The username of the person/app who created the notification

404

Hide Details

Not Found

Returns ErrorResponse of type(s) application/json

"ErrorResponse Object"

object

messages

Optional

Message of Error

string

type

Optional

type

500

Hide Details

Server Internal Error

Returns ErrorResponse of type(s) application/json

"ErrorResponse Object"

object

messages

Optional

Message of Error

string

type

Optional

type

Code Samples

COPY

                    curl -H 'Authorization: <value>' https://{api_host}/api/notification/{orgId}/notifications/{id}
                

On This Page

Description

Request

Path Parameters

Authentication

Response

200 Response Body

Errors

Notifications Operations

GET

Get Notifications

GET

Get Notification