Aracılığıyla paylaş


Instance Failover Groups - List By Location

Yük devretme gruplarını bir konumda Listeler.

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

URI Parametreleri

Name İçinde Gerekli Tür Description
locationName
path True

string

Kaynağın bulunduğu bölgenin adı.

resourceGroupName
path True

string

Kaynağı içeren kaynak grubunun adı. Bu değeri Azure Resource Manager API'sinden veya portaldan alabilirsiniz.

subscriptionId
path True

string

Azure aboneliğini tanımlayan abonelik kimliği.

api-version
query True

string

İstek için kullanılacak API sürümü.

Yanıtlar

Name Tür Description
200 OK

InstanceFailoverGroupListResult

Yük devretme grupları başarıyla alındı.

Other Status Codes

Hata Yanıtları: **

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidPrimary - Örnek oluşturma veya güncelleştirme örneği yük devretme grubu istek gövdesindeki verilen birincil alan boş veya geçersiz.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidPartner - Örnek oluşturma veya güncelleştirme örneği yük devretme grubu istek gövdesindeki verilen iş ortakları alanı boş veya geçersiz.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestDuplicatePartner - Sağlanan iş ortağı sunuculardan biri veya daha fazlası zaten örnek yük devretme grubunun bir parçası. Birincil sunucunun ve verilen tüm iş ortağı sunucularının benzersiz olduğundan emin olun.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidManagedInstanceRegion - Örnek yük devretme grubu istek gövdesinde sağlanan iş ortağı yönetilen örnek bölgesi boş veya geçersiz.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestUnsupportedPartnerCount - Yalnızca bir iş ortağı bölgesi desteklenir.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestUnsupportedPairCount - Yalnızca bir yönetilen örnek çifti desteklenir.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpoint - Oluşturma veya güncelleştirme istekleri için readWriteEndpoint alanı gereklidir.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalid - Örnek oluşturma veya güncelleştirme yük devretme grubu istek gövdesi boş veya geçersiz.

  • 400 InstanceFailoverGroupUpdateOrDeleteRequestOnSecondary - İkincil sunucuda örnek yük devretme grubunda değişikliklere izin verilmez. İsteği birincil sunucuda yürütür.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestNegativeGracePeriodValues - Okuma-yazma uç noktası için yetkisiz kullanım süresi değeri negatif olmamalıdır.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestLessThanMinimumGracePeriodValues - Örnek yük devretme grubu için yetkisiz kullanım süresi değeri '{0}' dakika minimum yetkisiz kullanım süresinden büyük veya buna eşit olmalıdır

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFields - Okuma-yazma uç noktası için otomatik yük devretme ilkesi seçildiğinde failoverWithDataLossGracePeriodMinutes özelliği sağlanmalıdır.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteFailoverPolicy - Oluşturma veya güncelleştirme istekleri için okuma-yazma uç noktasının failoverPolicy alanı gereklidir.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFieldsForManualPolicy - Okuma-yazma uç noktası için el ile yük devretme ilkesi seçildiğinde yetkisiz kullanım süresi değeri sağlanmamalıdır.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestReadOnlyPropertyModified - Oluşturma veya güncelleştirme örneği yük devretme grubu istek gövdesi ''{0} salt okunur özelliğini değiştirmemelidir.

  • 400 InstanceFailoverGroupFailoverRequestOnPrimary - Yük devretme isteği, örnek yük devretme grubunun ikincil sunucusunda başlatılmalıdır.

  • 400 InstanceFailoverGroupPartnerManagedInstanceFromDifferentSubscription - Birincil sunucu ve yük devretme grubunun iş ortağı sunucusu farklı aboneliklerdendir. Yük devretme grubu sunucuları için çapraz aboneliğe izin verilmez.

  • 400 FailoverGroupRegionMismatch - Yük Devretme Grubunda belirtilen iş ortağı bölgesinin, belirtilen iş ortağı yönetilen örneğinin bölgesiyle eşleşmesi gerekir.

  • 400 ServerEditionMismatch - Çoğaltma sunucusu oluşturulurken sürüm birincil sunucuyla aynı olmalıdır.

  • 400 DnsZoneMismatch - İş ortağı sunucusundaki DNSZone, kaynak sunucudaki DNSZone'dan farklıdır. Bu, InstanceFailoverGroup işlevselliğini bozar.

  • 400 InvalidTargetSubregion - Okunamayan bir ikincil sunucunun hedef sunucusu DR ile eşleştirilmiş bir Azure bölgesinde değil.

  • 400 GeoDrInstanceSizeMismatch - Birincil yönetilen örnek ve iş ortağı tarafından yönetilen örnek aynı depolama boyutuna sahip değildir.

  • 400 SecurityAdalPrincipalCertExpiredError - Azure Key Vault asıl sertifikasının süresi dolduğundan işlem tamamlanamadı.

  • 400 GeoDrSecondaryInstanceNotEmpty - İkincil yönetilen örnekte kullanıcı veritabanları vardır. Örnek yük devretme grubu oluşturmak için ikincil yönetilen örneğin boş olması gerekir.

  • 400 InstanceFailoverGroupIncorrectNetworkingConfiguration - Ağ yapılandırması yanlış. Birincil sunucunun çoğaltma trafiği ikincil sunucuya ulaşamıyor.

  • 400 IncorrectReplicationLinkState - İşlem, veritabanının çoğaltma bağlantısında beklenen bir durumda olmasını bekler.

  • 400 SecurityInvalidAzureKeyVaultRecoveryLevel - Sağlanan Key Vault uri geçerli değil.

  • 400 KeyMaterialNotFoundOnRemoteServer - Uzak sunucunun TDE koruyucusu olarak kullanılan anahtar malzemeye erişimi yok.

  • 400 AzureKeyVaultRsaKeyNotSupported - Sağlanan anahtar kasası desteklenmeyen RSA Anahtar Boyutu veya Anahtar Türü kullanıyor. Desteklenen RSA anahtar boyutu 2048 veya 3072, Anahtar Türü ise RSA veya RSA-HSM'dir.

  • 400 UnableToResolveRemoteServer - Uzak iş ortağı sunucu adı geçersiz bir sunucu adı veya DNS bağlantı sorunları nedeniyle çözümlenemedi.

  • 400 SameKeyUriNotFoundOnRemoteServer - İkincil sunucu, birincil sunucunun şifreleme koruyucusuyla aynı anahtar kasasındaki anahtar malzemesine sahip değildir ve anahtar otomatik döndürme etkindir.

  • 400 RemoteDatabaseCopyPermission - Kullanıcının belirtilen sunucuda veritabanı kopyası oluşturmak için yeterli izni yok.

  • 400 SameKeyMaterialNotFoundOnRemoteServer - İkincil sunucu birincil sunucunun şifreleme koruyucusunun anahtar malzemesine sahip değil.

  • 400 CannotUseReservedDatabaseName - Bu işlemde ayrılmış veritabanı adı kullanılamaz.

  • 400 InvalidFailoverGroupRegion - Örnek Yük Devretme Grubunda belirtilen sunucuların yalıtım sağlamak için farklı bölgelerde bulunması gerekir.

  • 400 InstanceFailoverGroupDoesNotExist - Yük devretme grubu sunucuda yok.

  • 400 InstanceFailoverGroupNotSecondary - Yük devretme, örnek yük devretme grubundaki birincil sunucudan başlatılamaz.

  • 400 InvalidServerName - Geçersiz sunucu adı belirtildi.

  • 400 InvalidIdentifier - Tanımlayıcı NULL veya geçersiz bir unicode karakter içeriyor.

  • 400 TokenTooLong - Sağlanan belirteç çok uzun.

  • 400 AzureKeyVaultKeyDisabled - Azure Key Vault anahtarı devre dışı bırakıldığından sunucuda işlem tamamlanamadı.

  • 400 AzureKeyVaultInvalidExpirationDate - Azure Key Vault anahtarı son kullanma tarihi geçersiz olduğundan işlem tamamlanamadı.

  • 400 SecurityAzureKeyVaultUrlNullOrEmpty - Azure Key Vault Uri null veya boş olduğundan işlem tamamlanamadı.

  • 400 InvalidSku - Kullanıcı geçersiz bir sku belirtti.

  • 400 InvalidAddSecondaryPermission - Kullanıcının belirtilen sunucuya ikincil eklemek için yeterli izni yok.

  • 400 ServerNotFound - İstenen sunucu bulunamadı.

  • 400 AzureKeyVaultNoServerIdentity - Sunucu kimliği doğru yapılandırılmamış.

  • 400 AzureKeyVaultInvalidUri - Azure Key Vault geçersiz bir yanıt. Lütfen geçerli bir Azure Key Vault URI'si kullanın.

  • 400 AzureKeyVaultMissingPermissions - Sunucuda Azure Key Vault gerekli izinler eksik.

  • 400 SecurityAzureKeyVaultInvalidKeyName - Geçersiz bir Sunucu Anahtarı adı nedeniyle işlem tamamlanamadı.

  • 400 PlannedFailoverTimedOutForDatabase - Kullanıcı planlı yük devretme çağrıldı, zaman aşımına uğradı ve belirli bir veritabanı suçlanıyor gibi görünüyor.

  • 400 PlannedFailoverTimedOut - Kullanıcı planlı yük devretme'yi çağırmış ve iş ortağı yönetim hizmetiyle iletişim kurmaya çalışırken zaman aşımına uğradı.

  • 400 AdalGenericError - Azure Active Directory hatasıyla karşılaşıldığından işlem tamamlanamadı.

  • 400 GeoReplicationDatabaseNotSecondary - İşlem veritabanının çoğaltma hedefi olmasını bekler.

  • 400 AdalServicePrincipalNotFound - Azure Active Directory kitaplığı Hizmet Sorumlusu bulunamadı hatasıyla karşılaşıldığından işlem tamamlanamadı.

  • 400 AzureKeyVaultMalformedVaultUri - Sağlanan Key Vault uri geçerli değil.

  • 400 FeatureDisabledOnSelectedEdition - Kullanıcı geçerli veritabanı sürümünde devre dışı bırakılmış bir özelliği kullanmaya çalıştı.

  • 404 ResourceNotFound - İstenen kaynak bulunamadı.

  • 404 SourceDatabaseNotFound - Kaynak veritabanı yok.

  • 404 ServerNotInSubscription - Belirtilen sunucu belirtilen abonelikte yok.

  • 404 ServerNotInSubscriptionResourceGroup - Belirtilen sunucu belirtilen kaynak grubunda ve abonelikte yok.

  • 405 UnsupportedReplicationOperation - Veritabanında desteklenmeyen bir çoğaltma işlemi başlatıldı.

  • 409 ManagedInstanceHasHybridLink - Yönetilen örnek bir karma bağlantı yapılandırıldığında kullanıcı desteklenmeyen bir işlem başlatmayı denedi.

  • 409 RemoteDatabaseExists - Hedef veritabanı adı hedef sunucuda zaten var.

  • 409 ConflictingServerOperation - Sunucu için şu anda bir işlem devam ediyor.

  • 409 SubscriptionDisabled - Abonelik devre dışı bırakıldı.

  • 409 InstanceFailoverGroupAlreadyExists - Belirli bir sunucuda yük devretme grubu zaten var.

  • 409 InstanceFailoverGroupBusy - Örnek yük devretme grubu başka bir işlemle meşgul.

  • 409 GeoReplicationCannotBecomePrimaryDuringUndo - İkincil fiziksel olarak tutarlı olmadığı ve birincil rolü giremediği bir durumdayken kullanıcı coğrafi bağlantıyı yük devretmeye veya zorlamaya çalıştı.

  • 409 InstanceFailoverGroupDnsRecordInUse - İstenen uç nokta için yinelenen bir DNS kaydı var.

  • 409 ServerKeyNameAlreadyExists - Sunucu anahtarı sunucuda zaten var.

  • 409 ServerKeyUriAlreadyExists - Sunucu anahtarı URI'si sunucuda zaten var.

  • 409 ServerKeyDoesNotExists - Sunucu anahtarı yok.

  • 409 InvalidFailoverGroupName - Geçersiz Örnek Yük Devretme Grubu adı sağlandı.

  • 409 UpdateSloInProgress - SLO güncelleştirmesi devam ederken kullanıcı uyumsuz bir işlem başlatmayı denedi.

  • 409 AzureKeyVaultKeyNameNotFound - Azure Key Vault Anahtarı adı mevcut olmadığından işlem tamamlanamadı.

  • 409 AzureKeyVaultKeyInUse - Anahtar şu anda sunucu tarafından kullanılıyor.

  • 409 ConflictingSystemOperationInProgress - Veritabanında bir sistem bakım işlemi devam ediyor ve diğer işlemlerin tamamlanana kadar beklemesi gerekiyor.

  • 409 InvalidOperationForDatabaseNotInReplicationRelationship - Zaten bir çoğaltma ilişkisinde olan bir veritabanında çoğaltma çekirdek oluşturma işlemi gerçekleştirildi.

  • 409 InvalidDatabaseStateForOperation - Veritabanında geçerli çoğaltma durumunda işleme izin verilmiyor.

  • 409 DuplicateGeoDrRelation - Veritabanları zaten bir çoğaltma ilişkisinde. Bu yinelenen bir istektir.

  • 429 SubscriptionTooManyCreateUpdateRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum isteklerin ötesindeki istekler.

  • 429 SubscriptionTooManyRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum isteklerin ötesindeki istekler.

  • 503 TooManyRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum isteklerin ötesindeki istekler.

  • 503 AzureKeyVaultConnectionFailed - Azure Key Vault bağlanma girişimleri başarısız olduğundan sunucuda işlem tamamlanamadı

  • 503 AzureKeyVaultGenericConnectionError - Key Vault bilgileri alınmaya çalışılırken bir hatayla karşılaşıldığından işlem tamamlanamadı.

  • 504 RequestTimeout - Hizmet isteği izin verilen zaman aşımını aştı.

