AllocateDedicatedHosts - Elastic Compute Service - Centro de documentación de Alibaba Cloud

Crea hosts dedicados de pago por uso o por suscripción. Un host dedicado es un servidor físico exclusivo para un solo inquilino. Puede crear instancias de Elastic Compute Service (ECS) en un host dedicado y ver los atributos del host dedicado.

Descripción de la operación

Antes de crear un host dedicado, puede llamar a la operación DescribeAvailableResource para consultar los recursos disponibles en una región o zona específica.

Se recomienda que comprenda los métodos de facturación de los recursos antes de crear un host dedicado. Se le cobrarán los recursos utilizados por el host dedicado creado. Para obtener más información, consulte Resumen de facturación.

Puede crear hasta 100 hosts dedicados de pago por uso o por suscripción a la vez.
Después de crear un host dedicado, puede utilizar el ID del host dedicado devuelto como valor de un parámetro de solicitud para llamar a la operación DescribeDedicatedHosts y consultar el estado del host dedicado.
Después de enviar una solicitud para crear un host dedicado, se devuelve un error si un parámetro específico no es válido o si los recursos solicitados son insuficientes. Para obtener más información sobre las causas de los errores, consulte la sección "Códigos de error" de este tema.
Después de crear un host dedicado, puede llamar a la operación ModifyInstanceDeployment para migrar instancias de ECS desde un host compartido al host dedicado. También puede migrar instancias de ECS desde otro host dedicado al host dedicado creado.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

ecs:AllocateDedicatedHosts

create

*DedicatedHost

