Skip to main content
A newer release of this product is available.

Retrieve CIFS session information for all SVMs

Contributors
PDFs

GET /protocols/cifs/sessions

Introduced In: 9.8

Retrieves the CIFS sessions information for all SVMs.

  • vserver cifs session show -active-volumes

Learn more

Parameters

Name Type In Required Description

client_ip

string

query

False

Filter by client_ip

open_other

integer

query

False

Filter by open_other

node.name

string

query

False

Filter by node.name

node.uuid

string

query

False

Filter by node.uuid

large_mtu

boolean

query

False

Filter by large_mtu

idle_duration

string

query

False

Filter by idle_duration

connection_count

integer

query

False

Filter by connection_count

mapped_unix_user

string

query

False

Filter by mapped_unix_user

identifier

integer

query

False

Filter by identifier

continuous_availability

string

query

False

Filter by continuous_availability

smb_encryption

string

query

False

Filter by smb_encryption

open_files

integer

query

False

Filter by open_files

smb_signing

boolean

query

False

Filter by smb_signing

volumes.name

string

query

False

Filter by volumes.name

volumes.uuid

string

query

False

Filter by volumes.uuid

connected_duration

string

query

False

Filter by connected_duration

authentication

string

query

False

Filter by authentication

svm.uuid

string

query

False

Filter by svm.uuid

svm.name

string

query

False

Filter by svm.name

server_ip

string

query

False

Filter by server_ip

user

string

query

False

Filter by user

connection_id

integer

query

False

Filter by connection_id

open_shares

integer

query

False

Filter by open_shares

protocol

string

query

False

Filter by protocol

fields

array[string]

query

False

Specify the fields to return.

max_records

integer

query

False

Limit the number of records returned.

return_timeout

integer

query

False

The number of seconds to allow the call to execute before returning. When iterating over a collection, the default is 15 seconds. ONTAP returns earlier if either max records or the end of the collection is reached.

  • Default value: 1

  • Max value: 120

  • Min value: 0

return_records

boolean

query

False

The default is true for GET calls. When set to false, only the number of records is returned.

  • Default value: 1

order_by

array[string]

query

False

Order results by specified fields and optional [asc

Response

Status: 200, Ok
Name Type Description

_links

_links

num_records

integer

Number of records

records

array[cifs_session]
Example response 
{
  "_links": {
    "next": {
      "href": "/api/resourcelink"
    },
    "self": {
      "href": "/api/resourcelink"
    }
  },
  "records": {
    "_links": {
      "self": {
        "href": "/api/resourcelink"
      }
    },
    "authentication": "ntlmv2",
    "client_ip": "10.74.7.182",
    "connected_duration": "P4DT84H30M5S",
    "connection_count": "0",
    "connection_id": "22802",
    "continuous_availability": "unavailable",
    "identifier": "4622663542519103507",
    "idle_duration": "P4DT84H30M5S",
    "large_mtu": 1,
    "mapped_unix_user": "root",
    "node": {
      "_links": {
        "self": {
          "href": "/api/resourcelink"
        }
      },
      "name": "node1",
      "uuid": "1cd8a442-86d1-11e0-ae1c-123478563412"
    },
    "open_files": 0,
    "open_other": 0,
    "open_shares": 0,
    "protocol": "smb3_1",
    "server_ip": "10.140.78.248",
    "smb_encryption": "unencrypted",
    "smb_signing": "",
    "svm": {
      "_links": {
        "self": {
          "href": "/api/resourcelink"
        }
      },
      "name": "svm1",
      "uuid": "02c9e252-41be-11e9-81d5-00a0986138f7"
    },
    "user": "NBCIFSQA2\\administrator",
    "volumes": {
      "_links": {
        "self": {
          "href": "/api/resourcelink"
        }
      },
      "name": "volume1",
      "uuid": "028baa66-41bd-11e9-81d5-00a0986138f7"
    }
  }
}

Error

Status: Default, Error
Name Type Description

error

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

_links

Name Type Description

next

href

self

href

_links

Name Type Description

self

href

node

Name Type Description

_links

_links

name

string

uuid

string

svm

Name Type Description

_links

_links

name

string

The name of the SVM.

uuid

string

The unique identifier of the SVM.

volumes

Name Type Description

_links

_links

name

string

The name of the volume.

uuid

string

Unique identifier for the volume. This corresponds to the instance-uuid that is exposed in the CLI and ONTAPI. It does not change due to a volume move.

  • example: 028baa66-41bd-11e9-81d5-00a0986138f7

cifs_session

Name Type Description

_links

_links

authentication

string

SMB authentication over which the client accesses the share. The following values are supported:

  • none - No authentication

  • ntlmv1 - Ntlm version 1 mechanism

  • ntlmv2 - Ntlm version 2 mechanism

  • kerberos - Kerberos authentication

  • anonymous - Anonymous mechanism

client_ip

string

Specifies IP address of the client.

connected_duration

string

Specifies an ISO-8601 format of date and time used to retrieve the connected time duration in hours, minutes, and seconds format.

connection_count

integer

A counter used to track requests that are sent to the volumes to the node.

connection_id

integer

A unique 32-bit unsigned number used to represent each SMB session's connection ID.

continuous_availability

string

The level of continuous availabilty protection provided to the SMB sessions and/or files.

  • unavailable - Open file is not continuously available. For sessions, it contains one or more open files but none of them are continuously available.

  • available - open file is continuously available. For sessions, it contains one or more open files and all of them are continuously available.

  • partial - Sessions only. Contains at least one continuously available open file with other files open but not continuously available.

identifier

integer

A unique 64-bit unsigned number used to represent each SMB session's identifier.

idle_duration

string

Specifies an ISO-8601 format of date and time used to retrieve the idle time duration in hours, minutes, and seconds format.

large_mtu

boolean

Specifies whether the large MTU is enabled or not for an SMB session.

mapped_unix_user

string

Indicated that a mapped UNIX user has logged in.

node

node

open_files

integer

Number of files the SMB session has opened.

open_other

integer

Number of other files the SMB session has opened.

open_shares

integer

Number of shares the SMB session has opened.

protocol

string

The SMB protocol version over which the client accesses the volumes. The following values are supported:

  • smb1 - SMB version 1

  • smb2 - SMB version 2

  • smb2_1 - SMB version 2 minor version 1

  • smb3 - SMB version 3

  • smb3_1 - SMB version 3 minor version 1

server_ip

string

Specifies the IP address of the SVM.

smb_encryption

string

Indicates an SMB encryption state. The following values are supported:

  • unencrypted - SMB session is not encrypted

  • encrypted - SMB session is fully encrypted. SVM level encryption is enabled and encryption occurs for the entire session.

  • partially_encrypted - SMB session is partially encrypted. Share level encryption is enabled and encryption is initiated when the tree-connect occurs.

smb_signing

boolean

Specifies whether or not SMB signing is enabled.

svm

svm

user

string

Indicates that a Windows user has logged in.

volumes

array[volumes]

A group of volumes, the client is accessing.

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.