Örnekler

List failover group

Örnek isteği

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

Örnek yanıt

{
  "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"
          }
        ]
      }
    }
  ]
}

Tanımlar

Name Description
InstanceFailoverGroup

Örnek yük devretme grubu.

InstanceFailoverGroupListResult

Örnek yük devretme gruplarının listesi.

InstanceFailoverGroupReadOnlyEndpoint

Yük devretme grubu örneğinin salt okunur uç noktası.

InstanceFailoverGroupReadWriteEndpoint

Yük devretme grubu örneğinin okuma-yazma uç noktası.

InstanceFailoverGroupReplicationRole

Yük devretme grubu örneğinin yerel çoğaltma rolü.

ManagedInstancePairInfo

Yük devretme grubundaki Yönetilen Örnek çiftleri.

PartnerRegionInfo

Yük devretme grubu için iş ortağı bölgesi bilgileri.

ReadOnlyEndpointFailoverPolicy

Yük devretme grubu için salt okunur uç noktanın yük devretme ilkesi.

ReadWriteEndpointFailoverPolicy

Yük devretme grubu için okuma-yazma uç noktasının yük devretme ilkesi. failoverPolicy Otomatik ise failoverWithDataLossGracePeriodMinutes gereklidir.

InstanceFailoverGroup

Örnek yük devretme grubu.

