Shares - List Synchronizations

Ссылка

Service:: Data Share

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

With optional parameters:

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

Имя	В	Обязательно	Тип	Описание
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	Метка продолжения

Ответы

Имя	Тип	Описание
200 OK	ShareSynchronizationList	Успешное завершение
Other Status Codes	DataShareError	От поставщика ресурсов Microsoft.DataShare получен ответ об ошибке.

Безопасность

azure_auth

Поток OAuth2 в Azure Active Directory.

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

Scopes

Имя	Описание
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

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",
      "message": "nda",
      "consumerTenantName": "nda",
      "consumerName": "abc@yahoo.com",
      "synchronizationId": "runId",
      "synchronizationMode": "Incremental"
    }
  ]
}

Определения

Имя	Описание
DataShareError	Модель ошибок общего ресурса данных.
DataShareErrorInfo	Модель тела ошибки общего ресурса данных.
ShareSynchronization	Объект передачи данных ShareSynchronization.
ShareSynchronizationList	Вывод списка ответов для получения ShareSynchronization.
synchronizationMode	Режим синхронизации

DataShareError

Модель ошибок общего ресурса данных.

Имя	Тип	Описание
error	DataShareErrorInfo	Текст ошибки общего ресурса данных

DataShareErrorInfo

Модель тела ошибки общего ресурса данных.

Имя	Тип	Описание
code	string	Код ошибки
details	DataShareErrorInfo[]	Вложенные сведения о модели ошибок
message	string	Сообщение об ошибке
target	string	Целевой объект ошибки

ShareSynchronization

Объект передачи данных ShareSynchronization.

Имя	Тип	Описание
consumerEmail	string	Email пользователя, создавшего синхронизацию
consumerName	string	Имя пользователя, создавшего синхронизацию
consumerTenantName	string	Имя клиента потребителя, создавшего синхронизацию
durationMs	integer	Длительность синхронизации
endTime	string	Время окончания синхронизации
message	string	сообщение о синхронизации
startTime	string	время начала синхронизации
status	string	Необработанное состояние
synchronizationId	string	Идентификатор синхронизации
synchronizationMode	synchronizationMode	Режим синхронизации

ShareSynchronizationList

Вывод списка ответов для получения ShareSynchronization.

Имя	Тип	Описание
nextLink	string	URL-адрес следующей страницы результатов.
value	ShareSynchronization[]	Коллекция элементов типа DataTransferObjects.

synchronizationMode

Режим синхронизации

Имя	Тип	Описание
FullSync	string
Incremental	string