DescribeDemands

Description

You can call this operation to query the details of resources filed by Alibaba Cloud, including the types, delivery status, and consumption status of the resources.

By default, the filing tickets of I/O optimized VPC-type instances are queried.

For information about how to create (CreateDemand), modify (ModifyDemand), and delete (DeleteDemand) filing tickets on ECS resources, contact your account manager.

Request parameters

Response parameters

Examples

Sample requests

https://ecs.aliyuncs.com/?Action=DescribeDemands
&RegionId=cn-hangzhou
&<Common request parameters>

Sample success responses

XML format

<DescribeDemandsResponse>
      <Demands>
            <AvailableAmount>0</AvailableAmount>
            <DeliveringAmount>50</DeliveringAmount>
            <DemandStatus>Expired</DemandStatus>
            <DemandTime>2019-02-26T12:00:00Z</DemandTime>
            <EndTime>2019-03-03T15:00:00Z</EndTime>
            <InstanceChargeType>PrePaid</InstanceChargeType>
            <DemandName>testnames</DemandName>
            <DemandDescription>testDesc</DemandDescription>
            <InstanceType>ecs.g6.xlarge</InstanceType>
            <DemandId>ed-bp16iilptf1tnc0y2***</DemandId>
            <Comment>zone closed</Comment>
            <InstanceTypeFamily>ecs.g6</InstanceTypeFamily>
            <Period>3</Period>
            <PeriodUnit>Month</PeriodUnit>
            <StartTime>2019-02-27T12:00:00Z</StartTime>
            <SupplyInfos>
                  <Amount>50</Amount>
                  <SupplyEndTime>2019-03-03T15:00:00Z</SupplyEndTime>
                  <SupplyStartTime>2019-03-01T14:00:00Z</SupplyStartTime>
                  <SupplyStatus>Delivering</SupplyStatus>
            </SupplyInfos>
            <TotalAmount>50</TotalAmount>
            <UsedAmount>0</UsedAmount>
            <ZoneId>cn-hangzhou-g</ZoneId>
      </Demands>
      <PageNumber>1</PageNumber>
      <PageSize>10</PageSize>
      <RegionId>cn-hangzhou</RegionId>
      <RequestId>04066112-BF3A-4FCD-ABBD-B4B5EDAE9DXX</RequestId>
      <TotalCount>1</TotalCount>
</DescribeDemandsResponse>

JSON format

{
    "Demands": [
        {
            "AvailableAmount": 0,
            "DeliveringAmount": 50,
            "DemandStatus": "Expired",
            "DemandTime": "2019-02-26T12:00:00Z",
            "EndTime": "2019-03-03T15:00:00Z",
            "InstanceChargeType": "PrePaid",
            "DemandName": "testnames",
            "DemandDescription": "testDesc",
            "InstanceType": "ecs.g6.xlarge",
            "DemandId": "ed-bp16iilptf1tnc0y2***",
             "Comment": "zone closed",                       
            "InstanceTypeFamily": "ecs.g6",
            "Period": 3,
            "PeriodUnit": "Month",
            "StartTime": "2019-02-27T12:00:00Z",
            "SupplyInfos": [
                {
                    "Amount": "50",
                    "SupplyEndTime": "2019-03-03T15:00:00Z",
                    "SupplyStartTime": "2019-03-01T14:00:00Z",
                    "SupplyStatus": "Delivering"
                }
            ],
            "TotalAmount": 50,
            "UsedAmount": 0,
            "ZoneId": "cn-hangzhou-g"
        }
    ],
    "PageNumber": 1,
    "PageSize": 10,
    "RegionId": "cn-hangzhou",
    "RequestId": "04066112-BF3A-4FCD-ABBD-B4B5EDAE9DXX",
    "TotalCount": 1
}

Error codes

For a list of error codes, visit the API Error Center.