REST API - list

vcenter system announcements: list

Return information about all the announcements in the system.

Request:

HTTP request

GET https://{server}/rest/vcenter/system/announcements
No request parameters

Response:

HTTP Status Code: 200

Representation:

{
    "value"[
        {
            "value"{
                "severity""CRITICAL",
                "expires_at""2015-01-01T22:13:05.651Z",
                "message"{
                    "args"[
                        "string",
                        "string"
                    ],
                    "default_message""string",
                    "localized""string",
                    "id""string",
                    "params"[
                        {
                            "value"{
                                "dt""2015-01-01T22:13:05.651Z",
                                "s""string",
                                "d"1.5,
                                "precision"1,
                                "format""SHORT_DATE",
                                "i"1,
                                "l"{
                                    "id""string",
                                    "params"[
                                        {
                                            "value"{
                                                "dt""2015-01-01T22:13:05.651Z",
                                                "s""string",
                                                "d"1.5,
                                                "precision"1,
                                                "format""SHORT_DATE",
                                                "i"1,
                                                "l"{
                                                    "id""string",
                                                    "params"[
                                                        {
                                                            "key""string"
                                                        }
                                                    ]
                                                }
                                            },
                                            "key""string"
                                        }
                                    ]
                                }
                            },
                            "key""string"
                        }
                    ]
                }
            },
            "key""obj-103"
        }
    ]
}

Response Type:

Name Type Description
bold = required
value list Map from announcement identifier to announcement Info structures. List of {"key": string, "value": info}
value[].key string
value[].value info
value[].value.message localizable_message Message to display

value[].value.message.id string Unique identifier of the localizable string or message template.

This identifier is typically used to retrieve a locale-specific string or message template from a message catalog.

value[].value.message.default_message string The value of this localizable string or message template in the en_US (English) locale. If vapi.std.localizable_message.id refers to a message template, the default message will contain the substituted arguments. This value can be used by clients that do not need to display strings and messages in the native language of the user. It could also be used as a fallback if a client is unable to access the appropriate message catalog.

value[].value.message.args string[] Positional arguments to be substituted into the message template. This list will be empty if the message uses named arguments or has no arguments.

Errors:

HTTP Status Code Type Description
500 error Generic error