本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
Amazon Location 的動作、資源與條件索引鍵
Amazon Location (服務字首：geo) 提供以下服務特定的資源、動作和條件內容索引鍵，以使用 IAM 許可政策。
參考資料：
-
了解如何設定此服務。
-
檢視可供此服務使用的 API 操作清單。
-
了解如何使用 IAM 許可政策來保護此服務及其資源。
Amazon Location 定義的動作
您可在 IAM 政策陳述式的 Action 元素中指定以下動作。使用政策來授予在 AWS中執行操作的許可。在政策中使用動作時，通常會允許或拒絕存取相同名稱的 API 操作或 CLI 命令。不過，在某些情況下，單一動作可控制對多個操作的存取。或者，某些操作需要多種不同的動作。
「動作」資料表的資源類型欄會指出每個動作是否支援資源層級的許可。如果此欄沒有值，您必須在政策陳述式的 Resource 元素中指定政策適用的所有資源 ("*")。如果資料欄包含資源類型，則您可以在具有該動作的陳述式中指定該類型的 ARN。如果動作具有一或多個必要資源，呼叫者必須具有對這些資源使用動作的許可。表格中的必要資源會以星號 (*) 表示。如果您使用 IAM 政策中的 Resource 元素限制資源存取，則每種必要的資源類型必須要有 ARN 或模式。某些動作支援多種資源類型。如果資源類型是選用 (未顯示為必要)，則您可以選擇使用其中一種選用資源類型。
「動作」資料表的條件索引鍵欄包含您可以在政策陳述式的 Condition 元素中指定的索引鍵。如需有關與服務資源相關聯之條件索引鍵的詳細資訊，請參閱「資源類型」資料表的條件索引鍵欄。
注意
資源條件索引鍵會列在資源類型資料表中。您可以在「動作」資料表的資源類型 (*必填) 欄中找到適用於動作的資源類型連結。「資源類型」資料表中的資源類型包括條件索引鍵欄，其中包含套用至「動作」資料表中動作的資源條件索引鍵。
如需下表各欄的詳細資訊，請參閱動作資料表。
| 動作 | 描述 | 存取層級 | 資源類型 (*必填項目) | 條件索引鍵 | 相依動作 |
|---|---|---|---|---|---|
| AssociateTrackerConsumer | 准許建立地理柵欄集合與追蹤器資源的關聯 | 寫入 | |||
| BatchDeleteDevicePositionHistory | 准許從追蹤器資源刪除一批裝置位置歷史記錄 | 寫入 | |||
| BatchDeleteGeofence | 准許從地理柵欄集合刪除批次地理柵欄 | 寫入 | |||
| BatchEvaluateGeofences | 准許根據指定地理柵欄集合中地理柵欄位置評估裝置位置 | 寫入 | |||
| BatchGetDevicePosition | 准許傳送批次請求以擷取裝置位置 | 讀取 | |||
| BatchPutGeofence | 准許傳送批次請求，以便將地理柵欄新增至指定的地理柵欄集合 | 寫入 | |||
| BatchUpdateDevicePosition | 准許將一或多個裝置的位置更新上傳至追蹤器資源 | 寫入 | |||
| CalculateRoute | 准許使用指定路由計算器資源計算路由 | 讀取 | |||
| CalculateRouteMatrix | 准許使用指定路由計算器資源計算路由矩陣 | 讀取 | |||
| CreateGeofenceCollection | 准許建立地理柵欄集合 | 寫入 | |||
| CreateKey | 准許建立 API 金鑰資源 | 寫入 | |||
| CreateMap | 准許建立地圖資源 | 寫入 | |||
| CreatePlaceIndex | 准許建立位置索引資源 | 寫入 | |||
| CreateRouteCalculator | 准許建立路由計算器資源 | 寫入 | |||
| CreateTracker | 准許建立追蹤器資源 | 寫入 | |||
| DeleteGeofenceCollection | 准許刪除地理柵欄集合 | 寫入 | |||
| DeleteKey | 准許刪除 API 金鑰資源 | 寫入 | |||
| DeleteMap | 准許刪除地圖資源 | 寫入 | |||
| DeletePlaceIndex | 准許刪除地點索引資源 | 寫入 | |||
| DeleteRouteCalculator | 准許刪除路由計算器資源 | 寫入 | |||
| DeleteTracker | 准許刪除追蹤器資源 | 寫入 | |||
| DescribeGeofenceCollection | 准許擷取地理柵欄集合詳細資訊 | 讀取 | |||
| DescribeKey | 准許擷取 API 金鑰資源詳細資訊和秘密 | 讀取 | |||
| DescribeMap | 准許擷取地圖資源詳細資訊 | 讀取 | |||
| DescribePlaceIndex | 准許擷取地點索引資源詳細資訊 | 讀取 | |||
| DescribeRouteCalculator | 准許擷取路由計算器資源詳細資訊 | 讀取 | |||
| DescribeTracker | 准許擷取追蹤器資源詳細資訊 | 讀取 | |||
| DisassociateTrackerConsumer | 准許移除追蹤器資源與地理柵欄集合的關聯 | 寫入 | |||
| ForecastGeofenceEvents | 授予預測存儲在給定地理圍欄集合中的地理圍欄事件的權限 | 讀取 | |||
| GetDevicePosition | 准許擷取最新裝置位置 | 讀取 | |||
| GetDevicePositionHistory | 准許擷取裝置位置歷史記錄 | 讀取 | |||
| GetGeofence | 准許從地理柵欄集合擷取地理柵欄詳細資訊 | 讀取 | |||
| GetMapGlyphs | 准許擷取地圖資源的字符檔案 | 讀取 | |||
| GetMapSprites | 准許擷取地圖資源的精靈圖檔案 | 讀取 | |||
| GetMapStyleDescriptor | 准許從地圖資源擷取地圖樣式描述項 | 讀取 | |||
| GetMapTile | 准許從地圖資源擷取地圖圖磚 | 讀取 | |||
| GetPlace | 准許透過唯一 ID 尋找地點 | 讀取 | |||
| ListDevicePositions | 准許從指定追蹤器資源擷取裝置清單及其最新位置 | 讀取 | |||
| ListGeofenceCollections | 准許列出地理柵欄集合 | 列出 | |||
| ListGeofences | 准許列出儲存在指定地理柵欄集合中的地理柵欄 | 讀取 | |||
| ListKeys | 准許列出 API 金鑰資源 | 清單 | |||
| ListMaps | 准許列出地圖資源 | 列出 | |||
| ListPlaceIndexes | 准許傳回位置索引資源清單 | 列出 | |||
| ListRouteCalculators | 准許傳回路由計算器資源清單 | 列出 | |||
| ListTagsForResource | 准許列出已指派給資源的標籤 (中繼資料) | 讀取 | |||
| ListTrackerConsumers | 准許擷取目前與指定追蹤器資源相關聯的地理柵欄集合清單 | 讀取 | |||
| ListTrackers | 准許傳回追蹤器資源清單 | 列出 | |||
| PutGeofence | 准許新增地理柵欄，或將現有地理柵欄更新至指定的地理柵欄集合 | 寫入 | |||
| SearchPlaceIndexForPosition | 准許對給定座標反向地理編碼 | 讀取 | |||
| SearchPlaceIndexForSuggestions | 准許基於部分或拼寫錯誤的自由格式文字產生地址和景點的建議 | 讀取 | |||
| SearchPlaceIndexForText | 准許地理編碼任意格式文字，例如地址、名稱、城市或地區 | 讀取 | |||
| 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 Monitron 會定義下列條件金鑰，可用於 IAM 政策的 Condition 元素。您可以使用這些索引鍵來縮小套用政策陳述式的條件。如需下表各欄的詳細資訊，請參閱條件索引鍵資料表。
若要檢視所有服務都可使用的全域條件索引鍵，請參閱可用全域條件索引鍵。
| 條件索引鍵 | 描述 | 類型 |
|---|---|---|
| aws:RequestTag/${TagKey} | 依請求中的標籤金鑰和值篩選存取權 | 字串 |
| aws:ResourceTag/${TagKey} | 依請求中的標籤鍵值對是否存在篩選存取權 | 字串 |
| aws:TagKeys | 依請求中的標籤金鑰篩選存取權 | ArrayOf字符串 |
| geo:DeviceIds | 依請求中是否存在裝置 ID 來篩選存取權 | ArrayOf字符串 |
| geo:GeofenceIds | 依請求中是否存在地理柵欄 ID 來篩選存取權 | ArrayOf字符串 |
