Dela via

Managed Instances - Failover

Tjänst:
SQL Database
API-versionen:
2023-08-01

Redundansväxlingar en hanterad instans.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/failover?api-version=2023-08-01
Med valfria parametrar: 
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/failover?replicaType={replicaType}&api-version=2023-08-01

URI-parametrar

Namn I Krävs Typ Beskrivning
managedInstanceName
 path True

string

Namnet på den hanterade instansen som redundansväxlar.
resourceGroupName
 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.
subscriptionId
 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.
replicaType
 query

ReplicaType

Den typ av replik som ska växlas över.

Svaren

Namn Typ Beskrivning
200 OK

Redundansen av den hanterade instansen har slutförts.
202 Accepted

Redundansväxling av hanterade instanser pågår.

Headers

Location: string
Other Status Codes

ErrorResponse

Felsvar: ***

  • 400 ManagedInstanceFailoverNotSupportedOnSKU – Den här typen av kundinitierad redundans stöds inte på den angivna SKU:n.

  • 400 ManagedInstanceFailoverThrottled – Redundansväxling på den hanterade instansen nyligen.

  • 400 ManagedInstanceStoppingOrS toppad – Konfliktåtgärd som skickas när instansen är i stopptillstånd

  • 400 ManagedInstanceStarting – Konfliktåtgärd som skickas när instansen är i starttillstånd

  • 404 ServerNotInSubscriptionResourceGroup – Den angivna servern finns inte i den angivna resursgruppen och prenumerationen.

  • 404 SubscriptionDoesNotHaveServer – Den begärda servern hittades inte

  • 404 OperationIdNotFound – Åtgärden med ID finns inte.

  • 409 ManagedInstanceFailoverFullBackupMissing – Automatisk säkerhetskopiering måste slutföra den första fullständiga säkerhetskopieringen för en ny databas.

  • 409 ManagedInstanceNotInStateToFailover – Den hanterade instansen är för närvarande i ett tillstånd som gör att redundans inte kan utfärdas.

  • 409 CannotCancelOperation – hanteringsåtgärden är i ett tillstånd som inte kan avbrytas.

  • 409 OperationCancelled – Åtgärden har avbrutits av användaren.

  • 409 Åtgärd avbröts – Det gick inte att slutföra åtgärden på resursen eftersom den avbröts av en annan åtgärd på samma resurs.

  • 429 SubscriptionTooManyCreateUpdateRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser.

  • 429 SubscriptionTooManyRequests – Begäranden utöver maxbegäranden som kan bearbetas av tillgängliga resurser.

  • 500 OperationTimedOut – Tidsgränsen för åtgärden uppnåddes och återställdes automatiskt. Försök igen.

  • 503 TooManyRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser.

Exempel

Failover a managed instance.

Exempelförfrågan

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/managedInstances/instanceName/failover?replicaType=Primary&api-version=2023-08-01

Exempelsvar

Statuskod:
200
Statuskod:
202 
Location: https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/westus/managedInstanceOperationResults/00000000-1111-2222-3333-444444444444?api-version=2019-06-01-preview

Definitioner

Namn Beskrivning
ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.
ErrorDetail

Felinformationen.
ErrorResponse

Felsvar
ReplicaType

Den typ av replik som ska växlas över.

ErrorAdditionalInfo

Objekt

Ytterligare information om resurshanteringsfelet.

Namn Typ Beskrivning
info

object

Ytterligare information.
type

string

Ytterligare informationstyp.

ErrorDetail

Objekt

Felinformationen.

Namn Typ Beskrivning
additionalInfo

ErrorAdditionalInfo[]

Ytterligare information om felet.
code

string

Felkoden.
details

ErrorDetail[]

Felinformationen.
message

string

Felmeddelandet.
target

string

Felmålet.

ErrorResponse

Objekt

Felsvar

Namn Typ Beskrivning
error

ErrorDetail

Felobjektet.

ReplicaType

Uppräkning

Den typ av replik som ska växlas över.

Värde Beskrivning
Primary
ReadableSecondary