acs:ecs:{#regionId}:{#accountId}:ddh/*

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
RegionId	string	Sí	El ID de la región en la que se creará el host dedicado. Puede llamar a la operación DescribeRegions para consultar la lista de regiones más reciente.	cn-hangzhou
Tag	array<object>	No	Las etiquetas que se agregarán al host dedicado.
	object	No	La etiqueta que se agregará al host dedicado.
Key	string	No	La clave de la etiqueta N que se agregará al host dedicado. Valores válidos de N: 1 a 20. La clave de la etiqueta no puede ser una cadena vacía. La clave de la etiqueta puede tener una longitud máxima de 128 caracteres y no puede contener `http://` ni `https://`. La clave de la etiqueta no puede comenzar con acs: ni aliyun.	Environment
Value	string	No	El valor de la etiqueta N que se agregará al host dedicado. Valores válidos de N: 1 a 20. El valor de la etiqueta puede ser una cadena vacía. El valor de la etiqueta puede tener una longitud máxima de 128 caracteres y no puede contener `http://` ni `https://`.	Production
ResourceGroupId	string	No	El ID del grupo de recursos al que se asignará el host dedicado.	rg-bp67acfmxazb4ph***
ZoneId	string	No	El ID de la zona en la que se creará el host dedicado. Este parámetro está vacío de forma predeterminada. Si no especifica una zona, el sistema selecciona una zona.	cn-hangzhou-f
DedicatedHostName	string	No	El nombre del host dedicado. El nombre debe tener entre 2 y 128 caracteres de longitud y puede contener letras y dígitos. El nombre puede contener dos puntos (:), guiones bajos (_), puntos (.) y guiones (-).	myDDH
DedicatedHostClusterId	string	No	El ID del clúster de hosts dedicados en el que se creará el host dedicado.	dc-bp12wlf6am0vz9v2****
DedicatedHostType	string	Sí	El tipo de host dedicado. Puede llamar a la operación DescribeDedicatedHostTypes para consultar la lista más reciente de tipos de hosts dedicados.	ddh.c5
ActionOnMaintenance	string	No	La política para migrar las instancias desplegadas en el host dedicado cuando el host dedicado falla o necesita reparación en línea. Valores válidos: Migrate: Las instancias se migran a otra máquina física y luego se reinician. Si hay discos en la nube conectados al host dedicado, el valor predeterminado es Migrate. Stop: Las instancias se detienen. Si el host dedicado no se puede reparar, las instancias se migran a otra máquina física y luego se reinician. Si hay discos locales conectados al host dedicado, el valor predeterminado es Stop.	Migrate
NetworkAttributes.SlbUdpTimeout	integer	No	El periodo de tiempo de espera para una sesión UDP entre una instancia de Server Load Balancer (SLB) y el host dedicado. Unidad: segundos. Valores válidos: 15 a 310.	60
NetworkAttributes.UdpTimeout	integer	No	El periodo de tiempo de espera para una sesión UDP entre un usuario y un servicio de Alibaba Cloud en el host dedicado. Unidad: segundos. Valores válidos: 15 a 310.	60
Description	string	No	La descripción del host dedicado. La descripción debe tener entre 2 y 256 caracteres de longitud y no puede comenzar con `http://` ni `https://`.	This-is-my-DDH
AutoPlacement	string	No	Especifica si se debe agregar el host dedicado al pool de recursos para el despliegue automático. Si crea una instancia de ECS en un host dedicado sin especificar el parámetro DedicatedHostId, Alibaba Cloud selecciona un host dedicado del pool de recursos para alojar la instancia. Para obtener más información, consulte Despliegue automático. Valores válidos: on: agrega el host dedicado al pool de recursos para el despliegue automático. off: no agrega el host dedicado al pool de recursos para el despliegue automático. Valor predeterminado: on. Nota Si no desea agregar el host dedicado al pool de recursos para el despliegue automático, establezca este parámetro en off.	off
CpuOverCommitRatio	number	No	La relación de sobreasignación de CPU. Solo puede configurar relaciones de sobreasignación de CPU para los siguientes tipos de hosts dedicados: g6s, c6s y r6s. Valores válidos: 1 a 5. La relación de sobreasignación de CPU afecta el número de vCPU disponibles en un host dedicado. Puede utilizar la siguiente fórmula para calcular el número de vCPU disponibles en un host dedicado: Número de vCPU disponibles = Número de núcleos físicos de CPU × 2 × Relación de sobreasignación de CPU. Por ejemplo, el número de núcleos físicos de CPU en cada host dedicado g6s es 52. Si establece la relación de sobreasignación de CPU de un host dedicado g6s en 4, el número de vCPU disponibles en el host dedicado es 416. Para escenarios que tienen requisitos mínimos de estabilidad de CPU o donde la carga de CPU no es alta, como entornos de desarrollo y prueba, puede aumentar el número de vCPU disponibles en un host dedicado incrementando la relación de sobreasignación de CPU. De esta manera, puede desplegar más instancias de ECS de las mismas especificaciones en el host dedicado y reducir el costo unitario de despliegue.	1
MinQuantity	integer	No	El número mínimo de hosts dedicados que se crearán. Valores válidos: 1 a 100. Nota Si el número de hosts dedicados disponibles es menor que el número mínimo de hosts dedicados que se crearán, se produce un error en la creación de los hosts dedicados.	2
ChargeType	string	No	El método de facturación del host dedicado. Valores válidos: PrePaid: suscripción. Si establece este parámetro en PrePaid, asegúrese de tener saldo suficiente o créditos en su cuenta. De lo contrario, se devuelve `InvalidPayMethod`. PostPaid: pago por uso. Valor predeterminado: PostPaid.	PrePaid
Quantity	integer	No	El número de hosts dedicados que desea crear. Valores válidos: 1 a 100. Valor predeterminado: 1.	2
Period	integer	No	La duración de la suscripción del host dedicado. El parámetro `Period` es obligatorio y solo surte efecto cuando el parámetro `ChargeType` se establece en `PrePaid`. Valores válidos: Valores válidos cuando el parámetro PeriodUnit se establece en Month: 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36, 48 y 60. Valores válidos cuando el parámetro PeriodUnit se establece en Year: 1, 2, 3, 4 y 5.	6
PeriodUnit	string	No	La unidad de la duración de la suscripción del host dedicado. Valores válidos: Month Year Valor predeterminado: Month.	Month
AutoRenew	boolean	No	Especifica si se debe renovar automáticamente el host dedicado por suscripción. Nota El parámetro AutoRenew solo surte efecto cuando el parámetro ChargeType se establece en PrePaid. Valor predeterminado: false.	false
AutoRenewPeriod	integer	No	La duración de la renovación automática del host dedicado. El parámetro AutoRenewPeriod surte efecto y es obligatorio solo cuando el parámetro AutoRenew se establece en true. Valores válidos: Valores válidos cuando PeriodUnit se establece en Month: 1, 2, 3, 6 y 12.	1
AutoReleaseTime	string	No	La hora en la que se liberará automáticamente el host dedicado. Especifique la hora en formato estándar `ISO 8601` yyyy-MM-ddTHH:mm:ssZ. La hora debe estar en UTC. Nota Debe ser al menos media hora posterior a la hora actual. Debe ser como máximo tres años posterior a la hora actual. Si el valor de los segundos (ss) no es 00, se establece automáticamente en 00.	2019-08-21T12:30:24Z
ClientToken	string	No	El token de cliente que se utiliza para garantizar la idempotencia de la solicitud. Puede utilizar el cliente para generar el token, pero debe asegurarse de que el token sea único entre diferentes solicitudes. El token solo puede contener caracteres ASCII y no puede exceder los 64 caracteres de longitud. Para obtener más información, consulte Cómo garantizar la idempotencia.	123e4567-e89b-12d3-a456-426655440000

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	Los parámetros de respuesta.
RequestId	string	El ID de la solicitud.	E2A664A6-2933-4C64-88AE-5033D003****
DedicatedHostIdSets	object
DedicatedHostId	array	Una lista de ID de hosts dedicados.
	string	El ID del host dedicado.	dh-bp67acfmxazb4d****
OrderId	string	El ID del pedido. Nota Este parámetro solo tiene un valor de retorno cuando el host dedicado es por suscripción (parámetro de solicitud ChargeType establecido en PrePaid).	23841229****

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "E2A664A6-2933-4C64-88AE-5033D003****",
  "DedicatedHostIdSets": {
    "DedicatedHostId": [
      "dh-bp67acfmxazb4d****"
    ]
  },
  "OrderId": "23841229****"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidInstanceType.ValueUnauthorized	The specified InstanceType is not authorized.
400	InvalidDescription.Malformed	The specified parameter "Description" is not valid.	The source description can be 2 to 256 characters in length. It cannot start with http:// and https://.
400	InvalidParameter.Conflict	The specified region and cluster do not match.	The specified region and cluster do not correspond to each other.
400	InvalidAutoRenewPeriod.ValueNotSupported	The specified autoRenewPeriod is not valid.	The specified AutoRenewPeriod parameter is invalid.
400	InvalidTagKey.Malformed	The specified Tag.n.Key is not valid.	The specified Tag.N.Key parameter is invalid.
400	InvalidDedicatedHostType.ValueNotSupported	%s	The specified dedicated host type is invalid because it is out of the selectable range.
400	RegionUnauthorized	%s	You do not have the permission to create a private pool in the specified region.
400	Zone.NotOnSale	%s	The requested resources are unavailable in the specified zone. %s is a variable. An error message is dynamically returned based on call conditions.
400	OperationDenied	The specified DedicatedHostType or Zone is not available or not authorized.	The specified dedicated host type or zone is unavailable or you are not authorized to manage the resources.
400	InvalidPeriodUnit.ValueNotSupported	The specified parameter PeriodUnit is not valid.	The specified PeriodUnit parameter is invalid.
400	InvalidTagValue.Malformed	The specified Tag.n.Value is not valid.	The specified tag value is invalid.
400	QuotaExceed.AfterpayDedicatedHost	The maximum number of Pay-As-You-Go DedicatedHosts is exceeded: %s	The inventory of pay-as-you-go dedicated hosts is insufficient. Reduce the number of hosts to create.
400	InvalidChargeType.ValueNotSupported	ChargeType is not valid	The billing method is invalid.
400	InvalidParameter.SlbUdpTimeout	The specified value is invalid.	The specified SlbUdpTimeout parameter is invalid.
400	InvalidParameter.UdpTimeout	The specified value is invalid.	The specified UdpTimeout parameter is invalid.
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	The specified tag key already exists. Tag keys must be unique.
400	InvalidParameter.Quantity	The specified Quantity is invalid.	The specified quantity parameter (Quantity) is invalid.
400	InvalidDedicatedHostPrice.NotFound	The specified Dedicated price is not found.	The specified dedicated host configuration request failed.
400	InvalidDedicatedHostType.CpuOverCommitRatioNotSupported	%s
400	InvalidCpuOverCommitRatio.ValueNotSupported	%s
500	InternalError	The request processing has failed due to some unknown error.
403	OperationDenied	The creation of Host to the specified Zone is not allowed.	Dedicated hosts cannot be created in the specified zone.
403	OperationDenied.NoStock	The requested resource is sold out in the specified zone; try other types of resources or other regions and zones.	The requested resources are insufficient.
403	NodeControllerUnavailable	The Node Controller is temporarily unavailable.
403	InvalidParameter.ResourceOwnerAccount	ResourceOwnerAccount is Invalid.	The specified ResourceOwnerAccount parameter is invalid.
403	InvalidUserData.Forbidden	User not authorized to input the parameter "UserData", please apply for permission "UserData"
403	Zone.NotOpen	The specified zone is not granted to you to buy resources yet.
403	Zone.NotOnSale	The specified zone is not available for purchase.	The requested resources are unavailable in the specified zone. Try a different instance type or select a different region or zone.
403	InvalidResourceType.NotSupported	%s	The specified resource combination does not exist. Change to another zone or specification.
403	InvalidDedicatedHostType.ValueNotSupported	The specified DedicatedHostType does not exist or beyond the permitted range.	The specified dedicated host type is invalid because it is out of the selectable range.
403	InvalidDedicatedHostType.ZoneNotSupported	The specified zone does not support this dedicatedHostType.	The specified zone does not support the specified dedicated host type.
403	InvalidUserData.Base64FormatInvalid	The specified UserData is not valid	An error occurred when the specified UserData parameter is encoded.
403	InvalidParameter.NotMatch	%s	A specified parameter is invalid. Check whether parameter conflicts exist.
403	Account.Arrearage	Your account has been in arrears.
404	OperationDenied.NoStock	The requested resource is sold out in the specified zone; try other types of resources or other regions and zones.
404	InvalidZoneId.NotFound	The ZoneId provided does not exist in our records.
404	OperationDenied	Another Host has been creating	Another host is being created.
404	PaymentMethodNotFound	No payment method has been registered on the account.
404	InvalidDedicatedHostName.Malformed	The specified parameter DedicatedHostName is not valid.
404	InvalidDedicatedHostClusterId.NotFound	The specified DedicatedHostClusterId does not exist.
404	InvalidDedicatedHostClusterId.ExceedMaxSize	The specified Dedicated Host Cluster exceeded max capacity.
404	InvalidParameter.ActionOnMaintenance	The specified ActionOnMaintenance does not exist.	The specified migration plan does not exist.

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.