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

Server Migration Center:ModifyReplicationJobAttribute

最終更新日:Sep 08, 2025

ModifyReplicationJobAttribute 操作を呼び出して、移行タスクの情報を変更できます。

操作説明

説明

移行タスクを変更する前に、次の点に注意してください。

  • 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 インスタンスを作成できます。

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

  • TargetInstance: 移行が完了すると、SMC はソースを宛先インスタンスに移行します。このパラメーターをこの値に設定する場合は、InstanceId パラメーターも指定する必要があります。

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

  • Windows または Arm ベースのオペレーティングシステムを実行しているサーバーをコンテナイメージに移行することはサポートされていません。

Image

ScheduledStartTime

string

任意

移行タスクを開始する時刻。SMC は指定された時刻に移行タスクを自動的に開始します。

時刻は ISO 8601 標準に準拠し、UTC である必要があります。形式は YYYY-MM-DDThh:mm:ssZ です。たとえば、2018-01-01T12:00:00Z は 2018 年 1 月 1 日 20:00:00 (UTC + 08:00) を指定します。

説明

このパラメーターを空のままにすると、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

任意

宛先 ECS インスタンスのシステムディスクサイズ。単位: GiB。有効な値: 20 ~ 500。

説明

このパラメーターの値は、ソースサーバーのシステムディスクで使用されている容量より大きくなければなりません。たとえば、ソースサーバーのシステムディスクのサイズが 500 GiB で、100 GiB の容量が使用されている場合、このパラメーターは 100 より大きい値に設定する必要があります。

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 標準に準拠し、UTC である必要があります。形式は YYYY-MM-DDThh:mm:ssZ です。たとえば、2018-01-01T12:00:00Z は 2018 年 1 月 1 日 20:00:00 (UTC + 08:00) を指定します。

  • このパラメーターを空のままにすると、タスクは期限切れになりません。

  • タスクが期限切れになると、Expired とマークされます。タスクは 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 のデバイス ID。

説明

N の値については、ソースパーティションのデバイス ID をご参照ください。

0_1

DataDisk

array<object>

任意

データディスク。

array<object>

任意

データディスク。

Index

integer

任意

宛先 ECS インスタンス上のデータディスクのシーケンス番号。有効な値: 1 ~ 16。

初期値は 1 です。

説明

ソースサーバーに存在するデータディスクに対してのみ、宛先データディスクを作成できます。

1

Part

array

任意

パーティション。

object

任意

パーティション。

SizeBytes

integer

任意

データディスク N のパーティション N のサイズ。単位: バイト。デフォルト値は、ソースデータディスクパーティションのサイズです。

説明

パーティションのサイズは、データディスクのサイズを超えることはできません。データディスク内のすべてのパーティションの合計サイズは、データディスクのサイズを超えることはできません。

254803968

Block

boolean

任意

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

  • true

  • false

true

Device

string

任意

データディスク N のパーティション N のデバイス ID。

説明

N の値については、ソースパーティションのデバイス ID をご参照ください。

0_1

Size

integer

任意

宛先 ECS インスタンスのデータディスクのサイズ。単位: GiB。有効な値: 20 ~ 32768。

説明

このパラメーターの値は、ソースサーバーのデータディスクで使用されている容量より大きくなければなりません。たとえば、ソースサーバーのデータディスクのサイズが 500 GiB で、100 GiB の容量が使用されている場合、このパラメーターは 100 より大きい値に設定する必要があります。

100

NetMode

integer

任意

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

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

  • 2: 内部ネットワーク転送モード。このモードを選択する場合は、VSwitchId パラメーターを設定する必要があります。サービスは VPC ID を自動的にクエリできるため、VpcId パラメーターは不要です。

0

VSwitchId

string

任意

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

vsw-bp1ddbrxdlrcbim46****

VpcId

string

任意

Express Connect または VPN Gateway で構成されている VPC の ID です。

vpc-bp1vwnn14rqpyiczj****

ReplicationParameters

string

任意

レプリケーションドライバーのパラメーター。パラメーターは JSON 形式のキーと値のペアです。キーは固定です。値は最大 2,048 文字です。

レプリケーションドライバーは、ソースサーバーから中間インスタンスにデータを複製するために使用されるツールです。レプリケーションドライバーでサポートされるパラメーターは異なる場合があります。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. リクエストの処理中にエラーが発生しました。もう一度お試しください。それでも問題が解決しない場合、チケットを起票してください。

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

変更履歴

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