HealthOmics Workflows teilen

Als Besitzer eines privaten Workflows können Sie den Workflow mit Personen AWS-Konto in derselben Region teilen. Um einen Workflow für mehrere Benutzer freizugeben AWS-Konto, erstellen Sie mehrere Shares desselben Workflows.

Als Eigentümer können Sie den Zugriff auf einen geteilten Workflow widerrufen, indem Sie den Share löschen.

Anmerkung

HealthOmics ermöglicht einem gemeinsamen Workflow automatisch den Zugriff auf das Amazon ECR-Repository, während der Workflow im Konto des Abonnenten läuft. Für gemeinsame Workflows müssen Sie keinen zusätzlichen Repository-Zugriff gewähren.

Wenn du einen Workflow teilst, kann der Abonnent jede der Workflow-Versionen verwenden. Wenn Sie für einen gemeinsamen Workflow eine Zugriffskontrolle auf Versionsebene benötigen, empfehlen wir, separate Workflows zu erstellen, anstatt Workflow-Versionen zu verwenden.

Vertrauen Sie dem Workflow-Besitzer

Stellen Sie sicher, dass Sie dem Workflow-Besitzer vertrauen, bevor Sie eine Freigabe akzeptieren. Wenn Sie einen gemeinsamen Workflow ausführen, werden die Workflow-Definition und die Container-Images, die der Besitzer bereitgestellt hat, in Ihrem ausgeführt AWS-Konto. Sie werden mit den Berechtigungen der IAM-Servicerolle ausgeführt, die Sie für die Ausführung angeben. Der Inhalt des Workflows und seiner Container-Bilder sind für Sie nicht sichtbar. Das Ausführen eines gemeinsamen Workflows entspricht der Ausführung von Drittanbietercode in Ihrem Konto. Geben Sie eine Dienstrolle mit geringsten Rechten ein und verwenden Sie eine Sitzungsrichtlinie, um die Berechtigungen für die Ausführung weiter einzuschränken. Weitere Informationen finden Sie unter Verwenden Sie Sitzungsrichtlinien, um Berechtigungen einzuschränken.

Einen gemeinsamen Workflow abonnieren

Um einen gemeinsamen Workflow zu abonnieren, folgen Sie diesen allgemeinen Schritten, um den Workflow zu akzeptieren und zu verwenden:

1. Verwenden Sie die Konsole oder die API, um das Teilen anzunehmen. Stellen Sie für Ihre aktuelle Region dieselbe Region ein, in der sich die Teilungsanfrage befindet.

   • Um die Freigabeanfrage in der Konsole zu finden, navigieren Sie zur Seite Alle gemeinsam genutzten Ressourcen und wählen Sie dann den Tab Für mich geteilt.

2. Verwenden Sie die Konsole oder die API, um einen Lauf für den gemeinsamen Workflow zu erstellen.

   • Um die Workflow-Detailseite in der Konsole zu finden, navigieren Sie zu Für mich freigegeben (siehe Schritt 1) und wählen Sie dann den Link Ressource für den gemeinsam genutzten Workflow.

3. Sie geben Ihre eigenen Eingabedaten für den Workflow an.

4. Der gemeinsame Workflow läuft in Ihrem AWS-Konto.

Als Abonnent eines gemeinsamen Workflows verhindert das System, dass Sie die folgenden Workflow-Aktionen ausführen:

• Exportieren eines gemeinsamen Workflows

• Re-running der gemeinsame Arbeitsablauf

  • Sie erstellen einen neuen Lauf für den gemeinsamen Workflow.

• Re-sharing der Arbeitsablauf.

• Zuweisen eines Tags zum Workflow.

• Löschen des Workflows.

  • Wenn Sie den Workflow nicht mehr benötigen, löschen Sie den Workflow-Anteil.

Weitere Informationen Cross-account gemeinsame Nutzung von Ressourcen in AWS HealthOmics zur gemeinsamen Nutzung von Ressourcen finden Sie unter.

Überwachung des Status einer Workflow-Freigabe

HealthOmics sendet EventBridge für jede Statusänderung einer Workflow-Freigabe ein Ereignis an. Wenn Sie Benachrichtigungen über bestimmte Statusänderungen erhalten möchten, richten Sie eine EventBridge Regel ein, um die Statusänderungsereignisse der Workflow-Freigabe zu überwachen. Beispiel:

• Sie möchten jedes Mal eine Benachrichtigung erhalten, wenn Sie eine Workflow-Freigabeanfrage erhalten, und jedes Mal, wenn ein Benutzer eine Workflow-Freigabe widerruft.

