- Navigation GuideYou are on a Command (operation) page with structural examples. Use the navigation breadcrumb if you would like to return to the Client landing page.
GetPolicyCommand
Retrieves the current permission policy for a Amazon Q Business application. The policy is returned as a JSON-formatted string and defines the IAM actions that are allowed or denied for the application's resources.
Example Syntax
Use a bare-bones client and the command you need to make an API call.
import { QBusinessClient, GetPolicyCommand } from "@aws-sdk/client-qbusiness"; // ES Modules import
// const { QBusinessClient, GetPolicyCommand } = require("@aws-sdk/client-qbusiness"); // CommonJS import
const client = new QBusinessClient(config);
const input = { // GetPolicyRequest
applicationId: "STRING_VALUE", // required
};
const command = new GetPolicyCommand(input);
const response = await client.send(command);
// { // GetPolicyResponse
// policy: "STRING_VALUE",
// };
GetPolicyCommand Input
Parameter | Type | Description |
|---|
Parameter | Type | Description |
|---|---|---|
applicationIdRequired | string | undefined | The unique identifier of the Amazon Q Business application. |
GetPolicyCommand Output
Parameter | Type | Description |
|---|
Parameter | Type | Description |
|---|---|---|
$metadataRequired | ResponseMetadata | Metadata pertaining to this request. |
policy | string | undefined | The JSON representation of the permission policy. |
Throws
Name | Fault | Details |
|---|
Name | Fault | Details |
|---|---|---|
| AccessDeniedException | client | You don't have access to perform this action. Make sure you have the required permission policies and user accounts and try again. |
| InternalServerException | server | An issue occurred with the internal server used for your Amazon Q Business service. Wait some minutes and try again, or contact Support for help. |
| ResourceNotFoundException | client | The application or plugin resource you want to use doesn’t exist. Make sure you have provided the correct resource and try again. |
| ThrottlingException | client | The request was denied due to throttling. Reduce the number of requests and try again. |
| ValidationException | client | The input doesn't meet the constraints set by the Amazon Q Business service. Provide the correct input and try again. |
| QBusinessServiceException | Base exception class for all service exceptions from QBusiness service. |