Failover Groups - Failover

참조

서비스:: SQL Database

API 버전:: 2023-08-01

현재 주 서버에서 이 서버로 장애 조치(fails over)합니다.

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
failoverGroupName	path	True	string	장애 조치(failover) 그룹의 이름입니다.
resourceGroupName	path	True	string	리소스를 포함하는 리소스 그룹의 이름입니다. Azure Resource Manager API 또는 포털에서 이 값을 가져올 수 있습니다.
serverName	path	True	string	장애 조치(failover) 그룹을 포함하는 서버의 이름입니다.
subscriptionId	path	True	string	Azure 구독을 식별하는 구독 ID입니다.
api-version	query	True	string	요청에 사용할 API 버전입니다.

응답

Name	형식	Description
200 OK	FailoverGroup	장애 조치(failover)가 완료되었습니다.
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 - 장애 조치(failover) 그룹 요청 본문을 만들거나 업데이트할 때 지정된 파트너 필드가 비어 있거나 잘못되었습니다. 이 필드의 유효한 값을 입력하세요. 적절한 형식의 요청 예제는 https://docs.microsoft.com/en-us/rest/api/sql/failovergroups/createorupdate 참조하세요. 400 FailoverGroupCreateOrUpdateRequestDuplicatePartner - 제공된 파트너 서버 중 하나 이상이 이미 장애 조치(failover) 그룹의 일부입니다. 주 서버와 지정된 모든 파트너 서버가 고유한지 확인하세요. 400 FailoverGroupCreateOrUpdateRequestInvalidDatabaseServer - 제공된 데이터베이스 중 하나 이상이 장애 조치(failover) 그룹의 주 서버에 존재하지 않습니다. 모든 데이터베이스가 주 서버에 있는지 확인하세요. 400 FailoverGroupCreateOrUpdateRequestUnsupportedPartnerCount - 장애 조치(failover) 그룹에 대한 하나의 파트너 서버만 지원됩니다. 그에 따라 요청을 수정하세요. 유효한 요청의 예는 https://docs.microsoft.com/en-us/rest/api/sql/failovergroups/createorupdate 참조하세요. 400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpoint - 만들기 또는 업데이트 요청에 readWriteEndpoint 필드가 필요합니다. 400 FailoverGroupCreateOrUpdateRequestInvalid - 장애 조치(failover) 그룹 만들기 또는 업데이트 요청 본문이 비어 있거나 잘못되었습니다. 400 FailoverGroupUpdateOrDeleteRequestOnSecondary - 보조 서버에서 장애 조치(failover) 그룹에 대한 수정이 허용되지 않습니다. 주 서버에서 요청을 실행합니다. 400 FailoverGroupCreateOrUpdateRequestNegativeGracePeriodValues - 읽기-쓰기 엔드포인트의 유예 기간 값은 음수가 아니어야 합니다. 400 FailoverGroupCreateOrUpdateRequestLessThanMinimumGracePeriodValues - 장애 조치(failover) 그룹의 유예 기간 값은 '{0}' 분 최소 유예 기간보다 크거나 같아야 합니다. 400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFields - 장애 조치(failover) 정책 자동이 읽기/쓰기 엔드포인트에 대해 선택된 경우 장애 조치(failover)WithDataLossGracePeriodMinutes 속성을 제공해야 합니다. 400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteFailoverPolicy - 읽기-쓰기 엔드포인트에 대한 failoverPolicy 필드는 요청을 만들거나 업데이트하는 데 필요합니다. 400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFieldsForManualPolicy - 읽기-쓰기 엔드포인트에 대해 장애 조치(failover) 정책 설명서를 선택하면 유예 기간 값을 제공하지 않아야 합니다. 요청에서 제거하세요. 400 FailoverGroupCreateOrUpdateRequestReadOnlyPropertyModified - 장애 조치(failover) 그룹 요청 본문 만들기 또는 업데이트는 읽기 전용 속성 '{0}'을 수정해서는 안 됩니다. 400 FailoverGroupFailoverRequestOnPrimary - 장애 조치(failover) 요청은 장애 조치(failover) 그룹의 보조 서버에서 시작되어야 합니다. 400 FailoverGroupPartnerServerFromDifferentSubscription - 장애 조치(failover) 그룹의 주 서버 및 파트너 서버는 서로 다른 구독에서 제공됩니다. 장애 조치(failover) 그룹의 서버에 대한 교차 구독은 허용되지 않습니다. 400 FailoverGroupCreateOrUpdateRequestInvalidReadOnlyEndpointTargetServer - 읽기 전용 엔드포인트의 속성 targetServer는 장애 조치(failover) 그룹에 대해 구성된 partnerServers 사이에 유효한 서버여야 합니다. 400 FailoverGroupCreateOrUpdateRequestUnsupportedPartnerCountForStandby - 보조 형식 대기에 대해 장애 조치(failover) 그룹에 대한 하나의 파트너 서버만 지원됩니다. 그에 따라 요청을 수정하세요. 400 InvalidServerName - 잘못된 서버 이름이 지정되었습니다. 400 InvalidIdentifier - 식별자에 NULL 또는 잘못된 유니코드 문자가 포함되어 있습니다. 400 TokenTooLong - 제공된 토큰이 너무 깁니다. 400 InvalidAddSecondaryPermission - 사용자에게 지정된 서버에 보조를 추가할 수 있는 충분한 권한이 없습니다. 400 InvalidSku - 사용자가 잘못된 sku를 지정했습니다. 400 ServerNotFound - 요청된 서버를 찾을 수 없습니다. 400 FeatureDisabledOnSelectedEdition - 사용자가 현재 데이터베이스 버전에서 사용하지 않도록 설정된 기능을 사용하려고 했습니다. 400 TokenTooLong - 제공된 토큰이 너무 깁니다. 400 InvalidTargetSubregion - 읽을 수 없는 보조 데이터베이스의 대상 서버가 DR 쌍을 이루는 Azure 지역에 있지 않습니다. 400 PartnerServerNotCompatible - 사용자가 SAWA V1 서버에서 Sterling 서버로 또는 그 반대로 데이터베이스를 복사하려고 합니다. 400 IncorrectReplicationLinkState - 작업에서는 데이터베이스가 복제 링크에서 예상된 상태여야 합니다. 400 ResourcePoolNotFound - 지정된 탄력적 풀이 지정된 논리 서버에 없습니다. 400 AzureKeyVaultKeyDisabled - Azure Key Vault 키를 사용할 수 없으므로 서버에서 작업을 완료할 수 없습니다. 400 AzureKeyVaultInvalidExpirationDate - Azure Key Vault 키 만료 날짜가 잘못되어 작업을 완료할 수 없습니다. 400 SecurityAzureKeyVaultUrlNullOrEmpty - Azure Key Vault Uri가 null이거나 비어 있으므로 작업을 완료할 수 없습니다. 400 AzureKeyVaultNoServerIdentity - 서버 ID가 올바르게 구성되지 않았습니다. 400 AzureKeyVaultInvalidUri - Azure Key Vault의 잘못된 응답입니다. 유효한 Azure Key Vault URI를 사용하세요. 400 AzureKeyVaultMissingPermissions - 서버에 Azure Key Vault에 대한 필수 권한이 없습니다. 400 SecurityAzureKeyVaultInvalidKeyName - 잘못된 서버 키 이름으로 인해 작업을 완료할 수 없습니다. 400 PlannedFailoverTimedOutForDatabase - 사용자가 계획된 장애 조치(failover)를 호출하고, 시간이 초과되었으며, 특정 데이터베이스가 비난하는 것처럼 보입니다. 400 PlannedFailoverTimedOut - 사용자가 계획된 장애 조치를 호출했으며 파트너 관리 서비스에 문의하는 동안 시간이 초과되었습니다. 400 AdalGenericError - Azure Active Directory 오류가 발생하여 작업을 완료할 수 없습니다. 400 AdalServicePrincipalNotFound - Azure Active Directory 라이브러리 서비스 주체를 찾을 수 없는 오류가 발생하여 작업을 완료할 수 없습니다. 400 AzureKeyVaultMalformedVaultUri - 제공된 Key Vault URI가 잘못되었습니다. 400 CannotUseReservedDatabaseName - 이 작업에서 예약된 데이터베이스 이름을 사용할 수 없습니다. 400 InvalidFailoverGroupRegion - 격리를 제공하려면 장애 조치(failover) 그룹에 지정된 서버가 서로 다른 지역에 있어야 합니다. 400 FailoverGroupDoesNotExist - 장애 조치(failover) 그룹이 서버에 없습니다. 400 FailoverGroupNotSecondary - 장애 조치 그룹의 주 서버에서 장애 조치를 시작할 수 없습니다. 400 InvalidServerName - 잘못된 서버 이름이 지정되었습니다. 400 DatabaseInFailoverGroupNotPrimary - 데이터베이스에 대한 GeoDR 링크가 이미 있지만 해당 역할은 '기본'이 아니거나 연속 복사 링크가 아닙니다. 400 SecurityAdalPrincipalCertExpiredError - Azure Key Vault 보안 주체 인증서가 만료되어 작업을 완료할 수 없습니다. 400 UnableToCreateFailoverGroupDueToTableAuditing - 테이블 감사가 켜져 있는 서버에 대해 장애 조치 그룹을 만들 수 없습니다. 400 InvalidIdentifier - 식별자에 NULL 또는 잘못된 유니코드 문자가 포함되어 있습니다. 400 UnableToAddDbWithTableAuditingToFailoverGroup - 테이블 감사를 사용하도록 설정된 데이터베이스는 장애 조치(failover) 그룹 엔드포인트를 통해 액세스할 수 없습니다. 400 SecurityInvalidAzureKeyVaultRecoveryLevel - 제공된 Key Vault URI가 잘못되었습니다. 400 KeyMaterialNotFoundOnRemoteServer - 원격 서버는 TDE 보호기로 사용되는 키 자료에 액세스할 수 없습니다. 400 LimitOfFailoverGroupsPerServerExceeded - 새 장애 조치 그룹을 만들면 서버당 허용되는 장애 조치(failover) 그룹 수를 초과합니다. 400 SameKeyUriNotFoundOnRemoteServer - 보조 서버에는 키 자동 회전이 사용하도록 설정된 주 서버의 암호화 보호기와 동일한 키 자격 증명 모음의 키 자료가 없습니다. 400 AzureKeyVaultRsaKeyNotSupported - 제공된 키 자격 증명 모음은 지원되지 않는 RSA 키 크기 또는 키 형식을 사용합니다. 지원되는 RSA 키 크기는 2048 또는 3072이고 키 유형은 RSA 또는 RSA-HSM입니다. 400 SameKeyMaterialNotFoundOnRemoteServer - 보조 서버에는 주 서버의 암호화 보호기의 키 자료가 없습니다. 400 GeoReplicationDatabaseNotSecondary - 작업에서는 데이터베이스가 복제 대상이 될 것으로 예상합니다. 400 GeoReplicaLimitReached - 복제본당 복제 제한에 도달했습니다. 400 FailoverGroupWithVirtualNetworkRulesNotSupported - 자동 장애 조치(failover) 정책으로 구성된 장애 조치(failover) 그룹은 현재 가상 네트워크 방화벽 규칙으로 구성된 서버에서 지원되지 않습니다. 수동 장애 조치(failover) 정책을 사용하여 장애 조치(failover) 그룹을 구성하세요. 400 UnableToResolveRemoteServer - 잘못된 서버 이름 또는 DNS 연결 문제로 인해 원격 파트너 서버 이름을 확인할 수 없습니다. 400 RemoteDatabaseCopyPermission - 사용자에게 지정된 서버에 데이터베이스 복사본을 만들 수 있는 충분한 권한이 없습니다. 400 SecurityAzureKeyVaultGeoChainError - BYOK(Azure Key Vault)를 사용하여 투명한 데이터 암호화를 사용하도록 설정할 때 보조(체인이라고 하는 프로세스)의 보조 만들기는 지원되지 않습니다. 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 - 보조 데이터베이스가 물리적으로 일관되지 않아 주 역할을 입력할 수 없는 상태에 있는 동안 사용자가 지역 링크를 장애 조치(failover)하거나 강제로 종료하려고 했습니다. 409 ServerKeyNameAlreadyExists - 서버 키가 서버에 이미 있습니다. 409 ServerKeyUriAlreadyExists - 서버 키 URI가 서버에 이미 있습니다. 409 ServerKeyDoesNotExists - 서버 키가 없습니다. 409 UpdateSloInProgress - 사용자가 SLO 업데이트가 진행되는 동안 호환되지 않는 작업을 시작하려고 했습니다. 409 AzureKeyVaultKeyNameNotFound - Azure Key Vault 키 이름이 없으므로 작업을 완료할 수 없습니다. 409 AzureKeyVaultKeyInUse - 현재 서버에서 키를 사용하고 있습니다. 409 FailoverGroupAlreadyExists - 장애 조치(failover) 그룹이 지정된 서버에 이미 있습니다. 다른 장애 조치(failover) 그룹 이름을 사용하세요. 409 FailoverGroupBusy - 장애 조치(failover) 그룹이 다른 작업으로 사용 중입니다. 409 DatabaseBelongsToOtherFailoverGroup - 데이터베이스는 다른 장애 조치 그룹에 속하며 이 그룹의 일부로 간주할 수 없습니다. 409 DatabaseBeingAddedToFailoverGroup - 데이터베이스가 현재 장애 조치(failover) 그룹에 추가되고 있습니다. 고객은 이 작업이 완료될 때까지 기다려야 제거를 발급합니다. 409 DatabaseBeingRemovedFromFailoverGroup - 데이터베이스가 현재 장애 조치(failover) 그룹에서 제거되고 있습니다. 고객은 이 작업이 완료될 때까지 기다려야 추가를 발급합니다. 409 FailoverGroupDnsRecordInUse - 요청된 엔드포인트에 대한 중복 DNS 레코드가 있습니다. 409 InvalidFailoverGroupName - 잘못된 장애 조치(failover) 그룹 이름이 제공되었습니다. 409 InvalidOperationForDatabaseNotInReplicationRelationship - 복제 관계에 없는 데이터베이스에서 복제 작업이 수행되었습니다. 409 InvalidDatabaseStateForOperation - 현재 복제 상태의 데이터베이스에서 작업이 허용되지 않습니다. 409 DuplicateGeoDrRelation - 데이터베이스가 이미 복제 관계입니다. 중복된 요청입니다. 409 RemoteDatabaseExists - 대상 데이터베이스 이름이 대상 서버에 이미 있습니다. 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 - 서비스 요청이 허용된 시간 제한을 초과했습니다.

