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 atualmente conectado é o aprovador. Ela é compatível com 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 ser omitido na primeira chamada. As solicitações de páginas subsequentes devem usar o valor de 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 solicitaçã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

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

dataworks:ListPendingApprovals

list

*All Resource

*

Nenhuma

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 compatíveis com 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 generalizada. 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 compatíveis com 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 recursos é 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	Metadados do recurso.	{ "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 por principal de autorização. Observação: Os tipos de principal de autorização compatíveis 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 por permissões solicitadas. Observação: Diferentes níveis de recurso são compatíveis com 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	ID da instância do processo.	176906667488145
DefSchema	string	Tipo de recurso.	MaxCompute
Reason	string	Motivo da solicitação.	Business requirement
ApplicationTime	integer	Hora em que a solicitação foi enviada.	Application time
Status	string	Status de aprovação. Valores válidos: WaitApproval: Aprovação pendente Confirmed: Autorização pendente RejectApproval: Aprovação rejeitada AuthorizeSucceed: Autorização bem-sucedida AuthorizeFailed: Falha na autorização Deleted: Excluído Canceled: Cancelado	Deleted
Contents	array<object>	Conteúdo da solicitação.
	array<object>	Conteúdo da solicitação.
Id	string	Identificador exclusivo do conteúdo da solicitação.	210001918826
ProcessInstanceId	string	ID da instância do processo.	176906667488145
TenantId	string	ID do locatário.	69973837489
ResourceName	string	Tipo de recurso de permissão mínima.	table
DefSchema	string	Tipo de recurso.	MaxCompute
AuthMethod	string	Método de autorização.	default
Resource	object	Declaração de recurso.
DefSchema	string	ResourceSchema.name do qual a análise de recursos depende.	MaxCompute
DefVersion	string	ResourceSchema.version da qual a análise de recursos depende.	v1.0.0
MetaData	object	Metadados do recurso. O conteúdo dos dados é restringido pelo ResourceSchema.
	any	Conteúdo do recurso.	{ "schema": "default", "threeTierModel": false, "project": "sync_dtestn", "workspace": "4477656", "table": "order", "tenant": "524257424864736" }
Grantee	object	Descrição do principal de autorização.
PrincipalType	string	Tipo de principal. Valores válidos: RamRole RamUser DataworksTenantMember DataworksTenantRole DataworksProjectMember DataworksProjectRole DlfRole	RamUser
PrincipalId	string	ID do principal. Observação: A semântica do ID varia dependendo do principalType: RamUser: UserId do DataWorks RamRole: UserId do DataWorks com o prefixo "ROLE_" DataworksTenantMember: UserId do DataWorks DataworksTenantRole: roleCode do locatário do DataWorks DataworksProjectRole: roleCode do workspace do DataWorks DataworksProjectMember: UserId do DataWorks DlfRole: Nome da função do DlfNext	213463068144525171
AccessTypes	array	Permissões de operação de recurso solicitadas.
	string	Permissão.	select
FinalAccessTypes	array	Permissões de operação de recurso finalmente aprovadas.
	string	select.	select
ExpirationTime	integer	Data de expiração da permissão, carimbo de data/hora em milissegundos.	1782354014507
Status	string	Status de aprovação. Valores válidos: WaitApproval: Aprovação pendente Confirmed: Autorização pendente RejectApproval: Aprovação rejeitada AuthorizeSucceed: Autorização bem-sucedida AuthorizeFailed: Falha na autorização Deleted: Excluído Canceled: Cancelado	Deleted
CreateTime	integer	Hora de criação.	2025-09-11 10:13:21
UpdateTime	integer	Hora de atualização.	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.