View a markdown version of this page

Actions, resources, and condition keys for Amazon OpenSearch - Service Authorization Reference

Actions, resources, and condition keys for Amazon OpenSearch

Amazon OpenSearch (service prefix: opensearch) provides the following service-specific operations, resources, actions, and condition keys for use in IAM permission policies.

References:

API operations defined by Amazon OpenSearch

The following table maps API operations to the IAM actions they authorize. Only condition keys that have static values for the given API and action are listed; for the full set of condition keys supported by each action, see the Actions table.

Operation IAM action Condition key Possible value(s) Access level

AcceptInboundConnection

es:AcceptInboundConnection

Write

es:AcceptInboundCrossClusterSearchConnection

Write

AddDataSource

es:AddDataSource

Write

iam:PassRole

iam:PassedToService

directquery.opensearchservice.amazonaws.com

Write

AddDirectQueryDataSource

es:AddDirectQueryDataSource

Write

es:AddTags

Tagging, Write

iam:PassRole

iam:PassedToService

directquery.opensearchservice.amazonaws.com

Write

AddTags

es:AddTags

Tagging, Write

AssociatePackage

es:AssociatePackage

Write

AssociatePackages

es:AssociatePackages

Write

AttachDataSource

es:AttachDataSource

Write

AuthorizeVpcEndpointAccess

es:AuthorizeVpcEndpointAccess

Write

CancelDomainConfigChange

es:CancelDomainConfigChange

Write

CancelServiceSoftwareUpdate

es:CancelElasticsearchServiceSoftwareUpdate

Write

es:CancelServiceSoftwareUpdate

Write

CreateApplication

es:AddTags

Tagging, Write

es:CreateApplication

Write

iam:PassRole

Write

CreateDomain

es:AddTags

Tagging, Write

es:CreateDomain

Write

es:CreateElasticsearchDomain

Write

iam:PassRole

iam:PassedToService

es.amazonaws.com

Write

CreateIndex

es:CreateIndex

Write

CreateOutboundConnection

es:CreateOutboundConnection

Write

es:CreateOutboundCrossClusterSearchConnection

Write

CreatePackage

es:CreatePackage

Write

CreateVpcEndpoint

es:CreateVpcEndpoint

Write

DeleteApplication

es:DeleteApplication

Write

DeleteDataSource

es:DeleteDataSource

Write

DeleteDirectQueryDataSource

es:DeleteDirectQueryDataSource

Write

DeleteDomain

es:DeleteDomain

Write

es:DeleteElasticsearchDomain

Write

DeleteInboundConnection

es:DeleteInboundConnection

Write

DeleteIndex

es:DeleteIndex

Write

DeleteOutboundConnection

es:DeleteOutboundConnection

Write

es:DeleteOutboundCrossClusterSearchConnection

Write

DeletePackage

es:DeletePackage

Write

DeleteVpcEndpoint

es:DeleteVpcEndpoint

Write

DeregisterCapability

es:DeregisterCapability

Write

DescribeDataSourceAttachment

es:DescribeDataSourceAttachment

Read

DescribeDomain

es:DescribeDomain

Read

es:DescribeElasticsearchDomain

Read

DescribeDomainAutoTunes

es:DescribeDomainAutoTunes

Read

DescribeDomainChangeProgress

es:DescribeDomainChangeProgress

Read

DescribeDomainConfig

es:DescribeDomainConfig

Read

es:DescribeElasticsearchDomainConfig

Read

DescribeDomainHealth

es:DescribeDomainHealth

Read

DescribeDomainNodes

es:DescribeDomainNodes

Read

DescribeDomains

es:DescribeDomains

List

es:DescribeElasticsearchDomains

List

DescribeDryRunProgress

es:DescribeDryRunProgress

Read

DescribeInboundConnections

es:DescribeInboundConnections

List

es:DescribeInboundCrossClusterSearchConnections

List

DescribeInsightDetails

es:DescribeInsightDetails

Read

DescribeInstanceTypeLimits

es:DescribeElasticsearchInstanceTypeLimits

List

es:DescribeInstanceTypeLimits

List

DescribeOutboundConnections

es:DescribeOutboundConnections

List

es:DescribeOutboundCrossClusterSearchConnections

List

DescribePackages

es:DescribePackages

Read

DescribeReservedInstanceOfferings

es:DescribeReservedElasticsearchInstanceOfferings

List

es:DescribeReservedInstanceOfferings

List

DescribeReservedInstances

es:DescribeReservedElasticsearchInstances

List

es:DescribeReservedInstances

List

DescribeVpcEndpoints

es:DescribeVpcEndpoints

List

DetachDataSource

es:DetachDataSource

Write

DissociatePackage

es:DissociatePackage

Write

DissociatePackages

es:DissociatePackages

Write

GetApplication

es:GetApplication

Read

GetCapability

es:GetCapability

Read

GetCompatibleVersions

es:GetCompatibleElasticsearchVersions

List

es:GetCompatibleVersions

List

GetDataSource

es:GetDataSource

Read

GetDefaultApplicationSetting

es:GetDefaultApplicationSetting

Read

GetDirectQueryDataSource

es:GetDirectQueryDataSource

Read

GetDomainMaintenanceStatus

es:GetDomainMaintenanceStatus

Read

GetIndex

es:GetIndex

Read

GetPackageVersionHistory

es:GetPackageVersionHistory

Read

GetUpgradeHistory