Name

형식

Description

200 OK

FailoverGroup

장애 조치(failover)가 완료되었습니다.

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 - 장애 조치(failover) 그룹 요청 본문을 만들거나 업데이트할 때 지정된 파트너 필드가 비어 있거나 잘못되었습니다. 이 필드의 유효한 값을 입력하세요. 적절한 형식의 요청 예제는 https://docs.microsoft.com/en-us/rest/api/sql/failovergroups/createorupdate 참조하세요.
400 FailoverGroupCreateOrUpdateRequestDuplicatePartner - 제공된 파트너 서버 중 하나 이상이 이미 장애 조치(failover) 그룹의 일부입니다. 주 서버와 지정된 모든 파트너 서버가 고유한지 확인하세요.
400 FailoverGroupCreateOrUpdateRequestInvalidDatabaseServer - 제공된 데이터베이스 중 하나 이상이 장애 조치(failover) 그룹의 주 서버에 존재하지 않습니다. 모든 데이터베이스가 주 서버에 있는지 확인하세요.
400 FailoverGroupCreateOrUpdateRequestUnsupportedPartnerCount - 장애 조치(failover) 그룹에 대한 하나의 파트너 서버만 지원됩니다. 그에 따라 요청을 수정하세요. 유효한 요청의 예는 https://docs.microsoft.com/en-us/rest/api/sql/failovergroups/createorupdate 참조하세요.
400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpoint - 만들기 또는 업데이트 요청에 readWriteEndpoint 필드가 필요합니다.
400 FailoverGroupCreateOrUpdateRequestInvalid - 장애 조치(failover) 그룹 만들기 또는 업데이트 요청 본문이 비어 있거나 잘못되었습니다.
400 FailoverGroupUpdateOrDeleteRequestOnSecondary - 보조 서버에서 장애 조치(failover) 그룹에 대한 수정이 허용되지 않습니다. 주 서버에서 요청을 실행합니다.
400 FailoverGroupCreateOrUpdateRequestNegativeGracePeriodValues - 읽기-쓰기 엔드포인트의 유예 기간 값은 음수가 아니어야 합니다.
400 FailoverGroupCreateOrUpdateRequestLessThanMinimumGracePeriodValues - 장애 조치(failover) 그룹의 유예 기간 값은 '{0}' 분 최소 유예 기간보다 크거나 같아야 합니다.
400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFields - 장애 조치(failover) 정책 자동이 읽기/쓰기 엔드포인트에 대해 선택된 경우 장애 조치(failover)WithDataLossGracePeriodMinutes 속성을 제공해야 합니다.
400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteFailoverPolicy - 읽기-쓰기 엔드포인트에 대한 failoverPolicy 필드는 요청을 만들거나 업데이트하는 데 필요합니다.
400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFieldsForManualPolicy - 읽기-쓰기 엔드포인트에 대해 장애 조치(failover) 정책 설명서를 선택하면 유예 기간 값을 제공하지 않아야 합니다. 요청에서 제거하세요.
400 FailoverGroupCreateOrUpdateRequestReadOnlyPropertyModified - 장애 조치(failover) 그룹 요청 본문 만들기 또는 업데이트는 읽기 전용 속성 '{0}'을 수정해서는 안 됩니다.
400 FailoverGroupFailoverRequestOnPrimary - 장애 조치(failover) 요청은 장애 조치(failover) 그룹의 보조 서버에서 시작되어야 합니다.
400 FailoverGroupPartnerServerFromDifferentSubscription - 장애 조치(failover) 그룹의 주 서버 및 파트너 서버는 서로 다른 구독에서 제공됩니다. 장애 조치(failover) 그룹의 서버에 대한 교차 구독은 허용되지 않습니다.
400 FailoverGroupCreateOrUpdateRequestInvalidReadOnlyEndpointTargetServer - 읽기 전용 엔드포인트의 속성 targetServer는 장애 조치(failover) 그룹에 대해 구성된 partnerServers 사이에 유효한 서버여야 합니다.
400 FailoverGroupCreateOrUpdateRequestUnsupportedPartnerCountForStandby - 보조 형식 대기에 대해 장애 조치(failover) 그룹에 대한 하나의 파트너 서버만 지원됩니다. 그에 따라 요청을 수정하세요.
400 InvalidServerName - 잘못된 서버 이름이 지정되었습니다.
400 InvalidIdentifier - 식별자에 NULL 또는 잘못된 유니코드 문자가 포함되어 있습니다.
400 TokenTooLong - 제공된 토큰이 너무 깁니다.
400 InvalidAddSecondaryPermission - 사용자에게 지정된 서버에 보조를 추가할 수 있는 충분한 권한이 없습니다.
400 InvalidSku - 사용자가 잘못된 sku를 지정했습니다.
400 ServerNotFound - 요청된 서버를 찾을 수 없습니다.
400 FeatureDisabledOnSelectedEdition - 사용자가 현재 데이터베이스 버전에서 사용하지 않도록 설정된 기능을 사용하려고 했습니다.
400 TokenTooLong - 제공된 토큰이 너무 깁니다.
400 InvalidTargetSubregion - 읽을 수 없는 보조 데이터베이스의 대상 서버가 DR 쌍을 이루는 Azure 지역에 있지 않습니다.
400 PartnerServerNotCompatible - 사용자가 SAWA V1 서버에서 Sterling 서버로 또는 그 반대로 데이터베이스를 복사하려고 합니다.
400 IncorrectReplicationLinkState - 작업에서는 데이터베이스가 복제 링크에서 예상된 상태여야 합니다.
400 ResourcePoolNotFound - 지정된 탄력적 풀이 지정된 논리 서버에 없습니다.
400 AzureKeyVaultKeyDisabled - Azure Key Vault 키를 사용할 수 없으므로 서버에서 작업을 완료할 수 없습니다.
400 AzureKeyVaultInvalidExpirationDate - Azure Key Vault 키 만료 날짜가 잘못되어 작업을 완료할 수 없습니다.
400 SecurityAzureKeyVaultUrlNullOrEmpty - Azure Key Vault Uri가 null이거나 비어 있으므로 작업을 완료할 수 없습니다.
400 AzureKeyVaultNoServerIdentity - 서버 ID가 올바르게 구성되지 않았습니다.
400 AzureKeyVaultInvalidUri - Azure Key Vault의 잘못된 응답입니다. 유효한 Azure Key Vault URI를 사용하세요.
400 AzureKeyVaultMissingPermissions - 서버에 Azure Key Vault에 대한 필수 권한이 없습니다.
400 SecurityAzureKeyVaultInvalidKeyName - 잘못된 서버 키 이름으로 인해 작업을 완료할 수 없습니다.
400 PlannedFailoverTimedOutForDatabase - 사용자가 계획된 장애 조치(failover)를 호출하고, 시간이 초과되었으며, 특정 데이터베이스가 비난하는 것처럼 보입니다.
400 PlannedFailoverTimedOut - 사용자가 계획된 장애 조치를 호출했으며 파트너 관리 서비스에 문의하는 동안 시간이 초과되었습니다.
400 AdalGenericError - Azure Active Directory 오류가 발생하여 작업을 완료할 수 없습니다.
400 AdalServicePrincipalNotFound - Azure Active Directory 라이브러리 서비스 주체를 찾을 수 없는 오류가 발생하여 작업을 완료할 수 없습니다.
400 AzureKeyVaultMalformedVaultUri - 제공된 Key Vault URI가 잘못되었습니다.
400 CannotUseReservedDatabaseName - 이 작업에서 예약된 데이터베이스 이름을 사용할 수 없습니다.
400 InvalidFailoverGroupRegion - 격리를 제공하려면 장애 조치(failover) 그룹에 지정된 서버가 서로 다른 지역에 있어야 합니다.
400 FailoverGroupDoesNotExist - 장애 조치(failover) 그룹이 서버에 없습니다.
400 FailoverGroupNotSecondary - 장애 조치 그룹의 주 서버에서 장애 조치를 시작할 수 없습니다.
400 InvalidServerName - 잘못된 서버 이름이 지정되었습니다.
400 DatabaseInFailoverGroupNotPrimary - 데이터베이스에 대한 GeoDR 링크가 이미 있지만 해당 역할은 '기본'이 아니거나 연속 복사 링크가 아닙니다.
400 SecurityAdalPrincipalCertExpiredError - Azure Key Vault 보안 주체 인증서가 만료되어 작업을 완료할 수 없습니다.
400 UnableToCreateFailoverGroupDueToTableAuditing - 테이블 감사가 켜져 있는 서버에 대해 장애 조치 그룹을 만들 수 없습니다.
400 InvalidIdentifier - 식별자에 NULL 또는 잘못된 유니코드 문자가 포함되어 있습니다.
400 UnableToAddDbWithTableAuditingToFailoverGroup - 테이블 감사를 사용하도록 설정된 데이터베이스는 장애 조치(failover) 그룹 엔드포인트를 통해 액세스할 수 없습니다.
400 SecurityInvalidAzureKeyVaultRecoveryLevel - 제공된 Key Vault URI가 잘못되었습니다.
400 KeyMaterialNotFoundOnRemoteServer - 원격 서버는 TDE 보호기로 사용되는 키 자료에 액세스할 수 없습니다.
400 LimitOfFailoverGroupsPerServerExceeded - 새 장애 조치 그룹을 만들면 서버당 허용되는 장애 조치(failover) 그룹 수를 초과합니다.
400 SameKeyUriNotFoundOnRemoteServer - 보조 서버에는 키 자동 회전이 사용하도록 설정된 주 서버의 암호화 보호기와 동일한 키 자격 증명 모음의 키 자료가 없습니다.
400 AzureKeyVaultRsaKeyNotSupported - 제공된 키 자격 증명 모음은 지원되지 않는 RSA 키 크기 또는 키 형식을 사용합니다. 지원되는 RSA 키 크기는 2048 또는 3072이고 키 유형은 RSA 또는 RSA-HSM입니다.
400 SameKeyMaterialNotFoundOnRemoteServer - 보조 서버에는 주 서버의 암호화 보호기의 키 자료가 없습니다.
400 GeoReplicationDatabaseNotSecondary - 작업에서는 데이터베이스가 복제 대상이 될 것으로 예상합니다.
400 GeoReplicaLimitReached - 복제본당 복제 제한에 도달했습니다.
400 FailoverGroupWithVirtualNetworkRulesNotSupported - 자동 장애 조치(failover) 정책으로 구성된 장애 조치(failover) 그룹은 현재 가상 네트워크 방화벽 규칙으로 구성된 서버에서 지원되지 않습니다. 수동 장애 조치(failover) 정책을 사용하여 장애 조치(failover) 그룹을 구성하세요.
400 UnableToResolveRemoteServer - 잘못된 서버 이름 또는 DNS 연결 문제로 인해 원격 파트너 서버 이름을 확인할 수 없습니다.
400 RemoteDatabaseCopyPermission - 사용자에게 지정된 서버에 데이터베이스 복사본을 만들 수 있는 충분한 권한이 없습니다.
400 SecurityAzureKeyVaultGeoChainError - BYOK(Azure Key Vault)를 사용하여 투명한 데이터 암호화를 사용하도록 설정할 때 보조(체인이라고 하는 프로세스)의 보조 만들기는 지원되지 않습니다.
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 - 보조 데이터베이스가 물리적으로 일관되지 않아 주 역할을 입력할 수 없는 상태에 있는 동안 사용자가 지역 링크를 장애 조치(failover)하거나 강제로 종료하려고 했습니다.
409 ServerKeyNameAlreadyExists - 서버 키가 서버에 이미 있습니다.
409 ServerKeyUriAlreadyExists - 서버 키 URI가 서버에 이미 있습니다.
409 ServerKeyDoesNotExists - 서버 키가 없습니다.
409 UpdateSloInProgress - 사용자가 SLO 업데이트가 진행되는 동안 호환되지 않는 작업을 시작하려고 했습니다.
409 AzureKeyVaultKeyNameNotFound - Azure Key Vault 키 이름이 없으므로 작업을 완료할 수 없습니다.
409 AzureKeyVaultKeyInUse - 현재 서버에서 키를 사용하고 있습니다.
409 FailoverGroupAlreadyExists - 장애 조치(failover) 그룹이 지정된 서버에 이미 있습니다. 다른 장애 조치(failover) 그룹 이름을 사용하세요.
409 FailoverGroupBusy - 장애 조치(failover) 그룹이 다른 작업으로 사용 중입니다.
409 DatabaseBelongsToOtherFailoverGroup - 데이터베이스는 다른 장애 조치 그룹에 속하며 이 그룹의 일부로 간주할 수 없습니다.
409 DatabaseBeingAddedToFailoverGroup - 데이터베이스가 현재 장애 조치(failover) 그룹에 추가되고 있습니다. 고객은 이 작업이 완료될 때까지 기다려야 제거를 발급합니다.
409 DatabaseBeingRemovedFromFailoverGroup - 데이터베이스가 현재 장애 조치(failover) 그룹에서 제거되고 있습니다. 고객은 이 작업이 완료될 때까지 기다려야 추가를 발급합니다.
409 FailoverGroupDnsRecordInUse - 요청된 엔드포인트에 대한 중복 DNS 레코드가 있습니다.
409 InvalidFailoverGroupName - 잘못된 장애 조치(failover) 그룹 이름이 제공되었습니다.
409 InvalidOperationForDatabaseNotInReplicationRelationship - 복제 관계에 없는 데이터베이스에서 복제 작업이 수행되었습니다.
409 InvalidDatabaseStateForOperation - 현재 복제 상태의 데이터베이스에서 작업이 허용되지 않습니다.
409 DuplicateGeoDrRelation - 데이터베이스가 이미 복제 관계입니다. 중복된 요청입니다.
409 RemoteDatabaseExists - 대상 데이터베이스 이름이 대상 서버에 이미 있습니다.
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 - 서비스 요청이 허용된 시간 제한을 초과했습니다.

