ListDataAssets - DataWorks - Centro de documentación de Alibaba Cloud

Realiza una consulta paginada de los activos de datos de DataWorks asociados con etiquetas.

Descripción de la operación

Debe adquirir DataWorks Enterprise Edition o una edición posterior para utilizar esta funció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:*

list

*All Resource

*

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
Tags	array<object>	No	La lista de etiquetas asociadas con los activos de datos. Este parámetro se utiliza para filtrar los resultados de la consulta en función de las etiquetas: Se evalúan varios valores con un operador lógico OR. Por ejemplo, si especifica `["key1:v1", "key2:v1", "key3:v1"]`, el sistema consulta los activos de datos que contienen al menos una de las etiquetas especificadas. Si no se especifica este parámetro o se deja vacío, no se realiza ningún filtrado basado en etiquetas.
	object	No	La definición del par clave-valor de la etiqueta.
Key	string	No	La clave de etiqueta personalizada ingresada por el usuario. La clave puede tener hasta 64 caracteres de longitud. No puede empezar por `dw:` y solo puede contener letras, dígitos y los siguientes caracteres especiales: `-@#*<>\|[]()+=&%$!~`.	key
Value	string	No	El valor de la etiqueta.	value
DataAssetIds	array	No	La lista de ID únicos de los activos de datos.
	string	No	El ID único del activo de datos.	7000069357000
DataAssetType	string	No	El tipo de activo del activo de datos. Tabla de DataWorks (ACS::DataWorks::Table) Tarea programada de DataWorks (ACS::DataWorks::Task) Valores válidos: ACS::DataWorks::Task : Tarea de DataWorks. ACS::DataWorks::Table : Tabla de DataWorks.	ACS::DataWorks::Task
ProjectId	integer	No	El ID del espacio de trabajo.	10000
PageNumber	integer	No	El número de página. Las páginas comienzan desde 1. Valor predeterminado: 1.	1
PageSize	integer	No	El número de entradas por página. Valor predeterminado: 10. Valor máximo: 100.	10
EnvType	string	No	El entorno del espacio de trabajo al que pertenece el activo de datos. Valores válidos: Dev: entorno de desarrollo Prod: entorno de producción Valores válidos: Prod : Entorno de producción. Dev : Entorno de desarrollo.	Prod
AssetDomainId	integer	No	El ID del dominio de activos.	1001
CategoryUuid	string	No	El ID de la categoría de activos.	cate-xxxxxxxx
Name	string	No	El nombre del activo. Se admite la búsqueda aproximada por nombre.	Asset domain name

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	Esquema de la respuesta.
RequestId	string	El ID de la solicitud.	0bc1ec92159376
PagingInfo	object	La información de paginación.
TotalCount	integer	El número total de entradas.	100
PageNumber	integer	El número de página.	1
PageSize	integer	El número de entradas por página.	10
DataAssets	array<object>	La lista de activos de datos.
	array<object>	La definición de esquema del activo de datos.
Id	string	El ID del activo de datos.	7259557313
Name	string	El nombre del activo de datos.	ali_cn_es_gfn
Type	string	El tipo de activo del activo de datos. Tabla de DataWorks (ACS::DataWorks::Table) Tarea programada de DataWorks (ACS::DataWorks::Task)	ACS::DataWorks::Task
EnvType	string	El entorno del espacio de trabajo al que pertenece el activo de datos. Valores válidos: Dev: entorno de desarrollo Prod: entorno de producción	Prod
ProjectId	integer	El ID del espacio de trabajo de DataWorks.	54275
DataAssetTagMappings	array<object>	La lista de etiquetas del activo de datos.
	object	La definición de esquema de la relación de asignación entre el activo de datos y la etiqueta.
Key	string	La clave de la etiqueta.	key
Value	string	El valor de la etiqueta.	value
TagSource	string	El origen de la relación entre el activo de datos y la etiqueta. Valores válidos: System: generada por operaciones en el sistema de gobernanza de activos de datos UserDefined: definida manualmente por el usuario	UserDefined
Creator	string	El creador de la relación de asignación entre el activo de datos y la etiqueta.	12345
AutoTraceEnabled	boolean	Especifica si está habilitado el rastreo automático de linaje.	false
DataAssetId	string	El ID del activo de datos.	7259557313
AssetCategories	array<object>	La información de la categoría de activos.
	object	La categoría de activos.
Id	string	El ID de la categoría de activos.	cate-xxxxxx
Name	string	El nombre de la categoría de activos.	Asset domain name
AssetDomainId	string	El ID del dominio de activos.	1001

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "0bc1ec92159376",
  "PagingInfo": {
    "TotalCount": 100,
    "PageNumber": 1,
    "PageSize": 10,
    "DataAssets": [
      {
        "Id": "7259557313",
        "Name": "ali_cn_es_gfn",
        "Type": "ACS::DataWorks::Task",
        "EnvType": "Prod",
        "ProjectId": 54275,
        "DataAssetTagMappings": [
          {
            "Key": "key",
            "Value": "value",
            "TagSource": "UserDefined",
            "Creator": "12345",
            "AutoTraceEnabled": false,
            "DataAssetId": "7259557313"
          }
        ],
        "AssetCategories": [
          {
            "Id": "cate-xxxxxx",
            "Name": "Asset domain name",
            "AssetDomainId": "1001"
          }
        ]
      }
    ]
  }
}

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.