アクティベーションコードを作成します。 このアクティベーションコードは、Alibaba Cloudによって管理対象インスタンスとして提供されていないサーバーを登録するために使用されます。

説明

アクティベーションコードを使用して、Alibaba Cloudによって提供されていないサーバーをAlibaba Cloudマネージドインスタンスとして登録した後、Alibaba Cloudによって提供されるさまざまなオンラインサービス (Cloud Assistant、Operation Orchestration Service (OOS) 、およびマネージドインスタンスのApsara Devopsなど) を使用できます。

サーバーがAlibaba Cloudによって提供されていない場合、サーバーがインターネットにアクセスでき、次のいずれかのバージョンのオペレーティングシステムを実行している場合にのみ、サーバーをAlibaba Cloud管理対象インスタンスとして登録できます。

  • Alibaba Cloud Linux 2およびAlibaba Cloud Linux 3以降
  • CentOS 6, CentOS 7, and CentOS 8 and later
  • Debian 8、Debian 9、およびDebian 10以降
  • Ubuntu 12、Ubuntu 14、Ubuntu 16、およびUbuntu 18以降
  • CoreOS
  • OpenSUSE
  • RedHat 5、RedHat 6、およびRedHat 7以降
  • SUSE Linux Enterprise Server (SLES) 11、SLES 12、およびSLES 15以降
  • Windows Server 2012、Windows Server 2016、およびWindows Server 2019以降

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

パラメーター データ型 必須／任意 例 説明
操作 String 必須 CreateActivation

実行する操作です。 値をCreateActivationに設定します。

RegionId String 必須 cn-hangzhou

アクティベーションコードを作成するリージョンのID。 次のリージョンがサポートされています: 中国 (青島) 、中国 (北京) 、中国 (張家口) 、中国 (フフホト) 、中国 (杭州) 、中国 (上海) 、中国 (深セン) 、中国 (河源) 、中国 (香港) 。

DescribeRegions を呼び出して、最新のリージョンリストをクエリできます。

InstanceName String 任意 test-InstanceName

デフォルトのインスタンス名のプレフィックス。 インスタンス名のプレフィックスは1 ~ 50文字である必要があります。 文字で始める必要があり、http:// またはhttps:// で始めることはできません。 インスタンス名のプレフィックスには、英数字、ピリオド (.) 、アンダースコア (_) 、ハイフン (-) 、およびコロン (:) のみを使用できます。

CreateActivation操作によって作成されたアクティベーションコードを使用してマネージインスタンスを登録する場合、インスタンスには、このパラメーターの値がプレフィックスとなるシーケンシャルネームが割り当てられます。 マネージインスタンスを登録するときに、新しいインスタンス名を指定して、割り当てられたシーケンシャル名を上書きすることもできます。

マネージドインスタンスの登録時にInstanceNameを指定すると、<InstanceName>-<Number> の形式のインスタンス名が生成されます。 <number> 値の桁数は、InstanceCount値の桁数によって決まります。 例: 001。 InstanceNameを指定しない場合、ホスト名 (hostname) がインスタンス名として使用されます。

説明 String 任意 これは説明です。

アクティベーションコードの説明。 説明の長さは1 ~ 100文字で、http:// またはhttps:// で始めることはできません。

InstanceCount Integer 任意 10

マネージインスタンスの登録にアクティベーションコードを使用できる最大回数。 有効な値: 1 ~ 1000

Default value: 10.

TimeToLiveInHours Long 任意 4

The validity period of the activation code. The activation code cannot be used to register new instances after the validity period expires. 単位：時間。 有効な値: 1 ~ 24。

デフォルト値: 4。

IpAddressRange String 任意 0.0.0.0/0

The IP addresses of hosts that are allowed to use the activation code. 値は、IPv4アドレス、IPv6アドレス、またはCIDRブロックです。

レスポンスパラメーター

パラメーター データ型 例 説明
RequestId String 4ECEEE12-56F1-4FBC-9AB1-890F1234 ****

リクエストの ID です。

ActivationCode String a-hz0ch3SwhOlE1234+Xo32lAZC****

アクティベーションコードの値。 この値は、CreateActivation操作が呼び出された後に1回だけ返され、その後はクエリできません。 Make sure that you properly save the return value.

ActivationId String 4ECEEE12-56F1-4FBC-9AB1-890F1234 ****

アクティベーションコードのID。

例

リクエストの例

https://ecs.aliyuncs.com/?Action=CreateActivation
&InstanceName=test-InstanceName
&RegionId=cn-hangzhou
&<共通リクエストパラメーター>

正常に処理された場合のレスポンス例

XML 形式 

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

<CreateActivationResponse>
    <RequestId>4ECEEE12-56F1-4FBC-9AB1-890F1234 ****</RequestId>
    <ActivationId>4ECEEE12-56F1-4FBC-9AB1-890F1234 ****</ActivationId>
    <ActivationCode>a-hz0ch3SwhOlE1234 + Xo32lAZC ****</ActivationCode>
</CreateActivationResponse>

JSON 形式 

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

{
  "RequestId" : "4ECEEE12-56F1-4FBC-9AB1-890F1234 ****" 、
  "ActivationId" : "4ECEEE12-56F1-4FBC-9AB1-890F1234 ****" 、
  "ActivationCode" : "a-hz0ch3SwhOlE1234 Xo32lAZC ****"
}

エラーコード

HTTP ステータスコード エラーコード エラーメッセージ 説明
400 RegionId.ApiNotSupported このリージョンではapiはサポートされていません。 指定されたリージョンでAPI操作を呼び出すことができない場合に返されるエラーメッセージ。 RegionIdパラメーターが有効かどうかを確認します。
400 InstanceName.ExceedLimit デフォルトのインスタンス名プレフィックスの長さがを超えています。 インスタンス名のプレフィックスの長さが50文字を超えている場合に返されるエラーメッセージ。
400 InstanceName.InvalidPattern Default instance name prefix pattern invalid. インスタンス名のプレフィックスが無効な場合に返されるエラーメッセージ。
400 ActivationDesc.ExceedLimit Activation description length exceeds. アクティベーションコードの説明が100文字を超えている場合に返されるエラーメッセージ。
400 ActivationLimitation.Invalid 登録制限はプラスでなければなりません。 マネージインスタンスの登録にアクティベーションコードを使用できる最大回数に達した場合に返されるエラーメッセージ。
400 AddressRange.InvalidPattern アドレス範囲はipv4アドレスまたはcidrです。 アクティベーションコードの使用を許可されているホストのIPアドレスが、IPv4アドレス、IPv6アドレス、またはCIDRブロックである必要がある場合に返されるエラーメッセージ。
400 ActivationCount.ExceedLimit アクティベーションが多すぎます。 作成できるアクティベーションコードの最大数に達した場合に返されるエラーメッセージ。
400 ActivationTTL.ExceedLimit アクティベーションTTLが制限を超えています。 指定されたTimeToLiveInHoursパラメーターが無効な場合に返されるエラーメッセージ。
403 Operation.Forbidden 操作は許可されていません。 操作がサポートされていない場合に返されるエラーメッセージ。
500 InternalError.Dispatch リクエストのディスパッチ時にエラーが発生しました。 The error message returned because an error occurred when the request was being sent. しばらくしてから再試行します。

エラーコードリストについては、「API エラーセンター」をご参照ください。