예제

Planned failover of a failover group

샘플 요청

HTTP

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

샘플 응답

상태 코드:: 200

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

상태 코드:: 202

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

정의

Name	Description
ErrorAdditionalInfo	리소스 관리 오류 추가 정보입니다.
ErrorDetail	오류 세부 정보입니다.
ErrorResponse	오류 응답
FailoverGroup	장애 조치(failover) 그룹입니다.
FailoverGroupDatabasesSecondaryType	파트너 서버의 데이터베이스 보조 형식입니다.
FailoverGroupReadOnlyEndpoint	장애 조치(failover) 그룹 인스턴스의 읽기 전용 엔드포인트입니다.
FailoverGroupReadWriteEndpoint	장애 조치(failover) 그룹 인스턴스의 읽기-쓰기 엔드포인트입니다.
FailoverGroupReplicationRole	장애 조치(failover) 그룹 인스턴스의 로컬 복제 역할입니다.
PartnerInfo	장애 조치(failover) 그룹에 대한 파트너 서버 정보입니다.
ReadOnlyEndpointFailoverPolicy	장애 조치(failover) 그룹에 대한 읽기 전용 엔드포인트의 장애 조치(failover) 정책입니다.
ReadWriteEndpointFailoverPolicy	장애 조치(failover) 그룹에 대한 읽기-쓰기 엔드포인트의 장애 조치(failover) 정책입니다. failoverPolicy가 자동이면 failoverWithDataLossGracePeriodMinutes가 필요합니다.

