1つ以上の従量課金またはサブスクリプション専用ホストを作成します。 専用ホストは、単一のテナントに専用の物理サーバーです。 専用ホスト上にElastic Compute Service (ECS) インスタンスを作成し、専用ホストのプロパティを表示できます。

説明

専用ホストを作成する前に、DescribeAvailableResource操作を呼び出して、特定のリージョンまたはゾーンで使用可能なリソースを照会できます。

専用ホストを作成する前に、リソースの課金方法を理解することをお勧めします。 作成された専用ホストによって使用されたリソースに対して課金されます。 詳細については、「課金概要」をご参照ください。

  • 一度に最大100の従量課金またはサブスクリプション専用ホストを作成できます。
  • 専用ホストの作成後、システムから返されるIDをリクエストパラメーターの値として使用して、DescribeDedicatedHosts操作を呼び出し、専用ホストのステータスを照会できます。
  • 専用ホストを作成する要求を送信した後、特定のパラメーターが無効であるか、要求されたリソースが不十分である場合、エラーが返されます。 エラーの理由の詳細については、このトピックの「エラーコード」セクションを参照してください。
  • 専用ホストの作成後、ModifyInstanceDeploymentを呼び出して、共有ホストから専用ホストにECSインスタンスを移行できます。 別の専用ホストから作成した専用ホストにECSインスタンスを移行することもできます。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、各種 SDK に用意されている API のサンプルコードを動的に生成します。

リクエストパラメーター

パラメーター データ型 必須/任意 説明
操作 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: にすることはできません。 http:// またはhttps:// は使用できません。

Tag.N.Value String 任意 実働環境

専用ホストに追加するタグNの値。 N の有効値:1 ~ 20。

タグ値は、空の文字列が使用可能です。 長さは最大128文字で、acs: で始めることも、http:// またはhttps:// を含めることもできません。

ResourceGroupId String 任意 rg-bp67acfmxazb4ph***

専用ホストを割り当てるリソースグループのID。

ZoneId String 任意 cn-hangzhou-f

専用ホストのゾーンID。

このパラメーターはデフォルトで空となります。 ゾーンを指定しない場合、システムはゾーンを選択します。

DedicatedHostName String 任意 myDDH

専用ホストの名前。 名前の長さは 2 から 128 文字です。 文字で始める必要があり、http:// またはhttps:// で始めることはできません。 英数字、コロン (:)、アンダースコア (_)、ハイフン (-) を含めることができます。

DedicatedHostClusterId String 任意 dc-bp12wlf6am0vz9v2 ****

専用ホストを割り当てる専用ホストクラスターのID。

ActionOnMaintenance String 任意 移行

専用ホストにデプロイされたインスタンスを移行するために使用されるポリシー。 設定可能な値は以下のとおりです。

  • Migrate: インスタンスは別の物理サーバーに移行され、再起動されます。

    専用ホストにクラウドディスクがアタッチされている場合、デフォルト値はMigrateです。

  • Stop: インスタンスは停止しています。 専用ホストを修復できない場合、インスタンスは別の物理サーバーに移行され、再起動されます。

    専用ホストにローカルディスクが接続されている場合、デフォルト値は [停止] です。

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 文字である必要があります。文頭に http:// または https:// を使用することはできません。

自動配置 String 任意 off

自動デプロイ用のリソースプールに専用ホストを追加するかどうかを指定します。 DedicatedHostIdパラメーターを指定せずに専用ホストにECSインスタンスを作成した場合、Alibaba Cloudはリソースプールから専用ホストを選択してインスタンスをホストします。 詳細については、「自動デプロイ」をご参照ください。 設定可能な値は以下のとおりです。

  • on: 自動デプロイのために専用ホストがリソースプールに追加されます。
  • off: 専用ホストは自動デプロイのためにリソースプールに追加されません。

デフォルト値 : 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。 設定可能な値は以下のとおりです。

  • PrePaid:サブスクリプション If you set this parameter to PrePaid, make sure that you have sufficient account balance or credit. それ以外の場合、InvalidPayMethodが返されます。
  • PostPaid: 従量課金
数量 Integer 任意 2

作成する専用ホストの数。 Valid values: 1 to 100.

デフォルト値:1。

期間 Integer 任意 6

専用ホストのサブスクリプション期間。 Periodパラメーターは、ChargeTypeパラメーターがPrePaidに設定されている場合にのみ有効になります。 設定可能な値は以下のとおりです。

  • PeriodUnitパラメーターがMonthに設定されている場合、Periodの有効な値は1、2、3、4、5、6、7、8、9です。
  • PeriodUnitパラメーターがYearに設定されている場合、Periodの有効な値は1、2、3、4、5です。
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 にする必要があります。

  • 現在の時間より少なくとも30分遅れている必要があります。
  • それは現在の時間よりせいぜい3年遅れているに違いありません。
  • 秒 (ss) の値が00でない場合、自動的に00に設定されます。
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 エラーセンター」をご参照ください。