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

Resource Orchestration Service:ALIYUN::ECS::CopyImage

最終更新日:Jan 16, 2025

ALIYUN::ECS::CopyImage は、カスタムイメージをあるリージョンから別のリージョンにコピーするために使用されます。

構文

{
  "Type": "ALIYUN::ECS::CopyImage",
  "Properties": {
    "Encrypted": Boolean,
    "DestinationImageName": String,
    "ImageId": String,
    "DestinationRegionId": String,
    "SourceRegionId": String,
    "Tag": List,
    "DestinationDescription": String,
    "KMSKeyId": String,
    "ResourceGroupId": String,
    "AllowCopyInSameRegion": Boolean
  }
}

プロパティ

プロパティ

タイプ

必須

編集可能

説明

制約

Encrypted

Boolean

いいえ

いいえ

コピー先のカスタムイメージを暗号化するかどうかを指定します。

有効な値:

  • true

  • false (デフォルト)

DestinationImageName

String

いいえ

いいえ

コピー先のカスタムイメージの名前。

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

ImageId

String

はい

いいえ

コピー元カスタムイメージの ID。

なし。

DestinationRegionId

String

はい

いいえ

コピー先のリージョンの ID。

なし。

SourceRegionId

String

いいえ

いいえ

コピー元のリージョンの ID。

デフォルトでは、現在のリージョンの ID が使用されます。

Tag

List

いいえ

いいえ

タグ。

詳細については、タグのプロパティ をご参照ください。

DestinationDescription

String

いいえ

いいえ

コピー先のカスタムイメージの説明。

説明は 2 ~ 256 文字の長さでなければなりません。http:// または https:// で始めることはできません。

KMSKeyId

String

いいえ

いいえ

カスタムイメージの暗号化に使用されるキーの ID。

なし。

ResourceGroupId

String

いいえ

はい

リソースグループの ID。

なし。

AllowCopyInSameRegion

Boolean

いいえ

いいえ

同じリージョン内でのイメージのコピーを許可しないかどうかを指定します。

有効な値:

  • true:同じリージョン内でのイメージのコピーを許可せず、ソースイメージの ID を返し、ソースイメージを保持します。

  • false:同じリージョン内でのイメージのコピーを許可します。

タグの構文

"Tag": [
  {
    "Key": String,
    "Value": String
  }
]

タグのプロパティ

プロパティ

タイプ

必須

編集可能

説明

制約

Key

String

いいえ

いいえ

タグキー。

タグキーは 1 ~ 128 文字の長さでなければならず、http:// または https:// を含めることはできません。aliyun または acs: で始めることはできません。

Value

String

いいえ

いいえ

タグ値。

タグ値は最大 128 文字の長さで、http:// または https:// を含めることはできません。aliyun または acs: で始めることはできません。

戻り値

Fn::GetAtt

  • ImageId:コピー先のカスタムイメージの ID。

  • DestinationRegionId:コピー先のリージョンの ID。

  • SourceRegionId:コピー元のリージョンの ID。

  • YAML 形式

    ROSTemplateFormatVersion: '2015-09-01'
    Description:
       
      # ECS CopyImage の作成
      en: Create ECS CopyImage
    Parameters:
      ImageId:
        Type: String
        AssociationProperty: ALIYUN::ECS::Image::ImageId
        AssociationPropertyMetadata:
          SupportedImageOwnerAlias:
            - self
    Resources:
      CopyImage:
        Type: ALIYUN::ECS::CopyImage
        Properties:
          Encrypted: false
          ImageId:
            Ref: ImageId
          DestinationRegionId: cn-shanghai
          SourceRegionId: cn-hangzhou
          DestinationDescription: Test CopyImage
    Outputs:
      CopyImageId:
        Value:
          Fn::GetAtt:
            - CopyImage
            - ImageId                    
  • JSON 形式

    {
      "ROSTemplateFormatVersion": "2015-09-01",
      "Description": {
         
        // ECS CopyImage の作成
        "en": "Create ECS CopyImage"
      },
      "Parameters": {
        "ImageId": {
          "Type": "String",
          "AssociationProperty": "ALIYUN::ECS::Image::ImageId",
          "AssociationPropertyMetadata": {
            "SupportedImageOwnerAlias": [
              "self"
            ]
          }
        }
      },
      "Resources": {
        "CopyImage": {
          "Type": "ALIYUN::ECS::CopyImage",
          "Properties": {
            "Encrypted": false,
            "ImageId": {
              "Ref": "ImageId"
            },
            "DestinationRegionId": "cn-shanghai",
            "SourceRegionId": "cn-hangzhou",
            "DestinationDescription": "Test CopyImage"
          }
        }
      },
      "Outputs": {
        "CopyImageId": {
          "Value": {
            "Fn::GetAtt": [
              "CopyImage",
              "ImageId"
            ]
          }
        }
      }
    }