Sync Groups - Create Or Update

Odwołanie

Usługa:: SQL Database

Wersja interfejsu API:: 2021-11-01

Tworzy lub aktualizuje grupę synchronizacji.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/syncGroups/{syncGroupName}?api-version=2021-11-01

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
databaseName	path	True	string	Nazwa bazy danych, w której jest hostowana grupa synchronizacji.
resourceGroupName	path	True	string	Nazwa grupy zasobów zawierającej zasób. Tę wartość można uzyskać z interfejsu API usługi Azure Resource Manager lub portalu.
serverName	path	True	string	Nazwa serwera.
subscriptionId	path	True	string	Identyfikator subskrypcji identyfikujący subskrypcję platformy Azure.
syncGroupName	path	True	string	Nazwa grupy synchronizacji.
api-version	query	True	string	Wersja interfejsu API do użycia dla żądania.

Treść żądania

Nazwa	Typ	Opis
properties.conflictLoggingRetentionInDays	integer	Okres przechowywania rejestrowania konfliktów.
properties.conflictResolutionPolicy	SyncConflictResolutionPolicy	Zasady rozwiązywania konfliktów grupy synchronizacji.
properties.enableConflictLogging	boolean	Jeśli rejestrowanie konfliktów jest włączone.
properties.hubDatabasePassword	string	Hasło do poświadczeń bazy danych centrum grupy synchronizacji.
properties.hubDatabaseUserName	string	Nazwa użytkownika dla poświadczeń bazy danych centrum grupy synchronizacji.
properties.interval	integer	Interwał synchronizacji grupy synchronizacji.
properties.schema	SyncGroupSchema	Synchronizuj schemat grupy synchronizacji.
properties.syncDatabaseId	string	Identyfikator zasobu usługi ARM bazy danych synchronizacji w grupie synchronizacji.
properties.usePrivateLinkConnection	boolean	W przypadku włączenia połączenia za pomocą łącza prywatnego.
sku	Sku	Nazwa i pojemność jednostki SKU.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	SyncGroup	Pomyślnie zaktualizowano grupę synchronizacji.
201 Created	SyncGroup	Pomyślnie utworzono grupę synchronizacji.
202 Accepted		Trwa tworzenie lub aktualizowanie grupy synchronizacji.
Other Status Codes		Odpowiedzi na błędy: *** 400 InvalidSyncGroupCreateOrUpdateRequest — treść żądania tworzenia lub aktualizowania grupy synchronizacji jest pusta. 400 InvalidSyncMemberCreateOrUpdateRequest — treść żądania utworzenia lub aktualizacji elementu członkowskiego synchronizacji jest pusta. 400 InvalidSyncAgentCreateOrUpdateRequest — treść żądania utworzenia lub aktualizacji agenta synchronizacji jest pusta. 400 InvalidDatabaseResourceId — nieprawidłowy identyfikator zasobu bazy danych. 400 NiezgodnośćSubscriptionWithUrl — podana subskrypcja nie jest zgodna z subskrypcją w adresie URL. 400 InvalidSyncAgentResourceId — nieprawidłowy identyfikator zasobu agenta synchronizacji. 400 MismatchingResourceGroupNameWithUrl — podana nazwa grupy zasobów nie jest zgodna z nazwą w adresie URL. 400 NiezgodnośćServerNameWithUrl — podana nazwa serwera nie jest zgodna z nazwą w adresie URL. 400 InvalidParameterValue — podano nieprawidłową wartość dla parametru. 400 MissingServerName — brak nazwy serwera 400 MissingDatabaseName — brak nazwy bazy danych 400 MissingSyncGroupName — brak nazwy grupy synchronizacji 400 MissingConflictResolutionPolicy — brak zasad rozwiązywania konfliktów 400 MissingSyncAgentName — brak nazwy agenta synchronizacji 400 SyncOperation_GenericFailure — nie można wykonać operacji synchronizacji danych. 400 InvalidSyncGroup — grupa synchronizacji jest nieprawidłowa. 400 FeatureDisabledOnSelectedEdition — użytkownik próbował użyć funkcji wyłączonej w bieżącej wersji bazy danych. 400 CannotCreateSyncGroupDueToQuotaExceeded — nie można utworzyć grupy synchronizacji z powodu przekroczenia limitu przydziału. 400 SyncOperation_DuplicateSyncGroupDrop — grupa synchronizacji jest już odrzucana. 400 SyncOperation_WrongSyncDatabase — określona baza danych synchronizacji jest niezgodna z istniejącą. 400 SyncOperation_UpdateSyncGroupWhenDropping — nie można zaktualizować grupy synchronizacji, ponieważ jest ona obecnie porzucana. 400 SyncOperation_DwInSyncGroup — nie można używać wersji magazynu danych w synchronizacji danych. 400 SyncOperation_MasterDbInSyncGroup — nie można użyć logicznego wzorca w synchronizacji danych. 400 SyncOperation_InvalidCredential — poświadczenia bazy danych są nieprawidłowe. 400 InvalidSyncMetadataDatabase — baza danych metadanych synchronizacji jest nieprawidłowa. 400 SyncOperation_InvalidSyncInterval — nie można utworzyć lub zaktualizować grupy synchronizacji, ponieważ interwał synchronizacji jest nieprawidłowy. 404 ResourceNotFound — żądany zasób nie został znaleziony. 404 SubscriptionDoesNotHaveServer — nie znaleziono żądanego serwera 404 DatabaseDoesNotExist — użytkownik określił nazwę bazy danych, która nie istnieje w tym wystąpieniu serwera. 404 SyncOperation_HubServerNotFound — serwer logiczny koncentratora nie istnieje. 404 SyncOperation_InvalidHubDatabase — baza danych centrum jest nieprawidłowa. 404 OperationIdNotFound — operacja o identyfikatorze nie istnieje. 409 SyncOperation_DuplicateSyncGroupName — nie można utworzyć grupy synchronizacji, ponieważ grupa synchronizacji o tej samej nazwie już istnieje. 409 OperationCancelled — operacja została anulowana przez użytkownika. 409 Operacja przerwana — nie można ukończyć operacji na zasobie, ponieważ została przerwana przez inną operację na tym samym zasobie. 429 SubscriptionTooManyCreateUpdateRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby. 429 SubscriptionTooManyRequests — żądania wykraczające poza maksymalną liczbę żądań, które mogą być przetwarzane przez dostępne zasoby. 500 OperationTimedOut — upłynął limit czasu operacji i automatycznie wycofano. Ponów próbę wykonania operacji. 503 TooManyRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.