Name Tür Description
id

string

Kaynak Kimliği.

name

string

Kaynak adı.

properties.managedInstancePairs

ManagedInstancePairInfo[]

Yük devretme grubundaki yönetilen örnek çiftlerinin listesi.

properties.partnerRegions

PartnerRegionInfo[]

Yük devretme grubu için iş ortağı bölgesi bilgileri.

properties.readOnlyEndpoint

InstanceFailoverGroupReadOnlyEndpoint

Yük devretme grubu örneğinin salt okunur uç noktası.

properties.readWriteEndpoint

InstanceFailoverGroupReadWriteEndpoint

Yük devretme grubu örneğinin okuma-yazma uç noktası.

properties.replicationRole

InstanceFailoverGroupReplicationRole

Yük devretme grubu örneğinin yerel çoğaltma rolü.

properties.replicationState

string

Yük devretme grubu örneğinin çoğaltma durumu.

type

string

Kaynak türü.

InstanceFailoverGroupListResult

Örnek yük devretme gruplarının listesi.

Name Tür Description
nextLink

string

Sonuçların sonraki sayfasını almak için bağlantı.

value

InstanceFailoverGroup[]

Sonuç dizisi.

InstanceFailoverGroupReadOnlyEndpoint

Yük devretme grubu örneğinin salt okunur uç noktası.

