Instance Failover Groups - List By Location

위치에 있는 장애 조치(failover) 그룹을 나열합니다.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/locations/{locationName}/instanceFailoverGroups?api-version=2021-11-01

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
locationName
path True

string

리소스가 있는 지역의 이름입니다.

resourceGroupName
path True

string

리소스를 포함하는 리소스 그룹의 이름입니다. Azure 리소스 관리자 API 또는 포털에서 이 값을 가져올 수 있습니다.

subscriptionId
path True

string

Azure 구독을 식별하는 구독 ID입니다.

api-version
query True

string

요청에 사용할 API 버전입니다.

응답

Name 형식 Description
200 OK

InstanceFailoverGroupListResult

장애 조치(failover) 그룹을 성공적으로 검색했습니다.

Other Status Codes

오류 응답: ***

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidPrimary - 장애 조치(failover) 그룹 요청 본문에 instance 만들기 또는 업데이트의 지정된 기본 필드가 비어 있거나 유효하지 않습니다.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidPartner - 장애 조치(failover) 그룹 요청 본문에 instance 만들기 또는 업데이트의 지정된 파트너 필드가 비어 있거나 유효하지 않습니다.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestDuplicatePartner - 제공된 파트너 서버 중 하나 이상이 이미 instance 장애 조치(failover) 그룹의 일부입니다. 주 서버와 지정된 모든 파트너 서버가 고유한지 확인하세요.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidManagedInstanceRegion - instance 장애 조치(failover) 그룹 요청 본문에서 제공된 파트너 관리 instance 지역이 비어 있거나 유효하지 않습니다.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestUnsupportedPartnerCount - 하나의 파트너 지역만 지원됩니다.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestUnsupportedPairCount - 관리되는 instance 쌍 하나만 지원됩니다.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpoint - readWriteEndpoint 필드는 요청을 만들거나 업데이트하는 데 필요합니다.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalid - 장애 조치(failover) 그룹 요청 본문에 instance 만들기 또는 업데이트가 비어 있거나 유효하지 않습니다.

  • 400 InstanceFailoverGroupUpdateOrDeleteRequestOnSecondary - 보조 서버에서 instance 장애 조치(failover) 그룹을 수정할 수 없습니다. 주 서버에서 요청을 실행합니다.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestNegativeGracePeriodValues - 읽기-쓰기 엔드포인트에 대한 유예 기간 값은 음수가 아니어야 합니다.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestLessThanMinimumGracePeriodValues - instance 장애 조치(failover) 그룹의 유예 기간 값은 '{0}' 분 최소 유예 기간보다 크거나 같아야 합니다.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFields - 읽기-쓰기 엔드포인트에 대해 장애 조치(failover) 정책 자동이 선택될 때 장애 조치(failover)WithDataLossGracePeriodMinutes 속성을 제공해야 합니다.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteFailoverPolicy - 읽기-쓰기 엔드포인트에 대한 failoverPolicy 필드는 요청을 만들거나 업데이트하는 데 필요합니다.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFieldsForManualPolicy - 읽기-쓰기 엔드포인트에 대해 장애 조치 정책 수동을 선택한 경우 유예 기간 값을 제공하지 않아야 합니다.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestReadOnlyPropertyModified - 장애 조치(failover) 그룹 요청 본문에 instance 만들기 또는 업데이트는 읽기 전용 속성 ''{0}을 수정하면 안 됩니다.

  • 400 InstanceFailoverGroupFailoverRequestOnPrimary - 장애 조치(failover) 요청은 instance 장애 조치(failover) 그룹의 보조 서버에서 시작되어야 합니다.

  • 400 InstanceFailoverGroupPartnerManagedInstanceFromDifferentSubscription - 기본 서버 및 장애 조치(failover) 그룹의 파트너 서버는 서로 다른 구독에서 온 것입니다. 장애 조치(failover) 그룹의 서버에 대한 교차 구독은 허용되지 않습니다.

  • 400 FailoverGroupRegionMismatch - 장애 조치(failover) 그룹에 지정된 파트너 지역은 표시된 파트너 관리 instance 지역과 일치해야 합니다.

  • 400 ServerEditionMismatch - 버전은 복제본(replica) 서버를 만들 때 주 서버와 동일해야 합니다.

  • 400 DnsZoneMismatch - 파트너 서버의 DNSZone은 원본 서버의 DNSZone과 다릅니다. 그러면 InstanceFailoverGroup 기능이 중단됩니다.

  • 400 InvalidTargetSubregion - 읽을 수 없는 보조 데이터베이스의 대상 서버가 DR 쌍을 이루는 Azure 지역에 있지 않습니다.

  • 400 GeoDrInstanceSizeMismatch - 기본 관리 instance 및 파트너 관리 instance 스토리지 크기가 동일하지 않습니다.

  • 400 SecurityAdalPrincipalCertExpiredError - Azure Key Vault 보안 주체 인증서가 만료되어 작업을 완료할 수 없습니다.

  • 400 GeoDrSecondaryInstanceNotEmpty - 보조 관리되는 instance 사용자 데이터베이스가 있습니다. instance 장애 조치(failover) 그룹을 만들려면 보조 관리 instance 비워야 합니다.

  • 400 InstanceFailoverGroupIncorrectNetworkingConfiguration - 네트워킹 구성이 잘못되었습니다. 주 서버의 복제 트래픽이 보조 서버에 연결할 수 없습니다.

  • 400 IncorrectReplicationLinkState - 작업에서는 데이터베이스가 복제 링크에서 예상되는 상태일 것으로 예상합니다.

  • 400 SecurityInvalidAzureKeyVaultRecoveryLevel - 제공된 Key Vault URI가 잘못되었습니다.

  • 400 KeyMaterialNotFoundOnRemoteServer - 원격 서버는 TDE 보호기로 사용되는 키 자료에 액세스할 수 없습니다.

  • 400 AzureKeyVaultRsaKeyNotSupported - 제공된 키 자격 증명 모음은 지원되지 않는 RSA 키 크기 또는 키 형식을 사용합니다. 지원되는 RSA 키 크기는 2048 또는 3072이고 키 유형은 RSA 또는 RSA-HSM입니다.

  • 400 UnableToResolveRemoteServer - 잘못된 서버 이름 또는 DNS 연결 문제로 인해 원격 파트너 서버 이름을 확인할 수 없습니다.

  • 400 SameKeyUriNotFoundOnRemoteServer - 보조 서버에는 키 자동 회전이 사용하도록 설정된 주 서버의 암호화 보호기와 동일한 키 자격 증명 모음의 키 자료가 없습니다.

  • 400 RemoteDatabaseCopyPermission - 사용자에게 지정된 서버에 데이터베이스 복사본을 만들 수 있는 충분한 권한이 없습니다.

  • 400 SameKeyMaterialNotFoundOnRemoteServer - 보조 서버에는 주 서버의 암호화 보호기의 키 자료가 없습니다.

  • 400 CannotUseReservedDatabaseName - 이 작업에서 예약된 데이터베이스 이름을 사용할 수 없습니다.

  • 400 InvalidFailoverGroupRegion - 인스턴스 장애 조치(failover) 그룹에 지정된 서버는 격리를 제공하기 위해 다른 지역에 있어야 합니다.

  • 400 InstanceFailoverGroupDoesNotExist - 장애 조치(failover) 그룹이 서버에 없습니다.

  • 400 InstanceFailoverGroupNotSecondary - 장애 조치(failover)는 instance 장애 조치(failover) 그룹의 주 서버에서 시작할 수 없습니다.

  • 400 InvalidServerName - 잘못된 서버 이름이 지정되었습니다.

  • 400 InvalidIdentifier - 식별자에 NULL 또는 잘못된 유니코드 문자가 포함되어 있습니다.

  • 400 TokenTooLong - 제공된 토큰이 너무 깁니다.

  • 400 AzureKeyVaultKeyDisabled - Azure Key Vault 키가 비활성화되어 서버에서 작업을 완료할 수 없습니다.

  • 400 AzureKeyVaultInvalidExpirationDate - Azure Key Vault 키 만료 날짜가 잘못되어 작업을 완료할 수 없습니다.

  • 400 SecurityAzureKeyVaultUrlNullOrEmpty - Azure Key Vault Uri가 null이거나 비어 있으므로 작업을 완료할 수 없습니다.

  • 400 InvalidSku - 사용자가 잘못된 sku를 지정했습니다.

  • 400 InvalidAddSecondaryPermission - 사용자에게 지정된 서버에 보조를 추가할 수 있는 충분한 권한이 없습니다.

  • 400 ServerNotFound - 요청된 서버를 찾을 수 없습니다.

  • 400 AzureKeyVaultNoServerIdentity - 서버 ID가 올바르게 구성되지 않았습니다.

  • 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 GeoReplicationDatabaseNotSecondary - 이 작업은 데이터베이스가 복제 대상이 될 것으로 예상합니다.

  • 400 AdalServicePrincipalNotFound - Azure Active Directory 라이브러리 서비스 주체를 찾을 수 없는 오류가 발생하여 작업을 완료할 수 없습니다.

  • 400 AzureKeyVaultMalformedVaultUri - 제공된 Key Vault URI가 잘못되었습니다.

  • 400 FeatureDisabledOnSelectedEdition - 사용자가 현재 데이터베이스 버전에서 사용하지 않도록 설정된 기능을 사용하려고 했습니다.

  • 404 ResourceNotFound - 요청된 리소스를 찾을 수 없습니다.

  • 404 SourceDatabaseNotFound - 원본 데이터베이스가 없습니다.

  • 404 ServerNotInSubscription - 지정된 서버가 지정된 구독에 없습니다.

  • 404 ServerNotInSubscriptionResourceGroup - 지정된 서버가 지정된 리소스 그룹 및 구독에 없습니다.

  • 405 UnsupportedReplicationOperation - 데이터베이스에서 지원되지 않는 복제 작업이 시작되었습니다.

  • 409 ManagedInstanceHasHybridLink - 관리되는 instance 하이브리드 링크가 구성된 경우 지원되지 않는 작업을 시작하려고 했습니다.

  • 409 RemoteDatabaseExists - 대상 데이터베이스 이름이 대상 서버에 이미 있습니다.

  • 409 ConflictingServerOperation - 서버에 대한 작업이 현재 진행 중입니다.

  • 409 SubscriptionDisabled - 구독을 사용할 수 없습니다.

  • 409 InstanceFailoverGroupAlreadyExists - 장애 조치(failover) 그룹이 지정된 서버에 이미 있습니다.

  • 409 InstanceFailoverGroupBusy - 인스턴스 장애 조치(failover) 그룹이 다른 작업으로 사용 중입니다.

  • 409 GeoReplicationCannotBecomePrimaryDuringUndo - 보조 데이터베이스가 물리적으로 일관되지 않아 주 역할을 입력할 수 없는 상태에 있는 동안 사용자가 지역 링크를 장애 조치(failover)하거나 강제로 종료하려고 했습니다.

  • 409 InstanceFailoverGroupDnsRecordInUse - 요청된 엔드포인트에 대해 중복 DNS 레코드가 있습니다.

  • 409 ServerKeyNameAlreadyExists - 서버 키가 서버에 이미 있습니다.

  • 409 ServerKeyUriAlreadyExists - 서버 키 URI가 서버에 이미 있습니다.

  • 409 ServerKeyDoesNotExists - 서버 키가 없습니다.

  • 409 InvalidFailoverGroupName - 잘못된 인스턴스 장애 조치(failover) 그룹 이름이 제공되었습니다.

  • 409 UpdateSloInProgress - 사용자가 SLO 업데이트가 진행되는 동안 호환되지 않는 작업을 시작하려고 했습니다.

  • 409 AzureKeyVaultKeyNameNotFound - Azure Key Vault 키 이름이 없으므로 작업을 완료할 수 없습니다.

  • 409 AzureKeyVaultKeyInUse - 현재 서버에서 키를 사용하고 있습니다.

  • 409 ConflictingSystemOperationInProgress - 데이터베이스에서 시스템 유지 관리 작업이 진행 중이며 추가 작업이 완료될 때까지 기다려야 합니다.

  • 409 InvalidOperationForDatabaseNotInReplicationRelationship - 복제 관계에 이미 있는 데이터베이스에서 복제 시드 작업이 수행되었습니다.

  • 409 InvalidDatabaseStateForOperation - 현재 복제 상태의 데이터베이스에서 작업이 허용되지 않습니다.

  • 409 DuplicateGeoDrRelation - 데이터베이스가 이미 복제 관계에 있습니다. 중복된 요청입니다.

  • 429 SubscriptionTooManyCreateUpdateRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.

  • 429 SubscriptionTooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.

  • 503 TooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.

  • 503 AzureKeyVaultConnectionFailed - Azure Key Vault 연결 시도가 실패했기 때문에 서버에서 작업을 완료할 수 없습니다.

  • 503 AzureKeyVaultGenericConnectionError - Key Vault 정보를 검색하려고 할 때 오류가 발생하여 작업을 완료할 수 없습니다.

  • 504 RequestTimeout - 서비스 요청이 허용된 시간 제한을 초과했습니다.

