Select your cookie preferences

We use essential cookies and similar tools that are necessary to provide our site and services. We use performance cookies to collect anonymous statistics, so we can understand how customers use our site and make improvements. Essential cookies cannot be deactivated, but you can choose “Customize” or “Decline” to decline performance cookies.

If you agree, AWS and approved third parties will also use cookies to provide useful site features, remember your preferences, and display relevant content, including relevant advertising. To accept or decline all non-essential cookies, choose “Accept” or “Decline.” To make more detailed choices, choose “Customize.”

Applications applicationId Policy

Focus mode
Applications applicationId Policy - AWS Serverless Application Repository

URI

/applications/applicationId/policy

HTTP methods

GET

Operation ID: GetApplicationPolicy

Retrieves the policy for the application.

Path parameters
NameTypeRequiredDescription
applicationIdStringTrue

The Amazon Resource Name (ARN) of the application.

Responses
Status codeResponse modelDescription
200ApplicationPolicy

Success

400BadRequestException

One of the parameters in the request is invalid.

403ForbiddenException

The client is not authenticated.

404NotFoundException

The resource (for example, an access policy statement) specified in the request doesn't exist.

429TooManyRequestsException

The client is sending more than the allowed number of requests per unit of time.

500InternalServerErrorException

The AWS Serverless Application Repository service encountered an internal error.

PUT

Operation ID: PutApplicationPolicy

Sets the permission policy for an application. For the list of actions supported for this operation, see Application Permissions .

Path parameters
NameTypeRequiredDescription
applicationIdStringTrue

The Amazon Resource Name (ARN) of the application.

Responses
Status codeResponse modelDescription
200ApplicationPolicy

Success

400BadRequestException

One of the parameters in the request is invalid.

403ForbiddenException

The client is not authenticated.

404NotFoundException

The resource (for example, an access policy statement) specified in the request doesn't exist.

429TooManyRequestsException

The client is sending more than the allowed number of requests per unit of time.

500InternalServerErrorException

The AWS Serverless Application Repository service encountered an internal error.

OPTIONS

Path parameters
NameTypeRequiredDescription
applicationIdStringTrue

The Amazon Resource Name (ARN) of the application.

Responses
Status codeResponse modelDescription
200None

200 response

Schemas

Request bodies

{ "statements": [ { "statementId": "string", "principals": [ "string" ], "actions": [ "string" ], "principalOrgIDs": [ "string" ] } ] }

PUT schema

{ "statements": [ { "statementId": "string", "principals": [ "string" ], "actions": [ "string" ], "principalOrgIDs": [ "string" ] } ] }

Response bodies

{ "statements": [ { "statementId": "string", "principals": [ "string" ], "actions": [ "string" ], "principalOrgIDs": [ "string" ] } ] }

ApplicationPolicy schema

{ "statements": [ { "statementId": "string", "principals": [ "string" ], "actions": [ "string" ], "principalOrgIDs": [ "string" ] } ] }
{ "message": "string", "errorCode": "string" }

BadRequestException schema

{ "message": "string", "errorCode": "string" }
{ "message": "string", "errorCode": "string" }

ForbiddenException schema

{ "message": "string", "errorCode": "string" }
{ "message": "string", "errorCode": "string" }

NotFoundException schema

{ "message": "string", "errorCode": "string" }
{ "message": "string", "errorCode": "string" }

TooManyRequestsException schema

{ "message": "string", "errorCode": "string" }
{ "message": "string", "errorCode": "string" }

InternalServerErrorException schema

{ "message": "string", "errorCode": "string" }

Properties

ApplicationPolicy

Policy statements applied to the application.

PropertyTypeRequiredDescription
statements

Array of type ApplicationPolicyStatement

True

An array of policy statements applied to the application.

ApplicationPolicyStatement

Policy statement applied to the application.

PropertyTypeRequiredDescription
actions

Array of type string

True

For the list of actions supported for this operation, see Application Permissions.

principalOrgIDs

Array of type string

False

The AWS Organizations ID to share the application with.

principals

Array of type string

True

An array of AWS account IDs to share the application with, or * to make the application public.

statementId

string

False

A unique ID for the statement.

BadRequestException

One of the parameters in the request is invalid.

PropertyTypeRequiredDescription
errorCode

string

False

400

message

string

False

One of the parameters in the request is invalid.

ForbiddenException

The client is not authenticated.

PropertyTypeRequiredDescription
errorCode

string

False

403

message

string

False

The client is not authenticated.

InternalServerErrorException

The AWS Serverless Application Repository service encountered an internal error.

PropertyTypeRequiredDescription
errorCode

string

False

500

message

string

False

The AWS Serverless Application Repository service encountered an internal error.

NotFoundException

The resource (for example, an access policy statement) specified in the request doesn't exist.

PropertyTypeRequiredDescription
errorCode

string

False

404

message

string

False

The resource (for example, an access policy statement) specified in the request doesn't exist.

TooManyRequestsException

The client is sending more than the allowed number of requests per unit of time.

PropertyTypeRequiredDescription
errorCode

string

False

429

message

string

False

The client is sending more than the allowed number of requests per unit of time.

See also

For more information about using this API in one of the language-specific AWS SDKs and references, see the following:

GetApplicationPolicy

PutApplicationPolicy

On this page

PrivacySite termsCookie preferences
© 2025, Amazon Web Services, Inc. or its affiliates. All rights reserved.