• Nachdem Sie eine Workflow-Freigabeanfrage initiiert haben, möchten Sie eine Benachrichtigung erhalten, wenn der Benutzer die Anfrage akzeptiert oder ablehnt.

Einzelheiten zur Verwendung von Ereignissen finden Sie unterVerwenden EventBridge mit AWS HealthOmics.

Einen privaten Workflow mithilfe der Konsole teilen

Von der Konsole aus können Sie einen privaten Workflow mit einem Benutzer teilen, der sich AWS-Konto in derselben Region wie der Workflow befindet.

Um einen privaten Workflow zu teilen

1. Öffnen Sie die HealthOmics -Konsole.

2. Öffnen Sie bei Bedarf den linken Navigationsbereich (≡). Wählen Sie Private Workflows aus.

3. Wählen Sie in der Tabelle Workflows auf der Seite Private Workflows den Workflow aus, den Sie teilen möchten, und wählen Sie Teilen aus.

4. Geben Sie auf der Workflow-Seite „Teilen“ im Bereich „Details teilen“ einen beschreibenden Namen für den Share ein und geben Sie den Namen AWS-Konto des Abonnenten ein.

5. Wählen Sie Ressource teilen aus. Die Konsole zeigt Ressourcenfreigaben auf der Seite Alle Ressourcenfreigaben an.

Der ursprüngliche Status der Aktie ist ausstehend. Nachdem der Abonnent die Aktie akzeptiert hat, wechselt der Status in Aktiv.

Einen privaten Workflow mithilfe der CLI teilen

Verwenden Sie den API-Vorgang create-share, um eine Workflow-Freigabe zu erstellen. Der Hauptabonnent ist AWS-Konto der Benutzer, der Zugriff auf den Workflow erhält.

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

Wenn die Erstellung erfolgreich ist, erhalten Sie eine Antwort mit der Share-ID und dem Status.

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

Die Aktie bleibt im Status „Ausstehend“, bis der Abonnent sie mithilfe der accept-share API-Operation akzeptiert.

Weitere Beispiele Cross-account gemeinsame Nutzung von Ressourcen in AWS HealthOmics für die API-Nutzung finden Sie unter.

Akzeptieren eines gemeinsamen Workflows mithilfe der Konsole

Sie können die Konsole verwenden, um eine angebotene Workflow-Freigabe anzunehmen. Stellen Sie sicher, dass die Konsole auf dieselbe Region wie der Workflow eingestellt ist.

1. Öffnen Sie die HealthOmics -Konsole.

2. Öffnen Sie bei Bedarf den linken Navigationsbereich (≡). Wählen Sie „Alle gemeinsam genutzten Ressourcen“ und dann den Tab „Für mich geteilt“.

3. Wählen Sie in der Tabelle Für mich geteilte Ressourcen die Workflow-Freigabe aus und klicken Sie dann auf Annehmen.

Nachdem Sie den Workflow akzeptiert haben, wählen Sie den Link Ressource für den gemeinsam genutzten Workflow, um dessen Details anzuzeigen.

Einen gemeinsamen Workflow mithilfe der Konsole ausführen

Nachdem Sie eine Workflow-Freigabe akzeptiert haben, können Sie eine Ausführung des Workflows starten.

1. Öffnen Sie die HealthOmics -Konsole.

2. Öffnen Sie bei Bedarf den linken Navigationsbereich (≡). Wählen Sie „Alle gemeinsam genutzten Ressourcen“ und dann den Tab „Für mich geteilt“.

3. Wählen Sie in der Tabelle „Für mich geteilte Ressourcen“ den Link „Ressource“ für den gemeinsam genutzten Workflow aus.

4. Wählen Sie auf der Seite mit den Workflow-Details die Option Lauf erstellen aus.

   Die Konsole öffnet die Seite „Run erstellen“, auf der der Workflowtyp (gemeinsam) und die Workflow-ID vorausgefüllt sind.

5. Konfigurieren Sie die verbleibenden Felder im Formular „Ausführung erstellen“. Weitere Informationen finden Sie unter Einen Lauf mit der Konsole starten.

Ausführen eines gemeinsamen Workflows mithilfe der API

Verwenden Sie get-workflow, um den ARN des gemeinsamen Workflows abzurufen.

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

Wenn Sie den Workflow ausführen, geben Sie die AWS-Konto ID des Workflow-Besitzers und den ARN des gemeinsamen Workflows an.

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