# Alibaba Cloud Computing Nest API

> Alibaba Cloud Computing Nest API on Apizie: 66 endpoints (Cancels a service usage request, Changes the resource group for a cloud resource, Performs a precheck to verify that a service instance can be deployed, If a service instance fails to deploy, you can call the ContinueDeployServiceInstance operation to resume…, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://zieapi.vercel.app/v1/cloud:aliyun-computenest/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:aliyun-computenest`
- Category: Cloud
- Status: byok
- Source: https://api.alibabacloud.com/product/computenest
- Page: https://zieapi.vercel.app/api/cloud/aliyun-computenest
- OpenAPI: https://zieapi.vercel.app/api/cloud/aliyun-computenest/openapi.json

Alibaba Cloud OpenAPI for Computing Nest (computenest, version 2021-06-01). Calls are signed with ACS3-HMAC-SHA256 using your AccessKey ID and secret.

## Endpoints

### Cancels a service usage request
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/cancel-service-usage` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| ServiceId | string | yes | The service ID |
| ClientToken | string | no | A client-generated token that ensures the idempotence of the request. The token must be unique for each request. It can contain only ASCII… |
| NeedDelete | string | no | Specifies whether to delete the request. If you delete the request, you must submit a new one |
| RegionId | string | no | The region ID |

### Changes the resource group for a cloud resource
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/change-resource-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| RegionId | string | no | The region ID |
| ResourceId | string | no | The ID of the cloud resource whose resource group you want to change |
| NewResourceGroupId | string | no | The ID of the destination resource group. You can obtain the resource group ID from the Resource Management console… |
| ResourceType | string | no | The resource type. Valid values: service: The resource is a service. serviceinstance: The resource is a service instance |

### Performs a precheck to verify that a service instance can be deployed
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/check-service-deployable` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| RegionId | string | no | The region ID |
| ServiceId | string | yes | The service ID |
| TrialType | string | no | The trial type. Valid values: Trial: The service supports trial use. NotTrial: The service does not support trial use |
| PrePaidAmount | string | no | The total upfront payment amount |
| PostPaidAmount | string | no | The total pay-as-you-go amount |
| TemplateName | string | no | The template name |
| ServiceVersion | string | no | The service version |

### If a service instance fails to deploy, you can call the ContinueDeployServiceInstance operation to resume…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/continue-deploy-service-instance` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| ClientToken | string | no | A client token that is used to ensure the idempotence of the request. Generate a unique value for this parameter from your client. The… |
| ServiceInstanceId | string | yes | The ID of the service instance |
| RegionId | string | yes | The region ID |
| Parameters | string | no | The configuration parameters of the service instance |
| DryRun | string | no | Specifies whether to perform a dry run. A dry run checks items such as permissions and the instance status. Valid values: true: performs a… |
| Option | string | no | The recreation options (JSON-encoded) |

### Creates a backup for a Compute Nest service instance
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/create-backup` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| Description | string | no | The backup description |
| ServiceInstanceId | string | yes | The ID of the service instance to back up |

### Creates a restore job
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/create-restore-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| ServiceInstanceId | string | yes | The ID of the service instance. Call the https://help.aliyun.com/document_detail/396200.html operation to obtain the service instance ID |
| BackupId | string | yes | The backup ID |

### Creates and deploys a service instance in Compute Nest by specifying parameters such as a region ID, a…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/create-service-instance` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID. Valid values: cn-hangzhou: China (Hangzhou). ap-southeast-1: Singapore |
| Name | string | no | The name of the service instance. The name must meet the following requirements: The name can be up to 64 characters in length. It must… |
| ServiceId | string | yes | The service ID |
| ServiceVersion | string | no | The service version |
| Parameters | string | no | The parameters for deploying the user instance. If the service instance contains deployment region information, you must specify the… |
| ClientToken | string | no | A client-generated, unique token that ensures the idempotence of the request. The token can contain only ASCII characters and cannot… |
| EnableInstanceOps | string | no | Indicates whether the service instance has the O\&M feature. Valid values: true: The service instance has the O\&M feature. false: The… |
| TemplateName | string | no | The template name. You must specify this parameter if the service supports multiple templates |
| OperationMetadata | string | no | The O\&M configuration (JSON-encoded) |
| ResourceGroupId | string | no | The resource group ID |
| ContactGroup | string | no | The CloudMonitor alert contact group that receives alerts |
| TrialType | string | no | The type of the service instance. Valid values: Trial: The service instance supports trial. NotTrial: The service instance does not… |
| Tag | string | no | The custom tags (JSON-encoded) |
| SpecificationName | string | no | The name of the specification package |
| DryRun | string | no | Indicates whether to perform a dry run for the request. The dry run checks for permissions and instance status. Valid values: true: Sends… |
| SpecificationCode | string | no | The commodity specification code |
| EnableUserPrometheus | string | no | Indicates whether to enable Prometheus monitoring. Valid values: true: Enable. false: Disable |
| Commodity | string | no | The information about the Alibaba Cloud Marketplace purchase order. You do not need to specify this parameter if the service is not listed… |
| ResourceAutoPay | string | no | Indicates whether to automatically deduct the payment from your account balance. Valid values: true: Enable automatic payment. false:… |
| ServiceInstanceId | string | no | The ID of the service instance to convert to a paid instance |

### Creates a service usage request
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/create-service-usage` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| ServiceId | string | yes | The service ID |
| ClientToken | string | no | A client token to ensure the idempotence of the request. The value is generated by the client and must be unique for each request. The… |
| UserInformation | string | no | The request information (JSON-encoded) |
| RegionId | string | no | The region ID |

### Creates a Skill
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/create-skill` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| SkillName | string | no | The Skill name |
| SkillDisplayName | string | no | The SkillDisplayName |
| SkillLabels | string | no | The set of Skill labels (JSON-encoded) |
| RequiredConnections | string | no | The set of connection types that the Skill depends on (JSON-encoded) |
| SkillDescription | string | no | The Skill description |
| SkillSpaceId | string | yes | The ID of the SkillSpace to which the Skill belongs |
| SourceType | string | yes | The source type for creating the Skill |
| SourceSkillId | string | no | The public Skill ID. This parameter is required when SourceType is set to COPY |
| OssUrl | string | no | The OSS URL of the Skill package to upload. This parameter is required when SourceType is set to UPLOAD |
| ClientToken | string | no | The client token that is used to ensure the idempotence of the request. You can use the client to generate the token, but you must make… |

### Creates a Skill file detection task
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/create-skill-file-detect` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| OssUrl | string | yes | The OSS URL of the Skill compressed file to be detected |
| ClientToken | string | no | The client token that is used to ensure the idempotence of the request. You can use the client to generate the token, but make sure that… |
| RegionId | string | no | The region ID |

### Creates a SkillHub config
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/create-skill-hub-config` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| OssBucketName | string | yes | The name of the Object Storage Service (OSS) bucket |
| OssRegionId | string | yes | The region ID of the OSS bucket. For more information, see https://help.aliyun.com/document_detail/31837.html |
| ClientToken | string | no | A client-generated token to ensure request idempotence. This value must be unique for each request. ClientToken must contain only ASCII… |

### Creates a SkillSpace
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/create-skill-space` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| SkillSpaceName | string | yes | The name of the SkillSpace |
| SkillSpaceDescription | string | yes | The description of the SkillSpace |
| ClientToken | string | no | The client token that is used to ensure the idempotence of the request. You can use the client to generate the token, but make sure that… |

### Deletes a Compute Nest instance backup
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/delete-backup` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| BackupId | string | yes | The backup ID |

### Deletes the specified service instances in a region
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/delete-service-instances` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| ClientToken | string | no | The client token that is used to ensure the idempotence of the request. Make sure that the token is unique for each request. The… |
| RegionId | string | yes | The region ID |
| ServiceInstanceId | string | yes | The IDs of the service instances (JSON-encoded) |

### Deletes a Skill
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/delete-skill` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| SkillId | string | yes | Skill ID |
| ClientToken | string | no | Ensures the idempotence of the request. Generate a value from your client that is unique across different requests. ClientToken supports… |

### Deletes a Skill workspace
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/delete-skill-space` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| SkillSpaceId | string | yes | SkillSpace ID |
| ClientToken | string | no | Ensures the idempotence of the request. Generate a parameter value from your client to ensure that the value is unique across different… |

### Deploys a service instance
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/deploy-service-instance` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| ClientToken | string | no | A client token to ensure the idempotence of a request. Generate a unique value from the client for this parameter. The token can contain… |
| ServiceInstanceId | string | yes | The ID of the service instance |
| RegionId | string | yes | The region ID. Possible values: cn-hangzhou: China (Hangzhou). ap-southeast-1: Singapore |

### Queries the available regions
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/describe-regions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| RegionId | string | no | The region ID |

### Queries the missing access policies before creating a service instance
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/generate-service-policy` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| ServiceId | string | yes | The service ID |
| RegionId | string | yes | The region ID |
| ServiceVersion | string | no | The service version |
| TemplateName | string | no | The template name |
| TrialType | string | no | The trial type. Default value: NotTrial. Valid values: Trial: Trial is supported. NotTrial: Trial is not supported |
| OperationTypes | string | no | The operation types for which policy information needs to be generated (JSON-encoded) |
| Parameters | string | no | The parameters required to check the deployment permissions of the service instance (JSON-encoded) |

### Retrieves the details of a backup
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/get-backup` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| BackupId | string | yes | The backup ID |

### Returns a list of available zones for a specified region
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/get-network-available-zones` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| PrivateVpcConnectionMode | string | no | The connection mode. Valid values: \`PrivateLink\` and \`OverlayLink\`. \`OverlayLink\` is an overlay link based on Application-aware… |
| ZoneId | string | no | The zone for the service deployment |
| NetworkRegionId | string | no | The region of the virtual network |
| ServiceInstanceEndpointServiceType | string | no | The direction of the internal-facing access. Valid values: \`Forward\` and \`Reverse\` |
| ServiceRegionId | string | no | The ID of the region where the service is located |
| IsPoc | string | no | Specifies whether the service is a trial |
| ServiceId | string | no | The service ID |
| ServiceVersion | string | no | The service version |

### Retrieves the details of a specified service
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/get-service` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| RegionId | string | no | The region ID |
| ServiceId | string | no | The service ID |
| ServiceVersion | string | no | The service version |
| ShowDetails | string | no | Specifies whether to return the detailed information of the service (JSON-encoded) |
| ServiceName | string | no | The service name |
| ServiceInstanceId | string | no | The service instance ID |

### Queries the estimated cost of creating a service instance
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/get-service-estimate-cost` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| RegionId | string | no | The region ID |
| ServiceId | string | yes | The service ID |
| ServiceVersion | string | no | The service version |
| TemplateName | string | no | The template name |
| Parameters | string | no | The parameters to deploy the service instance (JSON-encoded) |
| ClientToken | string | no | A client token to ensure the idempotence of the request. Generate a unique value for each request. The ClientToken supports only ASCII… |
| TrialType | string | no | The usage type. Valid values: Trial: The service supports a free trial. NotTrial: The service does not support a free trial |
| SpecificationName | string | no | The specification name |
| ServiceInstanceId | string | no | The service instance ID |
| Commodity | string | no | The subscription period for the purchase order (JSON-encoded) |
| OperationName | string | no | The name of the upgrade or downgrade operation |

### Queries the details of a service instance by its region ID, service instance ID, or Alibaba Cloud…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/get-service-instance` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| ServiceInstanceId | string | no | The service instance ID. You must specify either `ServiceInstanceId` or `MarketInstanceId` to query the detailed information about the… |
| RegionId | string | yes | The region ID |
| MarketInstanceId | string | no | The Alibaba Cloud Marketplace instance ID |

### Queries the estimated renewal cost of subscription resources in a privately deployed service instance. You…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/get-service-instance-subscription-estimate-cost` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| RegionId | string | no | The region ID |
| ServiceInstanceId | string | yes | The service instance ID |
| OrderType | string | yes | The order type. Valid value: Renewal |
| PeriodUnit | string | no | The unit of the renewal duration for all subscription resources of the service instance. This is the unit for the Period parameter. Valid… |
| ClientToken | string | no | A client-generated token that ensures the idempotence of the request. The token must be unique for each request. It can contain only ASCII… |
| Period | integer | no | The renewal duration for all subscription resources of the service instance. The unit is specified by PeriodUnit |
| ResourcePeriod | string | no | The renewal configuration for the resources (JSON-encoded) |

### Retrieves the provisions of a service, such as its activation status and service roles
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/get-service-provisions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| RegionId | string | no | The region ID |
| ServiceId | string | yes | The service ID |
| ServiceVersion | string | no | The service version |
| TemplateName | string | no | The template name |
| TrialType | string | no | The usage type. Valid values: Trial: The service supports trial use. NotTrial: The service does not support trial use |
| Parameters | string | no | The parameters for deploying the user instance (JSON-encoded) |

### Queries the parameter constraints for a Resource Orchestration Service (ROS) template in a specified region…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/get-service-template-parameter-constraints` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ServiceId | string | yes | The service ID |
| ServiceVersion | string | no | The service version |
| TemplateName | string | yes | The template name |
| Parameters | string | no | The configuration parameters of the service instance (JSON-encoded) |
| ClientToken | string | no | The client token that is used to ensure the idempotence of the request. Generate a unique value from your client for each request. The… |
| DeployRegionId | string | yes | The deployment region ID |
| TrialType | string | no | The usage type. Valid values: Trial: The service supports a trial. NotTrial: The service does not support a trial |
| SpecificationName | string | no | The specification name |
| ServiceInstanceId | string | no | The service instance ID |
| EnablePrivateVpcConnection | string | no | Indicates whether PrivateLink is enabled. Valid values: true: enabled false: disabled |

### Queries the details of a Skill
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/get-skill` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| SkillId | string | yes | The unique ID of the Skill |

### Retrieves the result of a Skill file detection task
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/get-skill-file-detect-result` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| HashKey | string | yes | The unique identifier for the detection task |
| RegionId | string | no | The region ID |

### Retrieves the SkillHub configuration
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/get-skill-hub-config` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |

### Queries the details of a SkillSpace
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/get-skill-space` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| SkillSpaceId | string | yes | SkillSpace ID |

### Queries user information
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/get-user-information` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |

### Queries a list of backups for Compute Nest service instances
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/list-backups` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| MaxResults | integer | no | The number of entries per page |
| NextToken | string | no | The token that is used to start the next query |
| Filter | string | no | The filter (JSON-encoded) |

### Retrieves a list of access policies
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/list-policies` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| MaxResults | integer | no | The number of entries to return on each page |
| NextToken | string | no | The token that is used to retrieve the next page of results. If this parameter is empty, no more results exist |
| RegionId | string | no | The region ID |

### Queries the list of public skills
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/list-public-skills` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| Filter | string | no | The filter (JSON-encoded) |
| NextToken | string | no | The token for the next query |
| MaxResults | integer | no | The number of entries per page |
| NeedDownloadUrl | string | no | Specifies whether to include the download URL for the skill package |

### Queries a list of restore jobs
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/list-restore-tasks` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| MaxResults | integer | no | The number of entries to return on each page. Maximum value: 100. Default value: 20 |
| NextToken | string | no | The token that is used to retrieve the next page of results |
| Filter | string | no | The filter (JSON-encoded) |

### Lists the available service categories
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/list-service-categories` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |

### Call the ListServiceInstanceBill operation to query bills for service instances
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/list-service-instance-bill` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| MaxResults | integer | no | The number of entries to return on each page. Maximum value: 100. Default value: 20 |
| NextToken | string | no | The token that is used to retrieve the next page of results |
| ServiceInstanceId | string | no | The ID of the service instance |
| BillingCycle | string | yes | The billing cycle in YYYY-MM format. Only billing cycles in the last 18 months are supported |
| Granularity | string | no | The granularity of the bills to query. Valid values: MONTHLY: monthly. The data is consistent with the bills aggregated by billing cycle… |
| BillingDate | string | no | The billing date. This parameter is required only when Granularity is set to DAILY. The format is YYYY-MM-DD |

### Retrieves the deployment and upgrade logs of a service instance
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/list-service-instance-logs` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| MaxResults | integer | no | The number of entries per page. Maximum value: 100. Default value: 20 |
| NextToken | string | no | The token that is used to retrieve the next page of results. Set this to the NextToken value that was returned in the last response |
| ServiceInstanceId | string | yes | The service instance ID |
| LogSource | string | no | The log source. Valid values: computeNest (default): The deployment and upgrade logs of the service instance. application: The logs… |
| Logstore | string | no | The Logstore. This parameter is required when you query application logs |
| Filter | string | no | The filter (JSON-encoded) |
| SortOrder | string | no | The sort order. Valid values: Ascending: Ascending order. Descending (default): Descending order |

### Queries the resources of a service instance based on parameters such as the service instance ID, Alibaba…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/list-service-instance-resources` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| MaxResults | integer | no | The number of entries to return on each page. Maximum value: 100. Default value: 20 |
| NextToken | string | no | The token that is used to retrieve the next page of results. Set this to the NextToken value from a previous API call |
| ServiceInstanceId | string | yes | The ID of the service instance |
| Tag | string | no | The resource tags (JSON-encoded) |
| RegionId | string | no | The region ID |
| ServiceInstanceResourceType | string | no | The resource type of the service instance. Valid values: AliyunResource: an Alibaba Cloud resource. ContainerResource: a container group… |
| Filters | string | no | The filter conditions. Valid values: ExpireTimeStart: The start of the time range to query the expiration time of subscription resources.… |

### You can call ListServiceInstanceUpgradeHistory to query the upgrade history of a service instance
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/list-service-instance-upgrade-history` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| MaxResults | integer | no | The number of entries to return on each page. Maximum value: 100. Default value: 20 |
| NextToken | string | no | The token to retrieve the next page of results. Do not specify this parameter for the first request. For subsequent requests, specify the… |
| ServiceInstanceId | string | yes | The ID of the service instance |

### Queries service instances for your account in a specified region
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/list-service-instances` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| MaxResults | integer | no | The number of entries to return on each page. Maximum value: 100. Default value: 20 |
| NextToken | string | no | The query token. Set it to the NextToken value returned from the previous API call |
| Filter | string | no | The filter (JSON-encoded) |
| Tag | string | no | The custom tags (JSON-encoded) |
| ResourceGroupId | string | no | The resource group ID |

### Queries your service usages
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/list-service-usages` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| MaxResults | integer | no | The number of entries to return on each page. Maximum value: 100. Default value: 20 |
| NextToken | string | no | The token that is used to retrieve the next page of results. This value is the NextToken value returned from the previous API call |
| Filter | string | no | The filter (JSON-encoded) |
| RegionId | string | no | The region ID |

### Queries information about your services
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/list-services` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| MaxResults | integer | no | The number of entries to return on each page. Maximum value: 100. Default value: 20 |
| NextToken | string | no | The token that is used to retrieve the next page of results. Set this to the NextToken value returned from the previous API call |
| Filter | string | no | The filter (JSON-encoded) |
| InUsed | string | no | Specifies whether the service is in use. Valid values: false: The service is not in use. true: The service is in use |
| Tag | string | no | The custom tags (JSON-encoded) |
| FuzzyKeyword | string | no | The keyword for a fuzzy query |
| ServiceAccessType | string | no | The service access type |
| OrderByType | string | no | The sorting type for services |

### Retrieves the list of skill files
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/list-skill-files` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| SkillId | string | yes | Skill ID |
| Filter | string | no | The filter (JSON-encoded) |
| NextToken | string | no | The pagination token for the next query |
| MaxResults | integer | no | The number of entries per page in a paging query. Maximum value: 100. Default value: 20 |

### Queries a list of SkillSpaces
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/list-skill-spaces` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| Filter | string | no | The filter (JSON-encoded) |
| NextToken | string | no | The pagination token. Set this parameter to the value of NextToken that was returned in the previous API call |
| MaxResults | integer | no | The number of entries per page in a paging query. Maximum value: 100. Default value: 20 |

### Queries a list of Skills
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/list-skills` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| Filter | string | no | The filter (JSON-encoded) |
| NextToken | string | no | NextToken |
| MaxResults | integer | no | The maximum number of entries to return in this request |
| NeedDownloadUrl | string | no | Specifies whether to include the download URL for the Skill package |

### This operation lists existing tag keys
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/list-tag-keys` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| NextToken | string | no | The token to start the next query |
| ResourceType | string | yes | The resource type. Valid values: service: service. serviceinstance: service instance. artifact: artifact. dataset: dataset |

### Queries a list of tagged resources
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/list-tag-resources` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID of the resource |
| NextToken | string | no | The token to retrieve the next page of results. Set this parameter to the \`NextToken\` value from the previous API call |
| ResourceType | string | yes | The resource type. Valid values: service: a service. serviceinstance: a service instance. artifact: an artifact |
| Tag | string | no | A list of tags (JSON-encoded) |
| ResourceId | string | no | The resource IDs. You can specify up to 50 resource IDs (JSON-encoded) |

### Lists the tag values for a specified tag key
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/list-tag-values` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| NextToken | string | no | The token that is used to start the next query |
| ResourceType | string | yes | The resource type. Valid values: service: service. serviceinstance: service instance. artifact: deployment. dataset: dataset |
| Key | string | yes | The tag key |

### Renews a service instance
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/renew-service-instance` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| DryRun | string | no | Specifies whether to perform a dry run of the renewal request, including permission and instance status checks. Valid values: true: Sends… |
| ServiceInstanceId | string | no | The service instance ID |

### Renews the subscription resources for a private deployment service instance. This operation supports two…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/renew-service-instance-resources` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| RegionId | string | no | The region ID |
| ServiceInstanceId | string | yes | The service instance ID |
| PeriodUnit | string | no | The time unit of the renewal duration for all subscription resources in the service instance. This parameter specifies the unit for… |
| ClientToken | string | no | A client token to ensure that the request is idempotent. Generate a unique value for this parameter from your client for each request. The… |
| Period | integer | no | The renewal duration for all subscription resources in the service instance. The unit is specified by \`PeriodUnit\` |
| ResourcePeriod | string | no | The list of resource renewals (JSON-encoded) |

### Restarts a service instance in the Deployed state
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/restart-service-instance` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| ClientToken | string | no | A client token to ensure the idempotence of the request. The token must be unique for each request. The token can contain only ASCII… |
| RegionId | string | yes | The region ID of the service instance |
| ServiceInstanceId | string | yes | The ID of the service instance. Call the https://help.aliyun.com/document_detail/396200.html operation to obtain the service instance ID |

### Rolls back an upgraded service instance
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/rollback-service-instance` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| RegionId | string | no | The region ID |
| ServiceInstanceId | string | no | The service instance ID |
| ClientToken | string | no | A client token to ensure request idempotence. Generate a unique value for this parameter from your client. ClientToken supports only ASCII… |

### Call the StartServiceInstance operation to start a service instance that is in the Stopped or StartFailed…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/start-service-instance` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| ClientToken | string | no | A client token to ensure the idempotence of the request. Generate a unique value on your client. This value can contain only ASCII… |
| RegionId | string | yes | The ID of the region where the service instance resides |
| ServiceInstanceId | string | yes | The ID of the service instance. Call the https://help.aliyun.com/document_detail/396200.html operation to obtain the service instance ID |

### Call the StopServiceInstance operation to shut down a service instance that is in the Deployed or StopFailed…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/stop-service-instance` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| ClientToken | string | no | A client token to ensure the idempotence of the request. Generate a unique token for each request. The token can contain only ASCII… |
| RegionId | string | yes | The ID of the region where the service instance resides |
| ServiceInstanceId | string | yes | The ID of the service instance. Call the https://help.aliyun.com/document_detail/396200.html operation to obtain the service instance ID |

### You can call TagResources to create and attach tags to multiple resources
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/tag-resources` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| Tag | string | no | The resource tags (JSON-encoded) |
| ResourceType | string | yes | The resource type. Valid values: service: a service. serviceinstance: a service instance. artifact: a deployment. dataset: a dataset |
| ResourceId | string | yes | The resource IDs (JSON-encoded) |

### Detaches tags from specified resources
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/un-tag-resources` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ResourceType | string | yes | The resource type. Valid values: service: A service. serviceinstance: A service instance. artifact: An artifact. dataset: A dataset |
| ResourceId | string | yes | The resource IDs (JSON-encoded) |
| All | string | no | Specifies whether to remove all tags from the resources. This parameter is valid only when \`TagKey\` is not specified. The default value… |
| TagKey | string | no | The tag keys of the resources (JSON-encoded) |

### Updates the attributes of a service instance
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/update-service-instance-attributes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ServiceInstanceId | string | yes | The ID of the service instance. Call the https://help.aliyun.com/document_detail/396200.html operation to obtain the service instance ID |
| EnableOperation | string | no | Specifies whether to enable managed O\&M |
| GrantedPermission | string | no | The GrantedPermission (JSON-encoded) |

### You can call the UpdateServiceInstanceSpec operation to upgrade or downgrade a service instance if its…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/update-service-instance-spec` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| ServiceInstanceId | string | yes | The ID of the service instance. Call the https://help.aliyun.com/document_detail/396200.html operation to obtain the service instance ID |
| PredefinedParametersName | string | no | The name of the service instance package. Set this parameter if the service provider set Change Type to Package Change for the… |
| Parameters | string | no | The parameters for changing the service instance. Set this parameter if the service provider set Change Type to Parameter Change for the… |
| DryRun | string | no | Specifies whether to perform a dry run for the request. A dry run checks for issues such as permissions and instance status. Valid values:… |
| EnableUserPrometheus | string | no | Specifies whether to enable Prometheus monitoring. Valid values: true: Enables Prometheus monitoring. false: Disables Prometheus monitoring |
| OperationName | string | no | The name of the upgrade/downgrade operation. To obtain the name and content of the upgrade/downgrade operation, check the… |
| ClientToken | string | no | A client token to ensure the idempotence of the request. This token is generated by your client and must be unique for each request. The… |
| Commodity | string | no | The information about the Alibaba Cloud Marketplace purchase order. This parameter is not required if the service is not listed on Alibaba… |

### Updates the information about a service usage request
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/update-service-usage` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| ServiceId | string | yes | The service ID |
| ClientToken | string | no | A client token to ensure the idempotence of the request. Generate a unique value from your client for this parameter. ClientToken supports… |
| UserInformation | string | no | The user information (JSON-encoded) |
| RegionId | string | no | The region ID |

### Updates a skill
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/update-skill` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| SkillId | string | yes | The ID of the skill to update |
| SourceType | string | no | The source type for updating the skill |
| SourceSkillId | string | no | Required when SourceType is set to COPY. The ID of the public skill |
| OssUrl | string | no | Required when SourceType is set to UPLOAD. The OSS URL of the skill package to upload |
| SkillDescription | string | no | The description of the skill |
| SkillName | string | no | The name of the skill |
| SkillDisplayName | string | no | The SkillDisplayName |
| SkillLabels | string | no | The labels of the skill (JSON-encoded) |
| RequiredConnections | string | no | The collection of connection types required by the skill (JSON-encoded) |
| ClientToken | string | no | The client token that is used to ensure the idempotence of the request. You can use the client to generate the token, but you must make… |

### The UpdateUserInformation operation updates user information
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/update-user-information` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| DeliverySettings | string | no | The configurations to modify (JSON-encoded) |

### Upgrades a service instance to a new version
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/upgrade-service-instance` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| RegionId | string | no | The region ID |
| ServiceInstanceId | string | no | The service instance ID |
| ServiceVersion | string | no | The service version to upgrade to |
| Parameters | string | no | The parameters required for the upgrade. This is used when new parameters are added to the new service version (JSON-encoded) |
| ClientToken | string | no | A client-generated token that ensures the idempotence of the request. The token must be unique for each request. It can contain only ASCII… |
| DryRun | string | no | Specifies whether to perform a dry run. A dry run checks for issues such as permissions and the instance status. Valid values: true: Sends… |

### Validates the name of a service instance
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/validate-service-instance-name` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |
| ServiceId | string | yes | The service ID |
| ServiceVersion | string | no | The service version |
| ServiceInstanceName | string | yes | The name of the service instance |
| IsTrial | string | no | Specifies whether the service instance is a trial instance |
| TemplateName | string | no | The name of the template. Specify this parameter if the service supports multiple templates |
| ClientToken | string | no | A client token to ensure the idempotence of the request. Generate a unique token for each request. The ClientToken supports only ASCII… |

### version
`POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/version` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://computenest.ap-southeast-1.aliyuncs.com |

## Example
```
curl "https://zieapi.vercel.app/v1/cloud:aliyun-computenest/cancel-service-usage" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Alibaba Cloud Computing Nest API?
Create a free Apizie key, then send POST https://zieapi.vercel.app/v1/cloud:aliyun-computenest/cancel-service-usage with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Alibaba Cloud Computing Nest API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Alibaba Cloud Computing Nest itself also needs your own key from aliyuncs.com.

### Can AI agents use the Alibaba Cloud Computing Nest API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:aliyun-computenest.

### What is the status of the Alibaba Cloud Computing Nest API?
Needs your own provider key (bring your own key)