你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Failover Groups - Create Or Update

服务:: SQL Database

API 版本:: 2023-08-01

创建或更新故障转移组。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/failoverGroups/{failoverGroupName}?api-version=2023-08-01

URI 参数

名称	在	必需	类型	说明
failoverGroupName	path	True	string	故障转移组的名称。
resourceGroupName	path	True	string	包含资源的资源组的名称。可以从 Azure 资源管理器 API 或门户获取此值。
serverName	path	True	string	包含故障转移组的服务器的名称。
subscriptionId	path	True	string	标识 Azure 订阅的订阅 ID。
api-version	query	True	string	要用于请求的 API 版本。

请求正文

名称	必需	类型	说明
properties.partnerServers	True	PartnerInfo[]	故障转移组的合作伙伴服务器信息列表。
properties.readWriteEndpoint	True	FailoverGroupReadWriteEndpoint	故障转移组实例的读写终结点。
properties.databases		string[] (arm-id)	故障转移组中的数据库列表。
properties.readOnlyEndpoint		FailoverGroupReadOnlyEndpoint	故障转移组实例的只读终结点。
properties.secondaryType		FailoverGroupDatabasesSecondaryType	合作伙伴服务器上的数据库辅助类型。
tags		object	资源标记。

响应

名称	类型	说明
200 OK	FailoverGroup	已成功更新故障转移组。
201 Created	FailoverGroup	已成功创建故障转移组。
202 Accepted		接受标头 Location: string
Other Status Codes	ErrorResponse	错误响应： *** 400 FailoverGroupCreateOrUpdateRequestInvalidDatabases - 提供的数据库 ID 未正确构造数据库资源 ID。有关正确格式的示例，请参阅 https://docs.microsoft.com/en-us/rest/api/sql/failovergroups/createorupdate 400 FailoverGroupCreateOrUpdateRequestInvalidPartner - 创建或更新故障转移组请求正文中的给定合作伙伴字段为空或无效。请提供此字段的有效值。有关格式正确的请求的示例，请参阅 https://docs.microsoft.com/en-us/rest/api/sql/failovergroups/createorupdate 400 FailoverGroupCreateOrUpdateRequestDuplicatePartner - 提供的一个或多个合作伙伴服务器已是故障转移组的一部分。请确保主服务器和所有给定的合作伙伴服务器都是唯一的。 400 FailoverGroupCreateOrUpdateRequestInvalidDatabaseServer - 故障转移组的主服务器上不存在一个或多个提供的数据库。请确保主服务器上存在所有数据库。 400 FailoverGroupCreateOrUpdateRequestUnsupportedPartnerCount - 仅支持故障转移组的一个伙伴服务器。请相应地修改你的请求。有关有效请求的示例，请参阅 https://docs.microsoft.com/en-us/rest/api/sql/failovergroups/createorupdate 400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpoint - 创建或更新请求需要 readWriteEndpoint 字段。 400 FailoverGroupCreateOrUpdateRequestInvalid - 创建或更新故障转移组请求正文为空或无效。 400 FailoverGroupUpdateOrDeleteRequestOnSecondary - 辅助服务器上不允许修改故障转移组。在主服务器上执行请求。 400 FailoverGroupCreateOrUpdateRequestNegativeGracePeriodValues - 读写终结点的宽限期值必须为非负值。 400 FailoverGroupCreateOrUpdateRequestLessThanMinimumGracePeriodValues - 故障转移组的宽限期值必须大于或等于“{0}”分钟最小宽限期 400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFields - 在为读写终结点选择故障转移策略自动时，必须提供属性 failoverWithDataLossGracePeriodMinutes。 400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteFailoverPolicy - 创建或更新请求需要读写终结点的 failoverPolicy 字段。 400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFieldsForManualPolicy - 在为读写终结点选择故障转移策略手动时，不应提供宽限期值。请将其从请求中删除。 400 FailoverGroupCreateOrUpdateRequestReadOnlyPropertyModified - 创建或更新故障转移组请求正文不应修改只读属性“{0}”。 400 FailoverGroupFailoverRequestOnPrimary - 故障转移请求应在故障转移组的辅助服务器上启动。 400 FailoverGroupPartnerServerFromDifferentSubscription - 故障转移组的主服务器和合作伙伴服务器来自不同的订阅。不允许跨订阅故障转移组的服务器。 400 FailoverGroupCreateOrUpdateRequestInvalidReadOnlyEndpointTargetServer - 只读终结点的属性 targetServer 必须是为故障转移组配置的 partnerServers 中存在的有效服务器。 400 FailoverGroupCreateOrUpdateRequestUnsupportedPartnerCountForStandby - 辅助类型待机仅支持故障转移组的一个伙伴服务器。请相应地修改你的请求。 400 InvalidServerName - 指定的服务器名称无效。 400 InvalidIdentifier - 标识符包含 NULL 或无效的 unicode 字符。 400 TokenTooLong - 提供的令牌太长。 400 InvalidAddSecondaryPermission - 用户没有足够的权限在指定的服务器上添加辅助数据库。 400 InvalidSku - 用户指定了无效 SKU。 400 ServerNotFound - 找不到请求的服务器。 400 FeatureDisabledOnSelectedEdition - 用户尝试使用当前数据库版本上禁用的功能。 400 TokenTooLong - 提供的令牌太长。 400 InvalidTargetSubregion - 不可读辅助数据库的目标服务器不在 DR 配对的 Azure 区域中。 400 PartnerServerNotCompatible - 用户尝试将数据库从 SAWA V1 服务器复制到斯特林服务器，反之亦然。 400 IncorrectReplicationLinkState - 该作要求数据库在复制链接上处于预期状态。 400 ResourcePoolNotFound - 指定的弹性池在指定的逻辑服务器中不存在。 400 AzureKeyVaultKeyDisabled - 无法在服务器上完成该作，因为 Azure Key Vault 密钥已禁用。 400 AzureKeyVaultInvalidExpirationDate - 无法完成该作，因为 Azure Key Vault 密钥到期日期无效。 400 SecurityAzureKeyVaultUrlNullOrEmpty - 无法完成作，因为 Azure Key Vault URI 为 null 或为空。 400 AzureKeyVaultNoServerIdentity - 服务器标识未正确配置。 400 AzureKeyVaultInvalidUri - 来自 Azure Key Vault 的无效响应。请使用有效的 Azure Key Vault URI。 400 AzureKeyVaultMissingPermissions - 服务器缺少对 Azure Key Vault 所需的权限。 400 SecurityAzureKeyVaultInvalidKeyName - 由于服务器密钥名称无效，无法完成该作。 400 PlannedFailoverTimedOutForDatabase - 用户调用了计划内故障转移，超时，特定数据库似乎要归咎于此。 400 PlannedFailoverTimedOut - 用户调用了计划的故障转移，尝试联系合作伙伴管理服务时超时。 400 AdalGenericError - 由于遇到 Azure Active Directory 错误，无法完成该作。 400 AdalServicePrincipalNotFound - 无法完成该作，因为遇到 Azure Active Directory 库服务主体找不到错误。 400 AzureKeyVaultMalformedVaultUri - 提供的 Key Vault URI 无效。 400 CannotUseReservedDatabaseName - 不能在此作中使用保留的数据库名称。 400 InvalidFailoverGroupRegion - 故障转移组中指定的服务器需要驻留在不同的区域中以提供隔离。 400 FailoverGroupDoesNotExist - 故障转移组在服务器上不存在。 400 FailoverGroupNotSecondary - 无法从故障转移组中的主服务器启动故障转移。 400 InvalidServerName - 指定的服务器名称无效。 400 DatabaseInFailoverGroupNotPrimary - 数据库的 GeoDR 链接已存在，但其角色不是“主要”，也不是连续复制链接。 400 SecurityAdalPrincipalCertExpiredError - 无法完成该作，因为 Azure Key Vault 主体证书已过期。 400 UnableToCreateFailoverGroupDueToTableAuditing - 无法为启用了表审核的服务器创建故障转移组。 400 InvalidIdentifier - 标识符包含 NULL 或无效的 unicode 字符。 400 UnableToAddDbWithTableAuditingToFailoverGroup - 无法通过故障转移组终结点访问启用了表审核的数据库。 400 SecurityInvalidAzureKeyVaultRecoveryLevel - 提供的 Key Vault URI 无效。 400 KeyMaterialNotFoundOnRemoteServer - 远程服务器无权访问用作 TDE 保护程序的密钥材料。 400 LimitOfFailoverGroupsPerServerExceeded - 创建新的故障转移组将超过每个服务器的允许故障转移组数。 400 SameKeyUriNotFoundOnRemoteServer - 辅助服务器没有与启用了密钥自动轮换的主服务器的加密保护程序相同的密钥保管库中的密钥材料。 400 AzureKeyVaultRsaKeyNotSupported - 提供的密钥保管库使用不支持的 RSA 密钥大小或密钥类型。支持的 RSA 密钥大小为 2048 或 3072，密钥类型为 RSA 或 RSA-HSM。 400 SameKeyMaterialNotFoundOnRemoteServer - 辅助服务器没有主服务器的加密保护程序的密钥材料。 400 GeoReplicationDatabaseNotSecondary - 该作要求数据库成为复制目标。 400 GeoReplicaLimitReached - 达到了每个副本复制限制。 400 FailoverGroupWithVirtualNetworkRulesNotSupported - 配置了自动故障转移策略的故障转移组目前在配置了虚拟网络防火墙规则的服务器上不受支持。请使用手动故障转移策略配置故障转移组。 400 UnableToResolveRemoteServer - 由于服务器名称或 DNS 连接问题无效，无法解决远程合作伙伴服务器名称。 400 RemoteDatabaseCopyPermission - 用户没有足够的权限在指定服务器上创建数据库副本。 400 SecurityAzureKeyVaultGeoChainError - 使用 Azure Key Vault（BYOK）启用透明数据加密时不支持创建辅助数据库（称为链接的进程）。 400 FailoverGroupCreateOrUpdatePartiallySucceeded - 某些数据库无法添加或删除。 404 OperationIdNotFound - ID作不存在。 404 ResourceNotFound - 找不到请求的资源。 404 OperationIdNotFound - ID作不存在。 404 ServerNotInSubscriptionResourceGroup - 指定的服务器在指定的资源组和订阅中不存在。 404 ServerNotInSubscription - 指定的服务器在指定的订阅上不存在。 404 SourceDatabaseNotFound - 源数据库不存在。 405 UnsupportedReplicationOperation - 在数据库上启动了不受支持的复制作。 409 CannotCancelOperation - 管理作处于无法取消的状态。 409 OperationCancelled -作已被用户取消。 409 OperationInterrupted - 无法完成资源上的作，因为它被同一资源上的另一个作中断。 409 ConflictingServerOperation - 服务器当前正在进行作。 409 SubscriptionDisabled - 已禁用订阅。 409 ConflictingSystemOperationInProgress - 数据库正在进行系统维护作，并且需要等待进一步的作，直到它完成。 409 GeoReplicationCannotBecomePrimaryDuringUndo - 用户尝试故障转移或强制终止异地链接，而辅助副本处于物理上不一致的状态，因此无法进入主要角色。 409 ServerKeyNameAlreadyExists - 服务器上已存在服务器密钥。 409 ServerKeyUriAlreadyExists - 服务器上已存在服务器密钥 URI。 409 ServerKeyDoesNotExists - 服务器密钥不存在。 409 UpdateSloInProgress - 用户在 SLO 更新正在进行时尝试启动不兼容的作。 409 AzureKeyVaultKeyNameNotFound - 无法完成该作，因为 Azure Key Vault 密钥名称不存在。 409 AzureKeyVaultKeyInUse - 服务器当前正在使用密钥。 409 FailoverGroupAlreadyExists - 故障转移组已存在于给定服务器上。请使用不同的故障转移组名称。 409 FailoverGroupBusy - 故障转移组正忙于另一个作。 409 DatabaseBelongsToOtherFailoverGroup - 数据库属于其他故障转移组，不能被视为此故障转移组的一部分。 409 DatabaseBeingAddedToFailoverGroup - 数据库当前正在添加到故障转移组，客户需要等待此作完成以发出删除问题。 409 DatabaseBeingRemovedFromFailoverGroup - 数据库当前正在从故障转移组中删除，客户需要等待此作完成添加。 409 FailoverGroupDnsRecordInUse - 请求的终结点存在重复的 DNS 记录。 409 InvalidFailoverGroupName - 提供了无效的故障转移组名称。 409 InvalidOperationForDatabaseNotInReplicationRelationship - 对不在复制关系中的数据库执行复制作。 409 InvalidDatabaseStateForOperation - 当前复制状态的数据库上不允许此作。 409 DuplicateGeoDrRelation - 数据库已处于复制关系中。这是重复的请求。 409 RemoteDatabaseExists - 目标服务器上已存在目标数据库名称。 409 FailoverGroupUnableToPerformGroupOperationOnDatabases - 要向/从故障转移组中添加/删除的数据库列表包含阻止作完成的错误。 429 SubscriptionTooManyCreateUpdateRequests - 请求超出可用资源可以处理的最大请求数。 429 SubscriptionTooManyRequests - 请求超出可用资源可以处理的最大请求数。 429 SubscriptionTooManyCreateUpdateRequests - 请求超出可用资源可以处理的最大请求数。 429 SubscriptionTooManyRequests - 请求超出可用资源可以处理的最大请求数。 500 OperationTimedOut -作超时并自动回滚。请重试该作。 503 TooManyRequests - 请求超出可用资源可以处理的最大请求数。 503 TooManyRequests - 请求超出可用资源可以处理的最大请求数。 503 AzureKeyVaultConnectionFailed - 无法在服务器上完成该作，因为尝试连接到 Azure Key Vault 失败 503 AzureKeyVaultGenericConnectionError - 无法完成该作，因为尝试检索 Key Vault 信息时遇到错误。 503 DatabaseUnavailable -作失败，因为数据库不可用。 504 RequestTimeout - 服务请求超过了允许的超时。

