Consulte les informations d'une instance de service de fichiers Agent.
Description de l'opération
Consulte les informations d'une instance de service de fichiers Agent.
Testez maintenant
Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.
Test
Autorisation RAM
Paramètres de requête
|
Paramètre |
Type |
Requis |
Description |
Exemple |
| RegionId |
string |
Oui |
L'identifiant de la région. |
cn-hangzhou |
| DBInstanceName |
string |
Oui |
L'identifiant de l'instance PolarDB-X. |
pxc-xxxxxxxx |
Éléments de réponse
|
Élément |
Type |
Description |
Exemple |
|
object |
Les paramètres de réponse. |
||
| RequestId |
string |
L'identifiant de la requête. |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
| Data |
object |
Les données de réponse. |
|
| Instance |
object |
Les informations sur l'instance. |
|
| InstanceId |
string |
L'identifiant de l'instance associée. |
pxc-xxxxxxxx |
| DBInstanceName |
string |
L'identifiant de l'instance PolarDB-X. |
pxc-xxxxxxxx |
| PxfsInstanceId |
string |
L'identifiant de l'instance de service de fichiers Agent. |
pxfs-xxxxxxxx |
| RegionId |
string |
L'identifiant de la région. |
cn-hangzhou |
| ZoneId |
string |
L'identifiant de la zone. |
cn-hangzhou-h |
| ClassCode |
string |
La spécification du nœud. |
polarx.pxfs.x4.xlarge |
| NodeCount |
integer |
Le nombre de nœuds. |
3 |
| StorageSize |
integer |
La taille du stockage. |
500 |
| CreateTime |
string |
L'heure de création. |
2026-09-03T12:00:00Z |
| Status |
string |
L'état. |
ACTIVE |
| StorageType |
string |
Le type de stockage. |
cloud_essd |
| VPCId |
string |
L'identifiant du cloud privé virtuel (VPC). |
vpc-xxxxxxxx |
| VSwitchId |
string |
L'identifiant du vSwitch. |
vsw-xxxxxxxx |
| Version |
string |
La version actuelle. |
1.0.0 |
| ConnAddrs |
array<object> |
La liste des adresses de connexion. |
|
|
object |
L'adresse de connexion. |
||
| Type |
string |
Le type de connexion. |
Intranet |
| Endpoint |
string |
Le point de terminaison. |
agent-files.example.com |
| ConnectionString |
string |
La chaîne de connexion. |
agent-files.example.com:12049 |
| Port |
integer |
Le numéro de port. |
12049 |
| Protocol |
string |
Le protocole d'accès. |
NFS |
| Transport |
string |
Le protocole de transport. |
TLS |
| TlsEnabled |
boolean |
Indique si TLS est activé. |
true |
| VPCId |
string |
L'identifiant du cloud privé virtuel (VPC). |
vpc-xxxxxxxx |
| VSwitchId |
string |
L'identifiant du vSwitch. |
vsw-xxxxxxxx |
| AccessDeniedDetail |
object |
Les détails concernant le refus d'accès. |
|
| AuthAction |
string |
L'action d'autorisation. Identique à la description ci-dessus. |
xxx |
| AuthPrincipalType |
string |
L'action d'autorisation. Identique à la description ci-dessus. |
222 |
| AuthPrincipalOwnerId |
string |
L'identifiant du propriétaire du principal d'authentification. |
111 |
| AuthPrincipalDisplayName |
string |
Le nom d'affichage du principal d'authentification. |
xxx |
| PolicyType |
string |
Le type de stratégie. |
PRIORITY |
| NoPermissionType |
string |
Le type d'autorisation manquante. |
ImplicitDeny |
| EncodedDiagnosticMessage |
string |
Le message de diagnostic encodé. |
AQEAAAAAaKPfwjY0MzMyODRGLUZCQkQtNTA1RS04MUUxLTc5NTkzODk2MUIzMg== |
Exemples
JSON format
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
"Data": {
"Instance": {
"InstanceId": "pxc-xxxxxxxx",
"DBInstanceName": "pxc-xxxxxxxx",
"PxfsInstanceId": "pxfs-xxxxxxxx",
"RegionId": "cn-hangzhou",
"ZoneId": "cn-hangzhou-h",
"ClassCode": "polarx.pxfs.x4.xlarge",
"NodeCount": 3,
"StorageSize": 500,
"CreateTime": "2026-09-03T12:00:00Z",
"Status": "ACTIVE",
"StorageType": "cloud_essd",
"VPCId": "vpc-xxxxxxxx",
"VSwitchId": "vsw-xxxxxxxx",
"Version": "1.0.0",
"ConnAddrs": [
{
"Type": "Intranet",
"Endpoint": "agent-files.example.com",
"ConnectionString": "agent-files.example.com:12049",
"Port": 12049,
"Protocol": "NFS",
"Transport": "TLS",
"TlsEnabled": true,
"VPCId": "vpc-xxxxxxxx",
"VSwitchId": "vsw-xxxxxxxx"
}
]
}
},
"AccessDeniedDetail": {
"AuthAction": "xxx",
"AuthPrincipalType": "222",
"AuthPrincipalOwnerId": "111",
"AuthPrincipalDisplayName": "xxx",
"PolicyType": "PRIORITY",
"NoPermissionType": "ImplicitDeny",
"EncodedDiagnosticMessage": "AQEAAAAAaKPfwjY0MzMyODRGLUZCQkQtNTA1RS04MUUxLTc5NTkzODk2MUIzMg=="
}
}
Codes d'erreur
Consultez Codes d'erreur pour la liste complète.
Notes de version
Consultez Notes de version pour la liste complète.