Omics / Client / get_workflow_version

get_workflow_version¶

Omics.Client.get_workflow_version(**kwargs)¶

Gets information about a workflow version. For more information, see Workflow versioning in Amazon Web Services HealthOmics in the Amazon Web Services HealthOmics User Guide.

Request Syntax

response = client.get_workflow_version(
    workflowId='string',
    versionName='string',
    type='PRIVATE'|'READY2RUN',
    export=[
        'DEFINITION'|'README',
    ],
    workflowOwnerId='string'
)

Parameters:

workflowId (string) –
[REQUIRED]

The workflow’s ID. The workflowId is not the UUID.
versionName (string) –
[REQUIRED]

The workflow version name.
type (string) – The workflow’s type.
export (list) –
The export format for the workflow.
- (string) –
workflowOwnerId (string) – The 12-digit account ID of the workflow owner. The workflow owner ID can be retrieved using the GetShare API operation. If you are the workflow owner, you do not need to include this ID.

Return type:

dict

Returns:

Response Syntax

{
    'arn': 'string',
    'workflowId': 'string',
    'versionName': 'string',
    'accelerators': 'GPU',
    'creationTime': datetime(2015, 1, 1),
    'description': 'string',
    'definition': 'string',
    'digest': 'string',
    'engine': 'WDL'|'NEXTFLOW'|'CWL'|'WDL_LENIENT',
    'main': 'string',
    'metadata': {
        'string': 'string'
    },
    'parameterTemplate': {
        'string': {
            'description': 'string',
            'optional': True|False
        }
    },
    'status': 'CREATING'|'ACTIVE'|'UPDATING'|'DELETED'|'FAILED'|'INACTIVE',
    'statusMessage': 'string',
    'storageType': 'STATIC'|'DYNAMIC',
    'storageCapacity': 123,
    'type': 'PRIVATE'|'READY2RUN',
    'tags': {
        'string': 'string'
    },
    'uuid': 'string',
    'workflowBucketOwnerId': 'string',
    'containerRegistryMap': {
        'registryMappings': [
            {
                'upstreamRegistryUrl': 'string',
                'ecrRepositoryPrefix': 'string',
                'upstreamRepositoryPrefix': 'string',
                'ecrAccountId': 'string',
                'credentialArn': 'string'
            },
        ],
        'imageMappings': [
            {
                'sourceImage': 'string',
                'destinationImage': 'string'
            },
        ]
    },
    'readme': 'string',
    'definitionRepositoryDetails': {
        'connectionArn': 'string',
        'fullRepositoryId': 'string',
        'sourceReference': {
            'type': 'BRANCH'|'TAG'|'COMMIT',
            'value': 'string'
        },
        'providerType': 'string',
        'providerEndpoint': 'string'
    },
    'readmePath': 'string',
    'profiles': [
        'string',
    ],
    'profileParameterTemplates': {
        'string': {
            'string': {
                'description': 'string',
                'optional': True|False
            }
        }
    }
}

Response Structure

(dict) –
- arn (string) –
  
  ARN of the workflow version.
- workflowId (string) –
  
  The workflow’s ID.
- versionName (string) –
  
  The workflow version name.
- accelerators (string) –
  
  The accelerator for this workflow version.
- creationTime (datetime) –
  
  When the workflow version was created.
- description (string) –
  
  Description of the workflow version.
- definition (string) –
  
  Definition of the workflow version.
- digest (string) –
  
  The workflow version’s digest.
- engine (string) –
  
  The workflow engine for this workflow version.
- main (string) –
  
  The path of the main definition file for the workflow.
- metadata (dict) –
  
  The metadata for the workflow version.
  - (string) –
    - (string) –
- parameterTemplate (dict) –
  
  The parameter template for the workflow version.
  - (string) –
    - (dict) –
      
      A workflow parameter.
      - description (string) –
        
        The parameter’s description.
      - optional (boolean) –
        
        Whether the parameter is optional.
- status (string) –
  
  The workflow version status
- statusMessage (string) –
  
  The workflow version status message
- storageType (string) –
  
  The default storage type for the run.
- storageCapacity (integer) –
  
  The default run storage capacity for static storage.
- type (string) –
  
  The workflow version type
- tags (dict) –
  
  The workflow version tags
  - (string) –
    - (string) –
- uuid (string) –
  
  The universally unique identifier (UUID) value for this workflow version
- workflowBucketOwnerId (string) –
  
  Amazon Web Services Id of the owner of the bucket.