示例

Create failover group

Create failover group with standby secondary database on partner server.

Create failover group

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/failoverGroups/failover-group-test-3?api-version=2023-08-01

{
  "properties": {
    "readWriteEndpoint": {
      "failoverPolicy": "Automatic",
      "failoverWithDataLossGracePeriodMinutes": 480
    },
    "readOnlyEndpoint": {
      "failoverPolicy": "Disabled"
    },
    "partnerServers": [
      {
        "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server"
      }
    ],
    "databases": [
      "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-1",
      "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-2"
    ]
  }
}

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Sql.Models;
using Azure.ResourceManager.Sql;

// Generated from example definition: specification/sql/resource-manager/Microsoft.Sql/stable/2023-08-01/examples/FailoverGroupCreateOrUpdate.json
// this example is just showing the usage of "FailoverGroups_CreateOrUpdate" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://free.blessedness.top/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this SqlServerResource created on azure
// for more information of creating SqlServerResource, please refer to the document of SqlServerResource
string subscriptionId = "00000000-1111-2222-3333-444444444444";
string resourceGroupName = "Default";
string serverName = "failover-group-primary-server";
ResourceIdentifier sqlServerResourceId = SqlServerResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, serverName);
SqlServerResource sqlServer = client.GetSqlServerResource(sqlServerResourceId);

