Sync Members - Create Or Update

Referens

Tjänst:: SQL Database

API-version:: 2021-11-01

Skapar eller uppdaterar en synkroniseringsmedlem.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
databaseName	path	True	string	Namnet på databasen där synkroniseringsgruppen finns.
resourceGroupName	path	True	string	Namnet på resursgruppen som innehåller resursen. Du kan hämta det här värdet från Azure Resource Manager-API:et eller portalen.
serverName	path	True	string	Namnet på servern.
subscriptionId	path	True	string	Det prenumerations-ID som identifierar en Azure-prenumeration.
syncGroupName	path	True	string	Namnet på synkroniseringsgruppen där synkroniseringsmedlemmen finns.
syncMemberName	path	True	string	Namnet på synkroniseringsmedlemmen.
api-version	query	True	string	DEN API-version som ska användas för begäran.

Begärandetext

Name	Typ	Description
properties.databaseName	string	Databasnamnet på medlemsdatabasen i synkroniseringsmedlemmen.
properties.databaseType	SyncMemberDbType	Synkroniseringsmedlemmens databastyp.
properties.password	string	Lösenord för medlemsdatabasen i synkroniseringsmedlemmen.
properties.serverName	string	Servernamnet på medlemsdatabasen i synkroniseringsmedlemmen
properties.sqlServerDatabaseId	string	SQL Server databas-ID för synkroniseringsmedlemmen.
properties.syncAgentId	string	ARM-resurs-ID för synkroniseringsagenten i synkroniseringsmedlemmen.
properties.syncDirection	SyncDirection	Synkroniseringsmedlemmens synkroniseringsriktning.
properties.syncMemberAzureDatabaseResourceId	string	ARM-resurs-ID för den logiska synkroniseringsmedlemsdatabasen för synkroniseringsmedlemmar i Azure.
properties.usePrivateLinkConnection	boolean	Om du vill använda private link-anslutning.
properties.userName	string	Användarnamnet för medlemsdatabasen i synkroniseringsmedlemmen.

Svar

Name	Typ	Description
200 OK	SyncMember	Synkroniseringsmedlemmen har uppdaterats.
201 Created	SyncMember	Synkroniseringsmedlemmen har skapats.
202 Accepted		Det pågår en skapande eller uppdatering av synkroniseringsmedlemmen.
Other Status Codes		Felsvar: *** 400 InvalidSyncGroupCreateOrUpdateRequest – Begärandetexten för att skapa eller uppdatera synkroniseringsgruppen är tom. 400 InvalidSyncMemberCreateOrUpdateRequest – Begärandetexten för att skapa eller uppdatera synkroniseringsmedlemmen är tom. 400 InvalidSyncAgentCreateOrUpdateRequest – Begärandetexten för att skapa eller uppdatera synkroniseringsagenten är tom. 400 InvalidDatabaseResourceId – Ogiltig databasresursidentifierare. 400 MismatchingSubscriptionWithUrl – den angivna prenumerationen matchade inte prenumerationen i URL:en. 400 InvalidSyncAgentResourceId – Ogiltig synkroniseringsagentens resursidentifierare. 400 MismatchingResourceGroupNameWithUrl – Det angivna resursgruppsnamnet matchade inte namnet i URL:en. 400 MismatchingServerNameWithUrl – det angivna servernamnet matchade inte namnet i URL:en. 400 InvalidParameterValue – ett ogiltigt värde angavs för en parameter. 400 MissingServerName – Servernamnet saknas 400 MissingDatabaseName – Databasnamnet saknas 400 MissingSyncGroupName – Synkroniseringsgruppens namn saknas 400 MissingConflictResolutionPolicy – Konfliktlösningsprincipen saknas 400 MissingSyncAgentName – Synkroniseringsagentens namn saknas 400 SyncOperation_GenericFailure – Det gick inte att utföra datasynkroniseringsåtgärden. 400 InvalidSyncGroup – synkroniseringsgruppen är ogiltig. 400 InvalidSyncMember – Sync-medlemmen är ogiltig. 400 InvalidSyncAgent – Synkroniseringsagenten är ogiltig. 400 CannotCreateSyncMemberDueToQuotaExceeded – Det går inte att skapa synkroniseringsmedlem på grund av att kvoten har överskridits. 400 SyncOperation_DuplicateSyncMemberDrop – Synkroniseringsmedlemmen tas redan bort. 400 SyncOperation_WrongSyncDatabase – Den angivna synkroniseringsdatabasen matchar inte den befintliga. 400 SyncOperation_DwInSyncGroup – Det går inte att använda datawarehouse edition i datasynkronisering. 400 SyncOperation_MasterDbInSyncGroup – Det går inte att använda logisk huvudserver i datasynkronisering. 400 SyncOperation_InvalidCredential – Databasens autentiseringsuppgifter är ogiltiga. 400 InvalidSyncMetadataDatabase – Databasen för synkroniseringsmetadata är ogiltig. 404 ResourceNotFound – Den begärda resursen hittades inte. 404 SubscriptionDoesNotHaveServer – Den begärda servern hittades inte 404 DatabaseDoesNotExist – Användaren har angett ett databasnamn som inte finns på den här serverinstansen. 404 SyncOperation_HubServerNotFound – Den logiska hubbservern finns inte. 404 SyncOperation_InvalidHubDatabase – Hubbdatabasen är ogiltig. 404 OperationIdNotFound – åtgärden med ID finns inte. 409 SyncOperation_DuplicateSyncMemberName – Det går inte att skapa en synkroniseringsmedlem eftersom synkroniseringsmedlemmen med samma namn redan finns. 409 OperationCancelled – Åtgärden har avbrutits av användaren. 409 OperationInterrupted – Det gick inte att slutföra åtgärden på resursen eftersom den avbröts av en annan åtgärd på samma resurs. 429 SubscriptionTooManyCreateUpdateRequests – begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser. 429 SubscriptionTooManyRequests – begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser. 500 OperationTimedOut – Tidsgränsen för åtgärden uppnåddes och återställdes automatiskt. Försök att utföra åtgärden igen. 503 TooManyRequests – begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser.

