Consulta as regiões onde o Message Queue for Apache RocketMQ está disponível.
Observações de uso
Ao usar o SDK para acessar e gerenciar uma instância do Message Queue for Apache RocketMQ, especifique sequencialmente as informações de duas regiões. Para obter os dados da segunda região, chame a operação OnsRegionList. Essa necessidade ocorre nos seguintes cenários:
Conectar sua aplicação ao Message Queue for Apache RocketMQ: Selecione o endpoint do API gateway mais próximo com base na região de implantação da aplicação e insira o ID da região correspondente. O ID da região permite acessar o Alibaba Cloud API Gateway, pois as instâncias do Message Queue for Apache RocketMQ fornecem serviços de API por meio da plataforma OpenAPI Explorer, também conhecida como POP.
Acessar uma região para gerenciar seus recursos: Especifique a região onde deseja gerenciar os recursos do Message Queue for Apache RocketMQ e insira o ID da região. Consulte o ID da região chamando a operação OnsRegionList.
Limite de QPS
O limite de consultas por segundo (QPS) desta operação é de 50 por usuário. O throttling é acionado quando o número de chamadas à operação por segundo excede esse limite. Como o throttling pode afetar seu negócio, chame esta operação conforme a necessidade. Para mais informações, consulte Limites de QPS.
Informações de autorização
Contas da Alibaba Cloud e usuários RAM podem chamar esta operação sem necessidade de autorização prévia. Para mais detalhes, consulte Políticas e exemplos.
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Exemplo |
Descrição |
|
Action |
String |
Sim |
OnsRegionList |
A operação a ser executada. Defina o valor como OnsRegionList. |
Parâmetros de resposta
|
Parâmetro |
Tipo |
Exemplo |
Descrição |
|
Data |
Array of RegionDo |
Os resultados retornados. |
|
|
RegionDo |
|||
|
OnsRegionId |
String |
cn-hangzhou |
O ID da região. |
|
RegionName |
String |
China (Hangzhou) |
O nome da região. |
|
RequestId |
String |
72D14A84-45E5-4E01-A6DB-F63C4721**** |
O ID da solicitação. Este é um parâmetro comum. Cada solicitação possui um ID exclusivo para facilitar a solução de problemas e a localização de falhas. |
Exemplos
Exemplos de solicitações
http(s)://ons.cn-hangzhou.aliyuncs.com/? Action=OnsRegionList
&<Common request parameters>Exemplos de respostas de sucesso
Formato XML
<OnsRegionListResponse>
<Data>
<RegionDo>
<RegionName>Internet</RegionName>
<OnsRegionId>mq-internet-access</OnsRegionId>
</RegionDo>
<RegionDo>
<RegionName>China (Qingdao)</RegionName>
<OnsRegionId>cn-qingdao</OnsRegionId>
</RegionDo>
<RegionDo>
<RegionName>China (Shenzhen)</RegionName>
<OnsRegionId>cn-shenzhen</OnsRegionId>
</RegionDo>
<RegionDo>
<RegionName>China (Hangzhou)</RegionName>
<OnsRegionId>cn-hangzhou</OnsRegionId>
</RegionDo>
<RegionDo>
<RegionName>China (Beijing)</RegionName>
<OnsRegionId>cn-beijing</OnsRegionId>
</RegionDo>
<RegionDo>
<RegionName>China (Shanghai)</RegionName>
<OnsRegionId>cn-shanghai</OnsRegionId>
</RegionDo>
<RegionDo>
<RegionName>China (Chengdu)</RegionName>
<OnsRegionId>cn-chengdu</OnsRegionId>
</RegionDo>
<RegionDo>
<RegionName>China (Zhangjiakou)</RegionName>
<OnsRegionId>cn-zhangjiakou</OnsRegionId>
</RegionDo>
<RegionDo>
<RegionName>China (Hohhot)</RegionName>
<OnsRegionId>cn-huhehaote</OnsRegionId>
</RegionDo>
<RegionDo>
<RegionName>China (Hong Kong)</RegionName>
<OnsRegionId>cn-hongkong</OnsRegionId>
</RegionDo>
<RegionDo>
<RegionName>Singapore (Singapore)</RegionName>
<OnsRegionId>ap-southeast-1</OnsRegionId>
</RegionDo>
<RegionDo>
<RegionName>Japan (Tokyo)</RegionName>
<OnsRegionId>ap-northeast-1</OnsRegionId>
</RegionDo>
<RegionDo>
<RegionName>Malaysia (Kuala Lumpur)</RegionName>
<OnsRegionId>ap-southeast-3</OnsRegionId>
</RegionDo>
<RegionDo>
<RegionName>India (Mumbai)</RegionName>
<OnsRegionId>ap-south-1</OnsRegionId>
</RegionDo>
<RegionDo>
<RegionName>UAE (Dubai)</RegionName>
<OnsRegionId>me-east-1</OnsRegionId>
</RegionDo>
<RegionDo>
<RegionName>Germany (Frankfurt)</RegionName>
<OnsRegionId>eu-central-1</OnsRegionId>
</RegionDo>
<RegionDo>
<RegionName>US (Silicon Valley)</RegionName>
<OnsRegionId>us-west-1</OnsRegionId>
</RegionDo>
<RegionDo>
<RegionName>US (Virginia)</RegionName>
<OnsRegionId>us-east-1</OnsRegionId>
</RegionDo>
<RegionDo>
<RegionName>Australia (Sydney)</RegionName>
<OnsRegionId>ap-southeast-2</OnsRegionId>
</RegionDo>
<RegionDo>
<RegionName>UK (London)</RegionName>
<OnsRegionId>eu-west-1</OnsRegionId>
</RegionDo>
<RegionDo>
<RegionName>Indonesia (Jakarta)</RegionName>
<OnsRegionId>ap-southeast-5</OnsRegionId>
</RegionDo>
</Data>
<RequestId>72D14A84-45E5-4E01-A6DB-F63C4721****</RequestId>
</OnsRegionListResponse>Formato JSON
{
"Data": {
"RegionDo": [
{
"RegionName": "Internet",
"OnsRegionId": "mq-internet-access"
},
{
"RegionName": "China (Qingdao)",
"OnsRegionId": "cn-qingdao"
},
{
"RegionName": "China (Shenzhen)",
"OnsRegionId": "cn-shenzhen"
},
{
"RegionName": "China (Hangzhou)",
"OnsRegionId": "cn-hangzhou"
},
{
"RegionName": "China (Beijing)",
"OnsRegionId": "cn-beijing"
},
{
"RegionName": "China (Shanghai)",
"OnsRegionId": "cn-shanghai"
},
{
"RegionName": "China (Chengdu)",
"OnsRegionId": "cn-chengdu"
},
{
"RegionName": "China (Zhangjiakou)",
"OnsRegionId": "cn-zhangjiakou"
},
{
"RegionName": "China (Hohhot)",
"OnsRegionId": "cn-huhehaote"
},
{
"RegionName": "China (Hong Kong)",
"OnsRegionId": "cn-hongkong"
},
{
"RegionName": "Singapore (Singapore)",
"OnsRegionId": "ap-southeast-1"
},
{
"RegionName": "Japan (Tokyo)",
"OnsRegionId": "ap-northeast-1"
},
{
"RegionName": "Malaysia (Kuala Lumpur)",
"OnsRegionId": "ap-southeast-3"
},
{
"RegionName": "India (Mumbai)",
"OnsRegionId": "ap-south-1"
},
{
"RegionName": "UAE (Dubai)",
"OnsRegionId": "me-east-1"
},
{
"RegionName": "Germany (Frankfurt)",
"OnsRegionId": "eu-central-1"
},
{
"RegionName": "US (Silicon Valley)",
"OnsRegionId": "us-west-1"
},
{
"RegionName": "US (Virginia)",
"OnsRegionId": "us-east-1"
},
{
"RegionName": "Australia (Sydney)",
"OnsRegionId": "ap-southeast-2"
},
{
"RegionName": "UK (London)",
"OnsRegionId": "eu-west-1"
},
{
"RegionName": "Indonesia (Jakarta)",
"OnsRegionId": "ap-southeast-5"
}
]
},
"RequestId": "72D14A84-45E5-4E01-A6DB-F63C4721****"
}Códigos de erro
Para obter uma lista de códigos de erro, visite o API Error Center.