All Products
Search
Document Center

Resource Orchestration Service:ALIYUN::OOS::Template

Last Updated:Jun 16, 2026

Creates an Operation Orchestration Service (OOS) 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 JSON or YAML format and cannot exceed 64 KB in size.

TemplateName

String

Yes

No

The name of the template.

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

IgnoreExisting

Boolean

No

No

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 already exists, an error is returned.

  • True: ROS skips the uniqueness check. If a template with the same name already exists, creation 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, specified as key-value pairs. Example: {"k1":"v1","k2":"v2"}.

You can specify up to 20 key-value pairs.

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"
            ]
          }
        }
      }
    }