- containerRegistryMap (dict) –
  
  The registry map that this workflow version uses.
  - registryMappings (list) –
    
    The mappings between upstream container registries and repository prefixes in your Amazon Elastic Container Registry (Amazon ECR) private registry. The list can include both pull through cache mappings and mappings for registries that Amazon Web Services HealthOmics copies images from.
    - (dict) –
      
      Maps an upstream container registry to a repository prefix in your Amazon Elastic Container Registry (Amazon ECR) private registry. For registries that Amazon ECR pull through cache supports, you create a pull through cache rule that synchronizes the upstream repositories with your private repositories. You can also use some registries that pull through cache doesn’t support. For these registries, specify credentialArn, and Amazon Web Services HealthOmics copies each image into a private Amazon ECR repository the first time a task needs it.
      - upstreamRegistryUrl (string) –
        
        The URI of the upstream registry.
      - ecrRepositoryPrefix (string) –
        
        The repository prefix to use in the ECR private repository.
      - upstreamRepositoryPrefix (string) –
        
        The repository prefix of the corresponding repository in the upstream registry.
      - ecrAccountId (string) –
        
        Account ID of the account that owns the upstream container image.
      - credentialArn (string) –
        
        The Amazon Resource Name (ARN) of the Amazon Web Services Secrets Manager secret that holds the credentials for the upstream registry. You must specify this value when Amazon Elastic Container Registry (Amazon ECR) doesn’t support pull through cache for the upstream registry. HealthOmics supports only some of these registries. The workflow role must have permission to call the secretsmanager:GetSecretValue operation on the secret. For more information about the supported registries, see Container images in the Amazon Web Services HealthOmics User Guide.
  - imageMappings (list) –
    
    Image mappings specify path mappings between the ECR private repository and their corresponding external repositories.
    - (dict) –
      
      Specifies image mappings that workflow tasks can use. For example, you can replace all the task references of a public image to use an equivalent image in your private ECR repository. You can use image mappings with upstream registries that don’t support pull through cache. You need to manually synchronize the upstream registry with your private repository.
      - sourceImage (string) –
        
        Specifies the URI of the source image in the upstream registry.
      - destinationImage (string) –
        
        Specifies the URI of the corresponding image in the private ECR registry.
- readme (string) –
  
  The README content for the workflow version, providing documentation and usage information specific to this version.
- definitionRepositoryDetails (dict) –
  
  Details about the source code repository that hosts the workflow version definition files.
  - connectionArn (string) –
    
    The Amazon Resource Name (ARN) of the connection to the source code repository.
  - fullRepositoryId (string) –
    
    The full repository identifier, including the repository owner and name. For example, ‘repository-owner/repository-name’.
  - sourceReference (dict) –
    
    The source reference for the repository, such as a branch name, tag, or commit ID.
    - type (string) –
      
      The type of source reference, such as branch, tag, or commit.
    - value (string) –
      
      The value of the source reference, such as the branch name, tag name, or commit ID.
  - providerType (string) –
    
    The provider type of the source code repository, such as Bitbucket, GitHub, GitHubEnterpriseServer, GitLab, and GitLabSelfManaged.
  - providerEndpoint (string) –
    
    The endpoint URL of the source code repository provider.
- readmePath (string) –
  
  The path to the workflow version README markdown file within the repository. This file provides documentation and usage information for the workflow. If not specified, the README.md file from the root directory of the repository will be used.
- profiles (list) –
  
  The list of Nextflow profiles that are available for this workflow version. Profiles allow you to select predefined configuration settings at runtime.
  - (string) –
- profileParameterTemplates (dict) –
  
  A mapping of profile names to their parameter templates. Each profile defines its own set of parameters that you can use when starting a run with that profile.
  - (string) –
    - (dict) –
      - (string) –
        
        (dict) –
        
        A workflow parameter.
        
        description (string) –
        
        The parameter’s description.
        
        optional (boolean) –
        
        Whether the parameter is optional.

Exceptions

Omics.Client.exceptions.InternalServerException
Omics.Client.exceptions.ServiceQuotaExceededException
Omics.Client.exceptions.ThrottlingException
Omics.Client.exceptions.ValidationException
Omics.Client.exceptions.ConflictException
Omics.Client.exceptions.ResourceNotFoundException
Omics.Client.exceptions.AccessDeniedException
Omics.Client.exceptions.RequestTimeoutException