Updated on 2024-05-11 GMT+08:00

Querying the Agent Status

Function

This API is used to check the Agent status required by application-consistent.

Debugging

You can debug this API through automatic authentication in API Explorer or use the SDK sample code generated by API Explorer.

URI

POST /v3/{project_id}/agent/check

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Project ID

Request Parameters

Table 2 Request body parameters

Parameter

Mandatory

Type

Description

agent_status

Yes

Array of ProtectableAgentStatusResource objects

Query parameter list

Table 3 ProtectableAgentStatusResource

Parameter

Mandatory

Type

Description

resource_id

Yes

String

ID of the resource to be checked

resource_name

No

String

Name of the resource to be checked

resource_type

Yes

String

Type of the resource to be checked. Possible values are OS::Nova::Server (ECS) and OS::Ironic::BareMetalServer (BMS).

Response Parameters

Status code: 200

Table 4 Response body parameters

Parameter

Type

Description

agent_status

Array of ProtectableAgentStatus objects

Status list

Table 5 ProtectableAgentStatus

Parameter

Type

Description

code

Integer

Error code returned upon an Agent connection failure

installed

Boolean

Whether the Agent is installed

is_old

Boolean

Whether the installed Agent is of an earlier version

message

String

Error information that explains why the Agent cannot be connected

resource_id

String

Resource ID

version

String

Agent version ID

Example Requests

Querying the agent status of a cloud server

POST https://{endpoint}/v3/f841e01fd2b14e7fa41b6ae7aa6b0594/agent/check

{
  "agent_status" : [ {
    "resource_id" : "6c0e29fc-5eaa-4f76-af9e-cc79895f70d7",
    "resource_name" : "ecs-8f7b",
    "resource_type" : "OS::Nova::Server"
  } ]
}

Example Responses

Status code: 200

OK

{
  "agent_status" : [ {
    "resource_id" : "6c0e29fc-5eaa-4f76-af9e-cc79895f70d7",
    "installed" : false
  } ]
}

Status Codes

Status Code

Description

200

OK

Error Codes

See Error Codes.