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

Obtiene la lista de órdenes de solicitud de permisos pendientes en las que el usuario actual es el aprobador.

Descripción de la operación

Descripción de la solicitud

Esta API consulta todas las órdenes de solicitud de permisos pendientes en las que el usuario actual es el aprobador. Admite filtrar por múltiples condiciones, incluido el tipo de recurso, el intervalo de tiempo y el estado de aprobación, para localizar de manera más precisa órdenes de solicitud específicas.

ResourceType: Especifica el tipo de recurso (como tabla), que puede tener varios valores.
Resource: Proporciona condiciones de búsqueda de recursos específicos, como el nombre del proyecto, la base de datos o la tabla.
StartTime y EndTime: Definen el intervalo de tiempo en el que se envió la solicitud.
Statuses: Permite filtrar los resultados por estado de aprobación, por ejemplo, para ver solo las solicitudes pendientes de aprobación.
Grantee: Filtra las órdenes de solicitud según la información del principal de autorización.
AccessTypes: Filtra según los tipos de permisos específicos solicitados (como lectura o actualización).
PageSize y NextToken: Se utilizan para el control de paginación y especifican la cantidad de datos devueltos por solicitud y el cursor necesario para recuperar la siguiente página de datos.

Notas:

Si no se proporcionan condiciones de filtrado, se devuelven todos los registros coincidentes de forma predeterminada.
El parámetro NextToken puede estar vacío u omitirse en la primera llamada. Las solicitudes de páginas posteriores deben utilizar el valor de NextToken proporcionado en la respuesta anterior.
El valor predeterminado de PageSize es 10 y el valor máximo es 200. Si el valor especificado supera el límite máximo, se utiliza el valor máximo.
Cuando no hay más datos por devolver, el campo HasMore se establece en false y NextToken queda vacío o ausente.

Descripción de la respuesta

Después de una llamada correcta a esta API, el cuerpo de la respuesta contiene resultados paginados e información detallada de cada orden de solicitud, como la hora de la solicitud, la descripción del recurso, el principal de autorización y los permisos solicitados, entre otros. Además, se proporciona el estado del proceso de aprobación y otros metadatos relacionados.

Data: El conjunto de resultados paginados, que incluye el tamaño de página (PageSize), el cursor (NextToken) y si hay más datos disponibles (HasMore).
ApplicationQueryResponse: El contenido específico de cada orden de solicitud, que incluye el motivo de la solicitud, la hora de envío, el estado y una lista detallada del contenido de la solicitud.

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:ListPendingApprovals

list

*All Resource

*

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
DefSchema	string	Sí	Filtra por tipo de recurso. Nota: Los tipos de recursos admitidos para las solicitudes están restringidos por ResourceSchema.name. Referencia: Documentación internacional de ResourceSchema	MaxCompute
ResourceType	array	Sí	Filtra por tipo de recurso de permiso mínimo. Nota: El tipo de recurso de permiso mínimo está restringido por ResourceSchema.resources[*].isValidLeaf cuando es true. Referencia: Documentación internacional de ResourceSchema	["table", "column"]
	string	No	Tipo de recurso.	table
Resource	object	No	Filtra por recurso con coincidencia exacta o generalizada. Las descripciones de recursos están restringidas por ResourceSchema. Referencia: Documentación internacional de ResourceSchema
DefSchema	string	No	Tipo de recurso. Nota: Los tipos de recursos admitidos para las solicitudes están restringidos por ResourceSchema.name. Referencia: Documentación internacional de ResourceSchema	MaxCompute
DefVersion	string	No	La versión de análisis de recursos está restringida por ResourceSchema.version. Referencia: Documentación internacional de ResourceSchema	v1.0.0
MetaData	object	No	Metadatos del recurso. Nota: Los metadatos están restringidos por ResourceSchema.resources. Una declaración de recurso válida debe incluir la declaración de metadatos de la ruta completa desde el nivel 0 hasta el nivel validLeaf. Referencia: Documentación internacional de ResourceSchema
	any	No	Metadatos del recurso.	{ "workspace": "449056", "project": "sync_destination" }
StartTime	integer	No	Hora de inicio del período de solicitud (marca de tiempo en milisegundos).	1771948800000
EndTime	integer	No	Hora de finalización del período de solicitud (marca de tiempo en milisegundos).	1779724799999
Grantee	object	No	Filtra por principal de autorización. Nota: Los tipos de principal de autorización admitidos están restringidos por ResourceSchema.authPrincipal. Referencia: Documentación internacional de ResourceSchema
PrincipalType	string	No	Tipo de principal de autorización.	RamRole
PrincipalId	string	No	ID del principal de autorización.	ROLE_3133343434
AccessTypes	array	No	Filtra por permisos solicitados. Nota: Los diferentes niveles de recursos admiten diferentes tipos de permisos. Todos están restringidos de manera uniforme por ResourceSchema.isValidLeaf, accessTypeRestrictions y authMethodAccessTypes. Referencia: Documentación internacional de ResourceSchema
	string	No	Permiso.	select