예제

List failover group

Sample Request

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/Japan East/instanceFailoverGroups?api-version=2021-11-01

Sample Response

{
  "value": [
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/JapanEast/instanceFailoverGroups/failover-group-test",
      "name": "failover-group-test",
      "type": "Microsoft.Sql/locations/instanceFailoverGroups",
      "properties": {
        "readWriteEndpoint": {
          "failoverPolicy": "Automatic",
          "failoverWithDataLossGracePeriodMinutes": 480
        },
        "readOnlyEndpoint": {
          "failoverPolicy": "Disabled"
        },
        "replicationRole": "Primary",
        "replicationState": "CATCH_UP",
        "partnerRegions": [
          {
            "location": "Japan West",
            "replicationRole": "Secondary"
          }
        ],
        "managedInstancePairs": [
          {
            "primaryManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-primary-mngdInstance",
            "partnerManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-secondary-mngdInstance"
          }
        ]
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/JapanEast/instanceFailoverGroups/failover-group-test-1",
      "name": "failover-group-test-1",
      "type": "Microsoft.Sql/locations/instanceFailoverGroups",
      "properties": {
        "readWriteEndpoint": {
          "failoverPolicy": "Automatic",
          "failoverWithDataLossGracePeriodMinutes": 480
        },
        "readOnlyEndpoint": {
          "failoverPolicy": "Disabled"
        },
        "replicationRole": "Primary",
        "replicationState": "CATCH_UP",
        "partnerRegions": [
          {
            "location": "Japan West",
            "replicationRole": "Secondary"
          }
        ],
        "managedInstancePairs": [
          {
            "primaryManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-primary-mngdInstance-1",
            "partnerManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-secondary-mngdInstance-1"
          }
        ]
      }
    }
  ]
}

