Instance Failover Groups - Create Or Update
Skapar eller uppdaterar en redundansgrupp.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/locations/{locationName}/instanceFailoverGroups/{failoverGroupName}?api-version=2023-08-01
		URI-parametrar
| Name | I | Obligatorisk | Typ | Description | 
|---|---|---|---|---|
| 
						 failover 
					 | 
					path | True | 
			 string  | 
					
						 Namnet på redundansgruppen.  | 
				
| 
						 location 
					 | 
					path | True | 
			 string  | 
					
						 Namnet på den region där resursen finns.  | 
				
| 
						 resource 
					 | 
					path | True | 
			 string  | 
					
						 Namnet på resursgruppen som innehåller resursen. Du kan hämta det här värdet från Azure Resource Manager-API:et eller portalen.  | 
				
| 
						 subscription 
					 | 
					path | True | 
			 string  | 
					
						 Det prenumerations-ID som identifierar en Azure-prenumeration.  | 
				
| 
						 api-version 
					 | 
					query | True | 
			 string  | 
					
						 DEN API-version som ska användas för begäran.  | 
				
Begärandetext
| Name | Obligatorisk | Typ | Description | 
|---|---|---|---|
| properties.managedInstancePairs | True | 
		 Lista över hanterade instanspar i redundansgruppen.  | 
|
| properties.partnerRegions | True | 
		 Information om partnerregion för redundansgruppen.  | 
|
| properties.readWriteEndpoint | True | 
		 Skrivskyddad slutpunkt för redundansklusterinstansen.  | 
|
| properties.readOnlyEndpoint | 
		 Skrivskyddad slutpunkt för redundansklusterinstansen.  | 
||
| properties.secondaryType | 
		 Typ av geo-sekundär instans. Ange "Vänteläge" om instansen endast används som dr-alternativ.  | 
Svar
| Name | Typ | Description | 
|---|---|---|
| 200 OK | 
		 Redundansgruppen har uppdaterats.  | 
|
| 201 Created | 
		 Redundansgruppen har skapats.  | 
|
| 202 Accepted | 
		 Accepterad Sidhuvuden Location: string  | 
|
| Other Status Codes | 
		 Felsvar: *** 
  | 
Exempel
Create failover group
Exempelbegäran
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=2023-08-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"
      }
    ],
    "secondaryType": "Geo"
  }
}
Exempelsvar
{
  "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"
      }
    ],
    "secondaryType": "Geo"
  }
}
						
							{
  "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"
      }
    ],
    "secondaryType": "Geo"
  }
}
						
				Definitioner
| Name | Description | 
|---|---|
| 
							Error | 
						
							 Ytterligare information om resurshanteringsfelet.  | 
					
| 
							Error | 
						
							 Felinformationen.  | 
					
| 
							Error | 
						
							 Felsvar  | 
					
| 
							Instance | 
						
							 En redundansgrupp för instanser.  | 
					
| 
							Instance | 
						
							 Skrivskyddad slutpunkt för redundansklusterinstansen.  | 
					
| 
							Instance | 
						
							 Skrivskyddad slutpunkt för redundansklusterinstansen.  | 
					
| 
							Instance | 
						
							 Den lokala replikeringsrollen för redundansklusterinstansen.  | 
					
| 
							Managed | 
						
							 Par med hanterade instanser i redundansgruppen.  | 
					
| 
							Partner | 
						
							 Information om partnerregion för redundansgruppen.  | 
					
| 
							Read | 
						
							 Redundansprincip för den skrivskyddade slutpunkten för redundansgruppen.  | 
					
| 
							Read | 
						
							 Redundansprincip för skrivskyddad slutpunkt för redundansgruppen. Om failoverPolicy är Automatisk krävs failoverWithDataLossGracePeriodMinutes.  | 
					
| 
							Secondary | 
						
							 Typ av geo-sekundär instans. Ange "Vänteläge" om instansen endast används som dr-alternativ.  | 
					
ErrorAdditionalInfo  
			
			Ytterligare information om resurshanteringsfelet.
| Name | Typ | Description | 
|---|---|---|
| info | 
			 object  | 
	
		 Ytterligare information.  | 
| type | 
			 string  | 
	
		 Ytterligare informationstyp.  | 
ErrorDetail 
			
			Felinformationen.
