すべてのプロダクト
Search
ドキュメントセンター

Server Migration Center:ModifyReplicationJobAttribute

最終更新日:Oct 27, 2026

移行タスクの属性を変更します。

操作説明

操作の説明

移行タスクを変更する前に、以下の注意事項をフォローして読み取りください。

  • Name パラメーターと Description パラメーターは、移行タスクのライフサイクル全体を通して変更済みにできます。

  • Frequency パラメーターと MaxNumberOfImageToKeep パラメーターは、移行タスクが実行される前、またはタスクのステータスが Waiting の場合にのみ変更済みにできます。

  • その他のパラメーターは、移行タスクが実行される前にのみ変更済みにできます。

今すぐお試しください

この 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:ModifyReplicationJobAttribute

update

*ReplicationJob。

acs:smc:{#regionId}:{#accountId}:replicationjob/{#JobId}

なし なし

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例

JobId

string

必須

移行タスクの ID。

j-bp19vlwm0tyigbmj****

Name

string

任意

移行タスクの名前。名前は以下の要件をフォローする必要があります。

  • タスク名は一意である必要があります。

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

testMigrationTaskName

Description

string

任意

移行タスクの説明。

説明の長さは 2~128 文字である必要があります。英字または漢字で始める必要があり、http:// または https:// で始めることはできません。数字、半角コロン (:)、アンダースコア (_)、ハイフン (-) を含めることができます。

This_is_my_migration_task

TargetType

string

任意

移行配信のターゲットタイプ。このパラメーターは、移行タスクが開始される前にのみ変更済みにできます。有効な値:

  • Image: 移行が成功すると、SMC はソースサーバー用に Alibaba Cloud イメージを生成します。このイメージを使用して ECS インスタンスを作成し、Alibaba Cloud への移行を完了できます。

  • ContainerImage: 移行が成功すると、SMC はソースサーバー用にコンテナイメージを生成します。このイメージは Container Registry で使用できます。

  • TargetInstance: 移行が成功すると、SMC は移行元を直接ターゲットインスタンスに移行します。このパラメーターをセットする場合は、InstanceId パラメーターも指定する必要があります。

説明
  • このパラメーターの値は大文字と小文字が区別されません。

  • Windows オペレーティングシステムおよび ARM ベースのオペレーティングシステムでは、コンテナイメージへの移行はサポートされていません。

Image

ScheduledStartTime

string

任意

移行タスクのスケジュールされた実行時間。SMC は指定された時間に移行タスクを自動的に開始します。

実行時間は ISO 8601 規格をフォローし、YYYY-MM-DDThh:mm:ssZ フォーマットの協定世界時 (UTC) 時間を使用する必要があります。たとえば、2018-01-01T12:00:00Z は 2018 年 1 月 1 日 20:00:00 (UTC+8) を示します。

説明

実行時間が空の場合、SMC は移行タスクを自動的に開始しません。開始するには、 StartReplicationJob の呼び出しが必要です。

2019-06-04T13:35:00Z

ImageName

string

任意

移行タスクによって配信されるターゲットイメージの名前。名前は以下の要件をフォローする必要があります。

  • イメージ名は、同じ Alibaba Cloud リージョン内で一意である必要があります。

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

説明

移行タスクの呼び出し中に現在のリージョンに同じ名前のイメージがすでに存在する場合、システムはイメージ名を読み取り、サフィックスとして移行タスク ID (JobId) を自動的に追加します (例: ImageName-JobId)。

testAliCloudImageName

InstanceId

string

任意

ターゲットインスタンスの ID。

i-bp1f1dvfto1sigz5****

SystemDiskSize

integer

任意

ターゲットエラスティックコンピューティングサービスサーバーのシステムクラウドディスクのサイズ。単位: GiB。有効な値: 20~500。

説明

このパラメーターの値は、ソースサーバーのシステムクラウドディスクの実際の使用領域より大きい必要があります。たとえば、ソースシステムクラウドディスクのサイズが 500 GiB で、実際に使用されている領域が 100 GiB の場合、このパラメーターの値は 100 GiB より大きい必要があります。

50

Frequency

integer

任意

増分移行タスクが実行される間隔。単位: 時間。有効な値: 1~168。

このパラメーターは、RunOnce パラメーターが false に設定されている場合に必須です。

10

MaxNumberOfImageToKeep

integer

任意

増分移行タスクに対してデフォルトで保持されるイメージの最大値。有効な値: 1~10。

このパラメーターは、RunOnce パラメーターが false にセットされている場合に必須です。

5

InstanceType

string

任意

中間インスタンスのインスタンスタイプ。

DescribeInstanceTypes を呼び出して、エラスティックコンピューティングサービス (ECS) サーバーが提供するインスタンスタイプをクエリできます。

  • このパラメーターを指定すると、システムはこのインスタンスタイプを使用して中間インスタンスを作成します。このインスタンスタイプの在庫が不足している場合、移行ノードの作成は失敗したとみなされます。

  • このパラメーターを指定しない場合、システムはデフォルトで特定の注文でインスタンスタイプを選択して中間インスタンスを作成します。詳細については、「SMC のよくある質問における中間インスタンスのインスタンスタイプ」を参照してください。

ecs.c5.large

LaunchTemplateId

string

任意

インスタンス起動テンプレートの ID。

lt-bp16jovvln1cgaaq****

LaunchTemplateVersion

string

任意

インスタンス起動テンプレートのバージョン。

Latest

InstanceRamRole

string

任意

インスタンス RAM ロールの名前。

SMCAdmin

ContainerNamespace

string

任意

Docker 名前空間。Docker コンテナイメージのフォーマットの詳細については、「Container Registry」を参照してください。

testNamespace

ContainerRepository

string

任意

Docker イメージリポジトリ。Docker コンテナイメージのフォーマットの詳細については、「Container Registry」を参照してください。

testRepository

ContainerTag

string

任意

Docker イメージタグ。Docker コンテナイメージのフォーマットの詳細については、「Container Registry」を参照してください。

CentOS:v1

ValidTime

string

任意

移行タスクの有効期限。有効な値: 移行タスクの作成後 7 日~90 日。

  • 有効期限は、移行タスクが Ready、Running、Stopped、InError、または Waiting の状態の場合にのみ変更済みにできます。

  • 有効期限は ISO 8601 規格をフォローし、YYYY-MM-DDThh:mm:ssZ フォーマットの協定世界時 (UTC) 時間を使用する必要があります。たとえば、2018-01-01T12:00:00Z は 2018 年 1 月 1 日 20:00:00 (UTC+8) を示します。

  • 有効期限が空の場合、タスクは無期限に有効です。

  • タスクの有効期限が切れると、期限切れとしてマークされ、7 日間保持されます。システムは 7 日後に自動的にクリーンアップします。

デフォルト値: 移行タスクの呼び出し後 30 日。つまり、移行タスクのデフォルトの有効期間は作成後 30 日です。

2019-06-04T13:35:00Z

SystemDiskPart

array<object>

任意

システムクラウドディスクのパーティションリスト。

object

任意

システムクラウドディスクのパーティションリスト。

SizeBytes

integer

任意

ターゲットシステムクラウドディスクのパーティション N のサイズ。単位: バイト。デフォルト値: ソースシステムクラウドディスクパーティションのサイズ。

説明

パーティションサイズはシステムクラウドディスクのサイズを超えることはできず、システムクラウドディスク配下のすべてのパーティションサイズの合計はシステムクラウドディスクのサイズを超えることはできません。

254803968

Block

boolean

任意

ターゲットシステムクラウドディスクのパーティション N のブロックレプリケーションを有効にするかどうかを指定します。有効な値:

  • true

  • false

true

Device

string

任意

ターゲットシステムクラウドディスクのパーティション N のデバイス識別子。

説明

N の実際の値については、移行元のパーティションデバイス識別子を参照してください。

0_1

DataDisk

array<object>

任意

データクラウドディスクのリスト。

array<object>

任意

データクラウドディスクのリスト。

Index

integer

任意

ターゲットエラスティックコンピューティングサービスサーバーのデータクラウドディスクのシーケンス番号。有効な値: 1~16。

デフォルト値: 1。

説明

ソースサーバーに存在するデータクラウドディスクに対してのみ、ターゲットデータクラウドディスクを作成できます。

1

Part

array<object>

任意

パーティションリスト。

object

任意

パーティションリスト。

SizeBytes

integer

任意

ターゲットデータクラウドディスクのパーティション N のサイズ。単位: バイト。デフォルト値: ソースデータクラウドディスクパーティションのサイズ。

説明

パーティションサイズはデータクラウドディスクのサイズを超えることはできず、同じデータクラウドディスク配下のすべてのパーティションサイズの合計はデータクラウドディスクのサイズを超えることはできません。

254803968

Block

boolean

任意

ターゲットデータクラウドディスクのパーティション N のブロックレプリケーションを有効にするかどうかを指定します。有効な値:

  • true

  • false

true

Device

string

任意

ターゲットデータクラウドディスクのパーティション N のデバイス識別子。

説明

N の実際の値については、移行元のパーティションデバイス識別子を参照してください。

0_1

Size

integer

任意

ターゲットエラスティックコンピューティングサービスサーバーのデータクラウドディスクのサイズ。単位: GiB。有効な値: 20~32768。

説明

このパラメーターの値は、ソースサーバーのデータクラウドディスクの実際の使用領域より大きい必要があります。たとえば、ソースデータクラウドディスクのサイズが 500 GiB で、実際に使用されている領域が 100 GiB の場合、このパラメーターの値は 100 GiB より大きい必要があります。

100

NetMode

integer

任意

データ転送のネットワークモード。有効な値:

  • 0: インターネット転送モード。このモードでは、ソースサーバーがインターネットにアクセスできる必要があります。移行データはインターネット経由で転送されます。

  • 2: 内部ネットワーク転送モード。このモードを選択する場合は、VSwitchId パラメーターをセットする必要があります。VpcId パラメーターは、サービスが API オペレーションを通じて内部的にクエリできるため、省略可能です。

0

VSwitchId

string

任意

指定された VPC 内の vSwitch の ID。

vsw-bp1ddbrxdlrcbim46****

VpcId

string

任意

Express Connect または VPN ゲートウェイが設定されている VPC の ID。

vpc-bp1vwnn14rqpyiczj****

ReplicationParameters

string

任意

レプリケーションドライバーのパラメーター情報。パラメーター情報は、固定キーを持つ JSON フォーマットのキーと値のペアです。最大長: 2048 文字。

レプリケーションドライバーは、ソースサーバーから中間インスタンスにデータをレプリケーションするために使用されるツールです。異なるレプリケーションドライバーは異なるパラメーターをフォローする場合があります。SMT レプリケーションドライバーは現在、以下のパラメーターをフォローしています。

  • bandwidth_limit: 転送速度の帯域幅制限。

  • compress_level: 転送圧縮率。

  • checksum: チェックサム検証を有効にするかどうか。

レプリケーションドライバーの値については、 DescribeSourceServers の SourceServers.ReplicationDriver レスポンスパラメーターを参照してください。

{"bandwidth_limit":0,"compress_level":1,"checksum":true}

レスポンスフィールド

フィールド

型

説明

例

object

RequestId

string

リクエスト ID。

1C488B66-B819-4D14-8711-C4EAAA13AC01

例

成功レスポンス

JSONJSON

{
  "RequestId": "1C488B66-B819-4D14-8711-C4EAAA13AC01"
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 DataDisk.DuplicateIndex The source server data disk cannot contain the same index. ソースサーバーのデータディスクに重複したインデックスを含むことはできません。
400 ReplicationJobDataDiskIndex.Invalid The specified replication job contains data disk index not found in source server. 指定されたレプリケーションジョブには、ソースサーバーに存在しないデータディスクインデックスがあります。
400 ReplicationJobName.Duplicate The specified replication job name already exists. 指定されたレプリケーションジョブ名が既に存在しています。
400 ReplicationJob.InvalidStatus The specified replication job status: %s is invalid. This operation can only be performed in the following status: %s.
400 ReplicationJob.InvalidBusinessStatus The specified business status: %s of the replication job is invalid. This operation can only be performed in the following status: %s.
400 ImageName.UsedByReplicationJob The specified imageName: "%s" was used by another replication job in the current region.
500 InternalError An error occurred while processing your request. Please try again. If the problem still exists, please submit a ticket. リクエストの処理中にエラーが発生しました。もう一度お試しください。それでも問題が解決しない場合、チケットを起票してください。

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

変更履歴

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