Agent Installer Platform Service API

注:

エージェントインストーラはメンテナンスモードです。「エージェント管理」を参照してください。

AppDynamics Agent Installer Platform Service API は現在ベータ版であり、変更される可能性があります。ベータ版 API を採用する場合、将来のバージョンは完全な互換性がない可能性があります。バージョン 21.11 では、Ansible スクリプトを使用できます。

https://developer.cisco.com/docs/appdynamics/agent-installer-platform-service/api-reference/Agent Installer Platform Service API に移動して、シスコの DevNet にある API リファレンスの詳細にアクセスします。

Agent Installer Platform Service API は、現在 UI を介して提供されているインストールおよびモニタリングの使用例をサポートするパブリック REST エンドポイントのコレクションです。エージェントインストーラは、現在 API でサポートされているアップグレードおよびロールバックの使用例をサポートしています。

シンプルな API を、より高度なオーケストレーション シナリオの構成要素として使用できます。Splunk AppDynamics エージェントインストーラは、Splunk AppDynamics モニタリングエージェントを使用するアプリケーションのインストルメンテーションを合理化します。

エージェントインストーラ：

  • Java エージェントおよびマシンエージェントを展開します。Linux と互換性があります。

  • アプリケーションを自動でインストゥルメント化
  • 検出された階層とノードへの一意の名前の割り当て
  • エージェントのアップグレードとロールバック

その他のエージェントは、開始ウィザードを使用して展開できます。詳細については、「エージェントインストーラ」を参照してください。

はじめに

Splunk AppDynamics では、機能をカスタマイズおよび拡張するためのさまざまな API が公開されています。

ベース URI

すべての API 要求は、次のベース URI で始まります（ゼロサービスのすべての実稼働導入用のテンプレート）。

サーバー 
https://{tenantName}.saas.appdynamics.com/zero/v1beta
計算された URL 
https://sampletenant.saas.appdynamics.com/zero/v1beta
サーバー変数 
tenantName: sampletenant

認証

アイデンティティタイプ（API クライアント）を作成し使用することで、REST API コールを使用した Splunk AppDynamics へのセキュアなアクセスを提供できます。これらのコールは、Open Authorization（OAuth）トークンベースの認証を使用します。OAuth トークンを生成するために使用できる新しい API クライアント ID タイプを作成できます。現時点ではロールは必要ありません。

OAuth トークンを作成するには、次の API を使用し、作成された「Client Name」と「Client Secret」をメモします。

注: OAuth トークンを生成するには、この API を使用する必要があります。で説明されているトークン生成方法

APIクライアント

