Amazon Location のアクション、リソース、および条件キー
Amazon Location (サービスプレフィックス: geo
) では、IAM アクセス許可ポリシーで使用できるように、以下のサービス固有のリソースやアクション、条件コンテキストキーが用意されています。
参照:
-
このサービスを設定する方法について説明します。
-
このサービスで使用可能な API オペレーションのリストを表示します。
-
IAM アクセス許可ポリシーを使用して、このサービスとそのリソースを保護する方法を学びます。
Amazon Location で定義されるアクション
IAM ポリシーステートメントの Action
エレメントでは、以下のアクションを指定できます。ポリシーを使用して、AWS でオペレーションを実行するアクセス許可を付与します。ポリシーでアクションを使用する場合は、通常、同じ名前の API オペレーションまたは CLI コマンドへのアクセスを許可または拒否します。ただし、場合によっては、1 つのアクションによって複数のオペレーションへのアクセスが制御されます。あるいは、いくつかのオペレーションはいくつかの異なるアクションを必要とします。
[アクション] テーブルの [リソースタイプ] 列は、各アクションがリソースレベルの許可をサポートしているかどうかを示します。この列に値がない場合は、ポリシーステートメントの Resource
要素で、ポリシーが適用されるすべてのリソース (「*」) を指定する必要があります。列にリソースタイプが含まれる場合、そのアクションを含むステートメントでそのタイプの ARN を指定できます。アクションで 1 つ以上のリソースが必須となっている場合、呼び出し元には、それらのリソースを伴うアクションを使用するための許可が付与されている必要があります。必須リソースは、アスタリスク (*) でテーブルに示されています。IAM ポリシーの Resource
要素でリソースアクセスを制限する場合は、必要なリソースタイプごとに ARN またはパターンを含める必要があります。一部のアクションでは、複数のリソースタイプがサポートされています。リソースタイプがオプション (必須として示されていない) の場合、オプションのリソースタイプのいずれかを使用することを選択できます。
[アクション] テーブルの [条件キー] 列には、ポリシーステートメントの Condition
要素で指定できるキーが含まれます。サービスのリソースに関連付けられている条件キーの詳細については、[リソースタイプ] テーブルの [条件キー] 列を参照してください。
注記
リソース条件キーは、リソースタイプテーブルに一覧表示されています。アクションに適用されるリソースタイプへのリンクは、[アクション] テーブルの [リソースタイプ (* 必須)] 列にあります。[リソースタイプ] テーブルのリソースタイプには、[アクション] テーブルのアクションに適用されるリソース条件キーである、[条件キー] 列が含まれています。
以下の表の列の詳細については、「アクションテーブル」を参照してください。
アクション | 説明 | アクセスレベル | リソースタイプ (* 必須) | 条件キー | 依存アクション |
---|---|---|---|---|---|
AssociateTrackerConsumer | ジオフェンスコレクションとトラッカーリソースの間の関連付けを作成する権限を付与します | Write | |||
BatchDeleteDevicePositionHistory | トラッカーリソースからデバイス位置履歴のバッチを削除する許可を付与 | Write | |||
BatchDeleteGeofence | ジオフェンスのコレクションからジオフェンスのバッチを削除する権限を付与します | Write | |||
BatchEvaluateGeofences | 所与のジオフェンスコレクション内のジオフェンスの位置に照らしてデバイスの位置を評価する権限を付与します | Write | |||
BatchGetDevicePosition | デバイスの位置を取得するためのバッチリクエストを送信する権限を付与します | Read | |||
BatchPutGeofence | 所与のジオフェンスコレクションにジオフェンスを追加するバッチリクエストを送信する権限を付与します | Write | |||
BatchUpdateDevicePosition | 1 つ異常のデバイスの位置更新をトラッカーリソースにアップロードする権限を付与します | Write | |||
CalculateRoute | 指定されたルート計算リソースを使用してルートを計算する許可を付与 | 読み取り | |||
CalculateRouteMatrix | 指定済みルート計算リソースを使用して、ルートマトリクスを計算する許可を付与します | 読み取り | |||
CreateGeofenceCollection | ジオフェンスコレクションを作成する権限を付与します | 書き込み | |||
CreateKey | API キーリソースを作成するための許可を付与します | 書き込み | |||
CreateMap | マップリソースを作成する権限を付与します | Write | |||
CreatePlaceIndex | 場所インデックスリソースを作成する権限を付与します | Write | |||
CreateRouteCalculator | ルート計算リソースを作成する許可を付与 | Write | |||
CreateTracker | トラッカーリソースを作成する権限を付与します | Write | |||
DeleteGeofenceCollection | ジオフェンスコレクションを削除する許可を付与 | 書き込み | |||
DeleteKey | API キーリソースを削除するための許可を付与します | 書き込み | |||
DeleteMap | マップリソースを削除する権限を付与します | Write | |||
DeletePlaceIndex | 場所インデックスリソースを削除する権限を付与します | Write | |||
DeleteRouteCalculator | ルート計算リソースを削除する許可を付与 | Write | |||
DeleteTracker | トラッカーリソースを削除する権限を付与します | Write | |||
DescribeGeofenceCollection | ジオフェンスコレクションの詳細を取得する許可を付与 | 読み取り | |||
DescribeKey | API キーリソースの詳細とシークレットを取得するための許可を付与します | 読み取り | |||
DescribeMap | マップリソースの詳細を取得する許可を付与。 | Read | |||
DescribePlaceIndex | 場所インデックスリソースの詳細を取得する許可を付与 | Read | |||
DescribeRouteCalculator | ルート計算リソースの詳細を取得する許可を付与 | Read | |||
DescribeTracker | トラッカーリソースの詳細を取得する権限を付与します | Read | |||
DisassociateTrackerConsumer | トラッカーリソースとジオフェンスコレクションの間の関連付けを削除する権限を付与します。 | 書き込み | |||
ForecastGeofenceEvents | 特定のジオフェンスコレクションに保存されているジオフェンスのイベントを予測する許可を付与する | 読み取り | |||
GetDevicePosition | 最新のデバイス位置を取得する権限を付与します | 読み取り | |||
GetDevicePositionHistory | デバイス位置履歴を取得する許可を付与します | 読み取り | |||
GetGeofence | ジオフェンスコレクションからジオフェンスの詳細を取得する許可を付与します | 読み取り | |||
GetMapGlyphs | マップリソースのグリフファイルを取得する権限を付与します | Read | |||
GetMapSprites | マップリソースのスプライトファイルを取得する権限を付与します | Read | |||
GetMapStyleDescriptor | マップリソースからマップスタイル記述子を取得するパーミッションを付与します | Read | |||
GetMapTile | マップリソースからマップタイルを取得する権限を付与します | 読み取り | |||
GetPlace | ユニーク ID でその場所を検索する許可を付与 | 読み取り | |||
ListDevicePositions | 指定されたトラッカーリソースからデバイスのリストと最新の位置を取得する許可を付与 | 読み取り | |||
ListGeofenceCollections | ジオフェンスコレクションを一覧表示する権限を付与します | リスト | |||
ListGeofences | 所与のジオフェンスのコレクションに保存されているジオフェンスを一覧表示する権限を付与します | 読み取り | |||
ListKeys | API キーリソースを一覧表示するための許可を付与します | リスト | |||
ListMaps | マップリソースを一覧表示する権限を付与します | リスト | |||
ListPlaceIndexes | 場所インデックスリソースのリストを返す権限を付与します | リスト | |||
ListRouteCalculators | ルート計算リソースのリストを返すアクセス許可を付与します | リスト | |||
ListTagsForResource | リソースに割り当てたタグ (メタデータ) を一覧表示する許可を付与 | Read | |||
ListTrackerConsumers | 所与のトラッカーリソースに現在関連付けられているジオフェンスコレクションのリストを取得する権限を付与します | Read | |||
ListTrackers | トラッカーリソースのリストを返す権限を付与します | リスト | |||
PutGeofence | 新しいジオフェンスを追加したり、既存のジオフェンスを更新して所与のジオフェンスコレクションにする権限を付与します | Write | |||
SearchPlaceIndexForPosition | 所与の座標を逆ジオコーディングする権限を付与します | 読み取り | |||
SearchPlaceIndexForSuggestions | 部分的またはスペルミスのある自由形式のテキストに基づいて、住所および対象となるポイントの候補を生成する許可を付与 | 読み取り | |||
SearchPlaceIndexForText | 住所、名前、都市、地域など自由形式のテキストをジオコーディングする権限を付与します | Read | |||
TagResource | 指定されたリソースのタグに追加するアクセス許可、またはタグを変更する許可を付与。タグは、リソースを管理するために使用できるメタデータです | タグ付け | |||
UntagResource | 指定のタグ (メタデータ) をリソースから削除する許可を付与 | タグ付け | |||
UpdateGeofenceCollection | ジオフェンスコレクションを更新する許可を付与 | 書き込み | |||
UpdateKey | API キーリソースを更新するための許可を付与します | 書き込み | |||
UpdateMap | マップリソースを更新する許可を付与 | 書き込み | |||
UpdatePlaceIndex | 場所インデックスリソースを更新する許可を付与 | 書き込み | |||
UpdateRouteCalculator | ルート計算リソースを更新する許可を付与 | 書き込み | |||
UpdateTracker | トラッカーリソースを更新する許可を付与 | 書き込み | |||
VerifyDevicePosition | デバイスの位置を確認する許可を付与する | 読み取り | |||
Amazon Location で定義されるリソースタイプ
以下のリソースタイプは、このサービスによって定義され、IAM アクセス許可ポリシーステートメントの Resource
エレメントで使用できます。アクションテーブルの各アクションは、そのアクションで指定できるリソースタイプを示しています。リソースタイプは、ポリシーに含めることができる条件キーを定義することもできます。これらのキーは、[リソースタイプ] テーブルの最後の列に表示されます。以下の表の列の詳細については、「リソースタイプテーブル」を参照してください。
リソースタイプ | ARN | 条件キー |
---|---|---|
api-key |
arn:${Partition}:geo:${Region}:${Account}:api-key/${KeyName}
|
|
geofence-collection |
arn:${Partition}:geo:${Region}:${Account}:geofence-collection/${GeofenceCollectionName}
|
|
map |
arn:${Partition}:geo:${Region}:${Account}:map/${MapName}
|
|
place-index |
arn:${Partition}:geo:${Region}:${Account}:place-index/${IndexName}
|
|
route-calculator |
arn:${Partition}:geo:${Region}:${Account}:route-calculator/${CalculatorName}
|
|
tracker |
arn:${Partition}:geo:${Region}:${Account}:tracker/${TrackerName}
|
Amazon Location の条件キー
Amazon Location では、IAM ポリシーの Condition
要素で使用できる以下の条件キーを定義します。これらのキーを使用して、ポリシーステートメントが適用される条件をさらに絞り込むことができます。以下の表の列の詳細については、「条件キーテーブル」を参照してください。
すべてのサービスで使用できるグローバル条件キーを確認するには、「使用できるグローバル条件キー」を参照してください。
条件キー | 説明 | タイプ |
---|---|---|
aws:RequestTag/${TagKey} | リクエスト内のタグのキーと値でアクセスをフィルター | 文字列 |
aws:ResourceTag/${TagKey} | リクエスト内のタグキーおよび値のペアのプレゼンスによってアクションをフィルタリングします | 文字列 |
aws:TagKeys | リクエスト内のタグキーでアクセスをフィルタリングします | ArrayOfString |
geo:DeviceIds | リクエスト内のデバイス ID の有無でアクセスをフィルタリング | ArrayOfString |
geo:GeofenceIds | リクエスト内のジオフェンス ID の有無でアクセスをフィルタリング | ArrayOfString |