Queries all properties or a combination of properties of a component.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | Yes | SearchInventory |
The operation that you want to perform. Set the value to SearchInventory. |
RegionId | String | No | cn-hangzhou |
The ID of the region. |
Filter.N.Name | String | No | ACS:InstanceInformation.InstanceId |
The name of the component property. Valid values of N: 1 to 5. Different components have different properties. You can call the GetInventorySchema operation to query the property names of different components. For example, the ACS:InstanceInformation component has the InstanceId property. Therefore, you can set this parameter to ACS:InstanceInformation.InstanceId. |
Filter.N.Operator | String | No | Equal |
The comparison operator that is used to filter property values. Valid values of N: 1 to 5. Valid values:
|
Filter.N.Value.N | RepeatList | No | i-bp1cpoxxxxxxxxxxxxxx |
The value of the property. Valid values of the first N: 1 to 5. Valid values of the second N: 1 to 20. |
Aggregator.N | RepeatList | No | ACS:Application.Name |
The combination of properties. Only the specified one or more properties are returned. Valid values:
|
NextToken | String | No | gAAAAABfTgv5ewUWmNdJ3g7JVLvX70sPH90GZOVGC |
The token that is used to retrieve the next page of results. |
MaxResults | Integer | No | 50 |
The number of entries to return on each page. Valid values: 1 to 100. Default value: 50. |
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
Entities | List | [ { "ACS:InstanceInformation": { "CaptureTime": "2020-10-13T08:55:06Z", "SchemaVersion": "1.0", "Content": { "PlatformName": "ubuntu", "PlatformVersion": "20.04", "Status": "Running", "InstanceId": "i-bp1cpoxxxxxxxxxxxxxx", "AgentVersion": "v1.5", "ComputerName": "iZbp1cpoxxxw111jcv94drZ", "IpAddress": "192.168.10.245", "AgentName": "oosutil", "PlatformType": "linux" }, "RegionId": "cn-hangzhou" }, "Id": "i-bp1cpoxxxxxxxxxxxxxx" } ]} |
The properties of the component. |
MaxResults | Integer | 50 |
The number of entries returned per page. |
NextToken | String | gAAAAABfTgv5ewUWmNdJ3g7JVLvX70sPH90GZOVGC |
The token that was used to retrieve the next page of results. |
RequestId | String | A81E4B2E-6B33-4BAE-9856-55DB7C893E01 |
The ID of the request. |
Examples
Sample requests
http(s)://[Endpoint]/? Action=SearchInventory
&Filter.0.Name=ACS:InstanceInformation.InstanceId
&Filter.0.Operator=Equal
&Filter.0.Value.0=i-bp1cpoxxxxxxxxxxxxxx
&Aggregator.0=ACS:Application.Name
&Aggregator.1=ACS:Application.Version
&<Common request parameters>
Sample success responses
XML
format
<RequestId>5B694097-E7C7-4231-858C-B979CEC3A0AC</RequestId>
<MaxResults>50</MaxResults>
<Entities>
<Data>
<ACS:Application>
<Content>
<ACS:Application.Name>NetworkManager</ACS:Application.Name>
<ACS:Application.Version>1.22.8</ACS:Application.Version>
<Count>1</Count>
</Content>
<Content>
<ACS:Application.Name>NetworkManager-libnm</ACS:Application.Name>
<ACS:Application.Version>1.22.8</ACS:Application.Version>
<Count>1</Count>
</Content>
<Content>
<ACS:Application.Name>NetworkManager-team</ACS:Application.Name>
<ACS:Application.Version>1.22.8</ACS:Application.Version>
<Count>1</Count>
</Content>
<Content>
<ACS:Application.Name>NetworkManager-tui</ACS:Application.Name>
<ACS:Application.Version>1.22.8</ACS:Application.Version>
<Count>1</Count>
</Content>
<Content>
<ACS:Application.Name>PackageKit</ACS:Application.Name>
<ACS:Application.Version>1.1.12</ACS:Application.Version>
<Count>1</Count>
</Content>
<Content>
<ACS:Application.Name>PackageKit-glib</ACS:Application.Name>
<ACS:Application.Version>1.1.12</ACS:Application.Version>
<Count>1</Count>
</Content>
<Content>
<ACS:Application.Name>abattis-cantarell-fonts</ACS:Application.Name>
<ACS:Application.Version>0.0.25</ACS:Application.Version>
<Count>1</Count>
</Content>
<Content>
<ACS:Application.Name>acl</ACS:Application.Name>
<ACS:Application.Version>2.2.53</ACS:Application.Version>
<Count>1</Count>
</Content>
<Content>
<ACS:Application.Name>adcli</ACS:Application.Name>
<ACS:Application.Version>0.8.2</ACS:Application.Version>
<Count>1</Count>
</Content>
<Content>
<ACS:Application.Name>aliyun_assist</ACS:Application.Name>
<ACS:Application.Version>1.0.2.493</ACS:Application.Version>
<Count>1</Count>
</Content>
</ACS:Application>
</Data>
</Entities>
JSON
format
{
"RequestId": "5B694097-E7C7-4231-858C-B979CEC3A0AC",
"MaxResults": 50,
"Entities": [
{
"Data": {
"ACS:Application": {
"Content": [
{
"ACS:Application.Name": "NetworkManager",
"ACS:Application.Version": "1.22.8",
"Count": 1
},
{
"ACS:Application.Name": "NetworkManager-libnm",
"ACS:Application.Version": "1.22.8",
"Count": 1
},
{
"ACS:Application.Name": "NetworkManager-team",
"ACS:Application.Version": "1.22.8",
"Count": 1
},
{
"ACS:Application.Name": "NetworkManager-tui",
"ACS:Application.Version": "1.22.8",
"Count": 1
},
{
"ACS:Application.Name": "PackageKit",
"ACS:Application.Version": "1.1.12",
"Count": 1
},
{
"ACS:Application.Name": "PackageKit-glib",
"ACS:Application.Version": "1.1.12",
"Count": 1
},
{
"ACS:Application.Name": "abattis-cantarell-fonts",
"ACS:Application.Version": "0.0.25",
"Count": 1
},
{
"ACS:Application.Name": "acl",
"ACS:Application.Version": "2.2.53",
"Count": 1
},
{
"ACS:Application.Name": "adcli",
"ACS:Application.Version": "0.8.2",
"Count": 1
},
{
"ACS:Application.Name": "aliyun_assist",
"ACS:Application.Version": "1.0.2.493",
"Count": 1
}
]
}
}
}
]
}
Error codes
For a list of error codes, visit the API Error Center.