ページは、Agent Installer Platform Service API では機能しません。
テンプレート化された URL 
curl --location --request POST
'https://{tenantName}.saas.appdynamics.com/auth/v1/oauth/token' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'grant_type=client_credentials' \
--data-urlencode 'client_id={apiClientName}@{accountName}' \
--data-urlencode 'client_secret={apiClientSecret}'
Template Variables
tenantName      : sampleTenantName
apiClientName   : sampleApiClientName
apiClientSecret : sampleApiClientSecret
accountName     : sampleAccountName
計算された URL 
curl --location --request POST
'https://sampleTenantName.saas.appdynamics.com/auth/v1/oauth/token' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'grant_type=client_credentials' \
--data-urlencode 'client_id=sampleApiClientName@sampleAccountName' \
--data-urlencode 'client_secret=sampleApiClientSecret'
出力例 
{
"token_type": "bearer",
"access_token": "eyJraWQiOiJlY2VhYTgwMC01M2NkLTQyNWYtOWYzNS0yZWFhNmU3ZmIzMjQiLCJhbGciOiJSUzUxMiJ9.eyJpc3MiOiJBcHBEeW5hbWljcyIsImF1ZCI6IkFwcERfQVBJcyIsImp0aSI6InhodWQzaXhYY0k2R1I1NVZMUWJIM1EiLCJzdWIiOiJ6ZmktZnVzaW9uLWNsaWVudCIsImlkVHlwZSI6IkFQSV9DTElFTlQiLCJpZCI6ImUxNWEyODhiLTEyYTUtNGYzMC04OWQ4LWMxNTQwZmNiOGZlYyIsImFjY3RJZCI6ImZiOGQ1YzAxLTVlYzItNGI4ZS1hMmJiLTdhMDRmODA5ZTgyYiIsInRudElkIjoiZmI4ZDVjMDEtNWVjMi00YjhlLWEyYmItN2EwNGY4MDllODJiIiwiYWNjdE5hbWUiOiJwcm9qZWN0LXplcm8tMSIsInRlbmFudE5hbWUiOiJwcm9qZWN0LXplcm8tMSIsImZtbVRudElkIjo1LCJhY2N0UGVybSI6W10sInJvbGVJZHMiOltdLCJpYXQiOjE2Mjc0ODk5MDIsIm5iZiI6MTYyNzQ4OTc4MiwiZXhwIjoxNjI3NDkwMjAyLCJ0b2tlblR5cGUiOiJBQ0NFU1MifQ.bz0CQrhyC1l92QSv7dibmqHNkJXrfL_DkXxk-4qSLAUj5xjj_NloETj8c0Es7PKopeZxrsBVgn_NJHDNM4YFSggW9DmXSBGZbRnQ8EBZhIy2w5821Pg0EErMpEQscSQY459m82kgvXOzDF4SO29pYW2bkO4JAMlEOUPjMlPXjkB2acsi9wcToWitVEwuE1sSm4QZ6BvUz84XF1y8_z_LyhakCIFwOdOZOOG3QO6nKvnJhVtI8kfCKim6LVkE93HirG8j4AxB79L_bPeKm7ZLqKapzE_9qhn1GvE4SQZ345ixpnQchJeFxrHILvHj06oKt65PvoAbxKLDxFPeViKtQl4svZeYGF6ujCUAb1SxSs3jgz4YKab8njVf_FeTS3dpsiw4UtkN_00QRv6QNfyjndk9_iMh46BpHDc0E6kvYRVW6rSXuYU7c8ulvU3SKeHoIl0PMjLpotYwHSlved4YUg_GmxstTBNpXeLP7xMxn7vReoM-eIw4IWXuRAt64bWj",
"refresh_token": "eyJraWQiOiJlY2VhYTgwMC01M2NkLTQyNWYtOWYzNS0yZWFhNmU3ZmIzMjQiLCJhbGciOiJSUzUxMiJ9.eyJpc3MiOiJBcHBEeW5hbWljcyIsImF1ZCI6IkFwcERfQVBJcyIsImp0aSI6InN6Z240cGVRb1M3UEdoTzh3Z0dMV0EiLCJzdWIiOiJ6ZmktZnVzaW9uLWNsaWVudCIsImlkVHlwZSI6IkFQSV9DTElFTlQiLCJpZCI6ImUxNWEyODhiLTEyYTUtNGYzMC04OWQ4LWMxNTQwZmNiOGZlYyIsImFjY3RJZCI6ImZiOGQ1YzAxLTVlYzItNGI4ZS1hMmJiLTdhMDRmODA5ZTgyYiIsInRudElkIjoiZmI4ZDVjMDEtNWVjMi00YjhlLWEyYmItN2EwNGY4MDllODJiIiwiYWNjdE5hbWUiOiJwcm9qZWN0LXplcm8tMSIsInRlbmFudE5hbWUiOiJwcm9qZWN0LXplcm8tMSIsImZtbVRudElkIjo1LCJhY2N0UGVybSI6W10sInJvbGVJZHMiOltdLCJpYXQiOjE2Mjc0ODk5MDIsIm5iZiI6MTYyNzQ4OTc4MiwiZXhwIjoxNjI3NDkwMjAyLCJ0b2tlblR5cGUiOiJSRUZSRVNIIn0.GF1H-2VEel1UsloQOsK3Q4t1cxKHQh-OOKW2Sn44eaDsgGvx8HkBogn9lum8MaH6zW4YDgf5Hv-ZE0U9l11OyuzhlhPN8O5fdSYAgG2w6UzZOfsUC63cRix95N11iCJsiYr2-AViv7SNdvNUz3SQW9iXgt_wAldzeqSVSvYK8jNgoUuCvw54qfKQDAsL7wy3HH0JVAnlkHiYYKa8QzciI6RLooT5ZPuavcwbg6Lansf_rXxJ5yFTdwoCjgJEnA3ZxmJNwFFPfmxf_uvnDXpjNEUiy3Wux4KreK5xadzoNQMgafjYPAx3QzmCFmCnKGdVz8lI_f21nqmS_tn89Jl-bqh0raJnQEJzcVr7aO1g3x6o1Ef3tp8mrx414ruU3vO-IsoOjIWp2ns9U43iFkjNmcl5FCCDGANc_HQU3aqr9gr8MbdpV2zAESbmZqmW9Q4v2OmTfENI5fflooeKGv19eDAmYIIcKLKYFcSY2SmUGyQEPrp2XOZumy1peZ3DsCuX",
"expires_in": 300
}
注: 認証にはアクセストークンを使用する必要があります。更新トークンは使用しないでください。