CreateSnapshotGroup - Elastic Compute Service: Central de Documentação do Alibaba Cloud

Cria um grupo de consistência de snapshot para discos em nuvem em uma instância ECS especificada. Um grupo de consistência de snapshot contém snapshots de um ou mais discos em nuvem.

Descrição da operação

Você pode definir InstanceId para criar um grupo de consistência de snapshot para discos em nuvem especificados dentro de uma instância. Alternativamente, você pode usar apenas DiskId.N para criar um grupo de consistência de snapshot para vários discos em nuvem anexados a várias instâncias ECS na mesma zona.

Nota

Você não pode definir DiskId.N e ExcludeDiskId.N simultaneamente. Além disso, se InstanceId estiver definido, DiskId.N só poderá ser definido para discos em nuvem anexados à instância especificada. A definição de vários IDs de discos em nuvem em diferentes instâncias não é mais suportada.

Ao criar um grupo de consistência de snapshot, observe os seguintes itens:

Os discos em nuvem para os quais você deseja criar snapshots devem estar no estado Em uso (In_use) ou Disponível (Available).
- Se um disco em nuvem estiver no estado Em uso (In_use), o status da instância ECS deve ser Em execução (Running) ou Parado (Stopped).
- Se um disco em nuvem estiver no estado Disponível (Available), certifique-se de que o disco em nuvem tenha sido montado em uma instância ECS anteriormente. Não é possível criar snapshots para discos em nuvem que nunca foram montados em uma instância ECS.
Atualmente, os grupos de consistência de snapshot suportam apenas discos em nuvem da série ESSD (ESSD, ESSD AutoPL e ESSD Entry).
Um único grupo de consistência de snapshot pode conter até 128 discos em nuvem (incluindo discos em nuvem do sistema e discos em nuvem de dados), e a capacidade total não pode exceder 256 TiB.
Os snapshots que você cria são retidos indefinidamente. Exclua regularmente os snapshots que não são mais necessários para evitar cobrança contínua pelo tamanho do snapshot.
Discos em nuvem com o atributo de anexação múltipla ativado não suportam grupos de consistência de snapshot. Se uma instância tiver montado um disco em nuvem com o atributo de anexação múltipla ativado, você deve configurar as definições do parâmetro ExcludeDiskId.N para excluir o disco em nuvem.

