UpdateWatermark - : Central de Documentação do Alibaba Cloud

Modifique uma marca d'água.

Nota

Apenas o nome e as configurações da marca d'água podem ser modificados.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos que você chame esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	UpdateWatermark	A operação que você deseja executar. Defina o valor como UpdateWatermark.
Name	String	Sim	test	Nome da marca d'água. Apenas letras e dígitos são suportados. O nome pode ter até 128 bytes de comprimento. O valor deve estar codificado em UTF-8.
WatermarkConfig	String	Sim	{"Width":"55","Height":"55","Dx":"9","Dy":"9","ReferPos":"BottonLeft","Type":"Image"}	Configurações como posição e efeito da marca d'água de texto ou imagem. O valor é uma string formatada em JSON. Nota O valor deste parâmetro varia conforme o tipo de marca d'água. Para mais informações sobre a estrutura de dados, consulte a seção "WatermarkConfig" do tópico Parâmetros de processamento de mídia.
WatermarkId	String	Sim	af2afe4761992c*****bd947dae97337	ID da marca d'água.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	25818875-5F78-4A*****F6-D7393642CA58	ID da solicitação.
WatermarkInfo	Struct		Informações sobre a marca d'água.
CreationTime	String	2018-11-06T08:03:17Z	Momento em que a marca d'água foi adicionada. O horário segue o padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. O horário é exibido em UTC.
FileUrl	String	https://outin-32**9f4b3e7.oss-cn-shanghai.aliyuncs.com/image/cover/E6C3448CC8B715E6F8A72EC6B-6-2.png?Expires=1541600583&OSSAccessKeyId=&Signature=gmf1eYMoDVg%2BHQCb4UGozBW**	URL do Object Storage Service (OSS) ou URL da Content Delivery Network (CDN) do arquivo de marca d'água. Marcas d'água de texto não possuem URL de arquivo.
IsDefault	String	NotDefault	Indica se a marca d'água é a padrão. Valores válidos: Default: A marca d'água é a padrão. NotDefault: A marca d'água não é a padrão.
Name	String	Image watermark test	Nome da marca d'água.
Type	String	Text	Tipo da marca d'água. Valores válidos: Image: Este é o valor padrão. Text
WatermarkConfig	String	{"Width":"55","Height":"55","Dx":"9","Dy":"9","ReferPos":"BottonLeft","Type":"Image"}	Configurações como posição e efeito da marca d'água de texto ou imagem. O valor é uma string formatada em JSON. Nota O valor deste parâmetro varia conforme o tipo de marca d'água. Para mais informações sobre a estrutura de dados, consulte a seção "WatermarkConfig" do tópico Parâmetros de processamento de mídia.
WatermarkId	String	505e2e287ea*****ecfddd386d384	ID da marca d'água.

Exemplos

Exemplos de solicitações

https://vod.{ApiRegion}.aliyuncs.com/?Action=UpdateWatermark
&Name=test
&WatermarkConfig={"Width":"55","Height":"55","Dx":"9","Dy":"9","ReferPos":"BottonLeft","Type":"Image"}
&WatermarkId=af2afe4761992c*****bd947dae97337
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

<UpdateWatermarkResponse>
  <RequestId>25818875-5F78-4A*****F6-D7393642CA58</RequestId>
  <WatermarkInfo>
        <Name>Image watermark test</Name>
        <CreationTime>2018-11-06T08:03:17Z</CreationTime>
        <WatermarkId>505e2e287ea*****ecfddd386d384</WatermarkId>
        <FileUrl>https://outin-32****9f4b3e7.oss-cn-shanghai.aliyuncs.com/image/cover/E6C3448CC8B715E6F8A72EC6B-6-2.png?Expires=1541600583&amp;OSSAccessKeyId=****&amp;Signature=gmf1eYMoDVg%2BHQCb4UGozBW****</FileUrl>
        <IsDefault>NotDefault</IsDefault>
        <Type>Image</Type>
        <WatermarkConfig>
              <ReferPos>BottomRight</ReferPos>
              <Height>55</Height>
              <Width>55</Width>
              <Dx>8</Dx>
              <Dy>8</Dy>
        </WatermarkConfig>
  </WatermarkInfo>
</UpdateWatermarkResponse>

Formato JSON

{
 "RequestId": "25818875-5F78-4A*****F6-D7393642CA58",
 "WatermarkInfo":{
    "Name": "Image watermark test",
    "CreationTime": "2018-11-06T08:03:17Z",
    "WatermarkId": "505e2e287ea*****ecfddd386d384",
    "FileUrl": "https://outin-32****9f4b3e7.oss-cn-shanghai.aliyuncs.com/image/cover/E6C3448CC8B715E6F8A72EC6B-6-2.png?Expires=1541600583&OSSAccessKeyId=****&Signature=gmf1eYMoDVg%2BHQCb4UGozBW****",
    "IsDefault": "NotDefault",
    "Type": "Image",
    "WatermarkConfig": {
      "ReferPos": "BottomRight",
      "Height": "55",
      "Width": "55",
      "Dx": "8",
      "Dy": "8"
    }
  }
}

Códigos de erro

Para obter uma lista de códigos de erro, visite o API Error Center.

Exemplos de SDK

Recomendamos o uso dos SDKs de servidor para chamar esta operação. Visualize os códigos de exemplo em diferentes linguagens para chamar esta operação clicando nos links a seguir: