クエリオプションを使用した変更タイプの検索 - AMS Advanced ユーザーガイド

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

クエリオプションを使用した変更タイプの検索

この例では、AMS コンソールを使用して、送信する RFC の適切な変更タイプを見つける方法を示します。

コンソールまたは API/CLI を使用して、変更タイプ ID (CT) またはバージョンを検索できます。検索または分類の選択の 2 つの方法があります。どちらの選択タイプでも、最も頻繁に使用される、最近使用された、またはアルファベットのいずれかを選択して検索をソートできます。

YouTube 動画: AWS Managed Services CLI を使用して RFC を作成する方法と、CT スキーマの場所を教えてください。

AMS コンソールの RFCs -> RFC の作成ページで、次の操作を行います。

  • 変更タイプによる参照 (デフォルト) を選択した場合、次のいずれかを実行します。

    • クイック作成エリアを使用して、AMS の最も一般的な CTs から選択します。ラベルをクリックすると、RFC の実行ページが開き、件名オプションが自動的に入力されます。必要に応じて残りのオプションを完了し、実行をクリックして RFC を送信します。

    • または、すべての変更タイプ領域までスクロールダウンし、オプションボックスに CT 名を入力し始めます。変更タイプ名を完全または完全に設定する必要はありません。関連する単語を入力して、変更タイプ ID、分類、または実行モード (自動または手動) で CT を検索することもできます。

      デフォルトのカードビューを選択すると、入力時に一致する CT カードが表示され、カードを選択して RFC の作成をクリックします。テーブルビューを選択し、関連する CT を選択し、RFC の作成をクリックします。どちらの方法でも、RFC の実行ページが開きます。

  • または、変更タイプの選択肢を確認するには、ページ上部の「カテゴリ別に選択」をクリックして、一連のドロップダウンオプションボックスを開きます。

  • カテゴリ、サブカテゴリ、項目、オペレーションを選択します。その変更タイプの情報ボックスは、ページの下部にパネルが表示されます。

  • 準備ができたら、Enter キーを押すと、一致する変更タイプのリストが表示されます。

  • リストから変更タイプを選択します。その変更タイプの情報ボックスがページの下部に表示されます。

  • 正しい変更タイプを取得したら、RFC の作成を選択します。

注記

これらのコマンドを機能させるには、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。

注記

AMS API/CLI (amscm および amsskms) エンドポイントは、AWS N. Virginia リージョン にありますus-east-1。認証の設定方法や、アカウントとリソースが存在する AWS リージョンによっては、コマンドの発行--region us-east-1時に追加が必要になる場合があります。認証方法である場合は--profile saml、 を追加する必要がある場合もあります。

AMS CM API (ListChangeTypeClassificationSummaries を参照) または CLI を使用して変更タイプを検索するには：

フィルターまたはクエリを使用して検索できます。ListChangeTypeClassificationSummaries オペレーションには、Category、、SubcategoryItem、および のフィルターオプションがありますがOperation、値は既存の値と完全に一致する必要があります。CLI を使用する際のより柔軟な結果を得るには、 --queryオプションを使用できます。

AMS CM API/CLI を使用した変更タイプのフィルタリング
属性 有効値 有効/デフォルト条件 注意

ChangeTypeId

ChangeTypeId を表す任意の文字列 (例: ct-abc123xyz7890)

Equals (等しい)

変更タイプ IDs「変更タイプリファレンス」を参照してください。

変更タイプ IDs「変更タイプまたは CSIO の検索」を参照してください。

カテゴリ

任意の自由形式のテキスト

を含む

個々のフィールドの正規表現はサポートされていません。大文字と小文字を区別しない検索

サブカテゴリ

Item

Operation

  1. 変更タイプの分類を一覧表示する例をいくつか示します。

    次のコマンドは、すべての変更タイプカテゴリを一覧表示します。

    aws amscm list-change-type-categories

    次の コマンドは、指定されたカテゴリに属するサブカテゴリを一覧表示します。

    aws amscm list-change-type-subcategories --category CATEGORY

    次の コマンドは、指定されたカテゴリとサブカテゴリに属する項目を一覧表示します。

    aws amscm list-change-type-items --category CATEGORY --subcategory SUBCATEGORY

  2. CLI クエリで変更タイプを検索する例をいくつか示します。

    次のコマンドは、項目名に「S3」が含まれている CT 分類の概要を検索し、カテゴリ、サブカテゴリ、項目、オペレーション、変更タイプ ID の出力をテーブル形式で作成します。

    aws amscm list-change-type-classification-summaries --query "ChangeTypeClassificationSummaries [?contains(Item, 'S3')].[Category,Subcategory,Item,Operation,ChangeTypeId]" --output table
    +---------------------------------------------------------------+
|               ListChangeTypeClassificationSummaries           |
+----------+-------------------------+--+------+----------------+
|Deployment|Advanced Stack Components|S3|Create|ct-1a68ck03fn98r|
+----------+-------------------------+--+------+----------------+

  3. その後、変更タイプ ID を使用して CT スキーマを取得し、パラメータを調べることができます。次のコマンドは、CreateS3Params.schema.json.

    aws amscm get-change-type-version --change-type-id "ct-1a68ck03fn98r" --query "ChangeTypeVersion.ExecutionInputSchema" --output text > CreateS3Params.schema.json

    CLI クエリの使用の詳細については、「--query Option で出力をフィルタリングする方法」および「クエリ言語リファレンス」のJMESPath Specification」を参照してください。

  4. 変更タイプ ID を取得したら、変更タイプのバージョンを検証して最新バージョンであることを確認することをお勧めします。次のコマンドを使用して、指定された変更タイプのバージョンを検索します。

    aws amscm list-change-type-version-summaries --filter Attribute=ChangeTypeId,Value=CHANGE_TYPE_ID

    AutomationStatus 特定の変更タイプの を検索するには、次のコマンドを実行します。

    aws amscm --profile saml get-change-type-version --change-type-id CHANGE_TYPE_ID --query "ChangeTypeVersion.{AutomationStatus:AutomationStatus.Name}"

    ExpectedExecutionDurationInMinutes 特定の変更タイプの を検索するには、次のコマンドを実行します。

    aws amscm --profile saml get-change-type-version --change-type-id ct-14027q0sjyt1h --query "ChangeTypeVersion.{ExpectedDuration:ExpectedExecutionDurationInMinutes}"