DescribePolarFsQuota - PolarDB: Central de Documentação do Alibaba Cloud

Obtém todas as regras de cota para uma instância PolarFileSystem (PolarFS) especificada.

Descrição da operação

Solicitação

Esta operação consulta todas as regras de cota para uma instância PolarFS específica. Ela suporta correspondência com curingas por meio dos parâmetros QuotaNameMatch e PatternMatch.
A paginação ainda não está disponível e será lançada em uma atualização futura do kernel.
O parâmetro PolarFsInstanceId é obrigatório para especificar a instância PolarFS a ser consultada.
Você pode usar parâmetros opcionais, como QuotaNameMatch e PatternMatch, para filtrar regras de cota.
Os dados retornados incluem o número total de regras de cota, o número de regras na página atual e os detalhes de cada regra, como ID da regra, nome, descrição e limite de capacidade.

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

polardb:DescribePolarFsQuota

none

*All Resource

*

Nenhuma

Sintaxe da solicitação

POST  HTTP/1.1

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
PolarFsInstanceId	string	Sim	O ID da instância PolarFS.	pfs-2ze0i74ka607*****
DBClusterId	string	Não	O ID do cluster. Nota Para encontrar o ID do cluster para clusters das edições enterprise, basic ou data lakehouse, chame a operação DescribeDBClusters.	pc-**************
RegionId	string	Não	O ID da região. Nota Chame a operação DescribeRegions para encontrar os IDs de todas as regiões disponíveis na sua conta.	cn-beijing
Path	string	Não	O caminho de destino.	/data
QuotaType	string	Não	O tipo de cota a ser consultado.	quotaPolicy

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	O esquema de resposta.
RequestId	string	O ID da solicitação.	2FED790E-FB61-4721-8C1C-07C627******
PolarFsInstanceId	string	O ID da instância PolarFS.	pfs-2ze0i74ka607*****
PageSize	string	O número de entradas por página. Valores válidos: 5 a 50. Valor padrão: 10.	10
PageNumber	string	O número da página.	1
TotalRecordCount	string	O número total de entradas retornadas.	5
PageRecordCount	string	O número de entradas retornadas na página atual.	5
PolicyItems	array<object>	Os detalhes das regras.
	object	A regra.
Id	integer	O ID da regra.	73
Name	string	O nome da regra.	xxxxx
Description	string	A descrição da regra.	NULL
Include	string	O padrão glob para caminhos a serem incluídos. O padrão deve começar com `/` e suporta sintaxe glob, incluindo ``, `?` e `*`.	/a*
Exclude	string	O padrão glob para caminhos a serem excluídos. O padrão deve começar com `/` e suporta sintaxe glob, incluindo ``, `?` e `*`.	NULL
SizeLimit	integer	O tamanho total máximo dos arquivos no diretório. Unidade: GB. O valor deve ser maior ou igual a 1.	1
FileCountLimit	integer	O número máximo de arquivos no diretório.	77
AccessTTL	integer	O TTL do tempo de acesso. Unidade: segundos.	7200
ChangeTTL	integer	O TTL do tempo de alteração. Unidade: segundos.	7200
Priority	integer	A prioridade da regra de cota.	1
Enabled	boolean	Indica se a regra está ativada. Valores válidos: true: A regra entra em vigor imediatamente para novos eventos. Este é o valor padrão. false: A regra não entra em vigor para novos eventos.	false
QuotaItems	array<object>	As informações de cota.
	object	A cota do diretório.
Path	string	O caminho do diretório.	/data
Capacity	integer	A capacidade. Unidade: bytes.	1073741824
UsedCapacity	integer	A capacidade utilizada. Unidade: bytes.	104857600
Inodes	integer	O número total de inodes.	100
UsedInodes	integer	O número de inodes utilizados.	1
Path	string	O caminho do diretório.	/data

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "2FED790E-FB61-4721-8C1C-07C627******",
  "PolarFsInstanceId": "pfs-2ze0i74ka607*****",
  "PageSize": "10",
  "PageNumber": "1",
  "TotalRecordCount": "5",
  "PageRecordCount": "5",
  "PolicyItems": [
    {
      "Id": 73,
      "Name": "xxxxx",
      "Description": "NULL",
      "Include": "/a*",
      "Exclude": "NULL",
      "SizeLimit": 1,
      "FileCountLimit": 77,
      "AccessTTL": 7200,
      "ChangeTTL": 7200,
      "Priority": 1,
      "Enabled": false
    }
  ],
  "QuotaItems": [
    {
      "Path": "/data",
      "Capacity": 1073741824,
      "UsedCapacity": 104857600,
      "Inodes": 100,
      "UsedInodes": 1
    }
  ],
  "Path": "/data"
}

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.