All Products
Search
Document Center

MaxCompute:GetQuotaPlan

Last Updated:Oct 24, 2024

Obtains the information of a quota 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

There is currently no authorization information disclosed in the API.

Request syntax

GET /api/v1/quotas/{nickname}/plans/{planName} HTTP/1.1

Request parameters

ParameterTypeRequiredDescriptionExample
nicknamestringYes

The name of the quota.

quotaA
planNamestringYes

The name of the quota plan.

planA
tenantIdstringNo

The ID of the tenant.

483212237127906
regionstringNo

The ID of the region.

cn-beijing

Response parameters

ParameterTypeDescriptionExample
object

PopResult

requestIdstring

The ID of the request.

0be3e0aa16667684362147582e038f
dataobject

The returned data.

namestring

The name of the quota plan.

planA
createTimestring

The time when the quota plan was created.

2022-05-16T06:07:45Z
quotaobject

The details of the quota.

idstring

The ID of the quota.

0
namestring

The name of the quota.

quota_a
nickNamestring

The alias of the quota.

quota_nickname
typestring

The type of the resource system. This parameter corresponds to the resourceSystemType parameter of the cluster.

FUXI_ONLINE
statusstring

The status of the resource.

ON
tenantIdstring

The ID of the tenant.

478403690625249
regionIdstring

The ID of the region.

cn-beijing
parentIdstring

The ID of the parent resource.

null
clusterstring

The ID of the cluster.

AT-120N
versionstring

The version number.

1
billingPolicyobject

The information of the order.

odpsSpecCodestring

The specifications of the order.

OdpsStandard
orderIdstring

The ID of the order.

45245678
billingMethodstring

The billing method of the quota. Valid values:

  • subscription: a subscription quota.
  • payasyougo: a pay-as-you-go quota.
subscription
scheduleInfoobject

The information of the scheduling plan.

currPlanstring

The quota plan that takes effect based on the scheduling plan.

planA
currTimestring

The time when the current quota plan is scheduled.

0800
nextPlanstring

The next quota plan that will take effect based on the scheduling plan.

planB
nextTimestring

The time when the next quota plan is scheduled.

1700
oncePlanstring

If the quota plan that immediately takes effect is different from the current quota plan, this parameter is not empty.

planC
onceTimestring

The time when the quota plan immediately takes effect.

1500
operatorNamestring

The name of the operator.

userA
parameterobject

The description of the quota.

tagstring

The tag of the resource for the quota.

abc
createTimelong

The time when the quota plan was created.

2022-09-06T02:14:44Z
creatorIdstring

The ID of the Alibaba Cloud account that is used to create the resource.

672863518
subQuotaInfoListarray<object>

The information of the level-2 quota.

subQuotaInfoListobject

The information of the level-2 quota.

idstring

The ID of the level-2 quota.

1000048
namestring

The name of the level-2 quota.

subquotaA
nickNamestring

The alias of the level-2 quota.

subquotaA
typestring

The type of the resource system. This parameter corresponds to the resourceSystemType parameter of the cluster.

FUXI_ONLINE
statusstring

The status of the resource.

ON
tenantIdstring

The ID of the tenant.

478403690625249
regionIdstring

The ID of the region.

cn-beijing
parentIdstring

The ID of the parent resource.

0
clusterstring

The ID of the cluster.

AT-120N
versionstring

The version number.

1
billingPolicyobject

The information of the order.

odpsSpecCodestring

The specifications of the order.

OdpsStandard
orderIdstring

The ID of the order.

45245678
billingMethodstring

The billing method of the quota. Valid values:

  • subscription: a subscription quota.
  • payasyougo: a pay-as-you-go quota.
subscription
scheduleInfoobject

The information of the scheduling plan.

currPlanstring

The quota plan that takes effect based on the scheduling plan.

planA
currTimestring

The time when the current quota plan is scheduled.

0800
nextPlanstring

The next quota plan that will take effect based on the scheduling plan.

planB
nextTimestring

The time when the next quota plan is scheduled.

1700
oncePlanstring

If the quota plan that immediately takes effect is different from the current quota plan, this parameter is not empty.

planC
onceTimestring

The time when the quota plan immediately takes effect.

1500
operatorNamestring

The name of the operator.

userA
parameterobject

The description of the quota.

tagstring

The tag of the resource for the quota.

abc
createTimelong

The time when the resource was created.

2022-09-06T02:14:44Z
creatorIdstring

The ID of the user who created the quota plan.

672863518

Examples

Sample success responses

JSONformat

{
  "requestId": "0be3e0aa16667684362147582e038f",
  "data": {
    "name": "planA",
    "createTime": "2022-05-16T06:07:45Z",
    "quota": {
      "id": "0",
      "name": "quota_a\n",
      "nickName": "quota_nickname",
      "type": "FUXI_ONLINE",
      "status": "ON",
      "tenantId": "478403690625249",
      "regionId": "cn-beijing",
      "parentId": "null",
      "cluster": "AT-120N\n",
      "version": "1",
      "billingPolicy": {
        "odpsSpecCode": "OdpsStandard",
        "orderId": "45245678",
        "billingMethod": "subscription"
      },
      "scheduleInfo": {
        "currPlan": "planA",
        "currTime": "0800",
        "nextPlan": "planB",
        "nextTime": "1700",
        "oncePlan": "planC",
        "onceTime": "1500",
        "operatorName": "userA"
      },
      "parameter": {
        "test": "test",
        "test2": 1
      },
      "tag": "abc",
      "createTime": 0,
      "creatorId": "672863518",
      "subQuotaInfoList": [
        {
          "id": "1000048",
          "name": "subquotaA",
          "nickName": "subquotaA",
          "type": "FUXI_ONLINE",
          "status": "ON",
          "tenantId": "478403690625249",
          "regionId": "cn-beijing",
          "parentId": "0",
          "cluster": "AT-120N\n",
          "version": "1",
          "billingPolicy": {
            "odpsSpecCode": "OdpsStandard",
            "orderId": "45245678",
            "billingMethod": "subscription"
          },
          "scheduleInfo": {
            "currPlan": "planA",
            "currTime": "0800",
            "nextPlan": "planB",
            "nextTime": "1700",
            "oncePlan": "planC",
            "onceTime": "1500",
            "operatorName": "userA"
          },
          "parameter": {
            "test": "test",
            "test2": 1
          },
          "tag": "abc",
          "createTime": 0,
          "creatorId": "672863518"
        }
      ]
    }
  }
}

Error codes

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

Change history

Change timeSummary of changesOperation
2024-10-09The internal configuration of the API is changed, but the call is not affectedView Change Details