Share Subscriptions - List Synchronization Details

Tjänst:

Data Share

API-version:

2021-08-01

Visa information om datauppsättningsnivå för synkronisering av en resursprenumeration
Information om listsynkronisering

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

Med valfria parametrar:

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

Name	I	Obligatorisk	Typ	Description
accountName	path	True	string	Namnet på resurskontot.
resourceGroupName	path	True	string	Resursgruppens namn.
shareSubscriptionName	path	True	string	Namnet på resursprenumerationen.
subscriptionId	path	True	string	Prenumerationsidentifieraren
api-version	query	True	string	Api-versionen som ska användas.
$filter	query		string	Filtrerar resultatet med hjälp av OData-syntax.
$orderby	query		string	Sorterar resultatet med OData-syntax.
$skipToken	query		string	Fortsättningstoken

Begärandetext

Name	Obligatorisk	Typ	Description
synchronizationId	True	string	Synkroniserings-ID

Svar

Name	Typ	Description
200 OK	SynchronizationDetailsList	Framgång
Other Status Codes	DataShareError	Ett felsvar som togs emot från resursprovidern Microsoft.DataShare.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

ShareSubscriptions_ListSynchronizationDetails

Exempelbegäran

HTTP

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

dotnet

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

Exempelsvar

Statuskod:

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

Definitioner

Name	Description
dataSetType	Typ av datauppsättning
DataShareError	Dataresursens felmodell.
DataShareErrorInfo	Dataresursens feltextmodell.
ShareSubscriptionSynchronization	Ett ShareSubscriptionSynchronization-dataöverföringsobjekt.
SynchronizationDetails	Synkroniseringsinformation på datauppsättningsnivå
SynchronizationDetailsList	information om synkronisering
synchronizationMode	Synkroniseringsläge

dataSetType

Uppräkning

Typ av datauppsättning

Värde	Description
AdlsGen1File
AdlsGen1Folder
AdlsGen2File
AdlsGen2FileSystem
AdlsGen2Folder
Blob
BlobFolder
Container
KustoCluster
KustoDatabase
KustoTable
SqlDBTable
SqlDWTable
SynapseWorkspaceSqlPoolTable

DataShareError

Objekt

Dataresursens felmodell.

Name	Typ	Description
error	DataShareErrorInfo	Feltexten för dataresursen

DataShareErrorInfo

Objekt

Dataresursens feltextmodell.

Name	Typ	Description
code	string	Kod för felet
details	DataShareErrorInfo[]	Kapslad information om felmodellen
message	string	Meddelande om felet
target	string	Målet för felet

ShareSubscriptionSynchronization

Objekt

Ett ShareSubscriptionSynchronization-dataöverföringsobjekt.

Name	Typ	Description
durationMs	integer (int32)	Varaktighet för synkronisering
endTime	string (date-time)	Sluttid för synkronisering
message	string	meddelande om synkronisering
startTime	string (date-time)	starttid för synkronisering
status	string	Raw-status
synchronizationId	string	Synkroniserings-ID
synchronizationMode	synchronizationMode	Synkroniseringsläge

SynchronizationDetails

Objekt

Synkroniseringsinformation på datauppsättningsnivå

Name	Typ	Description
dataSetId	string	ID för datauppsättning
dataSetType	dataSetType	Typ av datauppsättning
durationMs	integer (int32)	Varaktighet för kopiering på datauppsättningsnivå
endTime	string (date-time)	Sluttid för kopiering på datauppsättningsnivå
filesRead	integer (int64)	Antalet filer som lästs från källdatauppsättningen
filesWritten	integer (int64)	Antalet filer som skrivits in i datauppsättningen för mottagare
message	string	Felmeddelande om något
name	string	Namnet på datauppsättningen
rowsCopied	integer (int64)	Antalet filer som kopierats till datauppsättningen för mottagare
rowsRead	integer (int64)	Antalet rader som lästs från källdatauppsättningen.
sizeRead	integer (int64)	Storleken på data som lästs från källdatauppsättningen i byte
sizeWritten	integer (int64)	Storleken på data som skrivits till mottagardatauppsättningen i byte
startTime	string (date-time)	Starttid för kopiering på datauppsättningsnivå
status	string	Raw-status
vCore	integer (int64)	De virtuella kärnor som förbrukas för datauppsättningssynkroniseringen

SynchronizationDetailsList

Objekt

information om synkronisering

Name	Typ	Description
nextLink	string	Url:en för nästa resultatsida.
value	SynchronizationDetails[]	Samling objekt av typen DataTransferObjects.

synchronizationMode

Uppräkning

Synkroniseringsläge

Värde	Description
FullSync
Incremental