RenameFile

重命名文件。

此操作的工作原理如下：

1. WOPI 主机检查文件当前是否被锁定。
2. 如果文件当前 被锁定 并且 X-WOPI-Lock 值与文件上当前的锁不匹配， 则主机必须返回 409 Conflict ("lock mismatch") 并包含 X-WOPI-Lock 响应标头，标头包含文件当前锁的值。
3. 如果文件 未被锁定，主机应以 200 OK 响应并继续重命名。
4. 如果主机因为请求的名称无效或与现有文件冲突而无法重命名文件， 主机应尝试根据请求的名称生成满足文件名要求的不同名称。
5. 如果主机不能生成不同的名称，它应该返回 400 Bad Request。响应必须包含描述文件名无效原因的 X-WOPI-InvalidFileNameError 标头。

名称	描述	类型
file_id	必须是 URL 安全的文件 ID。	string

名称	描述	类型
access_token	访问令牌主机将用它确定请求是否被授权。	string

名称	描述	类型	出现
X-WOPI-Override	来自 WOPI 服务器的请求操作 (RENAME_FILE)。	string	必需的
X-WOPI-Lock	锁ID主机必须用它来标识文件上的锁。	string	可选的
X-WOPI-RequestedName	文件名，不包括文件扩展名（UTF-7 格式）。	string	可选的

名称	描述	类型	出现
X-WOPI-InvalidFileNameError	无法完成重命名操作的原因。仅当响应代码为 400 Bad Request时才应包含此标头。 此值只能用于记录目的。	string	可选的
X-WOPI-Lock	锁ID标识文件上的当前锁。当使用 409 Conflict响应请求时，必须始终包含此标头。 用 200 OK响应请求时不应包含它。	string	可选的
X-WOPI-LockFailureReason	锁定失败的原因。当使用 409 Conflict响应请求时，可能会包含此标头。它只能用于记录目的。	string	可选的

名称	描述	类型	出现
名称	没有路径或文件扩展名的重命名文件名。	string	必需的