Modifica o nome, a descrição ou o período de retenção de um snapshot.
Experimente agora
Testar
Autorização RAM
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
Exemplo |
| SnapshotId |
string |
Sim |
O ID do snapshot. |
s-bp199lyny9bb47pa**** |
| SnapshotName |
string |
Não |
O nome de exibição do snapshot. O nome deve ter de 2 a 128 caracteres. Deve começar com uma letra ou um caractere chinês e não pode começar com http:// ou https://. Pode conter dígitos, dois pontos (:), sublinhados (_) e hifens (-). Para evitar conflitos de nome com snapshots automáticos, o nome não pode começar com auto. |
testSnapshotName |
| Description |
string |
Não |
A descrição do snapshot. A descrição pode estar vazia e ter até 256 caracteres. Não pode começar com http:// ou https://. |
testDescription |
| DisableInstantAccess |
boolean |
Não |
Especifica se deve ser iniciada a desativação do recurso de acesso instantâneo do snapshot, que permite que um snapshot se torne ativo imediatamente. Valores válidos:
Valor padrão: false. Nota
[Deprecated] Este parâmetro foi descontinuado. Os snapshots padrão do disco ESSD (SSD corporativo, diferente do SSD padrão) são atualizados para acesso instantâneo por padrão. Você não precisa realizar configurações adicionais e nenhuma taxa extra é cobrada. |
false |
| RetentionDays |
integer |
Não |
O período de retenção do snapshot em dias. Ao especificar este parâmetro, o período de retenção é calculado a partir da hora de criação do snapshot. A hora de criação é exibida no padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ e em UTC+0. Valores válidos: 1 a 65536. Nota
Você pode apenas estender o período de retenção de um snapshot. Não é possível reduzir o período de retenção existente de um snapshot. |
10 |
Elementos de resposta
|
Elemento |
Tipo |
Descrição |
Exemplo |
|
object |
|||
| RequestId |
string |
O ID da solicitação. |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
Exemplos
Resposta de sucesso
JSON formato
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}Códigos de erro
|
Código de status HTTP |
Código de erro |
Mensagem de erro |
Descrição |
|---|---|---|---|
| 400 | InvalidSnapshotName.Malformed | The specified SnapshotName is malformed. | |
| 400 | NoAttributeToModify | No attribute to be modified in this request. | |
| 400 | InvalidRetentionDays.Malformed | The specified RetentionDays is not valid. | O período de retenção especificado é inválido. Verifique se o valor do parâmetro RetentionDays está correto. |
| 400 | InvalidOperation.DecreaseRetentionDaysUnsupported | The requested operation to decrease retention days for the snapshot is not supported. | A redução do período de retenção de snapshot não é suportada. |
| 400 | InvalidSnapshotId.NotReady | The specified snapshot has not completed yet. | O snapshot especificado não foi concluído. |
| 400 | IncorrectDiskStatus.CreatingSnapshot | A previous snapshot creation is in process. | Um snapshot está sendo criado para o disco. Aguarde até que o snapshot seja criado e tente novamente. |
| 403 | InvalidOperation.ResourceManagedByCloudProduct | The current operation is not supported because the resource is managed by a cloud product. Please contact the relevant cloud product to confirm the reason. | Os grupos de segurança gerenciados por serviços em nuvem não podem ser modificados. |
| 403 | InvalidOperation.DefaultFreeSnapshotNotSupport | The specified snapshot is a default free snapshot and does not support this operation. | O snapshot especificado é um snapshot gratuito padrão e não suporta a operação atual. |
| 404 | InvalidDescription.Malformed | The specified parameter Description is not valid. Please ensure that the description is 2 to 256 characters long and does not start with "http://" or "https://" and try again. | O parâmetro Description especificado é inválido. Certifique-se de que a descrição tenha de 2 a 256 caracteres e não comece com "http://" ou "https://" e tente novamente. |
| 404 | InvalidSnapshotId.NotFound | The specified SnapshotId does not exist. | |
| 404 | InvalidSnapshotDisableInstantAccess.Malformed | The specified DisableInstantAccess is not valid! |
Consulte Códigos de Erro para uma lista completa.
Notas de versão
Consulte Notas de Versão para uma lista completa.