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

Distributed Availability Groups - Update

汇报分布式可用性组复制模式。

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/distributedAvailabilityGroups/{distributedAvailabilityGroupName}?api-version=2021-11-01

URI 参数

名称 必需 类型 说明
distributedAvailabilityGroupName
path True

string

分布式可用性组名称。

managedInstanceName
path True

string

托管实例的名称。

resourceGroupName
path True

string

包含该资源的资源组名称。 可以从 Azure 资源管理器 API 或门户获取此值。

subscriptionId
path True

string

用于标识 Azure 订阅的订阅 ID。

api-version
query True

string

要用于请求的 API 版本。

请求正文

名称 类型 说明
properties.primaryAvailabilityGroupName

string

主要可用性组名称

properties.replicationMode

ReplicationMode

分布式可用性组的复制模式。 链接创建期间将忽略参数。

properties.secondaryAvailabilityGroupName

string

辅助可用性组名称

properties.sourceEndpoint

string

源终结点

properties.targetDatabase

string

目标数据库的名称

响应

名称 类型 说明
200 OK

DistributedAvailabilityGroup

已成功启动分布式可用性组复制模式更新。

202 Accepted

已接受更新分布式可用性组复制模式的请求。

Other Status Codes

错误响应: ***

  • 400 NameAlreadyExists - 提供的名称已存在。

  • 400 InvalidCollation - 排序规则无效。

  • 400 ProvisioningDisabled - 按原样显示来自资源操作授权者的错误消息,不需更改

  • 400 RegionDoesNotAllowProvisioning - 所选位置不接受新的 Windows Azure SQL数据库服务器。 这可能会在以后更改。

  • 400 UnableToResolveRemoteServer - 由于服务器名称无效或 DNS 连接问题,无法解析远程合作伙伴服务器名称。

  • 400 HkCannotSwitchToInactive - 数据库无法继续进行定价层更新,因为它具有内存优化对象。 请删除此类对象,然后重试。

  • 400 TokenTooLong - 提供的令牌太长。

  • 400 CloudLifterUnsupportedFeature - 此功能目前在托管实例上不可用。

  • 400 ManagedInstanceSloUpdateFailed - SLO“{0}”操作无法成功,因为“”{1}的内存使用量超过配额。

  • 400 OperationCanNotStartDueToMiLink - 无法完成“”{0}操作,因为通过托管实例链接创建过程中存在数据库。 请等待链接创建完成或删除链接,然后重试该操作。

  • 400 ManagedInstanceLocalStorageUpdateSloDisabled - 尚不支持使用本地存储更新托管实例的 SLO。

  • 400 InvalidSubnetResourceId - 为托管实例创建或更新提供的子网资源 ID 无效。

  • 400 VnetInWrongRegion - 虚拟网络位于错误区域。

  • 400 AlterDbDeactivatedNotSupported - 由于意外延迟,服务器“”、“{0}数据库”{1}的数据库操作失败。 请重试。

  • 400 VnetAddressRangeError - 虚拟网络地址范围无效。

  • 400 RegionDoesNotSupportVersion - 用户尝试在不支持该服务器版本的位置创建指定版本的服务器。

  • 400 VnetConfigIsNotAllowed - 不允许虚拟网络配置。

  • 400 InstanceFailoverGroupDoesNotExist - 服务器上不存在故障转移组。

  • 400 ManagedInstanceClassicVnetNotSupported - 托管实例无法加入经典虚拟网络。

  • 400 VnetConfigHasNsg - 用户尝试使用网络安全组注入托管服务器子网。

  • 400 VnetConfigHasNoUdr - 用户尝试在没有默认用户定义路由表的情况下注入托管服务器子网。

  • 400 VnetConfigHasInvalidUdr - 用户尝试注入用户定义路由表无效的托管服务器子网。

  • 400 VnetConfigHasInvalidDns - 用户尝试使用无效的自定义 DNS 注入托管服务器子网。

  • 400 VnetConfigHasServiceEndpoints - 用户尝试使用服务终结点注入托管服务器子网。

  • 400 VnetSubnetIsInUse - 用户尝试注入不为空的托管服务器子网。

  • 400 VnetSubnetIsLocked - 用户尝试注入锁定范围内的托管服务器子网。

  • 400 VnetSubnetIsGateway - 用户尝试注入网关子网的托管服务器子网。

  • 400 VnetSubnetIsUnknown - 用户尝试注入不存在的托管服务器子网。

  • 400 VnetSubnetConflictWithIntendedPolicy - 用户尝试注入与 IntendedPolicy 冲突的托管服务器子网。

  • 400 ManagedInstanceInvalidEditionForSku - 指定的版本 {0} 与指定的 SKU {1}不一致。

  • 400 ManagedInstanceInvalidLicenseType - 指定的许可证类型 {0} 无效。

  • 400 ManagedInstanceUpdateSloInProgress - “由于托管实例的服务层正在更改,因此无法完成操作。{0}” 请等待正常执行的操作完成,然后重试。”

  • 400 VnetResourceNotFound - 找不到资源:“{0}”。

  • 400 InstanceCollationUpdateNotSupported - 用户无法更改托管实例上的实例排序规则。

  • 400 CreateManagedInstanceWithNonDefaultCollationNotSupported - 用户只能使用排序规则“SQL_Latin1_General_CP1_CI_AS”创建托管实例。

  • 400 ManagedInstanceOperationInProgress - 操作无法完成,因为 {0} 操作正在进行中。 请等待正在进行的操作完成,然后重试。

  • 400 ManagedInstanceExceedMaxAzureStorage - 无法完成该操作,因为常规用途实例的总分配存储大小将超过 {0}。 请减少数据库文件数并重试操作。

  • 400 ManagedInstanceHasGeoReplica - 无法完成操作,因为实例已配置异地复制辅助实例。

  • 400 InvalidDnsZone - 操作失败,因为尝试将托管实例作为异地复制辅助数据库部署到已存在托管实例的子网 {0} 。 仅当托管实例是子网中部署的第一个实例时,才支持将托管实例部署为异地复制辅助实例。 请考虑将托管实例作为异地复制辅助部署到没有现有托管实例的其他子网,或者如果部署到具有现有托管实例的子网,请禁用异地复制选项。

  • 400 ManagedInstanceInvalidStorageSizeLessThenCurrentSizeUsed - 无效存储大小:存储大小限制 ({0} GB) 小于当前 (GB) 使用的 {1} 存储。 请指定更高的存储大小限制。

  • 400 InvalidTimezone - 时区无效。

  • 400 InstanceTimezoneUpdateNotSupported - 不支持实例时区更新。

  • 400 CreateManagedInstanceWithNonDefaultTimezoneNotSupported - 不支持使用非默认时区创建托管实例。

  • 400 ManagedInstanceIpAddressRangeLimit - 无法执行托管实例的创建/缩放,因为子网中没有足够的可用 IP 地址来执行操作。

  • 400 VnetDelegationNotAllowed - 用户尝试将托管服务器注入委托的子网。

  • 400 SubnetHasResourcesOfDifferentType - 用户尝试在具有不同类型资源的子网中创建 MI。

  • 400 UpdateManagedServerWithMaintenanceWindowNotAllowed - 不允许使用维护时段设置更新托管实例。

  • 400 VnetPrepareNIPFailed - 用户尝试准备与 NetworkIntentPolicy 冲突的子网。

  • 400 ManagedInstanceDeprecatedHardwareFamily - 无法将硬件代系更改为已弃用 {0} 的代系。

  • 400 ManagedInstanceBackupStorageTypeNotSupported - 实例更新操作中不允许使用备份存储类型参数。

  • 400 EmptyPDCInvalidDnsZone - 无法部署此托管实例,因为其 DNS 区域与子网 {0}的预期虚拟群集的 DNS 前缀不匹配。 尽管此虚拟群集为空,但无法更改其 DNS 前缀。 空的虚拟群集将在几个小时后自动删除。 请考虑等待此虚拟群集过期或手动删除此虚拟群集,然后创建托管实例。

  • 400 MissingIdentityId - 将标识类型设置为 UserAssigned 时,不会提供用户分配的标识

  • 400 InvalidPrimaryIdentityId - 用户为 PrimaryUserIdentityId 提供值,但 IdentityId 参数中未列出该值

  • 400 ManagedInstanceZoneRedudantFeatureNotSupported - 所选服务层不支持 ZoneRedundant 功能。 有关详细信息,请访问 aka.ms/sqlmi-service-tier-characteristics。

  • 400 ManagedInstanceZoneRedudantFeatureCantBeEnabled - 创建托管实例后,无法启用 zoneRedundant 功能。 有关更多详细信息,请访问 aka.ms/sqlmi-high-availability。

  • 400 ManagedInstanceZoneRedudantFeatureCantBeDisabled - 创建托管实例后,无法禁用 zoneRedundant 功能。 有关更多详细信息,请访问 aka.ms/sqlmi-high-availability。

  • 400 UmiMissingAkvPermissions - 用户提供的 PrimaryUserAssignedIdentityId 无权访问提供的 KeyId

  • 400 MissingPrimaryIdentity - 用户提供的 PrimaryUserAssignedIdentityId 无权访问提供的 KeyId

  • 400 SubnetIdCantBeUpdated - 不支持更改托管实例子网的操作。 请从请求中删除此参数。

  • 400 MigrationToAnotherVNetNotSupported - 所选子网位于另一个虚拟网络。 无法将托管实例移到另一个虚拟网络。 请提供 虚拟网络 {0}中的子网。

  • 400 MigrationToSubnetWithDifferentDnsZoneNotSupported - 提供的子网具有与当前不同的 DNS 区域。 不支持更改实例 DNS 区域。 请为子网提供同一 DNS 区域,创建新子网或提供空子网。

  • 400 MigrationToGen4SubnetNotSupported - 无法在 Gen4 硬件上运行时更新子网,因为它已被弃用。 请在更改托管实例子网操作过程中通过同时指定这两个参数(目标子网和硬件生成)将硬件从 Gen4 升级到 Gen5。

  • 400 PrimaryIdentityMissingPermissionForKeyId - KeyId 在创建过程中由用户提供,但在 API 调用中未提供 PrimaryUserAssignedIdentityId

  • 400 InvalidIdentityTypeForKeyId - KeyId 在创建过程中由用户提供,但标识类型未设置为“UserAssigned”

  • 400 ServerNotFound - 找不到请求的服务器。

  • 400 ManagedInstanceFileExceededMaxAzureStorageFileSizeLimit - 无法完成操作,因为某些数据库文件超出最大常规用途文件大小限制 GB{0}。

  • 400 ManagedInstanceStoppingOrStopped - 实例处于停止/停止状态时提交的冲突操作

  • 400 ManagedInstanceStarting - 实例处于启动状态时提交的冲突操作

  • 400 InstancePoolNotEnoughCapacity - 实例池没有足够的容量

  • 400 SourceAndTargetSubnetsMustBeVnetPeered - 托管实例当前使用的子网和提供的目标子网是未与虚拟网络对等互连连接的虚拟网络的一部分,或者已建立对等互连但不允许的流量。 若要将托管实例从一个子网移到另一个子网,需要从源虚拟网络和目标虚拟网络建立虚拟网络对等互连。 请配置虚拟网络要求,然后重试该操作。 了解详细信息 https://docs.microsoft.com/en-us/azure/virtual-network/tutorial-connect-virtual-networks-portal#peer-virtual-networks

  • 400 ManagedInstanceAndSubnetAreNotOnTheSameSubscription - 为托管实例部署提供的子网位于与为托管实例提交的订阅不同的订阅上。 用于部署实例的托管实例和子网必须位于同一订阅中。 请提供另一个子网或切换到子网订阅,然后再次尝试该操作。

  • 400 CreateManagedInstanceInvalidSubnetSize - 用户尝试在小于允许的最小子网大小的子网中创建托管实例。

  • 400 AddressRangeOfTargetSubnetAndSubnetOfGeoDRReplicaCantOverlap - 为托管实例迁移选择的子网的地址范围与保存异地复制辅助实例的子网的地址范围重叠。 请验证子网是否已根据 中的 https://aka.ms/move-managed-instance准则进行配置。

  • 400 TargetSubnetMustBeConfiguredToAllowGeoDRReplication - 选择用于托管实例迁移的子网未配置为启用与异地复制的辅助实例的通信。 如果所有必需的端口都已打开,请检查。 若要正确配置子网,请阅读 中的 https://aka.ms/move-managed-instance准则。

  • 400 InvalidIdentifier - 标识符包含 NULL 或无效的 unicode 字符。

  • 400 InvalidLoginName - 提供的登录名无效。

  • 400 InvalidUsername - 提供的用户名包含无效字符。

  • 400 PasswordTooShort - 提供的密码太短

  • 400 PasswordTooLong - 提供的密码太长。

  • 400 PasswordNotComplex - 提供的密码不够复杂。

  • 400 GatewayInvalidEdition - 在此版本的 SQL Server 中,“”{0}不是有效的数据库版本。

  • 400 InvalidLocation - 指定了无效的位置。

  • 400 InvalidParameterValue - 为参数提供了无效值。

  • 400 InvalidServerName - 指定的服务器名称无效。

  • 400 PitrPointInTimeInvalid - 时间 {0} 点无效。 有效时间点范围为 {1} 早日到现在,而不是在源服务器创建时间之前。

  • 400 CannotUseTrailingWhitespacesInDatabaseName - 数据库名称验证失败。

  • 400 StorageAccountFull - 托管实例已达到基础 Azure 存储帐户的总容量。 Azure 高级存储帐户的分配空间限制为 35TB。

  • 400 AkvHostNotResolvingFromNode - 无法从服务器“”{0}上的 SQL 解析 AKV 主机“”。{1}

  • 400 InvalidBackupRetentionPeriod - 的保留天数 {0} 不是有效的配置。 有效的备份保留期(以天为单位)必须介于 和 之间{1}{2}

  • 400 ManagedDatabaseNameInUse - 数据库“”{0}已存在。 请选择其他数据库名称。

  • 400 NoMoreSpaceInManagedInstance - 托管实例已达到其存储限制。 托管实例的存储使用量不能超过 (%d) MB。

  • 400 ManagedInstanceUpdateSloInProgress - “无法完成操作,因为正在对托管实例'{0}'进行服务层级更改。' 请等待正常执行的操作完成,然后重试。”

  • 400 SameKeyMaterialNotFoundOnRemoteServer - 辅助服务器没有主服务器的加密保护程序的密钥材料。

  • 400 SourceDatabaseNotFound - 源数据库不存在。

  • 400 RegionDoesNotSupportVersion - 用户尝试在不支持该服务器版本的位置创建指定版本的服务器。

  • 400 PasswordNotComplex - 提供的密码不够复杂。

  • 400 CannotUseReservedDatabaseName - 此操作中无法使用保留的数据库名称。

  • 400 InvalidServerName - 指定的服务器名称无效。

  • 400 SourceServerNotFound - CreateDatabaseAsCopy API 调用中提供的源数据库 ID 的服务器部分不会映射到现有服务器。

  • 400 TokenTooLong - 提供的令牌太长。

  • 400 CurrentDatabaseSizeExceedsMaxSize - 用户尝试将数据库的最大大小减小到小于当前使用情况的大小。

  • 400 InvalidCollation - 服务器无法识别排序规则。

  • 400 AkvEndpointNotReachableFromNode - 服务器“”{0}上的 SQL 无法访问 AKV 终结点“”。{1}

  • 400 ServerNotFound - 找不到请求的服务器。

  • 400 UnsupportedServiceName - 指定的名称是无效名称,因为它包含一个或多个不受支持的 unicode 字符。

  • 400 CurrentDatabaseLogSizeExceedsMaxSize - 用户尝试将数据库更改为最大日志大小低于当前使用情况的 SKU。

  • 400 DatabaseNumberLimitReached - 达到SQL 数据库 托管实例的最大数据库数。

  • 400 CannotUseReservedDatabaseName - 此操作中无法使用保留的数据库名称。

  • 404 ResourceNotFound - 找不到请求的资源。

  • 404 SubscriptionDoesNotHaveServer - 找不到请求的服务器

  • 404 ServerNotInSubscriptionResourceGroup - 指定的服务器不存在于指定的资源组和订阅中。

  • 404 OperationIdNotFound - ID 为 的操作不存在。

  • 404 ResourceDoesNotExist - 名称为“”{0}的资源不存在。 若要继续,请指定有效的资源名称。

  • 404 InstancePoolNotFound - 找不到实例池

  • 404 SubscriptionNotFound - 找不到请求的订阅。

  • 404 CannotFindServerCertificateWithThumbprint - 找不到指纹为“”{0}的服务器证书。 请使用 PowerShell Cmdlet“Add-AzureRmSqlManagedInstanceTransparentDataEncryptionCertificate”创建证书。

  • 404 CannotFindObject - 找不到对象,因为它不存在或您没有权限

  • 404 SubscriptionNotFound - 找不到请求的订阅。

  • 404 DatabaseDoesNotExist - 用户已指定此服务器实例上不存在的数据库名称。

  • 404 ServerNotInSubscription - 指定的服务器不存在于指定的订阅中。

  • 404 RestoreSourceDatabaseNotFound - 在“”{0}时找不到可还原的数据库“{1}”。

  • 404 ServerNotInSubscriptionResourceGroup - 指定的服务器不存在于指定的资源组和订阅中。

  • 405 InvalidVcoreValue - vCore 值 {0} 无效。 请指定有效的 vCore 值。

  • 405 InvalidHardwareGenerationValue - HardwareGeneration {0} 无效。 请指定有效的 HardwareGeneration 值。

  • 405 InvalidStorageSizeValue - “无效的存储大小: {0} GB。 必须在 和 {2} GB 之间{1}指定存储大小,以 GB 为{3}增量。

  • 409 OperationCancelled - 用户已取消操作。

  • 409 操作中断 - 无法完成对资源的操作,因为同一资源上的另一个操作中断了该操作。

  • 409 ConflictingServerOperation - 服务器当前正在进行操作。

  • 409 SubscriptionDisabled - 订阅已禁用。

  • 409 ServerOverridePreconditionFailed - 无法对类别“”{0}应用服务器替代,因为服务器“”{1}中的物理数据库或实例“”{2}当前未处于“就绪”或“已停用”状态。

  • 409 ManagedInstanceIsBusy - 服务器“”{0}当前正忙。 请等待几分钟,并重试。

  • 409 ServerAlreadyExists - 重复的服务器名称。

  • 409 ServerDisabled - 服务器已禁用。

  • 409 ServerQuotaExceeded - 服务器无法添加到订阅,因为它将超过配额。

  • 409 RemoteDatabaseExists - 目标服务器上已存在目标数据库名称。

  • 409 冲突的DatabaseOperation - 数据库上已经有一些操作,当前操作应等到操作完成。

  • 409 SubscriptionDisabled - 订阅已禁用。

  • 409 ManagementServiceDatabaseBusy - 数据库“”{0}正忙于另一个操作。 请稍后尝试操作。

  • 409 ConflictingSystemOperationInProgress - 数据库上的系统维护操作正在进行中,进一步的操作需要等到它完成。

  • 429 SubscriptionTooManyCreateUpdateRequests - 超出可用资源可处理的最大请求数的请求数。

  • 429 SubscriptionTooManyRequests - 超出可用资源可处理的最大请求数的请求数。

  • 429 ConflictingSubscriptionOperation - 订阅的操作当前正在进行中。

  • 429 SubscriptionTooManyCreateUpdateRequests - 超出可用资源可处理的最大请求数的请求数。

  • 429 SubscriptionTooManyRequests - 超出可用资源可处理的最大请求数的请求数。

  • 429 SubscriptionTooManyCreateUpdateRequests - 超出可用资源可处理的最大请求数的请求数。

  • 429 SubscriptionTooManyRequests - 超出可用资源可处理的最大请求数的请求数。

  • 500 OperationTimedOut - 操作超时并自动回滚。 请重试该操作。

  • 500 GatewayInternalServerError - 服务器遇到意外异常。

  • 500 ActivateOrDeactivateWorkflowThrottling - 激活或停用工作流失败,因为并发工作流太多

  • 503 TooManyRequests - 超出可用资源可处理的最大请求数的请求数。

  • 503 TooManyRequests - 超出可用资源可处理的最大请求数的请求数。

  • 503 DatabaseUnavailable - 操作失败,因为数据库不可用。

  • 503 TooManyRequests - 超出可用资源可处理的最大请求数的请求数。

  • 504 RequestTimeout - 服务请求超出允许的超时。

  • 504 RequestTimeout - 服务请求超出允许的超时。

