2.14.1 Obtaining Pod List
The API acquires a list of pods.
Execution permission
Admin, Modify
API version
v1
Request format
GET http[s]://host:port/Analytics/version/objects/Pods
Request body
Not applicable.
Response body
The structure of the response body and the object attributes are as follows:{ "data":[{ "name":"...", "status":"...", "monitorStatus":"...", "nodeID":"...", "nodeName":"...", "nodeMonitorStatus":"...", "clusterName":"...", "namespace":"...", "ownerReferences":"...", "labels":"...", "groupIDs":["...", ...], "groupNames":["...", ...], "gradeNames":["...", ...], "gradeOrders":["...", ...], "collectorID":"...", "collectorName":"...", "autoCollectionType":"...", "usedCredentialID":"...", "usedCredentials":"...", "accessPointType":"...", "accessPointIpAddress":"...", "accessPointUser":"...", "pluginId":"...", "pluginName":"..." }, : ], "pagination":{ "page":"...", "pageSize":"...", "numPages":"...", "totalCount":"..." }, "count":"..." }
Collections (Type: Collections)
Attribute |
Type |
Description |
---|---|---|
data |
Pod[] |
A list of Pod objects. For details about Pod, see the table below. |
pagination |
Pagination |
Page information. This parameter is displayed only when the relevant resource exists. |
count |
int |
Number of data items that meet the conditions. |
data (Type: Pod)
Attribute |
Type |
Description |
---|---|---|
name |
string |
Name of the pod |
status |
enum |
Status of the pod (For details about the specifiable values, see the table NodeStatusType in List of enumerators.) The specifiable values are as follows:
|
monitorStatus |
enum |
Monitor status of the pod (For details about the specifiable values, see the table ComponentMonitorType in List of enumerators.) The specifiable values are as follows:
|
nodeID |
long |
ID of the container node that the pod belongs to |
nodeName |
string |
Name of the container node that the pod belongs to |
nodeMonitorStatus |
enum |
Monitor status of the container node that the pod belongs to (For details about the specifiable values, see the table ManagementLevelType in List of enumerators.) The specifiable values are as follows:
|
clusterName |
string |
Name of the cluster that the pod belongs to |
namespace |
string |
Namespace of the container pod |
ownerReferences |
string |
Control source of the container pod |
labels |
string |
Labels of the container pod |
groupIDs |
long[] |
ID of the consumer assigned to the pod |
groupNames |
string[] |
Name of the consumer assigned to the pod |
gradeNames |
string[] |
Name of the grade of the consumer assigned to the pod |
gradeOrders |
integer[] |
Priority of the grade of the consumer assigned to the pod |
collectorID |
long |
ID for identifying a collector used for detection |
collectorName |
string |
Name of a collector used for detection |
autoCollectionType |
enum |
Type of a collector used for detection (For details about the specifiable values, see the table ConnectType in List of enumerators.) The specifiable values are as follows:
|
usedCredentialID |
long |
ID of authentication information used for detection |
usedCredentials |
string |
Name for authentication information used for detection |
accessPointType |
enum |
Type of the protocol or collector for authentication information used for detection. (For details about the specifiable values, see the table ProtocolType in List of enumerators.) The specifiable values are as follows:
|
accessPointIpAddress |
string |
IP address or host name used for connections to monitoring targets or management software |
accessPointUser |
string |
User ID used for connections to monitoring targets or management software |
pluginId |
string |
ID for the plug-in applied to the pod. |
pluginName |
string |
Name for the plug-in applied to the pod. |
pagination (Type: Pagination)
Attribute |
Type |
Description |
---|---|---|
page |
integer |
page |
pageSize |
integer |
Size of the pages |
numPages |
integer |
Number of the pages |
totalCount |
integer |
Number of the objects |
Status codes
Status code |
Reason phrase |
Description |
---|---|---|
200 |
OK |
Success. |
401 |
Unauthorized |
No login privilege. |
403 |
Forbidden |
No reference privilege. |
412 |
Precondition Failed |
The server is not available. |
500 |
Internal Server Error |
Server processing error. |
Example code
[Request Header] GET /Analytics/v1/objects/Pods HTTP/1.1 Authorization: Basic c3lzdGVtOm1hbmFnZXI= User-Agent: curl/7.33.0 Host: localhost:22015 Accept: application/json Accept-Language: ja [Response Header] HTTP/1.1 200 OK Date: Fri, 27 Nov 2015 07:11:36 GMT Server: Cosminexus HTTP Server Cache-Control: no-cache WWW-Authenticate: HSSO 87d94e387ca516a82287ff4254ddac7f44e18bd4_WVlGcHsLfg5ffg0I_V0810 X-Frame-Options: SAMEORIGIN Transfer-Encoding: chunked Content-Type: application/json [Response Body] { "data" : [ { "instanceID" : 16, "name" : "api-6f6f887c55-cqwdv", "status" : "Normal", "monitorStatus" : "InUse", "nodeID" : 50, "nodeName" : "k8s-master.local", "nodeMonitorStatus" : "Manage", "clusterName" : "zzops", "namespace" : "ml-smore", "ownerReferences" : "ReplicaSet/api-6f6f887c55", "labels" : "api,2929443711", "groupIDs" : [ 0 ], "groupNames" : [ "#Unassigned Resources" ], "gradeNames" : [ "" ], "gradeOrders" : [ -1 ], "collectorID" : 0, "collectorName" : "kubernetes", "autoCollectionType" : "AutoConnect", "accessPointType" : "HTTP", "accessPointIpAddress" : "10.197.101.177", "accessPointUser" : "system", "pluginId" : "com.hitachi.software.ias.KubernetesPlugin", "pluginName" : "Kubernetes Plugin A" }, { "instanceID" : 15, "name" : "api-9b96d4c5d-crpzj", "status" : "Normal", "monitorStatus" : "InUse", "nodeID" : 50, "nodeName" : "k8s-master.local", "nodeMonitorStatus" : "Manage", "clusterName" : "zzops", "namespace" : "ml-aem", "ownerReferences" : "ReplicaSet/api-9b96d4c5d", "labels" : "api,565280718", "groupIDs" : [ 0 ], "groupNames" : [ "#Unassigned Resources" ], "gradeNames" : [ "" ], "gradeOrders" : [ -1 ], "collectorID" : 0, "collectorName" : "kubernetes", "autoCollectionType" : "AutoConnect", "accessPointType" : "HTTP", "accessPointIpAddress" : "10.197.101.177", "accessPointUser" : "system", "pluginId" : "com.hitachi.software.ias.KubernetesPlugin", "pluginName" : "Kubernetes Plugin A" } ], "count" : 2 }