ErrorAdditionalInfo

Object

리소스 관리 오류 추가 정보입니다.

Name	형식	Description
info	object	추가 정보입니다.
type	string	추가 정보 유형입니다.

ErrorDetail

Object

오류 세부 정보입니다.

Name	형식	Description
additionalInfo	ErrorAdditionalInfo[]	오류 추가 정보입니다.
code	string	오류 코드입니다.
details	ErrorDetail[]	오류 세부 정보입니다.
message	string	오류 메시지입니다.
target	string	오류 대상입니다.

ErrorResponse

Object

오류 응답

Name	형식	Description
error	ErrorDetail	오류 개체입니다.

FailoverGroup

Object

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

Name	형식	Description
id	string	리소스 ID입니다.
location	string	리소스 위치입니다.
name	string	리소스 이름입니다.
properties.databases	string[] (arm-id)	장애 조치(failover) 그룹의 데이터베이스 목록입니다.
properties.partnerServers	PartnerInfo[]	장애 조치(failover) 그룹에 대한 파트너 서버 정보 목록입니다.
properties.readOnlyEndpoint	FailoverGroupReadOnlyEndpoint	장애 조치(failover) 그룹 인스턴스의 읽기 전용 엔드포인트입니다.
properties.readWriteEndpoint	FailoverGroupReadWriteEndpoint	장애 조치(failover) 그룹 인스턴스의 읽기-쓰기 엔드포인트입니다.
properties.replicationRole	FailoverGroupReplicationRole	장애 조치(failover) 그룹 인스턴스의 로컬 복제 역할입니다.
properties.replicationState	string	장애 조치(failover) 그룹 인스턴스의 복제 상태입니다.
properties.secondaryType	FailoverGroupDatabasesSecondaryType	파트너 서버의 데이터베이스 보조 형식입니다.
tags	object	리소스 태그.
type	string	리소스 종류입니다.

