Crea un disco de datos con método de facturación pay-as-you-go o suscripción.
Notas de uso
Puede habilitar la función de conexión múltiple (MultiAttach) al crear un disco. Se recomienda comprender esta función y sus límites antes de habilitarla. Para más información, consulte NVMe disks y Enable multi-attach.
Puede crear las siguientes categorías de discos: basic disks, ultra disks, standard SSDs, enhanced SSDs (ESSDs) y ESSD AutoPL disks.
Debe completar la verificación de nombre real antes de crear un disco. Complete este proceso en la página Real-name Verification de la consola de administración de Alibaba Cloud.
La creación de discos puede generar cargos por los recursos utilizados. Se recomienda familiarizarse con los métodos de facturación de Elastic Compute Service (ECS) antes de continuar. Para más información, consulte Billing overview.
De forma predeterminada, el parámetro DeleteAutoSnapshot se establece en true al crear un disco. Esto significa que, al liberar el disco, también se eliminan sus instantáneas automáticas. Puede llamar a la operación ModifyDiskAttribute para modificar este parámetro.
Si no configura el nivel de rendimiento al crear un ESSD, este se establece en PL1 de forma predeterminada. Puede llamar a la operación ModifyDiskSpec para modificar el nivel de rendimiento del ESSD.
Cuando se crea un disco mediante la operación CreateDisk, el atributo Portable se establece en true de forma predeterminada y el método de facturación es pay-as-you-go.
Depuración
Parámetros de solicitud
|
Parámetro |
Tipo |
Obligatorio |
Ejemplo |
Descripción |
| Action | String | Sí | CreateDisk | La operación que desea ejecutar. Establezca el valor en CreateDisk. |
| RegionId | String | Sí | cn-hangzhou | El ID de la región donde se creará el disco de datos. Puede llamar a la operación DescribeRegions para consultar la lista de regiones más reciente. |
| ZoneId | String | No | cn-hangzhou-g | El ID de la zona donde se creará el disco pay-as-you-go.
|
| SnapshotId | String | No | s-bp67acfmxazb4p**** | El ID de la instantánea que se usará para crear el disco. Las instantáneas creadas el 15 de julio de 2013 o antes no se pueden usar para crear discos. Los siguientes límites aplican a los parámetros
|
| DiskName | String | No | testDiskName | El nombre del disco. Debe tener entre 2 y 128 caracteres de longitud. Debe comenzar con una letra y no puede empezar con Este parámetro está vacío de forma predeterminada. |
| Size | Integer | No | 2000 | El tamaño del disco. Unidad: GiB. Este parámetro es obligatorio. Valores válidos:
Si se especifica el parámetro
|
| DiskCategory | String | No | cloud_ssd | La categoría del disco de datos. Valores válidos:
Valor predeterminado: cloud. |
| Description | String | No | testDescription | La descripción del disco. Debe tener entre 2 y 256 caracteres de longitud y no puede comenzar con Este parámetro está vacío de forma predeterminada. |
| Encrypted | Boolean | No | false | Especifica si se debe cifrar el disco. Valores válidos:
Valor predeterminado: false. |
| ClientToken | String | No | 123e4567-e89b-12d3-a456-426655440000 | El token de cliente que se usa para garantizar la idempotencia de la solicitud. Puede usar el cliente para generar el token, pero debe asegurarse de que sea único entre distintas solicitudes. El token solo puede contener caracteres ASCII y no debe exceder los 64 caracteres de longitud. Para más información, consulte How to ensure idempotence. |
| InstanceId | String | No | i-bp18pnlg1ds9rky4**** | El ID de la instancia a la que se conectará el disco de suscripción creado.
Este parámetro está vacío de forma predeterminada. Esto indica que se crea un disco pay-as-you-go, y los parámetros RegionId y ZoneId determinan su ubicación. |
| ResourceGroupId | String | No | rg-bp67acfmxazb4p**** | El ID del resource group al que se asignará el disco. |
| KMSKeyId | String | No | 0e478b7a-4262-4802-b8cb-00d3fb40826X | El ID de la clave de Key Management Service (KMS) que se usará para el disco. |
| PerformanceLevel | String | No | PL1 | El nivel de rendimiento del ESSD. Valores válidos:
Valor predeterminado: PL1. Para obtener información sobre los niveles de rendimiento de ESSD, consulte ESSDs. |
| AdvancedFeatures | String | No | hide | Este parámetro no está disponible públicamente. |
| StorageSetId | String | No | ss-bp67acfmxazb4p**** | El ID del conjunto de almacenamiento. Nota Solo puede especificar uno de los parámetros relacionados con conjuntos de almacenamiento ( StorageSetId y StorageSetPartitionNumber) o el parámetro relacionado con clústeres de block storage dedicado (StorageClusterId). Si especifica más de uno de estos parámetros, la llamada fallará. |
| EncryptAlgorithm | String | No | hide | Este parámetro no está disponible públicamente. |
| StorageSetPartitionNumber | Integer | No | 3 | El número de particiones en el conjunto de almacenamiento. El valor debe ser mayor o igual a 2, pero no puede exceder la cuota obtenida al llamar a la operación DescribeAccountAttributes. Valor predeterminado: 2. |
| StorageClusterId | String | No | dbsc-j5e1sf2vaf5he8m2**** | El ID del clúster de block storage dedicado. Para crear un disco en un clúster específico, debe especificar este parámetro. Nota Solo puede especificar uno de los parámetros relacionados con conjuntos de almacenamiento ( StorageSetId y StorageSetPartitionNumber) o el parámetro relacionado con clústeres de block storage dedicado (StorageClusterId). Si especifica más de uno de estos parámetros, la llamada fallará. |
| MultiAttach | String | No | Disabled | Especifica si se debe habilitar la función de conexión múltiple para el disco. Valores válidos:
Valor predeterminado: Disabled. Nota Los discos con la función de conexión múltiple habilitada solo admiten el método de facturación pay-as-you-go. Cuando el parámetro MultiAttach se establece en Enabled, no se puede especificar el parámetro InstanceId. Puede llamar a la operación AttachDisk para conectar discos a instancias después de crearlos. Los discos con conexión múltiple solo se pueden conectar como discos de datos. |
| Tag.N.key | String | No | Test | La clave de la etiqueta N que se agregará al disco. Nota Se recomienda usar el parámetro Tag.N.Key para garantizar la compatibilidad futura. |
| Tag.N.Key | String | No | TestKey | La clave de la etiqueta N que se agregará al disco. Valores válidos de N: 1 a 20. La clave de la etiqueta no puede ser una cadena vacía. Puede tener hasta 128 caracteres de longitud y no puede contener |
| Tag.N.Value | String | No | TestValue | El valor de la etiqueta N que se agregará al disco. Valores válidos de N: 1 a 20. El valor de la etiqueta puede ser una cadena vacía. Puede tener hasta 128 caracteres de longitud y no puede contener |
| Tag.N.value | String | No | Test | El valor de la etiqueta N que se agregará al disco. Nota Se recomienda usar el parámetro Tag.N.Value para garantizar la compatibilidad futura. |
| Arn.N.RoleType | String | No | hide | Este parámetro no está disponible públicamente. |
| Arn.N.Rolearn | String | No | hide | Este parámetro no está disponible públicamente. |
| Arn.N.AssumeRoleFor | Long | No | 1000000000 | Este parámetro no está disponible públicamente. |
| ProvisionedIops | Long | No | 40000 | Las IOPS de lectura/escritura aprovisionadas del disco ESSD AutoPL. Valores válidos: 0 a min{50,000, 1,000 × Capacidad - IOPS base} IOPS base = min{1,800 + 50 × Capacidad, 50,000} Nota Este parámetro solo está disponible si DataDisk.N.Category se establece en cloud_auto. Para más información, consulte ESSD AutoPL disks. |
| BurstingEnabled | Boolean | No | false | Especifica si se debe habilitar la función de ráfaga de rendimiento. Valores válidos:
Nota Este parámetro solo está disponible si DiskCategory se establece en cloud_auto. Para más información, consulte ESSD AutoPL disks. |
Parámetros de respuesta
Parámetro |
Tipo |
Ejemplo |
Descripción |
| DiskId | String | d-bp131n0q38u3a4zi**** | El ID del disco. |
| RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3**** | El ID de la solicitud. |
| OrderId | String | 20413515388**** | El ID del pedido. Nota Este parámetro solo se devuelve cuando se crea un disco de suscripción. |
Ejemplos
Solicitudes de ejemplo
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>
Respuestas exitosas de ejemplo
XML format
HTTP/1.1 200 OK
Content-Type:application/xml
<CreateDiskResponse>
<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
<DiskId>d-bp131n0q38u3a4zi****</DiskId>
</CreateDiskResponse>
JSON format
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
"DiskId" : "d-bp131n0q38u3a4zi****"
}
Códigos de error
|
Código de estado HTTP |
Código de error |
Mensaje de error |
Descripción |
|
400 |
InvalidSize.ValueNotSupported |
The specified parameter Size is not valid. |
Valor de Size no válido. |
|
400 |
InvalidDiskName.Malformed |
The specified disk name is wrongly formed. |
Formato de DiskName no válido. El nombre debe tener entre 2 y 128 caracteres de longitud y puede contener letras, dígitos, puntos (.), guiones bajos (_) y guiones (-). Debe comenzar con una letra y no puede empezar con http:// ni https://. |
|
400 |
InvalidDescription.Malformed |
The specified description is wrongly formed. |
Formato de Description no válido. La descripción debe tener entre 2 y 256 caracteres de longitud y no puede comenzar con http:// ni https://. |
|
400 |
InvalidDiskCategory.NotSupported |
The specified disk category is not support. |
Valor de DiskCategory no válido. |
|
400 |
Account.Arrearage |
Your account has an outstanding payment. |
Su cuenta tiene pedidos pendientes de pago. |
|
400 |
InvalidDataDiskCategory.ValueNotSupported |
%s |
Valor de DataDiskCategory no válido. %s es una variable. Se devuelve un mensaje de error dinámico según las condiciones de la llamada. |
|
400 |
InvalidParameter.Conflict |
%s |
Un parámetro especificado no es válido. Compruebe si existen conflictos de parámetros. %s es una variable. Se devuelve un mensaje de error dinámico según las condiciones de la llamada. |
|
400 |
RegionUnauthorized |
%s |
No tiene autorización para ejecutar la operación en esta región. %s es una variable. Se devuelve un mensaje de error dinámico según las condiciones de la llamada. |
|
400 |
Zone.NotOnSale |
%s |
Los recursos solicitados no están disponibles en la zona especificada. %s es una variable. Se devuelve un mensaje de error dinámico según las condiciones de la llamada. |
|
400 |
InvalidDataDiskSize.ValueNotSupported |
%s |
Valor de Size no válido. %s es una variable. Se devuelve un mensaje de error dinámico según las condiciones de la llamada. |
|
400 |
OperationDenied |
The specified Zone is not available or not authorized. |
La zona especificada no está disponible o no tiene autorización para acceder a ella. |
|
400 |
InvalidDiskSize.NotSupported |
The specified parameter size is not valid. |
Valor de Size no válido. |
|
400 |
InvalidDiskSizeOrCategory |
The specified disk category or size is invalid. |
Valor de DiskCategory o Size no válido. |
|
400 |
InvalidParameter.EncryptedIllegal |
%s |
Valor de parámetro no válido. Compruebe si su operación de cifrado es compatible. %s es una variable. Se devuelve un mensaje de error dinámico según las condiciones de la llamada. |
|
400 |
InvalidParameter.EncryptedNotSupported |
%s |
El parámetro especificado no es válido y su operación de cifrado no es compatible. %s es una variable. Se devuelve un mensaje de error dinámico según las condiciones de la llamada. |
|
400 |
EncryptedOption.Conflict |
%s |
El parámetro usado para cifrar discos no es compatible. %s es una variable. Se devuelve un mensaje de error dinámico según las condiciones de la llamada. |
|
400 |
InvalidParameter.EncryptedIllegal |
The specified parameter Encrypted must be true when kmsKeyId is not empty. |
La función de cifrado está deshabilitada después de especificar un ID de clave KMS. |
|
400 |
Duplicate.TagKey |
The Tag.N.Key contain duplicate key. |
La clave de etiqueta ya existe. Las claves de etiqueta deben ser únicas. |
|
400 |
InvalidTagKey.Malformed |
The specified Tag.n.Key is not valid. |
Valor de Tag.N.Key no válido. |
|
400 |
InvalidTagValue.Malformed |
The specified Tag.n.Value is not valid. |
Valor de Tag.N.Value no válido. |
|
400 |
InvalidPerformanceLevel.Malformed |
The specified parameter PerformanceLevel is not valid. |
Valor de PerformanceLevel no válido. |
|
400 |
InvalidStorageClusterId.CapacityNotEnough |
The remaining capacity of the current dedicated storage cluster is less than the size of disk. |
La capacidad restante del clúster de block storage dedicado al que pertenece el disco es insuficiente. |
|
400 |
InvalidInstance.NotFoundSystemDisk |
The specified instance has no system disk. |
La instancia especificada no tiene un disco de sistema conectado. Asegúrese de que la instancia tenga un disco de sistema conectado. Puede llamar a la operación DescribeInstances para consultar los detalles de la instancia. |
|
400 |
ProvisionedIopsForDiskCategoryUnsupported |
The specified disk category does not support provisioned iops. |
La categoría de disco no admite IOPS aprovisionadas. |
|
400 |
BurstingEnabledForDiskCategoryUnsupported |
The specified disk category does not support bursting enabled. |
La categoría de disco no admite la función de ráfaga de rendimiento. |
|
400 |
BurstingEnabledForMultiAttachDiskUnsupported |
The multi attach disk does not support bursting enabled. |
Los discos con la función de conexión múltiple habilitada no admiten la función de ráfaga de rendimiento. |
|
400 |
ProvisionedIopsForDiskCategoryRequired |
The provisioned iops is required for this disk category. |
Se requieren IOPS aprovisionadas para los discos de esta categoría. |
|
400 |
NotSupportSnapshotEncrypted.ShareImage |
Shared snapshot creating encrypted disks with native snapshot encrypt is not supported. |
Al crear discos cifrados basados en una imagen compartida, solo se puede usar la clave de cifrado proporcionada por dicha imagen; no se pueden especificar claves de cifrado propias para estos discos. |
|
400 |
NotSupportSnapshotEncrypted.DiskCategory |
The specified disk category does not support creating encrypted disks with native snapshot encrypt. |
No se pueden crear discos de esta categoría basados en instantáneas cifradas. |
|
400 |
QuotaExceed.DiskCapacity |
The used capacity of disk type has exceeded the quota in the zone, %s. |
La capacidad de los discos pertenecientes a la categoría especificada supera el límite de cuota de la zona. Puede ir al Centro de cuotas para consultar y aumentar la cuota. |
|
400 |
InsufficientBalance.AgentAccount |
The account balance is insufficient. Please contact your channel partner to recharge in time. |
El saldo de crédito de su socio de canal es insuficiente. Contacte a su socio de canal para agregar fondos a la cuenta oportunamente. |
|
400 |
InvalidAccountStatus.NotEnoughBalance |
Your account does not have enough balance, please contact your partner to increase your account balance. |
Su saldo de crédito es insuficiente. Contacte a su socio de canal para aumentar la disponibilidad de su cuenta. |
|
403 |
InvalidDataDiskCategory.NotSupported |
Specified disk category is not supported. |
Valor de DataDiskCategory no válido. |
|
403 |
InstanceDiskCategoryLimitExceed |
The total size of specified disk category in an instance exceeds. |
Se ha superado la capacidad máxima de disco de la categoría para una instancia. |
|
403 |
InvalidSnapshot.NotReady |
The specified snapshot creation is not completed yet. |
La instantánea especificada aún no se ha creado. |
|
403 |
InvalidSnapshot.TooOld |
This operation is forbidden because the specified snapshot is created before 2013-07-15. |
La instantánea especificada se creó el 15 de julio de 2013 o antes, por lo que no se puede usar para crear discos. |
|
403 |
InvalidSnapshot.TooLarge |
The capacity of snapshot exceeds 2000GB. |
El tamaño de la instantánea especificada supera los 2,000 GB. |
|
403 |
OperationDenied |
The specified snapshot is not allowed to create disk. |
La instantánea especificada no se puede usar para crear discos. |
|
403 |
QuotaExceed.PortableCloudDisk |
The quota of portable cloud disk exceeds. |
Se ha superado el número máximo de discos extraíbles. |
|
403 |
InvalidDiskCategory.ValueUnauthorized |
The disk category is not authorized. |
No tiene autorización para gestionar la categoría de disco especificada. |
|
403 |
InvalidSnapshotId.NotReady |
The specified snapshot has not completed yet. |
La instantánea especificada se está creando. |
|
403 |
InvalidSnapshotId.NotDataDiskSnapshot |
The specified snapshot is system disk snapshot. |
La instantánea especificada es una instantánea de disco de sistema. |
|
403 |
InvalidDiskSize.TooSmall |
Specified disk size is less than the size of snapshot. |
El tamaño de disco especificado es menor que el tamaño de la instantánea. |
|
403 |
OperationDenied |
The type of the disk does not support the operation. |
La categoría de disco no admite esta operación. |
|
403 |
InvalidDataDiskCategory.NotSupported |
%s |
Categoría de disco de datos no válida. %s es una variable. Se devuelve un mensaje de error dinámico según las condiciones de la llamada. |
|
403 |
InvalidDiskSize.NotSupported |
Disk size is not supported. |
Valor de Size no válido. |
|
403 |
InvalidAccountStatus.NotEnoughBalance |
Your account does not have enough balance. |
El saldo de su cuenta es insuficiente. Agregue fondos a su cuenta e inténtelo de nuevo. |
|
403 |
InvalidAccountStatus.SnapshotServiceUnavailable |
Snapshot service has not been opened yet. |
La operación no es compatible mientras el servicio de instantáneas no esté activado. |
|
403 |
InvalidPayMethod |
The specified pay method is not valid. |
Método de pago no válido. |
|
403 |
InvalidDiskCategory.NotSupported |
The specified disk category is not supported. |
La categoría de disco especificada no admite esta operación. |
|
403 |
InvalidDiskSize.NotSupported |
The specified disk size is not supported. |
El tamaño de disco especificado no es compatible. |
|
403 |
UserNotInTheWhiteList |
The user is not in disk white list. |
No tiene autorización para gestionar el disco. Inténtelo de nuevo cuando tenga autorización. |
|
403 |
QuotaExceed.PostPaidDisk |
Living postPaid disks quota exceeded. |
Se ha superado el número máximo de discos pay-as-you-go. |
|
403 |
InvalidRegion.NotSupport |
The specified region does not support byok. |
La función Bring Your Own Key (BYOK) no es compatible en la región especificada. |
|
403 |
UserNotInTheWhiteList |
The user is not in byok white list. |
No tiene autorización para usar la función BYOK. Inténtelo de nuevo después de obtener autorización. |
|
403 |
InvalidParameter.KMSKeyId.CMKNotEnabled |
The CMK needs to be enabled. |
La clave maestra de cliente (CMK) no está habilitada aunque se especificó su ID para un disco. Puede llamar a la operación DescribeKey de KMS para consultar la información de la CMK especificada. |
|
403 |
InvalidParameter.KMSKeyId.CMKUnauthorized |
The CMK needs to be added ECS tag. |
No tiene autorización para usar la CMK. |
|
403 |
InvalidParameter.KMSKeyId.KMSUnauthorized |
ECS service have no right to access your KMS. |
ECS no tiene autorización para acceder a sus recursos de 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. |
Se detectaron riesgos en su tarjeta de crédito o débito predeterminada. Haga clic en la URL del correo electrónico para realizar la verificación. |
|
403 |
InvalidStatus.Upgrading |
The instance is upgrading; please try again later. |
La instancia se está actualizando. Inténtelo de nuevo más tarde. |
|
403 |
QuotaExceed.Tags |
%s |
Se ha superado el número máximo de etiquetas. %s es una variable. Se devuelve un mensaje de error dinámico según las condiciones de la llamada. |
|
403 |
QuotaExceeded.PostpaidDataDiskCapacity |
The quota of postpaid data disk capacity exceeds. |
La capacidad de los discos de datos pay-as-you-go supera el límite de cuota. |
|
403 |
OperationDenied.SnapshotNotAllowed |
The specified snapshot is not allowed to create disk. |
La instantánea especificada no se puede usar para crear discos. |
|
403 |
LastTokenProcessing |
The last token request is processing. |
Se está procesando una solicitud de token. Inténtelo de nuevo más tarde. |
|
403 |
InvalidParameter.MultiAttach |
The specified param MultiAttach is not valid. |
Valor de MultiAttach no válido. |
|
403 |
InvalidParameter.MultiAttachAndInstanceIdConflict |
The parameter MultiAttach and InstanceId are conflict. |
No se pueden especificar MultiAttach e InstanceId simultáneamente. |
|
403 |
InvalidParameter.DiskCategoryAndMultiAttachConflict |
The specified disk category does not support multi attach set. |
Los dispositivos Shared Block Storage no admiten MultiAttach. |
|
403 |
InvalidParameter.DiskCategoryAndMultiAttachNotMatch |
The specified disk category does not support multi attach enabled. |
La categoría de disco especificada no admite la función de conexión múltiple. |
|
403 |
OperationDenied.ZoneNotSupportMultiAttachDisk |
The specified zone does support multi attach disk. |
No se pueden crear discos con la función de conexión múltiple habilitada en la zona especificada. |
|
403 |
InvalidAccountStatus.CouponAmountNotEnough |
Your coupon balance is insufficient or has expired. |
El saldo de sus cupones es insuficiente o han caducado. |
|
403 |
InvalidOperation.CreateFromSnapshotUnsupported |
The elastic ephemeral disk cannot be created from snapshot. |
No se pueden crear discos efímeros elásticos a partir de instantáneas. |
|
404 |
InvalidRegionId.NotFound |
The specified RegionId does not exist. |
No se encontró el RegionId. |
|
404 |
InvalidZoneId.NotFound |
The specified zone does not exist. |
No se encontró el ZoneId. |
|
404 |
InvalidSnapshotId.NotFound |
The specified SnapshotId does not exist. |
No se encontró el SnapshotId. |
|
404 |
InvalidResourceGroup.NotFound |
The ResourceGroup provided does not exist in our records. |
No se encontró el resource group. |
|
404 |
InvalidParameter.KMSKeyId.NotFound |
The specified KMSKeyId does not exist. |
No se encontró el ID de clave KMS especificado. |
|
404 |
InvalidInstanceId.NotFound |
The InstanceId provided does not exist in our records. |
No se encontró la instancia. Compruebe si el ID de la instancia es correcto. |
|
500 |
InternalError |
The request processing has failed due to some unknown error. |
Ocurrió un error interno. Inténtelo de nuevo más tarde. |
|
500 |
InternalError |
The request processing has failed due to some unknown error, exception or failure. |
Ocurrió un error interno. Inténtelo de nuevo más tarde. |
Para consultar la lista de códigos de error, visite Códigos de error del servicio.