정의

Name Description
InstanceFailoverGroup

instance 장애 조치(failover) 그룹입니다.

InstanceFailoverGroupListResult

instance 장애 조치(failover) 그룹 목록입니다.

InstanceFailoverGroupReadOnlyEndpoint

장애 조치(failover) 그룹의 읽기 전용 엔드포인트가 instance.

InstanceFailoverGroupReadWriteEndpoint

장애 조치(failover) 그룹의 읽기-쓰기 엔드포인트 instance.

InstanceFailoverGroupReplicationRole

장애 조치(failover) 그룹의 로컬 복제 역할 instance.

ManagedInstancePairInfo

장애 조치(failover) 그룹의 Managed Instance 쌍입니다.

PartnerRegionInfo

장애 조치(failover) 그룹에 대한 파트너 지역 정보입니다.

ReadOnlyEndpointFailoverPolicy

장애 조치(failover) 그룹에 대한 읽기 전용 엔드포인트의 장애 조치(failover) 정책입니다.

ReadWriteEndpointFailoverPolicy

장애 조치(failover) 그룹에 대한 읽기-쓰기 엔드포인트의 장애 조치(failover) 정책입니다. failoverPolicy가 자동인 경우 failoverWithDataLossGracePeriodMinutes가 필요합니다.

InstanceFailoverGroup