FailoverGroupDatabasesSecondaryType

열거형

파트너 서버의 데이터베이스 보조 형식입니다.

값	Description
Geo
Standby

FailoverGroupReadOnlyEndpoint

Object

장애 조치(failover) 그룹 인스턴스의 읽기 전용 엔드포인트입니다.

Name	형식	Description
failoverPolicy	ReadOnlyEndpointFailoverPolicy	장애 조치(failover) 그룹에 대한 읽기 전용 엔드포인트의 장애 조치(failover) 정책입니다.
targetServer	string (arm-id)	읽기 전용 엔드포인트가 가리키는 대상 파트너 서버입니다.

FailoverGroupReadWriteEndpoint

Object

장애 조치(failover) 그룹 인스턴스의 읽기-쓰기 엔드포인트입니다.

Name	형식	Description
failoverPolicy	ReadWriteEndpointFailoverPolicy	장애 조치(failover) 그룹에 대한 읽기-쓰기 엔드포인트의 장애 조치(failover) 정책입니다. failoverPolicy가 자동이면 failoverWithDataLossGracePeriodMinutes가 필요합니다.
failoverWithDataLossGracePeriodMinutes	integer (int32)	읽기/쓰기 엔드포인트에 대해 데이터 손실이 있는 장애 조치(failover) 전 유예 기간이 시도됩니다. failoverPolicy가 자동이면 failoverWithDataLossGracePeriodMinutes가 필요합니다.

FailoverGroupReplicationRole

열거형

장애 조치(failover) 그룹 인스턴스의 로컬 복제 역할입니다.

값	Description
Primary
Secondary

PartnerInfo

Object

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

Name	형식	Description
id	string (arm-id)	파트너 서버의 리소스 식별자입니다.
location	string	파트너 서버의 지리적 위치입니다.
replicationRole	FailoverGroupReplicationRole	파트너 서버의 복제 역할입니다.

ReadOnlyEndpointFailoverPolicy

열거형

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

값	Description
Disabled
Enabled

ReadWriteEndpointFailoverPolicy

열거형

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

값	Description
Automatic
Manual

다음을 통해 공유

Failover Groups - Failover

URI 매개 변수

응답

예제

Planned failover of a failover group

샘플 요청

샘플 응답

정의

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

FailoverGroup

FailoverGroupDatabasesSecondaryType

FailoverGroupReadOnlyEndpoint

FailoverGroupReadWriteEndpoint

FailoverGroupReplicationRole

PartnerInfo

ReadOnlyEndpointFailoverPolicy

ReadWriteEndpointFailoverPolicy

추가 리소스