重新命名資產。
此 renameFiles
舊版已棄用引數,並已從以下版本中移除: renameAsset
. 虛擬檔案路徑會變更為符合新的資產名稱(保留副檔名),而實體檔案路徑則不受影響。 API使用者端在更新至新API版本時需要移除此引數的參考。
IpsUser
IpsAdmin
IpsCompanyAdmin
ImagePortalAdmin
ImagePortalContrib
ImpagePortalContribUser
使用者必須擁有資產的讀取和寫入存取權。
輸入(renameAssetParam)
名稱 | 類型 | 必要 | 說明 |
---|---|---|---|
companyHandle | xsd:string |
是 | 資產所屬公司的控制代碼。 |
assetHandle | xsd:string |
是 | 您要重新命名的資產的控制代碼。 |
newName | xsd:string |
是 | 資產的新名稱。 |
validateName | xsd:boolean |
是 | 如果 validateName 是 true 且資產型別需要唯一的IPS ID,則會檢查新名稱是否有全域唯一性,以及 renameAsset 如果錯誤不是唯一的,則會擲回錯誤。 |
輸出(renameAssetReturn)
IPS API未傳回此作業的回應。 請參閱「 」的說明 <ns1:validateName>
元素,以取得關於此元素的警告。
此程式碼範例會重新命名資產
請求
<ns1:renameAssetParam xmlns:ns1="http://www.scene7.com/IpsApi/xsd">
<ns1:companyHandle>47</ns1:companyHandle>
<ns1:assetHandle>24265|1|17061</ns1:assetHandle>
<ns1:newName>My Newly Renamed Image</ns1:newName>
<ns1:validateName>true</ns1:validateName>
<ns1:renameFiles>true</ns1:renameFiles>
</ns1:renameAssetParam>
回答
無。