O Database Migration Service oferece uma API REST para administrar perfis de conexão e jobs de migração de maneira programática. A API REST é definida por recursos associados à criação e ao gerenciamento de perfis de conexão e jobs de migração. Para detalhes sobre todos os recursos e os métodos deles, consulte a referência da API Database Migration Service.
Ao enviar solicitações diretamente para a API REST do Database Migration Service, é preciso criar o formulário correto da solicitação, autorizá-la como um usuário autenticado e processar as respostas retornadas. Muitas das tarefas nesta documentação fornecem exemplos de API usando curl.
Para mais exemplos de uso das APIs, consulte a página da solicitação na referência da API Database Migration Service. Cada página tem exemplos de chamada da API em várias linguagens de programação, bem como um explorador específico da solicitação para ajudar você a ver o que entra em uma solicitação bem formada e o que esperar na resposta.
Você também usa a API Database Migration Service, indiretamente, ao usar qualquer uma das seguintes maneiras de administrar instâncias:
Google Cloud CLI: uma interface de linha de comando (CLI) que pode ser usada para trabalhar com suas instâncias.
Google Cloud Console: uma interface da Web gráfica.
A vantagem de usar esses métodos, especialmente o console doGoogle Cloud , é que eles podem simplificar muito a administração dos seus perfis de conexão e jobs de migração (dependendo do caso de uso). Se você está começando a usar o Database Migration Service, recomendamos que comece com uma dessas ferramentas antes de trabalhar diretamente com a API REST.
Ativar a API
Para usar a API Database Migration Service, é preciso ativá-la:
Console
- Ative a API Database Migration Service.
- Selecione o projeto.
- Selecione Continuar.
gcloud
- Digite o seguinte para exibir os IDs dos seus projetos do Google Cloud:
gcloud projects list
- Defina seu projeto padrão:
gcloud config set project YOUR_PROJECT_ID
- Ative a API Cloud SQL Admin:
gcloud services enable datamigration.googleapis.com
Permissões
Você precisa ter as permissões necessárias para usar a API Database Migration Service. Essas permissões incluem:
- Administrador do Database Migration: com essa permissão, um usuário tem acesso a todos os recursos do Database Migration Service usados para gerenciar perfis de conexão e jobs de migração.
- Leitor do Database Migration: com essa permissão, um usuário tem acesso somente leitura a perfis de conexão e jobs de migração no Database Migration Service.
- Administrador do Cloud SQL: com essa permissão, um usuário pode criar e gerenciar perfis de conexão e jobs de migração para o Cloud SQL no Database Migration Service.