Exempel

Create a new sync member

Update a sync member

Create a new sync member

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


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

Exempelsvar

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

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

Statuskod:: 202

Update a sync member

Exempelbegäran

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


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

Exempelsvar

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

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

Statuskod:: 202

Definitioner

Name	Description
SyncDirection	Synkroniseringsmedlemmens synkroniseringsriktning.
SyncMember	En Azure SQL-databassynkroniseringsmedlem.
SyncMemberDbType	Synkroniseringsmedlemmens databastyp.
SyncMemberState	Synkroniseringsmedlemmens synkroniseringstillstånd.

SyncDirection

Synkroniseringsmedlemmens synkroniseringsriktning.

Name	Typ	Description
Bidirectional	string
OneWayHubToMember	string
OneWayMemberToHub	string

SyncMember

En Azure SQL-databassynkroniseringsmedlem.

Name	Typ	Description
id	string	Resurs-ID.
name	string	Resursnamn.
properties.databaseName	string	Databasnamnet på medlemsdatabasen i synkroniseringsmedlemmen.
properties.databaseType	SyncMemberDbType	Synkroniseringsmedlemmens databastyp.
properties.password	string	Lösenord för medlemsdatabasen i synkroniseringsmedlemmen.
properties.privateEndpointName	string	Synkroniseringsmedlemmens privata slutpunktsnamn om användning av private link-anslutning är aktiverat för synkroniseringsmedlemmar i Azure.
properties.serverName	string	Servernamnet på medlemsdatabasen i synkroniseringsmedlemmen
properties.sqlServerDatabaseId	string	SQL Server databas-ID för synkroniseringsmedlemmen.
properties.syncAgentId	string	ARM-resurs-ID för synkroniseringsagenten i synkroniseringsmedlemmen.
properties.syncDirection	SyncDirection	Synkroniseringsmedlemmens synkroniseringsriktning.
properties.syncMemberAzureDatabaseResourceId	string	ARM-resurs-ID för den logiska synkroniseringsmedlemsdatabasen för synkroniseringsmedlemmar i Azure.
properties.syncState	SyncMemberState	Synkroniseringsmedlemmens synkroniseringstillstånd.
properties.usePrivateLinkConnection	boolean	Om du vill använda private link-anslutning.
properties.userName	string	Användarnamnet för medlemsdatabasen i synkroniseringsmedlemmen.
type	string	Resurstyp.

SyncMemberDbType

Synkroniseringsmedlemmens databastyp.

Name	Typ	Description
AzureSqlDatabase	string
SqlServerDatabase	string

SyncMemberState

Synkroniseringsmedlemmens synkroniseringstillstånd.

Name	Typ	Description
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

Dela via

Sync Members - Create Or Update

URI-parametrar

Begärandetext

Svar

Exempel

Create a new sync member

Exempelbegäran

Exempelsvar

Update a sync member

Exempelbegäran

Exempelsvar

Definitioner

SyncDirection

SyncMember

SyncMemberDbType

SyncMemberState

Ytterligare resurser