CreateElasticityAssurance - Elastic Compute Service - Alibaba Cloud ドキュメントセンター

リージョンに弾力性保証を作成します。この操作を呼び出す際、リクエストに `ZoneId`、`InstanceType`、`Period`、`PeriodUnit`、`AutoRenew` などのパラメーターを指定できます。

操作説明

弾力性保証は、保証されたリソースを柔軟に購入および使用するための新しい方法を提供します。弾力性保証は、従量課金の Elastic Compute Service (ECS) インスタンスのリソースへの確実なアクセスを提供するリソース予約サービスです。詳細については、「弾力性保証の概要」をご参照ください。

弾力性保証を購入した後は、返金をリクエストすることはできません。弾力性保証の課金の詳細については、「リソース保証」をご参照ください。
弾力性保証は、従量課金の ECS インスタンスの作成にのみ使用できます。
弾力性保証は無制限モードのみをサポートします。`AssuranceTimes` は `Unlimited` にのみ設定できます。無制限モードの弾力性保証は、有効期間内に無制限の回数使用できます。無制限モードの弾力性保証は、作成後すぐに有効になります。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

ecs:CreateElasticityAssurance

create

*ElasticityAssurance

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

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
RegionId	string	必須	弾力性保証を作成するリージョンの ID。DescribeRegions 操作を呼び出して、最新のリージョンリストを照会できます。	cn-hangzhou
ResourceGroupId	string	任意	弾力性保証を割り当てるリソースグループの ID。	rg-bp67acfmxazb4p****
Tag	array<object>	任意	弾力性保証に追加するタグ。
	object	任意	弾力性保証に追加するタグ。
Value	string	任意	弾力性保証に追加するタグ N の値。N の有効値：1～20。タグ値は空の文字列にすることができます。タグ値は最大 128 文字で、`acs:` で始めることはできません。タグ値に `http://` または `https://` を含めることはできません。	TestValue
Key	string	任意	弾力性保証に追加するタグ N のキー。N の有効値：1～20。タグキーは空の文字列にすることはできません。タグキーは最大 128 文字で、`http://` または `https://` を含めることはできません。タグキーは `acs:` または `aliyun` で始めることはできません。	TestKey
Period	integer	任意	エラスティック保証の有効期間。期間の単位は `PeriodUnit` の値によって決まります。インスタンスが使用するイメージがホットマイグレーションをサポートしているかどうかを確認するかどうかを指定します。有効な値は次のとおりです。 `PeriodUnit` の値が `Month` の場合、有効な値は 1、2、3、4、5、6、7、8、9 です。 `PeriodUnit` の値が `Year` の場合、有効な値は 1、2、3、4、5 です。 `PeriodUnit` の値が `Day` の場合、有効な値は 1～365 です。デフォルト値：1	1
PeriodUnit	string	任意	弾力性保証の有効期間の単位。有効値： Month Year Day ** 注 `PeriodUnit` を `Day` に設定した場合、時間分割弾力性保証を作成するには `RecurrenceRules` を指定する必要があります。デフォルト値：Year。	Year
ClientToken	string	任意	リクエストのべき等性を保証するために使用するクライアントトークン。クライアントを使用してトークンを生成できますが、異なるリクエスト間でトークンが一意であることを確認する必要があります。`token` には ASCII 文字のみを含めることができ、長さは 64 文字を超えることはできません。詳細については、「べき等性を確保する方法」をご参照ください。	0c593ea1-3bea-11e9-b96b-88e9fe637760
PrivatePoolOptions.Name	string	任意	弾力性保証の名前。名前は 2～128 文字である必要があります。先頭は英字である必要があり、`http://` または `https://` で始めることはできません。英字、数字、コロン (:)、アンダースコア (_)、ハイフン (-) を使用できます。	eapTestName
Description	string	任意	弾力性保証の説明。説明は 2～256 文字である必要があります。`http://` または `https://` で始めることはできません。このパラメーターはデフォルトで空です。	This is description.
PrivatePoolOptions.MatchCriteria	string	任意	弾力性保証を関連付けるプライベートプールのタイプ。有効値： Open：オープンプライベートプール。弾力性保証を使用して ECS インスタンスを作成する場合、弾力性保証に関連付けられているオープンプライベートプールが自動的に照合されます。オープンプライベートプールに利用可能な容量がない場合、パブリックプールのリソースが自動的に使用されて ECS インスタンスが作成されます。 Target：ターゲットプライベートプール。弾力性保証を使用して ECS インスタンスを作成する場合、弾力性保証に関連付けられている指定されたプライベートプールが自動的に照合されます。プライベートプールに利用可能な容量がない場合、ECS インスタンスの作成は失敗します。デフォルト値：Open。	Open
AssuranceTimes	string	任意	弾力性保証を使用できる合計回数。値を `Unlimited` に設定します。これは、弾力性保証が有効期間内に無制限の回数使用できることを指定します。デフォルト値：Unlimited。	Unlimited
InstanceAmount	integer	任意	容量を予約するインスタンスタイプのインスタンスの総数。有効値：1～1000。説明このパラメーターを指定する必要があります。	2
InstanceCpuCoreCount	integer	任意	説明このパラメーターは使用されなくなりました。	null
StartTime	string	任意	弾力性保証が有効になる時刻。デフォルト値は、`CreateElasticityAssurance` 操作が呼び出されて弾力性保証が作成された時刻です。時刻は ISO 8601 標準の `yyyy-MM-ddTHH:mm:ssZ` 形式で指定します。時刻は協定世界時 (UTC) である必要があります。詳細については、「ISO 8601」をご参照ください。	2020-10-30T06:32:00Z
ZoneId	array	必須	弾力性保証を作成するゾーンの ID。弾力性保証を使用して、単一ゾーン内のリソースを予約できます。	cn-hangzhou-h
	string	任意	弾力性保証を作成するゾーンの ID。弾力性保証を使用して、単一ゾーン内のリソースを予約できます。	cn-hangzhou-h
