Cambia el nombre de un recurso.
El renameFiles
El parámetro de ha quedado obsoleto para versiones anteriores y se ha eliminado de renameAsset
. La ruta del archivo virtual se cambia para que coincida con el nuevo nombre del recurso (conservando la extensión del archivo), mientras que las rutas de archivo físicas no se ven afectadas. Los clientes de API deben quitar las referencias a este parámetro al actualizar a la nueva versión de la API.
IpsUser
IpsAdmin
IpsCompanyAdmin
ImagePortalAdmin
ImagePortalContrib
ImpagePortalContribUser
El usuario debe tener acceso de lectura y escritura al recurso.
Entrada (RenameAssetParam)
Nombre | Tipo | Obligatorio | Descripción |
---|---|---|---|
companyHandle | xsd:string |
Sí | El identificador de la compañía a la que pertenece el recurso. |
assetHandle | xsd:string |
Sí | El identificador del recurso cuyo nombre desea cambiar. |
newName | xsd:string |
Sí | Nuevo nombre del recurso. |
validateName | xsd:boolean |
Sí | Si la variable validateName es true y el tipo de recurso requiere un ID de IPS único, se comprueba la exclusividad global del nuevo nombre y renameAsset genera un error si no es único. |
Salida (RenameAssetReturn)
La API de IPS no devuelve una respuesta para esta operación. Consulte la descripción de la <ns1:validateName>
para obtener advertencias sobre este elemento.
Este ejemplo de código cambia el nombre de un recurso
Solicitar
<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>
Respuesta
Ninguno.