Todos os produtos
Search
Central de documentação

:DescribeAutoSnapshotPolicies

Última atualização: Jun 27, 2026

Consulta políticas de snapshot automático.

Observações de uso

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar 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 DescribeAutoSnapshotPolicies

Operação a ser executada.

Defina o valor como DescribeAutoSnapshotPolicies.

AutoSnapshotPolicyId String Não sp-extreme-233e6****

ID da política de snapshot automático.

PageSize Integer Não 10

Número de entradas por página.

Valores válidos: 1 a 100.

Valor padrão: 10.

PageNumber Integer Não 1

Número da página.

As páginas começam na página 1. Valor padrão: 1.

FileSystemType String Sim extreme

Tipo do sistema de arquivos.

Valor válido: extreme, que indica sistemas de arquivos Extreme NAS.

Parâmetros de resposta

Parâmetro Tipo Exemplo Descrição
TotalCount Integer 2

Número total de políticas de snapshot automático.

RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

ID da solicitação.

PageSize Integer 10

Número de entradas por página.

PageNumber Integer 1

Número da página.

AutoSnapshotPolicies Array of AutoSnapshotPolicy

Lista de políticas de snapshot automático.

AutoSnapshotPolicy
TimePoints String 4,19

Horários de criação dos snapshots automáticos.

Unidade: horas.

Valores válidos: 0 a 23. Os valores de 0 a 23 indicam um total de 24 horas, das 00:00 às 23:00. Por exemplo, 1 indica 01:00. É possível retornar no máximo 24 horários. Múltiplos horários são separados por vírgulas (,).

Status String Available

Status da política de snapshot automático.

Valores válidos:

  • Creating: a política de snapshot automático está sendo criada.
  • Available: a política de snapshot automático está disponível.
RepeatWeekdays String 1,5

Dias da semana em que os snapshots automáticos são criados.

Os snapshots automáticos são criados semanalmente.

Valores válidos: 1 a 7. Os valores de 1 a 7 indicam os 7 dias da semana, de segunda a domingo.

AutoSnapshotPolicyName String FinanceJoshua

Nome da política de snapshot automático.

CreateTime String 2014-04-21T12:08:52Z

Momento de criação da política de snapshot automático.

O horário segue o padrão ISO8601 no formato yyyy-MM-ddTHH:mm:ssZ. O horário é exibido em UTC.

AutoSnapshotPolicyId String sp-extreme-233e6****

ID da política de snapshot automático.

RetentionDays Integer 30

Período de retenção dos snapshots automáticos.

Unidade: dias.

Valores válidos:

  • -1: os snapshots automáticos são retidos permanentemente. Quando o número de snapshots automáticos excede o limite superior, o snapshot mais antigo é excluído automaticamente.
  • 1 a 65536: os snapshots automáticos são retidos pelos dias especificados. Após o término do período de retenção, os snapshots são excluídos automaticamente.
FileSystemNums Integer 2

Número de sistemas de arquivos aos quais a política de snapshot automático se aplica.

RegionId String cn-hangzhou

ID da região onde a política de snapshot automático reside.

Exemplos

Solicitações de exemplo

http(s)://[Endpoint]/?Action=DescribeAutoSnapshotPolicies
&AutoSnapshotPolicyId=sp-extreme-233e6****
&PageSize=10
&PageNumber=1
&FileSystemType=extreme
&<Common request parameters>

Respostas de sucesso de exemplo

Formato XML

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

<DescribeAutoSnapshotPoliciesResponse>
    <TotalCount>2</TotalCount>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
    <PageSize>10</PageSize>
    <PageNumber>1</PageNumber>
    <AutoSnapshotPolicies>
        <TimePoints>4,19</TimePoints>
        <Status>Available</Status>
        <RepeatWeekdays>1,5</RepeatWeekdays>
        <AutoSnapshotPolicyName>FinanceJoshua</AutoSnapshotPolicyName>
        <CreateTime>2014-04-21T12:08:52Z</CreateTime>
        <AutoSnapshotPolicyId>sp-extreme-233e6****</AutoSnapshotPolicyId>
        <RetentionDays>30</RetentionDays>
        <FileSystemNums>2</FileSystemNums>
        <RegionId>cn-hangzhou</RegionId>
    </AutoSnapshotPolicies>
</DescribeAutoSnapshotPoliciesResponse>

Formato JSON

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

{
  "TotalCount" : 2,
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "PageSize" : 10,
  "PageNumber" : 1,
  "AutoSnapshotPolicies" : [ {
    "TimePoints" : "4,19",
    "Status" : "Available",
    "RepeatWeekdays" : "1,5",
    "AutoSnapshotPolicyName" : "FinanceJoshua",
    "CreateTime" : "2014-04-21T12:08:52Z",
    "AutoSnapshotPolicyId" : "sp-extreme-233e6****",
    "RetentionDays" : 30,
    "FileSystemNums" : 2,
    "RegionId" : "cn-hangzhou"
  } ]
}

Códigos de erro

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