Omics / Client / get_share

get_share#

Omics.Client.get_share(**kwargs)#

Retrieves the metadata for the specified resource share.

See also: AWS API Documentation

Request Syntax

response = client.get_share(
    shareId='string'
)
Parameters:

shareId (string) –

[REQUIRED]

The ID of the share.

Return type:

dict

Returns:

Response Syntax

{
    'share': {
        'shareId': 'string',
        'resourceArn': 'string',
        'resourceId': 'string',
        'principalSubscriber': 'string',
        'ownerId': 'string',
        'status': 'PENDING'|'ACTIVATING'|'ACTIVE'|'DELETING'|'DELETED'|'FAILED',
        'statusMessage': 'string',
        'shareName': 'string',
        'creationTime': datetime(2015, 1, 1),
        'updateTime': datetime(2015, 1, 1)
    }
}

Response Structure

  • (dict) –

    • share (dict) –

      A resource share details object. The object includes the status, the resourceArn, and ownerId.

      • shareId (string) –

        The ID of the resource share.

      • resourceArn (string) –

        The Arn of the shared resource.

      • resourceId (string) –

        The ID of the shared resource.

      • principalSubscriber (string) –

        The principal subscriber is the account that is sharing the resource.

      • ownerId (string) –

        The account ID for the data owner. The owner creates the resource share.

      • status (string) –

        The status of the share.

      • statusMessage (string) –

        The status message for a resource share. It provides additional details about the share status.

      • shareName (string) –

        The name of the resource share.

      • creationTime (datetime) –

        The timestamp of when the resource share was created.

      • updateTime (datetime) –

        The timestamp of the resource share update.

Exceptions