Todos los productos
Search
Centro de documentos

DataWorks:ListProjects

Última actualización: Sep 29, 2026

Consulta la lista de espacios de trabajo de DataWorks del inquilino al que pertenece su cuenta.

Descripción de la operación

Debe adquirir DataWorks Basic Edition o una edición superior para utilizar esta operación.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

  • Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.

  • API: La API que debe invocarse para llevar a cabo la acción.

  • Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.

  • Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.

    • En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.

    • Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.

  • Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.

  • Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

dataworks:ListProjects

list

*All Resource

*

Ninguna Ninguna

Parámetros de la solicitud

Parámetro

Tipo

Obligatorio

Descripción

Ejemplo

Ids

array

No

Los ID de los espacios de trabajo de DataWorks.

integer

No

El ID del espacio de trabajo de DataWorks. Puede iniciar sesión en la consola de DataWorks e ir a la página Espacio de trabajo para consultar el ID.

123456

Names

array

No

Los nombres de los espacios de trabajo de DataWorks.

string

No

El nombre del espacio de trabajo de DataWorks. Puede iniciar sesión en la consola de DataWorks e ir a la página Espacio de trabajo para consultar el nombre.

sora_finance

AliyunResourceGroupId

string

No

El ID del grupo de recursos de Alibaba Cloud al que pertenecen los espacios de trabajo. Puede iniciar sesión en la consola de Administración de recursos e ir a la página Grupos de recursos para consultar el ID.

Este parámetro se utiliza para consultar la información de los espacios de trabajo que pertenecen a un grupo de recursos específico.

rg-acfmzbn7pti3zff

Status

string

No

El estado de los espacios de trabajo. Valores válidos: Available (en ejecución normal), Initializing (inicializando), InitFailed (error de inicialización), Forbidden (deshabilitado manualmente), Deleting (en proceso de eliminación), DeleteFailed (error de eliminación), Frozen (congelado por pagos vencidos), Updating (en proceso de actualización) y UpdateFailed (error de actualización). Este parámetro filtra los espacios de trabajo por el estado especificado.

Available

DevEnvironmentEnabled

boolean

No

Especifica si el entorno de desarrollo está habilitado. Valores válidos:

  • true: El entorno de desarrollo está habilitado. En este caso, el entorno de desarrollo se aísla del entorno de producción en un espacio de trabajo.

  • false: El entorno de desarrollo está deshabilitado. En este caso, solo se utiliza el entorno de producción en un espacio de trabajo.

true

DevRoleDisabled

boolean

No

Especifica si el rol de desarrollador está deshabilitado. Valores válidos: false (habilitado, valor predeterminado) y true (deshabilitado). Este parámetro filtra los espacios de trabajo en función de si el rol de desarrollador está habilitado o deshabilitado.

false

PaiTaskEnabled

boolean

No

Especifica si la programación de tareas de Platform for AI (PAI) está habilitada. Valores válidos:

  • true: La programación de tareas de PAI está habilitada. En este caso, puede crear un nodo de PAI en un espacio de trabajo de DataWorks y configurar las propiedades de programación del nodo para implementar la programación periódica de tareas de PAI.

  • false: La programación de tareas de PAI está deshabilitada.

true

AliyunResourceTags

array<object>

No

La lista de etiquetas. Este parámetro permite consultar los espacios de trabajo que tienen cualquiera de los pares clave-valor de etiqueta especificados.

object

No

La etiqueta. Puede iniciar sesión en la consola de Administración de recursos e ir a la página Etiquetas para consultar la clave y el valor de la etiqueta.

Key

string

No

La clave de la etiqueta.

batch

Value

string

No

El valor de la etiqueta.

blue

PageNumber

integer

No

El número de página.

1

PageSize

integer

No

El número de entradas por página. Valor predeterminado: 10. Valor máximo: 100.

10

Elementos de la respuesta

Elemento

Tipo

Descripción

Ejemplo

object

Los parámetros de respuesta.

RequestId

string

El ID de la solicitud.

6D24AD9A-652F-59E2-AC1F-05029300F8A4

PagingInfo

object

La información de paginación.

PageSize

integer

El número de entradas por página.

1

PageNumber

integer

El número de página.

10

TotalCount

integer

El número total de entradas devueltas.

100

Projects

array<object>

Los espacios de trabajo.

array<object>

El espacio de trabajo.

Id

integer

El ID del espacio de trabajo.

123456

Name

string

El nombre del espacio de trabajo.

sora_finance

DisplayName

string

El nombre para mostrar del espacio de trabajo.

Sora financial analysis

Description

string

La descripción del espacio de trabajo.

Financial analysis group project data development

Owner

string

El ID de la cuenta de Alibaba Cloud a la que pertenece el espacio de trabajo.

123532153125

AliyunResourceGroupId

string

El ID del grupo de recursos de Alibaba Cloud al que pertenece el espacio de trabajo.

rg-acfmzbn7pti3zfa

Status

string

El estado del espacio de trabajo. Valores válidos: Available (en ejecución normal), Initializing (inicializando), InitFailed (error de inicialización), Forbidden (deshabilitado manualmente), Deleting (en proceso de eliminación), DeleteFailed (error de eliminación), Frozen (congelado por pagos vencidos), Updating (en proceso de actualización) y UpdateFailed (error de actualización).

Available

PaiTaskEnabled

boolean

Indica si la programación de tareas de PAI está habilitada. Valores válidos:

  • true: La programación de tareas de PAI está habilitada. En este caso, puede crear un nodo de PAI en un espacio de trabajo de DataWorks y configurar las propiedades de programación del nodo para implementar la programación periódica de tareas de PAI.

  • false: La programación de tareas de PAI está deshabilitada.

true

DevEnvironmentEnabled

boolean

Indica si el entorno de desarrollo está habilitado. Valores válidos:

  • true: El entorno de desarrollo está habilitado. En este caso, el entorno de desarrollo se aísla del entorno de producción en el espacio de trabajo.

  • false: El entorno de desarrollo está deshabilitado. En este caso, solo se utiliza el entorno de producción en el espacio de trabajo.

true

DevRoleDisabled

boolean

Indica si el rol de desarrollador está deshabilitado. Valores válidos: false (habilitado) y true (deshabilitado).

false

AliyunResourceTags

array<object>

Las etiquetas.

object

La etiqueta.

Key

string

La clave de la etiqueta.

batch

Value

string

El valor de la etiqueta.

blue

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "6D24AD9A-652F-59E2-AC1F-05029300F8A4",
  "PagingInfo": {
    "PageSize": 1,
    "PageNumber": 10,
    "TotalCount": 100,
    "Projects": [
      {
        "Id": 123456,
        "Name": "sora_finance",
        "DisplayName": "Sora financial analysis",
        "Description": "Desarrollo de datos del proyecto del grupo de análisis financiero",
        "Owner": "123532153125",
        "AliyunResourceGroupId": "rg-acfmzbn7pti3zfa",
        "Status": "Available",
        "PaiTaskEnabled": true,
        "DevEnvironmentEnabled": true,
        "DevRoleDisabled": false,
        "AliyunResourceTags": [
          {
            "Key": "batch",
            "Value": "blue"
          }
        ]
      }
    ]
  }
}

Códigos de error

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.