Para obter mais informações sobre os recursos e a cobrança de grupos de consistência de snapshot, consulte Grupos de consistência de snapshot.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região da instância. Você pode chamar DescribeRegions para consultar a lista de regiões mais recente.	cn-hangzhou
InstanceId	string	Não	O ID da instância.	i-j6ca469urv8ei629****
InstantAccess	boolean	Não	Especifica se deve ativar o recurso de acesso instantâneo para snapshots. Valores válidos: true: ativa o recurso. false: desativa. Valor padrão: false. Nota Este parâmetro foi descontinuado. Os snapshots padrão de discos em nuvem ESSD (SSD padrão) foram atualizados para acesso instantâneo por padrão. Você não precisa configurar este parâmetro e nenhuma taxa adicional será cobrada.	false
InstantAccessRetentionDays	integer	Não	Especifica as configurações para a duração de uso do recurso de acesso instantâneo para snapshots. Unidade: dias. Valores válidos: 1 a 65535. Este parâmetro entra em vigor apenas quando InstantAccess é definido como true. Uma desativação automática do recurso de acesso instantâneo é realizada quando o período de retenção expira. Valor padrão: null, o que indica que o período de retenção do recurso de acesso instantâneo é o mesmo que o período de retenção do snapshot. Nota Este parâmetro foi descontinuado. Os snapshots padrão de discos em nuvem ESSD (SSD padrão) foram atualizados para acesso instantâneo por padrão. Você não precisa configurar este parâmetro e nenhuma taxa adicional será cobrada.	1
Name	string	Não	O nome do grupo de consistência de snapshot. O nome deve ter de 2 a 128 caracteres e pode conter letras e caracteres chineses. 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, pontos (.), sublinhados (_), hifens (-) e dois-pontos (:).	testName
Description	string	Não	A descrição do grupo de consistência de snapshot. A descrição deve ter de 2 a 256 caracteres e não pode começar com `http://` ou `https://`.	This is description.
ClientToken	string	Não	O token de cliente usado para garantir a idempotência da solicitação. Você pode usar o cliente para gerar o token, mas deve garantir que o token seja exclusivo entre diferentes solicitações. O token pode conter apenas caracteres ASCII e não pode exceder 64 caracteres. Para obter mais informações, consulte Como garantir a idempotência.	123e4567-e89b-12d3-a456-426655440000
StorageLocationArn	string	Não	Nota Este parâmetro não está disponível.	null
ExcludeDiskId	array	Não	O ID do disco em nuvem na instância para o qual você não deseja criar um snapshot. Depois de especificar um ID de disco em nuvem, o grupo de consistência de snapshot criado não conterá o snapshot desse disco em nuvem. Valores válidos de N: 1 a 128. Valor padrão: null, o que indica que os snapshots são criados para todos os discos em nuvem na instância. Nota Você não pode definir este parâmetro e DiskId.N simultaneamente.	d-j6cf7l0ewidb78lq****
	string	Não	O ID do disco em nuvem na instância para o qual você não deseja criar um snapshot. Depois de especificar um ID de disco em nuvem, o grupo de consistência de snapshot criado não conterá o snapshot desse disco em nuvem. Valores válidos de N: 1 a 128. Valor padrão: null, o que indica que os snapshots são criados para todos os discos em nuvem na instância. Nota Você não pode definir este parâmetro e DiskId.N simultaneamente.	d-j6cf7l0ewidb78lq****
DiskId	array	Não	O ID do disco em nuvem para o qual você deseja criar um grupo de consistência de snapshot. Você pode especificar vários IDs de discos em nuvem em instâncias na mesma zona. Valores válidos de N: 1 a 128. Um único grupo de consistência de snapshot pode conter até 128 discos em nuvem com uma capacidade total de até 256 TiB. Observe os seguintes itens: Você não pode definir este parâmetro e ExcludeDiskId.N simultaneamente. Se você definir InstanceId, só poderá definir este parâmetro para discos em nuvem anexados à instância especificada. A definição de vários IDs de discos em nuvem em diferentes instâncias não é mais suportada.
	string	Não	O ID do disco em nuvem para o qual você deseja criar um grupo de consistência de snapshot. Você pode especificar vários IDs de discos em nuvem em instâncias na mesma zona. Valores válidos de N: 1 a 128. Um único grupo de consistência de snapshot pode conter até 128 discos em nuvem com uma capacidade total de até 256 TiB. Observe os seguintes itens: Você não pode definir este parâmetro e ExcludeDiskId.N simultaneamente. Se você definir InstanceId, só poderá definir este parâmetro para discos em nuvem anexados à instância especificada. A definição de vários IDs de discos em nuvem em diferentes instâncias não é mais suportada.	d-bp1bcpqxahucdrcn****
Tag	array<object>	Não	A lista de tags.
	object	Não
Key	string	Não	A chave da tag N do grupo de consistência de snapshot. Valores válidos de N: 1 a 20. A chave da tag não pode ser uma string vazia. A chave da tag pode ter até 128 caracteres e não pode começar com `aliyun` ou `acs:`. Não pode conter `http://` ou `https://`.	TestKey
Value	string	Não	O valor da tag N do grupo de consistência de snapshot. Valores válidos de N: 1 a 20. O valor da tag pode ser uma string vazia. O valor da tag pode ter até 128 caracteres e não pode começar com `acs:`. Não pode conter `http://` ou `https://`.	TestValue
ResourceGroupId	string	Não	O ID do grupo de recursos ao qual o grupo de consistência de snapshot pertence.	rg-bp67acfmxazb4p****

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	01ABBD93-1ABB-4D92-B496-1A3D20EC0697
SnapshotGroupId	string	O ID do grupo de consistência de snapshot.	ssg-j6ciyh3k52qp7ovm****

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "01ABBD93-1ABB-4D92-B496-1A3D20EC0697",
  "SnapshotGroupId": "ssg-j6ciyh3k52qp7ovm****"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidDiskIds.NotInSameZone	The specified disks are not in the same availability zone.
