View a markdown version of this page

Actions, resources, and condition keys for AWS Marketplace - Service Authorization Reference

Actions, resources, and condition keys for AWS Marketplace

AWS Marketplace (service prefix: aws-marketplace) provides the following service-specific resources, actions, and condition context keys for use in IAM permission policies.

References:

Actions defined by AWS Marketplace

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.

The Access level column of the Actions table describes how the action is classified (List, Read, Permissions management, or Tagging). This classification can help you understand the level of access that an action grants when you use it in a policy. For more information about access levels, see Access levels in policy summaries.

The Resource types column of the Actions table indicates whether each action supports resource-level permissions. If there is no value for this column, you must specify all resources ("*") to which the policy applies in the Resource element of your policy statement. If the column includes a resource type, then you can specify an ARN of that type in a statement with that action. If the action has one or more required resources, the caller must have permission to use the action with those resources. Required resources are indicated in the table with an asterisk (*). If you limit resource access with the Resource element in an IAM policy, you must include an ARN or pattern for each required resource type. Some actions support multiple resource types. If the resource type is optional (not indicated as required), then you can choose to use one of the optional resource types.

The Condition keys column of the Actions table includes keys that you can specify in a policy statement's Condition element. For more information on the condition keys that are associated with resources for the service, see the Condition keys column of the Resource types table.

The Dependent actions column of the Actions table shows additional permissions that may be required to successfully call an action. These permissions may be needed in addition to the permission for the action itself. When an action specifies dependent actions, those dependencies may apply to additional resources defined for that action, not only the first resource listed in the table.

Note

Resource condition keys are listed in the Resource types table. You can find a link to the resource type that applies to an action in the Resource types (*required) column of the Actions table. The resource type in the Resource types table includes the Condition keys column, which are the resource condition keys that apply to an action in the Actions table.

For details about the columns in the following table, see Actions table.

Actions Description Access level Resource types (*required) Condition keys Dependent actions
AcceptAgreementApprovalRequest Grants permission to approve an incoming subscription request (for providers who provide products that require subscription verification) Write
AcceptAgreementCancellationRequest Grants permission to accept an agreement cancellation request Write

aws-marketplace:PartyType

aws-marketplace:AgreementType

AcceptAgreementPaymentRequest Grants permission to accept a payment request Write

aws-marketplace:PartyType

aws-marketplace:AgreementType

AcceptAgreementRequest Grants permission to accept an agreement request Write

aws-marketplace:AgreementType

aws-marketplace:ProductId

BatchCreateBillingAdjustmentRequest Grants permission to create a billing adjustment request against an agreement Write

aws-marketplace:PartyType

aws-marketplace:AgreementType

CancelAgreement Grants permission to cancel agreements Write

aws-marketplace:AgreementType

CancelAgreementCancellationRequest Grants permission to cancel a pending agreement cancellation request Write

aws-marketplace:PartyType

aws-marketplace:AgreementType

CancelAgreementPaymentRequest Grants permission to cancel a payment request Write

aws-marketplace:PartyType

aws-marketplace:AgreementType

CancelAgreementRequest Grants permission to cancel pending subscription requests for products that require subscription verification Write
CreateAgreementRequest Grants permission to create an agreement request Write

aws-marketplace:AgreementType

aws-marketplace:ProductId

DescribeAgreement Grants permission to describe the metadata about the agreement Read

aws-marketplace:PartyType

aws-marketplace:AgreementType

GetAgreementApprovalRequest Grants permission to view the details of incoming subscription requests (for providers who provide products that require subscription verification) Read
GetAgreementCancellationRequest Grants permission to view the details of an agreement cancellation request Read

aws-marketplace:PartyType

aws-marketplace:AgreementType

GetAgreementEntitlements Grants permission to get the entitlements associated with an agreement Read

aws-marketplace:AgreementType

GetAgreementPaymentRequest Grants permission to view details for a payment request Read

aws-marketplace:PartyType

aws-marketplace:AgreementType

GetAgreementRequest Grants permission to view the details of subscription requests for data products that require subscription verification Read
GetAgreementTerms Grants permission to get a list of terms for an agreement List

aws-marketplace:PartyType

aws-marketplace:AgreementType

GetBillingAdjustmentRequest Grants permission to view the details of a billing adjustment request Read

aws-marketplace:PartyType

aws-marketplace:AgreementType

ListAgreementApprovalRequests Grants permission to list incoming subscription requests (for providers who provide products that require subscription verification) List
ListAgreementCancellationRequests Grants permission to list agreement cancellation requests List

aws-marketplace:PartyType

aws-marketplace:AgreementType

ListAgreementCharges Grants permission to list charges associated with an agreement List

aws-marketplace:AgreementType

ListAgreementInvoiceLineItems Grants permission to list invoice line items for an agreement List

aws-marketplace:PartyType

aws-marketplace:AgreementType

ListAgreementPaymentRequests Grants permission to list payment requests for an agreement List

aws-marketplace:PartyType

aws-marketplace:AgreementType

ListAgreementRequests Grants permission to list subscription requests for products that require subscription verification List
ListBillingAdjustmentRequests Grants permission to list billing adjustment requests List

aws-marketplace:PartyType

aws-marketplace:AgreementType

ListEntitlementDetails Grants permission to list details of the entitlements associated with an agreement. Note that this action is not applicable to Marketplace purchases Read
RejectAgreementApprovalRequest Grants permission to decline an incoming subscription requests (for providers who provide products that require subscription verification) Write
RejectAgreementCancellationRequest Grants permission to reject an agreement cancellation request Write

aws-marketplace:PartyType

aws-marketplace:AgreementType

RejectAgreementPaymentRequest Grants permission to reject a payment request Write

aws-marketplace:PartyType

aws-marketplace:AgreementType

SearchAgreements Grants permission to search agreements List

aws-marketplace:PartyType

aws-marketplace:AgreementType

SendAgreementCancellationRequest Grants permission to send an agreement cancellation request Write

aws-marketplace:PartyType

aws-marketplace:AgreementType

SendAgreementPaymentRequest Grants permission to send a payment request Write

aws-marketplace:PartyType

aws-marketplace:AgreementType

Subscribe Grants permission to subscribe to AWS Marketplace products. Includes the ability to send a subscription request for products that require subscription verification. Includes the ability to enable auto-renewal for an existing subscription Write
Unsubscribe Grants permission to unsubscribe from AWS Marketplace products. Includes the ability to disable auto-renewal for an existing subscription Write
UpdateAgreementApprovalRequest Grants permission to make changes to an incoming subscription request, including the ability to delete the prospective subscriber's information (for providers who provide products that require subscription verification) Write
UpdatePurchaseOrders Grants permission to update purchase orders for charges associated with an agreement Write

aws-marketplace:AgreementType

ViewSubscriptions Grants permission to view account's subscriptions List

Resource types defined by AWS Marketplace

AWS Marketplace does not support specifying a resource ARN in the Resource element of an IAM policy statement. To allow access to AWS Marketplace, specify "Resource": "*" in your policy.

Condition keys for AWS Marketplace

AWS Marketplace defines the following condition keys that can be used in the Condition element of an IAM policy. You can use these keys to further refine the conditions under which the policy statement applies. For details about the columns in the following table, see Condition keys table.

To view the global condition keys that are available to all services, see AWS global condition context keys.

Condition keys Description Type
aws-marketplace:AgreementType Filters access by the type of the agreement ArrayOfString
aws-marketplace:PartyType Filters access by the party type of the agreement String
aws-marketplace:ProductId Filters access by product id for AWS Marketplace purchases ArrayOfString