REST API - remove

REST API - remove

com.vmware.content.library.item.updatesession.file

The file service provides operations for accessing files within an update session.

After an update session is created against a library item, the file service can be used to make changes to the underlying library item metadata as well as the content of the files. The following changes can be made:

  • deleting an existing file within the library item. This deletes both the metadata and the content.
  • updating an existing file with new content.
  • adding a new file to the library item.

The above changes are not applied or visible until the session is completed. See com.vmware.content.library.item.update_session.

remove

POST /com/vmware/content/library/item/updatesession/file/id:{update_session_id}?~action=remove
POST /com/vmware/content/library/item/updatesession/file?~action=remove

Requests a file to be removed. The file will only be effectively removed when the update session is completed.
Request:
Representations:
{
    "file_name": "string",
    "update_session_id": "obj-103"
}
<?xml version="1.0" ?>
<ns0:Remove-Input xmlns:ns0="http://vmware.com/content/library/item/updatesession/file" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <file_name>string</file_name>
  <update_session_id>obj-103</update_session_id>
</ns0:Remove-Input>
POST /com/vmware/content/library/item/updatesession/file?~action=remove
&file_name=string
&update_session_id=obj-103

Parameters:
Name Type Required Description
update_session_id
 *
 ID Yes Identifier of the update session. Id of type com.vmware.content.library.item.UpdateSession.
file_name
 *
 string Yes Name of the file to be removed.

Response:
Representations:

Parameters:
Name Type Required Description
result VOID Yes

Errors:
Type Description HTTP Status Code
not_found if the update session doesn't exist. 404
invalid_argument if the file doesn't exist in the library item associated with the update session. 400

Copyright © 2014. All Rights Reserved.