Todos os produtos
Search
Central de documentação

:ListDAGVersions

Última atualização: Jul 09, 2026

Consulta as versões publicadas de um fluxo de tarefas.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta também gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

Action

String

Sim

ListDAGVersions

Operação a ser executada. Defina o valor como ListDAGVersions.

DagId

Long

Sim

7***

ID do fluxo de tarefas. Chame a operação ListTaskFlow para obter esse identificador.

PageIndex

Integer

Sim

1

Número da página a retornar.

PageSize

Integer

Sim

20

Quantidade de entradas por página.

Tid

Long

Não

3***

ID do locatário. Utilize a operação GetUserActiveTenant ou ListUserTenants para consultar esse valor.

RegionId

String

Não

cn-hangzhou

ID da região onde o Data Management (DMS) está ativado. Para mais informações, consulte Parâmetro RegionID.

Parâmetros de resposta

Parâmetro Tipo Exemplo Descrição
RequestId String C7775630-7901-51B9-8782-9B585EC0799A

ID da solicitação.

ErrorCode String 403

Código de erro.

ErrorMessage String UnknownError

Mensagem de erro.

Success Boolean true

Indica se a solicitação foi bem-sucedida. Valores válidos:

  • true: Solicitação bem-sucedida.
  • false: Falha na solicitação.
TotalCount Integer 1

Número total de entradas retornadas.

DagVersionList Array of DagVersion

Informações sobre as versões publicadas.

DagVersion
DagName String Spark SQL

Nome do fluxo de tarefas.

DagOwnerId String 51****

ID do proprietário do fluxo de tarefas.

DagOwnerNickName String name

Nome do proprietário do fluxo de tarefas.

VersionComments String test_OSS

Descrição da versão.

VersionId Long 2****

ID da versão.

LastVersionId Long 2****

ID da versão publicada anteriormente.

Exemplos

Exemplo de solicitação

http(s)://dms-enterprise.aliyuncs.com/?Action=ListDAGVersions
&DagId=7***
&PageIndex=1
&PageSize=20
&Tid=3***
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<ListDAGVersionsResponse>
    <TotalCount>1</TotalCount>
    <RequestId>C7775630-7901-51B9-8782-9B585EC0799A</RequestId>
    <DagVersionList>
        <DagVersion>
            <VersionId>2****</VersionId>
            <DagOwnerId>51****</DagOwnerId>
            <VersionComments>test_OSS</VersionComments>
            <DagName>Spark SQL</DagName>
            <DagOwnerNickName>name</DagOwnerNickName>
        </DagVersion>
    </DagVersionList>
    <Success>true</Success>
</ListDAGVersionsResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "TotalCount" : 1,
  "RequestId" : "C7775630-7901-51B9-8782-9B585EC0799A",
  "DagVersionList" : {
    "DagVersion" : [ {
      "VersionId" : "2****",
      "DagOwnerId" : "51****",
      "VersionComments" : "test_OSS",
      "DagName" : "Spark SQL",
      "DagOwnerNickName" : "name"
    } ]
  },
  "Success" : true
}

Códigos de erro

Para obter uma lista de códigos de erro, visite o Centro de Erros de API.