AMS API と CLI の使用 - AMS Advanced ユーザーガイド
REST コール用の AMS API HTTP エンドポイントAMS CLI のインストールまたはアップグレード

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

AMS API と CLI の使用

AWS Managed Services (AMS) API は、他の AWS サービスの APIs と似ています。AMS API については、「AMS API リファレンス」を参照してください。

REST コール用の AMS API HTTP エンドポイント

さまざまな SDKs に加えて、AMS は CLI を提供します。AMS エンドポイントに対して REST API コールを呼び出すこともできます。

2 つの AMS APIs があります (両方のエンドポイントは us-east-1 にあります）。

  • 変更管理: この API を使用して、RFCs の作成と更新、新しいインスタンスのデプロイ、インスタンスの更新と削除、CTs に関する情報の取得、AMIs の作成など、インフラストラクチャへのアクセスまたは変更をリクエストします。HTTP エンドポイントは次のとおりです。

    https://amscm.us-east-1.amazonaws.com

  • SKMS: この API を使用して、VPCs、スタック、サブネット、AMIs などのインフラストラクチャに関する情報を取得します。HTTP エンドポイントは次のとおりです。

    https://amsskms.us-east-1.amazonaws.com

AMS CLI のインストールまたはアップグレード

AMS CLI は AMS API を操作する簡単な方法であり、このセクションの例で使用します。CLI および AMS AWS CLI の使用規則については、AWS 「 コマンドラインインターフェイスの使用」を参照してください。

SAML のインストールについては、「」を参照してくださいAD FS クレームルールと SAML 設定。

AMS CLI をインストールまたはアップグレードするには、次の手順に従います。

注記

この手順には管理者認証情報が必要です。

AWS CLI は、AWS Managed Services (AMS) CLIs (変更管理と SKMS) を使用するための前提条件です。

  1. AWS CLI をインストールするには、「AWS コマンドラインインターフェイスのインストール」を参照して、適切な手順に従ってください。このページの下部には、さまざまなインストーラー、Linux、MS Windows、macOS、仮想環境、バンドルインストーラー (Linux、macOS、または Unix) を使用する手順があることに注意してください。

    インストール後、 aws helpを実行してインストールを確認します。

  2. AWS CLI がインストールされたら、AMS CLI をインストールまたはアップグレードするには、AMS AMS CLI または AMS SDK 配布用 zip ファイルをダウンロードして解凍します。AMS CLI ディストリビューションには、AMS コンソールの左ナビゲーションにあるデベロッパーのリソースリンクからアクセスできます。

  3. README ファイルには、インストールの手順が記載されています。

    次のいずれかを開きます。

    • CLI zip: AMS CLI のみを提供します。

    • SDK zip: すべての AMS APIs と AMS CLI を提供します。

    Windows の場合は、適切なインストーラ (32 ビットまたは 64 ビットシステムのみ) を実行します。

    • 32 ビット: ManagedCloudAPI_x86.msi

    • 64 ビット: ManagedCloudAPI_x64.msi

    Mac/Linux の場合は、次のコマンドを実行して AWSManagedServices_InstallCLI.sh という名前のファイルを実行します。 sh AWSManagedServices_InstallCLI.shamscm および amsskms ディレクトリとそのコンテンツは、AWSManagedServices_InstallCLI.sh ファイルと同じディレクトリにある必要があります。

  4. 企業の認証情報を AWS とのフェデレーション (AMS デフォルト設定) で使用する場合は、フェデレーションサービスにアクセスできる認証情報管理ツールをインストールする必要があります。例えば、この AWS セキュリティブログ How to Implement Federated API and CLI Access Using SAML 2.0 and AD FS を使用して、認証情報管理ツールの設定に役立てることができます。

  5. インストール後、 aws amscm helpと aws amsskms help を実行してコマンドとオプションを表示します。

    注記

    これらのコマンドを機能させるには、AMS CLI をインストールする必要があります。AMS API または CLI をインストールするには、AMS コンソールのデベロッパーリソースページに移動します。AMS CM API または AMS SKMS API のリファレンスマテリアルについては、「 ユーザーガイド」の「AMS 情報リソース」セクションを参照してください。認証--profileのオプションを追加する必要がある場合があります。例: aws amsskms ams-cli-command --profile SAML。また、 など、すべての AMS コマンドが us-east-1 を使い果たすため、 --regionオプションを追加する必要がある場合がありますaws amscm ams-cli-command --region=us-east-1。