Compartilhamento de HealthOmics fluxos de trabalho

Como proprietário de um fluxo de trabalho privado, você pode compartilhar o fluxo de trabalho com Conta da AWS alguém da mesma região. Para compartilhar um fluxo de trabalho com mais de um Conta da AWS, você cria vários compartilhamentos do mesmo fluxo de trabalho.

Como proprietário, você pode revogar o acesso a um fluxo de trabalho compartilhado excluindo o compartilhamento.

nota

HealthOmics permite automaticamente que um fluxo de trabalho compartilhado acesse o repositório Amazon ECR enquanto o fluxo de trabalho está sendo executado na conta do assinante. Você não precisa conceder acesso adicional ao repositório para fluxos de trabalho compartilhados.

Quando você compartilha um fluxo de trabalho, o assinante pode usar qualquer uma das versões do fluxo de trabalho. Se você precisar de controle de acesso em nível de versão para um fluxo de trabalho compartilhado, recomendamos criar fluxos de trabalho separados em vez de usar versões de fluxo de trabalho.

Inscrever-se em um fluxo de trabalho compartilhado

Para assinar um fluxo de trabalho compartilhado, siga estas etapas gerais para aceitar e usar o fluxo de trabalho:

1. Use o console ou a API para aceitar o compartilhamento. Defina sua região atual para a mesma região da solicitação de compartilhamento.

   • Para encontrar a solicitação de compartilhamento no console, navegue até a página Todos os compartilhamentos de recursos e escolha a guia Compartilhado comigo.

2. Use o console ou a API para criar uma execução para o fluxo de trabalho compartilhado.

   • Para encontrar a página de detalhes do fluxo de trabalho no console, navegue até Compartilhado comigo (consulte a etapa 1) e escolha o link Recurso para o fluxo de trabalho compartilhado.

3. Você fornece seus próprios dados de entrada para o fluxo de trabalho.

4. O fluxo de trabalho compartilhado é executado em seu Conta da AWS.

Como assinante de um fluxo de trabalho compartilhado, o sistema impede que você execute as seguintes ações de fluxo de trabalho:

• Exportação de um fluxo de trabalho compartilhado

• Executando novamente o fluxo de trabalho compartilhado

  • Você cria uma nova execução para o fluxo de trabalho compartilhado.

• Compartilhando novamente o fluxo de trabalho.

• Atribuição de uma tag ao fluxo de trabalho.

• Excluindo o fluxo de trabalho.

  • Quando você não precisar mais do fluxo de trabalho, exclua o compartilhamento do fluxo de trabalho.

Consulte Compartilhamento de recursos entre contas em AWS HealthOmics para obter informações adicionais sobre o compartilhamento de recursos.

Monitorando o status de um compartilhamento de fluxo de trabalho

HealthOmics envia um evento EventBridge para cada alteração de status de um compartilhamento de fluxo de trabalho. Se você quiser receber notificações sobre mudanças de status específicas, configure uma EventBridge regra para monitorar eventos de mudança de status do compartilhamento do fluxo de trabalho. Por exemplo:

• Você quer receber uma notificação sempre que receber uma solicitação de compartilhamento de fluxo de trabalho e sempre que um usuário revogar um compartilhamento de fluxo de trabalho.

• Depois de iniciar uma solicitação de compartilhamento de fluxo de trabalho, você deseja receber uma notificação quando o usuário aceitar ou recusar a solicitação.

Para obter detalhes sobre o uso de eventos, consulteUsando EventBridge com AWS HealthOmics.

Compartilhando um fluxo de trabalho privado usando o console

No console, você pode compartilhar um fluxo de trabalho privado com um Conta da AWS na mesma região do fluxo de trabalho.

Para compartilhar um fluxo de trabalho privado

1. Abra o console de HealthOmics .

2. No painel de navegação esquerdo, escolha Fluxos de trabalho privados.

3. Na tabela Fluxos de trabalho na página Fluxos de trabalho privados, selecione o fluxo de trabalho a ser compartilhado e escolha Compartilhar.

4. No painel Detalhes do compartilhamento da página Compartilhar fluxo de trabalho, insira um nome descritivo para o compartilhamento e insira o nome Conta da AWS do assinante.

5. Escolha Compartilhar recurso. O console exibe compartilhamentos de recursos na página Todos os compartilhamentos de recursos.

O estado inicial do compartilhamento está pendente. Depois que o assinante aceita o compartilhamento, o estado muda para ativo.

Compartilhando um fluxo de trabalho privado usando a CLI

Use a operação da API create-share para criar um compartilhamento de fluxo de trabalho. O assinante principal é o Conta da AWS usuário que terá acesso ao fluxo de trabalho.

aws omics create-share \
  --resource-arn "arn:aws:omics:us-west-2:555555555555:workflow/123456" \
  --principal-subscriber "123456789012" \
  --name "my_Share-123"  

Se a criação for bem-sucedida, você receberá uma resposta com o ID e o status do compartilhamento.

{
"shareId": "495c21bedc889d07d0ab69d710a6841e-dd75ab7a1a9c384fa848b5bd8e5a7e0a",
"name": "my_Share-123",
"status": "PENDING"
}     

O compartilhamento permanece pendente até que o assinante o aceite usando a operação da accept-share API.

Consulte Compartilhamento de recursos entre contas em AWS HealthOmics para ver outros exemplos de uso da API.

Aceitando um fluxo de trabalho compartilhado usando o console

Você pode usar o console para aceitar um compartilhamento de fluxo de trabalho oferecido. Certifique-se de configurar o console na mesma região do fluxo de trabalho.

1. Abra o console de HealthOmics .

2. No painel de navegação esquerdo, escolha Todos os compartilhamentos de recursos e, em seguida, escolha a guia Compartilhado comigo.

3. Na tabela Recursos compartilhados comigo, selecione o compartilhamento do fluxo de trabalho e escolha Aceitar.

Depois de aceitar o fluxo de trabalho, escolha o link Recurso do fluxo de trabalho compartilhado para ver seus detalhes.

Executando um fluxo de trabalho compartilhado usando o console

Depois de aceitar um compartilhamento de fluxo de trabalho, você pode iniciar uma execução no fluxo de trabalho.

1. Abra o console de HealthOmics .

2. No painel de navegação esquerdo, escolha Todos os compartilhamentos de recursos e, em seguida, escolha a guia Compartilhado comigo.

3. Na tabela Recursos compartilhados comigo, escolha o link Recurso para o fluxo de trabalho compartilhado.

4. Na página de detalhes do fluxo de trabalho, escolha Criar execução.

   O console abre a página Criar execução, com o tipo de fluxo de trabalho (compartilhado) e a ID do fluxo de trabalho pré-preenchidos.

5. Configure os campos restantes no formulário Criar execução. Para obter informações adicionais, consulte Iniciando uma execução usando o console.

Executando um fluxo de trabalho compartilhado usando a API

Use get-workflow para recuperar o ARN do fluxo de trabalho compartilhado.

aws omics get-workflow --id 1234567 \
--workflow-owner-id 55555555555       

Ao executar o fluxo de trabalho, forneça a Conta da AWS ID do proprietário do fluxo de trabalho e o ARN do fluxo de trabalho compartilhado.

aws omics start-run --id 1234567 --workflow-owner-id 55555555555 \
--role-arn arn:aws:iam::1234567892012:role/service-role/OmicsWorkflow-20221004T164236 \
--name ArchiveTest --retention-mode REMOVE