Share Subscriptions - Synchronize
Initiate an asynchronous data share job
Initiate a copy
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shareSubscriptions/{shareSubscriptionName}/synchronize?api-version=2021-08-01
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. |
share
|
path | True |
string |
The name of share subscription |
subscription
|
path | True |
string |
The subscription identifier |
api-version
|
query | True |
string |
The api version to use. |
Request Body
Name | Type | Description |
---|---|---|
synchronizationMode |
Mode of synchronization used in triggers and snapshot sync. Incremental by default |
Responses
Name | Type | Description |
---|---|---|
200 OK |
Success |
|
202 Accepted |
Accepted |
|
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_Synchronize
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
{
"startTime": "2019-06-30T02:37:48.4979104Z",
"status": "Succeeded",
"synchronizationId": "343c4772-ad68-41aa-91b9-bab1c92f9c27"
}
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
x-ms-long-running-operation: True
Azure-AsyncOperation: https://management.azure.com/subscriptions/d8869ae5-cd9e-413a-b660-104573d8bcee/resourceGroups/testrg/providers/Microsoft.DataShare/accounts/consumerAccount/shareSubscriptions/shareSub1/operationResults/dad6baec-3a39-41df-a469-843a9ee94213?api-version=2018-11-01-preview
{
"startTime": "2019-06-30T02:37:48.4979104Z",
"status": "Accepted",
"synchronizationId": "343c4772-ad68-41aa-91b9-bab1c92f9c27"
}
Definitions
Name | Description |
---|---|
Data |
The data share error model. |
Data |
The data share error body model. |
Share |
A ShareSubscriptionSynchronization data transfer object. |
synchronization |
Synchronization mode |
Synchronize |
Payload for the synchronizing the data. |
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 |
ShareSubscriptionSynchronization
A ShareSubscriptionSynchronization data transfer object.
Name | Type | Description |
---|---|---|
durationMs |
integer |
Synchronization duration |
endTime |
string |
End time of synchronization |
message |
string |
message of Synchronization |
startTime |
string |
start time of synchronization |
status |
string |
Raw Status |
synchronizationId |
string |
Synchronization id |
synchronizationMode |
Synchronization Mode |
synchronizationMode
Synchronization mode
Name | Type | Description |
---|---|---|
FullSync |
string |
|
Incremental |
string |
Synchronize
Payload for the synchronizing the data.
Name | Type | Description |
---|---|---|
synchronizationMode |
Mode of synchronization used in triggers and snapshot sync. Incremental by default |