ListRoles (POST)
- 17 Sep 2026
- Print
- DarkLight
ListRoles (POST)
- Updated on 17 Sep 2026
- Print
- DarkLight
Article summary
Did you find this summary helpful?
Thank you for your feedback
Post
/#/ListRoles
Availability
Early Access: July 1, 2026
Early Access is gated; contact the Backblaze Sales team for access.
Limited Availability: July 1, 2026
This API is available only to customers with access to the Backblaze Enterprise Web Console. For more information, contact the Backblaze Sales team.
POST form-encoded variant. The form body must contain Action=ListRoles&Version=2010-05-08&....
Security
API Key: sigv4
Header parameter nameAuthorization
AWS Signature Version 4. The Authorization header takes the form AWS4-HMAC-SHA256 Credential=..., SignedHeaders=..., Signature=.... For IAM and STS requests, the signing region is not validated; use any non-empty region value consistently. The signing service must be iam for IAM requests and sts for STS requests. When using temporary credentials, also include X-Amz-Security-Token: <session-token>.
Body parameters
object
Action
string Required
Valid values[ "ListRoles" ]
Version
string Required
Valid values[ "2010-05-08" ]
PathPrefix
string
Marker
string
MaxItems
integer
Minimum1
Maximum1000
Responses
200
The request succeeded. The response body is an XML document specific to the Action invoked, with a ResponseMetadata block containing a RequestId.
string
Action-specific XML response. See the example response for each operation.
400
The request was malformed or failed validation.
| HTTP Status | Code | Description |
|---|---|---|
| 400 | ValidationError | Invalid input parameter or failed validation. |
string
403
The caller is not authorized. For operations that reference IAM resources, authorization may be evaluated before resource existence is disclosed.
| HTTP Status | Code | Description |
|---|---|---|
| 403 | AccessDenied | The authenticated principal lacks permission for this action. |
string
429
The request was rate-limited.
| HTTP Status | Code | Description |
|---|---|---|
| 429 | Throttling | Too many requests. Use exponential backoff. |
string
500
The server encountered an unexpected condition.
| HTTP Status | Code | Description |
|---|---|---|
| 500 | InternalFailure | Unexpected server error. |
string
Was this article helpful?