AWS Application Discovery Service のアクション、リソース、および条件キー
AWS Application Discovery Service (サービスプレフィックス: discovery) では、IAM アクセス許可ポリシーで使用できるように、以下のサービス固有のリソースやアクション、条件コンテキストキーが用意されています。
リファレンス:
-
このサービスを設定する方法について説明します。
-
このサービスで使用可能な API オペレーションのリストを表示します。
-
IAM アクセス許可ポリシーを使用して、このサービスとそのリソースを保護する方法を学びます。
トピック
AWS Application Discovery Service で定義されるアクション
IAM ポリシーステートメントの Action エレメントでは、以下のアクションを指定できます。ポリシーを使用して、AWS でオペレーションを実行するアクセス許可を付与します。ポリシーでアクションを使用する場合は、通常、同じ名前の API オペレーションまたは CLI コマンドへのアクセスを許可または拒否します。ただし、場合によっては、1 つのアクションによって複数のオペレーションへのアクセスが制御されます。あるいは、いくつかのオペレーションはいくつかの異なるアクションを必要とします。
[アクション] テーブルの [リソースタイプ] 列は、各アクションがリソースレベルの許可をサポートしているかどうかを示します。この列に値がない場合は、ポリシーステートメントの Resource 要素で、ポリシーが適用されるすべてのリソース (「*」) を指定する必要があります。列にリソースタイプが含まれる場合、そのアクションを含むステートメントでそのタイプの ARN を指定できます。アクションで 1 つ以上のリソースが必須となっている場合、呼び出し元には、それらのリソースを伴うアクションを使用するための許可が付与されている必要があります。必須リソースは、アスタリスク (*) でテーブルに示されています。IAM ポリシーの Resource 要素でリソースアクセスを制限する場合は、必要なリソースタイプごとに ARN またはパターンを含める必要があります。一部のアクションでは、複数のリソースタイプがサポートされています。リソースタイプがオプション (必須として示されていない) の場合、オプションのリソースタイプのいずれかを使用することを選択できます。
[アクション] テーブルの [条件キー] 列には、ポリシーステートメントの Condition 要素で指定できるキーが含まれます。サービスのリソースに関連付けられている条件キーの詳細については、[リソースタイプ] テーブルの [条件キー] 列を参照してください。
注記
リソース条件キーは、リソースタイプテーブルに一覧表示されています。アクションに適用されるリソースタイプへのリンクは、[アクション] テーブルの [リソースタイプ (* 必須)] 列にあります。[リソースタイプ] テーブルのリソースタイプには、[アクション] テーブルのアクションに適用されるリソース条件キーである、[条件キー] 列が含まれています。
以下の表の列の詳細については、「アクションテーブル」を参照してください。
| アクション | 説明 | アクセスレベル | リソースタイプ (* 必須) | 条件キー | 依存アクション |
|---|---|---|---|---|---|
| AssociateConfigurationItemsToApplication | AssociateConfigurationItemsToApplication API に許可を付与します。AssociateConfigurationItemsToApplication は、1 つ以上の構成項目をアプリケーションに関連付けます | 書き込み | |||
| BatchDeleteAgents | BatchDeleteAgents API にアクセス許可を付与します。BatchDeleteAgents は、アカウントに関連付けられた 1 つ以上のエージェント/データコレクターを、それぞれエージェント ID で識別して削除します。データコレクターを削除しても、以前に収集されたデータは削除されません。 | 書き込み | |||
| BatchDeleteImportData | BatchDeleteImportData API に許可を付与します。BatchDeleteImportData は、インポート ID で識別される 1 つ以上の Migration Hub インポートタスクを削除します。各インポートタスクには、サーバーまたはアプリケーションを識別できるレコードが多数あります。 | 書き込み | |||
| CreateApplication | CreateApplication API に許可を付与します。CreateApplication は、指定された名前と説明でアプリケーションを作成します | 書き込み | |||
| CreateTags | CreateTags API に許可を付与します。CreateTags は、設定項目のタグを 1 つ以上作成します。タグは、IT アセットの分類に役立つメタデータです。この API は、複数の設定項目のリストを受け入れます。 | タグ付け | |||
| DeleteApplications | DeleteApplications API に許可をを付与します。DeleteApplications は、アプリケーションのリストと設定項目の関連付けを削除します | 書き込み | |||
| DeleteTags | DeleteTags API に許可を付与します。DeleteTags は、設定項目と 1 つ以上のタグの関連付けを削除します。この API は、複数の設定項目のリストを受け入れます。 | タグ付け | |||
| DescribeAgents | DescribeAgents API に許可を付与します。DescribeAgents は、エージェント、またはコネクタを ID ごとに一覧表示します。ID が指定されなかった場合は、ユーザーに関連付けられているエージェントまたはコネクタをすべて一覧表示します | 読み取り | |||
| DescribeBatchDeleteConfigurationTask | DescribeBatchDeleteConfigurationTask API にアクセス許可を付与します。DescribeBatchDeleteConfigurationTask は、一連の設定項目を削除するための一括削除タスクに関する属性を返します。指定するタスク ID は、StartBatchDeleteConfigurationTask の出力から受け取ったタスク ID でなければなりません。 | 読み取り | |||
| DescribeConfigurations | DescribeConfigurations API に許可を付与します。DescribeConfigurations は、設定項目 ID のリストの属性を取得します。提供される ID はすべて、アセットタイプ (サーバー、アプリケーション、プロセス、または接続) が同じである必要があります。出力フィールドは、選択されたアセットタイプに固有です。たとえば、サーバー設定項目の出力には、ホスト名、オペレーティングシステム、ネットワークカード数など、サーバーに関する属性のリストが含まれています。 | 読み取り | |||
| DescribeContinuousExports | DescribeContinuousExports API に許可を付与します。DescribeContinuousExports は、ID で指定されたエクスポートを一覧表示します。パラメータを渡さずに DescribeContinuousExports をそのまま呼び出すと、ユーザーに関連付けられている連続したエクスポートをすべて一覧表示できます。 | 読み取り | |||
| DescribeExportConfigurations | DescribeExportConfigurations API に許可を付与します。DescribeExportConfigurations は、指定されたエクスポートプロセスのステータスを取得します。ステータスは、最大 100 のプロセスから取得できます。 | 読み取り | |||
| DescribeExportTasks | DescribeExportTasks API に許可を付与します。DescribeExportTasks は、1 つ以上のエクスポートタスクのステータスを取得します。最大 100 個のエクスポートタスクのステータスを取得できます。 | 読み取り | |||
| DescribeImportTasks | DescribeImportTasks API に許可を付与します。DescribeImportTasks は、ステータス情報、時間、ID、インポートファイルの Amazon S3 オブジェクト URL など、ユーザーのインポートタスクの配列を返します | リスト | |||
| DescribeTags | DescribeTags API に許可を付与します。DescribeTags は、特定のタグでタグ付けされている設定項目のリストを取得します。または、特定の設定項目に割り当てられたすべてのタグのリストを取得します。 | 読み取り | |||
| DisassociateConfigurationItemsFromApplication | DisassociateConfigurationItemsFromApplication API に許可を付与します。DisassociateConfigurationItemsFromApplication は、1 つ以上の構成項目をアプリケーションから関連付け解除します。 | 書き込み | |||
| ExportConfigurations | ExportConfigurations API に許可を付与します。ExportConfigurations は、データを表示して評価できるように、検出されたすべての設定データを Amazon S3 バケットまたはアプリケーションにエクスポートします。データには、タグ、タグの関連付け、プロセス、接続、サーバー、システムパフォーマンスなどがあります。 | 書き込み | |||
| GetDiscoverySummary | GetDiscoverySummary API に許可を付与します。GetDiscoverySummary は、検出されたアセットの概要を取得します。 | 読み取り | |||
| GetNetworkConnectionGraph | GetNetworkConnectionGraph API に許可を付与します。GetNetworkConnectionGraph は、IP アドレス、サーバー ID、ノード ID のいずれかの入力リストを受け入れます。お客様がネットワーク接続グラフを視覚化するのに役立つノードとエッジのリストを返します。この API は、MigrationHub のコンソールでネットワークグラフ機能を可視化するために使用されます。 | 読み取り | |||
| ListConfigurations | ListConfigurations API に許可を付与します。ListConfigurations は、フィルターで指定された条件に従って、設定項目のリストを取得します。このフィルター条件に基づいて関係の要件が特定されます。 | リスト | |||
| ListServerNeighbors | ListServerNeighbors API に許可を付与します。ListServerNeighbors は、指定されたサーバーから 1 ネットワークホップ離れたサーバーのリストを取得します。 | リスト | |||
| StartBatchDeleteConfigurationTask | StartBatchDeleteConfigurationTask API にアクセス許可を付与します。StartBatchDeleteConfigurationTask は、設定項目の非同期での一括削除を開始します。提供される ID はすべて、アセットタイプ (サーバー、アプリケーション、プロセス、または接続) が同じである必要があります。出力は固有のタスク ID で、これを使用して削除の進行状況を確認できます。 | 書き込み | |||
| StartContinuousExport | StartContinuousExport API に許可を付与します。StartContinuousExport は、エージェントの検出データの Amazon Athena への連続フローを開始します | 書き込み |
iam:AttachRolePolicy iam:CreatePolicy iam:CreateRole iam:CreateServiceLinkedRole |
||
| StartDataCollectionByAgentIds | StartDataCollectionByAgentIds API に許可を付与します。StartDataCollectionByAgentIds は、データの収集を開始するように、指定されたエージェントまたはコネクタに指示します。 | 書き込み | |||
| StartExportTask | StartExportTask API に許可を付与します。StartExportTask は、検出された設定項目および関係に関する設定データを、指定された形式の S3 バケットにエクスポートします。 | 書き込み | |||
| StartImportTask | StartImportTask API に許可を付与します。StartImportTask はインポートタスクを開始します。Migration Hub のインポート機能を使用すると、Discovery Connector や Discovery Agent などの Application Discovery Service (ADS) ツールを使用しなくても、オンプレミス環境の詳細を AWS に直接インポートできます。これにより、インポートしたデータから直接、移行の評価と計画を実行することができます。たとえば、デバイスをアプリケーションとしてグループ化して移行ステータスを追跡することができます。 | 書き込み |
discovery:AssociateConfigurationItemsToApplication discovery:CreateApplication discovery:CreateTags discovery:GetDiscoverySummary discovery:ListConfigurations s3:GetObject |
||
| StopContinuousExport | StopContinuousExport API に許可を付与します。StopContinuousExport は、エージェントの検出データの Amazon Athena への連続フローを停止します | 書き込み | |||
| StopDataCollectionByAgentIds | StopDataCollectionByAgentIds API に許可を付与します。StopDataCollectionByAgentIds は、データの収集を停止するように、指定されたエージェントまたはコネクタに指示します。 | 書き込み | |||
| UpdateApplication | UpdateApplication API に許可を付与します。UpdateApplication は、アプリケーションに関するメタデータを更新します | 書き込み |
AWS Application Discovery Service で定義されるリソースタイプ
AWS Application Discovery Service では、IAM ポリシーステートメントの Resource 要素でのリソース ARN の指定はサポートされていません。AWS Application Discovery Service へのアクセスを許可するには、ポリシーで "Resource": "*" を指定します。
注記
アクセスを分離するには、別の AWS アカウントを作成して使用します。
AWS Application Discovery Service の条件キー
AWS Application Discovery Service では、IAM ポリシーの Condition 要素で使用できる以下の条件キーを定義します。これらのキーを使用して、ポリシーステートメントが適用される条件をさらに絞り込むことができます。以下の表の列の詳細については、「条件キーテーブル」を参照してください。
すべてのサービスで使用できるグローバル条件キーを確認するには、「使用できるグローバル条件キー」を参照してください。
| 条件キー | 説明 | [Type] (タイプ) |
|---|---|---|
| aws:TagKeys | リクエストで渡されたタグキーでアクセスをフィルタリングします | ArrayOfString |
