Share Subscriptions - List Synchronization Details

Referencia

Service:: Data Share

API Version:: 2021-08-01

Adatkészlet-szint részleteinek listázása megosztási előfizetés szinkronizálásához
Szinkronizálás részleteinek listázása

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

With optional parameters:

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-paraméterek

Name	In	Kötelező	Típus	Description
accountName	path	True	string	A megosztási fiók neve.
resourceGroupName	path	True	string	Az erőforráscsoport neve.
shareSubscriptionName	path	True	string	A megosztási előfizetés neve.
subscriptionId	path	True	string	Az előfizetés azonosítója
api-version	query	True	string	A használni kívánt API-verzió.
$filter	query		string	OData-szintaxissal szűri az eredményeket.
$orderby	query		string	OData szintaxissal rendezi az eredményeket.
$skipToken	query		string	Folytatási jogkivonat

Kérelem törzse

Name	Kötelező	Típus	Description
synchronizationId	True	string	Szinkronizálási azonosító

Válaszok

Name	Típus	Description
200 OK	SynchronizationDetailsList	Siker
Other Status Codes	DataShareError	Hibaválasz érkezett a Microsoft.DataShare erőforrás-szolgáltatótól.

Biztonság

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	felhasználói fiók megszemélyesítése

Példák

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 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/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

Sample Response

Status code:: 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

Response Body

{
  "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"
    }
  ]
}

Definíciók

Name	Description
dataSetType	Adatkészlet típusa
DataShareError	Az adatmegosztási hibamodell.
DataShareErrorInfo	Az adatmegosztási hibatörzs modellje.
ShareSubscriptionSynchronization	ShareSubscriptionSynchronization adatátviteli objektum.
SynchronizationDetails	Szinkronizálás részletei az adatkészlet szintjén
SynchronizationDetailsList	a szinkronizálás részletei
synchronizationMode	Szinkronizálási mód

dataSetType

Adatkészlet típusa

Name	Típus	Description
AdlsGen1File	string
AdlsGen1Folder	string
AdlsGen2File	string
AdlsGen2FileSystem	string
AdlsGen2Folder	string
Blob	string
BlobFolder	string
Container	string
KustoCluster	string
KustoDatabase	string
KustoTable	string
SqlDBTable	string
SqlDWTable	string
SynapseWorkspaceSqlPoolTable	string

DataShareError

Az adatmegosztási hibamodell.

Name	Típus	Description
error	DataShareErrorInfo	Az adatmegosztási hibatörzs

DataShareErrorInfo

Az adatmegosztási hibatörzs modellje.

Name	Típus	Description
code	string	A hiba kódja
details	DataShareErrorInfo[]	A hibamodell beágyazott részletei
message	string	A hiba üzenete
target	string	A hiba célja

ShareSubscriptionSynchronization

ShareSubscriptionSynchronization adatátviteli objektum.

Name	Típus	Description
durationMs	integer	Szinkronizálás időtartama
endTime	string	A szinkronizálás befejezési időpontja
message	string	a szinkronizálás üzenete
startTime	string	szinkronizálás kezdési időpontja
status	string	Nyers állapot
synchronizationId	string	Szinkronizálási azonosító
synchronizationMode	synchronizationMode	Szinkronizálási mód

SynchronizationDetails

Szinkronizálás részletei az adatkészlet szintjén

Name	Típus	Description
dataSetId	string	Adatkészlet azonosítója
dataSetType	dataSetType	Az adatkészlet típusa
durationMs	integer	Az adatkészlet-szint másolásának időtartama
endTime	string	Az adathalmazszintű másolás befejezési időpontja
filesRead	integer	A forrásadatkészletből beolvasott fájlok száma
filesWritten	integer	A fogadó adatkészletbe írt fájlok száma
message	string	Hibaüzenet, ha van ilyen
name	string	Az adatkészlet neve
rowsCopied	integer	A fogadó adatkészletbe másolt fájlok száma
rowsRead	integer	A forrásadatkészletből beolvasott sorok száma.
sizeRead	integer	A forrásadatkészletből beolvasott adatok mérete bájtban
sizeWritten	integer	A fogadó adatkészletébe írt adatok mérete bájtban
startTime	string	Az adatkészlet-szint másolásának kezdési időpontja
status	string	Nyers állapot
vCore	integer	Az adatkészlet szinkronizálásához felhasznált virtuálismag-egységek

SynchronizationDetailsList

a szinkronizálás részletei

Name	Típus	Description
nextLink	string	A következő eredményoldal URL-címe.
value	SynchronizationDetails[]	DataTransferObjects típusú elemek gyűjteménye.

synchronizationMode

Szinkronizálási mód

Name	Típus	Description
FullSync	string
Incremental	string