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

Obtém a lista de ordens de solicitação de permissão pendentes para as quais o usuário atual é o aprovador.

Descrição da operação

Descrição da solicitação

Esta API é usada para consultar todas as ordens de solicitação de permissão pendentes para as quais o usuário conectado atual é o aprovador. Ela suporta filtragem por várias condições, incluindo tipo de recurso, intervalo de tempo e status de aprovação, para localizar com mais precisão ordens de solicitação específicas.

ResourceType: Especifica o tipo de recurso (como tabela), que pode ter vários valores.
Resource: Fornece condições de pesquisa de recursos específicos, como o projeto, banco de dados ou nome da tabela.
StartTime e EndTime: Definem o intervalo de tempo durante o qual a solicitação foi enviada.
Statuses: Permite filtrar resultados por status de aprovação, por exemplo, para visualizar apenas solicitações com aprovação pendente.
Grantee: Filtra ordens de solicitação com base nas informações do principal de autorização.
AccessTypes: Filtra com base nos tipos de permissão específicos solicitados (como leitura ou atualização).
PageSize e NextToken: Usados para controle de paginação, especificando a quantidade de dados retornados por solicitação e o cursor necessário para recuperar a próxima página de dados.

Observações:

Se nenhuma condição de filtragem for fornecida, todos os registros correspondentes serão retornados por padrão.
O parâmetro NextToken pode estar vazio ou omitido na primeira chamada. As solicitações de páginas subsequentes devem usar o valor NextToken fornecido na resposta anterior.
O valor padrão de PageSize é 10, e o valor máximo é 200. Se o valor especificado exceder o limite máximo, o valor máximo será usado.
Quando não houver mais dados para retornar, o campo HasMore será definido como false, e NextToken estará vazio ou ausente.

Descrição da resposta

Após uma chamada bem-sucedida para esta API, o corpo da resposta contém resultados paginados e informações detalhadas para cada ordem de solicitação, como o horário da aplicação, descrição do recurso, principal de autorização, permissões solicitadas e muito mais. Além disso, o status do processo de aprovação e outros metadados relacionados são fornecidos.

Data: O conjunto de resultados paginados, incluindo o tamanho da página (PageSize), o cursor (NextToken) e se há mais dados disponíveis (HasMore).
ApplicationQueryResponse: O conteúdo específico de cada ordem de solicitação, incluindo o motivo da solicitação, horário de envio, status e uma lista detalhada do conteúdo da solicitação.

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

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
DefSchema	string	Sim	Filtra por tipo de recurso. Observação: Os tipos de recurso suportados para solicitações são restringidos por ResourceSchema.name. Referência: Documentação internacional do ResourceSchema.	MaxCompute
ResourceType	array	Sim	Filtra pelo tipo de recurso de permissão mínima. Observação: O tipo de recurso de permissão mínima é restringido por ResourceSchema.resources[*].isValidLeaf sendo verdadeiro. Referência: Documentação internacional do ResourceSchema.	["table", "column"]
	string	Não	Tipo de recurso.	table
Resource	object	Não	Filtra por recurso com correspondência exata ou aproximada. As descrições de recursos são restringidas por ResourceSchema. Referência: Documentação internacional do ResourceSchema.
DefSchema	string	Não	Tipo de recurso. Observação: Os tipos de recurso suportados para solicitações são restringidos por ResourceSchema.name. Referência: Documentação internacional do ResourceSchema.	MaxCompute
DefVersion	string	Não	A versão de análise de recurso é restringida por ResourceSchema.version. Referência: Documentação internacional do ResourceSchema.	v1.0.0
MetaData	object	Não	Metadados do recurso. Observação: Os metadados são restringidos por ResourceSchema.resources. Uma declaração de recurso válida deve incluir a declaração de metadados de caminho completo do nível 0 até o nível validLeaf. Referência: Documentação internacional do ResourceSchema.
	any	Não	Resource metadata	{ "workspace": "449056", "project": "sync_destination" }
