Sync Groups - Create Or Update

Referencia

Servicio:: SQL Database

Versión de la API:: 2021-11-01

Crea o actualiza un grupo de sincronización.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/syncGroups/{syncGroupName}?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.
api-version	query	True	string	La versión de API que se usará para la solicitud.

Cuerpo de la solicitud

Nombre	Tipo	Description
properties.conflictLoggingRetentionInDays	integer	Período de retención de registro de conflictos.
properties.conflictResolutionPolicy	SyncConflictResolutionPolicy	Directiva de resolución de conflictos del grupo de sincronización.
properties.enableConflictLogging	boolean	Si el registro de conflictos está habilitado.
properties.hubDatabasePassword	string	Contraseña para la credencial de la base de datos del centro de grupos de sincronización.
properties.hubDatabaseUserName	string	Nombre de usuario para la credencial de la base de datos del centro de grupo de sincronización.
properties.interval	integer	Intervalo de sincronización del grupo de sincronización.
properties.schema	SyncGroupSchema	Esquema de sincronización del grupo de sincronización.
properties.syncDatabaseId	string	Identificador de recurso de ARM de la base de datos de sincronización en el grupo de sincronización.
properties.usePrivateLinkConnection	boolean	Si se habilita la conexión de private link.
sku	Sku	Nombre y capacidad de la SKU.

Respuestas

Nombre	Tipo	Description
200 OK	SyncGroup	Se actualizó correctamente el grupo de sincronización.
201 Created	SyncGroup	Se creó correctamente el grupo de sincronización.
202 Accepted		La creación o actualización del grupo 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 No coincidentesSubscriptionWithUrl: la suscripción proporcionada no coincide con la suscripción en la dirección URL. 400 InvalidSyncAgentResourceId: identificador de recursos 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 FeatureDisabledOnSelectedEdition: el usuario intentó usar una característica que está deshabilitada en la edición actual de la base de datos. 400 CannotCreateSyncGroupDueToQuotaExceeded: no se puede crear un grupo de sincronización debido a que se superó la cuota. 400 SyncOperation_DuplicateSyncGroupDrop: el grupo 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_UpdateSyncGroupWhenDropping: no se puede actualizar el grupo de sincronización porque actualmente se está quitando. 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 InvalidSyncMetadataDatabase: la base de datos de metadatos de sincronización no es válida. 400 SyncOperation_InvalidSyncInterval: no se puede crear o actualizar el grupo de sincronización porque el intervalo de sincronización no es válido. 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 central no es válida. 404 OperationIdNotFound: la operación con id. no existe. 409 SyncOperation_DuplicateSyncGroupName: no se puede crear el grupo de sincronización porque el grupo de sincronización con el mismo nombre ya existe. 409 OperationCancelled: el usuario canceló 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 SuscripciónTooManyCreateUpdateRequests: solicitudes más allá del número máximo de solicitudes que pueden procesar los recursos disponibles. 429 SubscriptionTooManyRequests: solicitudes más allá del número máximo de solicitudes que pueden procesar los recursos disponibles. 500 OperationTimedOut: se agota el tiempo de espera de la operación y se revierte automáticamente. Vuelva a intentar la operación y, 503 TooManyRequests: solicitudes más allá del número máximo de solicitudes que se pueden procesar mediante recursos disponibles.

Ejemplos

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

Respuesta de muestra

status code:: 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"
}

status code:: 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"
}

status code:: 202

Update a sync group

Solicitud de ejemplo

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

Respuesta de muestra

status code:: 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"
}

status code:: 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"
}

status code:: 202

Definiciones

Nombre	Description
Sku	Una SKU de recursos de ARM.
SyncConflictResolutionPolicy	Directiva de resolución de conflictos del grupo de sincronización.
SyncGroup	Un grupo de sincronización de base de datos de Azure SQL.
SyncGroupSchema	Propiedades del esquema de grupo de sincronización.
SyncGroupSchemaTable	Propiedades de la tabla en el esquema de grupo de sincronización.
SyncGroupSchemaTableColumn	Propiedades de la columna en la tabla de grupos de sincronización.
SyncGroupState	Estado de sincronización del grupo de sincronización.

