Sync Members - Create Or Update

Servicio:

SQL Database

Versión de la API:

2021-11-01

Crea o actualiza un miembro de sincronización.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
databaseName	path	True	string	Nombre de la base de datos en la que se hospeda el grupo de sincronización.
resourceGroupName	path	True	string	Nombre del grupo de recursos que contiene el recurso. Puede obtener este valor en la API del Administrador de recursos o el portal de Azure.
serverName	path	True	string	El nombre del servidor.
subscriptionId	path	True	string	El id. de suscripción que identifica una suscripción de Azure.
syncGroupName	path	True	string	Nombre del grupo de sincronización en el que se hospeda el miembro de sincronización.
syncMemberName	path	True	string	Nombre del miembro de sincronización.
api-version	query	True	string	La versión de API que se usará para la solicitud.

Cuerpo de la solicitud

Nombre	Tipo	Description
properties.databaseName	string	Nombre de base de datos de la base de datos miembro en el miembro de sincronización.
properties.databaseType	SyncMemberDbType	Tipo de base de datos del miembro de sincronización.
properties.password	string	Contraseña de la base de datos miembro en el miembro de sincronización.
properties.serverName	string	Nombre del servidor de la base de datos miembro en el miembro de sincronización
properties.sqlServerDatabaseId	string	SQL Server identificador de base de datos del miembro de sincronización.
properties.syncAgentId	string	Identificador de recurso de ARM del agente de sincronización en el miembro de sincronización.
properties.syncDirection	SyncDirection	Dirección de sincronización del miembro de sincronización.
properties.syncMemberAzureDatabaseResourceId	string	Identificador de recurso de ARM de la base de datos lógica miembro de sincronización para los miembros de sincronización en Azure.
properties.usePrivateLinkConnection	boolean	Si se va a usar la conexión de vínculo privado.
properties.userName	string	Nombre de usuario de la base de datos miembro en el miembro de sincronización.

Respuestas

Nombre	Tipo	Description
200 OK	SyncMember	Se actualizó correctamente el miembro de sincronización.
201 Created	SyncMember	Se creó correctamente el miembro de sincronización.
202 Accepted		La creación o actualización del miembro de sincronización está en curso.
Other Status Codes		Respuestas de error: *** 400 InvalidSyncGroupCreateOrUpdateRequest: el cuerpo de la solicitud del grupo de sincronización de creación o actualización está vacío. 400 InvalidSyncMemberCreateOrUpdateRequest: el cuerpo de la solicitud de miembro de sincronización de creación o actualización está vacío. 400 InvalidSyncAgentCreateOrUpdateRequest: el cuerpo de la solicitud del agente de sincronización de creación o actualización está vacío. 400 InvalidDatabaseResourceId: identificador de recurso de base de datos no válido. 400 Error de coincidenciaSubscriptionWithUrl: la suscripción proporcionada no coincide con la suscripción en la dirección URL. 400 InvalidSyncAgentResourceId: identificador de recurso del agente de sincronización no válido. 400 No coincidentesResourceGroupNameWithUrl: el nombre del grupo de recursos proporcionado no coincide con el nombre de la dirección URL. 400 No coincidentesServerNameWithUrl: el nombre del servidor proporcionado no coincide con el nombre de la dirección URL. 400 InvalidParameterValue: se ha dado un valor no válido a un parámetro. 400 MissingServerName: falta el nombre del servidor 400 MissingDatabaseName: falta el nombre de la base de datos 400 MissingSyncGroupName: falta el nombre del grupo de sincronización 400 MissingConflictResolutionPolicy: falta la directiva de resolución de conflictos 400 MissingSyncAgentName: falta el nombre del agente de sincronización 400 SyncOperation_GenericFailure: no se pudo realizar la operación de sincronización de datos. 400 InvalidSyncGroup: el grupo de sincronización no es válido. 400 InvalidSyncMember: el miembro sync no es válido. 400 InvalidSyncAgent: el agente de sincronización no es válido. 400 CannotCreateSyncMemberDueToQuotaExceeded: no se puede crear un miembro de sincronización debido a la cuota superada. 400 SyncOperation_DuplicateSyncMemberDrop: el miembro de sincronización ya se está quitando. 400 SyncOperation_WrongSyncDatabase: la base de datos de sincronización especificada no coincide con la existente. 400 SyncOperation_DwInSyncGroup: no se puede usar la edición datawarehouse en la sincronización de datos. 400 SyncOperation_MasterDbInSyncGroup: no se puede usar el patrón lógico en la sincronización de datos. 400 SyncOperation_InvalidCredential: la credencial de la base de datos no es válida. 400 InvalidSyncMetadatabase: la base de datos de metadatos de sincronización no es válida. 404 ResourceNotFound: no se encontró el recurso solicitado. 404 SubscriptionDoesNotHaveServer: no se encontró el servidor solicitado 404 DatabaseDoesNotExist: el usuario ha especificado un nombre de base de datos que no existe en esta instancia del servidor. 404 SyncOperation_HubServerNotFound: el servidor lógico del concentrador no existe. 404 SyncOperation_InvalidHubDatabase: la base de datos del centro de conectividad no es válida. 404 OperationIdNotFound: la operación con id. no existe. 409 SyncOperation_DuplicateSyncMemberName: no se puede crear un miembro de sincronización porque el miembro de sincronización con el mismo nombre ya existe. 409 OperationCancelled: el usuario ha cancelado la operación. 409 OperationInterrupted: no se pudo completar la operación en el recurso porque se interrumpió por otra operación en el mismo recurso. 429 SubscriptionTooManyCreateUpdateRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar. 429 SubscriptionTooManyRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar. 500 OperationTimedOut: la operación agota el tiempo de espera y se revierte automáticamente. Vuelva a intentar la operación y, 503 TooManyRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar.

