4.4.2. 调用操作模式

如果目标资源类型是操作资源,那么POST方法将被视为调用该操作的请求。 消息主体(如果有的话)被处理为操作输入参数。 有关操作资源的详细信息,请参阅第3.6节

如果POST请求成功,如果有响应消息体,则返回“200 OK”状态行;如果没有响应消息体,则返回“204 No Content”状态行。

如果用户无权调用目标操作,则应返回包含“403 Forbidden”状态行的错误响应。 在这种情况下使用错误标签值“access-denied”。 服务器可以返回“404 Not Found”状态行,如[RFC7231]的第6.5.4节所述。 所有其他错误响应按照第7节中定义的过程进行处理。

示例:

在这个例子中,客户端正在调用在“example-jukebox”的YANG模块中定义的“play”操作。

客户可能会发送一个“play”请求,如下所示:

POST /restconf/operations/example-jukebox:play HTTP/1.1
Host: example.com
Content-Type: application/yang-data+json

{
  "example-jukebox:input" : {
    "playlist" : "Foo-One",
    "song-number" : 2
  }
}

服务器可能会如下回应:

HTTP/1.1 204 No Content
Date: Thu, 26 Jan 2017 20:56:30 GMT
Server: example-server

results matching ""

    No results matching ""