Cambia el nombre de un recurso.
La variable renameFiles
se ha desaprobado 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 eliminar las referencias a este parámetro al actualizar a la nueva versión de API.
IpsUser
IpsAdmin
IpsCompanyAdmin
ImagePortalAdmin
ImagePortalContrib
ImpagePortalContribUser
El usuario debe tener acceso de lectura y escritura al recurso.
Entrada (cambiar nombre de AssetParam)
Nombre | Tipo | Obligatorio | Descripción |
---|---|---|---|
companyHandle | xsd:string |
Sí | El identificador de la empresa a la que pertenece el recurso. |
assetHandle | xsd:string |
Sí | El identificador del recurso cuyo nombre desea cambiar. |
newName | xsd:string |
Sí | Nombre nuevo 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 si el nuevo nombre es único global y renameAsset genera un error si no es único. |
Salida (changeAssetReturn)
La API IPS no devuelve una respuesta para esta operación. Consulte la descripción del <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.