InstanceType	array	必須	インスタンスタイプ。弾力性保証を作成して、単一のインスタンスタイプの容量を予約できます。	ecs.c6.xlarge
	string	任意	インスタンスタイプ。弾力性保証を作成して、単一のインスタンスタイプの容量を予約できます。	ecs.c6.xlarge
RecurrenceRules	array<object>	任意	容量予約が有効になる保証スケジュール。説明時間分割弾力性保証は、特定のリージョンおよび特定のユーザーのみが利用できます。時間分割弾力性保証を使用するには、チケットを送信してください。
	object	任意	容量予約が有効になる保証スケジュール。
StartHour	integer	任意	容量予約の保証期間の開始時刻。正時を指定します。説明 `StartHour` と `EndHour` の両方を指定する必要があります。`EndHour` は `StartHour` より少なくとも 4 時間後でなければなりません。	4
RecurrenceType	string	任意	保証スケジュールのタイプ。有効値： Daily Weekly Monthly 説明 `RecurrenceType` と `RecurrenceValue` の両方を指定する必要があります。	Daily
EndHour	integer	任意	容量予約の保証期間の終了時刻。正時を指定します。	10
RecurrenceValue	string	任意	容量予約が有効になる曜日または月の日、あるいは容量予約が有効になる間隔 (日数)。 `RecurrenceType` を `Daily` に設定した場合、このパラメーターには 1 つの値のみ指定できます。有効値：1～31。この値は、容量予約が数日ごとに有効になることを指定します。 `RecurrenceType` を `Weekly` に設定した場合、このパラメーターには複数の値を指定できます。値はカンマ (,) で区切ります。有効値：0、1、2、3、4、5、6。それぞれ日曜日、月曜日、火曜日、水曜日、木曜日、金曜日、土曜日を指定します。例：`1,2` は、容量予約が月曜日と火曜日に有効になることを指定します。 `RecurrenceType` を `Monthly` に設定した場合、このパラメーターには `A-B` 形式で 2 つの値を指定できます。A と B の有効値：1～31。B は A 以上である必要があります。例：`1-5` は、毎月 1 日から 5 日まで実行が繰り返されることを示します。説明 `RecurrenceType` と `RecurrenceValue` の両方を指定する必要があります。	1
AutoRenew	boolean	任意	弾力性保証の自動更新を有効にするかどうかを指定します。有効値： true false デフォルト値：false。	true
AutoRenewPeriod	integer	任意	自動更新期間。単位：月。有効値：1、2、3、6、12、24、36。 `PeriodUnit` が `Month` に設定されている場合のデフォルト値：1。 `PeriodUnit` が `Year` に設定されている場合のデフォルト値：12。説明 `AutoRenew` を `true` に設定した場合、このパラメーターを指定する必要があります。	1

レスポンスフィールド

フィールド	型	説明	例
	object
RequestId	string	リクエスト ID。	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
PrivatePoolOptionsId	string	弾力性保証 ID。	eap-bp67acfmxazb4****
OrderId	string	注文 ID。	1234567890

例

成功レスポンス

