:DescribeInstances

説明

• 複数のリクエストパラメーターを指定できます。 指定されたパラメーター間には、論理 AND 関係が存在します。 指定したパラメーターのみがフィルター条件に含まれます。 ただし、InstanceIds が空の JSON 配列に設定されている場合、有効なフィルタリング条件と見なされ、空の結果が返されます。
• RAM ユーザーまたは RAM ロールを使用していて、ユーザーまたはロールにこの操作を呼び出す権限がない場合、空のリストが返されます。 リクエストに DryRun パラメーターを追加すると、権限不足により、空のリストになっているのかを判断できます。

Alibaba Cloud Command Line Interface (CLI) を使用して API 操作を呼び出すときは、さまざまなデータタイプのリクエストパラメーター値を必要な形式で指定してください。 詳細については、「 CLI パラメーターの形式」をご参照ください 。

リクエストパラメーター

レスポンスパラメーター

例

リクエスト例

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

通常のレスポンス例

XML 形式

<DescribeInstancesResponse>
      <PageNumber>1</PageNumber>
      <TotalCount>6</TotalCount>
      <PageSize>10</PageSize>
      <RequestId>8EF01A45-FFFA-497B-B5C3-1DE1B74DB32D</RequestId>
      <Instances>
            <Instance>
                  <InnerIpAddress></InnerIpAddress>
                  <ImageId>ubuntu_16_0402_64_20G_alibase_20170818.vhd</ImageId>
                  <InstanceTypeFamily>ecs.g5</InstanceTypeFamily>
                  <VlanId></VlanId>
                  <NetworkInterfaces>
                        <NetworkInterface>
                              <MacAddress>00:16:3e:32:b4:**</MacAddress>
                              <PrimaryIpAddress>172.17.XX.XXX</PrimaryIpAddress>
                              <NetworkInterfaceId>eni-2zeh9atclduxvf1z****</NetworkInterfaceId>
                        </NetworkInterface>
                  </NetworkInterfaces>
                  <InstanceId>XXXXXXXXXXX</InstanceId>
                  <EipAddress>
                        <IpAddress></IpAddress>
                        <AllocationId></AllocationId>
                        <InternetChargeType></InternetChargeType>
                  </EipAddress>
                  <InternetMaxBandwidthIn>50</InternetMaxBandwidthIn>
                  <ZoneId>cn-beijing-e</ZoneId>
                  <InternetChargeType>PayByBandwidth</InternetChargeType>
                  <SpotStrategy>NoSpot</SpotStrategy>
                  <StoppedMode>Not-applicable</StoppedMode>
                  <SerialNumber>d9bd1cdc-624d-4736-9da5-2ba2f741****</SerialNumber>
                  <IoOptimized>true</IoOptimized>
                  <Memory>8192</Memory>
                  <Cpu>2</Cpu>
                  <VpcAttributes>
                        <NatIpAddress></NatIpAddress>
                        <PrivateIpAddress>
                              <IpAddress>172.17.XX.XXX</IpAddress>
                        </PrivateIpAddress>
                        <VSwitchId>vsw-2zeh0r1pabwtg6wcs****</VSwitchId>
                        <VpcId>vpc-2zeuphj08tt7q3brd****</VpcId>
                  </VpcAttributes>
                  <InternetMaxBandwidthOut>1</InternetMaxBandwidthOut>
                  <SecurityGroupIds>
                        <SecurityGroupId>sg-2ze21r9qb638hvtr****</SecurityGroupId>
                  </SecurityGroupIds>
                  <SpotPriceLimit>0.0</SpotPriceLimit>
                  <SaleCycle>Week</SaleCycle>
                  <AutoReleaseTime></AutoReleaseTime>
                  <InstanceName>ECS-BUY-2017-57-10</InstanceName>
                  <Description></Description>
                  <ResourceGroupId></ResourceGroupId>
                  <OSType>linux</OSType>
                  <OSName>Ubuntu 16.04 64</OSName>
                  <InstanceNetworkType>vpc</InstanceNetworkType>
                  <PublicIpAddress>
                        <IpAddress>47.94.XX.XX</IpAddress>
                  </PublicIpAddress>
                  <HostName>iZ2zeh9atclduxvf1zx****</HostName>
                  <InstanceType>ecs.g5.large</InstanceType>
                  <CreationTime>2017-12-10T04:04Z</CreationTime>
                  <Tags>
                        <Tag>
                              <TagValue>fqwfew</TagValue>
                              <TagKey>fefqe</TagKey>
                        </Tag>
                        <Tag>
                              <TagValue>weqfwq</TagValue>
                              <TagKey>fqewfwqewf</TagKey>
                        </Tag>
                        <Tag>
                              <TagValue>ewqffeqw</TagValue>
                              <TagKey>fqfwewfqw</TagKey>
                        </Tag>
                  </Tags>
                  <Status>Running</Status>
                  <MetadataOptions>
                        <HttpTokens></HttpTokens>
                        <HttpEndpoint></HttpEndpoint>
                  </MetadataOptions>
                  <ClusterId></ClusterId>
                  <Recyclable>false</Recyclable>
                  <RegionId>cn-beijing</RegionId>
                  <GPUSpec></GPUSpec>
                  <OperationLocks></OperationLocks>
                  <GPUAmount>0</GPUAmount>
                  <InstanceChargeType>PrePaid</InstanceChargeType>
                  <ExpiredTime>2017-12-17T16:00Z</ExpiredTime>
            </Instance>
      </Instances>
