DescribeDemands - 云服务器 ECS

接口说明

您可通过该接口查询阿里云为您报备的资源详情，包括报备资源类型、资源的交付情况以及资源的消费情况。

默认查询I/O优化实例规格，以及专有网络VPC类型的ECS实例的报备表单状态。

如果您需要获取关于创建ECS资源需求报备信息（CreateDemand）、修改ECS资源需求报备信息（ModifyDemand）及删除ECS资源需求报备信息（DeleteDemand）的相关信息，请联系您对应的客户经理。

请求参数

返回数据

示例

请求示例

https://ecs.aliyuncs.com/?Action=DescribeDemands
&RegionId=cn-hangzhou
&<公共请求参数>

正常返回示例

XML 格式

<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 格式

{
    "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
}

错误码

访问错误中心查看更多错误码。