NextToken	string	No	Cursor.	eyJpZCI6MTIzfQ==
PageSize	integer	No	Tamaño de página (valor predeterminado: 10, máximo: 200).	20

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	Respuesta de la solicitud de API. El código de error no está vacío cuando la llamada falla.
RequestId	string	ID de la solicitud de API, generado como UUID.	0bc5df3a17****903790e8e8a
Data	object	Resultados paginados.
PageSize	integer	Tamaño de página (valor predeterminado: 10, máximo: 200).	10
NextToken	string	Cursor.	eyJpZCI6MTIzfQ==
HasMore	boolean	Indica si hay más datos disponibles.	false
Data	array<object>	Lista de datos en los resultados paginados.
	array<object>	Proceso de aprobación y contenido de la solicitud.
ProcessInstanceId	string	ID de la instancia del proceso.	176906667488145
DefSchema	string	Tipo de recurso.	MaxCompute
Reason	string	Motivo de la solicitud.	Business requirement
ApplicationTime	integer	Hora en que se envió la solicitud.	Application time
Status	string	Estado de aprobación. Enumeración: WaitApproval: Pendiente de aprobación Confirmed: Pendiente de autorización RejectApproval: Aprobación rechazada AuthorizeSucceed: Autorización exitosa AuthorizeFailed: Autorización fallida Deleted: Eliminado Canceled: Cancelado	Deleted
Contents	array<object>	Contenido de la solicitud.
	array<object>	Contenido de la solicitud.
Id	string	Identificador único del contenido de la solicitud.	210001918826
ProcessInstanceId	string	ID de la instancia del proceso.	176906667488145
TenantId	string	ID del inquilino.	69973837489
ResourceName	string	Tipo de recurso de permiso mínimo.	table
DefSchema	string	Tipo de recurso.	MaxCompute
AuthMethod	string	Método de autorización.	default
Resource	object	Declaración de recurso.
DefSchema	string	ResourceSchema.name del que depende el análisis del recurso.	MaxCompute
DefVersion	string	ResourceSchema.version del que depende el análisis del recurso.	v1.0.0
MetaData	object	Metadatos del recurso. El contenido de los datos está restringido por ResourceSchema.
	any	Contenido del recurso.	{ "schema": "default", "threeTierModel": false, "project": "sync_dtestn", "workspace": "4477656", "table": "order", "tenant": "524257424864736" }
Grantee	object	Descripción del principal de autorización.
PrincipalType	string	Tipo de principal. Enumeración: RamRole RamUser DataworksTenantMember DataworksTenantRole DataworksProjectMember DataworksProjectRole DlfRole	RamUser
PrincipalId	string	ID del principal. Nota: La semántica del ID varía según el principalType: RamUser: UserId de DataWorks RamRole: UserId de DataWorks con el prefijo "ROLE_" DataworksTenantMember: UserId de DataWorks DataworksTenantRole: roleCode del inquilino de DataWorks DataworksProjectRole: roleCode del espacio de trabajo de DataWorks DataworksProjectMember: UserId de DataWorks DlfRole: Nombre de rol de DlfNext	213463068144525171
AccessTypes	array	Permisos de operación de recursos solicitados en la solicitud.
	string	Permiso.	select
FinalAccessTypes	array	Permisos de operación de recursos finalmente aprobados.
	string	select.	select
ExpirationTime	integer	Fecha de vencimiento del permiso, marca de tiempo en milisegundos.	1782354014507
Status	string	Estado de aprobación. Enumeración: WaitApproval: Pendiente de aprobación Confirmed: Pendiente de autorización RejectApproval: Aprobación rechazada AuthorizeSucceed: Autorización exitosa AuthorizeFailed: Autorización fallida Deleted: Eliminado Canceled: Cancelado	Deleted
CreateTime	integer	Hora de creación.	2025-09-11 10:13:21
UpdateTime	integer	Hora de actualización.	2022-07-06 19:13:05

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "0bc5df3a17****903790e8e8a",
  "Data": {
    "PageSize": 10,
    "NextToken": "eyJpZCI6MTIzfQ==",
    "HasMore": false,
    "Data": [
      {
        "ProcessInstanceId": "176906667488145",
        "DefSchema": "MaxCompute",
        "Reason": "Requisito empresarial",
        "ApplicationTime": 0,
        "Status": "Deleted",
        "Contents": [
          {
            "Id": "210001918826",
            "ProcessInstanceId": "176906667488145",
            "TenantId": "69973837489",
            "ResourceName": "table",
            "DefSchema": "MaxCompute",
            "AuthMethod": "default",
            "Resource": {
              "DefSchema": "MaxCompute",
              "DefVersion": "v1.0.0",
              "MetaData": {
                "key": "{\n                \"schema\": \"default\",\n                \"threeTierModel\": false,\n                \"project\": \"sync_dtestn\",\n                \"workspace\": \"4477656\",\n                \"table\": \"order\",\n                \"tenant\": \"524257424864736\"\n              }"
              }
            },
            "Grantee": {
              "PrincipalType": "RamUser",
              "PrincipalId": "213463068144525171"
            },
            "AccessTypes": [
              "select"
            ],
            "FinalAccessTypes": [
              "select"
            ],
            "ExpirationTime": 1782354014507,
            "Status": "Deleted",
            "CreateTime": 0,
            "UpdateTime": 0
          }
        ]
      }
    ]
  }
}

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.