Share Subscriptions - List Synchronization Details

リファレンス

サービス:: Data Share

API バージョン:: 2021-08-01

共有サブスクリプション同期のデータセットレベルの詳細を一覧表示する
同期の詳細を一覧表示する

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

省略可能なパラメーターを含む:

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

URI パラメーター

名前	/	必須	型	説明
accountName	path	True	string	共有アカウントの名前。
resourceGroupName	path	True	string	リソースグループ名。
shareSubscriptionName	path	True	string	共有サブスクリプションの名前。
subscriptionId	path	True	string	サブスクリプション識別子
api-version	query	True	string	使用する API バージョン。
$filter	query		string	OData 構文を使用して結果をフィルター処理します。
$orderby	query		string	OData 構文を使用して結果を並べ替えます。
$skipToken	query		string	継続トークン

要求本文

名前	必須	型	説明
synchronizationId	True	string	同期 ID

応答

名前	型	説明
200 OK	SynchronizationDetailsList	成功
Other Status Codes	DataShareError	Microsoft.DataShare リソースプロバイダーから受信したエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー。

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前	説明
user_impersonation	ユーザーアカウントを偽装する

例

ShareSubscriptions_ListSynchronizationDetails

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

{
  "synchronizationId": "7d0536a6-3fa5-43de-b152-3d07c4f6b2bb"
}

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

// Generated from example definition: specification/datashare/resource-manager/Microsoft.DataShare/stable/2021-08-01/examples/ShareSubscriptions_ListSynchronizationDetails.json
// this example is just showing the usage of "ShareSubscriptions_ListSynchronizationDetails" 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 ShareSubscriptionResource created on azure
// for more information of creating ShareSubscriptionResource, please refer to the document of ShareSubscriptionResource
string subscriptionId = "433a8dfd-e5d5-4e77-ad86-90acdc75eb1a";
string resourceGroupName = "SampleResourceGroup";
string accountName = "Account1";
string shareSubscriptionName = "ShareSub1";
ResourceIdentifier shareSubscriptionResourceId = ShareSubscriptionResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, accountName, shareSubscriptionName);
ShareSubscriptionResource shareSubscription = client.GetShareSubscriptionResource(shareSubscriptionResourceId);

// invoke the operation and iterate over the result
ShareSubscriptionSynchronization shareSubscriptionSynchronization = new ShareSubscriptionSynchronization(Guid.Parse("7d0536a6-3fa5-43de-b152-3d07c4f6b2bb"));
await foreach (SynchronizationDetails item in shareSubscription.GetSynchronizationDetailsAsync(shareSubscriptionSynchronization))
{
    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",
      "name": "datasetmapping1",
      "dataSetId": "7d0536a6-3fa5-43de-b152-3d07c4f6b2bb",
      "dataSetType": "Blob"
    }
  ]
}

定義

名前	説明
dataSetType	データ・セットのタイプ
DataShareError	データ共有エラーモデル。
DataShareErrorInfo	データ共有エラー本文モデル。
ShareSubscriptionSynchronization	ShareSubscriptionSynchronization データ転送オブジェクト。
SynchronizationDetails	データセットレベルでの同期の詳細
SynchronizationDetailsList	同期の詳細
synchronizationMode	同期モード

dataSetType

列挙

データ・セットのタイプ

値	説明
AdlsGen1File
AdlsGen1Folder
AdlsGen2File
AdlsGen2FileSystem
AdlsGen2Folder
Blob
BlobFolder
Container
KustoCluster
KustoDatabase
KustoTable
SqlDBTable
SqlDWTable
SynapseWorkspaceSqlPoolTable

DataShareError

Object

データ共有エラーモデル。

名前	型	説明
error	DataShareErrorInfo	データ共有のエラー本文

DataShareErrorInfo

Object

データ共有エラー本文モデル。

名前	型	説明
code	string	エラーのコード
details	DataShareErrorInfo[]	エラーモデルの入れ子になった詳細
message	string	エラーのメッセージ
target	string	エラーのターゲット

ShareSubscriptionSynchronization

Object

ShareSubscriptionSynchronization データ転送オブジェクト。

名前	型	説明
durationMs	integer (int32)	同期期間
endTime	string (date-time)	同期の終了時刻
message	string	同期のメッセージ
startTime	string (date-time)	同期の開始時刻
status	string	生の状態
synchronizationId	string	同期 ID
synchronizationMode	synchronizationMode	同期モード

SynchronizationDetails

Object

データセットレベルでの同期の詳細

名前	型	説明
dataSetId	string	データセットの ID
dataSetType	dataSetType	データセットの型
durationMs	integer (int32)	データ・セット・レベル・コピーの期間
endTime	string (date-time)	データ・セット・レベル・コピーの終了時刻
filesRead	integer (int64)	ソースデータセットから読み取られたファイルの数
filesWritten	integer (int64)	シンクデータセットに書き込まれたファイルの数
message	string	エラーメッセージがある場合
name	string	データセットの名前
rowsCopied	integer (int64)	シンクデータセットにコピーされたファイルの数
rowsRead	integer (int64)	ソースデータセットから読み取られた行の数。
sizeRead	integer (int64)	ソースデータセットから読み取られたデータのサイズ (バイト単位)
sizeWritten	integer (int64)	シンクデータセットに書き込まれたデータのサイズ (バイト単位)
startTime	string (date-time)	データ・セット・レベル・コピーの開始時刻
status	string	生の状態
vCore	integer (int64)	データセットの同期に使用される仮想コアユニット

SynchronizationDetailsList

Object

同期の詳細

名前	型	説明
nextLink	string	次の結果ページの URL。
value	SynchronizationDetails[]	DataTransferObjects 型の項目のコレクション。

synchronizationMode

列挙

同期モード

値	説明
FullSync
Incremental

次の方法で共有

Share Subscriptions - List Synchronization Details

URI パラメーター

要求本文

応答

セキュリティ

azure_auth

スコープ

例

ShareSubscriptions_ListSynchronizationDetails

要求のサンプル

応答のサンプル

定義

dataSetType

DataShareError

DataShareErrorInfo

ShareSubscriptionSynchronization

SynchronizationDetails

SynchronizationDetailsList

synchronizationMode

その他のリソース