API によるクロスゾーン移行ジョブの実行 - Server Migration Center (SMC)

サーバ移行センタ (SMC) を使用すると、Alibaba Cloud Elastic Compute Service (ECS) インスタンスを同じリージョン内の別のゾーンに移行し、同じインスタンスファミリー内で vCPU やメモリなどのインスタンスタイプを変更できます。この機能は、インスタンスの移行と仕様変更に関するビジネス要件を満たすのに役立ちます。この操作を呼び出して、ゾーン間移行ジョブを作成します。

操作説明

ゾーン間移行の制限と影響の詳細については、「ゾーン間移行」をご参照ください。

今すぐお試しください

この 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 ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

smc:CreateCrossZoneMigrationJob

create

*All Resource

*

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
RegionId	string	必須	宛先の Alibaba Cloud リージョンの ID。たとえば、ソースサーバーを中国 (杭州) リージョンに移行する場合、リージョン ID は `cn-hangzhou` です。DescribeRegions を呼び出して、Alibaba Cloud リージョンの最新リストを表示できます。	cn-hangzhou
ClientToken	string	任意	リクエストのべき等性を保証するためのクライアントトークン。クライアントからこのパラメーターに一意の値を生成します。`ClientToken` には ASCII 文字のみを含めることができ、長さは 64 文字を超えることはできません。詳細については、「べき等性を確保する方法」をご参照ください。	123e4567-e89b-12d3-a456-426655440000
InstanceId	string	任意	ECS インスタンスの ID。	i-bp1ff25rzvnul6kr****
TargetVSwitchId	string	任意	宛先 vSwitch の ID。	vsw-bp1mxqnssl8nafltc****
TargetZoneId	string	任意	宛先ゾーンの ID。	cn-hangzhou-i
TargetInstanceType	string	任意	宛先インスタンスタイプ。	ecs.g7.large
AutoPay	boolean	任意	自動支払いを有効にするかどうかを指定します。有効な値: true: (デフォルト) 自動支払いを有効にします。アカウントに十分な残高があることを確認してください。 false: 自動支払いを無効にします。この場合、手動で支払いを完了する必要があります。詳細については、「サブスクリプションインスタンスを手動で更新する」をご参照ください。	false
Disk	array<object>	任意	ディスク情報。
	object	任意	ディスクオブジェクト。
DiskId	string	任意	ディスク ID。	d-bp1eeplkn4j29wf7****
Category	string	任意	ディスクカテゴリ。`cloud_essd` は拡張 SSD (ESSD) を示します。	cloud_essd
PerformanceLevel	string	任意	ESSD のパフォーマンスレベル。有効な値: PL0: 1 つのディスクで最大 10,000 のランダム読み取り/書き込み IOPS を実現できます。 PL1: 1 つのディスクで最大 50,000 のランダム読み取り/書き込み IOPS を実現できます。 PL2: 1 つのディスクで最大 100,000 のランダム読み取り/書き込み IOPS を実現できます。 PL3: 1 つのディスクで最大 1,000,000 のランダム読み取り/書き込み IOPS を実現できます。	PL0
ResourceGroupId	string	任意	リソースグループの ID。	rg-acfmw3ty5y7****

レスポンスフィールド

フィールド	型	説明	例
	object	レスポンスパラメーター。
RequestId	string	リクエスト ID。	A9DBD2F8-DE5A-5844-BA6F-957A996CBD78
JobId	string	移行ジョブ ID。	j-bp17bclvg344jlyt****

例

成功レスポンス

JSONJSON

{
  "RequestId": "A9DBD2F8-DE5A-5844-BA6F-957A996CBD78",
  "JobId": "j-bp17bclvg344jlyt****"
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ	説明
400	ReplicationJobDataDiskIndex.Invalid	The specified replication job contains data disk index not found in source server.	指定されたレプリケーションジョブには、ソースサーバーに存在しないデータディスクインデックスがあります。
400	VSwitchIdVpcId.Mismatch	The specified VSwitchId and VpcId does not match.	指定された VSwitchId と VpcId が一致しません。
400	InvalidSecurityGroupId.IncorrectNetworkType	The network type of the specified security group does not support this action.	指定されたセキュリティグループのネットワークタイプはこの操作をサポートしていません。
400	InvalidSecurityGroupId.VPCMismatch	The specified security group and the specified virtual switch are not in the same VPC.	指定されたセキュリティグループと VSwitch は同じ VPC にありません。
400	QuotaExceeded.ReplicationJob	The maximum number of replication jobs is exceeded. Please submit a ticket to raise the quota.	レプリケーションジョブの数が上限を超えています。クォータを引き上げるには、チケットを起票してください。
400	ReplicationJobName.Duplicate	The specified replication job name already exists.	指定されたレプリケーションジョブ名が既に存在しています。
400	SourceServerState.Invalid	The specified source server status: %s is invalid. This operation can only be performed in the following status: %s.
500	InternalError	An error occurred while processing your request. Please try again. If the problem still exists, please submit a ticket.	リクエストの処理中にエラーが発生しました。もう一度お試しください。それでも問題が解決しない場合、チケットを起票してください。
403	EntityNotExist.Role	The account is unauthorized. Please assign the role AliyunServiceRoleForSMC to your account.

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

変更履歴

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