Todos os produtos
Search
Central de documentação

:ListWatermark

Última atualização: Jun 27, 2026

Consulta marcas d'água.

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 de solicitação

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

Action

String

Sim

ListWatermark

A operação que você deseja executar. Defina o valor como ListWatermark.

AppId

String

Não

app-****

O ID do aplicativo. Valor padrão: app-1000000. Para mais informações, consulte Visão geral.

Parâmetros de resposta

ParâmetroTipoExemploDescrição
RequestIdString25818875-5F78-4A*****F6-D7393642CA58

O ID da solicitação.

WatermarkInfosArray of WatermarkInfo

As marcas d'água.

AppIdStringapp-****

O ID do aplicativo.

CreationTimeString2018-11-07T09:05:52Z

O momento em que a marca d'água foi adicionada. O horário segue o padrão ISO 8601 no formato aaaa-MM-ddTHH:mm:ssZ. O horário é exibido em UTC.

FileUrlStringhttps://outin-3262681cd*****89f4b3e7.oss-cn-shanghai.aliyuncs.com/image/cover/8CC8B715E6F8A72EC6B-6-2.png?Expires=1541600583&OSSAccessKeyId=****&Signature=gmf1eYMoDVg%2BHQCb4UGozB****

A URL do Object Storage Service (OSS) ou a URL da Content Delivery Network (CDN) do arquivo de marca d'água. Marcas d'água de texto não possuem URL de arquivo.

IsDefaultStringNotDefault

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.
NameStringText watermark test

O nome da marca d'água.

TypeStringText

O tipo da marca d'água. Valores válidos:

  • Image
  • Text
WatermarkConfigString{"FontColor": "Blue","FontSize": 80,"Content": "Watermark test"}

As configurações, como posição e efeito da marca d'água de texto ou de imagem. O valor é uma string formatada em JSON. Para mais informações sobre a estrutura de dados, consulte a seção "WatermarkConfig" do tópico Parâmetros de processamento de mídia.

WatermarkIdString9bcc8bfadb843*****109a2671d0df97

O ID da marca d'água.

Exemplos

Exemplos de solicitações

https://vod.{ApiRegion}.aliyuncs.com/?Action=ListWatermark
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

<ListWatermarkResponse>
  <RequestId>25818875-5F78-4A*****F6-D7393642CA58</RequestId>
  <WatermarkInfos>
        <IsDefault>NotDefault</IsDefault>
        <FileUrl>https://outin-3262681cd*****89f4b3e7.oss-cn-shanghai.aliyuncs.com/image/cover/8CC8B715E6F8A72EC6B-6-2.png?Expires=1541600583&amp;OSSAccessKeyId=****&amp;Signature=gmf1eYMoDVg%2BHQCb4UGozB****</FileUrl>
        <Type>Text</Type>
        <AppId>app-****</AppId>
        <WatermarkId>9bcc8bfadb843*****109a2671d0df97</WatermarkId>
        <CreationTime>2018-11-07T09:05:52Z</CreationTime>
        <WatermarkConfig>{"FontColor": "Blue","FontSize": 80,"Content": "Watermark test"}</WatermarkConfig>
        <Name>Text watermark test</Name>
  </WatermarkInfos>
</ListWatermarkResponse>

Formato JSON

{
    "RequestId": "25818875-5F78-4A*****F6-D7393642CA58",
    "WatermarkInfos": [{
        "IsDefault": "NotDefault",
        "FileUrl": "https://outin-3262681cd*****89f4b3e7.oss-cn-shanghai.aliyuncs.com/image/cover/8CC8B715E6F8A72EC6B-6-2.png?Expires=1541600583&OSSAccessKeyId=****&Signature=gmf1eYMoDVg%2BHQCb4UGozB****",
        "Type": "Text",
        "AppId": "app-****",
        "WatermarkId": "9bcc8bfadb843*****109a2671d0df97",
        "CreationTime": "2018-11-07T09:05:52Z",
        "WatermarkConfig": "{\"FontColor\": \"Blue\",\"FontSize\": 80,\"Content\": \"Watermark test\"}",
        "Name": "Text watermark test"
    }]
}

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: