Skip to main content
REST API reference

Retrieve the web services configuration

Accesses the web services configuration to review current settings and configurations. This is useful for ensuring that your web services are correctly set up and operating as expected.

HTTP method and endpoint

GET /cluster/web

Introduced in

ONTAP 9.10

Usage notes

Retrieves the web services configuration.

  • system services web show

  • security ssl show

Parameters

Name Type In Required Description

fields

array[string]

query

False

Specify the fields to return.

Response

Status: 200, Ok
Name Type Description

_links

_links

certificate

certificate

Certificate used by cluster and node management interfaces for TLS connection requests.

client_enabled

boolean

Indicates whether client authentication is enabled.

csrf

csrf

enabled

boolean

Indicates whether remote clients can connect to the web services.

hsts

hsts

http_enabled

boolean

Indicates whether HTTP is enabled.

http_port

integer

HTTP port for cluster-level web services.

https_port

integer

HTTPS port for cluster-level web services.

ocsp_enabled

boolean

Indicates whether online certificate status protocol verification is enabled.

per_address_limit

integer

The number of connections that can be processed concurrently from the same remote address.

state

string

State of the cluster-level web services.

wait_queue_capacity

integer

The maximum size of the wait queue for connections exceeding the per-address-limit.

Example response
{
  "_links": {
    "self": {
      "href": "/api/resourcelink"
    }
  },
  "certificate": {
    "_links": {
      "self": {
        "href": "/api/resourcelink"
      }
    },
    "name": "cert1",
    "uuid": "1cd8a442-86d1-11e0-ae1c-123478563412"
  },
  "csrf": {
    "token": {
      "concurrent_limit": 120,
      "idle_timeout": 200,
      "max_timeout": 1200
    }
  },
  "hsts": {
    "max_age": 31536000
  },
  "per_address_limit": 42,
  "state": "string"
}

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

href

Name Type Description

href

string

Name Type Description

self

href

certificate

Certificate used by cluster and node management interfaces for TLS connection requests.

Name Type Description

_links

_links

name

string

Certificate name

uuid

string

Certificate UUID

token

Name Type Description

concurrent_limit

integer

Maximum number of concurrent CSRF tokens.

idle_timeout

integer

Time for which an unused CSRF token is retained, in seconds.

max_timeout

integer

Time for which an unused CSRF token, regardless of usage is retained, in seconds.

csrf

Name Type Description

protection_enabled

boolean

Indicates whether CSRF protection is enabled.

token

token

hsts

Name Type Description

enabled

boolean

Indicates whether HTTP Strict Transport Security (HSTS) is enabled.

max_age

integer

HTTPS Strict Transport Security (HSTS) max-age value in seconds. The maximum time, in seconds, that the browser should remember that a site is only to be accessed using HTTPS.

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.