ListProfilesCommand

Suggest an Edit

Lists all profiles in the authenticated account and Amazon Web Services Region.

Required permissions: rolesanywhere:ListProfiles.

Example Syntax

Use a bare-bones client and the command you need to make an API call.

import { RolesAnywhereClient, ListProfilesCommand } from "@aws-sdk/client-rolesanywhere"; // ES Modules import
// const { RolesAnywhereClient, ListProfilesCommand } = require("@aws-sdk/client-rolesanywhere"); // CommonJS import
const client = new RolesAnywhereClient(config);
const input = { // ListRequest
  nextToken: "STRING_VALUE",
  pageSize: Number("int"),
};
const command = new ListProfilesCommand(input);
const response = await client.send(command);
// { // ListProfilesResponse
//   nextToken: "STRING_VALUE",
//   profiles: [ // ProfileDetails
//     { // ProfileDetail
//       profileId: "STRING_VALUE",
//       profileArn: "STRING_VALUE",
//       name: "STRING_VALUE",
//       requireInstanceProperties: true || false,
//       enabled: true || false,
//       createdBy: "STRING_VALUE",
//       sessionPolicy: "STRING_VALUE",
//       roleArns: [ // RoleArnList
//         "STRING_VALUE",
//       ],
//       managedPolicyArns: [ // ManagedPolicyList
//         "STRING_VALUE",
//       ],
//       createdAt: new Date("TIMESTAMP"),
//       updatedAt: new Date("TIMESTAMP"),
//       durationSeconds: Number("int"),
//       acceptRoleSessionName: true || false,
//       attributeMappings: [ // AttributeMappings
//         { // AttributeMapping
//           certificateField: "STRING_VALUE",
//           mappingRules: [ // MappingRules
//             { // MappingRule
//               specifier: "STRING_VALUE", // required
//             },
//           ],
//         },
//       ],
//     },
//   ],
// };

ListProfilesCommand Input

See ListProfilesCommandInput for more details

Parameter
Type
Description
nextToken
string | undefined

A token that indicates where the output should continue from, if a previous request did not show all results. To get the next results, make the request again with this value.

pageSize
number | undefined

The number of resources in the paginated list.

ListProfilesCommand Output

See ListProfilesCommandOutput for details

Parameter
Type
Description
$metadata
Required
ResponseMetadata
Metadata pertaining to this request.
nextToken
string | undefined

A token that indicates where the output should continue from, if a previous request did not show all results. To get the next results, make the request again with this value.

profiles
ProfileDetail[] | undefined

A list of profiles.

Throws

Name
Fault
Details
AccessDeniedException
client

You do not have sufficient access to perform this action.

ValidationException
client

Validation exception error.

RolesAnywhereServiceException
Base exception class for all service exceptions from RolesAnywhere service.