Updating a file or folder
You can update a file or folder to create or remove a dependency, set or remove an archive rule, define a parameter, or change other properties. You can also grant or revoke a permission and copy the access control list (ACL) of a folder to its subfolders. To use UpdateFile to modify the properties of a file or folder, you must have the write privilege on the file or folder. To update privileges to the file or folder, you must have the grant privilege on the file or folder.
The following request modifies the autoarchive rules of three files:
<SOAP-ENV:Body>
<Administrate>
<AdminOperation>
<UpdateFile>
<WorkingFolderId>170</WorkingFolderId>
<UpdateFileOperationGroup>
<UpdateFileOperation>
<SetArchiveRules>
<ArchiveRule>
<FileType>RPTDESIGN</FileType>
<NeverExpire>false</NeverExpire>
<ArchiveOnExpiration>true
</ArchiveOnExpiration>
<ExpirationAge>86400</ExpirationAge>
</ArchiveRule>
</SetArchiveRules>
</UpdateFileOperation>
</UpdateFileOperationGroup>
<IdList>
<String>1570</String>
<String>7840</String>
<String>8621</String>
</IdList>
</UpdateFile>
</AdminOperation>
</Administrate>
</SOAP-ENV:Body>
The response to an UpdateFile request is an empty response if the request succeeds. If the request fails, an error message appears.