ListSubjects
Lists the subjects in the authenticated account and Amazon Web Services Region.
Required permissions:
rolesanywhere:ListSubjects.
Request Syntax
GET /subjects?nextToken=nextToken&pageSize=pageSize HTTP/1.1
URI Request Parameters
The request uses the following URI parameters.
- nextToken
-
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.
Length Constraints: Minimum length of 1. Maximum length of 10000.
- pageSize
-
The number of resources in the paginated list.
Request Body
The request does not have a request body.
Response Syntax
HTTP/1.1 200
Content-type: application/json
{
"nextToken": "string",
"subjects": [
{
"createdAt": "string",
"enabled": boolean,
"lastSeenAt": "string",
"subjectArn": "string",
"subjectId": "string",
"updatedAt": "string",
"x509Subject": "string"
}
]
}Response Elements
If the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
- nextToken
-
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.
Type: String
- subjects
-
A list of subjects.
Type: Array of SubjectSummary objects
Errors
For information about the errors that are common to all actions, see Common Errors.
- AccessDeniedException
-
You do not have sufficient access to perform this action.
HTTP Status Code: 403
- ValidationException
-
Validation exception error.
HTTP Status Code: 400
See Also
For more information about using this API in one of the language-specific Amazon SDKs, see the following: