Todos los productos
Search
Centro de documentos

:ListProjects

Última actualización: Sep 04, 2026

Consulta por página los espacios de trabajo de DataWorks del inquilino al que pertenece un usuario.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, se recomienda llamar a esta operación en OpenAPI Explorer. OpenAPI Explorer genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro

Tipo

Obligatorio

Ejemplo

Descripción

Action

String

Sí

ListProjects

La operación que desea realizar. Establezca el valor en ListProjects.

PageNumber

Integer

Sí

1

El número de página.

PageSize

Integer

No

10

El número de entradas por página. Valores válidos: de 1 a 100. Valor predeterminado: 10.

ResourceManagerResourceGroupId

String

No

rg-acfmzbn7pti3zfa

El ID del resource group.

Tags

Array

No

Las etiquetas.

Key

String

No

Env

La clave de la etiqueta.

Value

String

No

Test

El valor de la etiqueta.

Parámetros de respuesta

Parámetro Tipo Ejemplo Descripción
RequestId String 20658801***

El ID de la solicitud.

PageResult Object

Los resultados devueltos.

PageNumber Integer 1

El número de página.

PageSize Integer 10

El número de entradas por página. Valores válidos: de 1 a 100. Valor predeterminado: 10.

TotalCount Integer 123

El número total de entradas devueltas.

ProjectList Array of Project

Los espacios de trabajo de DataWorks devueltos.

ProjectStatusCode String AVAILABLE

El código de estado del espacio de trabajo. Valores válidos:

  • AVAILABLE: 0, indica que el espacio de trabajo funciona correctamente.
  • DELETED: 1, indica que el espacio de trabajo está eliminado.
  • INITIALIZING: 2, indica que el espacio de trabajo se está inicializando.
  • INIT_FAILED: 3, indica que hubo un error al inicializar el espacio de trabajo.
  • FORBIDDEN: 4, indica que el espacio de trabajo se deshabilitó manualmente.
  • DELETING: 5, indica que el espacio de trabajo se está eliminando.
  • DEL_FAILED: 6, indica que hubo un error al eliminar el espacio de trabajo.
  • FROZEN: 7, indica que el espacio de trabajo está congelado debido a pagos vencidos.
  • UPDATING: 8, indica que el espacio de trabajo se está actualizando. Después de asociar un motor de cómputo con el espacio de trabajo, el sistema inicializa dicho motor y actualiza el espacio de trabajo.
  • UPDATE_FAILED: 9, indica que hubo un error al actualizar el espacio de trabajo.
ProjectStatus Integer 0

El estado del espacio de trabajo. Valores válidos:

  • 0: AVAILABLE, indica que el espacio de trabajo funciona correctamente.
  • 1: DELETED, indica que el espacio de trabajo está eliminado.
  • 2: INITIALIZING, indica que el espacio de trabajo se está inicializando.
  • 3: INIT_FAILED, indica que hubo un error al inicializar el espacio de trabajo.
  • 4: FORBIDDEN, indica que el espacio de trabajo se deshabilitó manualmente.
  • 5: DELETING, indica que el espacio de trabajo se está eliminando.
  • 6: DEL_FAILED, indica que hubo un error al eliminar el espacio de trabajo.
  • 7: FROZEN, indica que el espacio de trabajo está congelado debido a pagos vencidos.
  • 8: UPDATING, indica que el espacio de trabajo se está actualizando. Después de asociar un motor de cómputo con el espacio de trabajo, el sistema inicializa dicho motor y actualiza el espacio de trabajo.
  • 9: UPDATE_FAILED, indica que hubo un error al actualizar el espacio de trabajo.
ProjectName String Test

El nombre del espacio de trabajo.

ProjectIdentifier String test

El identificador del espacio de trabajo.

ProjectId Long 1212

El ID del espacio de trabajo.

ProjectDescription String Test

La descripción del espacio de trabajo.

ProjectOwnerBaseId String 122222

El ID del propietario del espacio de trabajo.

ResourceManagerResourceGroupId String rg-acfmzbn7pti3zfa

El ID del resource group.

Tags Array of Tag

Las etiquetas.

Key String Env

La clave de la etiqueta.