// get the collection of this FailoverGroupResource
FailoverGroupCollection collection = sqlServer.GetFailoverGroups();

// invoke the operation
string failoverGroupName = "failover-group-test-3";
FailoverGroupData data = new FailoverGroupData
{
    ReadWriteEndpoint = new FailoverGroupReadWriteEndpoint(ReadWriteEndpointFailoverPolicy.Automatic)
    {
        FailoverWithDataLossGracePeriodMinutes = 480,
    },
    ReadOnlyEndpoint = new FailoverGroupReadOnlyEndpoint
    {
        FailoverPolicy = ReadOnlyEndpointFailoverPolicy.Disabled,
    },
    PartnerServers = { new PartnerServerInfo(new ResourceIdentifier("/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server")) },
    FailoverDatabases = { new ResourceIdentifier("/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-1"), new ResourceIdentifier("/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-2") },
};
ArmOperation<FailoverGroupResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, failoverGroupName, data);
FailoverGroupResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
FailoverGroupData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

示例响应

状态代码:: 200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/failoverGroups/failover-group-test-3",
  "name": "failover-group-test-3",
  "type": "Microsoft.Sql/servers/failoverGroups",
  "location": "Japan East",
  "properties": {
    "readWriteEndpoint": {
      "failoverPolicy": "Automatic",
      "failoverWithDataLossGracePeriodMinutes": 480
    },
    "readOnlyEndpoint": {
      "failoverPolicy": "Disabled",
      "targetServer": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server"
    },
    "replicationRole": "Primary",
    "replicationState": "CATCH_UP",
    "partnerServers": [
      {
        "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server",
        "location": "Japan West",
        "replicationRole": "Secondary"
      }
    ],
    "databases": [
      "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-1",
      "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-2"
    ]
  }
}

