Update a hostname mapping for an SVM
Suggest changes
PDFs
PATCH /name-services/local-hosts/{owner.uuid}/{address}
Introduced In: 9.10
For a specified SVM and IP address, modifies the corresponding IP to hostname mapping.
Related ONTAP commands
-
vserver services name-service dns hosts modify
Learn more
Parameters
| Name | Type | In | Required | Description |
|---|---|---|---|---|
owner.uuid |
string |
path |
True |
UUID of the owner to which this object belongs. |
address |
string |
path |
True |
The IP address. |
Request Body
| Name | Type | Description |
|---|---|---|
aliases |
array[string] |
The list of aliases. |
hostname |
string |
Canonical hostname. |
scope |
string |
Scope of the entity. Set to "cluster" for cluster owned objects and to "svm" for SVM owned objects. |
Example request
{
"aliases": [
"host1.sales.foo.com",
"host2.sakes.foo.com"
],
"hostname": "host.sales.foo.com",
"scope": "string"
}Response
Status: 200, OkError
Status: DefaultONTAP Error Response Codes
| Error Code | Description |
|---|---|
23724055 |
Internal error. Configuration for Vserver failed. Verify that the cluster is healthy, then try the command again. For further assistance, contact technical support. |
Also see the table of common errors in the Response body overview section of this documentation.
Definitions
See Definitions
href
| Name | Type | Description |
|---|---|---|
href |
string |
_links
owner
SVM, applies only to SVM-scoped objects.
| Name | Type | Description |
|---|---|---|
name |
string |
The name of the SVM. This field cannot be specified in a PATCH method. |
uuid |
string |
The unique identifier of the SVM. This field cannot be specified in a PATCH method. |
local_host
| Name | Type | Description |
|---|---|---|
aliases |
array[string] |
The list of aliases. |
hostname |
string |
Canonical hostname. |
scope |
string |
Scope of the entity. Set to "cluster" for cluster owned objects and to "svm" for SVM owned objects. |
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. |