Consulta as informações de uma instância do serviço de arquivos do Agent.
Descrição da operação
Consulta as informações de uma instância do serviço de arquivos do Agent.
Experimente agora
Testar
Autorização RAM
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
Exemplo |
| RegionId |
string |
Sim |
O ID da região. |
cn-hangzhou |
| DBInstanceName |
string |
Sim |
O ID da instância PolarDB-X. |
pxc-xxxxxxxx |
Elementos de resposta
|
Elemento |
Tipo |
Descrição |
Exemplo |
|
object |
Os parâmetros de resposta. |
||
| RequestId |
string |
O ID da solicitação. |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
| Data |
object |
Os dados da resposta. |
|
| Instance |
object |
As informações da instância. |
|
| InstanceId |
string |
O ID da instância associada. |
pxc-xxxxxxxx |
| DBInstanceName |
string |
O ID da instância PolarDB-X. |
pxc-xxxxxxxx |
| PxfsInstanceId |
string |
O ID da instância do serviço de arquivos do Agent. |
pxfs-xxxxxxxx |
| RegionId |
string |
O ID da região. |
cn-hangzhou |
| ZoneId |
string |
O ID da zona. |
cn-hangzhou-h |
| ClassCode |
string |
A especificação do nó. |
polarx.pxfs.x4.xlarge |
| NodeCount |
integer |
O número de nós. |
3 |
| StorageSize |
integer |
O tamanho do armazenamento. |
500 |
| CreateTime |
string |
A hora de criação. |
2026-09-03T12:00:00Z |
| Status |
string |
O status. |
ACTIVE |
| StorageType |
string |
O tipo de armazenamento. |
cloud_essd |
| VPCId |
string |
O ID da nuvem privada virtual (VPC). |
vpc-xxxxxxxx |
| VSwitchId |
string |
O ID do vSwitch. |
vsw-xxxxxxxx |
| Version |
string |
A versão atual. |
1.0.0 |
| ConnAddrs |
array<object> |
A lista de endereços de conexão. |
|
|
object |
O endereço de conexão. |
||
| Type |
string |
O tipo de conexão. |
Intranet |
| Endpoint |
string |
O endpoint. |
agent-files.example.com |
| ConnectionString |
string |
A string de conexão. |
agent-files.example.com:12049 |
| Port |
integer |
O número da porta. |
12049 |
| Protocol |
string |
O protocolo de acesso. |
NFS |
| Transport |
string |
O protocolo de transporte. |
TLS |
| TlsEnabled |
boolean |
Indica se o TLS está ativado. |
true |
| VPCId |
string |
O ID da nuvem privada virtual (VPC). |
vpc-xxxxxxxx |
| VSwitchId |
string |
O ID do vSwitch. |
vsw-xxxxxxxx |
| AccessDeniedDetail |
object |
Os detalhes sobre a negação de acesso. |
|
| AuthAction |
string |
A ação de autorização. Igual ao descrito acima. |
xxx |
| AuthPrincipalType |
string |
A ação de autorização. Igual ao descrito acima. |
222 |
| AuthPrincipalOwnerId |
string |
O ID do proprietário do principal de autenticação. |
111 |
| AuthPrincipalDisplayName |
string |
O nome de exibição do principal de autenticação. |
xxx |
| PolicyType |
string |
O tipo de política. |
PRIORITY |
| NoPermissionType |
string |
O tipo de permissão ausente. |
ImplicitDeny |
| EncodedDiagnosticMessage |
string |
A mensagem de diagnóstico codificada. |
AQEAAAAAaKPfwjY0MzMyODRGLUZCQkQtNTA1RS04MUUxLTc5NTkzODk2MUIzMg== |
Exemplos
Resposta de sucesso
JSON formato
{
"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=="
}
}Códigos de erro
Consulte Códigos de Erro para uma lista completa.
Notas de versão
Consulte Notas de Versão para uma lista completa.