Shares - List Synchronizations

參考

服務:: Data Share

API 版本:: 2021-08-01

列出共用中的同步處理
列出共用的同步處理

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shares/{shareName}/listSynchronizations?api-version=2021-08-01

含選擇性參數:

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shares/{shareName}/listSynchronizations?api-version=2021-08-01&$skipToken={$skipToken}&$filter={$filter}&$orderby={$orderby}

URI 參數

名稱	位於	必要	類型	Description
accountName	path	True	string	共用帳戶的名稱。
resourceGroupName	path	True	string	資源群組名稱。
shareName	path	True	string	共用的名稱。
subscriptionId	path	True	string	訂用帳戶標識碼
api-version	query	True	string	要使用的 API 版本。
$filter	query		string	使用 OData 語法篩選結果。
$orderby	query		string	使用 OData 語法排序結果。
$skipToken	query		string	Continuation token (接續 Token)

回應

名稱	類型	Description
200 OK	ShareSynchronizationList	Success
Other Status Codes	DataShareError	從 Microsoft.DataShare 資源提供者收到的錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱	Description
user_impersonation	模擬您的用戶帳戶

範例

Shares_ListSynchronizations

POST https://management.azure.com/subscriptions/433a8dfd-e5d5-4e77-ad86-90acdc75eb1a/resourceGroups/SampleResourceGroup/providers/Microsoft.DataShare/accounts/Account1/shares/Share1/listSynchronizations?api-version=2021-08-01

using System;
using System.Threading.Tasks;
using Azure;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.DataShare;
using Azure.ResourceManager.DataShare.Models;

// Generated from example definition: specification/datashare/resource-manager/Microsoft.DataShare/stable/2021-08-01/examples/Shares_ListSynchronizations.json
// this example is just showing the usage of "Shares_ListSynchronizations" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this DataShareResource created on azure
// for more information of creating DataShareResource, please refer to the document of DataShareResource
string subscriptionId = "433a8dfd-e5d5-4e77-ad86-90acdc75eb1a";
string resourceGroupName = "SampleResourceGroup";
string accountName = "Account1";
string shareName = "Share1";
ResourceIdentifier dataShareResourceId = DataShareResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, accountName, shareName);
DataShareResource dataShare = client.GetDataShareResource(dataShareResourceId);

// invoke the operation and iterate over the result
await foreach (ShareSynchronization item in dataShare.GetSynchronizationsAsync())
{
    Console.WriteLine($"Succeeded: {item}");
}

Console.WriteLine($"Succeeded");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

範例回覆

狀態碼:: 200

Date: Wed, 13 Sep 2017 17:33:55 GMT
x-ms-request-id: 8e58266a-de42-40d5-b3c4-c6a7e159cfba
X-Content-Type-Options: nosniff
x-ms-ratelimit-remaining-subscription-reads: 14993
x-ms-correlation-request-id: 5d862c55-4de9-4a46-969d-cf1ed3e235ed

{
  "value": [
    {
      "endTime": "2018-11-14T04:47:52.9614956Z",
      "startTime": "2018-11-14T04:47:52.9614956Z",
      "durationMs": 2000,
      "status": "Completed",
      "message": "nda",
      "consumerTenantName": "nda",
      "consumerName": "abc@yahoo.com",
      "synchronizationId": "runId",
      "synchronizationMode": "Incremental"
    }
  ]
}

定義

名稱	Description
DataShareError	數據共用錯誤模型。
DataShareErrorInfo	數據共用錯誤主體模型。
ShareSynchronization	ShareSynchronization 數據傳輸物件。
ShareSynchronizationList	列出取得 ShareSynchronization 的回應。
synchronizationMode	同步模式

DataShareError

數據共用錯誤模型。

名稱	類型	Description
error	DataShareErrorInfo	數據共用錯誤本文

DataShareErrorInfo

數據共用錯誤主體模型。

名稱	類型	Description
code	string	錯誤碼
details	DataShareErrorInfo[]	錯誤模型的巢狀詳細數據
message	string	錯誤的訊息
target	string	錯誤的目標

ShareSynchronization

ShareSynchronization 數據傳輸物件。

名稱	類型	Description
consumerEmail	string	建立同步處理的使用者 Email
consumerName	string	建立同步處理的用戶名稱
consumerTenantName	string	建立同步處理的取用者租用戶名稱
durationMs	integer	同步處理持續時間
endTime	string	同步處理的結束時間
message	string	同步處理的訊息
startTime	string	同步處理的開始時間
status	string	原始狀態
synchronizationId	string	同步處理標識碼
synchronizationMode	synchronizationMode	同步模式

ShareSynchronizationList

列出取得 ShareSynchronization 的回應。

名稱	類型	Description
nextLink	string	下一個結果頁面的 URL。
value	ShareSynchronization[]	DataTransferObjects 類型的專案集合。

synchronizationMode

同步模式

名稱	類型	Description
FullSync	string
Incremental	string

共用方式為