Sync Members - Create Or Update

Usługa:

SQL Database

Wersja interfejsu API:

2021-11-01

Tworzy lub aktualizuje element członkowski synchronizacji.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/syncGroups/{syncGroupName}/syncMembers/{syncMemberName}?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, w której jest hostowany element członkowski synchronizacji.
syncMemberName	path	True	string	Nazwa elementu członkowskiego synchronizacji.
api-version	query	True	string	Wersja interfejsu API do użycia dla żądania.

Treść żądania

Nazwa	Typ	Opis
properties.databaseName	string	Nazwa bazy danych składowej w składowej synchronizacji.
properties.databaseType	SyncMemberDbType	Typ bazy danych elementu członkowskiego synchronizacji.
properties.password	string	Hasło bazy danych składowej w elemencie członkowskim synchronizacji.
properties.serverName	string	Nazwa serwera bazy danych składowej w elemencie członkowskim synchronizacji
properties.sqlServerDatabaseId	string	SQL Server identyfikator bazy danych elementu członkowskiego synchronizacji.
properties.syncAgentId	string	Identyfikator zasobu usługi ARM agenta synchronizacji w elemencie członkowskim synchronizacji.
properties.syncDirection	SyncDirection	Kierunek synchronizacji elementu członkowskiego synchronizacji.
properties.syncMemberAzureDatabaseResourceId	string	Identyfikator zasobu usługi ARM logicznej bazy danych składowej synchronizacji dla członków synchronizacji na platformie Azure.
properties.usePrivateLinkConnection	boolean	Czy używać połączenia łącza prywatnego.
properties.userName	string	Nazwa użytkownika bazy danych składowej w elemencie członkowskim synchronizacji.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	SyncMember	Pomyślnie zaktualizowano element członkowski synchronizacji.
201 Created	SyncMember	Pomyślnie utworzono element członkowski synchronizacji.
202 Accepted		Trwa tworzenie lub aktualizowanie elementu członkowskiego 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 InvalidSyncMember — element członkowski synchronizacji jest nieprawidłowy. 400 InvalidSyncAgent — agent synchronizacji jest nieprawidłowy. 400 CannotCreateSyncMemberDueToQuotaExceeded — nie można utworzyć elementu członkowskiego synchronizacji z powodu przekroczenia limitu przydziału. 400 SyncOperation_DuplicateSyncMemberDrop — element członkowski synchronizacji jest już porzucony. 400 SyncOperation_WrongSyncDatabase — określona baza danych synchronizacji jest niezgodna z istniejącą. 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. 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_DuplicateSyncMemberName — nie można utworzyć elementu członkowskiego synchronizacji, ponieważ element członkowski 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 new sync member

Update a sync member

Create a new sync member

Przykładowe żądanie

HTTP

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/syncMembers/syncmembercrud-4879?api-version=2021-11-01

{
  "properties": {
    "databaseType": "AzureSqlDatabase",
    "serverName": "syncgroupcrud-3379.database.windows.net",
    "databaseName": "syncgroupcrud-7421",
    "userName": "myUser",
    "syncDirection": "Bidirectional",
    "usePrivateLinkConnection": true,
    "syncMemberAzureDatabaseResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328"
  }
}

Java

import com.azure.resourcemanager.sql.fluent.models.SyncMemberInner;
import com.azure.resourcemanager.sql.models.SyncDirection;
import com.azure.resourcemanager.sql.models.SyncMemberDbType;