示例

Update the distributed availability group replication mode before deleting it.

Sample Request

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testcl/distributedAvailabilityGroups/dag?api-version=2021-11-01

{
  "properties": {
    "replicationMode": "Sync"
  }
}

Sample Response

{
  "properties": {
    "replicationMode": "Sync"
  },
  "name": "dag",
  "id": "/subscriptions/f2669dff-5f08-45dd-b857-b2a60b72cdc9/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testcl/distributedAvailabilityGroups/dag",
  "type": "Microsoft.Sql/managedInstances/distributedAvailabilityGroups"
}

定义

名称 说明
DistributedAvailabilityGroup

box 和 Sql 托管实例 之间的分布式可用性组。

ReplicationMode

分布式可用性组的复制模式。 链接创建期间将忽略参数。

DistributedAvailabilityGroup

box 和 Sql 托管实例 之间的分布式可用性组。

名称 类型 说明
id

string

资源 ID。

name

string

资源名称。

properties.distributedAvailabilityGroupId

string

分布式可用性组 ID

properties.lastHardenedLsn

string

最后一个强化的 lsn

properties.linkState

string

链接状态

properties.primaryAvailabilityGroupName

string

主要可用性组名称

properties.replicationMode

ReplicationMode

分布式可用性组的复制模式。 链接创建期间将忽略参数。

properties.secondaryAvailabilityGroupName

string

辅助可用性组名称

properties.sourceEndpoint

string

源终结点

properties.sourceReplicaId

string

源副本 (replica) ID

properties.targetDatabase

string

目标数据库的名称

properties.targetReplicaId

string

目标副本 (replica) ID

type

string

资源类型。

ReplicationMode

分布式可用性组的复制模式。 链接创建期间将忽略参数。

名称 类型 说明
Async

string

Sync

string