StartTime	integer	Não	Hora de início do período da solicitação (carimbo de data/hora em milissegundos).	1771948800000
EndTime	integer	Não	Hora de término do período da solicitação (carimbo de data/hora em milissegundos).	1779724799999
Grantee	object	Não	Filtra pelo principal de autorização. Observação: Os tipos de principal de autorização suportados são restringidos por ResourceSchema.authPrincipal. Referência: Documentação internacional do ResourceSchema.
PrincipalType	string	Não	Tipo de principal de autorização.	RamRole
PrincipalId	string	Não	ID do principal de autorização.	ROLE_3133343434
AccessTypes	array	Não	Filtra pelas permissões solicitadas. Observação: Diferentes níveis de recurso suportam diferentes tipos de permissão. Todos são uniformemente restringidos por ResourceSchema.isValidLeaf, accessTypeRestrictions e authMethodAccessTypes. Referência: Documentação internacional do ResourceSchema.
	string	Não	Permissão.	select
NextToken	string	Não	Cursor.	eyJpZCI6MTIzfQ==
PageSize	integer	Não	Tamanho da página (padrão: 10, máximo: 200).	20

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Resposta da solicitação da API. O código de erro não está vazio quando a chamada falha.
RequestId	string	ID da solicitação da API, gerado como UUID.	0bc5df3a17****903790e8e8a
Data	object	Resultados paginados.
PageSize	integer	Tamanho da página (padrão: 10, máximo: 200).	10
NextToken	string	Cursor.	eyJpZCI6MTIzfQ==
HasMore	boolean	Indica se há mais dados disponíveis.	false
Data	array<object>	Lista de dados nos resultados paginados.
	array<object>	Processo de aprovação e conteúdo da solicitação.
ProcessInstanceId	string	Process instance ID.	176906667488145
DefSchema	string	Resource type.	MaxCompute
Reason	string	Reason for the request.	业务需要
ApplicationTime	integer	Time when the request was submitted.	申请时间
Status	string	Approval status. Enumeration: WaitApproval: Pending approval Confirmed: Pending authorization RejectApproval: Approval rejected AuthorizeSucceed: Authorization succeeded AuthorizeFailed: Authorization failed Deleted: Deleted Canceled: Canceled	Deleted
Contents	array<object>	Request content.
	array<object>	Request content
Id	string	Unique identifier of the request content.	210001918826
ProcessInstanceId	string	Process instance ID.	176906667488145
TenantId	string	Tenant ID.	69973837489
ResourceName	string	Minimum permission resource type.	table
DefSchema	string	Resource type.	MaxCompute
AuthMethod	string	Authorization method.	default
Resource	object	Resource declaration.
DefSchema	string	ResourceSchema.name that the resource parsing depends on.	MaxCompute
DefVersion	string	ResourceSchema.version that the resource parsing depends on.	v1.0.0
MetaData	object	Resource metadata. The data content is constrained by ResourceSchema.
	any	Resource content	{ "schema": "default", "threeTierModel": false, "project": "sync_dtestn", "workspace": "4477656", "table": "order", "tenant": "524257424864736" }
Grantee	object	Authorization principal description.
PrincipalType	string	Principal type. Enumeration: RamRole RamUser DataworksTenantMember DataworksTenantRole DataworksProjectMember DataworksProjectRole DlfRole	RamUser
PrincipalId	string	Principal ID. Note: The semantics of the ID vary depending on the principalType: RamUser: DataWorks UserId RamRole: DataWorks UserId prefixed with "ROLE_" DataworksTenantMember: DataWorks UserId DataworksTenantRole: DataWorks tenant roleCode DataworksProjectRole: DataWorks workspace roleCode DataworksProjectMember: DataWorks UserId DlfRole: DlfNext role name	213463068144525171
AccessTypes	array	Resource operation permissions requested in the application.
	string	Permission	select
FinalAccessTypes	array	Resource operation permissions finally approved.
	string	select	select
ExpirationTime	integer	Permission expiration date, millisecond timestamp.	1782354014507
Status	string	Approval status. Enumeration: WaitApproval: Pending approval Confirmed: Pending authorization RejectApproval: Approval rejected AuthorizeSucceed: Authorization succeeded AuthorizeFailed: Authorization failed Deleted: Deleted Canceled: Canceled	Deleted
CreateTime	integer	Creation time.	2025-09-11 10:13:21
UpdateTime	integer	Update time.	2022-07-06 19:13:05

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "0bc5df3a17****903790e8e8a",
  "Data": {
    "PageSize": 10,
    "NextToken": "eyJpZCI6MTIzfQ==",
    "HasMore": false,
    "Data": [
      {
        "ProcessInstanceId": "176906667488145",
        "DefSchema": "MaxCompute",
        "Reason": "业务需要",
        "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 erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.