All Products
Search
Document Center

Cloud Architect Design Tools:ValuateTemplate

Last Updated:Mar 30, 2026

Retrieves the price of a template.

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

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

  • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

  • API: The API that you can call to perform the action.

  • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

  • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

    • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

    • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

  • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

  • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

bpstudio:ValuateTemplate

get

*Template

acs:bpstudio::{#accountId}:template/{#TemplateId}

None None

Request parameters

Parameter

Type

Required

Description

Example

TemplateId

string

Yes

The ID of the template.

0KSHPM6SJU03TNZP

ClientToken

string

Yes

A token that ensures the idempotency of the request.

1600765710019

AreaId

string

No

The ID of the region.

cn-hangzhou

Instances

array<object>

No

The list of instances to replace.

object

No

NodeType

string

No

The type of the instance.

ecs

NodeName

string

No

The name of the instance in the diagram.

ecs

Id

string

No

The ID of the instance.

vpc-bp1q56trhtaq40vlq5oj

ResourceGroupId

string

No

The ID of the resource group to which the application belongs.

rg-acfmyjt3c5om3fi

Variables

object

No

The variables for the template. If the template contains parameters, you can specify the parameter values. If you do not specify this parameter, default values are used.

any

No

Specifies the supported type.

${var1}

Response elements

Element

Type

Description

Example

object

Message

string

The error message.

Success

RequestId

string

The ID of the request.

847C9D0A-BABD-589C-8A9C-6464409EDED9

Data

object

The price inquiry results.

ResourceList

array<object>

The result set of the price inquiry.

array<object>

The result set.

NodeType

string

The type of the resource.

ecs

Error

string

The error message for the price inquiry.

InvalidSaleComponentFault : The request not refer to the correct order sale component.

TradePrice

number

The transaction price.

10.0

DiscountAmount

number

The discount amount.

73.0

OriginalPrice

number

The original price.

83.0

PromotionName

string

The promotional information.

PriceUnit

string

The pricing unit.

CNY / USD

PriceList

array<object>

The list of sub-prices.

object

The list of sub-prices.

NodeType

string

The type of the resource.

eip

ResourceId

string

The topology ID of the resource.

1687225092

Error

string

The error message.

ServiceUnavailable : The request has failed due to a temporary failure of the server.\r\nRequestId : 4AA302DB-3286-5589-8637-FF6D8507B7A9.

TradePrice

number

The transaction price.

0.01

DiscountAmount

number

The discount amount for the order.

82.99

OriginalPrice

number

The original price.

83.0

PromotionName

string

The promotional information.

PriceUnit

string

The pricing unit.

CNY / USD

Type

string

Indicates whether the resource is a new purchase.
1: New purchase
2: Existing
0: Not included in the price







"1"

Code

string

The status code.

200

Examples

Success response

JSON format

{
  "Message": "Success",
  "RequestId": "847C9D0A-BABD-589C-8A9C-6464409EDED9",
  "Data": {
    "ResourceList": [
      {
        "NodeType": "ecs",
        "Error": "InvalidSaleComponentFault : The request not refer to the correct order sale component.",
        "TradePrice": 10,
        "DiscountAmount": 73,
        "OriginalPrice": 83,
        "PromotionName": "",
        "PriceUnit": "CNY / USD",
        "PriceList": [
          {
            "NodeType": "eip",
            "ResourceId": "1687225092",
            "Error": "ServiceUnavailable : The request has failed due to a temporary failure of the server.\\r\\nRequestId : 4AA302DB-3286-5589-8637-FF6D8507B7A9.",
            "TradePrice": 0.01,
            "DiscountAmount": 82.99,
            "OriginalPrice": 83,
            "PromotionName": "",
            "PriceUnit": "CNY / USD\n",
            "Type": "\"1\""
          }
        ]
      }
    ]
  },
  "Code": "200"
}

Error codes

HTTP status code

Error code

Error message

Description

200 Success The transaction is successful.
400 ParameterEmpty You must specify the request parameter. You must specify request parameters.
400 bp.java.8004 No permissions.
400 bp.java.appNameNotNull Application name cannot be repeated.
400 bp.java.nopower No permissions.
400 bp.java.nopowerContact You do not have permission to use this function. Please contact the main account or permission administrator to authorize the relevant permissions.
400 bp.java.tempNameNotNull Application name cannot be repeated.
400 bp.java.userNotExist The user does not exist. The current user does not authenticate AliCloud with his real name.
500 bp.java.notDelete This template has been shared with other users and cannot be deleted.
500 bp.java.serviceError The server is abnormal. Please try again later.
404 EntityNotExist.ResourceGroup The resource group does not exist.
404 EntityNotExist.ResourceId The resource does not exist.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.