Przykłady

Create a sync group

Update a sync group

Create a sync group

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328/syncGroups/syncgroupcrud-3187?api-version=2021-11-01

{
  "properties": {
    "interval": -1,
    "conflictResolutionPolicy": "HubWin",
    "syncDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328",
    "hubDatabaseUserName": "hubUser",
    "usePrivateLinkConnection": true
  }
}


import com.azure.resourcemanager.sql.fluent.models.SyncGroupInner;
import com.azure.resourcemanager.sql.models.SyncConflictResolutionPolicy;

/**
 * Samples for SyncGroups CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/SyncGroupCreate.json
     */
    /**
     * Sample code: Create a sync group.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createASyncGroup(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getSyncGroups().createOrUpdate("syncgroupcrud-65440",
            "syncgroupcrud-8475", "syncgroupcrud-4328", "syncgroupcrud-3187",
            new SyncGroupInner().withInterval(-1).withConflictResolutionPolicy(SyncConflictResolutionPolicy.HUB_WIN)
                .withSyncDatabaseId(
                    "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328")
                .withHubDatabaseUsername("hubUser").withUsePrivateLinkConnection(true),
            com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Przykładowa odpowiedź

Kod stanu:: 200

{
  "properties": {
    "interval": -1,
    "lastSyncTime": "0001-01-01T08:00:00Z",
    "conflictResolutionPolicy": "HubWin",
    "syncDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328",
    "hubDatabaseUserName": "hubUser",
    "syncState": "NotReady",
    "usePrivateLinkConnection": true,
    "privateEndpointName": "PE_67FDBBD6-B2D8-4014-9CC6-C68ABBCFD481_syncgroupcrud-8475"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328/syncGroups/syncgroupcrud-3187",
  "name": "syncgroupcrud-3187",
  "type": "Microsoft.Sql/servers/databases/syncGroups"
}

Kod stanu:: 201

{
  "properties": {
    "interval": -1,
    "lastSyncTime": "0001-01-01T08:00:00Z",
    "conflictResolutionPolicy": "HubWin",
    "syncDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328",
    "hubDatabaseUserName": "hubUser",
    "syncState": "NotReady",
    "usePrivateLinkConnection": true,
    "privateEndpointName": "PE_67FDBBD6-B2D8-4014-9CC6-C68ABBCFD481_syncgroupcrud-8475"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328/syncGroups/syncgroupcrud-3187",
  "name": "syncgroupcrud-3187",
  "type": "Microsoft.Sql/servers/databases/syncGroups"
}

Kod stanu:: 202

Update a sync group

Przykładowe żądanie

HTTP
Java

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328/syncGroups/syncgroupcrud-3187?api-version=2021-11-01

{
  "properties": {
    "interval": -1,
    "conflictResolutionPolicy": "HubWin",
    "syncDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328",
    "hubDatabaseUserName": "hubUser",
    "usePrivateLinkConnection": true
  }
}


import com.azure.resourcemanager.sql.fluent.models.SyncGroupInner;
import com.azure.resourcemanager.sql.models.SyncConflictResolutionPolicy;

/**
 * Samples for SyncGroups CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/SyncGroupUpdate.json
     */
    /**
     * Sample code: Update a sync group.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updateASyncGroup(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getSyncGroups().createOrUpdate("syncgroupcrud-65440",
            "syncgroupcrud-8475", "syncgroupcrud-4328", "syncgroupcrud-3187",
            new SyncGroupInner().withInterval(-1).withConflictResolutionPolicy(SyncConflictResolutionPolicy.HUB_WIN)
                .withSyncDatabaseId(
                    "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328")
                .withHubDatabaseUsername("hubUser").withUsePrivateLinkConnection(true),
            com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Przykładowa odpowiedź

Kod stanu:: 200

{
  "properties": {
    "interval": -1,
    "lastSyncTime": "0001-01-01T08:00:00Z",
    "conflictResolutionPolicy": "HubWin",
    "syncDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328",
    "hubDatabaseUserName": "hubUser",
    "syncState": "NotReady",
    "usePrivateLinkConnection": true,
    "privateEndpointName": "PE_67FDBBD6-B2D8-4014-9CC6-C68ABBCFD481_syncgroupcrud-3187"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328/syncGroups/syncgroupcrud-3187",
  "name": "syncgroupcrud-3187",
  "type": "Microsoft.Sql/servers/databases/syncGroups"
}

Kod stanu:: 201

{
  "properties": {
    "interval": -1,
    "lastSyncTime": "0001-01-01T08:00:00Z",
    "conflictResolutionPolicy": "HubWin",
    "syncDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328",
    "hubDatabaseUserName": "hubUser",
    "syncState": "NotReady",
    "usePrivateLinkConnection": true,
    "privateEndpointName": "PE_67FDBBD6-B2D8-4014-9CC6-C68ABBCFD481_syncgroupcrud-3187"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328/syncGroups/syncgroupcrud-3187",
  "name": "syncgroupcrud-3187",
  "type": "Microsoft.Sql/servers/databases/syncGroups"
}

Kod stanu:: 202

Definicje

Nazwa	Opis
Sku	Jednostka SKU zasobu usługi ARM.
SyncConflictResolutionPolicy	Zasady rozwiązywania konfliktów grupy synchronizacji.
SyncGroup	Grupa synchronizacji usługi Azure SQL Database.
SyncGroupSchema	Właściwości schematu grupy synchronizacji.
SyncGroupSchemaTable	Właściwości tabeli w schemacie grupy synchronizacji.
SyncGroupSchemaTableColumn	Właściwości kolumny w tabeli grup synchronizacji.
SyncGroupState	Stan synchronizacji grupy synchronizacji.

Sku

Jednostka SKU zasobu usługi ARM.

Nazwa	Typ	Opis
capacity	integer	Pojemność konkretnej jednostki SKU.
family	string	Jeśli usługa ma różne generacje sprzętu, dla tej samej jednostki SKU, można je przechwycić tutaj.
name	string	Nazwa jednostki SKU, zazwyczaj, litera + kod numeryczny, np. P3.
size	string	Rozmiar konkretnej jednostki SKU
tier	string	Warstwa lub wersja konkretnej jednostki SKU, np. Podstawowa, Premium.

SyncConflictResolutionPolicy

Zasady rozwiązywania konfliktów grupy synchronizacji.

Nazwa	Typ	Opis
HubWin	string
MemberWin	string

SyncGroup

Grupa synchronizacji usługi Azure SQL Database.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu.
name	string	Nazwa zasobu.
properties.conflictLoggingRetentionInDays	integer	Okres przechowywania rejestrowania konfliktów.
properties.conflictResolutionPolicy	SyncConflictResolutionPolicy	Zasady rozwiązywania konfliktów grupy synchronizacji.
properties.enableConflictLogging	boolean	Jeśli rejestrowanie konfliktów jest włączone.
properties.hubDatabasePassword	string	Hasło do poświadczeń bazy danych centrum grupy synchronizacji.
properties.hubDatabaseUserName	string	Nazwa użytkownika dla poświadczeń bazy danych centrum grupy synchronizacji.
properties.interval	integer	Interwał synchronizacji grupy synchronizacji.
properties.lastSyncTime	string	Czas ostatniej synchronizacji grupy synchronizacji.
properties.privateEndpointName	string	Nazwa prywatnego punktu końcowego grupy synchronizacji, jeśli jest włączone połączenie usługi Private Link.
properties.schema	SyncGroupSchema	Synchronizuj schemat grupy synchronizacji.
properties.syncDatabaseId	string	Identyfikator zasobu usługi ARM bazy danych synchronizacji w grupie synchronizacji.
properties.syncState	SyncGroupState	Stan synchronizacji grupy synchronizacji.
properties.usePrivateLinkConnection	boolean	W przypadku włączenia połączenia za pomocą łącza prywatnego.
sku	Sku	Nazwa i pojemność jednostki SKU.
type	string	Typ zasobu.

SyncGroupSchema

Właściwości schematu grupy synchronizacji.

Nazwa	Typ	Opis
masterSyncMemberName	string	Nazwa elementu członkowskiego synchronizacji wzorca, z którego pochodzi schemat.
tables	SyncGroupSchemaTable[]	Lista tabel w schemacie grupy synchronizacji.

SyncGroupSchemaTable

Właściwości tabeli w schemacie grupy synchronizacji.

Nazwa	Typ	Opis
columns	SyncGroupSchemaTableColumn[]	Lista kolumn w schemacie grupy synchronizacji.
quotedName	string	Nazwa tabeli schematu grupy synchronizacji.

SyncGroupSchemaTableColumn

Właściwości kolumny w tabeli grup synchronizacji.

Nazwa	Typ	Opis
dataSize	string	Rozmiar danych kolumny.
dataType	string	Typ danych kolumny.
quotedName	string	Cytowana nazwa kolumny tabeli grupy synchronizacji.

SyncGroupState

Stan synchronizacji grupy synchronizacji.

Nazwa	Typ	Opis
Error	string
Good	string
NotReady	string
Progressing	string
Warning	string

Udostępnij za pośrednictwem

Sync Groups - Create Or Update

Parametry identyfikatora URI

Treść żądania

Odpowiedzi

Przykłady

Create a sync group

Przykładowe żądanie

Przykładowa odpowiedź

Update a sync group

Przykładowe żądanie

Przykładowa odpowiedź

Definicje

Sku

SyncConflictResolutionPolicy

SyncGroup

SyncGroupSchema

SyncGroupSchemaTable

SyncGroupSchemaTableColumn

SyncGroupState

Dodatkowe zasoby