Ejemplos

Create a new sync member

Update a sync member

Create a new sync member

Solicitud de ejemplo

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

Respuesta de muestra

status code:

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

status code:

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

status code:

202

Update a sync member

Solicitud de ejemplo

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

Respuesta de muestra

status code:

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

status code:

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

status code:

202

Definiciones

Nombre	Description
SyncDirection	Dirección de sincronización del miembro de sincronización.
SyncMember	Un miembro de sincronización de Azure SQL Database.
SyncMemberDbType	Tipo de base de datos del miembro de sincronización.
SyncMemberState	Estado de sincronización del miembro de sincronización.

SyncDirection

Dirección de sincronización del miembro de sincronización.

Nombre	Tipo	Description
Bidirectional	string
OneWayHubToMember	string
OneWayMemberToHub	string

SyncMember

Un miembro de sincronización de Azure SQL Database.

Nombre	Tipo	Description
id	string	Identificador del recurso.
name	string	Nombre del recurso.
properties.databaseName	string	Nombre de base de datos de la base de datos miembro en el miembro de sincronización.
properties.databaseType	SyncMemberDbType	Tipo de base de datos del miembro de sincronización.
properties.password	string	Contraseña de la base de datos miembro en el miembro de sincronización.
properties.privateEndpointName	string	Nombre del punto de conexión privado del miembro de sincronización si se habilita la conexión de vínculo privado para los miembros de sincronización en Azure.
properties.serverName	string	Nombre del servidor de la base de datos miembro en el miembro de sincronización
properties.sqlServerDatabaseId	string	SQL Server identificador de base de datos del miembro de sincronización.
properties.syncAgentId	string	Identificador de recurso de ARM del agente de sincronización en el miembro de sincronización.
properties.syncDirection	SyncDirection	Dirección de sincronización del miembro de sincronización.
properties.syncMemberAzureDatabaseResourceId	string	Identificador de recurso de ARM de la base de datos lógica miembro de sincronización para los miembros de sincronización en Azure.
properties.syncState	SyncMemberState	Estado de sincronización del miembro de sincronización.
properties.usePrivateLinkConnection	boolean	Si se va a usar la conexión de vínculo privado.
properties.userName	string	Nombre de usuario de la base de datos miembro en el miembro de sincronización.
type	string	Tipo de recurso.

SyncMemberDbType

Tipo de base de datos del miembro de sincronización.

Nombre	Tipo	Description
AzureSqlDatabase	string
SqlServerDatabase	string

SyncMemberState

Estado de sincronización del miembro de sincronización.

Nombre	Tipo	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