Use DATASOURCE::PVTZ::Rules to query forwarding rules - Resource Orchestration Service

Syntax

{
  "Type": "DATASOURCE::PVTZ::Rules",
  "Properties": {
    "EndpointId": String,
    "RefreshOptions": String
  }
}

Properties

Property

Type

Required

Editable

Description

Constraint

EndpointId

String

No

Yes

The ID of the outbound endpoint.

None.

RefreshOptions

String

No

Yes

The refresh policy for data source resources when the stack is updated.

Valid values:

Never (default): Does not refresh data source resources when the stack is updated.
Always: Refreshes data source resources when the stack is updated.

Return values

Fn::GetAtt

RuleIds: the IDs of the forwarding rules.
Rules: details of the forwarding rules.

Property	Type	Description	Constraint
RuleIds	List	The IDs of the forwarding rules.	None.
Rules	List	Details of the forwarding rules.	None.
ForwardIp	List	The destination IP addresses.	Example: `[{"Ip": "192.168.XX.XX","Port": 53}]`
RuleId	String	The ID of the forwarding rule.	None.
Vpcs	List	The associated virtual private clouds (VPCs).	Example: `[ { "VpcName" : "vpc-name-test", "VpcId" : "vpc-8vbl8mpum-vp****", "RegionName" : "Hangzhou-test", "RegionId" : "cn-hangzhou" } ]`
EndpointName	String	The name of the endpoint.	None.
EndpointId	String	The ID of the endpoint.	None.
RuleName	String	The name of the forwarding rule.	None.
Type	String	The type of the forwarding rule.	Only OUTBOUND can be returned, which indicates that Domain Name System (DNS) traffic is forwarded to external IP addresses.
CreateTime	String	The time when the forwarding rule was created.	None.
ZoneName	String	The name of the zone for which DNS requests are forwarded.	None.

Examples

YAML

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  EndpointId:
    Description: EndpointId
    Type: String
Resources:
  ExtensionDataSource:
    Properties:
      EndpointId:
        Ref: EndpointId
    Type: DATASOURCE::PVTZ::Rules
Outputs:
  RuleIds:
    Description: The list of rule IDs.
    Value:
      Fn::GetAtt:
      - ExtensionDataSource
      - RuleIds
  Rules:
    Description: The list of rules.
    Value:
      Fn::GetAtt:
      - ExtensionDataSource
      - Rules

JSON

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "EndpointId": {
      "Type": "String",
      "Description": "EndpointId"
    }
  },
  "Resources": {
    "ExtensionDataSource": {
      "Type": "DATASOURCE::PVTZ::Rules",
      "Properties": {
        "EndpointId": {
          "Ref": "EndpointId"
        }
      }
    }
  },
  "Outputs": {
    "RuleIds": {
      "Description": "The list of rule IDs.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "RuleIds"
        ]
      }
    },
    "Rules": {
      "Description": "The list of rules.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "Rules"
        ]
      }
    }
  }
}