Share Subscriptions - List By Account
List of available share subscriptions under an account.
List share subscriptions in an account
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shareSubscriptions?api-version=2021-08-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shareSubscriptions?api-version=2021-08-01&$skipToken={$skipToken}&$filter={$filter}&$orderby={$orderby}
URI Parameters
Name | In | Required | Type | Description |
---|---|---|---|---|
account
|
path | True |
string |
The name of the share account. |
resource
|
path | True |
string |
The resource group name. |
subscription
|
path | True |
string |
The subscription identifier |
api-version
|
query | True |
string |
The api version to use. |
$filter
|
query |
string |
Filters the results using OData syntax. |
|
$orderby
|
query |
string |
Sorts the results using OData syntax. |
|
$skip
|
query |
string |
Continuation Token |
Responses
Name | Type | Description |
---|---|---|
200 OK |
Success |
|
Other Status Codes |
An error response received from the Microsoft.DataShare resource provider. |
Security
azure_auth
Azure Active Directory OAuth2 Flow.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | impersonate your user account |
Examples
ShareSubscriptions_ListByAccount
Sample Request
Sample Response
Date: Wed, 13 Sep 2017 18:04:32 GMT
x-ms-request-id: d5496da4-9c52-402f-b067-83cc9ddea888
X-Content-Type-Options: nosniff
x-ms-ratelimit-remaining-tenant-reads: 14999
x-ms-correlation-request-id: 25c78f97-0b0a-4fe9-ad39-883a482265cd
{
"value": [
{
"properties": {
"invitationId": "12345678-1234-1234-12345678abd",
"sourceShareLocation": "eastus2",
"shareSubscriptionStatus": "Active",
"userName": "johnsmith@microsoft.com",
"createdAt": "2018-11-14T06:15:15.6818898Z",
"userEmail": "john.smith@microsoft.com",
"shareName": "share1",
"shareDescription": "Some share",
"shareTerms": "Confidential",
"shareKind": "CopyBased",
"providerTenantName": "Microsoft",
"providerName": "Jack Rose",
"providerEmail": "jack.rose@microsoft.com",
"expirationDate": "2020-08-26T22:33:24.5785265Z"
},
"id": "/subscriptions/433a8dfd-e5d5-4e77-ad86-90acdc75eb1a/resourceGroups/SampleResourceGroup/providers/Microsoft.DataShare/accounts/Account1/sharesubscriptions/ShareSubscription1",
"name": "ShareSubscription1",
"type": "Microsoft.DataShare/accounts/shareSubscriptions"
},
{
"properties": {
"userName": "John Smith",
"userEmail": "john.smith@microsoft.com",
"createdAt": "2020-12-17T22:32:36.8185016Z",
"shareSubscriptionStatus": "Active",
"invitationId": "4256e2cf-0f82-4865-961b-12f83333f487",
"sourceShareLocation": "eastus2",
"shareName": "share1",
"shareDescription": "Some share",
"shareTerms": "Confidential",
"shareKind": "CopyBased",
"providerTenantName": "Microsoft",
"providerName": "Jack Rose",
"providerEmail": "jack.rose@microsoft.com",
"expirationDate": "2020-08-26T22:33:24.5785265Z"
},
"id": "/subscriptions/433a8dfd-e5d5-4e77-ad86-90acdc75eb1a/resourceGroups/SampleResourceGroup/providers/Microsoft.DataShare/accounts/Account1/sharesubscriptions/ShareSubscription1",
"name": "ShareSubscription1",
"type": "Microsoft.DataShare/accounts/shareSubscriptions"
}
]
}
Definitions
Name | Description |
---|---|
created |
The type of identity that created the resource. |
Data |
The data share error model. |
Data |
The data share error body model. |
last |
The type of identity that last modified the resource. |
provisioning |
Provisioning state of the Account |
share |
Share kind. |
Share |
A share subscription data transfer object. |
Share |
List response for get ShareSubscription. |
share |
Gets the status of share subscription |
System |
Metadata pertaining to creation and last modification of the resource. |
createdByType
The type of identity that created the resource.
Name | Type | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
DataShareError
The data share error model.
Name | Type | Description |
---|---|---|
error |
The data share error body |
DataShareErrorInfo
The data share error body model.
Name | Type | Description |
---|---|---|
code |
string |
Code of the error |
details |
Nested details of the error model |
|
message |
string |
Message of the error |
target |
string |
Target of the error |
lastModifiedByType
The type of identity that last modified the resource.
Name | Type | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
provisioningState
Provisioning state of the Account
Name | Type | Description |
---|---|---|
Creating |
string |
|
Deleting |
string |
|
Failed |
string |
|
Moving |
string |
|
Succeeded |
string |
shareKind
Share kind.
Name | Type | Description |
---|---|---|
CopyBased |
string |
|
InPlace |
string |
ShareSubscription
A share subscription data transfer object.
Name | Type | Description |
---|---|---|
id |
string |
The resource id of the azure resource |
name |
string |
Name of the azure resource |
properties.createdAt |
string |
Time at which the share subscription was created. |
properties.expirationDate |
string |
The expiration date of the share subscription. |
properties.invitationId |
string |
The invitation id. |
properties.providerEmail |
string |
Email of the provider who created the resource |
properties.providerName |
string |
Name of the provider who created the resource |
properties.providerTenantName |
string |
Tenant name of the provider who created the resource |
properties.provisioningState |
Provisioning state of the share subscription |
|
properties.shareDescription |
string |
Description of share |
properties.shareKind |
Kind of share |
|
properties.shareName |
string |
Name of the share |
properties.shareSubscriptionStatus |
Gets the current status of share subscription. |
|
properties.shareTerms |
string |
Terms of a share |
properties.sourceShareLocation |
string |
Source share location. |
properties.userEmail |
string |
Email of the user who created the resource |
properties.userName |
string |
Name of the user who created the resource |
systemData |
System Data of the Azure resource. |
|
type |
string |
Type of the azure resource |
ShareSubscriptionList
List response for get ShareSubscription.
Name | Type | Description |
---|---|---|
nextLink |
string |
The Url of next result page. |
value |
Collection of items of type DataTransferObjects. |
shareSubscriptionStatus
Gets the status of share subscription
Name | Type | Description |
---|---|---|
Active |
string |
|
Revoked |
string |
|
Revoking |
string |
|
SourceDeleted |
string |
SystemData
Metadata pertaining to creation and last modification of the resource.
Name | Type | Description |
---|---|---|
createdAt |
string |
The timestamp of resource creation (UTC). |
createdBy |
string |
The identity that created the resource. |
createdByType |
The type of identity that created the resource. |
|
lastModifiedAt |
string |
The type of identity that last modified the resource. |
lastModifiedBy |
string |
The identity that last modified the resource. |
lastModifiedByType |
The type of identity that last modified the resource. |