Value String Test

El valor de la etiqueta.

DisableDevelopment Boolean true

Indica si el rol Development está deshabilitado. Valores válidos:

  • false: habilitado
  • true: deshabilitado
  • Valor predeterminado: false
UseProxyOdpsAccount Boolean true

Indica si se utiliza una cuenta proxy para acceder al motor de cómputo de MaxCompute asociado con el espacio de trabajo.

TablePrivacyMode Integer 1

Indica si las tablas de MaxCompute en el espacio de trabajo son visibles para los usuarios del inquilino. Valores válidos:

  • 0: invisible
  • 1: visible
IsDefault Integer 1

Indica si el espacio de trabajo es predeterminado. Valores válidos:

  • 1: El espacio de trabajo es predeterminado.
  • 0: El espacio de trabajo no es predeterminado.

Ejemplos

Solicitudes de ejemplo

http(s)://[Endpoint]/?Action=ListProjects
&PageNumber=1
&PageSize=10
&ResourceManagerResourceGroupId=rg-acfmzbn7pti3zfa
&Tags=[{"Key":"Env","Value":"Test"}]
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

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

<ListProjectsResponse>
    <RequestId>20658801***</RequestId>
    <PageResult>
        <PageNumber>1</PageNumber>
        <PageSize>10</PageSize>
        <TotalCount>123</TotalCount>
        <ProjectList>
            <ProjectStatusCode>AVAILABLE</ProjectStatusCode>
            <ProjectStatus>0</ProjectStatus>
            <ProjectName>Test</ProjectName>
            <ProjectIdentifier>test</ProjectIdentifier>
            <ProjectId>1212</ProjectId>
            <ProjectDescription>Test</ProjectDescription>
            <ProjectOwnerBaseId>122222</ProjectOwnerBaseId>
            <ResourceManagerResourceGroupId>rg-acfmzbn7pti3zfa</ResourceManagerResourceGroupId>
            <Tags>
                <Key>Env</Key>
                <Value>Test</Value>
            </Tags>
            <DisableDevelopment>true</DisableDevelopment>
            <UseProxyOdpsAccount>true</UseProxyOdpsAccount>
            <TablePrivacyMode>1</TablePrivacyMode>
            <IsDefault>1</IsDefault>
        </ProjectList>
    </PageResult>
</ListProjectsResponse>

Formato JSON

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

{
  "RequestId" : "20658801***",
  "PageResult" : {
    "PageNumber" : 1,
    "PageSize" : 10,
    "TotalCount" : 123,
    "ProjectList" : {
      "ProjectStatusCode" : "AVAILABLE",
      "ProjectStatus" : 0,
      "ProjectName" : "Test",
      "ProjectIdentifier" : "test",
      "ProjectId" : 1212,
      "ProjectDescription" : "Test",
      "ProjectOwnerBaseId" : "122222",
      "ResourceManagerResourceGroupId" : "rg-acfmzbn7pti3zfa",
      "Tags" : {
        "Key" : "Env",
        "Value" : "Test"
      },
      "DisableDevelopment" : true,
      "UseProxyOdpsAccount" : true,
      "TablePrivacyMode" : 1,
      "IsDefault" : 1
    }
  }
}

Códigos de error

Código de estado HTTP

Código de error

Mensaje de error

Descripción

400

Invalid.Tenant.ConnectionNotExists

The connection does not exist.

El origen de datos especificado no existe.

400

Invalid.Tenant.ProjectNotExists

The project does not exist.

El espacio de trabajo especificado no existe.

400

Invalid.Tenant.UserAlreadyInProject

The user already exists in the project.

El usuario que se va a agregar ya se encuentra en el espacio de trabajo.

400

Invalid.Tenant.UserNotInProject

The user is not in the project.

El usuario no está agregado al espacio de trabajo.

403

Invalid.Tenant.UserIsNotProjectOwnerOrAdmin

The user is not a project administrator or owner.

El usuario no es el propietario ni el administrador del espacio de trabajo.

403

Invalid.Tenant.UserNotInTenant

The user is not in tenant.

El usuario no pertenece al inquilino.

Para obtener una lista de códigos de error, consulte Códigos de error del servicio.