1つ以上の従量課金またはサブスクリプション専用ホストを作成します。 専用ホストは、単一のテナントに専用の物理サーバーです。 専用ホスト上にElastic Compute Service (ECS) インスタンスを作成し、専用ホストのプロパティを表示できます。
説明
専用ホストを作成する前に、DescribeAvailableResource操作を呼び出して、特定のリージョンまたはゾーンで使用可能なリソースを照会できます。
専用ホストを作成する前に、リソースの課金方法を理解することをお勧めします。 作成された専用ホストによって使用されたリソースに対して課金されます。 詳細については、「課金概要」をご参照ください。
- 一度に最大100の従量課金またはサブスクリプション専用ホストを作成できます。
- 専用ホストの作成後、システムから返されるIDをリクエストパラメーターの値として使用して、DescribeDedicatedHosts操作を呼び出し、専用ホストのステータスを照会できます。
- 専用ホストを作成する要求を送信した後、特定のパラメーターが無効であるか、要求されたリソースが不十分である場合、エラーが返されます。 エラーの理由の詳細については、このトピックの「エラーコード」セクションを参照してください。
- 専用ホストの作成後、ModifyInstanceDeploymentを呼び出して、共有ホストから専用ホストにECSインスタンスを移行できます。 別の専用ホストから作成した専用ホストにECSインスタンスを移行することもできます。
デバッグ
リクエストパラメーター
パラメーター | データ型 | 必須/任意 | 例 | 説明 |
---|---|---|---|---|
操作 | String | 必須 | AllocateDedicatedHosts |
実行する操作です。 値をAllocateDedicatedHostsに設定します。 |
DedicatedHostType | String | 必須 | ddh.c5 |
専用ホストのタイプ。 DescribeDedicatedHostTypesを呼び出して、専用ホストタイプの最新リストを照会できます。 |
RegionId | String | 必須 | cn-hangzhou |
専用ホストのリージョンID。 DescribeRegions を呼び出して、最新のリージョンリストをクエリできます。 |
Tag.N.Key | String | 任意 | 環境 |
専用ホストに追加するタグNのキー。 N の有効値:1 ~ 20。 タグキーを空の文字列にすることはできません。 長さは 128 文字以内である必要があります。先頭文字列は aliyun または acs: にすることはできません。
|
Tag.N.Value | String | 任意 | 実働環境 |
専用ホストに追加するタグNの値。 N の有効値:1 ~ 20。 タグ値は、空の文字列が使用可能です。 長さは最大128文字で、acs: で始めることも、 |
ResourceGroupId | String | 任意 | rg-bp67acfmxazb4ph*** |
専用ホストを割り当てるリソースグループのID。 |
ZoneId | String | 任意 | cn-hangzhou-f |
専用ホストのゾーンID。 このパラメーターはデフォルトで空となります。 ゾーンを指定しない場合、システムはゾーンを選択します。 |
DedicatedHostName | String | 任意 | myDDH |
専用ホストの名前。 名前の長さは 2 から 128 文字です。 文字で始める必要があり、 |
DedicatedHostClusterId | String | 任意 | dc-bp12wlf6am0vz9v2 **** |
専用ホストを割り当てる専用ホストクラスターのID。 |
ActionOnMaintenance | String | 任意 | 移行 |
専用ホストにデプロイされたインスタンスを移行するために使用されるポリシー。 設定可能な値は以下のとおりです。
|
NetworkAttributes.SlbUdpTimeout | Integer | 任意 | 60 |
Server Load Balancer (SLB) インスタンスと専用ホスト間のUDPセッションのタイムアウト期間。 (単位:秒) 有効な値: 15 ~ 310 |
NetworkAttributes.UdpTimeout | Integer | 任意 | 60 |
ユーザーと専用ホスト上のAlibaba Cloudサービス間のUDPセッションのタイムアウト期間。 (単位:秒) 有効な値: 15 ~ 310 |
説明 | String | 任意 | This-is-my-DDH |
専用ホストの説明。 説明の長さは 2 ~ 256 文字である必要があります。文頭に |
自動配置 | String | 任意 | off |
自動デプロイ用のリソースプールに専用ホストを追加するかどうかを指定します。 DedicatedHostIdパラメーターを指定せずに専用ホストにECSインスタンスを作成した場合、Alibaba Cloudはリソースプールから専用ホストを選択してインスタンスをホストします。 詳細については、「自動デプロイ」をご参照ください。 設定可能な値は以下のとおりです。
デフォルト値 : on。 注 自動デプロイのために専用ホストをリソースプールに追加しない場合は、値をoffに設定します。
|
CpuOverCommitRatio | Float | 任意 | 1 |
CPUオーバーコミット率。 CPU オーバーコミット率は、g6s、c6s、r6s の専用ホストタイプに対してのみ設定できます。 有効な値: 1 ~ 5。 CPU オーバーコミット率は、専用ホストで使用可能な vCPU の数に影響します。 専用ホストで使用可能な vCPU の数は、使用可能な vCPU の数 = 物理 CPU コアの数 × 2 × CPU オーバーコミット率で計算できます。 たとえば、g6s 専用ホストの物理 CPU コア数は 52 です。 g6s 専用ホストの CPU オーバーコミット率を 4 に設定すると、専用ホストで使用可能な vCPU の数は 416 となります。 開発環境やテスト環境など、CPUの安定性に対する要件が最小限であるシナリオや、CPU負荷が重くないシナリオでは、CPUオーバーコミット率を上げることで、専用ホストで使用可能なvCPUの数を増やすことができます。 これにより、同じ仕様のより多くのECSインスタンスを専用ホストにデプロイし、ユニットデプロイコストを削減できます。 |
最小数量 | Integer | 任意 | 2 |
作成する専用ホストの最小数。 Valid values: 1 to 100. 注 使用可能な専用ホストの数が作成する最小専用ホスト数より少ない場合、専用ホストの作成に失敗します。
|
ChargeType | String | 任意 | PrePaid |
専用ホストの課金方法。 デフォルト値:PostPaid。 設定可能な値は以下のとおりです。
|
数量 | Integer | 任意 | 2 |
作成する専用ホストの数。 Valid values: 1 to 100. デフォルト値:1。 |
期間 | Integer | 任意 | 6 |
専用ホストのサブスクリプション期間。
|
PeriodUnit | String | 任意 | 月 |
専用ホストのサブスクリプション期間の単位。 設定可能な値は以下のとおりです。
デフォルト値:Month 。 |
AutoRenew | Boolean | 任意 | false |
サブスクリプション専用ホストを自動的に更新するかどうかを指定します。 注 AutoRenewパラメーターは、ChargeTypeパラメーターがPrePaidに設定されている場合にのみ有効になります。
規定値: false |
AutoRenewPeriod | Integer | 任意 | 1 |
専用ホストの自動更新期間。 月単位で設定します。 有効な値: 1、2、3、6、および12。 注 AutoRenewPeriodパラメーターは、AutoRenewパラメーターがtrueに設定されている場合にのみ有効になります。
|
AutoReleaseTime | String | 任意 | 2019-08-21T12:30:24Z |
専用ホストの自動リリース時間。 時刻を ISO 8601 規格 (yyyy-MM-ddTHH:mm:ssZ) の形式で指定します。 時間は UTC にする必要があります。 注
|
ClientTokend | String | 任意 | 123e4567-e89b-12d3-a456-426655440000 |
リクエストのべき等性を保証するために使用されるクライアントトークンです。 クライアントを使用して値を生成できますが、異なるリクエスト間で一意であることを確認する必要があります。 ClientToken値にはASCII文字のみを含める必要があり、長さは64文字を超えることはできません。 詳細については、「べき等性を確保する方法」をご参照ください。 |
レスポンスパラメーター
パラメーター | データ型 | 例 | 説明 |
---|---|---|---|
DedicatedHostIdSets | List | "DedicatedHostIdSets":{"DedicatedHostId":["dh-bp67acfmxazb4p ****", "dh-bp67acfmxazb4d ****"]} |
専用ホストのID。 |
RequestId | String | E2A664A6-2933-4C64-88AE-5033D003EADF |
リクエストの ID です。 |
例
リクエストの例
https://ecs.aliyuncs.com/?Action=AllocateDedicatedHosts
&RegionId=cn-hangzhou
&DedicatedHostType=ddh.sn1ne
&数量=2
&ChargeType=PostPaid
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&<共通リクエストパラメーター>
正常に処理された場合のレスポンス例
XML
形式
<AllocateDedicatedHostsResponse>
<RequestId>E2A664A6-2933-4C64-88AE-5033D003EADF</RequestId>
<DedicatedHostIdSets>
<DedicatedHostId>dh-bp67acfmxazb4p ****</DedicatedHostId>
<DedicatedHostId>dh-bp67acfmxazb4d ****</DedicatedHostId>
</DedicatedHostIdSets>
</AllocateDedicatedHostsResponse>
JSON
形式
{
"RequestId":"E2A664A6-2933-4C64-88AE-5033D003EADF" 、
"DedicatedHostIdSets":{
"DedicatedHostId":[
"dh-bp67acfmxazb4p ****" 、
"dh-bp67acfmxazb4d ****"
]
}
}
エラーコード
HTTP ステータスコード | エラーコード | エラーメッセージ | 説明 |
---|---|---|---|
400 | InvalidInstanceType.ValueUnauthorized | 指定された InstanceType は許可されていません。 | 該当のインスタンスタイプを使用する権限が付与されていない場合に返されるエラーメッセージ。 |
400 | InvalidDescription.Malformed | The specified parameter "Description" is not valid. | 指定された Description パラメーターが無効な場合に返されるエラーメッセージ。 説明は、長さが 2 文字から 256 文字とする必要があります。文頭に http:// または https:// を含めることはできません。 |
400 | InvalidParameter.Conflict | The specified region and cluster do not match. | 指定されたリージョンとクラスターとが対応付けられていない場合に返されるエラーメッセージ。 |
400 | InvalidAutoRenewPeriod.ValueNotSupported | The specified autoRenewPeriod is not valid. | 指定された AutoRenewPeriod パラメーターが無効な場合に返されるエラーメッセージ。 |
400 | InvalidTagKey.Malformed | The specified Tag.n.Key is not valid. | 指定された Tag.N.Key パラメーターが無効な場合に返されるエラーメッセージ。 |
400 | InvalidDedicatedHostType.ValueNotSupported | %s | 指定されたDedicatedHostTypeパラメーターが無効な場合に返されるエラーメッセージ。 |
400 | RegionUnautifiedized | %s | 指定されたリージョンで操作を実行する権限がない場合に返されるエラーメッセージ。 |
400 | Zone.NotOnSale | %s | 指定されたゾーンで要求されたリソースが使用できない場合に返されるエラーメッセージ。 |
400 | OperationDenied | 指定されたDedicatedHostTypeまたはZoneは使用できないか、権限がありません。 | 指定された専用ホストの種類またはゾーンが使用できない場合、またはリソースを管理する権限がない場合に返されるエラーメッセージ。 |
400 | InvalidPeriodUnit.ValueNotSupported | The specified parameter PeriodUnit is not valid. | 指定された PeriodUnit パラメーターが無効な場合に返されるエラーメッセージ。 |
400 | InvalidTagValue.Malformed | The specified Tag.n.Value is not valid. | 指定された Tag.N.Value パラメーターが無効な場合に返されるエラーメッセージ。 |
400 | QuotaExceed.AfterpayDedicatedHost | 従量課金DedicatedHostsの最大数を超えています: % s | 指定された専用ホストタイプの従量課金リソースが不足している場合に返されるエラーメッセージ。 作成する専用ホストの数を減らします。 |
400 | InvalidChargeType.ValueNotSupported | ChargeTypeが無効です | 指定されたChargeTypeパラメーターが無効な場合に返されるエラーメッセージ。 |
400 | InvalidParameter.SlbUdpTimeout | 指定された値は無効です。 | 指定されたNetworkAttributes.SlbUdpTimeoutパラメーターが無効な場合に返されるエラーメッセージ。 |
400 | InvalidParameter.UdpTimeout | 指定された値は無効です。 | 指定されたNetworkAttributes.UdpTimeoutパラメーターが無効な場合に返されるエラーメッセージ。 |
400 | Duplicate.TagKey | The Tag.N.Key contain duplicate key. | 指定されたタグキーが既に存在している場合に返されるエラーメッセージ。 タグキーは一意である必要があります。 |
403 | OperationDenied | 指定されたゾーンへのホストの作成は許可されていません。 | 指定されたゾーンに専用ホストを作成する権限がない場合に返されるエラーメッセージ。 |
403 | OperationDenied.NoStock | The requested resource is sold out in the specified zone; try other types of resources or other regions and zones. | 指定されたゾーンでリソースが不十分な場合に返されるエラーメッセージ。 他のタイプのリソースを試すか、他のリージョンとゾーンを選択します。 |
403 | OperationDenied | Sales of this resource are temporarily suspended in the specified region; please try again later. | 指定されたリージョンで要求されたリソースが使用できない場合に返されるエラーメッセージ。 しばらくしてから再試行します。 |
403 | NodeControllerUnavailable | The Node Controller is temporarily unavailable. | ノードコントローラーが使用できない場合に返されるエラーメッセージ。 |
403 | OperationDenied | The resource is out of usage. | インスタンスが実行中のステータスではない場合に返されるエラーメッセージ。 インスタンスを開始するか、指定された操作が有効かどうかを確認してください。 |
403 | InvalidParameter.ResourceOwnerAccount | ResourceOwnerAccount is Invalid. | 指定された ResourceOwnerAccount パラメーターが無効な場合に返されるエラーメッセージ。 |
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. | 指定されたゾーンで要求されたリソースが使用できない場合に返されるエラーメッセージ。 他のインスタンスタイプを試すか、他のリージョンまたはゾーンを選択します。 |
403 | InvalidDedicatedHostType.ValueNotSupported | 指定されたDedicatedHostTypeは存在しないか、許可された範囲を超えています。 | 指定されたDedicatedHostTypeパラメーターが存在しない場合に返されるエラーメッセージ。 |
403 | InvalidDedicatedHostType.ZoneNotSupported | 指定されたゾーンは、この専用HostTypeをサポートしていません。 | 指定された専用ホストタイプが指定されたゾーンでサポートされていない場合に返されるエラーメッセージ。 |
403 | InvalidParameter.NotMatch | %s | 指定されたパラメーターが無効な場合に返されるエラーメッセージ。 パラメーターが競合するかどうかを確認します。 |
403 | Account.Arrearage | アカウントに料金の滞納が発生しています。 | アカウントの残高が不十分な場合に返されるエラーメッセージ。 アカウントに資金を追加して、もう一度お試しください。 |
404 | OperationDenied | 別のホストを作成しています | 別のホストが作成中の場合に返されるエラーメッセージ。 |
404 | PaymentMethodNotFound | No payment method has been registered on the account. | アカウントの支払い方法を設定していない場合に返されるエラーメッセージ。 |
404 | InvalidDedicatedHostName.Malformed | 指定されたパラメーターDedicatedHostNameは無効です。 | 指定されたDedicatedHostNameパラメーターが無効な場合に返されるエラーメッセージ。 |
500 | InternalError | 不明なエラーにより、リクエスト処理が失敗しました。 | 内部エラーが発生した場合に返されるエラーメッセージです。 しばらくしてから再試行します。 エラーが解決しない場合は、チケットを起票してください。 |
500 | InternalError | %s | 内部エラーが発生した場合に返されるエラーメッセージです。 しばらくしてから再試行します。 |
エラーコードリストについては、「API エラーセンター」をご参照ください。