4.7. DELETE

RESTCONF服务器必须支持DELETE方法。 DELETE方法用于删除目标资源。 如果DELETE请求成功,则返回“204 No Content”状态行。

如果用户没有被授权删除目标资源,那么应该返回一个包含“403 Forbidden”状态行的错误响应。 在这种情况下返回错误标记值“access-denied”。 服务器可以返回“404 Not Found”状态行,如[RFC7231]的第6.5.4节所述。 在这种情况下返回错误标签值“invalid-value”。 所有其他错误响应按照第7节中定义的过程进行处理。

如果目标资源表示配置叶列表或列表数据节点,则它必须表示一个单一的叶子列表或列表实例。 服务器绝不能使用DELETE方法来删除多个这样的实例。

例:

要用“Wasting Light”键删除“album”资源,客户端可能会发送以下内容:

  1. DELETE /restconf/data/example-jukebox:jukebox/\
  2. library/artist=Foo%20Fighters/album=Wasting%20Light HTTP/1.1
  3. Host: example.com

如果资源被删除,服务器可能会响应如下:

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