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

Resource Orchestration Service:ALIYUN::ECS::RamRoleAttachment

最終更新日:Jun 19, 2026

1 つ以上の ECS インスタンスにインスタンス RAM ロールを割り当てます。

構文

{
  "Type": "ALIYUN::ECS::RamRoleAttachment",
  "Properties": {
    "Policy": String,
    "RamRoleName": String,
    "InstanceIds": リスト
  }
}

プロパティ

プロパティ名

タイプ

必須

更新可能

説明

制約

Policy

String

いいえ

いいえ

アクセスポリシー。

長さは 1~1,024 文字である必要があります。RAM ロールの権限をさらに制限するための追加のアクセスポリシーを指定します。詳細については、「アクセスポリシーの概要」をご参照ください。

RamRoleName

String

はい

いいえ

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

RAM API の ListRoles を使用して、作成したインスタンスの RAM ロールを照会します。

InstanceIds

リスト

はい

いいえ

インスタンス ID のリスト。

インスタンス ID の JSON 配列。最大 100 個のインスタンスを指定できます。

戻り値

Fn::GetAtt

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

  • InstanceIds: インスタンス ID のリスト。

例

YAML 形式

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  Policy:
    Type: String
    Description: |-
      アクセスポリシー。インスタンス RAM ロールを ECS インスタンスに付与する際、この追加のポリシーを指定して、RAM ロールの権限をさらに制限できます。
      ポリシーの長さは 1~1,024 文字です。
    MinLength: 1
    MaxLength: 1024
    Default:
      Statement:
        - Action:
            - '*'
          Effect: Allow
          Resource:
            - '*'
      Version: '1'
  RamRoleName:
    Type: String
    Description: インスタンス RAM ロールの名前。
    Default: testRamRoleName
  InstanceIds:
    Type: Json
    Description: インスタンス RAM ロールを付与する先の ECS インスタンスの ID。
    MinLength: 1
    MaxLength: 100
    Default:
      - i-***
      - i-***
Resources:
  RamRoleAttachment:
    Type: ALIYUN::ECS::RamRoleAttachment
    Properties:
      Policy:
        Ref: Policy
      RamRoleName:
        Ref: RamRoleName
      InstanceIds:
        Ref: InstanceIds
Outputs:
  RamRoleName:
    Description: インスタンス RAM ロールの名前。
    Value:
      Fn::GetAtt:
        - RamRoleAttachment
        - RamRoleName
  InstanceIds:
    Description: ECS インスタンス ID のリスト。
    Value:
      Fn::GetAtt:
        - RamRoleAttachment
        - InstanceIds

JSON 形式

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "Policy": {
      "Type": "String",
      "Description": "アクセスポリシー。インスタンス RAM ロールを ECS インスタンスに付与する際、この追加のポリシーを指定して、RAM ロールの権限をさらに制限できます。\nポリシーの長さは 1~1,024 文字です。",
      "MinLength": 1,
      "MaxLength": 1024,
      "Default": {"Statement": [{"Action": ["*"],"Effect": "Allow","Resource": ["*"]}],"Version":"1"}
    },
    "RamRoleName": {
      "Type": "String",
      "Description": "インスタンス RAM ロールの名前。",
      "Default": "testRamRoleName"
    },
    "InstanceIds": {
      "Type": "Json",
      "Description": "インスタンス RAM ロールを付与する先の ECS インスタンスの ID。",
      "MinLength": 1,
      "MaxLength": 100,
      "Default": ["i-***", "i-***"]
    }
  },
  "Resources": {
    "RamRoleAttachment": {
      "Type": "ALIYUN::ECS::RamRoleAttachment",
      "Properties": {
        "Policy": {
          "Ref": "Policy"
        },
        "RamRoleName": {
          "Ref": "RamRoleName"
        },
        "InstanceIds": {
          "Ref": "InstanceIds"
        }
      }
    }
  },
  "Outputs": {
    "RamRoleName": {
      "Description": "インスタンス RAM ロールの名前。",
      "Value": {
        "Fn::GetAtt": [
          "RamRoleAttachment",
          "RamRoleName"
        ]
      }
    },
    "InstanceIds": {
      "Description": "ECS インスタンス ID のリスト。",
      "Value": {
        "Fn::GetAtt": [
          "RamRoleAttachment",
          "InstanceIds"
        ]
      }
    }
  }
}