Aktivera tjänstsäkerhetskopiering
Aktiverar regelbunden säkerhetskopiering av tillståndskänsliga partitioner under den här Service Fabric-tjänsten.
Möjliggör regelbunden säkerhetskopiering av tillståndskänsliga partitioner som ingår i den här Service Fabric-tjänsten. Varje partition säkerhetskopieras individuellt enligt den angivna beskrivningen av säkerhetskopieringsprincipen. Om programmet, som tjänsten är en del av, redan är aktiverat för säkerhetskopiering skulle den här åtgärden åsidosätta principen som används för att ta regelbunden säkerhetskopiering för den här tjänsten och dess partitioner (såvida den inte uttryckligen åsidosätts på partitionsnivå). Observera att endast C#-baserade Reliable Actor- och Reliable Stateful-tjänster för närvarande stöds för regelbunden säkerhetskopiering.
Förfrågan
Metod | URI för förfrågan |
---|---|
POST | /Services/{serviceId}/$/EnableBackup?api-version=6.4&timeout={timeout} |
Parametrar
Namn | Typ | Obligatorisk | Location |
---|---|---|---|
serviceId |
sträng | Ja | Sökväg |
api-version |
sträng | Ja | Söka i data |
timeout |
heltal (int64) | No | Söka i data |
EnableBackupDescription |
EnableBackupDescription | Yes | Brödtext |
serviceId
Typ: sträng
Obligatoriskt: Ja
Tjänstens identitet. Det här ID:t är vanligtvis det fullständiga namnet på tjänsten utan URI-schemat "fabric:".
Från och med version 6.0 avgränsas hierarkiska namn med tecknet "~".
Om tjänstnamnet till exempel är "fabric:/myapp/app1/svc1" skulle tjänstidentiteten vara "myapp~app1~svc1" i 6.0+ och "myapp/app1/svc1" i tidigare versioner.
api-version
Typ: sträng
Obligatoriskt: Ja
Standard: 6.4
Versionen av API:et. Den här parametern krävs och dess värde måste vara "6.4".
Service Fabric REST API-versionen baseras på körningsversionen där API:et introducerades eller ändrades. Service Fabric Runtime stöder mer än en version av API:et. Den här versionen är den senaste versionen av API:et som stöds. Om en lägre API-version skickas kan det returnerade svaret skilja sig från det som beskrivs i den här specifikationen.
Dessutom accepterar körningen alla versioner som är högre än den senaste versionen som stöds fram till den aktuella versionen av körningen. Så om den senaste API-versionen är 6.0 och körningen är 6.1 accepterar körningen version 6.1 för det API:et. Beteendet för API:et kommer dock att vara enligt den dokumenterade 6.0-versionen.
timeout
Typ: heltal (int64)
Obligatoriskt: Nej
Standard: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1
Serverns timeout för att utföra åtgärden i sekunder. Den här tidsgränsen anger hur lång tid klienten är villig att vänta på att den begärda åtgärden ska slutföras. Standardvärdet för den här parametern är 60 sekunder.
EnableBackupDescription
Typ: EnableBackupDescription
Obligatoriskt: Ja
Anger parametrarna för att aktivera säkerhetskopiering.
Svar
HTTP-statuskod | Description | Svarsschema |
---|---|---|
202 (accepterad) | En 202-statuskod anger att begäran om att aktivera säkerhetskopiering av tjänsten har accepterats. |
|
Alla andra statuskoder | Det detaljerade felsvaret. |
FabricError |
Exempel
Aktivera tjänstsäkerhetskopiering
Det här exemplet visar hur du aktiverar regelbunden säkerhetskopiering för en tillståndskänslig tjänst.
Förfrågan
POST http://localhost:19080/Services/CalcApp/CalcService/$/EnableBackup?api-version=6.4
Brödtext
{
"BackupPolicyName": "DailyAzureBackupPolicy"
}
202-svar
Brödtext
Svarstexten är tom.