エージェントの表示
エージェント ID を使用してエージェントを表示し、詳細な設定情報を取得することができます。 アカウント内に作成されたすべてのエージェントをリストすることもできます。
UIによるエージェントの表示
- IBM Cloudにログインするには、お客様の認証情報を使用してください。
- Schematics > エージェントをクリックします。
- エージェントの詳細を表示するには、リストからエージェントをクリックします。
CLIによるエージェントの表示
agent list CLI コマンドを使用して、アカウント内のエージェントのリストを表示できます。
例
ibmcloud schematics agent list
出力
Retrieving agents...
OK
Name ID Version Description Resource Group Agent Location Schematics location Status Tags Agent health
Agent-UI-Final-Testing Agent-UI-Final-Testing.deA.3dfb cli-testing eu-de Active
Vishwa-CLI-Testing Vishwa-CLI-Testing.deA.ef99 cli-testing eu-de Active
agent-5-multipod agent-5-multipod.deA.3d58 Srikar testing multiple pods in agent-5 ... job-runner eu-de Active agent_register
agent-prod-testing-api-dec-24-2 agent-prod-testing-api-dec-24-2.deA.ca07 1.6.0 Create Agent Default us-south eu-de Active env:prod, mytest
agent-testing-prod-cli-dec-27-2 agent-testing-prod-cli-dec-27-2.deA.727f v1.0.0 Default us-south eu-de Active
agent-testing-prod-cli-dec-27-3 agent-testing-prod-cli-dec-27-3.deA.fd13 Default us-south eu-de Active
agent-testing-prod-cli-dec-27-4 agent-testing-prod-cli-dec-27-4.deA.acd4 Default us-south eu-de Active
agent-testing-prod-cli-dec-27 agent-testing-prod-cli-dec-27.deA.3f7e Default jp-tok eu-de Active
gsmmar27v1cli-agent-test gsmmar27v1cli-agent-test.deA.6288 Default eu-de eu-de Active
gsmmar27v2cli-agent-test gsmmar27v2cli-agent-test.deA.afcc Default eu-de eu-de Active
gsmmar27v3cli-agent-test gsmmar27v3cli-agent-test.deA.4b56 Default eu-de eu-de Active
Showing 1-11 of 11 items
CLIによるエージェント設定の表示
エージェントの設定を見るには、agent get コマンドを使います。 このコマンドには、入力引数として agent_id が必要です。
エージェントの get コマンド、構文、およびオプション・フラグの詳細を表示するには、 ibmcloud schematics agent get を参照してください。
例
ibmcloud schematics agent get --id agent-testing-prod-cli-dec-27-5.deA.dc97
出力
Retrieving agent...
OK
ID agent-testing-prod-cli-dec-27-5.deA.dc97
Name agent-testing-prod-cli-dec-27-5
Status ACTIVE
Version 1.0.0
Location eu-de
Agent Location jp-tok
Resource Group Default
Recent Job Job ID Status Last modified
DEPLOY .ACTIVITY.465e9716 Triggered deployment 2023-03-27T12:25:01.239Z
APIによるエージェントの表示
手順に従って、API を使用して IAM アクセス・トークンを取得し、IBM Cloud Schematics で認証します。
アカウント内のすべてのエージェントをリストする例。
LIST /v2/agents/ HTTP/1.1
Host: schematics.cloud.ibm.com
Content-Type: application/json
Authorization: Bearer <auth_token>
出力
{
"name": "agent-beta1-testing",
"description": "Create Agent",
"resource_group": "schematics-prod",
"tags": [
"env:prod",
"mytest"
],
"version": "v1.0.0",
"schematics_location": "us-south",
"agent_location": "jp-tok",
"user_state": {
"state": "enable",
"set_by": "test@in.ibm.com",
"set_at": "2023-03-16T06:12:13.684097462Z"
},
"agent_crn": "crn:v1:bluemix:public:schematics:us-south:a/c19ef85117044059a3be5e45d6dc1cf6:347160c0-dca9-49e8-a292-9c980c7f8c47:agent:agent-beta1-testing.soA.748e",
"created_at": "2023-03-16T06:12:13.684112846Z",
"creation_by": "geetha_sathyamurthy@in.ibm.com",
"updated_at": "0001-01-01T00:00:00Z",
"system_state": {
"status_code": "draft"
},
"agent_kpi": {
"availability_indicator": "normal",
"lifecycle_indicator": "consistent",
"percent_usage_indicator": "30%"
}
}
例
GET /v2/agents/agent-beta1-testing.soA.748e/ HTTP/1.1
Host: schematics.cloud.ibm.com
Content-Type: application/json
Authorization: Bearer <auth_token>
出力
{
"name": "agent-beta1-testing",
"description": "Create Agent",
"resource_group": "schematics-prod",
"tags": [
"env:prod",
"mytest"
],
"version": "v1.0.0",
"schematics_location": "us-south",
"agent_location": "us-south",
"user_state": {
"state": "enable",
"set_by": "test@in.ibm.com",
"set_at": "2023-03-16T06:12:13.684097462Z"
},
"agent_crn": "crn:v1:bluemix:public:schematics:us-south:a/c19ef85117044059a3be5e45d6dc1cf6:347160c0-dca9-49e8-a292-9c980c7f8c47:agent:agent-beta1-testing.soA.748e",
"created_at": "2023-03-16T06:12:13.684112846Z",
"creation_by": "test@in.ibm.com",
"updated_at": "0001-01-01T00:00:00Z",
"system_state": {
"status_code": "draft"
},
"agent_kpi": {
"availability_indicator": "normal",
"lifecycle_indicator": "consistent",
"percent_usage_indicator": "30%"
}
}
Terraformによるエージェントの表示
ibm_schematics_agent データソースを使用すると、インフラストラクチャを変更することなく Schematicsに関する情報を取得できます。
既存のエージェントをリストに表示するには Schematicsが展開されている ことを確認してください。
-
main.tfファイルでibm_schematics_agent_deployリソースを定義します。data "ibm_schematics_agents" "schematics_agents" { name = "MyDevAgent" } -
初期化
terraform init -
適用
terraform apply
データソース固有のパラメータの詳細については IBM Cloud Provider Plug-in for Terraformを参照してください。
次のステップ
- エージェントを更新する、および エージェントを削除する ことができます
- エージェントの削除に関するよくある質問については、エージェントFAQ をご覧ください。