Programlivscykel för Säkerhetskopiering i Microsoft 365 Storage

Registrera ett Säkerhetskopiering i Microsoft 365 Storage-program från tredje part

När ditt Säkerhetskopiering i Microsoft 365 Storage-program har getts tillstånd att köra i den konsumerande klientorganisationen, så att det kan vara Säkerhetskopiering i Microsoft 365 lagringskontrollant i en förbrukningsklientorganisation, måste du utföra följande programmässiga uppgifter (via ditt program):

1. Registrera ditt program som en Säkerhetskopiering i Microsoft 365 Storage Controller.

2. Kontrollera om Säkerhetskopiering i Microsoft 365-tjänsten är aktiverad i den förbrukningsklientorganisation som används.

3. Aktivera programmet så att det är Säkerhetskopiering i Microsoft 365 Storage Controller.

   • Om det fanns en befintlig kontrollant väntar du tills respitperioden har slutförts.

4. Aktivera din faktureringsprincip i den förbrukningsklientorganisation.

När programmet har registrerats kan du alltid kontrollera programmets tillstånd som Säkerhetskopiering i Microsoft 365 storage controller genom att köra Api:et Get serviceApp:

GET /solutions/backupRestore/serviceApps/{serviceAppId}

Steg 1: Registrera ditt program som en Säkerhetskopiering i Microsoft 365 Storage Controller

Om du vill registrera ditt program som en Säkerhetskopiering i Microsoft 365 storage controller måste du först registrera ditt program genom att köra API:et För att skapa tjänstens app:

POST /solutions/backupRestore/serviceApps/

Om programmet har registrerats har det statusen inaktiv. Det returnerade ID:t är tjänstappens ID för ditt program (vilket är ditt program-ID).

Steg 2: Kontrollera om Säkerhetskopiering i Microsoft 365-tjänsten är aktiverad i den förbrukningsklientorganisation som används

För att kontrollera om Säkerhetskopiering i Microsoft 365-tjänsten är aktiverad i den konsumerande klientorganisationen måste programmet köra API:et Get backupRestoreRoot:

GET /solutions/backupRestore/

Om det returnerade tillståndet är aktiverat anger det här tillståndet att det finns en aktiv Säkerhetskopiering i Microsoft 365 lagringskontrollant och att ändring av kontrollanten framtvingar en respitperiod. Alla andra tillstånd anger att det inte finns någon aktiv Säkerhetskopiering i Microsoft 365 lagringskontrollant och att ett program omedelbart kan bli kontrollanten vid registrering.

Steg 3: Aktivera programmet så att det blir Säkerhetskopiering i Microsoft 365 Storage Controller

För att aktivera ditt program som Säkerhetskopiering i Microsoft 365 Storage Controller beror på om det redan finns en befintlig Säkerhetskopiering i Microsoft 365 Storage Controller (antingen från första part eller tredje part).

Ingen befintlig Säkerhetskopiering i Microsoft 365 storage controller

Om det inte finns någon befintlig Säkerhetskopiering i Microsoft 365 storage controller kan du omedelbart aktivera programmet som kontrollant. Det här steget gör du genom att köra serviceApp: aktivera API:

POST /solutions/backupRestore/serviceApps/{serviceAppId}/activate

Om programmet aktiverades omedelbart har det statusen aktiv.

Befintlig Säkerhetskopiering i Microsoft 365 Storage Controller

Om det finns en befintlig Säkerhetskopiering i Microsoft 365 Storage Controller måste du ange ett datum/tid för när ändringen gäller när du aktiverar programmet som kontrollant. Datum/tid måste vara minst 7 dagar i framtiden, men inte större än 30 dagar.

För att aktivera ditt program måste du köra serviceApp: aktivera API som anger gällande datum/tid i begärande-JSON-brödtexten:

POST /solutions/backupRestore/serviceApps/{serviceAppId}/activate

Obs!

Om det redan pågår en väntande ändring av Säkerhetskopiering i Microsoft 365 Storage Controller misslyckas din begäran med en HTTP 403-felkod. Du kan inte aktivera programmet förrän den väntande ändringen har slutförts.