</DescribeInstancesResponse>

JSON 形式

{
    "PageNumber": 1,
    "TotalCount": 58,
    "PageSize": 1,
    "RequestId": "97935DF1-0289-4AA2-9DD1-72377838B16B",
    "Instances": {
        "Instance": [
            {
                "ImageId": "centos_7_06_64_20G_alibase_20190711.vhd",
                "VlanId": "",
                "EipAddress": {
                    "IpAddress": "",
                    "AllocationId": "",
                    "InternetChargeType": ""
                },
                "ZoneId": "cn-hangzhou-f",
                "IoOptimized": true,
                "SerialNumber": "51d1353b-22bf-4567-a176-8b3e12e43***",
                "Cpu": 2,
                "Memory": 8192,
                "DeviceAvailable": true,
                "SecurityGroupIds": {
                    "SecurityGroupId": [
                        "sg-bp17zljqpohu6j2i****"
                    ]
                },
                "SaleCycle": "",
                "AutoReleaseTime": "",
                "ResourceGroupId": "",
                "OSType": "linux",
                "OSName": "CentOS 7.6 64-bit",
                "InstanceNetworkType": "classic",
                "HostName": "iZbp1j4i2jdf3owlheb****",
                "CreationTime": "2019-11-11T08:35Z",
                "Tags": {
                    "Tag": [
                        {
                            "TagValue": "asg-bp1d8uuut40f4qc4****",
                            "TagKey": "acs:autoscaling:scalingGroupId"
                        },
                        {
                            "TagValue": "ESS",
                            "TagKey": "ESS"
                        }
                    ]
                },
                "EcsCapacityReservationAttr": {
                    "CapacityReservationPreference": "none",
                    "CapacityReservationId": ""
                },
                "RegionId": "cn-hangzhou",
                "DeletionProtection": false,
                "OperationLocks": {
                    "LockReason": []
                },
                "ExpiredTime": "2099-12-31T15:59Z",
                "CpuOptions": {
                    "Numa": "",
                    "ThreadsPerCore": 2,
                    "CoreCount": 1
                },
                "InnerIpAddress": {
                    "IpAddress": [
                        "10.80.61.42"
                    ]
                },
                "InstanceTypeFamily": "ecs.mn4",
                "InstanceId": "i-bp1j4i2jdf3owlhe****",
                "InternetMaxBandwidthIn": 50,
                "CreditSpecification": "",
                "InternetChargeType": "PayByTraffic",
                "SpotStrategy": "NoSpot",
                "StoppedMode": "Not-applicable",
                "InternetMaxBandwidthOut": 1,
                "VpcAttributes": {
                    "NatIpAddress": "",
                    "PrivateIpAddress": {
                        "IpAddress": []
                    },
                    "VSwitchId": "",
                    "VpcId": ""
                },
                "SpotPriceLimit": 0,
                "StartTime": "2019-11-11T08:35Z",
                "InstanceName": "ECS-asg-MyFirstScalingGroup",
                "Description": "ECS",
                "OSNameEn": "CentOS 7.6 64 bit",
                "PublicIpAddress": {
                    "IpAddress": [
                        "121.40.77.XXX"
                    ]
                },
                "InstanceType": "ecs.mn4.large",
                "Status": "Running",
                "MetadataOptions": {
                    "HttpTokens": "",
                    "HttpEndpoint": ""
                },
                "Recyclable": false,
                "ClusterId": "",
                "GPUSpec": "",
                "InstanceChargeType": "PostPaid",
                "GPUAmount": 0,
                "DedicatedHostAttribute": {
                    "DedicatedHostId": "",
                    "DedicatedHostName": ""
                },
                "DedicatedInstanceAttribute": {
                    "Affinity": "",
                    "Tenancy": ""
                },
                "DeploymentSetId": ""
            }
        ]
    }
}

エラーコード

エラーコードのリストについては、「API エラーセンター」をご参照ください。