Sync Members - Create Or Update

Referencia

Szolgáltatás:: SQL Database

API-verzió:: 2021-11-01

Szinkronizálási tagot hoz létre vagy frissít.

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-paraméterek

Name	In	Kötelező	Típus	Description
databaseName	path	True	string	Annak az adatbázisnak a neve, amelyen a szinkronizálási csoport üzemel.
resourceGroupName	path	True	string	Az erőforrást tartalmazó erőforráscsoport neve. Ezt az értéket az Azure Resource Manager API-ból vagy a portálról szerezheti be.
serverName	path	True	string	A kiszolgáló neve.
subscriptionId	path	True	string	Az Azure-előfizetést azonosító előfizetés-azonosító.
syncGroupName	path	True	string	Annak a szinkronizálási csoportnak a neve, amelyen a szinkronizálási tag üzemel.
syncMemberName	path	True	string	A szinkronizálási tag neve.
api-version	query	True	string	A kéréshez használni kívánt API-verzió.

Kérelem törzse

Name	Típus	Description
properties.databaseName	string	A tagadatbázis adatbázisneve a szinkronizálási tagban.
properties.databaseType	SyncMemberDbType	A szinkronizálási tag adatbázistípusa.
properties.password	string	A tagadatbázis jelszava a szinkronizálási tagban.
properties.serverName	string	A tagadatbázis kiszolgálóneve a szinkronizálási tagban
properties.sqlServerDatabaseId	string	SQL Server szinkronizálási tag adatbázis-azonosítója.
properties.syncAgentId	string	A szinkronizálási ügynök ARM-erőforrás-azonosítója a szinkronizálási tagban.
properties.syncDirection	SyncDirection	A szinkronizálási tag szinkronizálási iránya.
properties.syncMemberAzureDatabaseResourceId	string	A szinkronizálási tag logikai adatbázisÁNAK ARM-erőforrás-azonosítója az Azure-beli szinkronizálási tagokhoz.
properties.usePrivateLinkConnection	boolean	Privát kapcsolati kapcsolat használata.
properties.userName	string	A tagadatbázis felhasználóneve a szinkronizálási tagban.

Válaszok

Name	Típus	Description
200 OK	SyncMember	A szinkronizálási tag frissítése sikerült.
201 Created	SyncMember	A szinkronizálási tag létrehozása sikerült.
202 Accepted		A szinkronizálási tag létrehozása vagy frissítése folyamatban van.
Other Status Codes		Hibaválaszok: *** 400 InvalidSyncGroupCreateOrUpdateRequest – A szinkronizálási csoport létrehozásának vagy frissítésének kérelemtörzse üres. 400 InvalidSyncMemberCreateOrUpdateRequest – A szinkronizálási tag kérésének létrehozása vagy frissítése törzse üres. 400 InvalidSyncAgentCreateOrUpdateRequest – A szinkronizálási ügynök létrehozásának vagy frissítésének kérelemtörzse üres. 400 InvalidDatabaseResourceId – Érvénytelen adatbázis-erőforrás-azonosító. 400 MismatchingSubscriptionWithUrl – A megadott előfizetés nem egyezett meg az URL-címben szereplő előfizetéssel. 400 InvalidSyncAgentResourceId – Érvénytelen szinkronizálási ügynök erőforrás-azonosítója. 400 MismatchingResourceGroupNameWithUrl – A megadott erőforráscsoport neve nem egyezett meg az URL-címben megadott névvel. 400 MismatchingServerNameWithUrl – A megadott kiszolgálónév nem egyezett meg az URL-címben megadott névvel. 400 InvalidParameterValue – Érvénytelen értéket adott meg egy paraméternek. 400 MissingServerName – A kiszolgáló neve hiányzik 400 MissingDatabaseName – Az adatbázis neve hiányzik 400 MissingSyncGroupName – A szinkronizálási csoport neve hiányzik 400 MissingConflictResolutionPolicy – Az ütközésfeloldási szabályzat hiányzik 400 MissingSyncAgentName – A szinkronizálási ügynök neve hiányzik 400 SyncOperation_GenericFailure – Nem sikerült végrehajtani az adatszinkronizálási műveletet. 400 InvalidSyncGroup – A szinkronizálási csoport érvénytelen. 400 InvalidSyncMember – A szinkronizálási tag érvénytelen. 400 InvalidSyncAgent – A szinkronizálási ügynök érvénytelen. 400 Nem hozható létreSyncMemberDueToQuotaExceededed – A kvóta túllépése miatt nem hozható létre szinkronizálási tag. 400 SyncOperation_DuplicateSyncMemberDrop – A szinkronizálási tag már el lett dobva. 400 SyncOperation_WrongSyncDatabase – A megadott szinkronizálási adatbázis nem egyezik a meglévő adatbázissal. 400 SyncOperation_DwInSyncGroup – A datawarehouse kiadás nem használható az adatszinkronizálásban. 400 SyncOperation_MasterDbInSyncGroup – Nem használható logikai főkiszolgáló az adatszinkronizálásban. 400 SyncOperation_InvalidCredential – Az adatbázis hitelesítő adatai érvénytelenek. 400 InvalidSyncMetadataDatabase – A metaadat-adatbázis szinkronizálása érvénytelen. 404 ResourceNotFound – A kért erőforrás nem található. 404 SubscriptionDoesNotHaveServer – A kért kiszolgáló nem található 404 DatabaseDoesNotExist – A felhasználó olyan adatbázisnevet adott meg, amely nem létezik ezen a kiszolgálópéldányon. 404 SyncOperation_HubServerNotFound – A központi logikai kiszolgáló nem létezik. 404 SyncOperation_InvalidHubDatabase – A központi adatbázis érvénytelen. 404 OperationIdNotFound – Az azonosítóval rendelkező művelet nem létezik. 409 SyncOperation_DuplicateSyncMemberName – Nem hozható létre szinkronizálási tag, mert az azonos nevű szinkronizálási tag már létezik. 409 OperationCancelled – A felhasználó megszakította a műveletet. 409 OperationInterrupted – Az erőforráson végzett művelet nem hajtható végre, mert ugyanazon az erőforráson egy másik művelet megszakította. 429 SubscriptionTooManyCreateUpdateRequests – Az elérhető erőforrások által feldolgozható maximális kérelmeken túli kérések. 429 SubscriptionTooManyRequests – Az elérhető erőforrások által feldolgozható maximális kérelmeken túli kérések. 500 OperationTimedOut – A művelet túllépte az időkorlátot, és automatikusan visszagördült. Please retry the operation. 503 TooManyRequests – Az elérhető erőforrások által feldolgozható maximális kérelmeken túli kérések.

