Create and send an AutoSupport message
- PDF of this doc site
Collection of separate PDF docs
Creating your file...
POST /support/autosupport/messages
Introduced In: 9.6
Creates and sends an AutoSupport message with the provided input parameters.
Important note:
-
By default, the response is an empty object. If
return_records=true
is passed in the request, the response includes information about the node and the index of the invoked AutoSupport message.
Recommended optional properties
-
message
- Message included in the AutoSupport subject. Use this to identify the generated AutoSupport message.
Default property values
If not specified in POST, the following are the default property values:
-
type
- all -
node.name
ornode.uuid
- Not specifying these properties invokes AutoSupport on all nodes in the cluster.
Related ONTAP commands
-
system node autosupport invoke
Learn more
Parameters
Name | Type | In | Required | Description |
---|---|---|---|---|
return_records |
boolean |
query |
False |
The default is false. If set to true, the records are returned.
|
Request Body
Name | Type | Description |
---|---|---|
destination |
string |
Destination for the AutoSupport |
error |
Last error during delivery attempt. Empty if "status=sent-successful". |
|
generated_on |
string |
Date and Time of AutoSupport generation in ISO-8601 format |
index |
integer |
Sequence number of the AutoSupport |
message |
string |
Message included in the AutoSupport subject |
node |
||
state |
string |
State of AutoSupport delivery |
subject |
string |
Subject line for the AutoSupport |
type |
string |
Type of AutoSupport collection to issue |
uri |
string |
Alternate destination for the AutoSupport |
Example request
{
"destination": "http",
"error": {
"code": 53149746,
"message": "Could not resolve host: test.com"
},
"generated_on": "2019-03-25T17:30:04-04:00",
"index": 9,
"message": "invoked_test_autosupport_rest",
"node": {
"_links": {
"self": {
"href": "/api/resourcelink"
}
},
"name": "node1",
"uuid": "1cd8a442-86d1-11e0-ae1c-123478563412"
},
"state": "sent_successful",
"subject": "WEEKLY_LOG",
"type": "test",
"uri": "http://1.2.3.4/delivery_uri"
}
Response
Status: 201, Created
Name | Type | Description |
---|---|---|
_links |
||
num_records |
integer |
Number of records |
records |
array[records] |
Example response
{
"_links": {
"self": {
"href": "/api/resourcelink"
}
},
"num_records": 3,
"records": [
{
"_links": {
"self": {
"href": "/api/resourcelink"
}
},
"index": 9,
"node": {
"_links": {
"self": {
"href": "/api/resourcelink"
}
},
"name": "node1",
"uuid": "1cd8a442-86d1-11e0-ae1c-123478563412"
}
}
]
}
Headers
Name | Description | Type |
---|---|---|
Location |
Useful for tracking the resource location |
string |
Error
Status: Default
ONTAP Error Response Codes
Error Code | Description |
---|---|
8650866 |
The message parameter is not supported with performance AutoSupports |
53149748 |
The destination URI provided for the invoked AutoSupport is invalid |
Name | Type | Description |
---|---|---|
error |
Example error
{
"error": {
"arguments": [
{
"code": "string",
"message": "string"
}
],
"code": "4",
"message": "entry doesn't exist",
"target": "uuid"
}
}
Definitions
See Definitions
error
Last error during delivery attempt. Empty if "status=sent-successful".
Name | Type | Description |
---|---|---|
code |
integer |
Error code |
message |
string |
Error message |
href
Name | Type | Description |
---|---|---|
href |
string |
_links
Name | Type | Description |
---|---|---|
self |
node
Name | Type | Description |
---|---|---|
_links |
||
name |
string |
|
uuid |
string |
autosupport_message
Name | Type | Description |
---|---|---|
destination |
string |
Destination for the AutoSupport |
error |
Last error during delivery attempt. Empty if "status=sent-successful". |
|
generated_on |
string |
Date and Time of AutoSupport generation in ISO-8601 format |
index |
integer |
Sequence number of the AutoSupport |
message |
string |
Message included in the AutoSupport subject |
node |
||
state |
string |
State of AutoSupport delivery |
subject |
string |
Subject line for the AutoSupport |
type |
string |
Type of AutoSupport collection to issue |
uri |
string |
Alternate destination for the AutoSupport |
records
Name | Type | Description |
---|---|---|
_links |
||
index |
integer |
Sequence number of the generated AutoSupport |
node |
error_arguments
Name | Type | Description |
---|---|---|
code |
string |
Argument code |
message |
string |
Message argument |
error
Name | Type | Description |
---|---|---|
arguments |
array[error_arguments] |
Message arguments |
code |
string |
Error code |
message |
string |
Error message |
target |
string |
The target parameter that caused the error. |