Manage UNIX user cache settings
Retrieve and manage UNIX user cache settings through this API to optimize access and performance in your environment. Use these endpoints to adjust cache parameters for specific storage virtual machines (SVMs).
Overview
This API is used to retrieve and manage unix-user settings.
Examples
Retrieving unix-user cache settings
The following example shows how to use the cache unix-user settings GET endpoint to retrieve unix-user cache settings.
# The API:
GET /api/name-services/cache/unix-user/settings
# The call:
curl -X GET "https://<mgmt-ip>/api/name-services/cache/unix-user/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-user cache setting for a given SVM
The following example shows how to use the cache unix-user settings GET endpoint to retrieve unix-user cache settings for a given SVM.
# The API:
GET /api/name-services/cache/unix-user/settings/{svm.uuid}
# The call:
curl -X GET "https://<mgmt-ip>/api/name-services/cache/unix-user/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-user setting
The following example shows how to use the cache unix-user settings PATCH endpoint to update unix-user cache settings.
# The API:
PATCH /api/name-services/cache/unix-user/settings/{svm.uuid}
# The call:
curl -X PATCH "https://<mgmt-ip>/api/name-services/cache/unix-user/settings/02c9e252-41be-11e9-81d5-00a0986138f9" -H "accept: application/json" -H "Content-Type: application/json" -d "{ \"ttl\": \"PT2H\", \"negative_ttl\": \"PT2M\" }"