CreateDedicatedHost - - Centro de documentación de Alibaba Cloud

Cree un host en un clúster dedicado.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos que invoque esta operación en OpenAPI Explorer. OpenAPI Explorer genera dinámicamente el código de ejemplo de la operación para diferentes SDKs.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	CreateDedicatedHost	La operación que desea ejecutar. Establezca el valor en CreateDedicatedHost.
RegionId	String	Sí	cn-hangzhou	El ID de la región donde se despliega el clúster. Para obtener el ID de la región, consulte IDs de regiones.
DedicatedHostGroupId	String	Sí	dhg-6w7q18iwt5jo****	El ID del clúster que contiene el host. Para consultar el ID del clúster, inicie sesión en la consola de ApsaraDB MyBase y consulte el ID del clúster en la página Dedicated Clusters. Nota El motor de base de datos del host debe ser el mismo que el del clúster.
ZoneId	String	Sí	cn-hangzhou-i	El ID de la zona donde desea desplegar el host. Para obtener el ID de la zona, consulte Clústeres dedicados.
VSwitchId	String	Sí	vsw-bp133c8ifzxd3iv6q****	El ID del vSwitch al que desea conectar el host. Puede consultar el ID del vSwitch en la consola de Virtual Private Cloud (VPC).
HostClass	String	Sí	rds.g6.4xlarge	La especificación del host. Para obtener información sobre las especificaciones de host compatibles con los diferentes tipos de bases de datos, consulte Tipos de instancia de hosts.
PayType	String	Sí	prepaid	El método de facturación. Establezca el valor en prepaid. prepaid indica el método de facturación por suscripción.
Period	String	No	Month	La unidad de duración de la suscripción. Valores válidos: Year Month
UsedTime	String	No	1	La duración de la suscripción del host. Valores válidos: Si el parámetro Period se establece en Year, los valores válidos para el parámetro UsedTime son números enteros del 1 al 5. Si el parámetro Period se establece en Month, los valores válidos para el parámetro UsedTime son números enteros del 1 al 9.
ClientToken	String	Sí	ETnLKlblzczshOTUbOCzSBZH8****	El token de cliente que se utiliza para garantizar la idempotencia de la solicitud. Puede usar el cliente para generar el valor. Asegúrese de que el token sea único entre las distintas solicitudes. El token solo puede contener caracteres ASCII y tener una longitud máxima de 64 caracteres.
AutoRenew	String	No	false	Especifica si se habilita la función de renovación automática. Valores válidos: true: habilita la función de renovación automática. false: deshabilita la función de renovación automática. Nota Si no especifica este parámetro, se utiliza el valor predeterminado false.
ImageCategory	String	No	AliLinux	La imagen que desea utilizar para crear el host. Valores válidos: WindowsWithMssqlEntAlwaysonLicense: SQL Server Cluster Edition WindowsWithMssqlStdLicense: SQL Server Standard Edition WindowsWithMssqlEntLicense: SQL Server Enterprise Edition WindowsWithMssqlWebLicense: SQL Server Web Edition AliLinux: otras imágenes Nota Cuando crea un host de SQL Server, debe especificar una imagen de la edición que corresponda a la edición del host.
OsPassword	String	No	Test123456	La contraseña para iniciar sesión en el host. Solo puede crear una contraseña si el host pertenece a un clúster privado. La contraseña debe cumplir los siguientes requisitos: La contraseña debe tener una longitud de 8 a 30 caracteres. La contraseña debe contener como mínimo tres de los siguientes tipos de caracteres: letras mayúsculas, letras minúsculas, dígitos y caracteres especiales. Se admiten los siguientes caracteres especiales: `( ) \ ~ ! @ # $ % ^ & * - _ + = \| { } [ ] : ; ' < > , . ? /`
HostStorageType	String	No	cloud_essd0	El tipo de disco que desea utilizar para el host. Este parámetro solo aplica a hosts Tair. Solo se admiten los siguientes dos tipos de disco: cloud_essd: Enhanced SSD (ESSD) con nivel de rendimiento (PL) 1 cloud_essd0: ESSD con PL 0
HostStorage	String	No	512	La capacidad del disco del host. Este parámetro solo aplica a hosts Tair. Unidad: GB. Valores válidos: 512 1024 1536 2048 2560 3072 3584 4096

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
OrderId	Long	102565235	El ID del pedido.
RequestId	String	C860658E-68A6-46C1-AF6E-3AE7C4D32375	El ID de la solicitud.
DedicateHostList	Array of DedicateHostList		Información sobre el host creado.
DedicateHostList
DedicatedHostId	String	ch-bp108dki3wdl6****	El ID del host creado.

Ejemplos

Solicitudes de ejemplo

http(s)://cddc.aliyuncs.com/?Action=CreateDedicatedHost
&RegionId=cn-hangzhou
&DedicatedHostGroupId=dhg-6w7q18iwt5jo****
&ZoneId=cn-hangzhou-i
&VSwitchId=vsw-bp133c8ifzxd3iv6q****
&HostClass=rds.g6.4xlarge
&PayType=prepaid
&Period=Month
&UsedTime=1
&ClientToken=ETnLKlblzczshOTUbOCzSBZH8****
&AutoRenew=false
&ImageCategory=AliLinux

&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateDedicatedHostResponse>
    <OrderId>102565235</OrderId>
    <RequestId>C860658E-68A6-46C1-AF6E-3AE7C4D32375</RequestId>
    <DedicateHostList>
        <DedicatedHostId> ch-bp108dki3wdl6****</DedicatedHostId>
    </DedicateHostList>
</CreateDedicatedHostResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "OrderId" : 102565235,
  "RequestId" : "C860658E-68A6-46C1-AF6E-3AE7C4D32375",
  "DedicateHostList" : [ {
    "DedicatedHostId" : " ch-bp108dki3wdl6****"
  } ]
}

Códigos de error

HttpCode	Código de error	Mensaje de error	Descripción
400	InvalidParameter	The parameter is invalid.	Se ha devuelto este mensaje de error porque un parámetro tiene un valor no válido.
400	InvalidAccountPassword.Format	The account password format is invalid.	Se ha devuelto este mensaje de error porque la contraseña especificada no es válida.
400	InsufficientResourceCapacity	No host is available for the requested instance.	Se ha devuelto este mensaje de error porque el sistema no pudo crear el host debido a recursos insuficientes en el clúster dedicado.

Para consultar una lista de códigos de error, visite el Centro de errores de API.