es:GetUpgradeHistory

Read

GetUpgradeStatus

es:GetUpgradeStatus

Read

InsightFeedback

es:InsightFeedback

Write

ListApplications

es:ListApplications

List

ListDataSourceAttachments

es:ListDataSourceAttachments

List

ListDataSources

es:ListDataSources

List

ListDirectQueryDataSources

es:ListDirectQueryDataSources

List

ListDomainMaintenances

es:ListDomainMaintenances

List

ListDomainNames

es:ListDomainNames

List

ListDomainsForPackage

es:ListDomainsForPackage

List

ListInsights

es:ListInsights

List

ListInstanceTypeDetails

es:ListElasticsearchInstanceTypeDetails

List

es:ListInstanceTypeDetails

List

ListPackagesForDomain

es:ListPackagesForDomain

List

ListScheduledActions

es:ListScheduledActions

List

ListTags

es:ListTags

Read

ListVersions

es:ListElasticsearchVersions

List

es:ListVersions

List

ListVpcEndpointAccess

es:ListVpcEndpointAccess

List

ListVpcEndpoints

es:ListVpcEndpoints

List

ListVpcEndpointsForDomain

es:ListVpcEndpointsForDomain

List

PurchaseReservedInstanceOffering

es:PurchaseReservedElasticsearchInstanceOffering

Write

es:PurchaseReservedInstanceOffering

Write

PutDefaultApplicationSetting

es:PutDefaultApplicationSetting

Write

RegisterCapability

es:RegisterCapability

Write

RejectInboundConnection

es:RejectInboundConnection

Write

es:RejectInboundCrossClusterSearchConnection

Write

RemoveTags

es:RemoveTags

Tagging, Write

RevokeVpcEndpointAccess

es:RevokeVpcEndpointAccess

Write

RollbackServiceSoftwareUpdate

es:RollbackElasticsearchServiceSoftwareUpdate

Write

es:RollbackServiceSoftwareUpdate

Write

StartDomainMaintenance

es:StartDomainMaintenance

Write

StartServiceSoftwareUpdate

es:StartElasticsearchServiceSoftwareUpdate

Write

es:StartServiceSoftwareUpdate

Write

UpdateApplication

es:UpdateApplication

Write

UpdateDataSource

es:UpdateDataSource

Write

iam:PassRole

iam:PassedToService

directquery.opensearchservice.amazonaws.com

Write

UpdateDirectQueryDataSource

es:UpdateDirectQueryDataSource

Write

iam:PassRole

iam:PassedToService

directquery.opensearchservice.amazonaws.com

Write

UpdateDomainConfig

es:UpdateDomainConfig

Write

es:UpdateElasticsearchDomainConfig

Write

iam:PassRole

iam:PassedToService

es.amazonaws.com

Write

UpdateIndex

es:UpdateIndex

Write

UpdatePackage

es:UpdatePackage

Write

UpdatePackageScope

es:UpdatePackageScope

Write

UpdateScheduledAction

es:UpdateScheduledAction

Write

UpdateVpcEndpoint

es:UpdateVpcEndpoint

Write

UpgradeDomain

es:UpgradeDomain

Write

es:UpgradeElasticsearchDomain

Write

Actions defined by Amazon OpenSearch

You can specify the following actions in the Action element of an IAM policy statement. Use policies to grant permissions to perform an operation in AWS. When you use an action in a policy, you usually allow or deny access to the API operation or CLI command with the same name. However, in some cases, a single action controls access to more than one operation. Alternatively, some operations require several different actions.

Actions Description Resource types (*required) Condition keys Access level

CancelAutoOptimizeJob

Grants permission to cancel submitted Auto Optimize Job

Write

CancelDirectQuery

Grants permission to cancel the query that is submitted on the OpenSearch DataSource resource

datasource*

Write

DeleteAutoOptimizeJob

Grants permission to delete Auto Optimize Job

Write

GetAutoOptimizeJob

Grants permission to get the Auto Optimize Job details

Read

GetDirectQuery

Grants permission to get the query status that are performed on the OpenSearch DataSource resource

datasource*

Read

GetDirectQueryResult

Grants permission to get the results of a query that is performed on the OpenSearch DataSource resource

datasource*

Read

ListAutoOptimizeJobs

Grants permission to retrieve a list of Auto Optimize Jobs

List

StartDirectQuery

Grants permission to start a direct query on the provided OpenSearch DataSource arns

datasource*

Write

SubmitAutoOptimizeJob

Grants permission to create new Auto Optimize Job

Write

Permission-only actions for Amazon OpenSearch

The following actions are defined by Amazon OpenSearch but are not directly invocable through any API operation. They can only be used in IAM policy statements to grant or deny permissions.

Actions Description Resource types (*required) Condition keys Access level

ApplicationAccessAll

Grants permission to access OpenSearch Application

application*

Permissions management, Write

ViewLoginPage

Grants permission to view the login page of an OpenSearch Application

application*

Permissions management, Write

Resource types defined by Amazon OpenSearch

The following resource types are defined by this service and can be used in the Resource element of IAM permission policy statements.

Resource types ARN Condition keys

application

arn:${Partition}:opensearch:${Region}:${Account}:application/${AppId}

datasource

arn:${Partition}:opensearch:${Region}:${Account}:datasource/${DataSourceName}

Condition keys for Amazon OpenSearch

Amazon OpenSearch has no service-specific condition keys that can be used in the Condition element of policy statements.