PUT /nodes/{nodeId}/content
基本信息
Note: 该端点在Alfresco 5.2和更高版本中可用。
使用标识符nodeId更新nodes的内容。
该端点的请求主体可以是任何文本流或二进制流。
majorVersion和comment参数可用于控制版本控制行为。 如果内容是可版本控制的,则默认情况下会创建一个新的次要版本。
还可以选择指定一个新的名称(name)参数,该名称在父文件夹中必须是唯一的。 如果指定且有效,则它将重命名该nodes。 如果无效,则返回错误,并且内容不更新。
Note: 此API方法可以接受任何内容类型,但是可以使用此工具提供基于文本的内容进行测试。 这是因为OpenAPI规范不允许提供通配符,也不允许工具接受任意文件。
请求方式: PUT
请求API:/ nodes / {nodeId} / content
响应等级(状态200)
成功回应
{ "entry": { "id": "string", "name": "string", "nodeType": "string", "isFolder": true, "isFile": true, "isLocked": false, "modifiedAt": "2021-01-08T08:52:11.400Z", "modifiedByUser": { "displayName": "string", "id": "string" }, "createdAt": "2021-01-08T08:52:11.400Z", "createdByUser": { "displayName": "string", "id": "string" }, "parentId": "string", "isLink": true, "isFavorite": true, "content": { "mimeType": "string", "mimeTypeName": "string", "sizeInBytes": 0, "encoding": "string" }, "aspectNames": [ "string" ], "properties": {}, "allowableOperations": [ "string" ], "path": { "elements": [ { "id": "string", "name": "string", "nodeType": "string", "aspectNames": [ "string" ] } ], "name": "string", "isComplete": true }, "permissions": { "isInheritanceEnabled": true, "inherited": [ { "authorityId": "string", "name": "string", "accessStatus": "ALLOWED" } ], "locallySet": [ { "authorityId": "string", "name": "string", "accessStatus": "ALLOWED" } ], "settable": [ "string" ] } } }
响应内容类型 applicaiton/json
Query参数
名称 | 类型 | 是否必填 | 示例值 | 描述 |
majorVersion | boolean | 否 | false(default) | 如果为true,则创建一个主要版本。 如果尚未进行版本控设置此参数还会启用该nodes的版本控制。 |
comment | string | 否 | 添加将显示在版本历史记录中的版本注释。 如果尚未进行版本控设置此参数还会启用该nodes的版本控制。 | |
name | string | 否 | 可选的新名称。 这应该包括文件扩展名。 名称中不能包含空格或以下特殊字符:*“ <> \ /?:和|。字符。不得在名称末尾使用。 | |
include | Array[string] | 否 | 返回有关该nodes的其他信息。 可以请求以下可选字段:allowableOperations;association;isLink;isFavorite;isLocked;path;permissions | |
fields | Array[string] | 否 | field名称的list。 例如,如果您想节省整体带宽,则可以使用此参数来限制响应中返回的field。 例如,如果您想节省整体带宽,则可以使用此参数来限制响应中返回的field。 该列表适用于返回的单个实体或集合中的条目。 如果API方法也支持include参数,则除了在fields参数中指定的fields外,还返回include参数中指定的fields。 |
Path参数
名称 | 类型 | 是否必填 | 示例值 | 描述 |
nodeId | string | 是 | nodes的标识符。 |
Body参数(nodeBodyCopy)
名称 | 类型 | 是否必填 | 描述 |
contentBodyUpdate | string | 是 | 二进制内容 参数内容类型:applicaiton/json |
错误信息描述
状态码 | 原因 |
400 | 无效的参数:nodeId无效,或者不是文件 |
401 | 验证失败 |
403 | 当前用户无权更新nodeId |
404 | nodeId不存在 |
409 | 可选的新名称与当前父文件夹中的现有nodes冲突 |
413 | 内容超出了单个文件的大小限制(已针对网络/系统配置) |
422 | 模型完整性异常,包括文件名包含无效字符 |
507 | 内容超出为网络/系统配置的总体存储配额限制 |
default | 意外错误 |
返回结果示例
{ "error": { "errorKey": "string", "statusCode": 0, "briefSummary": "string", "stackTrace": "string", "descriptionURL": "string", "logId": "string" } }