状态代码:: 201

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/failoverGroups/failover-group-test-3",
  "name": "failover-group-test-3",
  "type": "Microsoft.Sql/servers/failoverGroups",
  "location": "Japan East",
  "properties": {
    "readWriteEndpoint": {
      "failoverPolicy": "Automatic",
      "failoverWithDataLossGracePeriodMinutes": 480
    },
    "readOnlyEndpoint": {
      "failoverPolicy": "Disabled",
      "targetServer": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server"
    },
    "replicationRole": "Primary",
    "replicationState": "CATCH_UP",
    "partnerServers": [
      {
        "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server",
        "location": "Japan West",
        "replicationRole": "Secondary"
      }
    ],
    "databases": [
      "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-1",
      "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-2"
    ]
  }
}

状态代码:: 202

Location: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/japaneast/failoverGroupOperationResults/11111111-1111-1111-1111-111111111111

Create failover group with standby secondary database on partner server.

示例请求

HTTP
dotnet

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/failoverGroups/failover-group-test-3?api-version=2023-08-01

{
  "properties": {
    "readWriteEndpoint": {
      "failoverPolicy": "Automatic",
      "failoverWithDataLossGracePeriodMinutes": 480
    },
    "readOnlyEndpoint": {
      "failoverPolicy": "Disabled"
    },
    "partnerServers": [
      {
        "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server"
      }
    ],
    "databases": [
      "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-1",
      "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-2"
    ],
    "secondaryType": "Standby"
  }
}

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Sql.Models;
using Azure.ResourceManager.Sql;

