Omics / Client / list_shares
list_shares#
- Omics.Client.list_shares(**kwargs)#
Lists all shares associated with an account.
See also: AWS API Documentation
Request Syntax
response = client.list_shares( resourceOwner='SELF'|'OTHER', filter={ 'resourceArns': [ 'string', ], 'status': [ 'PENDING'|'ACTIVATING'|'ACTIVE'|'DELETING'|'DELETED'|'FAILED', ] }, nextToken='string', maxResults=123 )
- Parameters:
resourceOwner (string) –
[REQUIRED]
The account that owns the analytics store shared.
filter (dict) –
Attributes used to filter for a specific subset of shares.
resourceArns (list) –
The Amazon Resource Number (Arn) for an analytics store.
(string) –
status (list) –
The status of an annotation store version.
(string) –
nextToken (string) – Next token returned in the response of a previous ListReadSetUploadPartsRequest call. Used to get the next page of results.
maxResults (integer) – The maximum number of shares to return in one page of results.
- Return type:
dict
- Returns:
Response Syntax
{ 'shares': [ { 'shareId': 'string', 'resourceArn': '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) }, ], 'nextToken': 'string' }
Response Structure
(dict) –
shares (list) –
The shares available and their meta details.
(dict) –
The details of a share.
shareId (string) –
The ID for a share offer for an analytics store .
resourceArn (string) –
The resource Arn of the analytics store being shared.
principalSubscriber (string) –
The principal subscriber is the account the analytics store data is being shared with.
ownerId (string) –
The account ID for the data owner. The owner creates the share offer.
status (string) –
The status of a share.
statusMessage (string) –
The status message for a share. It provides more details on the status of the share.
shareName (string) –
The name of the share.
creationTime (datetime) –
The timestamp for when the share was created.
updateTime (datetime) –
The timestamp of the share update.
nextToken (string) –
Next token returned in the response of a previous ListSharesResponse call. Used to get the next page of results.
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