import type { MetadataBearer as __MetadataBearer } from "@smithy/types"; import type { DisableAWSServiceAccessRequest } from "../models/models_0"; /** * @public */ export type { __MetadataBearer }; /** * @public * * The input for {@link DisableAWSServiceAccessCommand}. */ export interface DisableAWSServiceAccessCommandInput extends DisableAWSServiceAccessRequest { } /** * @public * * The output of {@link DisableAWSServiceAccessCommand}. */ export interface DisableAWSServiceAccessCommandOutput extends __MetadataBearer { } declare const DisableAWSServiceAccessCommand_base: { new (input: DisableAWSServiceAccessCommandInput): import("@smithy/core/client").CommandImpl; new (input: DisableAWSServiceAccessCommandInput): import("@smithy/core/client").CommandImpl; getEndpointParameterInstructions(): import("@smithy/types").EndpointParameterInstructions; }; /** *

Disables the integration of an Amazon Web Services service (the service that is specified by * ServicePrincipal) with Organizations. When you disable integration, the * specified service no longer can create a service-linked role in * new accounts in your organization. This means the service can't * perform operations on your behalf on any new accounts in your organization. The service * can still perform operations in older accounts until the service completes its clean-up * from Organizations.

* *

We * strongly recommend * that * you don't use this command to disable integration between Organizations and the specified * Amazon Web Services service. Instead, use the console or commands that are provided by the * specified service. This lets the trusted service perform any required initialization * when enabling trusted access, such as creating any required resources and any * required clean up of resources when disabling trusted access.

*

For information about how to disable trusted service access to your organization * using the trusted service, see the Learn more link * under the Supports Trusted Access column at Amazon Web Services services that you can use with Organizations. on this page.

*

If you disable access by using this command, it causes the following actions to * occur:

*
    *
  • *

    The service can no longer create a service-linked role in the accounts in * your organization. This means that the service can't perform operations on * your behalf on any new accounts in your organization. The service can still * perform operations in older accounts until the service completes its * clean-up from Organizations.

    *
  • *
  • *

    The service can no longer perform tasks in the member accounts in the * organization, unless those operations are explicitly permitted by the IAM * policies that are attached to your roles. This includes any data aggregation * from the member accounts to the management account, or to a delegated * administrator account, where relevant.

    *
  • *
  • *

    Some services detect this and clean up any remaining data or resources * related to the integration, while other services stop accessing the * organization but leave any historical data and configuration in place to * support a possible re-enabling of the integration.

    *
  • *
*

Using the other service's console or commands to disable the integration ensures * that the other service is aware that it can clean up any resources that are required * only for the integration. How the service cleans up its resources in the * organization's accounts depends on that service. For more information, see the * documentation for the other Amazon Web Services service.

*
*

After you perform the DisableAWSServiceAccess operation, the specified * service can no longer perform operations in your organization's accounts

*

For more information about integrating other services with Organizations, including the * list of services that work with Organizations, see Using Organizations with other Amazon Web Services * services in the Organizations User Guide.

*

You can only call this operation from the management account.

* @example * Use a bare-bones client and the command you need to make an API call. * ```javascript * import { OrganizationsClient, DisableAWSServiceAccessCommand } from "@aws-sdk/client-organizations"; // ES Modules import * // const { OrganizationsClient, DisableAWSServiceAccessCommand } = 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 = { // DisableAWSServiceAccessRequest * ServicePrincipal: "STRING_VALUE", // required * }; * const command = new DisableAWSServiceAccessCommand(input); * const response = await client.send(command); * // {}; * * ``` * * @param DisableAWSServiceAccessCommandInput - {@link DisableAWSServiceAccessCommandInput} * @returns {@link DisableAWSServiceAccessCommandOutput} * @see {@link DisableAWSServiceAccessCommandInput} for command's `input` shape. * @see {@link DisableAWSServiceAccessCommandOutput} 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 ConcurrentModificationException} (client fault) *

The target of the operation is currently being modified by a different request. Try * again later.

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

Performing this operation violates a minimum or maximum value limit. For example, * attempting to remove the last service control policy (SCP) from an OU or root, inviting * or creating too many accounts to the organization, or attaching too many policies to an * account, OU, or root. 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 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 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.

* * * @public */ export declare class DisableAWSServiceAccessCommand extends DisableAWSServiceAccessCommand_base { /** @internal type navigation helper, not in runtime. */ protected static __types: { api: { input: DisableAWSServiceAccessRequest; output: {}; }; sdk: { input: DisableAWSServiceAccessCommandInput; output: DisableAWSServiceAccessCommandOutput; }; }; }