Carregue e transfira integrações

Pode transferir as suas integrações como um ficheiro JSON e guardá-lo no seu sistema local. Como resultado, toda a integração está disponível num ficheiro que pode carregar diretamente noutro projeto de integração sem modificações. O carregamento de uma integração cria uma nova versão da integração no projeto onde o ficheiro é carregado.

Ter uma integração completa num formato de ficheiro oferece-lhe as seguintes vantagens:

Pode copiar a sua integração de um projeto para outro sem grande esforço.
Pode atualizar programaticamente o ficheiro de integração para alterações repetitivas, como mudar o nome das tarefas ou modificar dinamicamente os nomes das variáveis.

Transfira uma integração

Para transferir uma integração, selecione uma das seguintes opções:

Consola

Na Google Cloud Console, aceda à página Integração de aplicações.
Aceda à solução Application Integration
Clique em Integrações no menu de navegação do lado esquerdo para abrir a página Integrações.
Selecione uma integração existente. Esta ação abre a integração no editor de integração.
Clique no menu pendente Versões e selecione a versão que quer transferir.
Na barra de ferramentas do criador, clique em (menu Ações) e selecione Transferir.
O ficheiro INTEGRATION_NAME.json é guardado automaticamente na pasta de transferências predefinida do navegador de Internet.

Nota: o ficheiro JSON transferido tem a estrutura de DownloadIntegrationVersionResponse type. Se modificar o ficheiro JSON, certifique-se de que o ficheiro modificado cumpre a estrutura DownloadIntegrationVersionResponse.

API

Para transferir uma integração, emita um pedido GET para a seguinte API: GET https://integrations.googleapis.com/v1/projects/*/locations/*/integrations/*/versions/*:download

https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/INTEGRATION_NAME/versions/INTEGRATION_VERSION:download

O exemplo seguinte mostra como transferir uma versão específica de uma integração:

curl -v -s \
-H "Content-Type: application/json" -H "Authorization: Bearer $TOKEN" \
-H "X-GFE-SSL: yes" \
-X GET "https://integrations.googleapis.com/v1/projects/demo-project/locations/us-east1/integrations/test-integration/versions/0e90d453-5fcf-4aae-b164-2e8344d1ac11:download"

Nota: no exemplo anterior, o número da versão da integração é 0e90d453-5fcf-4aae-b164-2e8344d1ac11. Para obter a versão da integração, abra a versão necessária da integração na IU e copie a string de ID exclusivo gerada automaticamente após ../integrations/integration/INTEGRATION_NAME/ do URL.

Para mais informações, consulte projects.locations.integrations.versions.download.

Carregue uma integração

O carregamento de uma integração cria uma nova versão da integração no projeto onde o ficheiro é carregado. Por exemplo, se tiver uma integração com o nome IP-Test na versão 5 e carregar um ficheiro de integração em IP-Test, é criada uma nova versão 6 para a integração.

Se não tiver uma integração existente na qual possa carregar um ficheiro, tem de criar primeiro uma nova integração e, em seguida, fazer o carregamento. Neste caso, a nova integração que criar vai estar na versão 1 e a integração carregada vai estar na versão 2.

Se tiver uma integração existente que quer carregar, selecione uma das seguintes opções:

Consola

Na Google Cloud Console, aceda à página Integração de aplicações.
Aceda à solução Application Integration
Clique em Integrações no menu de navegação do lado esquerdo para abrir a página Integrações.
Selecione uma integração existente ou crie uma nova clicando em Criar integração.
Se estiver a criar uma nova integração:
1. Introduza um nome e uma descrição na caixa de diálogo Criar integração.
2. Selecione uma região para a integração.
  Nota: o menu pendente Regiões apenas apresenta as regiões aprovisionadas no seu projeto do Google Cloud. Para aprovisionar uma nova região, clique em Ativar região. Consulte o artigo Ative uma nova região para mais informações.
3. Clique em Criar.
Esta ação abre a integração no editor de integração.
Na barra de ferramentas do criador, clique em (menu Ações) e selecione Carregar.
Na caixa de diálogo do explorador de ficheiros, selecione o ficheiro que quer carregar e, de seguida, clique em Abrir.
É criada uma nova versão da integração com o ficheiro carregado.

API

Para carregar uma integração, emita um pedido POST para a seguinte API:

  https://integrations.googleapis.com/v1/projects/$YOUR_GOOGLE_PROJECT_ID/locations/$PROJECT_LOCATION/integrations $INTEGRATION_NAME/versions/$INTEGRATION_VERSION}:upload

O exemplo seguinte mostra como carregar uma integração:

  curl -v -s -H "Content-Type: application/json"  -H "Authorization: Bearer $TOKEN"  \
  -X POST -d '{"content": 
    "{\"name\":\"projects/450954726404/locations/us-east1/integrations/test-workflow/versions/0e90d453-5fcf-4aae-b164-2e8344d1ac11\",
    \"origin\":\"UI\",
    \"snapshotNumber\":\"3\",
    \"updateTime\":\"2022-01-06T04:26:58.137Z\",
    \"lockHolder\":\"abc@test.com\",
    \"createTime\":\"2022-01-06T04:26:42.734Z\",
    \"lastModifierEmail\":\"abc@test.com\",
    \"state\":\"DRAFT\",
    \"triggerConfigs\":[{\"label\":\"API Trigger\",\"startTasks\":[{\"taskId\":\"1\"}],
    \"properties\":{\"Trigger name\":\"rj-test-workflow_API_1\"},\"triggerType\":\"API\",\"triggerNumber\":\"1\",\"triggerId\":\"api_trigger/rj-test-workflow_API_1\"}],\"taskConfigs\":[{\"task\":\"EmailTask\",\"taskId\":\"1\",\"taskExecutionStrategy\":\"WHEN_ALL_SUCCEED\",\"displayName\":\"Send Email\"}]}"}' 
    \https://integrations.googleapis.com/v1/projects/demo-project/locations/us-east1/integrations/test-integration/versions:upload

Para mais informações, consulte projects.locations.integrations.versions.upload.

O que se segue?

Saiba como gerir integrações.
Saiba como testar e publicar integrações.
Saiba mais sobre todas as tarefas e acionadores.