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

Obtém os detalhes de armazenamento das tabelas em um projeto do MaxCompute.

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

get

*Storage

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

Nenhuma

Sintaxe da solicitação

GET /api/v1/observations/analysis/storage/projects/{project}/tablesInfo HTTP/1.1

Parâmetros de caminho

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

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.	28074710977****
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
recentDays	integer	Não	O número de dias para comparação interanual.	1
schema	string	Não	O schema ao qual a tabela pertence.	schema
tablePrefix	string	Não	O nome da tabela para correspondência aproximada.	bank
types	array	Não	O tipo de armazenamento.
	string	Não	O tipo de armazenamento.	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.	0bc12e6a16679892465424670db3eb
httpCode	integer	O código de status HTTP. 1xx: Informativo. 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 concluir a solicitação. 4xx: Erro do cliente. A solicitação contém parâmetros inválidos, sintaxe incorreta ou condições específicas da solicitação não podem ser atendidas. 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	Os dados de resposta.
storageTableInfoList	array<object>	A lista de informações de armazenamento das tabelas.
	object	A lista de informações de armazenamento das tabelas.
date	string	A data estatística. Este campo não é retornado. O formato é YYYYMMDD.	20241205
projectName	string	O nome do projeto.	odps_project
schemaName	string	O nome do schema.	schema
tableName	string	O nome da tabela.	bank_data
isPartitioned	boolean	Especifica se a tabela é uma tabela particionada.	false
storageType	string	O tipo de armazenamento da tabela. Valores válidos: standard: Armazenamento padrão. lowfrequency: Armazenamento de baixa frequência. longterm: Armazenamento de longo prazo. unknown: Este valor é retornado quando a tabela é uma tabela particionada. Você deve chamar a operação ListStoragePartitionsInfo para consultar o tipo de armazenamento de cada partição.	standard
lastAccessTime	integer	A última vez que os dados na tabela foram acessados. Este campo é retornado apenas quando a tabela é uma tabela não particionada. Nota A coleta desses dados foi gradualmente atualizada a partir de julho de 2023. Se a tabela não tiver sido acessada desde a atualização, ou tiver sido acessada por meio de jobs ALGO ou leitura direta do Hologres, a última hora de acesso não poderá ser coletada.	1694589365
totalStorageFileCount	integer	O número total de arquivos.	2
totalStorage	number	O uso total de armazenamento. Para uma tabela particionada, esta é a soma do uso de armazenamento de todas as partições. Se as partições tiverem tipos de armazenamento diferentes, esta é a soma do uso de armazenamento de todos os tipos de armazenamento.	600
totalStorageUnit	string	A unidade de uso de armazenamento.	KB
rate	number	A comparação interanual do uso total de armazenamento nos últimos {$recentDays} dias.	0
standardStorageFileCount	integer	O número de arquivos no armazenamento padrão.	2
standardStorage	number	O uso de armazenamento padrão.	600
standardStorageUnit	string	A unidade de uso de armazenamento padrão.	KB
longTermStorageFileCount	integer	O número de arquivos no armazenamento de longo prazo.	0
longTermStorage	number	O uso de armazenamento de longo prazo.	0
longTermStorageUnit	string	A unidade de uso de armazenamento de longo prazo.	B
lowFreqStorageFileCount	integer	O número de arquivos no armazenamento de baixa frequência.	0
lowFreqStorage	number	O uso de armazenamento de baixa frequência.	0
lowFreqStorageUnit	string	A unidade de uso de armazenamento de baixa frequência.	B
totalFrequency	integer	A frequência de acesso. Nota Os comportamentos de acesso incluem: Nota A tabela é usada como uma tabela de entrada em uma tarefa 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. A coleta de estatísticas para esses dados foi gradualmente atualizada a partir de julho de 2023. Se a tabela não tiver sido acessada desde a atualização, ou tiver sido acessada por meio de jobs ALGO ou leitura direta do Hologres, a frequência de acesso não poderá ser coletada.	10
totalInputAmount	number	A quantidade total de dados acessados. Nota A quantidade total de dados lidos por todos os comportamentos de acesso.	1
totalInputAmountUnit	string	A unidade da quantidade total de dados acessados.	GB
date	string	A data estatística. O formato é YYYYMMDD.	20241205
totalCount	integer	O número total de resultados retornados.	1
pageNumber	integer	O número da página.	1
pageSize	integer	O número de entradas por página.	10

Exemplos

Resposta de sucesso

JSON formato

{
  "requestId": "0bc12e6a16679892465424670db3eb",
  "httpCode": 200,
  "errorCode": "OBJECT_NOT_EXIST",
  "errorMsg": "This object does not exist.\n",
  "data": {
    "storageTableInfoList": [
      {
        "date": "20241205",
        "projectName": "odps_project",
        "schemaName": "schema",
        "tableName": "bank_data",
        "isPartitioned": false,
        "storageType": "standard",
        "lastAccessTime": 1694589365,
        "totalStorageFileCount": 2,
        "totalStorage": 600,
        "totalStorageUnit": "KB",
        "rate": 0,
        "standardStorageFileCount": 2,
        "standardStorage": 600,
        "standardStorageUnit": "KB",
        "longTermStorageFileCount": 0,
        "longTermStorage": 0,
        "longTermStorageUnit": "B",
        "lowFreqStorageFileCount": 0,
        "lowFreqStorage": 0,
        "lowFreqStorageUnit": "B",
        "totalFrequency": 10,
        "totalInputAmount": 1,
        "totalInputAmountUnit": "GB"
      }
    ],
    "date": "20241205",
    "totalCount": 1,
    "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.