Modifies the configurations of an ApsaraDB MyBase dedicated cluster.

For more information, see Manage dedicated clusters.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes ModifyDedicatedHostGroupAttribute

The operation that you want to perform. Set the value to ModifyDedicatedHostGroupAttribute.

DedicatedHostGroupId String Yes dhg-h5i4p331f509****

The ID of the dedicated cluster.

Note You can view the ID of the dedicated cluster on the Dedicated Clusters page in the ApsaraDB MyBase console.
RegionId String Yes cn-hangzhou

The region ID of the dedicated cluster. For more information about region IDs, see Region IDs.

DedicatedHostGroupDesc String No mysql-cluster

The name of the dedicated cluster.

CpuAllocationRatio Integer No 300

The numeric value of the CPU overcommit ratio of the dedicated cluster. Valid values: 100 to 300.

Note The value 300 specifies that the system can allocate three times the number of the provided CPU resources. This maximizes CPU utilization.
MemAllocationRatio Integer No 100

The numeric value of the maximum memory usage of each host in the dedicated cluster. Valid values: 0 to 100.

DiskAllocationRatio Integer No 200

The numeric value of the storage overcommit ratio of the dedicated cluster. Valid values: 100 to 200.

AllocationPolicy String No Intensively

The policy that is used to allocate resources in the dedicated cluster. Valid values:

  • Evenly: The system preferentially creates database instances on the hosts that have the smallest loads. This way, the loads on the hosts in the dedicated cluster can be balanced. This maximizes system stability. This value is the default value.
  • Intensively: The system preferentially creates database instances on the hosts that are created earlier than the other hosts and have fewer available resources than the other hosts in the dedicated cluster. This maximizes resource utilization.
HostReplacePolicy String No Auto

The policy based on which the system handles host failures. Valid values:

  • Auto: The system automatically replaces faulty hosts. This value is the default value.
  • Manual: You must manually replace faulty hosts.
Note You can select a policy based on your business requirements only if the dedicated cluster runs the MySQL database engine. For a dedicated cluster that runs another database engine, the default value Auto is used for this parameter.
OpenPermission String No 0

Specifies whether to enable the feature that allows you to have the OS permissions on the hosts in the dedicated cluster. Valid values:

  • 0: disables this feature. This value is the default value.
  • 1: enables this feature.
Note You can enable this feature based on your business requirements only if the dedicated cluster runs the MySQL, SQL Server, or PostgreSQL database engine. This feature is unavailable for dedicated clusters that run other database engines. For these dedicated clusters, the default value 0 is used for this parameter.

Response parameters

Parameter Type Example Description
RequestId String D6E068C3-25BC-455A-85FE-45F0B22EEDAS

The ID of the request.

Examples

Sample requests

http(s)://cddc.aliyuncs.com/?Action=ModifyDedicatedHostGroupAttribute
&DedicatedHostGroupId=dhg-h5i4p331f509****
&RegionId=cn-hangzhou
&DedicatedHostGroupDesc=mysql-cluster
&CpuAllocationRatio=300
&MemAllocationRatio=100
&DiskAllocationRatio=200
&AllocationPolicy=Intensively
&HostReplacePolicy=Auto
&OpenPermission=0
&<Common request parameters>

Sample success responses

XML format

<ModifyDedicatedHostGroupAttributeResponse>
  <RequestId>D6E068C3-25BC-455A-85FE-45F0B22EEDAS</RequestId>
</ModifyDedicatedHostGroupAttributeResponse>

JSON format

null

Error codes

HttpCode Error code Error message Description
403 Forbidden.RAM User not authorized to operate on the specified resource, or this API does not support RAM. The error message returned because the specified operation is forbidden.

For a list of error codes, visit the API Error Center.