Consulta uma lista de contas de host que o usuário atual do Resource Access Management (RAM) está autorizado a gerenciar.
Experimente agora
Testar
Autorização RAM
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
Exemplo |
| InstanceId |
string |
Sim |
O ID do bastion host. Nota
Você pode chamar a operação DescribeInstances para consultar o ID do bastion host. |
bastionhost-cn-st220aw**** |
| RegionId |
string |
Não |
O ID da região do bastion host. Nota
Para obter mais informações sobre o mapeamento entre IDs de região e nomes de região, consulte Regiões e zonas. |
cn-hangzhou |
| HostId |
string |
Sim |
O ID do host cujas contas você deseja consultar. Nota
Você pode chamar a operação ListOperationHosts para consultar o ID do host. |
1 |
| PageNumber |
string |
Não |
O número da página. Valor padrão: 1. |
1 |
| PageSize |
string |
Não |
O número de entradas por página. Nota
Recomendamos que você não deixe este parâmetro vazio. |
20 |
| HostAccountName |
string |
Não |
O nome da conta do host a ser consultada. Há suporte apenas para correspondência exata. |
root |
Elementos de resposta
|
Elemento |
Tipo |
Descrição |
Exemplo |
|
object |
|||
| HostAccounts |
array<object> |
As contas de host retornadas. |
|
|
array<object> |
|||
| HasPassword |
boolean |
Indica se uma senha está configurada para a conta do host.
|
true |
| HostAccountId |
string |
O ID da conta do host. |
1 |
| HostAccountName |
string |
O nome da conta do host. |
root |
| HostId |
string |
O ID do host. |
1 |
| HostShareKeyId |
string |
O ID da chave compartilhada associada ao host. |
3 |
| PrivateKeyFingerprint |
string |
A impressão digital da chave privada da conta do host. |
fe:ca:37:42:30:00:9d:95:e6:73:e5:b0:32:0a:**:** |
| ProtocolName |
string |
O protocolo usado pela conta do host.
|
SSH |
| SSHConfig |
object |
Indica se os canais do Secure File Transfer Protocol (SFTP) ou os canais SSH estão ativados para a conta do host que usa o protocolo SSH. |
|
| EnableSFTPChannel |
boolean |
Indicates whether SFTP channels are enabled for the account. |
|
| EnableSSHChannel |
boolean |
Indicates whether SSH channels are enabled for the account. |
|
| RequestId |
string |
O ID da solicitação. |
EC9BF0F4-8983-491A-BC8C-1B4DD94976DE |
| TotalCount |
integer |
O número total de contas de host retornadas. |
1 |
Exemplos
Resposta de sucesso
JSON formato
{
"HostAccounts": [
{
"HasPassword": true,
"HostAccountId": "1",
"HostAccountName": "root",
"HostId": "1",
"HostShareKeyId": "3",
"PrivateKeyFingerprint": "fe:ca:37:42:30:00:9d:95:e6:73:e5:b0:32:0a:**:**",
"ProtocolName": "SSH",
"SSHConfig": {
"EnableSFTPChannel": false,
"EnableSSHChannel": false
}
}
],
"RequestId": "EC9BF0F4-8983-491A-BC8C-1B4DD94976DE",
"TotalCount": 1
}
Códigos de erro
|
Código de status HTTP |
Código de erro |
Mensagem de erro |
Descrição |
|---|---|---|---|
| 400 | InvalidParameter | The argument is invalid. | The argument is invalid. |
| 500 | InternalError | An unknown error occurred. | An unknown error occurred. |
Consulte Códigos de Erro para uma lista completa.
Notas de versão
Consulte Notas de Versão para uma lista completa.