Partage HealthOmics de workflows - AWS HealthOmics
Abonnement à un flux de travail partagé Surveillance de l'état d'un partage de flux de travailPartage d'un flux de travail privé à l'aide de la consolePartage d'un flux de travail privé à l'aide de la CLIAcceptation d'un flux de travail partagé à l'aide de la consoleExécution d'un flux de travail partagé à l'aide de la consoleExécution d'un flux de travail partagé à l'aide de l'API

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Partage HealthOmics de workflows

En tant que propriétaire d'un flux de travail privé, vous pouvez partager le flux de travail avec un Compte AWS utilisateur de la même région. Pour partager un flux de travail avec plusieurs personnes Compte AWS, vous devez créer plusieurs partages du même flux de travail.

En tant que propriétaire, vous pouvez révoquer l'accès à un flux de travail partagé en supprimant le partage.

Note

HealthOmics permet automatiquement à un flux de travail partagé d'accéder au référentiel Amazon ECR pendant que le flux de travail est exécuté dans le compte de l'abonné. Il n'est pas nécessaire d'accorder un accès supplémentaire au référentiel pour les flux de travail partagés.

Lorsque vous partagez un flux de travail, l'abonné peut utiliser n'importe quelle version du flux de travail. Si vous avez besoin d'un contrôle d'accès au niveau des versions pour un flux de travail partagé, nous vous recommandons de créer des flux de travail distincts plutôt que d'utiliser des versions de flux de travail.

Abonnement à un flux de travail partagé

Pour vous abonner à un flux de travail partagé, vous devez suivre ces étapes générales pour accepter et utiliser le flux de travail :

  1. Utilisez la console ou l'API pour accepter le partage. Définissez votre région actuelle sur la même région que celle de la demande de partage.

    • Pour trouver la demande de partage dans la console, accédez à la page Tous les partages de ressources, puis choisissez l'onglet Partagé avec moi.

  2. Utilisez la console ou l'API pour créer une exécution pour le flux de travail partagé.

    • Pour trouver la page des détails du flux de travail dans la console, accédez à Partagé avec moi (voir étape 1), puis cliquez sur le lien Ressource pour le flux de travail partagé.

  3. Vous fournissez vos propres données d'entrée pour le flux de travail.

  4. Le flux de travail partagé s'exécute dans votre Compte AWS.

En tant qu'abonné à un flux de travail partagé, le système vous empêche d'effectuer les actions de flux de travail suivantes :

  • Exportation d'un flux de travail partagé

  • Réexécution du flux de travail partagé

    • Vous créez une nouvelle exécution pour le flux de travail partagé.

  • Partage à nouveau du flux de travail.

  • Attribuer une étiquette au flux de travail.

  • Suppression du flux de travail.

    • Lorsque vous n'avez plus besoin du flux de travail, vous supprimez le partage du flux de travail.

Consultez Partage de ressources entre comptes dans AWS HealthOmics pour plus d'informations sur le partage des ressources.

Surveillance de l'état d'un partage de flux de travail

HealthOmics envoie un événement à chaque changement EventBridge de statut d'un partage de flux de travail. Si vous souhaitez recevoir des notifications concernant des changements de statut spécifiques, configurez une EventBridge règle pour surveiller les événements de changement de statut du partage de flux de travail. Par exemple :

  • Vous souhaitez recevoir une notification chaque fois que vous recevez une demande de partage de flux de travail et chaque fois qu'un utilisateur révoque un partage de flux de travail.

  • Après avoir lancé une demande de partage de flux de travail, vous souhaitez recevoir une notification lorsque l'utilisateur accepte ou refuse la demande.

Pour plus de détails sur l'utilisation des événements, consultezUtilisation EventBridge avec AWS HealthOmics.

Partage d'un flux de travail privé à l'aide de la console

Depuis la console, vous pouvez partager un flux de travail privé avec un utilisateur situé Compte AWS dans la même région que le flux de travail.

Pour partager un flux de travail privé

  1. Ouvrez la HealthOmics console.

  2. Dans le volet de navigation de gauche, choisissez Private Workflows.

  3. Dans le tableau des flux de travail de la page des flux de travail privés, sélectionnez le flux de travail à partager, puis choisissez Partager.

  4. Dans le panneau Détails du partage de la page du flux de travail de partage, entrez un nom descriptif pour le partage et entrez le nom Compte AWS de l'abonné.

  5. Choisissez Partager la ressource. La console affiche les partages de ressources sur la page Tous les partages de ressources.

L'état initial du partage est en attente. Une fois que l'abonné a accepté le partage, l'état devient actif.

Partage d'un flux de travail privé à l'aide de la CLI

Utilisez l'opération d'API create-share pour créer un partage de flux de travail. L'abonné principal est celui Compte AWS de l'utilisateur qui aura accès au flux de travail. 

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

Si la création est réussie, vous recevez une réponse avec l'ID et le statut du partage.

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

Le partage reste en attente jusqu'à ce que l'abonné l'accepte à l'aide de l'opération accept-share API.

Voir Partage de ressources entre comptes dans AWS HealthOmics pour d'autres exemples d'utilisation de l'API.

Acceptation d'un flux de travail partagé à l'aide de la console

Vous pouvez utiliser la console pour accepter un partage de flux de travail proposé. Assurez-vous de configurer la console sur la même région que le flux de travail.

  1. Ouvrez la HealthOmics console.

  2. Dans le volet de navigation de gauche, choisissez Tous les partages de ressources, puis choisissez l'onglet Partagé avec moi.

  3. Dans le tableau Ressources partagées avec moi, sélectionnez le partage du flux de travail, puis choisissez Accepter.

Après avoir accepté le flux de travail, cliquez sur le lien Ressource du flux de travail partagé pour en afficher les détails.

Exécution d'un flux de travail partagé à l'aide de la console

Après avoir accepté le partage d'un flux de travail, vous pouvez démarrer une exécution du flux de travail.

  1. Ouvrez la HealthOmics console.

  2. Dans le volet de navigation de gauche, choisissez Tous les partages de ressources, puis choisissez l'onglet Partagé avec moi.

  3. Dans le tableau Ressources partagées avec moi, cliquez sur le lien Ressource pour le flux de travail partagé.

  4. Sur la page des détails du flux de travail, choisissez Create run.

    La console ouvre la page Créer une exécution, avec le type de flux de travail (partagé) et l'ID de flux de travail préremplis.

  5. Configurez les champs restants dans le formulaire Créer une exécution. Pour plus d’informations, consultez Lancer une course à l'aide de la console.

Exécution d'un flux de travail partagé à l'aide de l'API

Utilisez get-workflow pour récupérer l'ARN du flux de travail partagé.

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

Lorsque vous exécutez le flux de travail, fournissez l' Compte AWS ID du propriétaire du flux de travail et l'ARN du flux de travail partagé.

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