Om programmet har aktiverats för ett datum/en tid i framtiden har det tillståndet pendingActive.

Befintlig respitperiod för Säkerhetskopiering i Microsoft 365 lagringskontrollant

Om det fanns en befintlig Säkerhetskopiering i Microsoft 365 storage controller när du aktiverade ditt program framtvingar det här steget en respitperiod på mellan 7 och 30 dagar (som anges när du aktiverade programmet).

Under respitperioden:

• Programmet har tillståndet pendingActive.
• Programmet har skrivskyddad åtkomst till befintliga skyddsprinciper. Programmet kan inte ändra eller skapa skyddsprinciper eller utföra några återställningar.
• Den förbrukningsbegränsade säkerhetskopieringen av klientorganisationen Admin kan avbryta den väntande ändringen av Säkerhetskopiering i Microsoft 365 Storage Controller och återgå till ursprungligt tillstånd.
• Programmet kan avbryta den väntande ändringen av Säkerhetskopiering i Microsoft 365 Storage Controller och återgå till ursprungligt tillstånd genom att köra serviceApp: inaktivera API:

POST /solutions/backupRestore/serviceApps/{serviceAppId}/deactivate

• Ditt program kan kontrollera tillståndet för ditt program som Säkerhetskopiering i Microsoft 365 Storage Controller genom att köra Api:et Get serviceApp:

GET /solutions/backupRestore/serviceApps/{serviceAppId}

När respitperioden har slutförts:

• Programmet har statusen aktiv.

Steg 4: Aktivera din faktureringsprincip i den förbrukningsklientorganisation

När ditt program har statusen aktiv måste du aktivera din faktureringsprincip i den förbrukningsklientorganisation. Det här steget utförs genom att köra backupRestoreRoot: aktivera API:

POST /solutions/backupRestore/enable

När du har aktiverat faktureringsprincipen blir ditt program Säkerhetskopiering i Microsoft 365 lagringskontrollant i den förbrukningsbegränsade klienten och kan nu underhålla Säkerhetskopiering i Microsoft 365-tjänsten (enligt programmets oAuth-behörighetsomfång).

Obs!

Du kan köra det här API:et flera gånger eftersom det är idempotent. Vi rekommenderar att du aktiverar faktureringsprincipen i den förbrukningsklientorganisation om faktureringsprincipen av någon anledning ändras. Om du till exempel vill ändra Azure-prenumerations-ID eller resursgrupp.

Avregistrera ett Säkerhetskopiering i Microsoft 365 program

Ett annat program aktiveras som Säkerhetskopiering i Microsoft 365 Storage Controller

Om ditt program är aktivt Säkerhetskopiering i Microsoft 365 Storage Controller är det möjligt att ett annat program (första part eller tredje part) också kan aktiveras enligt registreringsprocessen som definieras i Befintlig-Säkerhetskopiering i Microsoft 365 Storage Controller och Befintlig Säkerhetskopiering i Microsoft 365 respitperiod för lagringskontrollant. Om den här händelsen inträffar meddelas inte programmet uttryckligen. Programmets tillstånd blir dock väntandeInaktivt.

Om du vill hämta tillståndet för ditt program som Säkerhetskopiering i Microsoft 365 storage controller kan ditt program köra Api:et Get serviceApp:

GET /solutions/backupRestore/serviceApps/{serviceAppId}

Under respitperioden:

• Programmet har tillståndet pendingInactive.
• Ditt program har fortfarande åtkomst till befintliga skyddsprinciper och kan ändra eller skapa skyddsprinciper eller utföra återställningar (enligt dina oAuth-behörighetsomfattningar).
• Ditt program fortsätter att vara ansvarigt för Säkerhetskopiering i Microsoft 365 fakturering och därmed förbrukningen i den konsumerande klienten.
• Den använda säkerhetskopieringen av klientorganisationen Admin kan avbryta den väntande ändringen av Säkerhetskopiering i Microsoft 365 Storage Controller och återgå till ursprungligt tillstånd så att programmet återställs som den aktiva Säkerhetskopiering i Microsoft 365 Storage Controller.