JSONJSON

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "PrivatePoolOptionsId": "eap-bp67acfmxazb4****",
  "OrderId": "1234567890"
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ
400	InvalidOperation.PeriodUnitUnsupported	TimeDivisionElasticityAssurance only supports PeriodUnit of Day.
400	InvalidParameter.RegionId	The specified RegionId is invalid.
400	OperationDenied	The specified instanceType or zone is not available or not authorized.
400	MissingParameter.RegionId	The specified RegionId should not be null.
400	InvalidStartTime.NotSupported	The specified StartTime should be within 180 calendar days from the current date, and you must specify a precision to hour.
400	InvalidStartTime.MalFormed	The specified StartTime is out of the permitted range.
400	Invalid.PrivatePoolOptionsName.MalFormed	The specified PrivatePoolOptions.Name is not valid.
400	Invalid.ZoneId	The specified ZoneId is not valid.
400	Invalid.InstanceType	The specified InstanceType is not valid.
400	DedicatedHostNotSupported	DedicatedHost is not supported for PrivatePool.
400	SpotNotSupported	Spot is not supported for PrivatePool.
400	ClassicNetworkNotSupported	Classic network is not supported for PrivatePool.
400	Invalid.InstanceId	Instance does not exist.
400	Invalid.PrivatePoolOptions.MatchCriteria	Target mode does not support this operation.
400	MissingParameter.PrivatePoolOptions.Id	The specified PrivatePoolOptions.Id should not be null.
400	Invalid.PrivatePoolOptions.Id	The PrivatePool does not exist.
400	Invalid.InstanceChargeType	The InstanceChargeType does not match the PrivatePool.
400	Invalid.PrivatePoolOptions.status	The PrivatePool status is not valid.
400	InvalidPlatform.ValueNotSupported	The Platform does not match the PrivatePool.
400	InvalidAliUid	The PrivatePool does not belong to the user of the Instance.
400	MissingParameter.PackageType	The specified parameter "PackageType" can not be empty.
400	MissingParameter.PrivatePoolOptions.Ids	The specified parameter "PrivatePoolOptions.Ids" can not be empty.
400	MissingParameter.InstanceCpuCoreCount	The specified parameter "InstanceCpuCoreCount" can not be empty.
400	MissingParameter.InstanceAmount	The specified parameter "InstanceAmount" can not be empty.
400	MissingParameter.InstanceCpuCoreCountOrInstanceAmount	The specified parameter "InstanceCpuCoreCount" and "InstanceAmount" must not be empty at the same time.
400	Invalid.TooManyPrivatePoolOptions.Ids	Too many PrivatePoolOptions.Ids in this request.
400	Invalid.TooManyZoneIds	Too many ZoneIds in the request.
400	Invalid.TooManyInstanceTypes	Too many InstanceTypes in the request.
400	Invalid.TooManyUnpaidPrivatePool	Too many PrivatePools create but still unpaid.
400	Invalid.InstanceCpuCoreCountOrInstanceAmount	Both InstanceCpuCoreCount and InstanceAmount are provided.
400	Invalid.PrivatePoolOptions.Ids	The specified parameter "PrivatePoolOptions.Ids" exist invalid element Id.
400	Invalid.PackageType	The specified parameter "PackageType" is invalid.
400	Invalid.PrivatePool.Purchase	The PrivatePool has already paid.
400	Invalid.AssuranceTimes.NotSupported	The value of AssuranceTimes is not supported.
400	RepeatStartPrivatePool	PrivatePool has already been started.
400	Invalid.PeriodUnit	Only Month or Year is supported for PeriodUnit.
400	AccountForbidden.ProductCreationLimited	The commodity must be officially operated by Aliyun and in pay-as-you-go billing method.
400	RegionUnauthorized	There is no authority to create private pool in the specified region.
400	PriceNotFound	The price of your queried resource is not available now, please try other resources.
400	InvalidRecurrenceRules.CountLimitExceeded	The count of RecurrenceRules exceeds the limit.
400	InvalidRecurrenceRulesStartHourEndHour.TooShort	The recurrence hour between RecurrenceRules.StartHour and RecurrenceRules.EndHour is too short.
400	InvalidParameter.RecurrenceRulesStartHourEndHour	The specified parameter RecurrenceRules.StartHour or RecurrenceRules.EndHour is invalid.
400	InvalidParameter.RecurrenceRulesRecurrenceValueMonthly	The specified parameter RecurrenceRules.RecurrenceValue for Monthly is invalid.
400	InvalidParameter.RecurrenceRulesRecurrenceValueWeekly	The specified parameter RecurrenceRules.RecurrenceValue for Weekly is invalid.
400	InvalidParameter.RecurrenceRulesRecurrenceValueDaily	The specified parameter RecurrenceRules.RecurrenceValue for Daily is invalid.
400	InvalidParameter.RecurrenceRulesRecurrenceType	The specified parameter RecurrenceRules.RecurrenceType is invalid.
400	InvalidAutoRenewPeriod.ValueNotSupported	The specified autoRenewPeriod is invalid.
400	InvalidOperation.ElasticityAssuranceActiveTimeTooShort	The total active time of the ElasticityAssurance is too short.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.
403	Zone.NotOpen	The specified zone is not granted to you to buy resources yet.
403	InvalidResourceType.NotSupported	%s
403	OperationDenied.NoStock	The resource is out of stock in the specified zone. Please try other types, or choose other regions and zones.
403	InvalidInstanceType.NotSupported	The specified InstanceType is invalid.
403	Invalid.ZoneIds	At least one of the specified ZoneIds are invalid.
403	Zone.NotOnSale	The specified zone is not available for purchase.
403	QuotaExceed.ElasticityAssuranceCapacity	ElasticityAssurance Capacity quota exceeded.
403	InvalidAccount.NotSupportEA	According to business rules, this account cannot purchase ECS ElasticityAssurance.
404	InvalidZoneId.NotFound	The specified zoneId does not exist.
404	InvalidResourceGroup.NotFound	The ResourceGroup provided does not exist in our records.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。