Name Tür Description
failoverPolicy

ReadOnlyEndpointFailoverPolicy

Yük devretme grubu için salt okunur uç noktanın yük devretme ilkesi.

InstanceFailoverGroupReadWriteEndpoint

Yük devretme grubu örneğinin okuma-yazma uç noktası.

Name Tür Description
failoverPolicy

ReadWriteEndpointFailoverPolicy

Yük devretme grubu için okuma-yazma uç noktasının yük devretme ilkesi. failoverPolicy Otomatik ise failoverWithDataLossGracePeriodMinutes gereklidir.

failoverWithDataLossGracePeriodMinutes

integer

Okuma-yazma uç noktası için veri kaybıyla yük devretme denenmeden önce yetkisiz kullanım süresi. failoverPolicy Otomatik ise failoverWithDataLossGracePeriodMinutes gereklidir.

InstanceFailoverGroupReplicationRole

Yük devretme grubu örneğinin yerel çoğaltma rolü.

Name Tür Description
Primary

string

Secondary

string

ManagedInstancePairInfo

Yük devretme grubundaki Yönetilen Örnek çiftleri.

Name Tür Description
partnerManagedInstanceId

string

eşleştirilmiş İş Ortağı Yönetilen Örneğinin kimliği.

primaryManagedInstanceId

string

Çiftteki Birincil Yönetilen Örneğin kimliği.

PartnerRegionInfo

Yük devretme grubu için iş ortağı bölgesi bilgileri.

Name Tür Description
location

string

İş ortağı tarafından yönetilen örneklerin coğrafi konumu.

replicationRole

InstanceFailoverGroupReplicationRole

İş ortağı tarafından yönetilen örneklerin çoğaltma rolü.

ReadOnlyEndpointFailoverPolicy

Yük devretme grubu için salt okunur uç noktanın yük devretme ilkesi.

Name Tür Description
Disabled

string

Enabled

string

ReadWriteEndpointFailoverPolicy

Yük devretme grubu için okuma-yazma uç noktasının yük devretme ilkesi. failoverPolicy Otomatik ise failoverWithDataLossGracePeriodMinutes gereklidir.

Name Tür Description
Automatic

string

Manual

string