ListImageVersions - DataWorks: Central de Documentação do Alibaba Cloud

Obtém os detalhes de uma versão de imagem especificada.

Descrição da operação

Para usar esta API, você deve adquirir o DataWorks Basic Edition ou uma edição posterior.
Certifique-se de criar a função vinculada ao serviço AliyunServiceRoleForDataWorks antes de chamar esta API.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

dataworks:ListImageVersions

list

*DwImage

acs:dataworks:{#regionId}:{#accountId}:dwimage/{#id}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
Id	string	Sim	O ID da imagem.	Custom_image_xxxx_xxxx
PageNumber	integer	Não	O número da página.	1
PageSize	integer	Não	O número de entradas por página.	10

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	O esquema da resposta.
Success	boolean	Indica se a solicitação foi bem-sucedida.	true
PagingInfo	object	Os detalhes de paginação.
ImageVersions	array<object>	Uma lista de detalhes das versões de imagem.
	array<object>	Os detalhes da versão da imagem.
Id	string	O ID da imagem.	Custom_image_xxxx_xxxx
Name	string	O nome da imagem.	dataworks_image
Version	string	A versão da imagem.	1
Description	string	A descrição da imagem.	Test image created by xxx
Creator	string	O ID do usuário que criou a imagem.	123
Modifier	string	O ID do usuário que modificou a imagem pela última vez.	123
CreatedTime	integer	A hora em que a imagem foi criada, como um timestamp de 64 bits.	1727055811000
LastModifiedTime	integer	A hora em que a imagem foi modificada pela última vez, como um timestamp de 64 bits.	1727055811000
Official	boolean	Indica se a imagem é uma imagem oficial.	true
Accessibility	string	A acessibilidade da imagem. Valores válidos: `Public`: A imagem é visível para todos os usuários. `Private`: A imagem é visível apenas para o criador.	Public
Status	string	O status da imagem. Valores válidos: `Disabled`: A imagem está desativada. `Expired`: A imagem está expirada. `Available`: A imagem está disponível. `ReadOnly`: A imagem é somente leitura.	Available
PublishStage	string	O estágio de publicação da imagem. Valores válidos: `Untest`: Não testada. `Testing`: Em teste. `TestFailed`: Falha no teste. `Unpublished`: Não publicada. `Publishing`: Em publicação. `Published`: Publicada. `PublishFailed`: Falha na publicação. `Building`: Em compilação. `BuildSuccess`: Compilação bem-sucedida. `BuildFailed`: Falha na compilação. `Accelerating`: Em aceleração. `AccelerateSuccess`: Aceleração bem-sucedida. `AccelerateFailed`: Falha na aceleração.	Published
Supported	object	Os módulos e tipos de tarefa suportados.
Module	string	O módulo suportado. Valor válido: `Scheduler`: O módulo de agendamento.	Scheduler
TaskTypes	array	Os tipos de tarefa suportados.
	string	O tipo de tarefa suportado. Valores válidos: Shell Python ServerIDE Notebook PyODPS 2 PyODPS 3	Shell
IsDefault	boolean	Indica se a imagem é a imagem padrão.	false
EnableSyncMaxCompute	boolean	Indica se a sincronização do MaxCompute está ativada.	false
ProviderType	string	O tipo de provedor da imagem. Valores válidos: `ACR`: A imagem é de um repositório ACR. `DataWorks`: A imagem é uma imagem oficial fornecida pelo DataWorks.	ACR
ProviderImageId	string	O ID da imagem do provedor.	acr_image_id
ImageUri	string	O URI da imagem.	registry.cn-hangzhou.aliyuncs.com/xxx/xxx:tag
Namespace	string	O namespace.	namespace
Size	string	O tamanho da imagem.	1GB
AcrInstanceId	string	O ID da instância ACR.	cri-xxx
ImageTag	string	A tag da imagem.	v1.0.0
RepositoryName	string	O nome do repositório.	repo_name
ImageVpcUri	string	O URI da VPC da imagem.	registry-vpc.cn-hangzhou.aliyuncs.com/xxx/xxx:tag
AcrEndpoint	string	O endpoint ACR.	registry.cn-hangzhou.aliyuncs.com
AcrAssociatedVpcId	string	O ID da VPC associada à instância ACR.	vpc-xxx
BuildConfig	object	A configuração de compilação da imagem.
BuildType	string	O tipo de compilação.	PackageInstallation
PackageInstallationScripts	array<object>	Os scripts de pré-instalação.
	object	Um script de pré-instalação.
Type	string	O tipo de script.	Python3
Content	string	O conteúdo do script. Separe vários nomes de pacotes com uma vírgula (,).	requests
PageNumber	integer	O número da página.	1
PageSize	integer	O número de entradas por página.	10
TotalCount	integer	O número total de entradas.	10
RequestId	string	O ID da solicitação, usado para localizar logs e solucionar problemas.	6A6CBE87-9F91-1323-B680-E7A7065XXXXX

Exemplos

Resposta de sucesso

JSON formato

{
  "Success": true,
  "PagingInfo": {
    "ImageVersions": [
      {
        "Id": "Custom_image_xxxx_xxxx",
        "Name": "dataworks_image",
        "Version": "1",
        "Description": "Test image created by xxx",
        "Creator": "123",
        "Modifier": "123",
        "CreatedTime": 1727055811000,
        "LastModifiedTime": 1727055811000,
        "Official": true,
        "Accessibility": "Public",
        "Status": "Available",
        "PublishStage": "Published",
        "Supported": {
          "Module": "Scheduler",
          "TaskTypes": [
            "Shell"
          ]
        },
        "IsDefault": false,
        "EnableSyncMaxCompute": false,
        "ProviderType": "ACR",
        "ProviderImageId": "acr_image_id",
        "ImageUri": "registry.cn-hangzhou.aliyuncs.com/xxx/xxx:tag",
        "Namespace": "namespace",
        "Size": "1GB",
        "AcrInstanceId": "cri-xxx",
        "ImageTag": "v1.0.0",
        "RepositoryName": "repo_name",
        "ImageVpcUri": "registry-vpc.cn-hangzhou.aliyuncs.com/xxx/xxx:tag",
        "AcrEndpoint": "registry.cn-hangzhou.aliyuncs.com",
        "AcrAssociatedVpcId": "vpc-xxx",
        "BuildConfig": {
          "BuildType": "PackageInstallation",
          "PackageInstallationScripts": [
            {
              "Type": "Python3",
              "Content": "requests"
            }
          ]
        }
      }
    ],
    "PageNumber": 1,
    "PageSize": 10,
    "TotalCount": 10
  },
  "RequestId": "6A6CBE87-9F91-1323-B680-E7A7065XXXXX"
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.