Failover Groups - Create Or Update
Vytvoří nebo aktualizuje skupinu převzetí služeb při selhání.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/failoverGroups/{failoverGroupName}?api-version=2023-08-01
Parametry identifikátoru URI
Name | V | Vyžadováno | Typ | Description |
---|---|---|---|---|
failover
|
path | True |
string |
Název skupiny převzetí služeb při selhání. |
resource
|
path | True |
string |
Název skupiny prostředků, která obsahuje prostředek. Tuto hodnotu můžete získat z rozhraní API Azure Resource Manageru nebo portálu. |
server
|
path | True |
string |
Název serveru obsahujícího skupinu převzetí služeb při selhání. |
subscription
|
path | True |
string |
ID předplatného, které identifikuje předplatné Azure. |
api-version
|
query | True |
string |
Verze rozhraní API, která se má použít pro požadavek. |
Text požadavku
Name | Vyžadováno | Typ | Description |
---|---|---|---|
properties.partnerServers | True |
Seznam informací o partnerském serveru pro skupinu převzetí služeb při selhání |
|
properties.readWriteEndpoint | True |
Koncový bod pro čtení i zápis instance skupiny převzetí služeb při selhání |
|
properties.databases |
string[] (arm-id) |
Seznam databází ve skupině převzetí služeb při selhání |
|
properties.readOnlyEndpoint |
Koncový bod skupiny převzetí služeb při selhání jen pro čtení. |
||
properties.secondaryType |
Sekundární typ databáze na partnerském serveru. |
||
tags |
object |
Značky prostředků |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
Skupina převzetí služeb při selhání byla úspěšně aktualizována. |
|
201 Created |
Skupina převzetí služeb při selhání byla úspěšně vytvořena. |
|
202 Accepted |
Přijal Hlavičky Location: string |
|
Other Status Codes |
Chybové odpovědi: ***
|
Příklady
Create failover group |
Create failover group with standby secondary database on partner server. |
Create failover group
Ukázkový požadavek
PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/failoverGroups/failover-group-test-3?api-version=2023-08-01
{
"properties": {
"readWriteEndpoint": {
"failoverPolicy": "Automatic",
"failoverWithDataLossGracePeriodMinutes": 480
},
"readOnlyEndpoint": {
"failoverPolicy": "Disabled"
},
"partnerServers": [
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server"
}
],
"databases": [
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-1",
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-2"
]
}
}
Ukázková odpověď
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/failoverGroups/failover-group-test-3",
"name": "failover-group-test-3",
"type": "Microsoft.Sql/servers/failoverGroups",
"location": "Japan East",
"properties": {
"readWriteEndpoint": {
"failoverPolicy": "Automatic",
"failoverWithDataLossGracePeriodMinutes": 480
},
"readOnlyEndpoint": {
"failoverPolicy": "Disabled",
"targetServer": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server"
},
"replicationRole": "Primary",
"replicationState": "CATCH_UP",
"partnerServers": [
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server",
"location": "Japan West",
"replicationRole": "Secondary"
}
],
"databases": [
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-1",
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-2"
]
}
}
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/failoverGroups/failover-group-test-3",
"name": "failover-group-test-3",
"type": "Microsoft.Sql/servers/failoverGroups",
"location": "Japan East",
"properties": {
"readWriteEndpoint": {
"failoverPolicy": "Automatic",
"failoverWithDataLossGracePeriodMinutes": 480
},
"readOnlyEndpoint": {
"failoverPolicy": "Disabled",
"targetServer": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server"
},
"replicationRole": "Primary",
"replicationState": "CATCH_UP",
"partnerServers": [
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server",
"location": "Japan West",
"replicationRole": "Secondary"
}
],
"databases": [
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-1",
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-2"
]
}
}
Location: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/japaneast/failoverGroupOperationResults/11111111-1111-1111-1111-111111111111
Create failover group with standby secondary database on partner server.
Ukázkový požadavek
PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/failoverGroups/failover-group-test-3?api-version=2023-08-01
{
"properties": {
"readWriteEndpoint": {
"failoverPolicy": "Automatic",
"failoverWithDataLossGracePeriodMinutes": 480
},
"readOnlyEndpoint": {
"failoverPolicy": "Disabled"
},
"partnerServers": [
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server"
}
],
"databases": [
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-1",
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-2"
],
"secondaryType": "Standby"
}
}
Ukázková odpověď
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/failoverGroups/failover-group-test-3",
"name": "failover-group-test-3",
"type": "Microsoft.Sql/servers/failoverGroups",
"location": "Japan East",
"properties": {
"readWriteEndpoint": {
"failoverPolicy": "Automatic",
"failoverWithDataLossGracePeriodMinutes": 480
},
"readOnlyEndpoint": {
"failoverPolicy": "Disabled",
"targetServer": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server"
},
"replicationRole": "Primary",
"replicationState": "CATCH_UP",
"partnerServers": [
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server",
"location": "Japan West",
"replicationRole": "Secondary"
}
],
"databases": [
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-1",
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-2"
]
}
}
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/failoverGroups/failover-group-test-3",
"name": "failover-group-test-3",
"type": "Microsoft.Sql/servers/failoverGroups",
"location": "Japan East",
"properties": {
"readWriteEndpoint": {
"failoverPolicy": "Automatic",
"failoverWithDataLossGracePeriodMinutes": 480
},
"readOnlyEndpoint": {
"failoverPolicy": "Disabled",
"targetServer": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server"
},
"replicationRole": "Primary",
"replicationState": "CATCH_UP",
"partnerServers": [
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server",
"location": "Japan West",
"replicationRole": "Secondary"
}
],
"databases": [
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-1",
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-2"
]
}
}
Location: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/japaneast/failoverGroupOperationResults/11111111-1111-1111-1111-111111111111
Definice
Name | Description |
---|---|
Error |
Další informace o chybě správy prostředků |
Error |
Podrobnosti o chybě. |
Error |
Chybová odpověď |
Failover |
Skupina převzetí služeb při selhání. |
Failover |
Sekundární typ databáze na partnerském serveru. |
Failover |
Koncový bod skupiny převzetí služeb při selhání jen pro čtení. |
Failover |
Koncový bod pro čtení i zápis instance skupiny převzetí služeb při selhání |
Failover |
Role místní replikace instance skupiny převzetí služeb při selhání |
Partner |
Informace o partnerském serveru pro skupinu převzetí služeb při selhání |
Read |
Zásady převzetí služeb při selhání koncového bodu jen pro čtení pro skupinu převzetí služeb při selhání |
Read |
Zásady převzetí služeb při selhání koncového bodu pro čtení a zápis pro skupinu převzetí služeb při selhání Pokud je hodnota failoverPolicy automatická, je vyžadováno převzetí služeb při selháníWithDataLossGracePeriodMinutes. |
ErrorAdditionalInfo
Další informace o chybě správy prostředků
Name | Typ | Description |
---|---|---|
info |
object |
Další informace. |
type |
string |
Další typ informací. |
ErrorDetail
Podrobnosti o chybě.
Name | Typ | Description |
---|---|---|
additionalInfo |
Další informace o chybě. |
|
code |
string |
Kód chyby. |
details |
Podrobnosti o chybě. |
|
message |
string |
Chybová zpráva. |
target |
string |
Cíl chyby. |
ErrorResponse
Chybová odpověď
Name | Typ | Description |
---|---|---|
error |
Objekt chyby. |
FailoverGroup
Skupina převzetí služeb při selhání.
Name | Typ | Description |
---|---|---|
id |
string |
ID prostředku. |
location |
string |
Umístění prostředku |
name |
string |
Název prostředku |
properties.databases |
string[] (arm-id) |
Seznam databází ve skupině převzetí služeb při selhání |
properties.partnerServers |
Seznam informací o partnerském serveru pro skupinu převzetí služeb při selhání |
|
properties.readOnlyEndpoint |
Koncový bod skupiny převzetí služeb při selhání jen pro čtení. |
|
properties.readWriteEndpoint |
Koncový bod pro čtení i zápis instance skupiny převzetí služeb při selhání |
|
properties.replicationRole |
Role místní replikace instance skupiny převzetí služeb při selhání |
|
properties.replicationState |
string |
Stav replikace instance skupiny převzetí služeb při selhání |
properties.secondaryType |
Sekundární typ databáze na partnerském serveru. |
|
tags |
object |
Značky prostředků |
type |
string |
Typ prostředku. |
FailoverGroupDatabasesSecondaryType
Sekundární typ databáze na partnerském serveru.
Hodnota | Description |
---|---|
Geo | |
Standby |
FailoverGroupReadOnlyEndpoint
Koncový bod skupiny převzetí služeb při selhání jen pro čtení.
Name | Typ | Description |
---|---|---|
failoverPolicy |
Zásady převzetí služeb při selhání koncového bodu jen pro čtení pro skupinu převzetí služeb při selhání |
|
targetServer |
string (arm-id) |
Cílový partnerový server, na který koncový bod jen pro čtení odkazuje. |
FailoverGroupReadWriteEndpoint
Koncový bod pro čtení i zápis instance skupiny převzetí služeb při selhání
Name | Typ | Description |
---|---|---|
failoverPolicy |
Zásady převzetí služeb při selhání koncového bodu pro čtení a zápis pro skupinu převzetí služeb při selhání Pokud je hodnota failoverPolicy automatická, je vyžadováno převzetí služeb při selháníWithDataLossGracePeriodMinutes. |
|
failoverWithDataLossGracePeriodMinutes |
integer (int32) |
Období odkladu před převzetím služeb při selhání se ztrátou dat se pokusí o koncový bod pro čtení i zápis. Pokud je hodnota failoverPolicy automatická, je vyžadováno převzetí služeb při selháníWithDataLossGracePeriodMinutes. |
FailoverGroupReplicationRole
Role místní replikace instance skupiny převzetí služeb při selhání
Hodnota | Description |
---|---|
Primary | |
Secondary |
PartnerInfo
Informace o partnerském serveru pro skupinu převzetí služeb při selhání
Name | Typ | Description |
---|---|---|
id |
string (arm-id) |
Identifikátor prostředku partnerského serveru. |
location |
string |
Geografické umístění partnerského serveru |
replicationRole |
Role replikace partnerského serveru |
ReadOnlyEndpointFailoverPolicy
Zásady převzetí služeb při selhání koncového bodu jen pro čtení pro skupinu převzetí služeb při selhání
Hodnota | Description |
---|---|
Disabled | |
Enabled |
ReadWriteEndpointFailoverPolicy
Zásady převzetí služeb při selhání koncového bodu pro čtení a zápis pro skupinu převzetí služeb při selhání Pokud je hodnota failoverPolicy automatická, je vyžadováno převzetí služeb při selháníWithDataLossGracePeriodMinutes.
Hodnota | Description |
---|---|
Automatic | |
Manual |