How to use DATASOURCE::NLB::LoadBalancers to query information about NLB instances - Resource Orchestration Service

Syntax

{
  "Type": "DATASOURCE::NLB::LoadBalancers",
  "Properties": {
    "LoadBalancerNames": List,
    "AddressIpVersion": String,
    "LoadBalancerBussinessStatus": String,
    "ZoneId": String,
    "ResourceGroupId": String,
    "VpcIds": List,
    "LoadBalancerIds": List,
    "AddressType": String,
    "LoadBalancerStatus": String,
    "Tags": List,
    "Ipv6AddressType": String,
    "RefreshOptions": String
  }
}

Properties

Property	Type	Required	Editable	Description	Constraint
LoadBalancerNames	List	No	Yes	The names of the NLB instances.	You can query up to 20 instances in a request.
AddressIpVersion	String	No	Yes	The protocol version.	Valid values: ipv4 DualStack
LoadBalancerBussinessStatus	String	No	Yes	The business status of the NLB instance.	Valid values: Abnormal Normal
ZoneId	String	No	Yes	The zone ID.	None.
ResourceGroupId	String	No	Yes	The ID of the resource group.	None.
VpcIds	List	No	Yes	The IDs of the VPCs in which the NLB instances reside.	You can query up to 10 VPCs in a request.
LoadBalancerIds	List	No	Yes	The IDs of the NLB instances.	You can query up to 20 instances in a request.
AddressType	String	No	Yes	The IPv4 address type of the NLB instance.	Valid values: Internet: The instance uses a public IP address and can be accessed over the Internet. Intranet: The instance uses a private IP address and can be accessed only within its VPC.
LoadBalancerStatus	String	No	Yes	The status of the NLB instance.	Valid values: Inactive: The NLB instance is stopped. Listeners do not forward traffic. Active: The NLB instance is running. Provisioning: The NLB instance is being created. Configuring: The NLB instance configurations are being modified. Deleting: The NLB instance is being deleted. Deleted: The NLB instance is deleted.
Tags	List	No	Yes	The tags of the NLB instance.	You can add up to 20 tags in a request.
Ipv6AddressType	String	No	Yes	The IPv6 address type of the NLB instance.	Valid values: Internet: The instance uses a public IP address and can be accessed over the Internet. Intranet: The instance uses a private IP address and can be accessed only within its VPC.
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.

Tags syntax

"Tags": [
  {
    "Value": String,
    "Key": String
  }
]

Tags properties

Property	Type	Required	Editable	Description	Constraint
Value	String	No	No	The tag value.	The tag value can be up to 128 characters in length and cannot contain `http://` or `https://`. It cannot start with `aliyun` or `acs:`.
Key	String	Yes	No	The tag key.	The tag key must be 1 to 128 characters in length and cannot contain `http://` or `https://`. It cannot start with `aliyun` or `acs:`.

Return values

Fn::GetAtt

LoadBalancerIds: the IDs of the NLB instances.
LoadBalancers: details of the NLB instances.

Property	Type	Description	Constraint
LoadBalancerIds	List	The IDs of the NLB instances.	None.
LoadBalancers	List	Details of the NLB instances.	None.
LoadBalancerId	String	The ID of the NLB instance.	None.
LoadBalancerName	String	The name of the NLB instance.	None.
LoadBalancerType	String	The type of the Server Load Balancer (SLB) instance.	Only Network is returned, indicating an NLB instance.
AddressType	String	The IPv4 address type of the NLB instance.	Valid values: Internet: The instance uses a public IP address and can be accessed over the Internet. Intranet: The instance uses a private IP address and can be accessed only within its VPC.
AddressIpVersion	String	The protocol version.	Valid values: ipv4 DualStack
Ipv6AddressType	String	The IPv6 address type of the NLB instance.	Valid values: Internet: The instance uses a public IP address and can be accessed over the Internet. Intranet: The instance uses a private IP address and can be accessed only within its VPC.
LoadBalancerStatus	String	The status of the NLB instance.	Valid values: Inactive: The NLB instance is stopped. Listeners do not forward traffic. Active: The NLB instance is running. Provisioning: The NLB instance is being created. Configuring: The NLB instance configurations are being modified. Deleting: The NLB instance is being deleted. Deleted: The NLB instance is deleted.
LoadBalancerBusinessStatus	String	The business status of the NLB instance.	Valid values: Abnormal Normal
VpcId	String	The ID of the VPC in which the NLB instance resides.	None.
CreateTime	String	The time when the NLB instance was created.	The time follows ISO 8601 format: yyyy-MM-ddTHH:mm:ssZ (UTC).
ResourceGroupId	String	The ID of the resource group.	None.
DNSName	String	The domain name.	None.
BandwidthPackageId	String	The ID of the Internet Shared Bandwidth instance associated with the Internet-facing NLB instance.	None.
SecurityGroupIds	List	The security groups associated with the NLB instance.	[ "sg-bp67acfmxazb4p****" ]
CrossZoneEnabled	Boolean	Whether cross-zone load balancing is enabled for the NLB instance.	Valid values: true false
Tags	List	The tags.	Example: `[ { "Key" : "KeyTest", "Value" : "ValueTest" } ]`
PayType	String	The billing method of the NLB instance.	Only PostPay is returned, indicating pay-as-you-go billing.

Examples

YAML

ROSTemplateFormatVersion: '2015-09-01'
Parameters: {}
Resources:
  ExtensionDataSource:
    Type: DATASOURCE::NLB::LoadBalancers
    Properties:
      AddressIpVersion: ipv4
Outputs:
  LoadBalancerIds:
    Description: The list of load balancer IDs.
    Value:
      Fn::GetAtt:
        - ExtensionDataSource
        - LoadBalancerIds
  LoadBalancers:
    Description: The list of load balancers.
    Value:
      Fn::GetAtt:
        - ExtensionDataSource
        - LoadBalancers

JSON

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
  },
  "Resources": {
    "ExtensionDataSource": {
      "Type": "DATASOURCE::NLB::LoadBalancers",
      "Properties": {
        "AddressIpVersion": "ipv4"
      }
    }
  },
  "Outputs": {
    "LoadBalancerIds": {
      "Description": "The list of load balancer IDs.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "LoadBalancerIds"
        ]
      }
    },
    "LoadBalancers": {
      "Description": "The list of load balancers.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "LoadBalancers"
        ]
      }
    }
  }
}