När respitperioden har slutförts:

• Programmet har ett inaktivt tillstånd.
• Ditt program ansvarar inte längre för Säkerhetskopiering i Microsoft 365 fakturering och därmed faktureringen med användningsbaserad betalning i den förbrukningsbaserade klientorganisationen.

Inaktivera programmet som Säkerhetskopiering i Microsoft 365 Storage Controller

Om du vill inaktivera programmet från att vara Säkerhetskopiering i Microsoft 365-tjänsten i den förbrukningsklientorganisation måste programmet köra serviceApp: inaktivera API:

POST /solutions/backupRestore/serviceApps/{serviceAppId}/deactivate

Resultatet av att inaktivera programmet beror på programmets aktuella tillstånd.

Inaktivera med det aktuella tillståndet inaktivt

Att inaktivera ditt program som har ett inaktivt tillstånd gör ingenting.

Inaktivera med det aktuella tillståndet pendingActive

Om du inaktiverar ditt program som har tillståndet väntandeActive avbryts den väntande ändringen för att bli Säkerhetskopiering i Microsoft 365 Storage Controller.

När api:et har anropats:

• Programmet har ett inaktivt tillstånd.
• Programmet som för närvarande är Säkerhetskopiering i Microsoft 365 Storage Controller har tillståndet aktiv.

Inaktivera med det aktuella tillståndet pendingInactive

Om du inaktiverar ditt program som har tillståndet pendingInactive kommer det inte att göra något med den väntande ändringen av Säkerhetskopiering i Microsoft 365 Storage Controller. Den väntande ändringen fortsätter alltså tills respitperioden har slutförts.

Inaktivera med aktuellt tillstånd för aktiv

Du kan inte inaktivera ditt program som har ett aktivt tillstånd och din begäran misslyckas med http-fel 403-kod.

Om du vill inaktivera programmet som Säkerhetskopiering i Microsoft 365 Storage Controller måste antingen ett annat program aktiveras eller så kan du avregistrera ditt program till en Säkerhetskopiering i Microsoft 365 Storage Controller.

Avregistrera ditt program som Säkerhetskopiering i Microsoft 365 Storage Controller

Om du vill avregistrera ditt program från att vara Säkerhetskopiering i Microsoft 365 storage controller i den förbrukningsklientorganisation måste programmet köra Api:et För att ta bort serviceApp:

DELETE /solutions/backupRestore/serviceApps/{serviceAppId}

Resultatet av avregistreringen av ditt program beror på programmets aktuella tillstånd.

Avregistrera med aktuellt inaktivt tillstånd

Om du avregistrerar ditt program som har ett inaktivt tillstånd tas ditt program bort som tillgängligt för Säkerhetskopiering i Microsoft 365 Storage Controller.

När api:et har anropats:

• Programmet är inte längre tillgängligt för att bli Säkerhetskopiering i Microsoft 365 Storage Controller (såvida det inte har registrerats om).

Avregistrera med det aktuella tillståndet pendingActive

Om du avregistrerar ditt program som har ett väntande tillstånd avbryts den väntande ändringen för att bli Säkerhetskopiering i Microsoft 365 Storage Controller.

När api:et har anropats:

• Programmet är inte längre tillgängligt för att bli Säkerhetskopiering i Microsoft 365 Storage Controller (såvida det inte har registrerats om).
• Programmet har inte längre skrivskyddad åtkomst till befintliga skyddsprinciper.
• Programmet som för närvarande är Säkerhetskopiering i Microsoft 365 Storage Controller har tillståndet aktiv.

Avregistrera med det aktuella tillståndet pendingInactive

Du kan inte avregistrera ditt program som har tillståndet pendingInactive och din begäran misslyckas med en HTTP 403-felkod.