/**
 * Samples for SyncMembers CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/SyncMemberCreate.json
     */
    /**
     * Sample code: Create a new sync member.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createANewSyncMember(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getSyncMembers().createOrUpdate("syncgroupcrud-65440",
            "syncgroupcrud-8475", "syncgroupcrud-4328", "syncgroupcrud-3187", "syncmembercrud-4879",
            new SyncMemberInner().withDatabaseType(SyncMemberDbType.AZURE_SQL_DATABASE)
                .withSyncMemberAzureDatabaseResourceId(
                    "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328")
                .withUsePrivateLinkConnection(true).withServerName("syncgroupcrud-3379.database.windows.net")
                .withDatabaseName("syncgroupcrud-7421").withUsername("myUser")
                .withSyncDirection(SyncDirection.BIDIRECTIONAL),
            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": {
    "databaseType": "AzureSqlDatabase",
    "serverName": "syncgroupcrud-3379.database.windows.net",
    "databaseName": "syncgroupcrud-7421",
    "userName": "myUser",
    "syncDirection": "Bidirectional",
    "syncState": "UnProvisioned",
    "usePrivateLinkConnection": true,
    "privateEndpointName": "PE_67FDBBD6-B2D8-4014-9CC6-C68ABBCFD481_syncmembercrud-4879",
    "syncMemberAzureDatabaseResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328/syncGroups/syncgroupcrud-3187/syncMembers/syncmembercrud-4879",
  "name": "syncmembercrud-4879",
  "type": "Microsoft.Sql/servers/databases/syncGroups/syncMembers"
}

Kod stanu:

201

{
  "properties": {
    "databaseType": "AzureSqlDatabase",
    "serverName": "syncgroupcrud-3379.database.windows.net",
    "databaseName": "syncgroupcrud-7421",
    "userName": "myUser",
    "syncDirection": "Bidirectional",
    "syncState": "UnProvisioned",
    "usePrivateLinkConnection": true,
    "privateEndpointName": "PE_67FDBBD6-B2D8-4014-9CC6-C68ABBCFD481_syncmembercrud-4879",
    "syncMemberAzureDatabaseResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328/syncGroups/syncgroupcrud-3187/syncMembers/syncmembercrud-4879",
  "name": "syncmembercrud-4879",
  "type": "Microsoft.Sql/servers/databases/syncGroups/syncMembers"
}

Kod stanu:

202

Update a sync member

Przykładowe żądanie

HTTP

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/syncMembers/syncmembercrud-4879?api-version=2021-11-01

{
  "properties": {
    "databaseType": "AzureSqlDatabase",
    "serverName": "syncgroupcrud-3379.database.windows.net",
    "databaseName": "syncgroupcrud-7421",
    "userName": "myUser",
    "syncDirection": "Bidirectional",
    "usePrivateLinkConnection": true,
    "syncMemberAzureDatabaseResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328"
  }
}

Java

import com.azure.resourcemanager.sql.fluent.models.SyncMemberInner;
import com.azure.resourcemanager.sql.models.SyncDirection;
import com.azure.resourcemanager.sql.models.SyncMemberDbType;

/**
 * Samples for SyncMembers CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/SyncMemberUpdate.json
     */
    /**
     * Sample code: Update a sync member.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updateASyncMember(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getSyncMembers().createOrUpdate("syncgroupcrud-65440",
            "syncgroupcrud-8475", "syncgroupcrud-4328", "syncgroupcrud-3187", "syncmembercrud-4879",
            new SyncMemberInner().withDatabaseType(SyncMemberDbType.AZURE_SQL_DATABASE)
                .withSyncMemberAzureDatabaseResourceId(
                    "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328")
                .withUsePrivateLinkConnection(true).withServerName("syncgroupcrud-3379.database.windows.net")
                .withDatabaseName("syncgroupcrud-7421").withUsername("myUser")
                .withSyncDirection(SyncDirection.BIDIRECTIONAL),
            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": {
    "databaseType": "AzureSqlDatabase",
    "serverName": "syncgroupcrud-3379.database.windows.net",
    "databaseName": "syncgroupcrud-7421",
    "userName": "myUser",
    "syncDirection": "Bidirectional",
    "syncState": "UnProvisioned",
    "usePrivateLinkConnection": true,
    "privateEndpointName": "PE_67FDBBD6-B2D8-4014-9CC6-C68ABBCFD481_syncmembercrud-4879",
    "syncMemberAzureDatabaseResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328/syncGroups/syncgroupcrud-3187/syncMembers/syncmembercrud-4879",
  "name": "syncmembercrud-4879",
  "type": "Microsoft.Sql/servers/databases/syncGroups/syncMembers"
}

Kod stanu:

201

{
  "properties": {
    "databaseType": "AzureSqlDatabase",
    "serverName": "syncgroupcrud-3379.database.windows.net",
    "databaseName": "syncgroupcrud-7421",
    "userName": "myUser",
    "syncDirection": "Bidirectional",
    "syncState": "UnProvisioned",
    "usePrivateLinkConnection": true,
    "privateEndpointName": "PE_67FDBBD6-B2D8-4014-9CC6-C68ABBCFD481_syncmembercrud-4879",
    "syncMemberAzureDatabaseResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328/syncGroups/syncgroupcrud-3187/syncMembers/syncmembercrud-4879",
  "name": "syncmembercrud-4879",
  "type": "Microsoft.Sql/servers/databases/syncGroups/syncMembers"
}

Kod stanu:

202

Definicje

Nazwa	Opis
SyncDirection	Kierunek synchronizacji elementu członkowskiego synchronizacji.
SyncMember	Element członkowski synchronizacji usługi Azure SQL Database.
SyncMemberDbType	Typ bazy danych elementu członkowskiego synchronizacji.
SyncMemberState	Stan synchronizacji elementu członkowskiego synchronizacji.

SyncDirection

Kierunek synchronizacji elementu członkowskiego synchronizacji.

Nazwa	Typ	Opis
Bidirectional	string
OneWayHubToMember	string
OneWayMemberToHub	string

SyncMember

Element członkowski synchronizacji usługi Azure SQL Database.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu.
name	string	Nazwa zasobu.
properties.databaseName	string	Nazwa bazy danych składowej w składowej synchronizacji.
properties.databaseType	SyncMemberDbType	Typ bazy danych elementu członkowskiego synchronizacji.
properties.password	string	Hasło bazy danych składowej w elemencie członkowskim synchronizacji.
properties.privateEndpointName	string	Nazwa prywatnego punktu końcowego elementu członkowskiego synchronizacji, jeśli jest włączone połączenie usługi Private Link, dla członków synchronizacji na platformie Azure.
properties.serverName	string	Nazwa serwera bazy danych składowej w elemencie członkowskim synchronizacji
properties.sqlServerDatabaseId	string	SQL Server identyfikator bazy danych elementu członkowskiego synchronizacji.
properties.syncAgentId	string	Identyfikator zasobu usługi ARM agenta synchronizacji w elemencie członkowskim synchronizacji.
properties.syncDirection	SyncDirection	Kierunek synchronizacji elementu członkowskiego synchronizacji.
properties.syncMemberAzureDatabaseResourceId	string	Identyfikator zasobu usługi ARM logicznej bazy danych składowej synchronizacji dla członków synchronizacji na platformie Azure.
properties.syncState	SyncMemberState	Stan synchronizacji elementu członkowskiego synchronizacji.
properties.usePrivateLinkConnection	boolean	Czy używać połączenia łącza prywatnego.
properties.userName	string	Nazwa użytkownika bazy danych składowej w elemencie członkowskim synchronizacji.
type	string	Typ zasobu.

SyncMemberDbType

Typ bazy danych elementu członkowskiego synchronizacji.

Nazwa	Typ	Opis
AzureSqlDatabase	string
SqlServerDatabase	string

SyncMemberState

Stan synchronizacji elementu członkowskiego synchronizacji.

Nazwa	Typ	Opis
DeProvisionFailed	string
DeProvisioned	string
DeProvisioning	string
DisabledBackupRestore	string
DisabledTombstoneCleanup	string
ProvisionFailed	string
Provisioned	string
Provisioning	string
ReprovisionFailed	string
Reprovisioning	string
SyncCancelled	string
SyncCancelling	string
SyncFailed	string
SyncInProgress	string
SyncSucceeded	string
SyncSucceededWithWarnings	string
UnProvisioned	string
UnReprovisioned	string