Skip to main content

Retrieve the AutoSupport configuration

Contributors
PDFs

GET /support/autosupport

Introduced In: 9.6

Retrieves the AutoSupport configuration of the cluster and if requested, returns connectivity issues with the AutoSupport configuration.

Important note:

  • The issues field consists of a list of objects containing details of the node that has a connectivity issue, the issue description, and corrective action you can take to address the issue. When not empty, this indicates a connection issue to the HTTPS, SMTP, or AutoSupport On Demand server.

Expensive properties

There is an added computational cost to retrieving values for these properties. They are not included by default in GET results and must be explicitly requested using the fields query parameter. See Requesting specific fields to learn more.

  • issues

  • system node autosupport show -instance

  • system node autosupport check show-details

Learn more

Parameters

Name Type In Required Description

fields

array[string]

query

False

Specify the fields to return.

Response

Status: 200, Ok
Name Type Description

contact_support

boolean

Specifies whether to send the AutoSupport messages to vendor support.

enabled

boolean

Specifies whether the AutoSupport daemon is enabled. When this setting is disabled, delivery of all AutoSupport messages is turned off.

from

string

The e-mail address from which the AutoSupport messages are sent. To generate node-specific 'from' addresses, enable '-node-specific-from' parameter via ONTAP CLI.

is_minimal

boolean

Specifies whether the system information is collected in compliant form, to remove private data or in complete form, to enhance diagnostics.

issues

array[autosupport_issues]

A list of connectivity issues to the HTTPS/SMTP/AOD AutoSupport destinations on the nodes in the cluster along with the corrective actions.

mail_hosts

array[string]

The names of the mail servers used to deliver AutoSupport messages via SMTP.

partner_addresses

array[string]

The list of partner addresses.

proxy_url

string

Proxy server for AutoSupport message delivery via HTTPS. Optionally specify a username/password for authentication with the proxy server.

smtp_encryption

string

The encryption protocol used to deliver AutoSupport messages via SMTP to the configured mail_hosts.

to

array[string]

The e-mail addresses to which the AutoSupport messages are sent.

transport

string

The name of the transport protocol used to deliver AutoSupport messages.

Note 'http' transport is no longer supported by AutoSupport servers.
Example response 
{
  "contact_support": 1,
  "enabled": 1,
  "from": "postmaster@example.com",
  "is_minimal": 1,
  "issues": [
    {
      "component": "mail_server",
      "corrective_action": {
        "code": "53149746",
        "message": "Check the hostname of the SMTP server"
      },
      "destination": "mailhost1.example.com",
      "issue": {
        "code": "53149746",
        "message": "SMTP connectivity check failed for destination: mailhost. Error: Could not resolve host - 'mailhost'"
      },
      "node": {
        "_links": {
          "self": {
            "href": "/api/resourcelink"
          }
        },
        "name": "node1",
        "uuid": "1cd8a442-86d1-11e0-ae1c-123478563412"
      }
    }
  ],
  "mail_hosts": [
    "mailhost1.example.com",
    "mailhost2.example.com"
  ],
  "partner_addresses": [
    "user1@partner.com",
    "user2@partner.com"
  ],
  "proxy_url": "proxy.company.com",
  "smtp_encryption": "none",
  "to": [
    "user1@example.com",
    "user2@example.com"
  ],
  "transport": "smtp"
}

Error

Status: Default, Error
Name Type Description

error

returned_error
Example error 
{
  "error": {
    "arguments": [
      {
        "code": "string",
        "message": "string"
      }
    ],
    "code": "4",
    "message": "entry doesn't exist",
    "target": "uuid"
  }
}

Definitions

See Definitions

autosupport_connectivity_corrective_action

Name Type Description

code

string

Corrective action code

message

string

Corrective action message. The corrective action might contain commands which needs to be executed on the ONTAP CLI.

  • example: Check the hostname of the SMTP server

  • readOnly: 1

  • Introduced in: 9.6

  • x-nullable: true

autosupport_connectivity_issue

Name Type Description

code

string

Error code

message

string

Error message

href

Name Type Description

href

string

_links

Name Type Description

self

href

node

Name Type Description

_links

_links

name

string

uuid

string

autosupport_issues

Name Type Description

component

string

The name of the component where the issue occurred.

corrective_action

autosupport_connectivity_corrective_action

destination

string

The HTTPS/SMTP/AOD AutoSupport Destination.

issue

autosupport_connectivity_issue

node

node

error_arguments

Name Type Description

code

string

Argument code

message

string

Message argument

returned_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.