Om du vill avregistrera ditt program som Säkerhetskopiering i Microsoft 365 Storage Controller måste du vänta tills respitperioden har slutförts (eller om den väntande ändringen avbryts och programmet återställs som Säkerhetskopiering i Microsoft 365 storage controller).

Avregistrera med aktuellt tillstånd för aktiv

Avregistrering av ditt program med aktiv status initierar automatiskt en väntande ändring av Säkerhetskopiering i Microsoft 365 Storage Controller med en obligatorisk 7-dagars respitperiod.

Efter att ha anropat API:et och under respitperioden:

• Programmet kommer inte att kunna komma åt, skapa eller ändra några skyddsprinciper eller utföra några återställningar.
• Programmet är inte längre tillgängligt för att bli Säkerhetskopiering i Microsoft 365 storage controller (såvida det inte har omregistrerats).
• Ditt program fortsätter att vara ansvarigt för Säkerhetskopiering i Microsoft 365 fakturering och därmed förbrukningen i den konsumerande klienten tills ett annat program har aktiverats för att bli Säkerhetskopiering i Microsoft 365 Storage Controller.

När respitperioden har slutförts:

• Ditt program är fortfarande inte längre tillgängligt för att bli Säkerhetskopiering i Microsoft 365 Storage Controller (såvida det inte har registrerats om).
• Om ett annat program inte är aktiverat för att vara Säkerhetskopiering i Microsoft 365 Storage Controller initieras avregistreringen av Säkerhetskopiering i Microsoft 365-tjänsten i den förbrukningsklientorganisation som används.
• Ditt program fortsätter att vara ansvarigt för Säkerhetskopiering i Microsoft 365 fakturering och därmed förbrukningen i den konsumerande klienten tills ett annat program har aktiverats för att vara Säkerhetskopiering i Microsoft 365 Storage Controller eller tills faktureringsperioden går ut (30 dagar) enligt avregistreringen av Säkerhetskopiering i Microsoft 365-tjänsten i förbrukningsklientorganisationen.

Varning

Om ditt program är aktivt Säkerhetskopiering i Microsoft 365 storage controller när du avregistrerar det, kan du vara ansvarig för ytterligare 37 dagar (7 dagar plus 30 dagar) för Säkerhetskopiering i Microsoft 365 betala per användning-fakturering i den konsumerande klientorganisationen.

Programlivscykeltillstånd

Registrering och avregistrering av ett Säkerhetskopiering i Microsoft 365 program kräver att programmet genomgår ett antal olika tillstånd. Tillståndsändringarna initieras av:

• Ett program som anropar specifika API:er.
• Konsekvensen av att ett annat program anropar specifika API:er. Eller
• Systemet väntar på att en viss tid ska passera.

I föregående diagram beskrivs tillstånd och gester som kan orsaka en övergång mellan dem:

1. Registrera ditt program som en Säkerhetskopiering i Microsoft 365 Storage Controller
2. Aktivera ditt program så att det är Säkerhetskopiering i Microsoft 365 Storage Controller utan någon befintlig Säkerhetskopiering i Microsoft 365 Storage Controller
3. Aktivera ditt program för att vara Säkerhetskopiering i Microsoft 365 storage controller med en befintlig Säkerhetskopiering i Microsoft 365 storage controller och ett annat program aktiveras som Säkerhetskopiering i Microsoft 365 Lagringskontrollant när programmet är Active Säkerhetskopiering i Microsoft 365 Storage Controller
4. Den befintliga respitperioden för Säkerhetskopiering i Microsoft 365 storage controller har slutförts
5. Inaktivera programmet så att det är Säkerhetskopiering i Microsoft 365 storage controller med det aktuella tillståndet pendingActive
6. Avregistrera programmet så att det är Säkerhetskopiering i Microsoft 365 storage controller med det aktuella tillståndet inaktivt
7. Avregistrera ditt program för att vara Säkerhetskopiering i Microsoft 365 Storage Controller med det aktuella tillståndet pendingActive
8. Avregistrera ditt program för att vara Säkerhetskopiering i Microsoft 365 storage controller med aktuellt tillstånd för aktiv