instance 장애 조치(failover) 그룹입니다.

Name 형식 Description
id

string

리소스 ID입니다.

name

string

리소스 이름입니다.

properties.managedInstancePairs

ManagedInstancePairInfo[]

장애 조치(failover) 그룹의 관리되는 instance 쌍 목록입니다.

properties.partnerRegions

PartnerRegionInfo[]

장애 조치(failover) 그룹에 대한 파트너 지역 정보입니다.

properties.readOnlyEndpoint

InstanceFailoverGroupReadOnlyEndpoint

장애 조치(failover) 그룹의 읽기 전용 엔드포인트가 instance.

properties.readWriteEndpoint

InstanceFailoverGroupReadWriteEndpoint

장애 조치(failover) 그룹의 읽기-쓰기 엔드포인트 instance.

properties.replicationRole

InstanceFailoverGroupReplicationRole

장애 조치(failover) 그룹의 로컬 복제 역할 instance.

properties.replicationState

string

장애 조치(failover) 그룹 instance 복제 상태입니다.

type

string

리소스 종류.

InstanceFailoverGroupListResult

instance 장애 조치(failover) 그룹 목록입니다.

Name 형식 Description
nextLink

string

연결하여 결과의 다음 페이지를 검색합니다.

value

InstanceFailoverGroup[]