// Generated from example definition: specification/sql/resource-manager/Microsoft.Sql/stable/2023-08-01/examples/FailoverGroupCreateOrUpdateStandbySecondary.json
// this example is just showing the usage of "FailoverGroups_CreateOrUpdate" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://free.blessedness.top/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this SqlServerResource created on azure
// for more information of creating SqlServerResource, please refer to the document of SqlServerResource
string subscriptionId = "00000000-1111-2222-3333-444444444444";
string resourceGroupName = "Default";
string serverName = "failover-group-primary-server";
ResourceIdentifier sqlServerResourceId = SqlServerResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, serverName);
SqlServerResource sqlServer = client.GetSqlServerResource(sqlServerResourceId);

// get the collection of this FailoverGroupResource
FailoverGroupCollection collection = sqlServer.GetFailoverGroups();

// invoke the operation
string failoverGroupName = "failover-group-test-3";
FailoverGroupData data = new FailoverGroupData
{
    ReadWriteEndpoint = new FailoverGroupReadWriteEndpoint(ReadWriteEndpointFailoverPolicy.Automatic)
    {
        FailoverWithDataLossGracePeriodMinutes = 480,
    },
    ReadOnlyEndpoint = new FailoverGroupReadOnlyEndpoint
    {
        FailoverPolicy = ReadOnlyEndpointFailoverPolicy.Disabled,
    },
    PartnerServers = { new PartnerServerInfo(new ResourceIdentifier("/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server")) },
    FailoverDatabases = { new ResourceIdentifier("/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-1"), new ResourceIdentifier("/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-2") },
    SecondaryType = FailoverGroupDatabasesSecondaryType.Standby,
};
ArmOperation<FailoverGroupResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, failoverGroupName, data);
FailoverGroupResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
FailoverGroupData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

