すべてのプロダクト
Search

このプロダクト

    Data Online Migration:create-address (データアドレスの作成)

    ドキュメントセンター

    Data Online Migration:create-address (データアドレスの作成)

    最終更新日:Jan 30, 2026

    mgwutil create-address コマンドを使用して、パラメーターを指定することでデータアドレスを作成できます。このコマンドは、Object Storage Service (OSS)、S3、COS などの複数のストレージクラスをサポートしています。

    コマンドフォーマット

    mgwutil create-address <address-name> --address-type <value> [--bucket <value>] [--domain <value>]...

    パラメーター

    パラメーター

    必須

    説明

    address-name

    はい

    作成するデータアドレスの名前。

    --address-type

    はい

    データアドレスのタイプ。

    有効な値の詳細については、「AddressDetail」をご参照ください。

    --data-type

    いいえ

    AddressType が `inv` に設定されている場合、DataType はマニフェストアイテムに関連付けられている実際の Object Storage Service のタイプを指定します。

    有効な値は次のとおりです：

    oss、s3、cos。

    --bucket

    いいえ

    移行元または移行先のバケット名。このパラメーターは、データ転送に使用されるバケットを指定します。

    --prefix

    いいえ

    プレフィックス。このパラメーターは、ソースが `local` タイプの場合に必須です。

    --domain

    いいえ

    移行元または移行先の Object Storage Service のエンドポイント。このパラメーターは、データ転送のアクセスアドレスを指定します。

    --region-id

    いいえ

    ソースまたは宛先のリージョン ID。 ストレージクラスが OSS の場合、このパラメーターは必須です。 Alibaba Cloud OSS バケットが配置されているリージョン (oss-cn-hangzhou など) を指定します。

    --access-id

    いいえ

    移行元または移行先の AccessKey ID。この認証情報は、対応する Object Storage Service にアクセスするための ID 認証に使用されます。

    --access-secret

    いいえ

    移行元または移行先の AccessKey Secret。このキーは、移行元の Object Storage Service にアクセスするための ID 認証に使用されます。

    --role

    いいえ

    承認済みロール。データが OSS バケットに保存されている場合、バケットの AccessKey ペアの代わりに承認済みロールを指定できます。

    承認済みロールの詳細については、「移行の実装」をご参照ください。

    --agent-list

    いいえ

    移行元または移行先のアドレスに関連付けられているエージェントのリスト。例：agent1,agent2,agent3。

    --inv-access-id

    いいえ

    マニフェストタイプのアドレスを作成する際に、マニフェストが保存されているバケットへのアクセスに使用される AccessKey ID です。

    --inv-access-secret

    いいえ

    マニフェストタイプのアドレスを作成する際に、マニフェストが保存されているバケットへのアクセスに使用される AccessKey Secret です。

    --inv-domain

    いいえ

    マニフェストドメイン名。マニフェストタイプのアドレスを作成する際に、このパラメーターはマニフェストファイルが配置されているストレージサービスのエンドポイントを指定します。

    --inv-region-id

    いいえ

    OSS マニフェストソース (`ossinv`) のリージョン ID。このパラメーターは、cn-hangzhou など、マニフェストが配置されている Alibaba Cloud OSS バケットのリージョンを指定します。

    --inv-bucket

    いいえ

    マニフェストが保存されているバケットの名前。マニフェストタイプのアドレスを作成する際に、このパラメーターはマニフェストファイルのストレージ場所を指定します。

    --inv-location

    いいえ

    マニフェストソースのタイプ。マニフェストタイプのアドレスを作成する際に、このパラメーターはマニフェストファイルが配置されているストレージサービスのタイプを指定します。通常、これは oss に設定されます。

    --inv-path

    いいえ

    マニフェストファイルへのパス。マニフェストタイプのアドレスを作成する際に、このパラメーターはバケット内の manifest.json ファイルの完全なオブジェクトパスを指定します。例：path/to/manifest.json。

    --inv-role

    いいえ

    マニフェストリストを保存するバケットの承認済みロール。マニフェストリストが OSS バケットに保存されている場合、バケットの AccessKey ペアの代わりに承認済みロールを指定できます。

    マニフェストリストバケットの承認済みロールの詳細については、「移行の実装」をご参照ください。

    例

    OSS

    次の例は、OSS データソースのデータアドレスを作成する方法を示しています。

    mgwutil create-address "mgwutil_src_agent-1" --address-type oss --bucket "bucket-beijing" --role "oss-import-*" --region-id "oss-cn-beijing"

    LOCAL

    次の例は、LOCAL データソースのデータアドレスを作成する方法を示しています。

    mgwutil create-address "mgwutil_src_agent-1" --address-type local  --prefix "/mnt/abc/" --agent-list "local-agent"

    INV

    説明

    汎用マニフェストソースは、ネイティブクラウドストレージマニフェストと移行サービスのカスタムマニフェストをサポートしています。

    次の例は、OSS マニフェストデータソースのデータアドレスを作成する方法を示しています。

    mgwutil create-address  "mgwutil_src_agent-1" --address-type inv  --data-type oss --bucket "bucket-oss" --role "oss-import-*" --region-id "oss-cn-beijing" --inv-bucket "bucket-beijing" --inv-location "oss" --inv-path "dir/manifest.json" --inv-region-id "oss-cn-beijing" --inv-role "oss-import-*"

    次の例は、S3 マニフェストデータソースのデータアドレスを作成する方法を示しています。

    mgwutil create-address  "mgwutil_src_agent-1" --address-type inv  --data-type s3 --bucket "bucket-beijing"--domain "s3.us-east-1.amazonaws.com" --bucket "bucket-s3"  --access-id "*******" --access-secret "*******" --inv-bucket "bucket-s3" --inv-location "s3" --inv-path "dir/manifest.json" --inv-domain "s3.us-east-1.amazonaws.com"

    次の例は、S3-COMPAT マニフェストデータソースのデータアドレスを作成する方法を示しています。

    mgwutil create-address  "mgwutil_src_agent-1" --address-type inv  --data-type s3-compat --bucket "bucket-s3-compat"   --inv-bucket "bucket-beijing" --inv-location "oss" --inv-path "dir/manifest.json" --inv-region-id "oss-cn-beijing"

    次の例は、COS マニフェストデータソースのデータアドレスを作成する方法を示しています。

    mgwutil create-address  "mgwutil_src_agent-1" --address-type inv  --data-type cos --domain "cos.ap-nanjing.myqcloud.com" --bucket "bucket-cos" --access-id "*******" --access-secret "*******" --inv-bucket "bucket-beijing" --inv-location "cos" --inv-path "dir/manifest.json" --inv-domain "cos.ap-nanjing.myqcloud.com"

    次の例は、TOS マニフェストデータソースのデータアドレスを作成する方法を示しています。

    mgwutil create-address  "mgwutil_src_agent-1" --address-type inv  --data-type tos --domain "tos-s3-cn-beijing.volces.com" --bucket "bucket-tos" --access-id "*******" --access-secret "*******" --inv-bucket "bucket-beijing" --inv-location "tos" --inv-path "dir/manifest.json" --inv-domain "tos-s3-cn-beijing.volces.com"

    次の例は、OBS マニフェストデータソースのデータアドレスを作成する方法を示しています。

    mgwutil create-address  "mgwutil_src_agent-1" --address-type inv  --data-type obs --domain "obs.cn-north-1.myhuaweicloud.com" --bucket "bucket-obs" --access-id "*******" --access-secret "*******" --inv-bucket "bucket-obs" --inv-location "obs" --inv-path "dir/manifest.json" --inv-domain "obs.cn-north-1.myhuaweicloud.com"

    HTTP

    次の例は、HTTP マニフェストデータソースのデータアドレスを作成する方法を示しています。

    mgwutil create-address  "mgwutil_src_agent-1" --address-type http  --bucket "bucket-http" --role "oss-import-*" --region-id "oss-cn-beijing" --inv-bucket "bucket-beijing" --inv-location "oss" --inv-path "dir/manifest.json" --inv-region-id "oss-cn-beijing"

    S3

    次の例は、S3 データソースのデータアドレスを作成する方法を示しています。

    mgwutil create-address  "mgwutil_src_agent-1" --address-type s3 --domain "s3.us-east-1.amazonaws.com" --bucket "bucket-s3"  --access-id "*******" --access-secret "*******"

    S3COMPAT

    次の例は、S3 互換 (S3COMPAT) データソースのデータアドレスを作成する方法を示しています。

    mgwutil create-address  "mgwutil_src_agent-1" --address-type s3compat --domain "<s3-compat-url>" --bucket "bucket-s3-compat"  --access-id "*******" --access-secret "*******"

    COS

    次の例は、COS データソースのデータアドレスを作成する方法を示しています。

    mgwutil create-address  "mgwutil_src_agent-1" --address-type cos --domain "cos.ap-nanjing.myqcloud.com" --bucket "bucket-cos" --access-id "*******" --access-secret "*******"

    OBS

    次の例は、OBS データソースのデータアドレスを作成する方法を示しています。

    mgwutil create-address  "mgwutil_src_agent-1" --address-type obs --domain "obs.cn-north-1.myhuaweicloud.com" --bucket "bucket-obs" --access-id "*******" --access-secret "*******"

    TOS

    次の例は、TOS データソースのデータアドレスを作成する方法を示しています。

    mgwutil create-address  "mgwutil_src_agent-1" --address-type tos --domain "tos-s3-cn-beijing.volces.com" --bucket "bucket-tos" --access-id "*******" --access-secret "*******"

    BOS

    次の例は、BOS データソースのデータアドレスを作成する方法を示しています。

    mgwutil create-address  "mgwutil_src_agent-1" --address-type bos --domain "bj.bcebos.com" --bucket "bucket-bos" --access-id "*******" --access-secret "*******"

    QINIU

    次の例は、QINIU データソースのデータアドレスを作成する方法を示しています。

    mgwutil create-address  "mgwutil_src_agent-1" --address-type qiniu --domain "<Qiniu custom origin or accelerated domain name>" --bucket "bucket-qiniu" --access-id "*******" --access-secret "*******"

    KS3

    次の例は、KS3 データソースのデータアドレスを作成する方法を示しています。

    mgwutil create-address  "mgwutil_src_agent-1" --address-type ks3 --domain "ks3-cn-beijing.ksyuncs.com" --bucket "bucket-ks3" --access-id "*******" --access-secret "*******"

    AZURE

    次の例は、AZURE データソースのデータアドレスを作成する方法を示しています。

    mgwutil create-address  "mgwutil_src_agent-1" --address-type azure --domain "https://<storage_account>.blob.core.windows.net" --bucket "bucket-azure" --access-secret "*******"

    GCP

    次の例は、GCP データソースのデータアドレスを作成する方法を示しています。

    mgwutil create-address  "mgwutil_src_agent-1" --address-type gcp --domain "<Request endpoint of the bucket (Cloud Storage URI)>" --bucket "bucket-gcp" --access-id "*******" --access-secret "*******"

    YOUPAI

    次の例は、YOUPAI データソースのデータアドレスを作成する方法を示しています。

    mgwutil create-address  "mgwutil_src_agent-1" --address-type upyun  --bucket "youpai-bucket" --domain "s3.api.upyun.com" --access-id "*******" --access-secret "*******"

    UCLOUD

    次の例は、UCLOUD データソースのデータアドレスを作成する方法を示しています。

    mgwutil create-address  "mgwutil_src_agent-1" --address-type ucloud  --bucket "us3-bucket" --domain "cn-bj.ufileos.com" --access-id "*******" --access-secret "*******"

    FTP

    次の例は、FTP データソースのデータアドレスを作成する方法を示しています。

    mgwutil create-address "ftp-ss-src-0127" --address-type ftp --agent-list "ftp-server-test" --prefix "/home/normal/" --domain "127.0.0.1:21" --access-id "drs_e2e" --access-secret "******"

    OSSINV

    次の例は、OSSINV データソースのデータアドレスを作成する方法を示しています。

    mgwutil create-address "ossinv-oss-src-0127" --address-type ossinv --bucket "src-common-cn-hangzhou" --role "src-common-cn-hangzhou" --region-id "oss-cn-hangzhou" --inv-bucket "ossinv-src-common-cn-hangzhou" --inv-location oss --inv-path "ossinv-common/manifest.json" --inv-role "import-ossinv-src-common-cn-han" --inv-region-id "oss-cn-hangzhou"

    S3INV

    次の例は、S3INV データソースのデータアドレスを作成する方法を示しています。

    mgwutil create-address "s3inv-oss-src-0127" --address-type s3inv --domain "s3.ap-southeast-1.amazonaws.com" --bucket "src-common-ap-southeast-1" --access-id "AK******" --access-secret "SK******" --inv-bucket "s3inv-src-common-ap-southeast-1" --inv-location s3 --inv-path "s3inv-common/common/manifest.json" --inv-access-id "AK******" --inv-access-secret "SK*******" --inv-domain "s3.ap-southeast-1.amazonaws.com"

    応答

    成功の応答

    {
  "Code":      "success" ,
  "StatusCode": 200,
  "LogTime": "2025-12-25 17:51:37",
  "Data":       {
    "AddrName": "mgwutil_src_agent-1",
    "Version": "***-2713-4cdc-88c7-***",
    "CreateTime": "2025-07-17T13:36:37.000Z",
    "Status": "notVerify",
    "AddrType": "oss",
    "AgentList": "mgwutil_agent_1"
  }
}

    エラー応答

    {
  "Code": "fail",
  "StatusCode": 400,
  "LogTime": "2026-01-16 11:31:03",
  "ErrorMsg": "SDKError:    StatusCode: 400    Code: InvalidArgument    Message: AddressType is invalid    Data: {'AccessDeniedDetail':null,'Recommend':null,'ecCode':null,'hostId':'1****96***69****.cn-hangzhou.mgw.aliyuncs.com','requestId':'6969B0F79367063435CAC345','statusCode':400} ",
  "ErrorCode": "InvalidArgument",
  "RequestId": "6969B0F79367063435CAC345"
}

    エラーコード

    説明

    • エラーコードはエラーカテゴリを示します。詳細については、エラーメッセージ (ErrorMsg) をご参照ください。

    • このエラーコードは、「共通エラーコード」に記載されています。

    ErrorCode

    説明

    MissingArgument

    必須パラメーターがありません。コマンドで指定されているすべての必須パラメーターを指定してください。

    InvalidArgument

    パラメーター名が無効であるか、パラメーター値が有効ではありません。

    ImportAddressAlreadyExist

    同じ名前のアドレスがすでに存在します。一意の名前を使用するか、既存のアドレスを先に削除してください。

    NoSuchImportAgent

    関連付けられたエージェントが存在しません。--agent-list 内のエージェント名が正しいことを確認してください。

    ImportAddressNumExceed

    データアドレスの数が制限を超えています。

    デフォルトの制限：200。