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