示例响应

状态代码:: 200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/failoverGroups/failover-group-test-3",
  "name": "failover-group-test-3",
  "type": "Microsoft.Sql/servers/failoverGroups",
  "location": "Japan East",
  "properties": {
    "readWriteEndpoint": {
      "failoverPolicy": "Automatic",
      "failoverWithDataLossGracePeriodMinutes": 480
    },
    "readOnlyEndpoint": {
      "failoverPolicy": "Disabled",
      "targetServer": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server"
    },
    "replicationRole": "Primary",
    "replicationState": "CATCH_UP",
    "partnerServers": [
      {
        "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server",
        "location": "Japan West",
        "replicationRole": "Secondary"
      }
    ],
    "databases": [
      "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-1",
      "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-2"
    ]
  }
}

状态代码:: 201

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/failoverGroups/failover-group-test-3",
  "name": "failover-group-test-3",
  "type": "Microsoft.Sql/servers/failoverGroups",
  "location": "Japan East",
  "properties": {
    "readWriteEndpoint": {
      "failoverPolicy": "Automatic",
      "failoverWithDataLossGracePeriodMinutes": 480
    },
    "readOnlyEndpoint": {
      "failoverPolicy": "Disabled",
      "targetServer": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server"
    },
    "replicationRole": "Primary",
    "replicationState": "CATCH_UP",
    "partnerServers": [
      {
        "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server",
        "location": "Japan West",
        "replicationRole": "Secondary"
      }
    ],
    "databases": [
      "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-1",
      "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-2"
    ]
  }
}

状态代码:: 202

Location: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/japaneast/failoverGroupOperationResults/11111111-1111-1111-1111-111111111111

定义

名称	说明
ErrorAdditionalInfo	资源管理错误附加信息。
ErrorDetail	错误详细信息。
ErrorResponse	错误响应
FailoverGroup	故障转移组。
FailoverGroupDatabasesSecondaryType	合作伙伴服务器上的数据库辅助类型。
FailoverGroupReadOnlyEndpoint	故障转移组实例的只读终结点。
FailoverGroupReadWriteEndpoint	故障转移组实例的读写终结点。
FailoverGroupReplicationRole	故障转移组实例的本地复制角色。
PartnerInfo	故障转移组的合作伙伴服务器信息。
ReadOnlyEndpointFailoverPolicy	故障转移组只读终结点的故障转移策略。
ReadWriteEndpointFailoverPolicy	故障转移组的读写终结点的故障转移策略。如果 failoverPolicy 为 Automatic，则需要 failoverWithDataLossGracePeriodMinutes。

