ListStoragePartitionsInfo - MaxCompute: Central de Documentação do Alibaba Cloud

Obtém os detalhes de armazenamento de cada partição em uma tabela particionada dentro de um projeto MaxCompute especificado.

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

odps:ListStoragePartitionsInfo

get

*Armazenamento.

acs:odps:{#regionId}:{#accountId}:storage/{#project}

Nenhuma

Sintaxe da solicitação

GET /api/v1/observations/analysis/storage/projects/{project}/tables/{table}/partitionsInfo HTTP/1.1

Parâmetros de caminho

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
project	string	Sim	O nome do projeto MaxCompute.	odps_project
table	string	Sim	O nome da tabela.	bank_data

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
tenantId	string	Não	O ID do locatário. Você pode visualizar o ID do locatário fazendo login no console do MaxCompute e escolhendo Gerenciamento de Locatários > Propriedades do Locatário no painel de navegação à esquerda.	40713753659****
region	string	Não	O ID da região.	cn-beijing
date	string	Sim	A data estatística no nível de dia. Especifique o parâmetro de tempo no formato YYYYMMdd.	20241205
schema	string	Não	O nome do schema.	schema
partitionPrefix	string	Não	O nome da partição para correspondência difusa.	20241201
types	array	Não	Os tipos de armazenamento.
	string	Não	O tipo de armazenamento. Valores válidos: standardStorage: Armazenamento padrão. lowFreqStorage: Armazenamento de baixa frequência. longTermStorage: Armazenamento de longo prazo.	standardStorage
orderColumn	string	Não	A coluna de ordenação.	totalFrequency
ascOrder	boolean	Não	Especifica se os resultados devem ser ordenados em ordem crescente.	false
pageSize	integer	Não	O número de entradas a serem retornadas em cada página. Valor padrão: 10.	10
pageNumber	integer	Não	O número da página.	1

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
requestId	string	O ID da solicitação.	0be3e0bd16661643917136451ebf55
httpCode	integer	O código de status HTTP. Valores válidos: 1xx: Resposta informativa. A solicitação foi recebida e está sendo processada. 2xx: Sucesso. A solicitação foi recebida, compreendida e aceita com sucesso pelo servidor. 3xx: Redirecionamento. A solicitação foi redirecionada e uma ação adicional é necessária para concluí-la. 4xx: Erro do cliente. A solicitação contém sintaxe incorreta, parâmetros inválidos ou não pode ser atendida. 5xx: Erro do servidor. O servidor não conseguiu atender à solicitação devido a outros motivos.	200
errorCode	string	O código de erro.	OBJECT_NOT_EXIST
errorMsg	string	A mensagem de erro.	This object does not exist.
data	object	O resultado retornado.
storagePartitionInfoList	array<object>	A lista de informações de armazenamento de partições.
	object	A lista de informações de armazenamento de partições.
projectName	string	O nome do projeto.	odps_project
schemaName	string	O nome do schema.	schema
tableName	string	O nome da tabela.	bank_data
partition	string	O nome da partição.	ds=20241201
isPartitioned	boolean	Indica se a tabela é particionada. Esta operação de API retorna apenas informações de partição. Você pode ignorar este campo.	false
type	string	O tipo.	PARTITION
storageType	string	O tipo de armazenamento. Valores válidos: standard: Armazenamento padrão. lowfrequency: Armazenamento de baixa frequência. longterm: Armazenamento de longo prazo.	standard
totalFrequency	integer	A frequência de acesso. Nota Os comportamentos de acesso incluem: Nota A tabela é usada como uma tabela de entrada em tarefas de computação SQL. A tabela é baixada usando o Tunnel. A tabela é lida chamando a operação Read da StorageAPI (dados no nível de partição para tabelas particionadas estão indisponíveis no momento). A frequência de acesso aumenta em 1 para cada acesso adicional. As estatísticas para estes dados têm sido gradualmente atualizadas desde julho de 2023. Acessos que não ocorreram após a atualização ou acessos feitos por meio de jobs ALGO ou leitura direta do Hologres não podem ser contabilizados na frequência de acesso.	10
totalInputAmount	number	A quantidade total de dados acessados. Nota A quantidade de dados lidos por todos os comportamentos de acesso.	1
totalInputAmountUnit	string	A unidade da quantidade total de dados acessados.	GB
fileCount	integer	O número de arquivos.	2
fileSize	number	O tamanho do armazenamento.	1
fileSizeUnit	string	A unidade do tamanho do armazenamento.	GB
rate	number	A comparação ano a ano da capacidade total de armazenamento nos últimos {$recentDays} dias. Esta operação de API não retorna este valor.	1%
lastAccessTime	integer	A hora do último acesso aos dados na partição. Nota A coleta destes dados tem sido gradualmente atualizada desde julho de 2023. O last_access_time não pode ser coletado se a partição não tiver sido acessada após a atualização ou se for acessada por meio de jobs ALGO ou leitura direta do Hologres.	1694589365
date	string	A data estatística. O formato é YYYYMMDD.	20241205
totalCount	integer	O número total de resultados retornados.	57
pageNumber	integer	O número da página atual.	1
pageSize	integer	O número de entradas por página.	10

Exemplos

Resposta de sucesso

JSON formato

{
  "requestId": "0be3e0bd16661643917136451ebf55",
  "httpCode": 200,
  "errorCode": "OBJECT_NOT_EXIST",
  "errorMsg": "This object does not exist.",
  "data": {
    "storagePartitionInfoList": [
      {
        "projectName": "odps_project",
        "schemaName": "schema",
        "tableName": "bank_data",
        "partition": "ds=20241201",
        "isPartitioned": false,
        "type": "PARTITION",
        "storageType": "standard",
        "totalFrequency": 10,
        "totalInputAmount": 1,
        "totalInputAmountUnit": "GB",
        "fileCount": 2,
        "fileSize": 1,
        "fileSizeUnit": "GB",
        "rate": 0,
        "lastAccessTime": 1694589365
      }
    ],
    "date": "20241205",
    "totalCount": 57,
    "pageNumber": 1,
    "pageSize": 10
  }
}

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.