Queries the access token for the Agent file service.
Operation description
Queries the access token for the Agent file service.
Try it now
Test
RAM authorization
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| RegionId |
string |
Yes |
The region ID. |
cn-hangzhou |
| DBInstanceName |
string |
Yes |
The PolarDB-X instance ID. |
pxc-xxxxxxxx |
| TenantId |
string |
Yes |
The tenant ID. |
tenant-001 |
| IdentityName |
string |
No |
The identity name. |
agent-runtime |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
The response parameters. |
||
| RequestId |
string |
The request ID. |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
| Data |
object |
The response data. |
|
| AccessTokens |
array<object> |
The list of access tokens. |
|
|
object |
The access token. |
||
| TokenId |
string |
Token ID |
token-001 |
| Label |
string |
The token label. |
production-agent |
| Status |
string |
The status. |
ACTIVE |
| ExpiresAt |
string |
The expiration time. |
2026-12-31T23:59:59Z |
| CreateTime |
string |
The creation time. |
2026-09-03T12:00:00Z |
| IdentityName |
string |
The identity name. |
agent-runtime |
| AccessDeniedDetail |
object |
The detailed reason why access was denied. |
|
| AuthAction |
string |
The authorization action. |
xxx |
| AuthPrincipalType |
string |
The type of the authorization principal. |
222 |
| AuthPrincipalOwnerId |
string |
The owner ID of the authorization principal. |
111 |
| AuthPrincipalDisplayName |
string |
The identity used for authorization in the request. |
xxx |
| PolicyType |
string |
The policy type. |
System |
| NoPermissionType |
string |
NoPermissionType |
ImplicitDeny |
| EncodedDiagnosticMessage |
string |
The diagnostic information. |
AQEAAAAAaKPfwjY0MzMyODRGLUZCQkQtNTA1RS04MUUxLTc5NTkzODk2MUIzMg== |
Examples
Success response
JSON format
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
"Data": {
"AccessTokens": [
{
"TokenId": "token-001",
"Label": "production-agent",
"Status": "ACTIVE",
"ExpiresAt": "2026-12-31T23:59:59Z",
"CreateTime": "2026-09-03T12:00:00Z",
"IdentityName": "agent-runtime"
}
]
},
"AccessDeniedDetail": {
"AuthAction": "xxx",
"AuthPrincipalType": "222",
"AuthPrincipalOwnerId": "111",
"AuthPrincipalDisplayName": "xxx",
"PolicyType": "System",
"NoPermissionType": "ImplicitDeny",
"EncodedDiagnosticMessage": "AQEAAAAAaKPfwjY0MzMyODRGLUZCQkQtNTA1RS04MUUxLTc5NTkzODk2MUIzMg=="
}
}Error codes
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.