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

Agent Installer Platform Service API に移動して、シスコの DevNet にある API リファレンスの詳細にアクセスします。

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

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

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

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

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

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

使用する前に

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

ベース URI

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

Servers

https://{tenantName}.saas.appdynamics.com/zero/v1beta
CODE

Computed URL

https://sampletenant.saas.appdynamics.com/zero/v1beta
CODE

Server Variables

tenantName: sampletenant
CODE

承認

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

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

OAuth トークンを生成するには、この API を使用する必要があります。「API クライアント」ページで説明されているトークン生成方法は、Agent Installer Platform Service API では機能しません。

Templated 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
CODE

Computed 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' 
CODE

Example Output

{
    "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
}
CODE

認証にはアクセストークンを使用する必要があります。更新トークンは使用しないでください。