Query usage plan status

Last updated: 2020-06-09 15:06:04


    This is a legacy API which has been hidden and will no longer be updated. We recommend using the new API Gateway API 3.0 which is standardized and faster.

    Interface description

    This API (DescribeUsagePlansStatus) is used to query one or more usage plan lists. You can query the name, description, QPS and other information of these usage plans.

    Input Parameter

    The following request parameter list only lists the API request parameters. For other parameters, please see Common Request Parameters .

    Parameter name Required Type Description
    UsagePlanIds.n No Array of Strings Unique ID queries according to one or more usage plans.
    Offset No Int Offset, default is 0.
    Limit No Int The number returned. The default is 20, and the maximum value is 100.
    Orderby No String Sort by which field.
    Order No String Sort mode.
    SearchName No String Fuzzy search according to the name of the usage plan.
    SearchId No String According to the usage plan unique ID precise search.

    Output Parameter

    Parameter name Type Description
    Code Int Common error code, 0 indicates success, other values indicate failure. For more information, please see the error code page Common error code .
    CodeDesc String Error code on the business side. If a Success, error is returned on success, the cause of the business error is returned.
    Message String Module error message description, related to the interface.
    TotalCount Int The number of usage plans that meet the criteria.
    UsagePlanStatusSet List of Array Use the schedule list.

    Where usagePlanStatusSet is an array of usagePlanStatus, and usagePlanStatus is composed as follows:

    Parameter name Type Description
    UsagePlanId String Use plan unique ID.
    UsagePlanName String User-defined usage plan name.
    UsagePlanDescription String User-defined usage plan description.
    RequestControlUnit String Request limit unit. Default is SECOND. Currently, SECOND, can only be followed by MINUTE, HOUR, and so on.
    RequestControlNum Int Request limit number.
    CreatedTime Timestamp Policy creation time. Expressed according to the ISO8601 standard, and using UTC time. The format is: YYYY-MM-DDThh:mm:ssZ.
    ModifiedTime Timestamp Last Modification Time. Expressed according to the ISO8601 standard, and using UTC time. The format is: YYYY-MM-DDThh:mm:ssZ.
    MaxRequestNum Int The total requested quota,-1 means there is no limit.


    &<Common request parameters>

    The returned results are as below:

                "maxRequestNum": -1
                "maxRequestNum": 100

    Was this page helpful?

    Was this page helpful?

    • Not at all
    • Not very helpful
    • Somewhat helpful
    • Very helpful
    • Extremely helpful
    Send Feedback