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

Distributed Availability Groups - List By Instance

获取实例中分布式可用性组的列表。

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/distributedAvailabilityGroups?api-version=2022-02-01-preview

URI 参数

Name In Required Type Description
managedInstanceName
path True
  • string

托管实例的名称。

resourceGroupName
path True
  • string

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

subscriptionId
path True
  • string

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

api-version
query True
  • string

要用于请求的 API 版本。

响应

Name Type Description
200 OK

已成功检索分布式可用性组的列表。

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) 小于当前使用的存储 ({1} GB) 。 请指定更高的存储大小限制。

  • 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 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 - “”{0}在此版本的 SQL Server中不是有效的数据库版本。

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

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

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

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

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

  • 404 InstancePoolNotFound - 找不到实例池

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

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

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

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

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

  • 409 SubscriptionDisabled - 已禁用订阅。

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

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

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

  • 409 ServerDisabled - 服务器已禁用。

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

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

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

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

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

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

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

示例

Lists all distributed availability groups in instance.

Sample Request

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testcl/distributedAvailabilityGroups?api-version=2022-02-01-preview

Sample Response

{
  "value": [
    {
      "properties": {
        "targetDatabase": "testdb",
        "sourceEndpoint": "TCP://SERVER:7022",
        "replicationMode": "Async",
        "distributedAvailabilityGroupId": "6bc05a51-aa36-a196-09bd-481d7a0973c0",
        "sourceReplicaId": "543dd519-7585-faff-6ad2-11fb826d4f4d",
        "targetReplicaId": "7e218aba-0a53-6231-be09-895d99f96bf2",
        "linkState": "Catchup",
        "lastHardenedLsn": "39000000030400001"
      },
      "id": "/subscriptions/f2669dff-5f08-45dd-b857-b2a60b72cdc9/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testcl/distributedAvailabilityGroups/dag",
      "name": "dag",
      "type": "Microsoft.Sql/managedInstances/distributedAvailabilityGroups"
    },
    {
      "properties": {
        "targetDatabase": "testdb2",
        "sourceEndpoint": "TCP://SERVER:7022",
        "replicationMode": "Async",
        "distributedAvailabilityGroupId": "7ec05a51-aa36-a196-09bd-481d7a0973c0",
        "sourceReplicaId": "d423d519-7585-faff-6ad2-11fb826d4f4d",
        "targetReplicaId": "32578aba-0a53-6231-be09-895d99f96bf2",
        "linkState": "Catchup",
        "lastHardenedLsn": "39000000030400001"
      },
      "id": "/subscriptions/f2669dff-5f08-45dd-b857-b2a60b72cdc9/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testcl/distributedAvailabilityGroups/dag2",
      "name": "dag2",
      "type": "Microsoft.Sql/managedInstances/distributedAvailabilityGroups"
    }
  ]
}

定义

DistributedAvailabilityGroup

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

DistributedAvailabilityGroupsListResult

实例中分布式可用性组的列表。

ReplicationMode

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

DistributedAvailabilityGroup

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

Name Type Description
id
  • string

资源 ID。

name
  • string

资源名称。

properties.distributedAvailabilityGroupId
  • string

分布式可用性组 ID

properties.lastHardenedLsn
  • string

最后一个强化 lsn

properties.linkState
  • string

链接状态

properties.primaryAvailabilityGroupName
  • string

主要可用性组名称

properties.replicationMode

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

properties.secondaryAvailabilityGroupName
  • string

辅助可用性组名称

properties.sourceEndpoint
  • string

源终结点

properties.sourceReplicaId
  • string

源副本 ID

properties.targetDatabase
  • string

目标数据库的名称

properties.targetReplicaId
  • string

目标副本 ID

type
  • string

资源类型。

DistributedAvailabilityGroupsListResult

实例中分布式可用性组的列表。

Name Type Description
nextLink
  • string

用于检索下一页结果的链接。

value

结果数组。

ReplicationMode

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

Name Type Description
Async
  • string
Sync
  • string