ErrorAdditionalInfo

Object

资源管理错误附加信息。

名称	类型	说明
info	object	其他信息。
type	string	其他信息类型。

ErrorDetail

Object

错误详细信息。

名称	类型	说明
additionalInfo	ErrorAdditionalInfo[]	错误附加信息。
code	string	错误代码。
details	ErrorDetail[]	错误详细信息。
message	string	错误消息。
target	string	错误目标。

ErrorResponse

Object

错误响应

名称	类型	说明
error	ErrorDetail	错误对象。

FailoverGroup

Object

故障转移组。

名称	类型	说明
id	string	资源 ID。
location	string	资源位置。
name	string	资源名称。
properties.databases	string[] (arm-id)	故障转移组中的数据库列表。
properties.partnerServers	PartnerInfo[]	故障转移组的合作伙伴服务器信息列表。
properties.readOnlyEndpoint	FailoverGroupReadOnlyEndpoint	故障转移组实例的只读终结点。
properties.readWriteEndpoint	FailoverGroupReadWriteEndpoint	故障转移组实例的读写终结点。
properties.replicationRole	FailoverGroupReplicationRole	故障转移组实例的本地复制角色。
properties.replicationState	string	故障转移组实例的复制状态。
properties.secondaryType	FailoverGroupDatabasesSecondaryType	合作伙伴服务器上的数据库辅助类型。
tags	object	资源标记。
type	string	资源类型。

FailoverGroupDatabasesSecondaryType

枚举

合作伙伴服务器上的数据库辅助类型。

值	说明
Geo
Standby

FailoverGroupReadOnlyEndpoint

Object

故障转移组实例的只读终结点。

名称	类型	说明
failoverPolicy	ReadOnlyEndpointFailoverPolicy	故障转移组只读终结点的故障转移策略。
targetServer	string (arm-id)	只读终结点指向的目标伙伴服务器。

FailoverGroupReadWriteEndpoint

Object

故障转移组实例的读写终结点。

名称	类型	说明
failoverPolicy	ReadWriteEndpointFailoverPolicy	故障转移组的读写终结点的故障转移策略。如果 failoverPolicy 为 Automatic，则需要 failoverWithDataLossGracePeriodMinutes。
failoverWithDataLossGracePeriodMinutes	integer (int32)	尝试对读写终结点执行故障转移前的宽限期，并丢失数据。如果 failoverPolicy 为 Automatic，则需要 failoverWithDataLossGracePeriodMinutes。

FailoverGroupReplicationRole

枚举

故障转移组实例的本地复制角色。

值	说明
Primary
Secondary

PartnerInfo

Object

故障转移组的合作伙伴服务器信息。

名称	类型	说明
id	string (arm-id)	合作伙伴服务器的资源标识符。
location	string	合作伙伴服务器的地理位置。
replicationRole	FailoverGroupReplicationRole	合作伙伴服务器的复制角色。

ReadOnlyEndpointFailoverPolicy

枚举

故障转移组只读终结点的故障转移策略。

值	说明
Disabled
Enabled

ReadWriteEndpointFailoverPolicy

枚举

故障转移组的读写终结点的故障转移策略。如果 failoverPolicy 为 Automatic，则需要 failoverWithDataLossGracePeriodMinutes。

值	说明
Manual
Automatic

通过

Failover Groups - Create Or Update

URI 参数

请求正文

响应

示例

Create failover group

示例请求

示例响应

Create failover group with standby secondary database on partner server.

示例请求

示例响应

定义

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

FailoverGroup

FailoverGroupDatabasesSecondaryType

FailoverGroupReadOnlyEndpoint

FailoverGroupReadWriteEndpoint

FailoverGroupReplicationRole

PartnerInfo

ReadOnlyEndpointFailoverPolicy

ReadWriteEndpointFailoverPolicy