Instance Failover Groups - Create Or Update
建立或更新故障轉移群組。
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/locations/{locationName}/instanceFailoverGroups/{failoverGroupName}?api-version=2021-11-01
URI 參數
名稱 | 位於 | 必要 | 類型 | Description |
---|---|---|---|---|
failover
|
path | True |
string |
故障轉移群組的名稱。 |
location
|
path | True |
string |
資源所在的區域名稱。 |
resource
|
path | True |
string |
包含資源的資源群組名稱。 您可以從 Azure 資源管理員 API 或入口網站取得這個值。 |
subscription
|
path | True |
string |
可識別 Azure 訂用帳戶的訂用帳戶識別碼。 |
api-version
|
query | True |
string |
要用於要求的 API 版本。 |
要求本文
名稱 | 必要 | 類型 | Description |
---|---|---|---|
properties.managedInstancePairs | True |
故障轉移群組中的受控實例配對清單。 |
|
properties.partnerRegions | True |
故障轉移群組的合作夥伴區域資訊。 |
|
properties.readWriteEndpoint | True |
故障轉移群組實例的讀寫端點。 |
|
properties.readOnlyEndpoint |
故障轉移群組實例的唯讀端點。 |
回應
名稱 | 類型 | Description |
---|---|---|
200 OK |
已成功更新故障轉移群組。 |
|
201 Created |
已成功建立故障轉移群組。 |
|
202 Accepted |
已接受 |
|
Other Status Codes |
錯誤回應: ≦
|
範例
Create failover group
範例要求
PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/Japan East/instanceFailoverGroups/failover-group-test-3?api-version=2021-11-01
{
"properties": {
"readWriteEndpoint": {
"failoverPolicy": "Automatic",
"failoverWithDataLossGracePeriodMinutes": 480
},
"readOnlyEndpoint": {
"failoverPolicy": "Disabled"
},
"partnerRegions": [
{
"location": "Japan West"
}
],
"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-3",
"name": "failover-group-test-3",
"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-3",
"name": "failover-group-test-3",
"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"
}
]
}
}
定義
名稱 | Description |
---|---|
Instance |
實例故障轉移群組。 |
Instance |
故障轉移群組實例的唯讀端點。 |
Instance |
故障轉移群組實例的讀寫端點。 |
Instance |
故障轉移群組實例的本機複寫角色。 |
Managed |
故障轉移群組中的受控實例配對。 |
Partner |
故障轉移群組的合作夥伴區域資訊。 |
Read |
故障轉移群組之只讀端點的故障轉移原則。 |
Read |
故障轉移群組之讀寫端點的故障轉移原則。 如果 failoverPolicy 為 Automatic,則需要 failoverWithDataLossGracePeriodMinutes。 |
InstanceFailoverGroup
實例故障轉移群組。
名稱 | 類型 | Description |
---|---|---|
id |
string |
資源識別碼。 |
name |
string |
資源名稱。 |
properties.managedInstancePairs |
故障轉移群組中的受控實例配對清單。 |
|
properties.partnerRegions |
故障轉移群組的合作夥伴區域資訊。 |
|
properties.readOnlyEndpoint |
故障轉移群組實例的唯讀端點。 |
|
properties.readWriteEndpoint |
故障轉移群組實例的讀寫端點。 |
|
properties.replicationRole |
故障轉移群組實例的本機複寫角色。 |
|
properties.replicationState |
string |
故障轉移群組實例的復寫狀態。 |
type |
string |
資源類型。 |
InstanceFailoverGroupReadOnlyEndpoint
故障轉移群組實例的唯讀端點。
名稱 | 類型 | Description |
---|---|---|
failoverPolicy |
故障轉移群組之只讀端點的故障轉移原則。 |
InstanceFailoverGroupReadWriteEndpoint
故障轉移群組實例的讀寫端點。
名稱 | 類型 | Description |
---|---|---|
failoverPolicy |
故障轉移群組之讀寫端點的故障轉移原則。 如果 failoverPolicy 為 Automatic,則需要 failoverWithDataLossGracePeriodMinutes。 |
|
failoverWithDataLossGracePeriodMinutes |
integer |
嘗試進行讀寫端點的數據遺失故障轉移之前的寬限期。 如果 failoverPolicy 為 Automatic,則需要 failoverWithDataLossGracePeriodMinutes。 |
InstanceFailoverGroupReplicationRole
故障轉移群組實例的本機複寫角色。
名稱 | 類型 | Description |
---|---|---|
Primary |
string |
|
Secondary |
string |
ManagedInstancePairInfo
故障轉移群組中的受控實例配對。
名稱 | 類型 | Description |
---|---|---|
partnerManagedInstanceId |
string |
合作夥伴 受控執行個體的標識碼。 |
primaryManagedInstanceId |
string |
配對的主要 受控執行個體標識碼。 |
PartnerRegionInfo
故障轉移群組的合作夥伴區域資訊。
名稱 | 類型 | Description |
---|---|---|
location |
string |
合作夥伴受控實例的地理位置。 |
replicationRole |
夥伴受控實例的複寫角色。 |
ReadOnlyEndpointFailoverPolicy
故障轉移群組之只讀端點的故障轉移原則。
名稱 | 類型 | Description |
---|---|---|
Disabled |
string |
|
Enabled |
string |
ReadWriteEndpointFailoverPolicy
故障轉移群組之讀寫端點的故障轉移原則。 如果 failoverPolicy 為 Automatic,則需要 failoverWithDataLossGracePeriodMinutes。
名稱 | 類型 | Description |
---|---|---|
Automatic |
string |
|
Manual |
string |