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\" }"