| Name | Typ | Description | 
|---|---|---|
| additionalInfo | 
		 Ytterligare information om felet.  | 
|
| code | 
			 string  | 
	
		 Felkoden.  | 
| details | 
		 Felinformationen.  | 
|
| message | 
			 string  | 
	
		 Felmeddelandet.  | 
| target | 
			 string  | 
	
		 Felmålet.  | 
ErrorResponse 
			
			Felsvar
| Name | Typ | Description | 
|---|---|---|
| error | 
		 Felobjektet.  | 
InstanceFailoverGroup  
			
			En redundansgrupp för instanser.
| Name | Typ | Description | 
|---|---|---|
| id | 
			 string  | 
	
		 Resurs-ID.  | 
| name | 
			 string  | 
	
		 Resursnamn.  | 
| properties.managedInstancePairs | 
		 Lista över hanterade instanspar i redundansgruppen.  | 
|
| properties.partnerRegions | 
		 Information om partnerregion för redundansgruppen.  | 
|
| properties.readOnlyEndpoint | 
		 Skrivskyddad slutpunkt för redundansklusterinstansen.  | 
|
| properties.readWriteEndpoint | 
		 Skrivskyddad slutpunkt för redundansklusterinstansen.  | 
|
| properties.replicationRole | 
		 Den lokala replikeringsrollen för redundansklusterinstansen.  | 
|
| properties.replicationState | 
			 string  | 
	
		 Replikeringstillstånd för redundansklusterinstansen.  | 
| properties.secondaryType | 
		 Typ av geo-sekundär instans. Ange "Vänteläge" om instansen endast används som dr-alternativ.  | 
|
| type | 
			 string  | 
	
		 Resurstyp.  | 
InstanceFailoverGroupReadOnlyEndpoint     
			
			Skrivskyddad slutpunkt för redundansklusterinstansen.
| Name | Typ | Description | 
|---|---|---|
| failoverPolicy | 
		 Redundansprincip för den skrivskyddade slutpunkten för redundansgruppen.  | 
InstanceFailoverGroupReadWriteEndpoint     
			
			Skrivskyddad slutpunkt för redundansklusterinstansen.
| Name | Typ | Description | 
|---|---|---|
| failoverPolicy | 
		 Redundansprincip för skrivskyddad slutpunkt för redundansgruppen. Om failoverPolicy är Automatisk krävs failoverWithDataLossGracePeriodMinutes.  | 
|
| failoverWithDataLossGracePeriodMinutes | 
			 integer (int32)  | 
	
		 Respitperiod före redundansväxling med dataförlust görs för läs- och skrivslutpunkten. Om failoverPolicy är Automatisk krävs failoverWithDataLossGracePeriodMinutes.  | 
InstanceFailoverGroupReplicationRole    
			
			Den lokala replikeringsrollen för redundansklusterinstansen.
| Värde | Description | 
|---|---|
| Primary | |
| Secondary | 
ManagedInstancePairInfo   
			
			Par med hanterade instanser i redundansgruppen.
| Name | Typ | Description | 
|---|---|---|
| partnerManagedInstanceId | 
			 string  | 
	
		 ID för partnerhanterad instans i par.  | 
| primaryManagedInstanceId | 
			 string  | 
	
		 ID för primär hanterad instans i par.  | 
PartnerRegionInfo  
			
			Information om partnerregion för redundansgruppen.
| Name | Typ | Description | 
|---|---|---|
| location | 
			 string  | 
	
		 Geoplats för partnerhanterade instanser.  | 
| replicationRole | 
		 Replikeringsrollen för partnerhanterade instanser.  | 
ReadOnlyEndpointFailoverPolicy    
			
			Redundansprincip för den skrivskyddade slutpunkten för redundansgruppen.
| Värde | Description | 
|---|---|
| Disabled | |
| Enabled | 
ReadWriteEndpointFailoverPolicy    
			
			Redundansprincip för skrivskyddad slutpunkt för redundansgruppen. Om failoverPolicy är Automatisk krävs failoverWithDataLossGracePeriodMinutes.
| Värde | Description | 
|---|---|
| Manual | |
| Automatic | 
SecondaryInstanceType  
			
			Typ av geo-sekundär instans. Ange "Vänteläge" om instansen endast används som dr-alternativ.
| Värde | Description | 
|---|---|
| Geo | |
| Standby |