Gerenciar assinaturas
Como assinante do Analytics Hub, é possível realizar as seguintes tarefas:
- Assinar uma listagem.
- Listar suas assinaturas atuais em um determinado projeto.
- Excluir uma assinatura.
Como editor do Analytics Hub, é possível realizar as seguintes tarefas:
- Conferir todas as assinaturas da sua listagem.
- Revogar o acesso a uma assinatura específica.
Uma assinatura é um recurso regionalizado que reside no projeto do assinante. As assinaturas armazenam informações relevantes sobre o assinante e representam o contrato entre o editor e o assinante.
Antes de começar
Para começar a usar o Analytics Hub, você precisa ativar a API Analytics Hub no projeto do Google Cloud.
Permissões necessárias
Para ativar a API Analytics Hub, você precisa das seguintes permissões de gerenciamento de identidade e acesso (IAM):
serviceUsage.services.get
serviceUsage.services.list
serviceUsage.services.enable
O papel predefinido do IAM a seguir inclui as permissões necessárias para ativar a API Analytics Hub:
roles/serviceusage.serviceUsageAdmin
Para mais informações sobre os papéis do IAM no BigQuery, consulte Papéis e permissões predefinidos.
Ativar a API Analytics Hub
Para ativar a API Analytics Hub, faça o seguinte:
Console
Acesse a API Analytics Hub para seu projeto do Google Cloud e ative-o.
gcloud
Execute o comando gcloud services enable:
gcloud services enable analyticshub.googleapis.com
Permissões necessárias
Para gerenciar listagens, você precisa ter um destes papéis do Analytics Hub:
- Papel de proprietário de assinatura do Analytics Hub (
roles/analyticshub.subscriptionOwner
), que permite gerenciar as assinaturas criadas por você.
Para mais informações, consulte as funções do usuário do Analytics Hub.
Fluxo de trabalho dos assinantes
Os assinantes podem realizar as ações a seguir com as assinaturas.
Assinar listagens
Para fazer isso, siga as etapas em Assinar listagens.
Listar assinaturas
Para listar todas as assinaturas, siga estas etapas.
API
Para conferir suas assinaturas atuais em um determinado projeto, use o
método
projects.locations.subscriptions.list
.
GET https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/subscriptions
Substitua:
PROJECT_ID
: o ID do projeto que contém as assinaturas que você quer listar.LOCATION
: o local em que você quer listar as assinaturas atuais.
Fluxo de trabalho do editor
Os editores podem realizar as ações a seguir com as assinaturas. Para mais informações sobre como gerenciar assinaturas em listagens, consulte Gerenciar listagens.
Listar assinaturas
Para listar todas as assinaturas, siga estas etapas.
Console
No Console do Google Cloud, acesse a página do Analytics Hub.
Será exibida uma página que lista todas as trocas de dados que é possível acessar.
Clique no nome da troca de dados em que você quer listar as assinaturas.
Clique na guia Assinaturas para conferir todas as assinaturas em listagens na troca de dados.
API
Para listar assinaturas de fichas em uma troca de dados específica, use o
método
projects.locations.dataExchanges.listSubscriptions
.
GET https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID:listSubscriptions
Substitua:
PROJECT_ID
: o ID do projeto do Data Exchange em que você quer listar as assinaturas que quer remover.LOCATION
: o local da troca de dados.DATAEXCHANGE_ID
: o ID do Data Exchange em que você quer listar as assinaturas.
Remover uma inscrição
Console
No Console do Google Cloud, acesse a página do Analytics Hub.
Será exibida uma página que lista todas as trocas de dados que é possível acessar.
Clique no nome da troca de dados na qual você quer criar a listagem.
Clique na guia Assinaturas para conferir todas as assinaturas na troca de dados.
Marque a caixa de seleção ao lado das assinaturas que você quer remover ou selecione todas.
Clique em Remover assinaturas.
API
Para remover uma assinatura, use o método
projects.locations.subscriptions.revoke
.
POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/subscriptions/SUBSCRIPTION_ID:revoke
Substitua:
PROJECT_ID
: o ID do projeto da assinatura que você quer remover.LOCATION
: o local da assinatura.SUBSCRIPTION_ID
: o ID da assinatura que você quer remover.
Limitações
As assinaturas estão sujeitas às seguintes limitações:
- Os conjuntos de dados vinculados criados antes de 25 de julho de 2023 não são preenchidos. Apenas assinaturas criadas após 25 de julho de 2023 vão funcionar com os métodos da API.
A seguir
- Saiba mais sobre a arquitetura do Analytics Hub.
- Saiba como ver e assinar listagens.
- Saiba mais sobre as funções dos usuários do Analytics Hub.
- Saiba mais sobre como criar conjuntos de dados.
- Saiba mais sobre a geração de registros de auditoria do Analytics Hub.