GetFeatureDetails - Resource Orchestration Service - Alibaba Cloud ドキュメントセンター

Queries the details of features that are supported by Resource Orchestration Service (ROS).

Operation description

You can call this operation to query the Terraform hosting, resource cleaner, and scenario features.

This topic provides an example on how to query the details of features supported by ROS in the China (Hangzhou) region. The details include Terraform versions, provider versions, and supported resource types.

Note

In the Examples section, only part of the sample code is provided.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact your account manager.

Request parameters

Parameter	Type	Required	Description	Example
Feature	string	Yes	The one or more features that you want to query. Valid values: Terraform: the Terraform hosting feature. ResourceCleaner: the resource cleaner feature. You can use ALIYUN::ROS::ResourceCleaner to create a resource cleaner. TemplateScratch: the scenario feature. All: all features that are supported by ROS.	Terraform
RegionId	string	Yes	The region ID of the stack. You can call the DescribeRegions operation to query the most recent region list.	cn-hangzhou

For more information about common request parameters, see Common parameters.

Response parameters

Parameter	Type	Description	Example
	object
RequestId	string	The ID of the request.	EBF833DA-D0E2-52BE-92E2-59CA56BE834E
Terraform	object	Details of the Terraform hosting feature.
SupportedVersions	array	The Terraform versions.
	object
ProviderVersions	array	The names and versions of the providers that correspond to the Terraform versions.
	object
ProviderName	string	The name of the provider.	alicloud
SupportedVersions	array	The provider versions.
	string	The provider version.	1.121.2
TerraformVersion	string	The Terraform version.	1.0.11
Transform	string	The Terraform version that is supported by ROS. The parameter value is the same as the value of the Transform parameter in a Terraform template.	Aliyun::Terraform-v1.0
UpdateAllowedTransforms	array	The Terraform versions that can be updated in ROS.
	string	The Terraform version that can be updated in ROS.	Aliyun::Terraform-v1.1
SupportedResourceTypes	object	The resource types that support the scenario feature.
SystemTag	array	The resource types that support the system tag `acs:ros:stackId`.
	string	The resource types that support the system tag `acs:ros:stackId`.	alicloud_instance
CustomTag	array	The resource types that support the custom tag feature.
	string	The resource types that support the custom tag feature.	alicloud_instance
EstimateCost	array	The resource types that support the price inquiry feature.
	string	The resource types that support the price inquiry feature.	alicloud_instance
ResourceGroup	array	The resource types that support the resource group feature.
	string	The resource types that support the resource group feature.	alicloud_instance
StackOperationRisk	object	The resource type that support the risk check feature.
DeleteStack	array	The resource types that support the risk check performed to detect risks caused by a stack deletion operation.
	string	The resource types that support the risk check performed to detect risks caused by a stack deletion operation.	alicloud_instance
TemplateScratch	object	Details of the scenario feature.
SupportedResourceTypes	array	The resource types that are supported by the scenario feature.
	object	The resource types that support the scenario feature.
ResourceType	string	The resource type.	ALIYUN::ECS::Disk
SourceResourcesSupported	boolean	Indicates whether the resource scope can be specified by source resource. Valid values: true false	true
SourceTagSupported	boolean	Indicates whether the resource scope can be specified by source tag. Valid values: true false	true
SourceResourceGroupSupported	boolean	Indicates whether the resource scope can be specified by source resource group. Valid values: true false	true
SourceSupported	boolean	Indicates whether the resource scope can be specified by source tag, resource group, or resource. Valid values: true false	true
SupportedTemplateScratchTypes	array	The scenario types that are supported.
	string	The scenario type that is supported. Valid values: ArchitectureReplication: resource replication ArchitectureDetection: resource detection ResourceImport: resource management ResourceMigration: resource migration	ArchitectureReplication
ResourceCleaner	object	Details of the resource cleaner feature.
SupportedResourceTypes	array	The resource types that can be cleaned up.
	object	The resource types that can be cleaned up.
ResourceType	string	The resource type that supports the resource cleaner feature.	ECS:Instance
SupportedFilters	array	The names of the filters that are supported by the resource type.
	string	The name of the filter that is supported by the resource type. Valid values: RegionId ResourceId ResourceName Tags ResourceGroupId DeletionProtection	ResourceName
SideEffects	array	The names of the side effects that may be caused by the cleanup operation performed on the resources of the specified type.
	string	The name of the side effect that may be caused by the cleanup operation performed on the resources of the specified type. Only StopInstance may be returned, which indicates that instances related to the specified resource type are stopped.	StopInstance
TemplateParameterConstraints	object	Details of the template parameter constraint feature.
SupportedResourceTypes	array	The resource types that support the template parameter constraint feature.
	object	The resource types that support the template parameter constraint feature.
ResourceType	string	The resource type.	ALIYUN::ECS::Disk
Properties	array	The names of properties that are supported by the resource type.
	string	The name of the property that is supported by the resource type.	["DiskCategory", "ZoneId"]
DriftDetection	object	Details of the drift detection feature.
SupportedResourceTypes	array	The resource types that are supported by the drift detection feature.
	string	The resource types that are supported by the drift detection feature.	ALIYUN::ECS::Disk
ResourceImport	object	Details of the resource import feature.
SupportedResourceTypes	array	The resource types that are supported by the resource import feature.
	object
ResourceType	string	The resource type.	ALIYUN::ECS::Disk
ResourceIdentifiers	array	The resource identifiers.
	string	The resource identifier.	DiskId

Examples

Success response

JSON format

{
  "RequestId": "EBF833DA-D0E2-52BE-92E2-59CA56BE834E",
  "Terraform": {
    "SupportedVersions": [
      {
        "ProviderVersions": [
          {
            "ProviderName": "alicloud",
            "SupportedVersions": [
              "1.121.2"
            ]
          }
        ],
        "TerraformVersion": "1.0.11",
        "Transform": "Aliyun::Terraform-v1.0",
        "UpdateAllowedTransforms": [
          "Aliyun::Terraform-v1.1"
        ]
      }
    ],
    "SupportedResourceTypes": {
      "SystemTag": [
        "alicloud_instance"
      ],
      "CustomTag": [
        "alicloud_instance"
      ],
      "EstimateCost": [
        "alicloud_instance"
      ],
      "ResourceGroup": [
        "alicloud_instance"
      ],
      "StackOperationRisk": {
        "DeleteStack": [
          "alicloud_instance"
        ]
      }
    }
  },
  "TemplateScratch": {
    "SupportedResourceTypes": [
      {
        "ResourceType": "ALIYUN::ECS::Disk",
        "SourceResourcesSupported": true,
        "SourceTagSupported": true,
        "SourceResourceGroupSupported": true,
        "SourceSupported": true,
        "SupportedTemplateScratchTypes": [
          "ArchitectureReplication"
        ]
      }
    ]
  },
  "ResourceCleaner": {
    "SupportedResourceTypes": [
      {
        "ResourceType": "ECS:Instance",
        "SupportedFilters": [
          "ResourceName"
        ],
        "SideEffects": [
          "StopInstance"
        ]
      }
    ]
  },
  "TemplateParameterConstraints": {
    "SupportedResourceTypes": [
      {
        "ResourceType": "ALIYUN::ECS::Disk",
        "Properties": [
          "[\"DiskCategory\", \"ZoneId\"]"
        ]
      }
    ]
  },
  "DriftDetection": {
    "SupportedResourceTypes": [
      "ALIYUN::ECS::Disk"
    ]
  },
  "ResourceImport": {
    "SupportedResourceTypes": [
      {
        "ResourceType": "ALIYUN::ECS::Disk",
        "ResourceIdentifiers": [
          "DiskId"
        ]
      }
    ]
  }
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.