All Products
Search
Document Center

Resource Orchestration Service:ALIYUN::CEN::InterRegionTrafficQosQueue

Last Updated:Apr 09, 2026

The ALIYUN::CEN::InterRegionTrafficQosQueue resource creates a queue in a Traffic QoS Policy.

Syntax

{
  "Type": "ALIYUN::CEN::InterRegionTrafficQosQueue",
  "Properties": {
    "Dscps": List,
    "TrafficQosPolicyId": String,
    "Bandwidth": Integer,
    "InterRegionTrafficQosQueueName": String,
    "InterRegionTrafficQosQueueDescription": String,
    "RemainBandwidthPercent": Integer
  }
}

Properties

Parameter

Type

Required

Update allowed

Description

Constraints

Dscps

List

Yes

Yes

The Differentiated Services Code Point (DSCP) values of the traffic packets that match the queue.

Valid values: 0 to 63.

TrafficQosPolicyId

String

Yes

No

The ID of the Traffic QoS Policy.

None.

Bandwidth

Integer

No

Yes

The maximum absolute bandwidth for the queue.

Unit: Mbit/s.

  • For example, a value of 20 sets the maximum bandwidth for the queue to 20 Mbit/s.

  • The sum of bandwidths for all queues in the same inter-region connection cannot exceed the maximum bandwidth of the inter-region connection.

InterRegionTrafficQosQueueDescription

String

No

Yes

The description of the queue.

The description must be 1 to 256 characters long and cannot start with http:// or https://.

InterRegionTrafficQosQueueName

String

No

Yes

The name of the queue.

The name must be 1 to 128 characters long and cannot start with http:// or https://.

RemainBandwidthPercent

Integer

No

Yes

The maximum percentage of inter-region bandwidth that can be allocated to the queue.

Unit: percent. For example, a value of 20 indicates that the queue can use a maximum of 20% of the inter-region bandwidth. The sum of percentages for all queues in the same inter-region connection cannot exceed 100%. Valid values: 0 to 100.

Return values

Fn::GetAtt

  • RemainBandwidthPercent: The maximum percentage of inter-region bandwidth that can be allocated to the queue.

  • EffectiveBandwidth: The actual bandwidth of the queue.

  • InterRegionTrafficQosQueueId: The ID of the queue.

  • Dscps: The DSCP values of the traffic packets that match the queue.

  • Bandwidth: The maximum absolute bandwidth for the queue. Unit: Mbit/s.

  • InterRegionTrafficQosQueueName: The name of the queue.

  • TrafficQosPolicyId: The ID of the Traffic QoS Policy.

  • InterRegionTrafficQosQueueDescription: The description of the queue.

Examples

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  Dscps:
    AssociationPropertyMetadata:
      Parameter:
        Type: Number
        Description: The DSCP value that matches the current queue.
        Required: false
    AssociationProperty: List[Parameter]
    Type: Json
    Description: The list of DSCP values for traffic packets that match the queue. Each value can range from 0 to 63.
    Required: true
    MinLength: 0
    MaxLength: 63
  TrafficQosPolicyId:
    Type: String
    Description: The ID of the Traffic QoS Policy.
    Required: true
Resources:
  ExtensionResource:
    Type: ALIYUN::CEN::InterRegionTrafficQosQueue
    Properties:
      Dscps:
        Ref: Dscps
      TrafficQosPolicyId:
        Ref: TrafficQosPolicyId
Outputs:
  RemainBandwidthPercent:
    Description: The maximum percentage of inter-region bandwidth that can be allocated to the queue.
    Value:
      Fn::GetAtt:
        - ExtensionResource
        - RemainBandwidthPercent
  EffectiveBandwidth:
    Description: The actual bandwidth of the queue.
    Value:
      Fn::GetAtt:
        - ExtensionResource
        - EffectiveBandwidth
  InterRegionTrafficQosQueueId:
    Description: The ID of the queue.
    Value:
      Fn::GetAtt:
        - ExtensionResource
        - InterRegionTrafficQosQueueId
  Dscps:
    Description: The list of DSCP values for traffic packets that match the queue.
    Value:
      Fn::GetAtt:
        - ExtensionResource
        - Dscps
  Bandwidth:
    Description: 'The maximum absolute bandwidth that can be allocated to the queue. Unit: Mbit/s.'
    Value:
      Fn::GetAtt:
        - ExtensionResource
        - Bandwidth
  InterRegionTrafficQosQueueName:
    Description: The name of the queue.
    Value:
      Fn::GetAtt:
        - ExtensionResource
        - InterRegionTrafficQosQueueName
  TrafficQosPolicyId:
    Description: The ID of the Traffic QoS Policy.
    Value:
      Fn::GetAtt:
        - ExtensionResource
        - TrafficQosPolicyId
  InterRegionTrafficQosQueueDescription:
    Description: The description of the queue.
    Value:
      Fn::GetAtt:
        - ExtensionResource
        - InterRegionTrafficQosQueueDescription
{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "Dscps": {
      "AssociationPropertyMetadata": {
        "Parameter": {
          "Type": "Number",
          "Description": "The DSCP value that matches the current queue.",
          "Required": false
        }
      },
      "AssociationProperty": "List[Parameter]",
      "Type": "Json",
      "Description": "The list of DSCP values for traffic packets that match the queue. Each value can range from 0 to 63.",
      "Required": true,
      "MinLength": 0,
      "MaxLength": 63
    },
    "TrafficQosPolicyId": {
      "Type": "String",
      "Description": "The ID of the Traffic QoS Policy.",
      "Required": true
    }
  },
  "Resources": {
    "ExtensionResource": {
      "Type": "ALIYUN::CEN::InterRegionTrafficQosQueue",
      "Properties": {
        "Dscps": {
          "Ref": "Dscps"
        },
        "TrafficQosPolicyId": {
          "Ref": "TrafficQosPolicyId"
        }
      }
    }
  },
  "Outputs": {
    "RemainBandwidthPercent": {
      "Description": "The maximum percentage of inter-region bandwidth that can be allocated to the queue.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionResource",
          "RemainBandwidthPercent"
        ]
      }
    },
    "EffectiveBandwidth": {
      "Description": "The actual bandwidth of the queue.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionResource",
          "EffectiveBandwidth"
        ]
      }
    },
    "InterRegionTrafficQosQueueId": {
      "Description": "The ID of the queue.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionResource",
          "InterRegionTrafficQosQueueId"
        ]
      }
    },
    "Dscps": {
      "Description": "The list of DSCP values for traffic packets that match the queue.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionResource",
          "Dscps"
        ]
      }
    },
    "Bandwidth": {
      "Description": "The maximum absolute bandwidth that can be allocated to the queue. Unit: Mbit/s.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionResource",
          "Bandwidth"
        ]
      }
    },
    "InterRegionTrafficQosQueueName": {
      "Description": "The name of the queue.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionResource",
          "InterRegionTrafficQosQueueName"
        ]
      }
    },
    "TrafficQosPolicyId": {
      "Description": "The ID of the Traffic QoS Policy.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionResource",
          "TrafficQosPolicyId"
        ]
      }
    },
    "InterRegionTrafficQosQueueDescription": {
      "Description": "The description of the queue.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionResource",
          "InterRegionTrafficQosQueueDescription"
        ]
      }
    }
  }
}