Consulta uma lista de grupos de ativos gerenciados por um bastion host.
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 a ser consultado. 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 no qual você deseja consultar o grupo de hosts. Nota
Para mais informações sobre o mapeamento entre IDs de região e nomes de região, consulte Regiões e zonas. |
cn-hangzhou |
| 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. Valores válidos: 1 a 100. Valor padrão: 20. Se você deixar este parâmetro vazio, 20 entradas serão retornadas em cada página. Nota
Recomendamos que você não deixe este parâmetro vazio. |
20 |
| HostGroupName |
string |
Não |
O nome do grupo de hosts que você deseja consultar. Apenas correspondência exata é suportada. |
HostGroup1 |
Elementos de resposta
|
Elemento |
Tipo |
Descrição |
Exemplo |
|
object |
|||
| TotalCount |
integer |
O número total de grupos de ativos retornados. |
1 |
| RequestId |
string |
O ID da solicitação. |
EC9BF0F4-8983-491A-BC8C-1B4DD94976DE |
| HostGroups |
array<object> |
Os grupos de ativos retornados. |
|
|
object |
|||
| MemberCount |
integer |
O número de hosts no grupo de ativos. |
1 |
| HostGroupId |
string |
O ID do grupo de ativos. |
1 |
| Comment |
string |
As observações do grupo de ativos. |
Comment |
| HostGroupName |
string |
O nome do grupo de ativos. |
HostGroup1 |
Exemplos
Resposta de sucesso
JSON formato
{
"TotalCount": 1,
"RequestId": "EC9BF0F4-8983-491A-BC8C-1B4DD94976DE",
"HostGroups": [
{
"MemberCount": 1,
"HostGroupId": "1",
"Comment": "Comment",
"HostGroupName": "HostGroup1"
}
]
}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.