All Products
Search
Document Center

Resource Orchestration Service:DATASOURCE::MSE::Clusters

Last Updated:Jun 16, 2026

Queries Microservices Registry (MSE) clusters.

Syntax

{
  "Type": "DATASOURCE::MSE::Clusters",
  "Properties": {
    "ClusterAliasName": String,
    "RefreshOptions": String
  }
}

Properties

Property

Type

Required

Editable

Description

Constraint

ClusterAliasName

String

No

Yes

The cluster name.

Fuzzy match is supported.

RefreshOptions

String

No

Yes

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

Valid values:

  • Never (default): Data source resources are not refreshed when the stack is updated.

  • Always: Data source resources are refreshed when the stack is updated.

Return values (Fn::GetAtt)

  • ClusterIds: the IDs of the clusters.

  • Clusters: details of the clusters.

Property

Type

Description

Constraint

ClusterIds

List

The IDs of the clusters.

None.

Clusters

List

Details of the clusters.

None.

ClusterId

String

The cluster ID.

None.

ClusterName

String

The cluster name.

None.

ClusterAliasName

String

The alias of the cluster.

None.

InstanceId

String

The instance ID.

None.

AppVersion

String

The application version.

None.

VersionCode

String

The cluster version.

None.

InstanceCount

Number

The number of clusters.

None.

IntranetAddress

String

The private IP address.

None.

CanUpdate

Boolean

Indicates whether the cluster can be updated.

Valid values:

  • true

  • false

ChargeType

String

The billing method.

Valid values:

  • PrePaid: subscription

  • PostPaid: pay-as-you-go

InitStatus

String

The initialization status.

None.

InternetAddress

String

The public IP address.

None.

IntranetDomain

String

The private domain name.

None.

CreateTime

String

The cluster creation time.

The time is in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time is displayed in UTC.

EndDate

String

The cluster expiration time.

The time is in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time is displayed in UTC.

Examples

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "ClusterAliasName": {
      "Type": "String",
      "Description": "The alias name of cluster."
    }
  },
  "Resources": {
    "Clusters": {
      "Type": "DATASOURCE::MSE::Clusters",
      "Properties": {
        "ClusterAliasName": {
          "Ref": "ClusterAliasName"
        }
      }
    }
  },
  "Outputs": {
    "Clusters": {
      "Description": "The list of clusters.",
      "Value": {
        "Fn::GetAtt": [
          "Clusters",
          "Clusters"
        ]
      }
    },
    "ClusterIds": {
      "Description": "The list of cluster IDs.",
      "Value": {
        "Fn::GetAtt": [
          "Clusters",
          "ClusterIds"
        ]
      }
    }
  }
}
ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  ClusterAliasName:
    Type: String
    Description: The alias name of cluster.
Resources:
  Clusters:
    Type: DATASOURCE::MSE::Clusters
    Properties:
      ClusterAliasName:
        Ref: ClusterAliasName
Outputs:
  Clusters:
    Description: The list of clusters.
    Value:
      Fn::GetAtt:
        - Clusters
        - Clusters
  ClusterIds:
    Description: The list of cluster IDs.
    Value:
      Fn::GetAtt:
        - Clusters
        - ClusterIds