import type { MetadataBearer as __MetadataBearer } from "@smithy/types"; import type { DescribePolicyRequest, DescribePolicyResponse } from "../models/models_0"; /** * @public */ export type { __MetadataBearer }; /** * @public * * The input for {@link DescribePolicyCommand}. */ export interface DescribePolicyCommandInput extends DescribePolicyRequest { } /** * @public * * The output of {@link DescribePolicyCommand}. */ export interface DescribePolicyCommandOutput extends DescribePolicyResponse, __MetadataBearer { } declare const DescribePolicyCommand_base: { new (input: DescribePolicyCommandInput): import("@smithy/core/client").CommandImpl; new (input: DescribePolicyCommandInput): import("@smithy/core/client").CommandImpl; getEndpointParameterInstructions(): import("@smithy/types").EndpointParameterInstructions; }; /** *

Retrieves information about a policy.

*

You can only call this operation from the management account or a member account that is a delegated administrator.

* @example * Use a bare-bones client and the command you need to make an API call. * ```javascript * import { OrganizationsClient, DescribePolicyCommand } from "@aws-sdk/client-organizations"; // ES Modules import * // const { OrganizationsClient, DescribePolicyCommand } = require("@aws-sdk/client-organizations"); // CommonJS import * // import type { OrganizationsClientConfig } from "@aws-sdk/client-organizations"; * const config = {}; // type is OrganizationsClientConfig * const client = new OrganizationsClient(config); * const input = { // DescribePolicyRequest * PolicyId: "STRING_VALUE", // required * }; * const command = new DescribePolicyCommand(input); * const response = await client.send(command); * // { // DescribePolicyResponse * // Policy: { // Policy * // PolicySummary: { // PolicySummary * // Id: "STRING_VALUE", * // Arn: "STRING_VALUE", * // Name: "STRING_VALUE", * // Description: "STRING_VALUE", * // Type: "SERVICE_CONTROL_POLICY" || "RESOURCE_CONTROL_POLICY" || "TAG_POLICY" || "BACKUP_POLICY" || "AISERVICES_OPT_OUT_POLICY" || "CHATBOT_POLICY" || "DECLARATIVE_POLICY_EC2" || "SECURITYHUB_POLICY" || "INSPECTOR_POLICY" || "UPGRADE_ROLLOUT_POLICY" || "BEDROCK_POLICY" || "S3_POLICY" || "NETWORK_SECURITY_DIRECTOR_POLICY", * // AwsManaged: true || false, * // }, * // Content: "STRING_VALUE", * // }, * // }; * * ``` * * @param DescribePolicyCommandInput - {@link DescribePolicyCommandInput} * @returns {@link DescribePolicyCommandOutput} * @see {@link DescribePolicyCommandInput} for command's `input` shape. * @see {@link DescribePolicyCommandOutput} for command's `response` shape. * @see {@link OrganizationsClientResolvedConfig | config} for OrganizationsClient's `config` shape. * * @throws {@link AccessDeniedException} (client fault) *

You don't have permissions to perform the requested operation. The user or role that * is making the request must have at least one IAM permissions policy attached that * grants the required permissions. For more information, see Access Management in the * IAM User Guide.

* * @throws {@link AWSOrganizationsNotInUseException} (client fault) *

Your account isn't a member of an organization. To make this request, you must use the * credentials of an account that belongs to an organization.

* * @throws {@link InvalidInputException} (client fault) *

The requested operation failed because you provided invalid values for one or more of * the request parameters. This exception includes a reason that contains additional * information about the violated limit:

* *

Some of the reasons in the following list might not be applicable to this specific * API or operation.

* * * * @throws {@link PolicyNotFoundException} (client fault) *

We can't find a policy with the PolicyId that you specified.

* * @throws {@link ServiceException} (server fault) *

Organizations can't complete your request because of an internal service error. Try again * later.

* * @throws {@link TooManyRequestsException} (client fault) *

You have sent too many requests in too short a period of time. The quota helps protect * against denial-of-service attacks. Try again later.

*

For information about quotas that affect Organizations, see Quotas for Organizations in the * Organizations User Guide.

* * @throws {@link UnsupportedAPIEndpointException} (client fault) *

This action isn't available in the current Amazon Web Services Region.

* * @throws {@link OrganizationsServiceException} *

Base exception class for all service exceptions from Organizations service.

* * * @example To get information about a policy * ```javascript * // The following example shows how to request information about a policy:/n/n * const input = { * PolicyId: "p-examplepolicyid111" * }; * const command = new DescribePolicyCommand(input); * const response = await client.send(command); * /* response is * { * Policy: { * Content: `{\n \"Version\": \"2012-10-17\",\n \"Statement\": [\n {\n \"Effect\": \"Allow\",\n \"Action\": \"*\",\n \"Resource\": \"*\"\n }\n ]\n}`, * PolicySummary: { * Arn: "arn:aws:organizations::111111111111:policy/o-exampleorgid/service_control_policy/p-examplepolicyid111", * AwsManaged: false, * Description: "Enables admins to delegate S3 permissions", * Id: "p-examplepolicyid111", * Name: "AllowAllS3Actions", * Type: "SERVICE_CONTROL_POLICY" * } * } * } * *\/ * ``` * * @public */ export declare class DescribePolicyCommand extends DescribePolicyCommand_base { /** @internal type navigation helper, not in runtime. */ protected static __types: { api: { input: DescribePolicyRequest; output: DescribePolicyResponse; }; sdk: { input: DescribePolicyCommandInput; output: DescribePolicyCommandOutput; }; }; }