Share Subscriptions - List Synchronization Details

Odwołanie

Service:: Data Share

API Version:: 2021-08-01

Wyświetlanie listy szczegółów poziomu zestawu danych dotyczących synchronizacji subskrypcji udziału
Wyświetlanie listy szczegółów synchronizacji

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}

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
accountName	path	True	string	Nazwa konta udziału.
resourceGroupName	path	True	string	Nazwa grupy zasobów.
shareSubscriptionName	path	True	string	Nazwa subskrypcji udziału.
subscriptionId	path	True	string	Identyfikator subskrypcji
api-version	query	True	string	Wersja interfejsu API do użycia.
$filter	query		string	Filtruje wyniki przy użyciu składni OData.
$orderby	query		string	Sortuje wyniki przy użyciu składni OData.
$skipToken	query		string	Token kontynuacji

Treść żądania

Nazwa	Wymagane	Typ	Opis
synchronizationId	True	string	Identyfikator synchronizacji

Odpowiedzi

Nazwa	Typ	Opis
200 OK	SynchronizationDetailsList	Powodzenie
Other Status Codes	DataShareError	Odebrano odpowiedź o błędzie od dostawcy zasobów Microsoft.DataShare.

Zabezpieczenia

azure_auth

Przepływ OAuth2 usługi Azure Active Directory.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

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

Definicje

Nazwa	Opis
dataSetType	Typ zestawu danych
DataShareError	Model błędu udziału danych.
DataShareErrorInfo	Model treści błędu udziału danych.
ShareSubscriptionSynchronization	Obiekt transferu danych ShareSubscriptionSynchronization.
SynchronizationDetails	Szczegóły synchronizacji na poziomie zestawu danych
SynchronizationDetailsList	szczegóły synchronizacji
synchronizationMode	Tryb synchronizacji

dataSetType

Typ zestawu danych

Nazwa	Typ	Opis
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

Model błędu udziału danych.

Nazwa	Typ	Opis
error	DataShareErrorInfo	Treść błędu udziału danych

DataShareErrorInfo

Model treści błędu udziału danych.

Nazwa	Typ	Opis
code	string	Kod błędu
details	DataShareErrorInfo[]	Zagnieżdżone szczegóły modelu błędu
message	string	Komunikat o błędzie
target	string	Element docelowy błędu

ShareSubscriptionSynchronization

Obiekt transferu danych ShareSubscriptionSynchronization.

Nazwa	Typ	Opis
durationMs	integer	Czas trwania synchronizacji
endTime	string	Godzina zakończenia synchronizacji
message	string	komunikat o synchronizacji
startTime	string	godzina rozpoczęcia synchronizacji
status	string	Stan nieprzetworzonego
synchronizationId	string	Identyfikator synchronizacji
synchronizationMode	synchronizationMode	Tryb synchronizacji

SynchronizationDetails

Szczegóły synchronizacji na poziomie zestawu danych

Nazwa	Typ	Opis
dataSetId	string	Identyfikator zestawu danych
dataSetType	dataSetType	Typ zestawu danych
durationMs	integer	Czas trwania kopiowania na poziomie zestawu danych
endTime	string	Godzina zakończenia kopiowania na poziomie zestawu danych
filesRead	integer	Liczba plików odczytanych ze źródłowego zestawu danych
filesWritten	integer	Liczba plików zapisanych w zestawie danych ujścia
message	string	Komunikat o błędzie, jeśli istnieje
name	string	Nazwa zestawu danych
rowsCopied	integer	Liczba plików skopiowanych do zestawu danych ujścia
rowsRead	integer	Liczba wierszy odczytanych ze źródłowego zestawu danych.
sizeRead	integer	Rozmiar danych odczytanych ze źródłowego zestawu danych w bajtach
sizeWritten	integer	Rozmiar danych zapisanych w zestawie danych ujścia w bajtach
startTime	string	Godzina rozpoczęcia kopiowania na poziomie zestawu danych
status	string	Stan nieprzetworzonego
vCore	integer	Jednostki rdzeni wirtualnych używane na potrzeby synchronizacji zestawu danych

SynchronizationDetailsList

szczegóły synchronizacji

Nazwa	Typ	Opis
nextLink	string	Adres URL następnej strony wyników.
value	SynchronizationDetails[]	Kolekcja elementów typu DataTransferObjects.

synchronizationMode

Tryb synchronizacji

Nazwa	Typ	Opis
FullSync	string
Incremental	string

Udostępnij za pośrednictwem