Példák

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.core.util.Context;
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),
            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

Mintaválasz

Állapotkód:: 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"
}

Állapotkód:: 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"
}

Állapotkód:: 202

Update a sync member

Mintakérelem

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.core.util.Context;
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),
            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

Mintaválasz

Állapotkód:: 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"
}

Állapotkód:: 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"
}

Állapotkód:: 202

Definíciók

Name	Description
SyncDirection	A szinkronizálási tag szinkronizálási iránya.
SyncMember	Egy Azure SQL adatbázis-szinkronizálási tag.
SyncMemberDbType	A szinkronizálási tag adatbázistípusa.
SyncMemberState	A szinkronizálási tag szinkronizálási állapota.

SyncDirection

A szinkronizálási tag szinkronizálási iránya.

Name	Típus	Description
Bidirectional	string
OneWayHubToMember	string
OneWayMemberToHub	string

SyncMember

Egy Azure SQL adatbázis-szinkronizálási tag.

Name	Típus	Description
id	string	Erőforrás-azonosító.
name	string	Erőforrás neve.
properties.databaseName	string	A tagadatbázis adatbázisneve a szinkronizálási tagban.
properties.databaseType	SyncMemberDbType	A szinkronizálási tag adatbázistípusa.
properties.password	string	A tagadatbázis jelszava a szinkronizálási tagban.
properties.privateEndpointName	string	A szinkronizálási tag privát végpontjának neve, ha a privát kapcsolat használata engedélyezve van, az Azure-beli szinkronizálási tagok esetében.
properties.serverName	string	A tagadatbázis kiszolgálóneve a szinkronizálási tagban
properties.sqlServerDatabaseId	string	SQL Server szinkronizálási tag adatbázis-azonosítója.
properties.syncAgentId	string	A szinkronizálási ügynök ARM-erőforrás-azonosítója a szinkronizálási tagban.
properties.syncDirection	SyncDirection	A szinkronizálási tag szinkronizálási iránya.
properties.syncMemberAzureDatabaseResourceId	string	A szinkronizálási tag logikai adatbázisÁNAK ARM-erőforrás-azonosítója az Azure-beli szinkronizálási tagokhoz.
properties.syncState	SyncMemberState	A szinkronizálási tag szinkronizálási állapota.
properties.usePrivateLinkConnection	boolean	Privát kapcsolati kapcsolat használata.
properties.userName	string	A tagadatbázis felhasználóneve a szinkronizálási tagban.
type	string	Erőforrástípus.

SyncMemberDbType

A szinkronizálási tag adatbázistípusa.

Name	Típus	Description
AzureSqlDatabase	string
SqlServerDatabase	string

SyncMemberState

A szinkronizálási tag szinkronizálási állapota.

Name	Típus	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

Megosztás a következőn keresztül:

Sync Members - Create Or Update

URI-paraméterek

Kérelem törzse

Válaszok

Példák

Create a new sync member

Mintakérelem

Mintaválasz

Update a sync member

Mintakérelem

Mintaválasz

Definíciók

SyncDirection

SyncMember

SyncMemberDbType

SyncMemberState

További források