Todos os produtos
Search
Central de documentação

:DescribeSnapshotsUsage

Última atualização: Jul 03, 2026

Consulta a quantidade de snapshots armazenados em uma região e o tamanho total desses snapshots.

Observações de uso

Para visualizar o uso de snapshots de cada disco na região atual, chame a operação DescribeSnapshotLinks para consultar informações sobre as cadeias de snapshots.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, chame esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

Action

String

Sim

DescribeSnapshotsUsage

A operação a ser executada. Defina o valor como DescribeSnapshotsUsage.

RegionId

String

Sim

cn-hangzhou

O ID da região do snapshot. Chame a operação DescribeRegions para consultar a lista mais recente de regiões.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

SnapshotSize

Long

122

O tamanho total dos snapshots armazenados na região atual. Unidade: bytes.

RequestId

String

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

O ID da solicitação.

SnapshotCount

Integer

5

A quantidade de snapshots armazenados na região atual.

Exemplos

Exemplos de solicitações

https://ecs.aliyuncs.com/?Action=DescribeSnapshotsUsage
&RegionId=cn-hangzhou
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<DescribeSnapshotsUsageResponse>
	<SnapshotCount>5</SnapshotCount>
	<SnapshotSize>122</SnapshotSize>    
    <RequestId>ED5CF6DD-71CA-462C-9C94-A61A78A01479</RequestId>
</DescribeSnapshotsUsageResponse>

Formato JSON

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

{
  "SnapshotCount" : "5",
  "SnapshotSize" : "122",
  "RequestId" : "ACD9BBB0-A9D1-46D7-9630-B7A69889E110"
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

403

InvalidParam.RegionId

The specified region is not exist.

A região especificada não existe.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.