Cria um disco de dados com faturamento conforme o uso ou por assinatura.
Observações de uso
Você pode ativar o recurso de anexo múltiplo (MultiAttach) ao criar um disco. Recomendamos entender o funcionamento e os limites desse recurso antes da ativação. Para mais informações, consulte Discos NVMe e Ativar anexo múltiplo.
É possível criar as seguintes categorias de discos: discos básicos, discos ultra, SSDs padrão, SSDs aprimorados (ESSDs) e discos ESSD AutoPL.
A verificação de nome real é obrigatória para criar discos. Conclua esse processo na página Real-name Verification no Alibaba Cloud Management Console.
A criação de discos pode gerar cobranças pelos recursos utilizados. Familiarize-se com os métodos de faturamento do Elastic Compute Service (ECS) antes de prosseguir. Para mais detalhes, consulte Visão geral de faturamento.
Por padrão, o parâmetro DeleteAutoSnapshot é definido como true na criação do disco. Isso significa que, ao liberar o disco, os snapshots automáticos associados também são excluídos. Para alterar essa configuração, chame a operação ModifyDiskAttribute.
Se nenhum nível de desempenho for configurado na criação de um ESSD, o sistema atribuirá automaticamente o nível PL1. Use a operação ModifyDiskSpec para ajustar o nível de desempenho posteriormente.
Discos criados pela operação CreateDisk possuem, por padrão, o atributo Portable definido como true e utilizam o modelo de pagamento conforme o uso.
Depuração
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Exemplo |
Descrição |
| Action | String | Sim | CreateDisk | A operação a ser executada. Defina o valor como CreateDisk. |
| RegionId | String | Sim | cn-hangzhou | ID da região onde o disco de dados será criado. Chame a operação DescribeRegions para obter a lista atualizada de regiões. |
| ZoneId | String | Não | cn-hangzhou-g | ID da zona onde o disco de pagamento conforme o uso será criado.
|
| SnapshotId | String | Não | s-bp67acfmxazb4p**** | ID do snapshot a ser utilizado na criação do disco. Snapshots criados em ou antes de 15 de julho de 2013 não podem ser usados para criar discos. Os seguintes limites se aplicam aos parâmetros
|
| DiskName | String | Não | testDiskName | Nome do disco. Deve ter entre 2 e 128 caracteres, iniciar com uma letra e não pode começar com Este parâmetro está vazio por padrão. |
| Size | Integer | Não | 2000 | Tamanho do disco. Unidade: GiB. Este parâmetro é obrigatório. Valores válidos:
Se o parâmetro
|
| DiskCategory | String | Não | cloud_ssd | Categoria do disco de dados. Valores válidos:
Valor padrão: cloud. |
| Description | String | Não | testDescription | Descrição do disco. Deve ter entre 2 e 256 caracteres e não pode iniciar com Este parâmetro está vazio por padrão. |
| Encrypted | Boolean | Não | false | Define se o disco deve ser criptografado. Valores válidos:
Valor padrão: false. |
| ClientToken | String | Não | 123e4567-e89b-12d3-a456-426655440000 | Token do cliente usado para garantir a idempotência da solicitação. O token pode ser gerado pelo cliente, mas deve ser único entre solicitações diferentes. Aceita apenas caracteres ASCII e não pode exceder 64 caracteres. Para mais informações, consulte Como garantir idempotência. |
| InstanceId | String | Não | i-bp18pnlg1ds9rky4**** | ID da instância à qual o disco de assinatura criado será anexado.
Este parâmetro está vazio por padrão. Isso indica a criação de um disco de pagamento conforme o uso, cuja localização é definida pelos parâmetros RegionId e ZoneId. |
| ResourceGroupId | String | Não | rg-bp67acfmxazb4p**** | ID do grupo de recursos ao qual o disco será atribuído. |
| KMSKeyId | String | Não | 0e478b7a-4262-4802-b8cb-00d3fb40826X | ID da chave do Key Management Service (KMS) a ser usada para o disco. |
| PerformanceLevel | String | Não | PL1 | Nível de desempenho do ESSD. Valores válidos:
Valor padrão: PL1. Para informações sobre níveis de desempenho de ESSD, consulte ESSDs. |
| AdvancedFeatures | String | Não | hide | Este parâmetro não está disponível publicamente. |
| StorageSetId | String | Não | ss-bp67acfmxazb4p**** | ID do conjunto de armazenamento. Nota É permitido especificar apenas um dos parâmetros relacionados ao conjunto de armazenamento ( StorageSetId e StorageSetPartitionNumber) ou o parâmetro relacionado ao cluster de armazenamento em bloco dedicado (StorageClusterId). Especificar mais de um desses parâmetros resultará em falha na chamada. |
| EncryptAlgorithm | String | Não | hide | Este parâmetro não está disponível publicamente. |
| StorageSetPartitionNumber | Integer | Não | 3 | Número de partições no conjunto de armazenamento. O valor deve ser maior ou igual a 2, sem exceder a cota obtida pela operação DescribeAccountAttributes. Valor padrão: 2. |
| StorageClusterId | String | Não | dbsc-j5e1sf2vaf5he8m2**** | ID do cluster de armazenamento em bloco dedicado. Para criar um disco em um cluster específico, este parâmetro é obrigatório. Nota É permitido especificar apenas um dos parâmetros relacionados ao conjunto de armazenamento ( StorageSetId e StorageSetPartitionNumber) ou o parâmetro relacionado ao cluster de armazenamento em bloco dedicado (StorageClusterId). Especificar mais de um desses parâmetros resultará em falha na chamada. |
| MultiAttach | String | Não | Disabled | Define se o recurso de anexo múltiplo deve ser ativado para o disco. Valores válidos:
Valor padrão: Disabled. Nota Discos com o recurso de anexo múltiplo ativado suportam apenas o método de pagamento conforme o uso. Quando o parâmetro MultiAttach estiver definido como Enabled, não é possível especificar o parâmetro InstanceId. Utilize a operação AttachDisk para anexar discos às instâncias após a criação. Discos com anexo múltiplo só podem ser anexados como discos de dados. |
| Tag.N.key | String | Não | Test | Chave da tag N a ser adicionada ao disco. Nota Recomendamos usar o parâmetro Tag.N.Key para garantir compatibilidade futura. |
| Tag.N.Key | String | Não | TestKey | Chave da tag N a ser adicionada ao disco. Valores válidos de N: 1 a 20. A chave da tag não pode ser uma string vazia, deve ter até 128 caracteres e não pode conter |
| Tag.N.Value | String | Não | TestValue | Valor da tag N a ser adicionada ao disco. Valores válidos de N: 1 a 20. O valor da tag pode ser uma string vazia, deve ter até 128 caracteres e não pode conter |
| Tag.N.value | String | Não | Test | Valor da tag N a ser adicionada ao disco. Nota Recomendamos usar o parâmetro Tag.N.Value para garantir compatibilidade futura. |
| Arn.N.RoleType | String | Não | hide | Este parâmetro não está disponível publicamente. |
| Arn.N.Rolearn | String | Não | hide | Este parâmetro não está disponível publicamente. |
| Arn.N.AssumeRoleFor | Long | Não | 1000000000 | Este parâmetro não está disponível publicamente. |
| ProvisionedIops | Long | Não | 40000 | IOPS de leitura/gravação provisionados do disco ESSD AutoPL. Valores válidos: 0 a min{50000, 1000 × Capacidade - IOPS Base} IOPS Base = min{1800 + 50 × Capacidade, 50000} Nota Este parâmetro está disponível apenas se DataDisk.N.Category estiver definido como cloud_auto. Para mais informações, consulte Discos ESSD AutoPL. |
| BurstingEnabled | Boolean | Não | false | Define se o recurso de pico de desempenho deve ser ativado. Valores válidos:
Nota Este parâmetro está disponível apenas se DiskCategory estiver definido como cloud_auto. Para mais informações, consulte Discos ESSD AutoPL. |
Parâmetros de resposta
Parâmetro |
Tipo |
Exemplo |
Descrição |
| DiskId | String | d-bp131n0q38u3a4zi**** | ID do disco. |
| RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3**** | ID da solicitação. |
| OrderId | String | 20413515388**** | ID do pedido. Nota Este parâmetro é retornado apenas ao criar um disco de assinatura. |
Exemplos
Exemplos de solicitações
https://ecs.aliyuncs.com/?Action=CreateDisk
&RegionId=cn-hangzhou
&ZoneId=cn-hangzhou-g
&SnapshotId=s-bp67acfmxazb4p****
&DiskName=testDiskName
&Size=2000
&DiskCategory=cloud_ssd
&Description=testDescription
&Encrypted=false
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&Tag.1.Key=TestKey
&Tag.1.Value=TestValue
&<Common request parameters>
Exemplos de respostas de sucesso
Formato XML
HTTP/1.1 200 OK
Content-Type:application/xml
<CreateDiskResponse>
<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
<DiskId>d-bp131n0q38u3a4zi****</DiskId>
</CreateDiskResponse>
Formato JSON
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
"DiskId" : "d-bp131n0q38u3a4zi****"
}
Códigos de erro
|
Código de status HTTP |
Código de erro |
Mensagem de erro |
Descrição |
|
400 |
InvalidSize.ValueNotSupported |
The specified parameter Size is not valid. |
Valor de Size inválido. |
|
400 |
InvalidDiskName.Malformed |
The specified disk name is wrongly formed. |
Formato de DiskName inválido. O nome deve ter entre 2 e 128 caracteres e pode conter letras, dígitos, pontos (.), sublinhados (_) e hifens (-). Deve iniciar com uma letra e não pode começar com http:// ou https://. |
|
400 |
InvalidDescription.Malformed |
The specified description is wrongly formed. |
Formato de Description inválido. A descrição deve ter entre 2 e 256 caracteres e não pode iniciar com http:// ou https://. |
|
400 |
InvalidDiskCategory.NotSupported |
The specified disk category is not support. |
Valor de DiskCategory inválido. |
|
400 |
Account.Arrearage |
Your account has an outstanding payment. |
Sua conta possui pedidos não pagos. |
|
400 |
InvalidDataDiskCategory.ValueNotSupported |
%s |
Valor de DataDiskCategory inválido. %s é uma variável. Uma mensagem de erro é retornada dinamicamente com base nas condições da chamada. |
|
400 |
InvalidParameter.Conflict |
%s |
Um parâmetro especificado é inválido. Verifique se existem conflitos de parâmetros. %s é uma variável. Uma mensagem de erro é retornada dinamicamente com base nas condições da chamada. |
|
400 |
RegionUnauthorized |
%s |
Você não tem autorização para executar a operação nesta região. %s é uma variável. Uma mensagem de erro é retornada dinamicamente com base nas condições da chamada. |
|
400 |
Zone.NotOnSale |
%s |
Os recursos solicitados não estão disponíveis na zona especificada. %s é uma variável. Uma mensagem de erro é retornada dinamicamente com base nas condições da chamada. |
|
400 |
InvalidDataDiskSize.ValueNotSupported |
%s |
Valor de Size inválido. %s é uma variável. Uma mensagem de erro é retornada dinamicamente com base nas condições da chamada. |
|
400 |
OperationDenied |
The specified Zone is not available or not authorized. |
A zona especificada está indisponível ou você não tem autorização para acessá-la. |
|
400 |
InvalidDiskSize.NotSupported |
The specified parameter size is not valid. |
Valor de Size inválido. |
|
400 |
InvalidDiskSizeOrCategory |
The specified disk category or size is invalid. |
Valor de DiskCategory ou Size inválido. |
|
400 |
InvalidParameter.EncryptedIllegal |
%s |
Valor de parâmetro inválido. Verifique se sua operação de criptografia é suportada. %s é uma variável. Uma mensagem de erro é retornada dinamicamente com base nas condições da chamada. |
|
400 |
InvalidParameter.EncryptedNotSupported |
%s |
O parâmetro especificado é inválido e sua operação de criptografia não é suportada. %s é uma variável. Uma mensagem de erro é retornada dinamicamente com base nas condições da chamada. |
|
400 |
EncryptedOption.Conflict |
%s |
O parâmetro usado para criptografar discos não é suportado. %s é uma variável. Uma mensagem de erro é retornada dinamicamente com base nas condições da chamada. |
|
400 |
InvalidParameter.EncryptedIllegal |
The specified parameter Encrypted must be true when kmsKeyId is not empty. |
O recurso de criptografia está desativado após a especificação de um ID de chave KMS. |
|
400 |
Duplicate.TagKey |
The Tag.N.Key contain duplicate key. |
A chave da tag já existe. As chaves de tag devem ser únicas. |
|
400 |
InvalidTagKey.Malformed |
The specified Tag.n.Key is not valid. |
Valor de Tag.N.Key inválido. |
|
400 |
InvalidTagValue.Malformed |
The specified Tag.n.Value is not valid. |
Valor de Tag.N.Value inválido. |
|
400 |
InvalidPerformanceLevel.Malformed |
The specified parameter PerformanceLevel is not valid. |
Valor de PerformanceLevel inválido. |
|
400 |
InvalidStorageClusterId.CapacityNotEnough |
The remaining capacity of the current dedicated storage cluster is less than the size of disk. |
A capacidade restante do cluster de armazenamento em bloco dedicado ao qual o disco pertence é insuficiente. |
|
400 |
InvalidInstance.NotFoundSystemDisk |
The specified instance has no system disk. |
A instância especificada não possui disco de sistema anexado. Certifique-se de que a instância tenha um disco de sistema anexado. Chame a operação DescribeInstances para consultar os detalhes da instância. |
|
400 |
ProvisionedIopsForDiskCategoryUnsupported |
The specified disk category does not support provisioned iops. |
A categoria de disco não suporta IOPS provisionados. |
|
400 |
BurstingEnabledForDiskCategoryUnsupported |
The specified disk category does not support bursting enabled. |
A categoria de disco não suporta o recurso de pico de desempenho. |
|
400 |
BurstingEnabledForMultiAttachDiskUnsupported |
The multi attach disk does not support bursting enabled. |
Discos com o recurso de anexo múltiplo ativado não suportam o recurso de pico de desempenho. |
|
400 |
ProvisionedIopsForDiskCategoryRequired |
The provisioned iops is required for this disk category. |
IOPS provisionados são obrigatórios para discos desta categoria. |
|
400 |
NotSupportSnapshotEncrypted.ShareImage |
Shared snapshot creating encrypted disks with native snapshot encrypt is not supported. |
Ao criar discos criptografados com base em uma imagem compartilhada, apenas a chave de criptografia fornecida pela imagem compartilhada pode ser usada; não é possível especificar outras chaves de criptografia. |
|
400 |
NotSupportSnapshotEncrypted.DiskCategory |
The specified disk category does not support creating encrypted disks with native snapshot encrypt. |
Discos desta categoria não podem ser criados com base em snapshots criptografados. |
|
400 |
QuotaExceed.DiskCapacity |
The used capacity of disk type has exceeded the quota in the zone, %s. |
A capacidade dos discos pertencentes à categoria especificada excede o limite de cota da zona. Acesse o Quota Center para visualizar e aumentar a cota. |
|
400 |
InsufficientBalance.AgentAccount |
The account balance is insufficient. Please contact your channel partner to recharge in time. |
O saldo de crédito do seu parceiro de canal é insuficiente. Entre em contato com ele para adicionar fundos à conta oportunamente. |
|
400 |
InvalidAccountStatus.NotEnoughBalance |
Your account does not have enough balance, please contact your partner to increase your account balance. |
Seu saldo de crédito é insuficiente. Entre em contato com seu parceiro de canal para aumentar a disponibilidade da sua conta. |
|
403 |
InvalidDataDiskCategory.NotSupported |
Specified disk category is not supported. |
Valor de DataDiskCategory inválido. |
|
403 |
InstanceDiskCategoryLimitExceed |
The total size of specified disk category in an instance exceeds. |
A capacidade máxima de disco da categoria para uma instância foi excedida. |
|
403 |
InvalidSnapshot.NotReady |
The specified snapshot creation is not completed yet. |
O snapshot especificado ainda não foi criado. |
|
403 |
InvalidSnapshot.TooOld |
This operation is forbidden because the specified snapshot is created before 2013-07-15. |
O snapshot especificado foi criado em ou antes de 15 de julho de 2013 e não pode ser usado para criar discos. |
|
403 |
InvalidSnapshot.TooLarge |
The capacity of snapshot exceeds 2000GB. |
O tamanho do snapshot especificado excede 2.000 GB. |
|
403 |
OperationDenied |
The specified snapshot is not allowed to create disk. |
O snapshot especificado não pode ser usado para criar discos. |
|
403 |
QuotaExceed.PortableCloudDisk |
The quota of portable cloud disk exceeds. |
O número máximo de discos removíveis foi excedido. |
|
403 |
InvalidDiskCategory.ValueUnauthorized |
The disk category is not authorized. |
Você não tem autorização para gerenciar a categoria de disco especificada. |
|
403 |
InvalidSnapshotId.NotReady |
The specified snapshot has not completed yet. |
O snapshot especificado está sendo criado. |
|
403 |
InvalidSnapshotId.NotDataDiskSnapshot |
The specified snapshot is system disk snapshot. |
O snapshot especificado é um snapshot de disco de sistema. |
|
403 |
InvalidDiskSize.TooSmall |
Specified disk size is less than the size of snapshot. |
O tamanho do disco especificado é menor que o tamanho do snapshot. |
|
403 |
OperationDenied |
The type of the disk does not support the operation. |
A categoria de disco não suporta esta operação. |
|
403 |
InvalidDataDiskCategory.NotSupported |
%s |
Categoria de disco de dados inválida. %s é uma variável. Uma mensagem de erro é retornada dinamicamente com base nas condições da chamada. |
|
403 |
InvalidDiskSize.NotSupported |
Disk size is not supported. |
Valor de Size inválido. |
|
403 |
InvalidAccountStatus.NotEnoughBalance |
Your account does not have enough balance. |
O saldo da sua conta é insuficiente. Adicione fundos à sua conta e tente novamente. |
|
403 |
InvalidAccountStatus.SnapshotServiceUnavailable |
Snapshot service has not been opened yet. |
A operação não é suportada enquanto o serviço de snapshot não estiver ativado. |
|
403 |
InvalidPayMethod |
The specified pay method is not valid. |
Método de pagamento inválido. |
|
403 |
InvalidDiskCategory.NotSupported |
The specified disk category is not supported. |
A categoria de disco especificada não suporta esta operação. |
|
403 |
InvalidDiskSize.NotSupported |
The specified disk size is not supported. |
O tamanho de disco especificado não é suportado. |
|
403 |
UserNotInTheWhiteList |
The user is not in disk white list. |
Você não tem autorização para gerenciar o disco. Tente novamente quando estiver autorizado. |
|
403 |
QuotaExceed.PostPaidDisk |
Living postPaid disks quota exceeded. |
O número máximo de discos de pagamento conforme o uso foi excedido. |
|
403 |
InvalidRegion.NotSupport |
The specified region does not support byok. |
O recurso Bring Your Own Key (BYOK) não é suportado na região especificada. |
|
403 |
UserNotInTheWhiteList |
The user is not in byok white list. |
Você não tem autorização para usar o recurso BYOK. Tente novamente após receber autorização. |
|
403 |
InvalidParameter.KMSKeyId.CMKNotEnabled |
The CMK needs to be enabled. |
A chave mestra do cliente (CMK) não está ativada quando o ID da CMK é especificado para um disco. Chame a operação DescribeKey do KMS para consultar as informações sobre a CMK especificada. |
|
403 |
InvalidParameter.KMSKeyId.CMKUnauthorized |
The CMK needs to be added ECS tag. |
Você não tem autorização para usar a CMK. |
|
403 |
InvalidParameter.KMSKeyId.KMSUnauthorized |
ECS service have no right to access your KMS. |
O ECS não tem autorização para acessar seus recursos do KMS. |
|
403 |
SecurityRisk.3DVerification |
We have detected a security risk with your default credit or debit card. Please proceed with verification via the link in your email. |
Foram detectados riscos no seu cartão de crédito ou débito padrão. Clique em na URL no e-mail para verificação. |
|
403 |
InvalidStatus.Upgrading |
The instance is upgrading; please try again later. |
A instância está sendo atualizada. Tente novamente mais tarde. |
|
403 |
QuotaExceed.Tags |
%s |
O número máximo de tags foi excedido. %s é uma variável. Uma mensagem de erro é retornada dinamicamente com base nas condições da chamada. |
|
403 |
QuotaExceeded.PostpaidDataDiskCapacity |
The quota of postpaid data disk capacity exceeds. |
A capacidade de discos de dados de pagamento conforme o uso excede o limite de cota. |
|
403 |
OperationDenied.SnapshotNotAllowed |
The specified snapshot is not allowed to create disk. |
O snapshot especificado não pode ser usado para criar discos. |
|
403 |
LastTokenProcessing |
The last token request is processing. |
Uma solicitação de token está sendo processada. Tente novamente mais tarde. |
|
403 |
InvalidParameter.MultiAttach |
The specified param MultiAttach is not valid. |
Valor de MultiAttach inválido. |
|
403 |
InvalidParameter.MultiAttachAndInstanceIdConflict |
The parameter MultiAttach and InstanceId are conflict. |
MultiAttach e InstanceId não podem ser especificados simultaneamente. |
|
403 |
InvalidParameter.DiskCategoryAndMultiAttachConflict |
The specified disk category does not support multi attach set. |
Dispositivos Shared Block Storage não suportam MultiAttach. |
|
403 |
InvalidParameter.DiskCategoryAndMultiAttachNotMatch |
The specified disk category does not support multi attach enabled. |
A categoria de disco especificada não suporta o recurso de anexo múltiplo. |
|
403 |
OperationDenied.ZoneNotSupportMultiAttachDisk |
The specified zone does support multi attach disk. |
Discos com o recurso de anexo múltiplo ativado não podem ser criados na zona especificada. |
|
403 |
InvalidAccountStatus.CouponAmountNotEnough |
Your coupon balance is insufficient or has expired. |
Seu saldo de cupons é insuficiente ou seus cupons expiraram. |
|
403 |
InvalidOperation.CreateFromSnapshotUnsupported |
The elastic ephemeral disk cannot be created from snapshot. |
Discos efêmeros elásticos não podem ser criados a partir de snapshots. |
|
404 |
InvalidRegionId.NotFound |
The specified RegionId does not exist. |
O RegionId não foi encontrado. |
|
404 |
InvalidZoneId.NotFound |
The specified zone does not exist. |
O ZoneId não foi encontrado. |
|
404 |
InvalidSnapshotId.NotFound |
The specified SnapshotId does not exist. |
O SnapshotId não foi encontrado. |
|
404 |
InvalidResourceGroup.NotFound |
The ResourceGroup provided does not exist in our records. |
O grupo de recursos não foi encontrado. |
|
404 |
InvalidParameter.KMSKeyId.NotFound |
The specified KMSKeyId does not exist. |
O ID da chave KMS especificado não foi encontrado. |
|
404 |
InvalidInstanceId.NotFound |
The InstanceId provided does not exist in our records. |
A instância não foi encontrada. Verifique se o ID da instância está correto. |
|
500 |
InternalError |
The request processing has failed due to some unknown error. |
Ocorreu um erro interno. Tente novamente mais tarde. |
|
500 |
InternalError |
The request processing has failed due to some unknown error, exception or failure. |
Ocorreu um erro interno. Tente novamente mais tarde. |
Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.