Skip to main content
REST API reference

Manage UNIX group cache settings

Retrieve and manage UNIX group cache settings to optimize and control how group information is stored and accessed within your system. Use these endpoints to adjust cache parameters such as time-to-live and propagation settings for specific Storage Virtual Machines (SVMs).

Overview

This API is used to retrieve and manage unix-group settings.

Examples

Retrieving unix-group settings


The following example shows how to use the cache unix-group settings GET endpoint to retrieve unix-group cache settings.

# The API:
GET /api/name-services/cache/unix-group/settings

# The call:
curl -X GET "https://<mgmt-ip>/api/name-services/cache/unix-group/settings?fields=*" -H "accept: application/hal+json"

# The response:
{
"records": [
  {
    "svm": {
      "uuid": "8a1a8730-2036-11ec-8457-005056bbcfdb",
      "name": "vs43"
    },
    "enabled": true,
    "negative_cache_enabled": true,
    "ttl": "P1D",
    "negative_ttl": "PT1M",
    "propagation_enabled": true
  },
  {
    "svm": {
      "uuid": "dc458b2f-2035-11ec-bfe2-005056bb6bef",
      "name": "vs34"
    },
    "enabled": true,
    "negative_cache_enabled": true,
    "ttl": "P1D",
    "negative_ttl": "PT1M",
    "propagation_enabled": true
  }
],
"num_records": 2
}

Retrieving a unix-group setting for a given SVM


The following example shows how to use the cache unix-group settings GET endpoint to retrieve unix-group cache settings for a given SVM.

# The API:
GET /api/name-services/cache/unix-group/settings/{svm.uuid}

# The call:
curl -X GET "https://<mgmt-ip>/api/name-services/cache/unix-group/settings/dc458b2f-2035-11ec-bfe2-005056bb6bef" -H "accept: application/hal+json"

# The response:
{
"svm": {
  "uuid": "dc458b2f-2035-11ec-bfe2-005056bb6bef",
  "name": "vs34"
},
"enabled": true,
"negative_cache_enabled": true,
"ttl": "P1D",
"negative_ttl": "PT1M",
"propagation_enabled": true
}

Updating a unix-group setting


The following example shows how to use the cache unix-group settings PATCH endpoint to update unix-group cache settings for an SVM.

# The API:
PATCH /api/name-services/cache/unix-group/settings/{svm.uuid}

# The call:
curl -X PATCH "https://<mgmt-ip>/api/name-services/cache/unix-group/settings/02c9e252-41be-11e9-81d5-00a0986138f9" -H "accept: application/json" -H "Content-Type: application/json" -d "{ \"ttl\": \"PT2H\", \"negative_ttl\": \"PT2M\" }"