renameAsset

Renomeia um ativo.

OBSERVAÇÃO

O parâmetro renameFiles foi preterido para versões anteriores e removido de renameAsset. O caminho do arquivo virtual é alterado para corresponder ao novo nome do ativo (preservando a extensão do arquivo), enquanto os caminhos de arquivo físico não são afetados. Os clientes da API precisam remover referências a esse parâmetro ao atualizar para a nova versão da API.

Tipos de usuário autorizados

  • IpsUser
  • IpsAdmin
  • IpsCompanyAdmin
  • ImagePortalAdmin
  • ImagePortalContrib
  • ImpagePortalContribUser
OBSERVAÇÃO

O usuário deve ter acesso de leitura e gravação ao ativo.

Parâmetros

Entrada (renameAssetParam)

Nome Tipo Obrigatório Descrição
*companyHandle* xsd:string Sim O identificador da empresa à qual o ativo pertence.
*assetHandle* xsd:string Sim O identificador do ativo que deseja renomear.
*newName* xsd:string Sim Novo nome do ativo.
*validateName* xsd:boolean Sim Se validateName for true e o tipo de ativo exigir uma ID IPS exclusiva, o novo nome será verificado para exclusividade global e renameAsset emitirá uma falha se não for exclusiva.

Saída (renameAssetReturn)

A API do IPS não retorna uma resposta para esta operação. Consulte a descrição do elemento <ns1:validateName> para obter avisos sobre esse elemento.

Exemplos

Essa amostra de código renomeia um ativo

Solicitação

<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>

Resposta

Nenhum.

Nesta página

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now