All Products
Search
Document Center

Service Catalog:CreateProvisionedProductPlan

Last Updated:Jul 25, 2025

Creates a plan.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Authorization information

The following table shows the authorization information corresponding to the API. The authorization information can be used in the Action policy element to grant a RAM user or RAM role the permissions to call this API operation. Description:

  • Operation: the value that you can use in the Action element to specify the operation on a resource.
  • Access level: the access level of each operation. The levels are read, write, and list.
  • Resource type: the type of the resource on which you can authorize the RAM user or the RAM role to perform the operation. Take note of the following items:
    • For mandatory resource types, indicate with a prefix of * .
    • If the permissions cannot be granted at the resource level, All Resources is used in the Resource type column of the operation.
  • Condition Key: the condition key that is defined by the cloud service.
  • Associated operation: other operations that the RAM user or the RAM role must have permissions to perform to complete the operation. To complete the operation, the RAM user or the RAM role must have the permissions to perform the associated operations.
OperationAccess levelResource typeCondition keyAssociated operation
servicecatalog:CreateProvisionedProductPlancreate
*All Resources
*
  • servicecatalog:UserLevel
none

Request parameters

ParameterTypeRequiredDescriptionExample
PlanNamestringYes

The plan name.

The value must be 1 to 128 characters in length.

DEMO-ECS instance
PlanTypestringYes

The plan type.

Set the value to Ros, which specifies Resource Orchestration Service (ROS).

Ros
ProvisionedProductNamestringYes

The product instance name.

The value must be 1 to 128 characters in length.

DEMO-ECS instance
PortfolioIdstringNo

The product portfolio ID.

Note If PortfolioId is not required, you do not need to specify PortfolioId. If PortfolioId is required, you must specify PortfolioId. For more information about how to obtain the value of PortfolioId, see ListLaunchOptions .
port-bp1yt7582g****
ProductIdstringYes

The product ID.

prod-bp18r7q127****
ProductVersionIdstringYes

The product version ID.

pv-bp15e79d26****
Parametersarray<object>No

An array that consists of the parameters in the template.

You can specify up to 200 parameters.

Note If you specify Parameters, you must specify ParameterKey and ParameterValue.
objectNo
ParameterKeystringNo

The name of the parameter in the template.

instance_type
ParameterValuestringNo

The value of the parameter in the template.

ecs.s6-c1m1.small
StackRegionIdstringYes

The ID of the region to which the ROS stack belongs.

For more information about how to obtain the regions that are supported by ROS, see DescribeRegions .

cn-hangzhou
Tagsarray<object>No

An array that consists of custom tags.

Maximum value of N: 20.

Note
  • If you specify Tags, you must specify Tags.N.Key and Tags.N.Value.
  • The tag of a stack is propagated to each resource that supports the tag feature in the stack.
objectNo
KeystringNo

The key of the custom tag.

The key can be up to 128 characters in length, and cannot start with acs: or aliyun. The tag key cannot contain http:// or https://.

k1
ValuestringNo

The value of the custom tag.

The value can be up to 128 characters in length, and cannot start with acs:. The tag value cannot contain http:// or https://.

v1
OperationTypestringNo

The type of the operation that you want the plan to perform. Valid values:

  • LaunchProduct: launches the product. This is the default value.
  • UpdateProvisionedProduct: updates the information about the product instance.
  • TerminateProvisionedProduct: terminates the product instance.
LaunchProduct
DescriptionstringNo

The description of the plan.

The value must be 1 to 128 characters in length.

Create an ECS instance.

Response parameters

ParameterTypeDescriptionExample
object

The response parameters.

RequestIdstring

The request ID.

0FEEF92D-4052-5202-87D0-3D8EC16F81BF
PlanIdstring

The plan ID.

plan-bp1jvmdk2k****
ProvisionedProductIdstring

The product instance ID.

pp-bp1ddg1n2a****

Examples

Sample success responses

JSONformat

{
  "RequestId": "0FEEF92D-4052-5202-87D0-3D8EC16F81BF",
  "PlanId": "plan-bp1jvmdk2k****",
  "ProvisionedProductId": "pp-bp1ddg1n2a****"
}

Error codes

HTTP status codeError codeError message
500InternalErrorA system error occurred.

For a list of error codes, visit the Service error codes.