Neste documento, apresentamos informações sobre como criar, excluir e administrar tópicos e assinaturas do Pub/Sub. Para saber mais sobre como publicar e acessar dados de mensagens, consulte o Guia do editor e a Visão geral do assinante.
Como gerenciar tópicos
É possível criar, excluir e visualizar tópicos por meio da API, do Console do Google Cloud ou da ferramenta de linha de comando gcloud
. Consulte a referência do gcloud pubsub
para uma lista completa de comandos gcloud
da API Pub/Sub.
Para uma introdução sobre o Console do Cloud, consulte o Guia de início rápido do Console do Cloud.
Ao criar um tópico, é possível especificar chaves de criptografia próprias. Consulte Como usar chaves de criptografia gerenciadas pelo cliente.
Como criar um tópico
É necessário criar um tópico para poder publicar ou assiná-lo. Veja um exemplo de como criar um tópico:
gcloud
gcloud pubsub topics create TOPIC_ID
REST
Solicitação:
A solicitação precisa ser autenticada com um token de acesso no cabeçalho Authorization
. Para conseguir um token de acesso para o Application Default Credentials: gcloud auth application-default print-access-token
.
PUT https://pubsub.googleapis.com/v1/projects/myproject/topics/mytopic Authorization: Bearer ACCESS_TOKEN
Saída:
200 OK
{ "name": "projects/myproject/topics/mytopic" }
C++
Antes de testar este exemplo, siga as instruções de configuração do C++ no Guia de início rápido do Pub/Sub: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub C++.
C#
Antes de testar este exemplo, siga as instruções de configuração do C# no Guia de início rápido do Pub/Sub: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub C#.
Go
Antes de testar essa amostra, siga as instruções de configuração do Go no Guia de início rápido do Cloud Pub/Sub: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub Go.
Java
Antes de testar essa amostra, siga as instruções de configuração do Java no guia de início rápido do Pub/Sub usando bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub Java.
Node.js
Antes de testar essa amostra, siga as instruções de configuração do Node.js no Guia de início rápido do Pub/Sub usando bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub Node.js.
PHP
Antes de testar essa amostra, siga as instruções de configuração do PHP no guia de início rápido do Pub/Sub usando bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub PHP.
Python
Antes de testar essa amostra, siga as instruções de configuração do Python no guia de início rápido do Pub/Sub usando bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub para Python (em inglês).
Ruby
Antes de testar essa amostra, siga as instruções de configuração do Ruby no guia de início rápido do Pub/Sub usando bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub Ruby.
Como excluir um tópico
Veja um exemplo de como excluir um tópico:
gcloud
gcloud pubsub topics delete TOPIC_ID
REST
Solicitação:
A solicitação precisa ser autenticada com um token de acesso no cabeçalho Authorization
. Para conseguir um token de acesso para o Application Default Credentials: gcloud auth application-default print-access-token
.
DELETE https://pubsub.googleapis.com/v1/projects/myproject/topics/mytopic Authorization: Bearer ACCESS_TOKEN
Saída:
200 OK
{ "name": "projects/myproject/topics/mytopic" }
C++
Antes de testar este exemplo, siga as instruções de configuração do C++ no Guia de início rápido do Pub/Sub: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub C++.
C#
Antes de testar este exemplo, siga as instruções de configuração do C# no Guia de início rápido do Pub/Sub: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub C#.
Go
Antes de testar essa amostra, siga as instruções de configuração do Go no Guia de início rápido do Cloud Pub/Sub: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub Go.
Java
Antes de testar essa amostra, siga as instruções de configuração do Java no guia de início rápido do Pub/Sub usando bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub Java.
Node.js
Antes de testar essa amostra, siga as instruções de configuração do Node.js no Guia de início rápido do Pub/Sub usando bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub Node.js.
PHP
Antes de testar essa amostra, siga as instruções de configuração do PHP no guia de início rápido do Pub/Sub usando bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub PHP.
Python
Antes de testar essa amostra, siga as instruções de configuração do Python no guia de início rápido do Pub/Sub usando bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub para Python (em inglês).
Ruby
Antes de testar essa amostra, siga as instruções de configuração do Ruby no guia de início rápido do Pub/Sub usando bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub Ruby.
Quando você exclui um tópico, as inscrições dele não são excluídas, e o backlog da mensagem da inscrição fica disponível para os inscritos. Depois que um tópico é excluído, as assinaturas dele ficam com o nome de tópico _deleted-topic_
. Se você tentar criar um tópico com o mesmo nome de um recém-excluído, verá um erro por um breve período de tempo após a exclusão.
Como listar tópicos
Veja um exemplo de como listar tópicos:
gcloud
gcloud pubsub topics list
REST
Solicitação:
A solicitação precisa ser autenticada com um token de acesso no cabeçalho Authorization
. Para conseguir um token de acesso para o Application Default Credentials: gcloud auth application-default print-access-token
.
GET https://pubsub.googleapis.com/v1/projects/myproject/topics Authorization: Bearer ACCESS_TOKEN
Saída:
200 OK
{ "topics": [ { "name": "projects/myproject/topics/mytopic1" }, { "name": "projects/myproject/topics/mytopic2" } ] }
C++
Antes de testar este exemplo, siga as instruções de configuração do C++ no Guia de início rápido do Pub/Sub: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub C++.
C#
Antes de testar este exemplo, siga as instruções de configuração do C# no Guia de início rápido do Pub/Sub: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub C#.
Go
Antes de testar essa amostra, siga as instruções de configuração do Go no Guia de início rápido do Cloud Pub/Sub: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub Go.
Java
Antes de testar essa amostra, siga as instruções de configuração do Java no guia de início rápido do Pub/Sub usando bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub Java.
Node.js
Antes de testar essa amostra, siga as instruções de configuração do Node.js no Guia de início rápido do Pub/Sub usando bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub Node.js.
PHP
Antes de testar essa amostra, siga as instruções de configuração do PHP no guia de início rápido do Pub/Sub usando bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub PHP.
Python
Antes de testar essa amostra, siga as instruções de configuração do Python no guia de início rápido do Pub/Sub usando bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub para Python (em inglês).
Ruby
Antes de testar essa amostra, siga as instruções de configuração do Ruby no guia de início rápido do Pub/Sub usando bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub Ruby.
Por padrão, são retornados no máximo 100 resultados por consulta. Você pode mudar essa quantidade para até 1.000 usando o parâmetro de tamanho de página.
Como remover assinaturas
Ao criar uma assinatura, você a anexa a um tópico, e os assinantes podem receber mensagens da assinatura. Para impedir que os assinantes recebam mensagens, é possível remover assinaturas do tópico.
Antes de remover uma assinatura, você precisa da
permissão pubsub.topics.detachSubscription
no tópico. É possível remover uma
assinatura sem permissões na assinatura, o que é útil para gerenciar
um tópico que esteja em um projeto diferente da assinatura. Para
mais informações, consulte
Controle de acesso do Pub/Sub.
É possível remover a assinatura de um tópico usando o Console do Cloud,
a ferramenta de linha de comando gcloud
ou a API Pub/Sub.
Console
Para remover uma assinatura, siga estas etapas:
- No Console do Cloud, acesse a página Tópicos.
- Clique no código do tópico.
- Na guia Assinaturas, clique no ID da assinatura que você quer remover.
- Na página Detalhes da assinatura, clique em Remover.
- Na caixa de diálogo exibida, clique em Remover novamente.
gcloud
Para remover uma assinatura, use o
comando
gcloud pubsub topics detach-subscription
:
gcloud pubsub topics detach-subscription SUBSCRIPTION_ID
Se a solicitação for bem-sucedida, a linha de comando exibirá uma confirmação:
Detached subscription [SUBSCRIPTION_ID].
REST
Para remover uma assinatura, envie uma solicitação como esta:
POST https://pubsub.googleapis.com/v1/subscriptions/PROJECT_ID/subscriptions/SUBSCRIPTION_ID:detach Authorization: Bearer $(gcloud auth application-default print-access-token)
Se a solicitação for bem-sucedida, a resposta será um objeto JSON vazio.
C++
Antes de testar este exemplo, siga as instruções de configuração do C++ no Guia de início rápido do Pub/Sub: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub C++.
C#
Antes de testar este exemplo, siga as instruções de configuração do C# no Guia de início rápido do Pub/Sub: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub C#.
Go
Antes de testar essa amostra, siga as instruções de configuração do Go no Guia de início rápido do Cloud Pub/Sub: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub Go.
Java
Antes de testar essa amostra, siga as instruções de configuração do Java no guia de início rápido do Pub/Sub usando bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub Java.
Node.js
Antes de testar essa amostra, siga as instruções de configuração do Node.js no Guia de início rápido do Pub/Sub usando bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub Node.js.
PHP
Antes de testar essa amostra, siga as instruções de configuração do PHP no guia de início rápido do Pub/Sub usando bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub PHP.
Python
Antes de testar essa amostra, siga as instruções de configuração do Python no guia de início rápido do Pub/Sub usando bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub para Python (em inglês).
Ruby
Antes de testar essa amostra, siga as instruções de configuração do Ruby no guia de início rápido do Pub/Sub usando bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub Ruby.
O serviço Pub/Sub pode levar vários minutos para concluir a remoção da assinatura do tópico.
Depois que o serviço do Pub/Sub remove a assinatura do tópico, o serviço do Pub/Sub exclui todas as mensagens retidas para a assinatura. Não é possível recuperar essas mensagens da assinatura nem reconectá-la a um tópico. Para liberar sua cota de projeto do Cloud, exclua a assinatura.
Se a assinatura e o tópico estiverem em projetos diferentes do Cloud, o serviço Pub/Sub adicionará uma entrada aos registros de auditoria dos dois projetos.
Gerenciar inscrições
Nesta seção, você aprenderá a gerenciar assinaturas de push e pull. Para uma visão geral e comparação das assinaturas de pull e de push, consulte a visão geral do assinante.
É necessário criar uma assinatura em um tópico para que os inscritos possam receber mensagens publicadas nela.
Como criar assinaturas
É possível criar assinaturas com o Console do Cloud, a ferramenta de linha de comando gcloud
ou a API Pub/Sub.
Console
Para criar uma assinatura, conclua as etapas a seguir.
- No Console do Cloud, acesse a página Assinaturas.
- Clique em Criar assinatura.
- Insira o ID da assinatura.
- Escolha ou crie um tópico no menu suspenso. A assinatura recebe mensagens do tópico.
- Clique em Criar
Você também pode criar uma assinatura na seção Tópicos. Esse atalho é útil para associar tópicos a assinaturas.
- No Console do Cloud, acesse a página Tópicos.
- Clique em more_vert ao lado do tópico em que você quer criar uma assinatura.
- No menu de contexto, selecione Criar assinatura.
- Escolha ou crie um tópico no menu suspenso. A assinatura recebe mensagens do tópico.
- Insira o ID da assinatura.
- Clique em Criar
gcloud
Para criar uma assinatura, execute o comando gcloud pubsub subscriptions create
.
gcloud pubsub subscriptions create SUBSCRIPTION_ID \ --topic=TOPIC_ID \ [--ack-deadline=ACK_DEADLINE] \ [--dead-letter-topic=DEAD_LETTER_TOPIC_ID \ --dead-letter-topic-project=DEAD_LETTER_TOPIC_PROJECT_ID \ [--expiration-period=EXPIRATION_PERIOD] \ --max-delivery-attempts=MAX_DELIVERY_ATTEMPTS] \ [--message-filter=FILTER] [--message-retention-duration=MESSAGE_RETENTION_DURATION] \ [--max-retry-delay=MAX_RETRY_DELAY] \ [--min-retry-delay=MIN_RETRY_DELAY] \ [--push-endpoint=PUSH_ENDPOINT]
REST
Solicitação:
A solicitação precisa ser autenticada com um token de acesso no cabeçalho Authorization
. Para conseguir um token de acesso para o Application Default Credentials atual, use: gcloud auth application-default print-access-token.
PUT https://pubsub.googleapis.com/v1/projects/myproject/subscriptions/mysubscription Authorization: Bearer ACCESS_TOKEN
Especifique os campos a seguir no corpo da solicitação:
{ "topic": "projects/someproject/topics/sometopic" // Only needed if you are using push delivery "pushConfig": { "pushEndpoint": "https://myproject.appspot.com/myhandler" } }
Saída:
200 OK
{ "name": "projects/myproject/subscriptions/mysubscription", "topic": "projects/someproject/topics/sometopic", "pushConfig": { "pushEndpoint": "https://myproject.appspot.com/myhandler" }, "ackDeadlineSeconds": 10 }
C++
Antes de testar este exemplo, siga as instruções de configuração do C++ no Guia de início rápido do Pub/Sub: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub C++.
C#
Antes de testar este exemplo, siga as instruções de configuração do C# no Guia de início rápido do Pub/Sub: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub C#.
Go
Antes de testar essa amostra, siga as instruções de configuração do Go no Guia de início rápido do Cloud Pub/Sub: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub Go.
Java
Antes de testar essa amostra, siga as instruções de configuração do Java no guia de início rápido do Pub/Sub usando bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub Java.
Node.js
Antes de testar essa amostra, siga as instruções de configuração do Node.js no Guia de início rápido do Pub/Sub usando bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub Node.js.
PHP
Antes de testar essa amostra, siga as instruções de configuração do PHP no guia de início rápido do Pub/Sub usando bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub PHP.
Python
Antes de testar essa amostra, siga as instruções de configuração do Python no guia de início rápido do Pub/Sub usando bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub para Python (em inglês).
Ruby
Antes de testar essa amostra, siga as instruções de configuração do Ruby no guia de início rápido do Pub/Sub usando bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub Ruby.
Nos exemplos a seguir, mostramos como criar uma assinatura com a entrega por push. Por padrão, as assinaturas usam a entrega por pull.
C++
Antes de tentar esse exemplo, siga as instruções de configuração do C++ em Guia de início rápido: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub C++.
C#
Antes de testar este exemplo, siga as instruções de configuração do C# no Guia de início rápido do Pub/Sub: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub C#.
Go
Antes de testar essa amostra, siga as instruções de configuração do Go no Guia de início rápido do Cloud Pub/Sub: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub Go.
Java
Antes de testar essa amostra, siga as instruções de configuração do Java no guia de início rápido do Pub/Sub usando bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub Java.
Node.js
Antes de testar essa amostra, siga as instruções de configuração do Node.js no Guia de início rápido do Pub/Sub usando bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub Node.js.
PHP
Antes de testar essa amostra, siga as instruções de configuração do PHP no guia de início rápido do Pub/Sub usando bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub PHP.
Python
Antes de testar essa amostra, siga as instruções de configuração do Python no guia de início rápido do Pub/Sub usando bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub para Python (em inglês).
Ruby
Antes de testar essa amostra, siga as instruções de configuração do Ruby no guia de início rápido do Pub/Sub usando bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub Ruby.
Como usar propriedades de assinatura
Você pode definir as propriedades da assinatura ao criar ou atualizar uma assinatura.
Para mais informações sobre como configurar propriedades de assinatura com a ferramenta de linha de comando gcloud
,
consulte as sinalizações opcionais
gcloud pubsub subscriptions create
ou gcloud pubsub subscriptions update
.
As assinaturas têm as seguintes propriedades:
Property | Descrição | Padrão |
---|---|---|
Método de exibição |
Você pode receber mensagens com entrega pull ou push. Na entrega pull, o aplicativo do seu assinante inicia solicitações para o servidor do Pub/Sub para recuperar mensagens. Na entrega push, o Pub/Sub inicia solicitações para o aplicativo do seu assinante enviar mensagens. |
Se não for especificado, as assinaturas do Pub/Sub usarão a entrega pull. |
Prazo de confirmação |
Se o seu código não reconhecer a mensagem antes do prazo, a mensagem será enviada novamente. |
10 segundos é o prazo de confirmação padrão. O máximo é 10 minutos. |
Duração da retenção da mensagem |
A duração da retenção da mensagem especifica por quanto tempo o Pub/Sub retém as mensagens após a publicação. Após a duração da retenção de mensagens, o Pub/Sub pode descartar a mensagem, independentemente do estado de confirmação. Para reter mensagens reconhecidas para a duração da retenção da mensagem, consulte Como reproduzir e descartar mensagens. |
7 dias é a duração padrão da retenção de mensagens. O mínimo é 10 minutos e o máximo é 7 dias. |
Tópicos com mensagens inativas |
Quando um assinante não consegue confirmar uma mensagem, o Pub/Sub pode encaminhar a mensagem para um tópico de mensagem inativa. Para ver detalhes, consulte Encaminhar para tópicos de mensagens inativas. Se você usar um tópico de mensagens inativas, não será possível ativar a ordem das mensagens. |
Se você definir um tópico de mensagem inativa, também será possível especificar o número máximo de tentativas de entrega. O padrão é 5 tentativas de entrega, e você pode especificar de 5 a 100 tentativas. Se você definir um tópico de mensagem inativa e o tópico estiver em um projeto diferente da assinatura, também será necessário especificar o ID do projeto com o tópico de mensagem inativa. |
Período de expiração |
As assinaturas sem atividade do assinante (como conexões abertas, pulls ativos ou pushes bem-sucedidos) expiram. Caso o Pub/Sub detecte atividade do assinante, o relógio de exclusão de assinatura será reiniciado. |
31 dias é o período de expiração padrão. O mínimo é 1 dia. Para evitar que uma assinatura expire, defina o período de expiração como |
Política de repetição |
Se o prazo de confirmação expirar ou um assinante responder com uma confirmação negativa, o Pub/Sub poderá enviar a mensagem novamente usando espera exponencial. |
Se a política de nova tentativa não estiver definida, o Pub/Sub reenviará a mensagem assim que o prazo de confirmação expirar ou um assinante responder com uma confirmação negativa. Se a duração máxima da retirada for definida, a duração mínima de retirada será de 10 segundos. Se a duração mínima de espera for definida, a duração máxima padrão de espera é de 600 segundos. A duração de espera mais longa que você pode especificar é de 600 segundos. |
Ordem das mensagens |
Se os editores enviarem mensagens com uma chave de ordem e a ordem das mensagens estiver definida, o Pub/Sub entrega as mensagens na ordem. |
Se não for definido, o Pub/Sub não entregará mensagens em ordem, incluindo mensagens com chaves de ordenação. |
Filtro |
O filtro é uma string com uma expressão de filtragem. Se uma assinatura tiver um filtro, ela só entregará as mensagens correspondentes ao filtro. É possível filtrar mensagens pelos atributos. |
Se não for especificada, a assinatura não filtrará as mensagens, e os inscritos receberão todas as mensagens. |
Como usar políticas de repetição
Quando uma assinatura tem uma política de repetição, o Pub/Sub reenvia as mensagens não confirmadas após a duração de espera especificada. O Pub/Sub reenvia as mensagens após a duração de espera com base no melhor esforço, para que você possa receber mensagens antes da duração de espera mínima.
Se as mensagens estiverem em lote, o Pub/Sub iniciará a espera exponencial quando uma das seguintes situações ocorrer:
- O assinante envia uma confirmação negativa para cada mensagem no lote.
- O prazo de confirmação expira.
Após a duração de espera, o Pub/Sub entrega o lote novamente.
Se você receber mensagens de uma assinatura de push, o Pub/Sub pode reenviá-las após a espera em push em vez da duração da espera exponencial. Quando a espera em push é mais longa do que a duração da espera exponencial, o Pub/Sub reenvia mensagens não confirmadas após a espera em push.
Como modificar métodos de exibição
É possível alternar entre assinaturas de push e pull com o
Console do Cloud, a ferramenta de linha de comando gcloud
ou a API Pub/Sub.
Console
Para modificar uma assinatura de push, siga estas instruções:
- No Console do Cloud, acesse a página Assinaturas.
- Clique em more_vert ao lado da assinatura que você quer atualizar.
- Em Tipo de entrega, escolha Pull ou Push.
- Clique em Update.
gcloud
Para modificar o URL do endpoint de push, execute o comando
modify-push-config
:
gcloud pubsub subscriptions modify-push-config SUBSCRIPTION_ID \ --push-endpoint=PUSH_ENDPOINT
Se a assinatura já estiver usando a entrega por pull, configurar o endpoint de push alternará o método para a entrega por push.
É possível alternar a entrega de push para pull alterando o endpoint de push para uma string vazia.
C++
Antes de testar este exemplo, siga as instruções de configuração do C++ no Guia de início rápido do Pub/Sub: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub C++.
C#
Antes de testar este exemplo, siga as instruções de configuração do C# no Guia de início rápido do Pub/Sub: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub C#.
Go
Antes de testar essa amostra, siga as instruções de configuração do Go no Guia de início rápido do Cloud Pub/Sub: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub Go.
Java
Antes de testar essa amostra, siga as instruções de configuração do Java no guia de início rápido do Pub/Sub usando bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub Java.
Node.js
Antes de testar essa amostra, siga as instruções de configuração do Node.js no Guia de início rápido do Pub/Sub usando bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub Node.js.
Python
Antes de testar essa amostra, siga as instruções de configuração do Python no guia de início rápido do Pub/Sub usando bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub para Python (em inglês).
Ruby
Antes de testar essa amostra, siga as instruções de configuração do Ruby no guia de início rápido do Pub/Sub usando bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub Ruby.
Como listar assinaturas
É possível listar as assinaturas em um projeto do Google Cloud com o
Console do Cloud, a ferramenta de linha de comando gcloud
ou a API Pub/Sub.
Console
Para listar as assinaturas em um projeto, acesse a página Assinaturas.
gcloud
Para listar as assinaturas em um projeto do Google Cloud, execute o
comando
gcloud pubsub subscriptions list
:
gcloud pubsub subscriptions list [--project=PROJECT_ID]
C++
Antes de testar este exemplo, siga as instruções de configuração do C++ no Guia de início rápido do Pub/Sub: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub C++.
C#
Antes de testar este exemplo, siga as instruções de configuração do C# no Guia de início rápido do Pub/Sub: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub C#.
Go
Antes de testar essa amostra, siga as instruções de configuração do Go no Guia de início rápido do Cloud Pub/Sub: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub Go.
Java
Antes de testar essa amostra, siga as instruções de configuração do Java no guia de início rápido do Pub/Sub usando bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub Java.
Node.js
Antes de testar essa amostra, siga as instruções de configuração do Node.js no Guia de início rápido do Pub/Sub usando bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub Node.js.
PHP
Antes de testar essa amostra, siga as instruções de configuração do PHP no guia de início rápido do Pub/Sub usando bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub PHP.
Python
Antes de testar essa amostra, siga as instruções de configuração do Python no guia de início rápido do Pub/Sub usando bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub para Python (em inglês).
Ruby
Antes de testar essa amostra, siga as instruções de configuração do Ruby no guia de início rápido do Pub/Sub usando bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub Ruby.
É possível listar as assinaturas de um tópico com o Console do Cloud,
a ferramenta de linha de comando gcloud
ou a API Pub/Sub.
Console
- No Console do Cloud, acesse a página Tópicos.
- Selecione um ID de tópico para abrir a página Detalhes do tópico. A seção Assinaturas da página inclui uma lista de assinaturas do tópico.
gcloud
Para listar as assinaturas em um projeto do Google Cloud, execute o
comando
gcloud pubsub topics list-subscriptions
:
gcloud pubsub topics list-subscriptions TOPIC_ID
C++
Antes de testar este exemplo, siga as instruções de configuração do C++ no Guia de início rápido do Pub/Sub: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub C++.
C#
Antes de testar este exemplo, siga as instruções de configuração do C# no Guia de início rápido do Pub/Sub: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub C#.
Go
Antes de testar essa amostra, siga as instruções de configuração do Go no Guia de início rápido do Cloud Pub/Sub: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub Go.
Java
Antes de testar essa amostra, siga as instruções de configuração do Java no guia de início rápido do Pub/Sub usando bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub Java.
Node.js
Antes de testar essa amostra, siga as instruções de configuração do Node.js no Guia de início rápido do Pub/Sub usando bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub Node.js.
Python
Antes de testar essa amostra, siga as instruções de configuração do Python no guia de início rápido do Pub/Sub usando bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub para Python (em inglês).
Ruby
Antes de testar essa amostra, siga as instruções de configuração do Ruby no guia de início rápido do Pub/Sub usando bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub Ruby.
Como excluir assinaturas
É possível excluir assinaturas com o Console do Cloud,
a ferramenta de linha de comando gcloud
ou a API Pub/Sub.
Console
- No Console do Cloud, acesse a página Assinaturas.
- Selecione a assinatura a ser excluída.
- Clique em Excluir.
gcloud
Para excluir uma assinatura, execute o
comando
gcloud pubsub subscriptions delete
:
gcloud pubsub subscriptions delete SUBSCRIPTION_ID
C++
Antes de testar este exemplo, siga as instruções de configuração do C++ no Guia de início rápido do Pub/Sub: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub C++.
C#
Antes de testar este exemplo, siga as instruções de configuração do C# no Guia de início rápido do Pub/Sub: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub C#.
Go
Antes de testar essa amostra, siga as instruções de configuração do Go no Guia de início rápido do Cloud Pub/Sub: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub Go.
Java
Antes de testar essa amostra, siga as instruções de configuração do Java no guia de início rápido do Pub/Sub usando bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub Java.
Node.js
Antes de testar essa amostra, siga as instruções de configuração do Node.js no Guia de início rápido do Pub/Sub usando bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub Node.js.
PHP
Antes de testar essa amostra, siga as instruções de configuração do PHP no guia de início rápido do Pub/Sub usando bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub PHP.
Python
Antes de testar essa amostra, siga as instruções de configuração do Python no guia de início rápido do Pub/Sub usando bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub para Python (em inglês).
Ruby
Antes de testar essa amostra, siga as instruções de configuração do Ruby no guia de início rápido do Pub/Sub usando bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub Ruby.
Nomes de recurso
Um nome de recurso do Pub/Sub identifica exclusivamente um recurso do Pub/Sub, como uma assinatura ou um tópico, e precisa ter o seguinte formato:
projects/project-identifier/collection/relative-name
O identificador do projeto precisa ser o ID do projeto, disponível no Console do Google Cloud. Por exemplo, projects/myproject/topics/mytopic
;
A coleção precisa ser subscriptions
ou topics
.
O nome relativo precisa:
- não começar com a string
goog
; - começar com uma letra;
- conter entre 3 e 255 caracteres;
conter apenas os caracteres a seguir:
- letras:
[A-Za-z]
- números:
[0-9]
- traços:
-
- sublinhados:
_
- pontos:
.
- sinais diacríticos:
~
- sinais de adição:
+
sinais de porcentagem:
%
Os caracteres especiais mencionados acima podem ser usados em nomes de recursos sem codificação para URLs. Mas, é preciso garantir que os caracteres sejam codificados/decodificados corretamente quando usados em URLs. Por exemplo,
mi-tópico
é um nome relativo inválido. No entanto,mi-t%C3%B3pico
é válido.Isso é particularmente importante para chamadas REST.
- letras: