:ListSubscriptionByTopic

Autorização

Por padrão, apenas contas Alibaba Cloud podem chamar esta operação. Usuários do RAM só conseguem executar essa ação após receberem as permissões necessárias. A tabela a seguir apresenta os detalhes de autorização desta operação. Para mais informações, consulte Políticas e exemplos de autorização.

Descrição

Caso o número total de inscrições ultrapasse o valor do parâmetro x-mns-ret-number especificado na requisição, o sistema retorna o parâmetro NextMarker, que indica a posição inicial da próxima página. Ao enviar uma nova requisição para consultar as inscrições restantes, defina o parâmetro x-mns-marker com o valor retornado no parâmetro NextMarker.

Requisição

Uma requisição é composta pelas seguintes partes:

• Linha de requisição

  GET /topics/$TopicName/subscriptions HTTP/1.1

• Cabeçalhos de requisição específicos da operação

  Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
  x-mns-prefix	String	Não	topic	Prefixo das inscrições a serem consultadas.
  x-mns-marker	Integer	Não	10	Posição inicial da próxima página. Obtenha esse valor a partir do parâmetro NextMarker na resposta anterior.
  x-mns-ret-number	Integer	Não	2	Quantidade máxima de resultados retornados em uma única requisição. Valores válidos: 1 a 1000.

  Para obter mais detalhes sobre outros cabeçalhos de requisição, consulte Parâmetros comuns.

• Corpo da requisição

  Nenhum.

Resposta

Uma resposta contém as seguintes partes:

• Código de status HTTP

  HTTP/1.1 200 OK

• Cabeçalhos de resposta específicos da operação

  Nenhum.

• Corpo da resposta

  O corpo da resposta utiliza o formato XML. Uma lista de subscriptions é retornada, e cada subscription inclui uma subscription URL. Se o total de inscrições exceder o valor do parâmetro x-mns-ret-number, o parâmetro NextMarker será retornado para indicar a posição inicial da próxima página.

Exemplos

Exemplos de requisições

GET /topics/$TopicName/subscriptions HTTP/1.1
x-mns-marker: 10
x-mns-ret-number:2
Host: $AccountId.mns.cn-hangzhou.aliyuncs.com
Date: Tue, 08 Dec 2015 06:16:18 GMT
Authorization: MNS 15B4D3461F177624206A:dXSLY5yGG8Ri5f26ZEmxMCq1****
x-mns-version: 2015-06-06

Exemplos de respostas de sucesso

HTTP/1.1 200 OK
x-mns-request-id:566675B2B2B71C9C1600****
x-mns-version: 2015-06-06

<?xml version="1.0" encoding="utf-8"?>
<Subscriptions xmlns="http://mns.aliyuncs.com/doc/v1/">
    <Subscription>
        <SubscriptionURL>http://$AccountId.mns.cn-hangzhou.aliyuncs.com/$TopicName/subscriptions/$SubscriptionName1</SubscriptionURL>
    </Subscription>
    <Subscription>
        <SubscriptionURL>http://$AccountId.mns.cn-hangzhou.aliyuncs.com/$TopicName/subscriptions/$SubscriptionName2</SubscriptionURL>
    </Subscription>
    <NextMarker>OTczNjU4MTcvYmRwejd6NXluby8yNjg0Mi9+fn5FI1Rlc3RUb3BpYy0xI2JkcHo3ejV5bm8jVGVzdFN1Yi0zLzA=</NextMarker>
</Subscriptions>