Sku

Object

Una SKU de recursos de ARM.

Nombre	Tipo	Description
capacity	integer	Capacidad de la SKU determinada.
family	string	Si el servicio tiene diferentes generaciones de hardware, para la misma SKU, se puede capturar aquí.
name	string	El nombre de la SKU, normalmente, una letra + código numérico, por ejemplo, P3.
size	string	Tamaño de la SKU determinada
tier	string	El nivel o la edición de la SKU determinada, por ejemplo, Básico, Premium.

SyncConflictResolutionPolicy

Enumeration

Directiva de resolución de conflictos del grupo de sincronización.

Valor	Description
HubWin
MemberWin

SyncGroup

Object

Un grupo de sincronización de base de datos de Azure SQL.

Nombre	Tipo	Description
id	string	Identificador del recurso.
name	string	Nombre del recurso.
properties.conflictLoggingRetentionInDays	integer	Período de retención de registro de conflictos.
properties.conflictResolutionPolicy	SyncConflictResolutionPolicy	Directiva de resolución de conflictos del grupo de sincronización.
properties.enableConflictLogging	boolean	Si el registro de conflictos está habilitado.
properties.hubDatabasePassword	string	Contraseña para la credencial de la base de datos del centro de grupos de sincronización.
properties.hubDatabaseUserName	string	Nombre de usuario para la credencial de la base de datos del centro de grupo de sincronización.
properties.interval	integer	Intervalo de sincronización del grupo de sincronización.
properties.lastSyncTime	string	Hora de la última sincronización del grupo de sincronización.
properties.privateEndpointName	string	Nombre del punto de conexión privado del grupo de sincronización si se habilita la conexión de vínculo privado.
properties.schema	SyncGroupSchema	Esquema de sincronización del grupo de sincronización.
properties.syncDatabaseId	string	Identificador de recurso de ARM de la base de datos de sincronización en el grupo de sincronización.
properties.syncState	SyncGroupState	Estado de sincronización del grupo de sincronización.
properties.usePrivateLinkConnection	boolean	Si se habilita la conexión de private link.
sku	Sku	Nombre y capacidad de la SKU.
type	string	Tipo de recurso.

SyncGroupSchema

Object

Propiedades del esquema de grupo de sincronización.

Nombre	Tipo	Description
masterSyncMemberName	string	Nombre del miembro de sincronización maestra desde el que procede el esquema.
tables	SyncGroupSchemaTable[]	Lista de tablas en el esquema de grupo de sincronización.

SyncGroupSchemaTable

Object

Propiedades de la tabla en el esquema de grupo de sincronización.

Nombre	Tipo	Description
columns	SyncGroupSchemaTableColumn[]	Lista de columnas en el esquema de grupo de sincronización.
quotedName	string	Nombre entre comillas de la tabla de esquema de grupo de sincronización.

SyncGroupSchemaTableColumn

Object

Propiedades de la columna en la tabla de grupos de sincronización.

Nombre	Tipo	Description
dataSize	string	Tamaño de los datos de la columna.
dataType	string	Tipo de datos de la columna.
quotedName	string	Nombre entre comillas de la columna de tabla de grupo de sincronización.

SyncGroupState

Enumeration

Estado de sincronización del grupo de sincronización.

Valor	Description
Error
Good
NotReady
Progressing
Warning

Compartir a través de

Sync Groups - Create Or Update

Parámetros de identificador URI

Cuerpo de la solicitud

Respuestas

Ejemplos

Create a sync group

Solicitud de ejemplo

Respuesta de muestra

Update a sync group

Solicitud de ejemplo

Respuesta de muestra

Definiciones

Sku

SyncConflictResolutionPolicy

SyncGroup

SyncGroupSchema

SyncGroupSchemaTable

SyncGroupSchemaTableColumn

SyncGroupState

Recursos adicionales