Agent Upgrade API

{
    "requestFilter": [
        12, 13
    ],
    "resultColumns": [
    ],
    "offset": 0,
    "limit": 10,
    "searchFilters": [],
    "columnSorts": [],
    "timeRangeStart": 0,
    "timeRangeEnd": 0
}

{
    "id": 1,
    "version": 0,
    "name": "Deploy updated configuration",
    "type": "CONFIGURE",
    "triggerTs": 1762941714549,
    "createdBy": 5,
    "createTs": 1762941714549,
    "modifiedBy": 5,
    "modifyTs": 1762941714549,
    "accountId": 2,
    "deployments": [
        {
            "id": 1,
            "version": 1,
            "taskId": 1,
            "agentType": "SMART_AGENT",
            "smartAgentId": "01K2KDF2TZA83RP71HB6WB40XN",
            "agentInstanceId": "01K2KDF2TZA83RP71HB6WB40XN",
            "configYaml": "{}\n",
            "configHash": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
            "configFilesJson": "[{\"fileName\":\"config.json\",\"fileFormat\":\"json\",\"fileContent\":\"{\\\"key\\\": \\\"value\\\"}\",\"targetPath\":\"/opt/appdynamics/config/\"}]",
            "status": "TRIGGERED",
            "logs": "",
            "agentId": null,
            "endTs": 1762941714550,
            "deploymentV1": 0,
            "config": {}
        }
    ],
    "profileId": 0
}

curl -X POST "https://<controller-host>/controller/rest/v2/agent-management/inventory/query"
 -H "Content-Type: application/json"
 -u "user@account:password"
 -d '{ "agentType": "SMART_AGENT", "limit": 25, "offset": 0 }'

curl -X POST "https://<controller-host>/controller/rest/agent-management/v2/upgrades" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -u "user@account:password" \
  -d '{
    "agentInstallationIds": [1],
    "agentType": "SMART_AGENT",
    "targetVersion": "26.2.0.779",
    "downloadSource": "local",
    "downloadUri": "/opt/agents/binaries"
  }'

{
  "taskId": 456,
  "status": "TRIGGERED",
  "deploymentCount": 3,
  "deployments": [
    {
      "deploymentId": 4561,
      "agentId": 1,
      "status": "TRIGGERED",
      "agentType": "SMART_AGENT"
    },
    {
      "deploymentId": 4562,
      "agentId": 2,
      "status": "TRIGGERED",
      "agentType": "SMART_AGENT"
    },
    {
      "deploymentId": 4563,
      "agentId": 3,
      "status": "TRIGGERED",
      "agentType": "SMART_AGENT"
    }
  ],
  "skippedAgents": {}
}

{
  "taskId": 457,
  "status": "TRIGGERED",
  "deploymentCount": 1,
  "deployments": [
    {
      "deploymentId": 4571,
      "agentId": 1,
      "status": "TRIGGERED",
      "agentType": "SMART_AGENT"
    }
  ],
  "skippedAgents": {
    "INACTIVE_SMART_AGENT": [2],
    "EXISTING_DEPLOYMENTS": [3]
  }
}

{
  "taskId": 0,
  "status": "NO_ELIGIBLE_AGENTS",
  "deploymentCount": 0,
  "deployments": [],
  "skippedAgents": {
    "INACTIVE_SMART_AGENT": [1, 2, 3]
  }
}

#!/bin/bash
set -euo pipefail

CONTROLLER="https://controller.example.com:8090"
AUTH="apiuser@customer1:api-token-here"

# Step 1: Discover agents to upgrade
echo "=== Discovering agents ==="
AGENTS=$(curl -s -X POST "$CONTROLLER/controller/rest/v2/agent-management/inventory/query" \
  -H "Content-Type: application/json" \
  -u "$AUTH" \
  -d '{
    "agentType": "SMART_AGENT",
    "limit": 100,
    "offset": 0,
    "filters": [
      { "field": "VERSION_STATUS", "operator": "IN", "value": ["UpdateAvailable"] }
    ]
  }')

# IMPORTANT: Use agentInstallationV2 (not agentId) for the upgrade API
AGENT_INSTALLATION_IDS=$(echo "$AGENTS" | jq '[.data[].agentInstallationV2]')
echo "Found agent installation IDs: $AGENT_INSTALLATION_IDS"

# Step 2: Check available versions
echo "=== Checking available versions ==="
VERSIONS=$(curl -s -X GET "$CONTROLLER/controller/rest/agent-management/v2/upgrades/versions?agentType=SMART_AGENT" \
  -H "Accept: application/json" \
  -u "$AUTH")

LATEST=$(echo "$VERSIONS" | jq -r '.versions[0]')
echo "Latest version: $LATEST"

# Step 3: Trigger upgrade
echo "=== Triggering upgrade to $LATEST ==="
RESULT=$(curl -s -w "\n%{http_code}" -X POST "$CONTROLLER/controller/rest/agent-management/v2/upgrades" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -u "$AUTH" \
  -d "{
    \"agentInstallationIds\": $AGENT_INSTALLATION_IDS,
    \"agentType\": \"SMART_AGENT\",
    \"targetVersion\": \"$LATEST\",
    \"skipIneligible\": true
  }")

HTTP_CODE=$(echo "$RESULT" | tail -1)
BODY=$(echo "$RESULT" | head -1)

if [ "$HTTP_CODE" = "201" ]; then
  TASK_ID=$(echo "$BODY" | jq '.taskId')
  DEPLOY_COUNT=$(echo "$BODY" | jq '.deploymentCount')
  echo "SUCCESS: Task $TASK_ID created with $DEPLOY_COUNT deployments"
  echo "Track progress using task ID $TASK_ID via the existing task status API."
else
  echo "FAILED: HTTP $HTTP_CODE - $BODY"
  exit 1
fi