Todos os produtos
Search
Central de documentação

:Consultar o uso de armazenamento

Última atualização: Jun 26, 2026

Chame a operação DescribeResourceUsage para consultar o uso de armazenamento de uma instância do ApsaraDB RDS.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer, que gera dinamicamente códigos de exemplo para diferentes SDKs.

Parâmetros de solicitação

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

Action

String

Sim

DescribeResourceUsage

Operação a ser executada. Defina o valor como DescribeResourceUsage.

DBInstanceId

String

Sim

rm-uf6wjk5xxxxxxx

ID da instância.

ResourceGroupId

String

Não

rg-acfmy*

ID do grupo de recursos.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

BackupOssDataSize

Long

8821760

Tamanho dos arquivos de backup de dados armazenados nos buckets do Object Storage Service (OSS). Unidade: bytes. O valor 0 indica ausência de arquivos de backup de dados nos buckets do OSS.

DiskUsed

Long

2337275904

Armazenamento total ocupado por arquivos de dados e de log na instância. Unidade: bytes. O valor -1 indica ausência de arquivos de dados ou de log na instância.

ArchiveBackupSize

Long

0

Armazenamento ocupado por arquivos de backup arquivados na instância. Unidade: bytes.

BackupOssLogSize

Long

44180999

Tamanho dos arquivos de backup de log armazenados nos buckets do OSS. Unidade: bytes. O valor 0 indica ausência de arquivos de backup de log nos buckets do OSS.

BackupLogSize

Long

45145563

Armazenamento ocupado por arquivos de backup de log na instância, excluindo backups arquivados. Unidade: bytes.

BackupDataSize

Long

94324736

Armazenamento ocupado por arquivos de backup de dados na instância, excluindo backups arquivados. Unidade: bytes.

ColdBackupSize

Long

2337275904

Armazenamento usado para arquivos de backup frio. Unidade: bytes. O valor -1 indica ausência de arquivos de backup frio.

DataSize

Long

1292094741

Armazenamento usado para arquivos de dados. Unidade: bytes. O valor -1 indica ausência de arquivos de dados.

PaidBackupSize

Long

0

Armazenamento de backup faturável. O ApsaraDB RDS oferece uma cota gratuita; o armazenamento que exceder essa cota será cobrado. Unidade: bytes.

RequestId

String

F937E173-559C-4498-8D90-38D32342B9E4

ID da solicitação.

LogSize

Long

1045181163

Armazenamento usado para arquivos de log. Unidade: bytes. O valor -1 indica ausência de arquivos de log.

BackupSize

Long

53002759

Armazenamento usado para arquivos de backup. Unidade: bytes. O valor -1 indica ausência de arquivos de backup.

DBInstanceId

String

rm-uf6wjk5xxxxxxx

ID da instância.

Engine

String

MySQL

Mecanismo de banco de dados da instância.

SQLSize

Long

315052751

Armazenamento ocupado pela execução de instruções SQL na instância. Unidade: bytes. O valor -1 indica que nenhuma instrução SQL foi executada.

Exemplos

Solicitações de exemplo

http(s)://rds.aliyuncs.com/?Action=DescribeResourceUsage
&DBInstanceId=rm-uf6wjk5xxxxxxx
&<Common request parameters>

Respostas de sucesso de exemplo

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeResourceUsageResponse>
<PaidBackupSize>0</PaidBackupSize>
<RequestId>28E73580-103C-4925-A48D-9A7E25F24297</RequestId>
<BackupSize>51305057407</BackupSize>
<ArchiveBackupSize>0</ArchiveBackupSize>
<ColdBackupSize>-1</ColdBackupSize>
<LogSize>2097152</LogSize>
<BackupOssLogSize>48565375</BackupOssLogSize>
<DBInstanceId> rm-uf6wjk5xxxxxxx</DBInstanceId>
<BackupDataSize>51256492032</BackupDataSize>
<DataSize>3198156800</DataSize>
<BackupLogSize>48565375</BackupLogSize>
<BackupOssDataSize>0</BackupOssDataSize>
<SQLSize>446228522</SQLSize>
<DiskUsed>3200253952</DiskUsed>
<Engine>MySQL</Engine>
</DescribeResourceUsageResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "PaidBackupSize" : 0,
  "RequestId" : "28E73580-103C-4925-A48D-9A7E25F24297",
  "BackupSize" : 51305057407,
  "ArchiveBackupSize" : 0,
  "ColdBackupSize" : -1,
  "LogSize" : 2097152,
  "BackupOssLogSize" : "48565375",
  "DBInstanceId" : " rm-uf6wjk5xxxxxxx",
  "BackupDataSize" : 51256492032,
  "DataSize" : 3198156800,
  "BackupLogSize" : 48565375,
  "BackupOssDataSize" : "0",
  "SQLSize" : 446228522,
  "DiskUsed" : 3200253952,
  "Engine" : "MySQL"
}

Códigos de erro

Para obter uma lista de códigos de erro, visite o API Error Center.