Instance Failover Groups - List By Location

Bir konumdaki yük devretme gruplarını listeler.

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

URI Parametreleri

Name In Required Type 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 portalından elde edebilirsiniz.

subscriptionId
path True
  • string

Bir 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 Type Description
200 OK

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

Other Status Codes

Hata yanıtları: * * _

_ 400 ınstancefailovergroupcreateorupdaterequestınvalidpartner-oluşturma veya güncelleştirme örneği yük devretme grubu istek gövdesi içindeki verilen iş ortakları alanı boş veya geçersiz.

  • 400 ınstancefailovergroupcreateorupdaterequestduplicatepartner-bir veya daha fazla sağlanmış iş ortağı sunucusu zaten örnek yük devretme grubunun bir parçası. Lütfen birincil sunucunun ve tüm verilen iş ortağı sunucularının benzersiz olduğundan emin olun.

  • 400 ınstancefailovergroupcreateorupdaterequestınvalidmanagedınstanceregion-örnek yük devretme grubu istek gövdesinde belirtilen iş ortağı yönetilen örnek bölgesi boş veya geçersiz.

  • 400 ınstancefailovergroupcreateorupdaterequestunsupportedpartnercount-yalnızca bir iş ortağı bölgesi destekleniyor.

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

  • 400 ınstancefailovergroupcreateorupdaterequestınvalidreadwriteendpoint-oluşturma veya güncelleştirme istekleri için readWriteEndpoint alanı gereklidir.

  • 400 ınstancefailovergroupcreateorupdaterequestgeçersiz-oluşturma veya güncelleştirme örneği yük devretme grubu istek gövdesi boş veya geçersiz.

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

  • 400 InstanceFailoverGroupCreateOrUpdateRequestNegativeGracePeriodValues-okuma-yazma uç noktası için yetkisiz kullanım süresi değeri negatif olmayan bir değer olmalıdır.

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

  • 400 ınstancefailovergroupcreateorupdaterequestınvalidreadwritefailoverpolicy-oluşturma veya güncelleştirme istekleri için okuma-yazma uç noktası için failoverPolicy alanı gereklidir.

  • 400 ınstancefailovergroupcreateorupdaterequestınvalidreadwriteendpointalanlar Formanualpolicy-okuma-yazma uç noktası için yük devretme İlkesi El Ile seçildiğinde, yetkisiz kullanım süresi değeri sağlanmamalıdır.

  • 400 ınstancefailovergroupcreateorupdaterequestreadonlypropertymodified-oluşturma veya güncelleştirme örneği yük devretme grubu istek gövdesi, salt okunurdur ' ' özelliğini değiştirmemelidir {0} .

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

  • 400 ınstancefailovergrouppartnermanagedınstancefromfarklıentsubscription-birincil sunucu ve yük devretme grubunun iş ortağı sunucusu farklı aboneliklerden. Yük devretme grubu sunucuları için çapraz aboneliğe izin verilmez.

  • 400 ınvalidtargetsubregion-okunabilir olmayan bir ikincil sunucunun hedef sunucusu, DR eşleştirilmiş bir Azure bölgesinde değil.

  • 400 Geodrınstancesizeuyuşmazlığı-birincil yönetilen örnek ve iş ortağı yönetilen örneği aynı depolama boyutuna sahip değil.

  • 400 Securityadalsprincipalcertexpiretno-Azure Key Vault asıl sertifikanın süresi sona erdiğinden işlem tamamlanamadı.

  • 400 Geodrsecondaryınstancenotempty-Ikincil yönetilen örnek, Kullanıcı veritabanlarına sahiptir. Ö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şılamıyor.

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

  • 400 Securityınvalidazurekeyvaultrecoverylevel-belirtilen Key Vault URI 'si geçerli değil.

  • 400 Keymaterialnotfoundonuzaksunucu-uzak sunucunun TDE koruyucusu olarak kullanılan anahtar malzemesine erişimi yok.

  • 400 AzureKeyVaultMismatchError-http yanıtında beklenmeyen Key Vault bölgesi bulundu.

  • 400 AzureKeyVaultRsaKeyNotSupported-belirtilen anahtar kasası desteklenmeyen RSA anahtar boyutu veya anahtar türü kullanıyor. Desteklenen RSA anahtar boyutu 2048 veya 3072, anahtar türü RSA veya RSA-HSM ' dir.

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

  • 400 RemoteDatabaseCopyPermission-Kullanıcı, belirtilen sunucuda bir veritabanı kopyası oluşturmak için yeterli izne sahip değil.

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

  • 400 ınvalidfailovergroupregion-bir örnek yük devretme grubunda belirtilen sunucuların, yalıtım sağlamak için farklı bölgelerde bulunması gerekir.

  • 400 ınstancefailovergroupyoktu notexist-bir sunucuda yük devretme grubu yok.

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

  • 400 ınvalidservername-geçersiz sunucu adı belirtildi.

  • 400 InvalidIdentifier-tanımlayıcı NULL veya geçersiz bir Unicode karakteri içeriyor.

  • 400 TokenTooLong-belirtilen belirteç çok uzun.

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

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

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

  • 400 ınvalidsku-Kullanıcı geçersiz bir SKU belirtti.

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

  • 400 ServerNotFound-istenen 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 gerekli izinler eksik Azure Key Vault.

  • 400 SecurityAzureKeyVaultInvalidKeyName-geçersiz bir sunucu anahtar adı nedeniyle işlem tamamlanamadı.

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

  • 400 Plannedfailovertimeout-Kullanıcı planlı yük devretme çağırdı ve iş ortağı yönetim hizmeti ile iletişim kurmaya çalışırken zaman aşımına uğradı.

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

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

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

  • 400 AzureKeyVaultMalformedVaultUri-belirtilen Key Vault URI 'si 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-istenen 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 Managedınstancehashyıbridlink-Kullanıcı, yönetilen örnek tarafından yapılandırılmış bir karma bağlantı olduğunda desteklenmeyen bir işlem başlatmayı denedi.

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

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

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

  • 409 ınstancefailovergroupalreadyexists-belirli bir sunucuda yük devretme grubu zaten var.

  • 409 ınstancefailovergroupbusy-örnek yük devretme grubu başka bir işlemle meşgul.

  • 409 GeoReplicationCannotBecomePrimaryDuringUndo-Kullanıcı, fiziksel olarak tutarlı olmayan bir durumda olduğu ve birincil rolü giremediğinden bir coğrafi bağlantının yük devretmesini veya zorla sonlandırılmaya çalıştı.

  • 409 ınstancefailovergroupdnsrecordinuse-istenen 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 Serverkeybir notexists-sunucu anahtarı yok.

  • 409 ınvalidfailovergroupname-geçersiz örnek yük devretme grubu adı sağlandı.

  • 409 Updatesloınprogress-bir SLO güncelleştirmesi sürerken Kullanıcı uyumsuz bir işlem başlatmayı denedi.

  • 409 AzureKeyVaultKeyNameNotFound-Azure Key Vault anahtar adı bulunmadığından işlem tamamlanamadı.

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

  • 409 Conflictingsystemoperationınprogress-veritabanında bir sistem bakım işlemi devam ediyor ve tamamlanana kadar bekleyen işlemler var.

  • 409 InvalidOperationForDatabaseNotInReplicationRelationship-zaten bir çoğaltma ilişkisinde olan bir veritabanında çoğaltma dengeli dağıtım işlemi gerçekleştirildi.

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

  • 409 DuplicateGeoDrRelation-veritabanları zaten bir çoğaltma ilişkisinde. Bu, yinelenen bir istek.

  • 429 SubscriptionTooManyCreateUpdateRequests-kullanılabilir kaynaklar tarafından işlenebilecek en fazla isteklerin ötesinde Istekler.

  • 429 SubscriptionTooManyRequests-kullanılabilir kaynaklar tarafından işlenebilecek en fazla isteklerin ötesinde Istek.

  • 503 TooManyRequests-kullanılabilir kaynaklar tarafından işlenebilecek en fazla isteklerin ötesinde Istek.

  • 503 AzureKeyVaultConnectionFailed-Azure Key Vault bağlanma girişimleri başarısız olduğundan sunucu üzerinde 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

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-02-01-preview

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/failoverGroups",
      "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/failoverGroups",
      "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

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 grubunda 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, yük devretmeWithDataLossGracePeriodMinutes gereklidir.

