本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
Amazon OpenSearch Service 的動作、資源和條件索引鍵
Amazon OpenSearch Service (服務字首:es
) 提供下列服務特定的資源、動作和條件內容索引鍵,可用於 IAM 許可政策。
參考資料:
-
了解如何設定此服務。
-
檢視API此服務可用的操作清單。
-
了解如何使用 IAM 許可政策來保護此服務及其資源。
Amazon OpenSearch Service 定義的動作
您可在 IAM 政策陳述式的 Action
元素中指定以下動作。使用政策來授予在 AWS中執行操作的許可。當您在政策中使用 動作時,通常會允許或拒絕存取具有相同名稱API的操作或CLI命令。不過,在某些情況下,單一動作可控制對多個操作的存取。或者,某些操作需要多種不同的動作。
「動作」資料表的資源類型欄會指出每個動作是否支援資源層級的許可。如果此欄沒有值,您必須在政策陳述式的 Resource
元素中指定政策適用的所有資源 ("*")。如果資料欄包含資源類型,則您可以在具有該動作ARN的陳述式中指定該類型的 。如果動作具有一或多個必要資源,呼叫者必須具有對這些資源使用動作的許可。表格中的必要資源會以星號 (*) 表示。如果您在 IAM 政策中限制使用 Resource
元素存取資源,您必須為每個必要的資源類型包含 ARN或 模式。某些動作支援多種資源類型。如果資源類型是選用 (未顯示為必要),則您可以選擇使用其中一種選用資源類型。
「動作」資料表的條件索引鍵欄包含您可以在政策陳述式的 Condition
元素中指定的索引鍵。如需有關與服務資源相關聯之條件索引鍵的詳細資訊,請參閱「資源類型」資料表的條件索引鍵欄。
注意
資源條件索引鍵會列在資源類型資料表中。您可以在「動作」資料表的資源類型 (*必填) 欄中找到適用於動作的資源類型連結。「資源類型」資料表中的資源類型包括條件索引鍵欄,其中包含套用至「動作」資料表中動作的資源條件索引鍵。
如需下表各欄的詳細資訊,請參閱動作資料表。
動作 | 描述 | 存取層級 | 資源類型 (*必填項目) | 條件索引鍵 | 相依動作 |
---|---|---|---|---|---|
AcceptInboundConnection | 准許目的地網域擁有者接受傳入的跨叢集搜尋連線請求 | 寫入 | |||
AcceptInboundCrossClusterSearchConnection | 准許目的地網域擁有者接受傳入的跨叢集搜尋連線請求。此許可已過時。請 AcceptInboundConnection 改用 | 寫入 | |||
AddDataSource | 准許新增 OpenSearch 服務網域的資料來源 | 寫入 | |||
AddDirectQueryDataSource | 准許新增所提供 OpenSearch arn 的資料來源 | 寫入 | |||
AddTags | 准許將資源標籤連接至 OpenSearch 服務網域、資料來源或應用程式 | 標記 | |||
AssociatePackage | 准許將套件與服務 OpenSearch 網域建立關聯 | 寫入 | |||
AssociatePackages | 准許將多個套件與服務 OpenSearch 網域建立關聯 | 寫入 | |||
AuthorizeVpcEndpointAccess | 准許透過使用介面VPC端點提供對 Amazon OpenSearch Service 網域的存取 | 寫入 | |||
CancelDomainConfigChange | 准許取消 OpenSearch 服務網域上的變更 | 寫入 | |||
CancelElasticsearchServiceSoftwareUpdate | 准許取消網域的服務軟體更新。此許可已過時。請 CancelServiceSoftwareUpdate 改用 | 寫入 | |||
CancelServiceSoftwareUpdate | 准許取消網域的服務軟體更新 | 寫入 | |||
CreateApplication | 准許建立 OpenSearch 應用程式 | 寫入 | |||
CreateDomain | 准許建立 Amazon OpenSearch Service 網域 | 寫入 | |||
CreateElasticsearchDomain | 准許建立 OpenSearch 服務網域。此許可已過時。請 CreateDomain 改用 | 寫入 | |||
CreateElasticsearchServiceRole | 准許建立使用VPC存取之服務網域所需的 OpenSearch 服務連結角色。此許可已棄用。 OpenSearch 服務會為您建立服務連結角色 | 寫入 | |||
CreateOutboundConnection | 准許建立從來源網域到目的地網域的新跨叢集搜尋連線 | 寫入 | |||
CreateOutboundCrossClusterSearchConnection | 准許建立從來源網域到目的地網域的新跨叢集搜尋連線。此許可已過時。請 CreateOutboundConnection 改用 | 寫入 | |||
CreatePackage | 准許新增套件以與服務 OpenSearch 網域搭配使用 | 寫入 | |||
CreateServiceRole | 准許建立使用VPC存取權的 Amazon OpenSearch Service 網域所需的服務連結角色 | 寫入 | |||
CreateVpcEndpoint | 准許建立 Amazon OpenSearch Service 受管VPC端點 | 寫入 | |||
DeleteApplication | 准許刪除 OpenSearch 應用程式 | 寫入 | |||
DeleteDataSource | 准許刪除 OpenSearch 服務網域的資料來源 | 寫入 | |||
DeleteDirectQueryDataSource | 准許刪除所提供 OpenSearch arn 的資料來源 | 寫入 | |||
DeleteDomain | 准許刪除 Amazon OpenSearch Service 網域及其所有資料 | 寫入 | |||
DeleteElasticsearchDomain | 准許刪除 OpenSearch 服務網域及其所有資料。此許可已過時。請 DeleteDomain 改用 | 寫入 | |||
DeleteElasticsearchServiceRole | 准許刪除使用VPC存取之服務網域所需的 OpenSearch 服務連結角色。此許可已過時。使用 IAMAPI刪除服務連結角色 | 寫入 | |||
DeleteInboundConnection | 准許目的地網域擁有者刪除現有的傳入跨叢集搜尋連線 | 寫入 | |||
DeleteInboundCrossClusterSearchConnection | 准許目的地網域擁有者刪除現有的傳入跨叢集搜尋連線。此許可已過時。請 DeleteInboundConnection 改用 | 寫入 | |||
DeleteOutboundConnection | 准許來源網域擁有者刪除現有的傳出跨叢集搜尋連線 | 寫入 | |||
DeleteOutboundCrossClusterSearchConnection | 准許來源網域擁有者刪除現有的傳出跨叢集搜尋連線。此許可已過時。請 DeleteOutboundConnection 改用 | 寫入 | |||
DeletePackage | 准許從 OpenSearch Service 刪除套件。封裝不得與任何網域相關聯 | 寫入 | |||
DeleteVpcEndpoint | 准許刪除 Amazon OpenSearch Service 受管介面VPC端點 | 寫入 | |||
DescribeDomain | 准許檢視指定 OpenSearch 服務網域的網域組態描述,包括網域 ID、服務端點和 ARN | 讀取 | |||
DescribeDomainAutoTunes | 准許檢視指定 OpenSearch 服務網域之網域的 Auto-Tune 組態,包括 Auto-Tune 狀態和維護排程 | 讀取 | |||
DescribeDomainChangeProgress | 准許檢視 OpenSearch 服務網域的詳細資訊階段進度 | 讀取 | |||
DescribeDomainConfig | 准許檢視 OpenSearch 服務網域組態選項和狀態的描述 | 讀取 | |||
DescribeDomainHealth | 准許檢視網域和節點運作狀態、待命可用區域、每個可用區域的節點數量,以及每個節點碎片計數的相關資訊 | 讀取 | |||
DescribeDomainNodes | 准許檢視為網域設定之節點及其組態的相關資訊 - 節點 ID、節點類型、節點狀態、可用區域、執行個體類型和儲存空間 | 讀取 | |||
DescribeDomains | 准許檢視最多五個指定 OpenSearch 服務網域的網域組態描述 | 清單 | |||
DescribeDryRunProgress | 准許描述 OpenSearch 服務網域上更新前驗證檢查的狀態 | 讀取 | |||
DescribeElasticsearchDomain | 准許檢視指定 OpenSearch 服務網域的網域組態描述,包括網域 ID、服務端點和 ARN。此許可已過時。請 DescribeDomain 改用 | 讀取 | |||
DescribeElasticsearchDomainConfig | 准許檢視 OpenSearch 服務網域的組態和狀態描述。此許可已過時。請 DescribeDomainConfig 改用 | 讀取 | |||
DescribeElasticsearchDomains | 准許檢視最多五個指定 Amazon 網域的 OpenSearch 網域組態描述。此許可已過時。請 DescribeDomains 改用 | 清單 | |||
DescribeElasticsearchInstanceTypeLimits | 准許檢視指定 OpenSearch 版本和執行個體類型的執行個體計數、儲存體和主節點限制。此許可已過時。請 DescribeInstanceTypeLimits 改用 | 清單 | |||
DescribeInboundConnections | 准許列出目的地網域的所有傳入跨叢集搜尋連線 | 列出 | |||
DescribeInboundCrossClusterSearchConnections | 准許列出目的地網域的所有傳入跨叢集搜尋連線。此許可已過時。請 DescribeInboundConnections 改用 | 清單 | |||
DescribeInstanceTypeLimits | 准許檢視指定引擎版本和執行個體類型的執行個體計數、儲存和主節點限制 | 列出 | |||
DescribeOutboundConnections | 准許列出來源網域的所有傳出跨叢集搜尋連線 | 列出 | |||
DescribeOutboundCrossClusterSearchConnections | 准許列出來源網域的所有傳出跨叢集搜尋連線。此許可已過時。請 DescribeOutboundConnections 改用 | 清單 | |||
DescribePackages | 准許描述 OpenSearch 服務網域可用的所有套件 | 讀取 | |||
DescribeReservedElasticsearchInstanceOfferings | 准許擷取 Amazon OpenSearch Service 的預留執行個體優惠。此許可已過時。請 DescribeReservedInstanceOfferings 改用 | 清單 | |||
DescribeReservedElasticsearchInstances | 准許擷取已購買的 OpenSearch 服務預留執行個體。此許可已過時。請 DescribeReservedInstances 改用 | 清單 | |||
DescribeReservedInstanceOfferings | 准許擷取 OpenSearch 服務的預留執行個體優惠 | 清單 | |||
DescribeReservedInstances | 准許擷取已購買的 OpenSearch 服務預留執行個體 | 清單 | |||
DescribeVpcEndpoints | 准許描述一或多個 Amazon OpenSearch Service 受管VPC端點 | 清單 | |||
DissociatePackage | 准許取消套件與指定 OpenSearch 服務網域的關聯 | 寫入 | |||
DissociatePackages | 准許取消多個套件與指定 OpenSearch 服務網域的關聯 | 寫入 | |||
ESCrossClusterGet | 准許將跨叢集要求傳送至目的地網域 | 讀取 | |||
ESHttpDelete | 准許將HTTPDELETE請求傳送至 OpenSearch APIs | 寫入 | |||
ESHttpGet | 准許將HTTPGET請求傳送至 OpenSearch APIs | 讀取 | |||
ESHttpHead | 准許將HTTPHEAD請求傳送至 OpenSearch APIs | 讀取 | |||
ESHttpPatch | 准許將HTTPPATCH請求傳送至 OpenSearch APIs | 寫入 | |||
ESHttpPost | 准許將HTTPPOST請求傳送至 OpenSearch APIs | 寫入 | |||
ESHttpPut | 准許將HTTPPUT請求傳送至 OpenSearch APIs | 寫入 | |||
GetApplication | 准許取得 OpenSearch 應用程式的相關資訊 | 讀取 | |||
GetCompatibleElasticsearchVersions | 准許擷取相容 OpenSearch 和 Elasticsearch 版本的清單,服務 OpenSearch 網域可以升級至該版本。此許可已過時。請 GetCompatibleVersions 改用 | 清單 | |||
GetCompatibleVersions | 准許擷取可升級 OpenSearch 服務網域的相容引擎版本清單 | 清單 | |||
GetDataSource | 准許取得 OpenSearch 服務網域的資料來源 | 讀取 | |||
GetDirectQueryDataSource | 准許取得所提供 OpenSearch arn 的資料來源 | 讀取 | |||
GetDomainMaintenanceStatus | 准許擷取節點的維護動作狀態 | 讀取 | |||
GetPackageVersionHistory | 准許擷取套件的版本歷史 | 讀取 | |||
GetUpgradeHistory | 准許擷取指定 OpenSearch 服務網域的升級歷史記錄 | 讀取 | |||
GetUpgradeStatus | 准許擷取指定 OpenSearch 服務網域的升級狀態 | 讀取 | |||
ListApplications | 准許列出 OpenSearch 應用程式 | 清單 | |||
ListDataSources | 准許擷取 OpenSearch 服務網域的資料來源清單 | 清單 | |||
ListDirectQueryDataSources | 准許擷取所提供 OpenSearch arn 的資料來源清單 | 清單 | |||
ListDomainMaintenances | 准許擷取 OpenSearch 服務網域的維護動作清單 | 清單 | |||
ListDomainNames | 准許顯示目前使用者擁有的所有 OpenSearch 服務網域的名稱 | 清單 | |||
ListDomainsForPackage | 准許列出與套件相關聯的所有 OpenSearch 服務網域 | 清單 | |||
ListElasticsearchInstanceTypeDetails | 准許列出指定 OpenSearch 版本的所有執行個體類型和可用功能。此許可已過時。請 ListInstanceTypeDetails 改用 | 清單 | |||
ListElasticsearchInstanceTypes | 准許列出指定 OpenSearch 版本支援的所有EC2執行個體類型 | 清單 | |||
ListElasticsearchVersions | 准許列出 Amazon OpenSearch Service 上所有支援的 OpenSearch 版本。此許可已過時。請 ListVersions 改用 | 清單 | |||
ListInstanceTypeDetails | 准許列出指定 OpenSearch 或 Elasticsearch 版本的所有執行個體類型和可用功能 | 清單 | |||
ListPackagesForDomain | 准許列出與服務 OpenSearch 網域相關聯的所有套件 | 清單 | |||
ListScheduledActions | 准許擷取針對 OpenSearch 服務網域排定的組態變更清單 | 清單 | |||
ListTags | 准許顯示 OpenSearch 服務網域、資料來源或應用程式的所有資源標籤 | 讀取 | |||
ListVersions | 准許列出 Amazon OpenSearch Service 中的所有支援版本 OpenSearch 和 Elasticsearch 版本 | 清單 | |||
ListVpcEndpointAccess | 准許擷取允許透過使用界面VPC端點存取指定 Amazon OpenSearch Service 網域的每個 AWS 主體的資訊 | 清單 | |||
ListVpcEndpoints | 准許擷取目前 AWS 帳戶 和 區域中所有 Amazon OpenSearch Service 受管VPC端點 | 清單 | |||
ListVpcEndpointsForDomain | 准許擷取與特定網域相關聯的所有 Amazon OpenSearch Service 受管VPC端點 | 清單 | |||
PurchaseReservedElasticsearchInstanceOffering | 准許購買 OpenSearch 服務預留執行個體。此許可已過時。請 PurchaseReservedInstanceOffering 改用 | 寫入 | |||
PurchaseReservedInstanceOffering | 准許購買 OpenSearch 預留執行個體 | 寫入 | |||
RejectInboundConnection | 准許目的地網域擁有者拒絕傳入的跨叢集搜尋連線請求 | 寫入 | |||
RejectInboundCrossClusterSearchConnection | 准許目的地網域擁有者拒絕傳入的跨叢集搜尋連線請求。此許可已過時。請 RejectInboundConnection 改用 | 寫入 | |||
RemoveTags | 准許從 OpenSearch 服務網域、資料來源或應用程式移除資源標籤 | 標記 | |||
RevokeVpcEndpointAccess | 准許撤銷透過介面VPC端點提供的 Amazon OpenSearch Service 網域存取權 | 寫入 | |||
StartDomainMaintenance | 准許在節點上啟動維護 | 寫入 | |||
StartElasticsearchServiceSoftwareUpdate | 准許啟動網域的服務軟體更新 此許可已過時。請 StartServiceSoftwareUpdate 改用 | 寫入 | |||
StartServiceSoftwareUpdate | 准許啟動網域的服務軟體更新 | 寫入 | |||
UpdateApplication | 准許更新 OpenSearch 應用程式 | 寫入 | |||
UpdateDataSource | 准許更新 OpenSearch 服務網域的資料來源 | 寫入 | |||
UpdateDirectQueryDataSource | 准許更新所提供 OpenSearch arn 的資料來源 | 寫入 | |||
UpdateDomainConfig | 准許修改 OpenSearch 服務網域的組態,例如執行個體類型或執行個體數量 | 寫入 | |||
UpdateElasticsearchDomainConfig | 准許修改 OpenSearch 服務網域的組態,例如執行個體類型或執行個體數量。此許可已過時。請 UpdateDomainConfig 改用 | 寫入 | |||
UpdatePackage | 准許更新套件以與服務 OpenSearch 網域搭配使用 | 寫入 | |||
UpdatePackageScope | 准許更新套件的範圍 | 寫入 | |||
UpdateScheduledAction | 准許在稍後重新排程規劃 OpenSearch 的服務網域組態變更 | 寫入 | |||
UpdateVpcEndpoint | 准許修改 Amazon OpenSearch Service 受管介面VPC端點 | 寫入 | |||
UpgradeDomain | 准許啟動將 OpenSearch 服務網域升級至指定的版本 | 寫入 | |||
UpgradeElasticsearchDomain | 准許啟動將 OpenSearch 服務網域升級至指定的版本。此許可已過時。請 UpgradeDomain 改用 | 寫入 |
Amazon OpenSearch Service 定義的資源類型
此服務會定義下列資源類型,並可用在 IAM 許可政策陳述式的 Resource
元素中。動作表格中的每個動作都代表可使用該動作指定的資源類型。資源類型也能定義您可以在政策中包含哪些條件索引鍵。這些索引鍵都會顯示在「資源類型」資料表的最後一欄。如需下表各欄的詳細資訊,請參閱資源類型資料表。
資源類型 | ARN | 條件索引鍵 |
---|---|---|
domain |
arn:${Partition}:es:${Region}:${Account}:domain/${DomainName}
|
|
application |
arn:${Partition}:opensearch:${Region}:${Account}:application/${AppId}
|
|
es_role |
arn:${Partition}:iam::${Account}:role/aws-service-role/es.amazonaws.com/AWSServiceRoleForAmazonOpenSearchService
|
|
opensearchservice_role |
arn:${Partition}:iam::${Account}:role/aws-service-role/opensearchservice.amazonaws.com/AWSServiceRoleForAmazonOpenSearchService
|
|
datasource |
arn:${Partition}:opensearch:${Region}:${Account}:datasource/${DataSourceName}
|
Amazon OpenSearch Service 的條件索引鍵
Amazon OpenSearch Service 定義下列條件索引鍵,可用於 IAM政策的 Condition
元素。您可以使用這些索引鍵來縮小套用政策陳述式的條件。如需下表各欄的詳細資訊,請參閱條件索引鍵表。
若要檢視所有服務都可使用的全域條件鍵,請參閱可用全域條件鍵。
條件索引鍵 | 描述 | 類型 |
---|---|---|
aws:RequestTag/${TagKey} | 根據請求中傳遞的標籤來篩選存取權 | 字串 |
aws:ResourceTag/${TagKey} | 根據與資源關聯的標籤來篩選存取權 | 字串 |
aws:TagKeys | 根據請求中傳遞的標籤索引鍵來篩選存取權 | ArrayOfString |