Lists the roots that are defined in the current organization.
Always check the NextToken response parameter
for a null value when calling a List* operation. These operations can
occasionally return an empty set of results even when there are more results available. The
NextToken response parameter value is nullonly
when there are no more results to display.
This operation can be called only from the organization's
management account or by a member account that is a delegated administrator for an Amazon Web Services service.
Policy types can be enabled and disabled in roots. This is distinct from whether
they're available in the organization. When you enable all features, you make policy
types available for use in that organization. Individual policy types can then be
enabled and disabled in a root. To see the availability of a policy type in an
organization, use DescribeOrganization.
example
Use a bare-bones client and the command you need to make an API call.
Lists the roots that are defined in the current organization.
Always check the
NextTokenresponse parameter for anullvalue when calling aList*operation. These operations can occasionally return an empty set of results even when there are more results available. TheNextTokenresponse parameter value isnullonly when there are no more results to display.This operation can be called only from the organization's management account or by a member account that is a delegated administrator for an Amazon Web Services service.
Policy types can be enabled and disabled in roots. This is distinct from whether they're available in the organization. When you enable all features, you make policy types available for use in that organization. Individual policy types can then be enabled and disabled in a root. To see the availability of a policy type in an organization, use DescribeOrganization.
Use a bare-bones client and the command you need to make an API call.
import { OrganizationsClient, ListRootsCommand } from "@aws-sdk/client-organizations"; // ES Modules import // const { OrganizationsClient, ListRootsCommand } = require("@aws-sdk/client-organizations"); // CommonJS import const client = new OrganizationsClient(config); const command = new ListRootsCommand(input); const response = await client.send(command);ListRootsCommandInput for command's
inputshape.ListRootsCommandOutput for command's
responseshape.config for OrganizationsClient's
configshape.