Todos os produtos
Search
Central de documentação

:ModifyAutoSnapshotPolicyEx

Última atualização: Jul 03, 2026

Modifica uma política de snapshot automático. Após a modificação de uma política aplicada a discos específicos, as alterações entram em vigor imediatamente nesses discos.

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 códigos de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

ParâmetroTipoObrigatórioExemploDescrição
ActionStringSimModifyAutoSnapshotPolicyEx

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

regionIdStringSimcn-hangzhou

ID da região da política de snapshot automático a ser modificada. Chame a operação DescribeRegions para consultar a lista mais recente de regiões.

autoSnapshotPolicyIdStringSimsp-bp12m37ccmxvbmi5****

ID da política de snapshot automático. Chame a operação DescribeAutoSnapshotPolicyEx para consultar as políticas de snapshot automático disponíveis.

autoSnapshotPolicyNameStringNãoSPTestName

Nome da política de snapshot automático. Se você não especificar este parâmetro, o nome original da política será mantido.

timePointsStringNão["0", "1"]

Horários do dia para criação dos snapshots automáticos. O horário deve estar no fuso UTC+8. Unidade: horas. Valores válidos: 0 a 23, correspondendo aos 24 horários exatos entre 00:00:00 e 23:00:00. Por exemplo, o valor 1 indica 01:00:00.

Para agendar múltiplos snapshots automáticos por dia, especifique várias horas.

  • É possível definir até 24 horários distintos.
  • Defina este parâmetro como um array JSON, como ["0", "1", ... "23"]. Separe os horários com vírgulas (,).
repeatWeekdaysStringNão["1", "7"]

Dias da semana para criação dos snapshots automáticos. Valores válidos: 1 a 7, correspondendo aos dias da semana. Por exemplo, o valor 1 indica segunda-feira.

Para agendar múltiplos snapshots automáticos por semana, especifique vários dias.

  • É possível selecionar até sete dias dentro de uma semana.
  • Defina este parâmetro como um array JSON, como ["1", "2" ... "7"]. Separe os valores do array com vírgulas (,).
retentionDaysIntegerNão30

Período de retenção do snapshot automático. Unidade: dias. Valores válidos:

  • -1: O snapshot automático é retido permanentemente.
  • 1 a 65536: O snapshot automático é retido pelo número especificado de dias.

Valor padrão: -1.

EnableCrossRegionCopyBooleanNãofalse

Indica se a replicação entre regiões deve ser ativada para o snapshot automático.

  • true: ativa a replicação entre regiões para o snapshot automático.
  • false: desativa a replicação entre regiões para o snapshot automático.
TargetCopyRegionsStringNão["cn-hangzhou"]

Região de destino para onde o snapshot será copiado. É possível especificar apenas uma região de destino.

CopiedSnapshotsRetentionDaysIntegerNão30

Período de retenção da cópia do snapshot na região de destino. Unidade: dias. Valores válidos:

  • -1: O snapshot é retido permanentemente.
  • 1 a 65535: O snapshot automático é retido pelo número especificado de dias.

Valor padrão: -1.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

ID da solicitação.

Exemplos

Exemplos de solicitações

https://ecs.aliyuncs.com/?Action=ModifyAutoSnapshotPolicyEx
&autoSnapshotPolicyId=sp-bp12m37ccmxvbmi5****
&regionId=cn-hangzhou
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<ModifyAutoSnapshotPolicyResponse>
    <RequestId>F3CD6886-D8D0-4FEE-B93E-1B73239673DE</RequestId>
</ModifyAutoSnapshotPolicyResponse>

Formato JSON

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

{
  "RequestId" : "F3CD6886-D8D0-4FEE-B93E-1B73239673DE"
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

403

ParameterInvalid

The specified RegionId parameter is invalid.

A mensagem de erro retornada porque o parâmetro regionId especificado é inválido.

403

ParameterInvalid

The specified RepeatWeekDays parameter is invalid.

A mensagem de erro retornada porque o parâmetro repeatWeekdays especificado é inválido.

403

ParameterInvalid

The specified TimePoints parameter is invalid.

A mensagem de erro retornada porque o parâmetro timePoints especificado é inválido.

403

ParameterInvalid

The specified AutoSnapshotPolicyId is invalid.

A mensagem de erro retornada porque o parâmetro autoSnapshotPolicyId especificado é inválido.

403

ParameterInvalid

The specified RetentionDays parameter is invalid.

A mensagem de erro retornada porque o parâmetro retentionDays especificado é inválido.

404

ParameterInvalid

The specified automatic snapshot policy does not exist.

A mensagem de erro retornada porque o parâmetro autoSnapshotPolicyId especificado não existe.

404

ParameterInvalid

The specified automatic snapshot policy does not exist in the region.

A mensagem de erro retornada porque o parâmetro autoSnapshotPolicyId especificado não existe na região.

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