400	MissingParamter.InstanceId	The specified InstanceId should not be null.
400	InvalidParam.ExcludeDiskIdsAndDiskIds.Conflict	The use of parameter 'ExcludeDiskIds' and 'DiskIds' at the same time is not supported.
400	InvalidSnapshotName.Malformed	The specified SnapshotName is malformed.
400	IncorrectInstanceStatus	The current status of the resource does not support this operation.	O status atual da instância não oferece suporte a este tipo de operação.
400	Duplicate.TagKey	The parameter Tag.N.Key contains duplicate values. Please remove the duplicate tag keys and try again.
400	InvalidTagKey.Malformed	The specified Tag.n.Key is not valid.	O parâmetro de chave de tag especificado é inválido.
400	InvalidTagValue.Malformed	The specified Tag.n.Value is not valid.	O parâmetro de valor da tag especificado é inválido.
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	DiskCategory.OperationNotSupported	The specified disk is encrypted. This operation is not supported.
400	InvalidParameter.Name	The specified Name is invalid.	O parâmetro Name especificado é inválido.
400	InvalidParameter.Description	The specified Description is invalid.
400	InvalidInstantAccessRetentionDays.Malformed	The specified parameter InstantAccessRetentionDays is not valid. Ensure you provide a value between 1 and 65536.
500	InternalError	The request processing has failed due to an internal error and you may retry later or contact support with the request ID.
403	IncorrectDiskStatus.CreatingSnapshot	A previous snapshot creation is in process.
403	InstanceLockedForSecurity	The disk attached instance is locked due to security.
403	IncorrectDiskStatus.NeverAttached	The specified disk has never been attached to any instance.
403	QuotaExceed.Snapshot	The snapshot quota exceeds.
403	IncorrectDiskStatus.NeverUsed	The specified disk has never been used after creating.
403	CreateSnapshot.Failed	The process of creating snapshot is failed.
403	DiskInArrears	The specified operation is denied as your disk has expired.
403	DiskId.ValueNotSupported	The specified parameter diskid is not supported.	Esta operação não é suportada para o tipo de block storage especificado.
403	IncorrectDiskStatus	The current disk status does not support this operation.
403	InvalidAccountStatus.NotEnoughBalance	Your account does not have enough balance.
403	InvalidAccountStatus.SnapshotServiceUnavailable	The snapshot service has not been activated. Please activate it and try again.
403	IncorrectInstanceStatus	The current status of the resource does not support this operation.
403	IncorrectVolumeStatus	The current volume status does not support this operation.	O estado atual não suporta esta operação.
403	IdempotentParameterMismatch	The specified clientToken is used.	Os parâmetros da solicitação são inconsistentes com os da solicitação que usa o mesmo ClientToken.
403	IncorrectDiskStatus.Invalid	The specified device status is invalid. Restart the instance and try again.
403	IncorrectDiskType.NotSupport	The specified device type is not supported.	O tipo de armazenamento do disco especificado não oferece suporte a esta operação.
403	IncorrectDiskStatus.Transferring	The specified device is transferring. You can retry after the process is finished.
403	InvalidParameter.KMSKeyId.CMKNotEnabled	The CMK needs to be enabled.
403	InvalidParameter.KMSKeyId.KMSUnauthorized	ECS service does not have permission to access your KMS key. Please verify that the specified KMS key has authorized the ECS service.
403	IdempotentProcessing	The previous idempotent request(s) is still processing.	A solicitação idempotente anterior ainda está sendo processada. Tente novamente mais tarde.
403	InvalidSnapshotCategory.Malformed	The specified Category is not valid.	O tipo de snapshot especificado é inválido. Verifique se o valor do parâmetro Category está correto.
403	InvalidOperation.Unauthorized	The specified operation is unauthorized.
403	InvalidRegion.NotSupportSnapshotInstantAccessRegion	The snapshot InstantAccess is not supported for this region.
403	InvalidCategoryAndInstantAccess.Malformed	The snapshot Category and InstantAccess can't be used together.
403	IncorrectDiskStatus.TooManyCreatingSnapshots	The specified disk has too many unfinished snapshots.
403	InvalidRegion.NotSupport	The specified region does not support creating snapshot group.
403	UserNotInTheWhiteList	The user is not in the white list of creating snapshot group.
403	InvalidInstance.NoDisk	There is no disk mounted on the instance.	Nenhum disco está anexado à instância.
403	NumberExceed.TooManyDisks	The number of all disks in the request exceeds.	O número de discos na solicitação excede o limite.
403	CapacityExceed.TooManyDisks	The capacity of all disks in the request exceeds.
403	InvalidOperation.MultiAttachDisk	Multi attach disk does not support this operation.	Esta operação não é suportada para discos com o recurso multi-attach ativado.
403	InvalidParameter.KMSKeyId.CMKUnauthorized	The CMK has not authorized the ECS service to perform the KMS TagResource and UntagResource operations. Please verify the authorization and try again.
403	InvalidDisk.DiskCategoryInconsistent	If any specified disk is of a regional disk category; then all disks must also be of that regional disk category.
403	QuotaExceed.ConcurrentSnapshotQuota	The number of snapshots being created for the disk %s has exceeded the concurrent quota (%s). Please wait for the previous snapshots to complete before trying again.	O número de snapshots sendo criados para o disco excede a cota de simultaneidade. Aguarde a conclusão dos snapshots em andamento e tente novamente.
403	InvalidDisk.ShareVolume	The specified diskId is invalid. The shared volume does not support creating a snapshot group.	O DiskId especificado é inválido. Volumes compartilhados não suportam a criação de grupos de snapshots.
403	InvalidParameter.UnauthorizedStorageLocationArn	The operation has failed due to lack of permission for the specified "StorageLocationArn". Please use a resource with appropriate permission for the operation.	A operação atual falhou devido a permissões insuficientes no StorageLocationArn especificado. Entre em contato com o administrador do recurso para obter as permissões necessárias.
403	InvalidOperation.SnapshotStorageLocationUnsupported	Snapshots with storage location in CloudBox do not support the current operation.	Os snapshots armazenados no CloudBox não suportam a operação atual.
403	InvalidStorageLocationArn.Malformed	The specified parameter StorageLocationArn is malformed.
403	Forbidden.InDebt	The operation is not allowed because your account has an outstanding balance. Please settle the overdue payment and try again.
403	InvalidOperation.RegionUnsupported	Creating snapshots is not supported in the specified region. Please use a region that supports the snapshot feature.	A região especificada não oferece suporte à criação de snapshots. Use uma região que ofereça suporte a snapshots.
403	OperationDenied.KMSKeyUnauthorized	The operation is denied due to missing KMS key authorization. Please check the KMS key permissions and ensure the key is properly authorized for this operation.
404	InvalidDiskId.NotFound	The specified DiskId does not exist.	O DiskId especificado não existe. Verifique o ID do disco e a região.
404	InvalidDescription.Malformed	The specified description is malformed.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	A instância especificada não existe. Verifique se o ID da instância está correto.
404	InvalidVolumeId.NotFound	The specified volume does not exist.
404	InvalidRegionId.NotFound	The specified RegionId does not exist.	O RegionId especificado não existe. Verifique se o serviço está disponível na região.
404	InvalidKMSKeyId.NotFound	The specified KMSKeyId does not exist. Please verify that the key ID is correct and that the key resides in the current region.
404	InvalidResourceGroup.NotFound	The ResourceGroup provided does not exist in our records.	O grupo de recursos especificado não existe.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.