StaticPool search request
Description
This API searches for StaticPool objects that satisfy the specified criteria.
API stability classification
API overview
HTTP | URI | Return | Return type |
|---|---|---|---|
POST | csm/StaticPool/search | 0..* |
HTTP request message
Query string parameters
This API does not use query string parameters.
Request message headers
This API uses only common headers listed in HTTP-request-and-response-headers.
Request message body
This API uses the following objects in the request message body JSON.
Top-level objectsThe [confluence_table-plus] macro is a standalone macro and it cannot be used inline. Click on this message for details.
Name | Type | Multi- | Description |
|---|---|---|---|
callbackURL | String | 0..1 | URL to call when the operation finishes |
postCallout | String | 0..1 | Identifier of a callout to run after the operation executes |
preCallout | String | 0..1 | Identifier of a callout to run before the operation executes |
timeout | Integer | 0..1 | Timeout setting. For more information about using the timeout, see Synchronous-and-asynchronous-operations. Timeout values:
|
operationParams | 1 | Array of input parameters. The following table contains the list of input parameters. For information about setting up the input parameters, see Passing-input-parameters-with-an-API-request. |
The [confluence_table-plus] macro is a standalone macro and it cannot be used inline. Click on this message for details.
Input parameters to include in operationParamsThe [confluence_table-plus] macro is a standalone macro and it cannot be used inline. Click on this message for details.
Name | Type | Multi- | Description |
|---|---|---|---|
criteria | 0..1 | Query criteria to filter the results. If you omit this parameter, all results are returned. | |
pageSize | Integer | 0..1 | Number of objects to return per page. When isOnboarded is set to false, this parameter is ignored and all results are returned in the response. |
pageNo | Integer | 0..1 | Page number to return. When isOnboarded is set to false, this parameter is ignored and all results are returned in the response. |
orderBy | String | 0..* | Name of an attribute or relationship on which to sort the results |
fillFields | String | 0..* | List of attributes and relationships to include in the response |
ignoreFields | String | 0..* | List of attributes and relationships to omit from the response |
isOnboarded | Boolean | 0..1 | Indicates whether to search for onboarded objects. When set to false, you must include providerURI. |
providerURI | String | 0..1 | URI of the provider in which to search for objects that are not onboarded. You must include this parameter when isOnboarded is set to false. |
The [confluence_table-plus] macro is a standalone macro and it cannot be used inline. Click on this message for details.
If you include both the fillFields and ignoreFields parameters in your query and the same field is listed in both parameters, the ignoreFields parameter takes precedence.
HTTP response message
Response message headers
This API uses only common headers listed in HTTP-request-and-response-headers.
Response message body
The response message body contains a SearchResults object in which the results field is an array of StaticPool objects. If your search request times out before it finishes, the response message body contains a Task object.
Example
The following example shows an HTTP request that searches for all static pool objects:
POST /csm/staticpool/search HTTP/1.1
Host: <apiServer>
Authentication-Token: <yourToken>
The following example shows an HTTP response to the previous request:
HTTP/1.1 200 OK
Date: Thu, 07 Apr 2011 00:18:19 GMT
BMC-Transaction-ID: 1e13ac5d-4b4a-4a40-826f-f594a82c4858
Content-Type: application/json; charset=UTF-8
Content-Length: 3121
Server: Jetty(6.1.x)
[
{
"cloudClass" : "com.bmc.cloud.model.beans.SearchResults",
"guid" : "45c9da55-2ea6-4ae5-8b5b-e339d5a32d6c",
"pageNo" : 0,
"pageSize" : 0,
"results" : [
{
"actual" : 17,
"cloudClass" : "com.bmc.cloud.model.beans.StaticPool",
"description" : "Default pool for pod CompactPODDev",
"externalID" :
"52cfae96-730b-43ee-b530-cdcc99ebfd99:CompactPODDev_default_pool",
"forNetworkContainer" : [],
"guid" : "51354b3d-75cd-406e-bf53-051244e76125",
"inPod" : "/pod/5304ea7c-7992-4b00-9456-b4a45620f715",
"isDefault" : true,
"name" : "CompactPODDev_default_pool",
"owner" : "bhu_admin",
"pooledObjects" : [
"/virtualhost/f93b9c35-4272-4285-85a5-7a4c9a4806af",
"/virtualresourcepool/181d3c0e-bdbc-45d5-b1cd-bfb2677d6925",
"/virtualresourcepool/ea276992-0bb4-43b2-b63d-c0c9b69acba7",
"/virtualresourcepool/45f40c04-f9a9-4543-ab43-cbb19d63c4d8",
"/virtualresourcepool/2c6983c5-2f14-4e3f-aebb-461fc0d6b7d7",
"/virtualresourcepool/b46ef274-1f8a-4bdd-8146-2ecbe3a9fb46",
"/virtualresourcepool/dd5ed52b-e8c1-40d0-b212-b3fc6f58c545",
"/virtualresourcepool/5029db5f-e38f-45a0-814b-747291c4ad30",
"/virtualresourcepool/7e5788e3-b9f4-476b-ac7d-021e8f2435a9",
"/virtualresourcepool/1ebc026b-7800-4b76-baa8-0d2971695ac3",
"/virtualresourcepool/0b1fef73-74af-4cf2-9068-892f6601acd0",
"/virtualresourcepool/a7a4f725-532f-4beb-ad5b-7fa1c8f62d10",
"/virtualresourcepool/bb2c64e2-3357-4209-9c63-ed3cfdf867ee",
"/virtualcluster/0e7d9f54-db4a-43a8-b139-159b2b186acf",
"/virtualdatastore/6689dbf5-2e44-4fbd-ac34-91e796e6a500",
"/virtualresourcepool/32a4e5ad-ad04-4935-9da0-62449055c3fb",
"/virtualresourcepool/f826d0cc-7500-4ba0-86f0-e4b068c82362"
],
"reconciliationID" : "OI-be7ff062c7a9448eb14fafcf92ceef56",
"tokenID" : "CompactPODDev_default_pool"
},
{
"actual" : 1,
"cloudClass" : "com.bmc.cloud.model.beans.StaticPool",
"description" : "Compute Pool One.",
"forNetworkContainer" :
[ "/networkcontainer/04e36fa8-9f8e-4415-a7c7-60b88b349e4d" ],
"guid" : "65cd213f-4a54-480f-bb4d-03b12b262924",
"inPod" : "/pod/5304ea7c-7992-4b00-9456-b4a45620f715",
"isDefault" : false,
"name" : " yComputePool",
"owner" : "bhu_admin",
"pooledObjectType" : "com.bmc.cloud.model.beans.VirtualCluster",
"pooledObjects" :
["/virtualhost/2ddd18a0-bc2b-4cb0-a2dc-399e773c5257"],
"reconciliationID" : "OI-4aed613fd707491aaa8a42ebd813ee07",
"tokenID" : " yComputePool"
},
{
"actual" : 2,
"cloudClass" : "com.bmc.cloud.model.beans.StaticPool",
"forNetworkContainer" : [],
"guid" : "8eb7a6fc-8c7b-460f-8680-f5d305005c5a",
"inPod" : "/pod/5304ea7c-7992-4b00-9456-b4a45620f715",
"isDefault" : false,
"name" : "VDS Pool",
"owner" : "bhu_admin",
"pooledObjectType" : "com.bmc.cloud.model.beans.VirtualDatastore",
"pooledObjects" : [
"/virtualdatastore/3342d1c1-a206-41f1-83cb-f5053cecebf2",
"/virtualdatastore/6be93d4a-fb32-47d1-ac15-d9187d9fb4d4"
],
"reconciliationID" : "OI-88c3ed085c154309b1168e26d0868483",
"tokenID" : "VDS Pool"
}
],
"totalRows" : 3
}
]