InstanceFailoverGroup

Örnek yük devretme grubu.

Name Type Description
id
  • string

Kaynak Kimliği.

name
  • string

Kaynak adı.

properties.managedInstancePairs

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

properties.partnerRegions

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

properties.readOnlyEndpoint

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

properties.readWriteEndpoint

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

properties.replicationRole

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 Type Description
nextLink
  • string

Sonraki sonuç sayfasını alma bağlantısı.

value

Sonuç dizisi.

InstanceFailoverGroupReadOnlyEndpoint

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

Name Type Description
failoverPolicy

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 Type Description
failoverPolicy

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

failoverWithDataLossGracePeriodMinutes
  • integer

Okuma-yazma uç noktası için veri kaybıyla yük devretme öncesinde yetkisiz kullanım süresi denenir. failoverPolicy Otomatik ise, yük devretmeWithDataLossGracePeriodMinutes gereklidir.

InstanceFailoverGroupReplicationRole

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

Name Type Description
Primary
  • string
Secondary
  • string

ManagedInstancePairInfo

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

Name Type Description
partnerManagedInstanceId
  • string

İş Ortağı Yönetilen Örneği çiftinin kimliği.

primaryManagedInstanceId
  • string

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

PartnerRegionInfo

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

Name Type Description
location
  • string

İş ortağı yönetilen örneklerinin coğrafi konumu.

replicationRole

İş ortağı yönetilen örneklerinin çoğaltma rolü.

ReadOnlyEndpointFailoverPolicy

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

Name Type 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, yük devretmeWithDataLossGracePeriodMinutes gereklidir.

Name Type Description
Automatic
  • string
Manual
  • string