결과 배열입니다.

InstanceFailoverGroupReadOnlyEndpoint

장애 조치(failover) 그룹의 읽기 전용 엔드포인트가 instance.

Name 형식 Description
failoverPolicy

ReadOnlyEndpointFailoverPolicy

장애 조치(failover) 그룹에 대한 읽기 전용 엔드포인트의 장애 조치(failover) 정책입니다.

InstanceFailoverGroupReadWriteEndpoint

장애 조치(failover) 그룹의 읽기-쓰기 엔드포인트 instance.

Name 형식 Description
failoverPolicy

ReadWriteEndpointFailoverPolicy

장애 조치(failover) 그룹에 대한 읽기-쓰기 엔드포인트의 장애 조치(failover) 정책입니다. failoverPolicy가 자동인 경우 failoverWithDataLossGracePeriodMinutes가 필요합니다.

failoverWithDataLossGracePeriodMinutes

integer

데이터 손실이 있는 장애 조치(failover) 전 유예 기간은 읽기-쓰기 엔드포인트에 대해 시도됩니다. failoverPolicy가 자동인 경우 failoverWithDataLossGracePeriodMinutes가 필요합니다.

InstanceFailoverGroupReplicationRole

장애 조치(failover) 그룹의 로컬 복제 역할 instance.

Name 형식 Description
Primary

string

Secondary

string

ManagedInstancePairInfo

장애 조치(failover) 그룹의 Managed Instance 쌍입니다.

Name 형식 Description
partnerManagedInstanceId

string

파트너 Managed Instance ID입니다.

primaryManagedInstanceId

string

쌍으로 된 기본 Managed Instance ID입니다.

PartnerRegionInfo

장애 조치(failover) 그룹에 대한 파트너 지역 정보입니다.

Name 형식 Description
location

string

파트너 관리되는 인스턴스의 지리적 위치입니다.

replicationRole

InstanceFailoverGroupReplicationRole

파트너 관리되는 인스턴스의 복제 역할입니다.

ReadOnlyEndpointFailoverPolicy

장애 조치(failover) 그룹에 대한 읽기 전용 엔드포인트의 장애 조치(failover) 정책입니다.

Name 형식 Description
Disabled

string

Enabled

string

ReadWriteEndpointFailoverPolicy

장애 조치(failover) 그룹에 대한 읽기-쓰기 엔드포인트의 장애 조치(failover) 정책입니다. failoverPolicy가 자동인 경우 failoverWithDataLossGracePeriodMinutes가 필요합니다.

Name 형식 Description
Automatic

string

Manual

string