All Products
Search
Document Center

Resource Orchestration Service:ALIYUN::OOS::Template

Last Updated:Nov 12, 2025

The ALIYUN::OOS::Template resource type creates a template.

Syntax

{
  "Type": "ALIYUN::OOS::Template",
  "Properties": {
    "Content": String,
    "TemplateName": String,
    "Tags": Map,
    "ResourceGroupId": String,
    "IgnoreExisting": Boolean
  }
}

Properties

Property

Type

Required

Updatable

Description

Constraints

Content

String

Yes

Yes

The content of the template.

The template must be in the JSON or YAML format. The size of the template cannot exceed 64 KB.

TemplateName

String

Yes

No

The name of the template.

The name can contain letters, digits, hyphens (-), and underscores (_). The name can be up to 200 characters in length. The name cannot start with ALIYUN, ACS, ALIBABA, or ALICLOUD.

IgnoreExisting

Boolean

No

No

Specifies whether to ignore the template if it already exists.

Valid values:

  • False: Resource Orchestration Service (ROS) performs a uniqueness check. If a template with the same name exists, ROS reports an error during creation.

  • True: ROS does not perform a uniqueness check. If a template with the same name exists, the creation process is skipped.

If the template was not created by ROS, it is also ignored during the update or delete phase.

Tags

Map

No

Yes

The tags of the template. A tag is a key-value pair. Example: {"k1":"v1","k2":"v2"}.

A maximum of 20 key-value pairs are supported.

ResourceGroupId

String

No

Yes

The ID of the resource group.

None

Return values

Fn::GetAtt

  • TemplateId: The ID of the template.

  • TemplateName: The name of the template.

  • ExecutionPolicy: The execution policy of the template.

Examples

  • YAML format

    ROSTemplateFormatVersion: '2015-09-01'
    Resources:
      Template:
        Type: ALIYUN::OOS::Template
        Properties:
          Content:
            Fn::Join:
              - '"'
              - - '{"FormatVersion":"OOS-2019-06-01","Description":"automaticly delete black hole.","Parameters":{"OOSAssumeRole":{"Description":"The RAM role to be assumed by OOS.","Type":"String","Default":'
                - Ref: RoleName
                - '}},"RamRole":"{{OOSAssumeRole}}","Tasks":[{"Name":"ddosbgp_event_blackhole","Action":"ACS::EventTrigger","Properties":{"Product":"ddosbgp","Name":["ddosbgp_event_blackhole"],"Level":["CRITICAL"],"Content":{"action":["add"]}},"Outputs":{"InstanceId":{"ValueSelector":".content.instanceId","Type":"String"},"Ip":{"ValueSelector":".content.ip","Type":"String"}}},{"Name":"DeleteBlackhole","Action":"ACS::ExecuteAPI","Properties":{"Service":"ddosbgp","API":"DeleteBlackhole","Parameters":{"InstanceId":"{{ ddosbgp_event_blackhole.InstanceId }}","Ip":"{{ddosbgp_event_blackhole.Ip}}"}},"Description":"DeleteBlackhole."}],"Outputs":{"InstanceId":{"Value":"{{ ddosbgp_event_blackhole.InstanceId }}","Type":"String"},"Ip":{"Value":"{{ ddosbgp_event_blackhole.Ip }}","Type":"String"}}}'
          TemplateName: TestTemplate
    Parameters: {}
    Outputs:
      ExecutionPolicy:
        Description: Execution Policy
        Value:
          Fn::GetAtt:
            - Template
            - ExecutionPolicy
      TemplateName:
        Description: Template Name
        Value:
          Fn::GetAtt:
            - Template
            - TemplateName
      TemplateId:
        Description: Template ID
        Value:
          Fn::GetAtt:
            - Template
            - TemplateId
  • JSON format

    {
      "ROSTemplateFormatVersion": "2015-09-01",
      "Resources": {
        "Template": {
          "Type": "ALIYUN::OOS::Template",
          "Properties": {
            "Content": {
              "Fn::Join": [
                "\"",
                [
                  "{\"FormatVersion\":\"OOS-2019-06-01\",\"Description\":\"automaticly delete black hole.\",\"Parameters\":{\"OOSAssumeRole\":{\"Description\":\"The RAM role to be assumed by OOS.\",\"Type\":\"String\",\"Default\":",
                  {
                    "Ref": "RoleName"
                  },
                  "}},\"RamRole\":\"{{OOSAssumeRole}}\",\"Tasks\":[{\"Name\":\"ddosbgp_event_blackhole\",\"Action\":\"ACS::EventTrigger\",\"Properties\":{\"Product\":\"ddosbgp\",\"Name\":[\"ddosbgp_event_blackhole\"],\"Level\":[\"CRITICAL\"],\"Content\":{\"action\":[\"add\"]}},\"Outputs\":{\"InstanceId\":{\"ValueSelector\":\".content.instanceId\",\"Type\":\"String\"},\"Ip\":{\"ValueSelector\":\".content.ip\",\"Type\":\"String\"}}},{\"Name\":\"DeleteBlackhole\",\"Action\":\"ACS::ExecuteAPI\",\"Properties\":{\"Service\":\"ddosbgp\",\"API\":\"DeleteBlackhole\",\"Parameters\":{\"InstanceId\":\"{{ ddosbgp_event_blackhole.InstanceId }}\",\"Ip\":\"{{ddosbgp_event_blackhole.Ip}}\"}},\"Description\":\"DeleteBlackhole.\"}],\"Outputs\":{\"InstanceId\":{\"Value\":\"{{ ddosbgp_event_blackhole.InstanceId }}\",\"Type\":\"String\"},\"Ip\":{\"Value\":\"{{ ddosbgp_event_blackhole.Ip }}\",\"Type\":\"String\"}}}"
                ]
              ]
            },
            "TemplateName": "TestTemplate"
          }
        }
      },
      "Parameters": {
      },
      "Outputs": {
        "ExecutionPolicy": {
          "Description": "Execution Policy",
          "Value": {
            "Fn::GetAtt": [
              "Template",
              "ExecutionPolicy"
            ]
          }
        },
        "TemplateName": {
          "Description": "Template Name",
          "Value": {
            "Fn::GetAtt": [
              "Template",
              "TemplateName"
            ]
          }
        },
        "TemplateId": {
          "Description": "Template ID",
          "Value": {
            "Fn::GetAtt": [
              "Template",
              "TemplateId"
            ]
          }
        }
      }
    }