Compartir HealthOmics flujos de trabajo

Como propietario de un flujo de trabajo privado, puedes compartirlo con alguien Cuenta de AWS de la misma región. Para compartir un flujo de trabajo con más de uno Cuenta de AWS, debe crear varios recursos compartidos del mismo flujo de trabajo.

Como propietario, puede revocar el acceso a un flujo de trabajo compartido eliminando el recurso compartido.

nota

HealthOmics permite automáticamente que un flujo de trabajo compartido acceda al repositorio de Amazon ECR mientras el flujo de trabajo se ejecuta en la cuenta del suscriptor. No es necesario conceder acceso adicional al repositorio para los flujos de trabajo compartidos.

Cuando compartes un flujo de trabajo, el suscriptor puede usar cualquiera de las versiones del flujo de trabajo. Si necesita un control de acceso a nivel de versión para un flujo de trabajo compartido, le recomendamos que cree flujos de trabajo independientes en lugar de utilizar versiones del flujo de trabajo.

Suscribirse a un flujo de trabajo compartido

Para suscribirse a un flujo de trabajo compartido, siga estos pasos generales para aceptar y utilizar el flujo de trabajo:

1. Usa la consola o la API para aceptar el uso compartido. Configura tu región actual en la misma región que la solicitud de compartición.

   • Para encontrar la solicitud para compartir en la consola, ve a la página Todos los recursos compartidos y, a continuación, selecciona la pestaña Compartido conmigo.

2. Usa la consola o la API para crear una ejecución para el flujo de trabajo compartido.

   • Para encontrar la página de detalles del flujo de trabajo en la consola, ve a Compartido conmigo (consulta el paso 1) y, a continuación, selecciona el enlace Recurso para el flujo de trabajo compartido.

3. Usted proporciona sus propios datos de entrada para el flujo de trabajo.

4. El flujo de trabajo compartido se ejecuta en su Cuenta de AWS.

Como suscriptor de un flujo de trabajo compartido, el sistema le impide realizar las siguientes acciones del flujo de trabajo:

• Exportación de un flujo de trabajo compartido

• Volver a ejecutar el flujo de trabajo compartido

  • Se crea una nueva ejecución para el flujo de trabajo compartido.

• Volver a compartir el flujo de trabajo.

• Asignación de una etiqueta al flujo de trabajo.

• Eliminar el flujo de trabajo.

  • Cuando ya no necesite el flujo de trabajo, eliminará el recurso compartido del flujo de trabajo.

Consulte Uso compartido de recursos entre cuentas en AWS HealthOmics para obtener información adicional sobre el uso compartido de recursos.

Supervisión del estado de un flujo de trabajo compartido

HealthOmics envía un evento a EventBridge por cada cambio de estado de un flujo de trabajo compartido. Si desea recibir notificaciones sobre cambios de estado específicos, configure una EventBridge regla para supervisar los eventos de cambio de estado de los flujos de trabajo compartidos. Por ejemplo:

• Desea recibir una notificación cada vez que reciba una solicitud para compartir un flujo de trabajo y cada vez que un usuario revoque un flujo de trabajo compartido.

• Tras iniciar una solicitud para compartir un flujo de trabajo, querrá recibir una notificación cuando el usuario acepte o rechace la solicitud.

Para obtener más información sobre el uso de eventos, consulteUso EventBridge con AWS HealthOmics.

Compartir un flujo de trabajo privado mediante la consola

Desde la consola, puedes compartir un flujo de trabajo privado con alguien de Cuenta de AWS la misma región que el flujo de trabajo.

Para compartir un flujo de trabajo privado

1. Abra la consola de HealthOmics .

2. En el panel de navegación izquierdo, selecciona Flujos de trabajo privados.

3. En la tabla Flujos de trabajo de la página Flujos de trabajo privados, seleccione el flujo de trabajo que desee compartir y elija Compartir.

4. En el panel de detalles de la página Compartir flujo de trabajo, introduzca un nombre descriptivo para el recurso compartido e introduzca el nombre Cuenta de AWS del suscriptor.

5. Seleccione Compartir recurso. La consola muestra los recursos compartidos en la página Todos los recursos compartidos.

El estado inicial del recurso compartido está pendiente. Una vez que el suscriptor acepta la acción, el estado cambia a activo.

Compartir un flujo de trabajo privado mediante la CLI

Utilice la operación de API crear-compartir para crear un flujo de trabajo compartido. El suscriptor principal es Cuenta de AWS el usuario que tendrá acceso al flujo de trabajo.

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

Si la creación se realiza correctamente, recibirá una respuesta con el ID y el estado del recurso compartido.

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

El recurso compartido permanece en estado pendiente hasta que el suscriptor lo acepte mediante la operación de accept-share API.

Consulte otros ejemplos Uso compartido de recursos entre cuentas en AWS HealthOmics de uso de la API.

Aceptar un flujo de trabajo compartido mediante la consola

Puede usar la consola para aceptar un flujo de trabajo compartido ofrecido. Asegúrese de configurar la consola en la misma región que el flujo de trabajo.

1. Abra la consola de HealthOmics .

2. En el panel de navegación izquierdo, selecciona Todos los recursos compartidos y, a continuación, selecciona la pestaña Compartidos conmigo.

3. En la tabla Recursos compartidos conmigo, selecciona el recurso compartido del flujo de trabajo y, a continuación, selecciona Aceptar.

Tras aceptar el flujo de trabajo, elija el enlace Recurso del flujo de trabajo compartido para ver sus detalles.

Ejecutar un flujo de trabajo compartido mediante la consola

Tras aceptar un flujo de trabajo compartido, puede iniciar una ejecución en el flujo de trabajo.

1. Abra la consola de HealthOmics .

2. En el panel de navegación izquierdo, selecciona Todos los recursos compartidos y, a continuación, selecciona la pestaña Compartido conmigo.

3. En la tabla Recursos compartidos conmigo, seleccione el enlace Recurso para el flujo de trabajo compartido.

4. En la página de detalles del flujo de trabajo, seleccione Crear ejecución.

   La consola abre la página Crear ejecución, con el tipo de flujo de trabajo (compartido) y el ID del flujo de trabajo rellenados previamente.

5. Configure los campos restantes en el formulario Crear ejecución. Para obtener información adicional, consulta Iniciar una ejecución mediante la consola.

Ejecutar un flujo de trabajo compartido mediante la API

Utilice get-workflow para recuperar el ARN del flujo de trabajo compartido.

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

Cuando ejecute el flujo de trabajo, proporcione el Cuenta de AWS ID del propietario del flujo de trabajo y el ARN del flujo de trabajo compartido.

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