Resursmodell för Azure Cosmos DB-funktionen för återställning till tidpunkt

  • Artikel

GÄLLER FÖR: Nosql Mongodb Gremlin Tabell

I den här artikeln beskrivs resursmodellen för Azure Cosmos DB-funktionen för återställning till tidpunkt. Den förklarar de parametrar som stöder kontinuerlig säkerhetskopiering och resurser som kan återställas. Den här funktionen stöds i Azure Cosmos DB API för SQL, Azure Cosmos DB API för Gremlin, Tabell-API och Azure Cosmos DB API för MongoDB.

Databaskontots resursmodell

Databaskontots resursmodell uppdateras med några extra egenskaper för att stödja de nya återställningsscenarierna. Dessa egenskaper är BackupPolicy, CreateModeoch RestoreParameters.

BackupPolicy

En ny egenskap i säkerhetskopieringsprincipen på kontonivå med namnet Type under parametern backuppolicy möjliggör kontinuerlig säkerhetskopiering och återställning till tidpunkt. Det här läget kallas kontinuerlig säkerhetskopiering. Du kan ange det här läget när du skapar kontot eller när du migrerar ett konto från periodiskt till kontinuerligt läge. När kontinuerligt läge har aktiverats har alla containrar och databaser som skapats i det här kontot återställning till tidpunkt och kontinuerlig säkerhetskopiering aktiverat som standard. Nivån för kontinuerlig säkerhetskopiering kan anges till Continuous7Days eller Continuous30Days. Om ingen nivå anges Continuous30Days tillämpas som standard på kontot.

Kommentar

För närvarande är funktionen för återställning till tidpunkt tillgänglig för Azure Cosmos DB för NoSQL-, API för MongoDB-, Table- och Gremlin-konton. När du har skapat ett konto med kontinuerligt läge kan du inte växla det till ett periodiskt läge. Nivån Continuous7Days är i förhandsversion.

CreateMode

Den här egenskapen anger hur kontot skapades. Möjliga värden är Standard och Återställ. Om du vill utföra en återställning anger du det här värdet till Återställ och anger lämpliga värden i egenskapen RestoreParameters .

publicNetworkAccess

Den här egenskapen måste vara inställd på "Inaktiverad" för att återställa kontot utan åtkomst till det offentliga nätverket. Om den här egenskapen inte anges fortsätter återställningen av kontot med publicNetworkAccess som Enabled.

RestoreParameters

Resursen RestoreParameters innehåller information om återställningsåtgärden, inklusive konto-ID, tid för återställning och resurser som måste återställas.

Egenskapsnamn beskrivning
restoreMode Återställningsläget ska vara PointInTime.
restoreSource InstanceId för källkontot som återställningen ska initieras från.
restoreTimestampInUtc Tidpunkt i UTC för att återställa kontot.
databasesToRestore DatabaseRestoreResource Lista över objekt för att ange vilka databaser och containrar som ska återställas. Varje resurs representerar en enskild databas och alla samlingar under databasen. Mer information finns i Återställningsbara SQL-resurser. Om det här värdet är tomt återställs hela kontot.
gremlinDatabasesToRestore GremlinDatabaseRestoreResource Lista över objekt för att ange vilka databaser och grafer som ska återställas. Varje resurs representerar en enskild databas och alla grafer under den databasen. Mer information finns i Återställningsbara Gremlin-resurser. Om det här värdet är tomt återställs hela kontot.
restoreWithTtlDisabled booleska flaggvärden (sant/falskt) för att inaktivera Time-To-Live i det återställda kontot när återställningen har slutförts. (förhandsversion)
tablesToRestore TableRestoreResource Lista över objekt för att ange vilka tabeller som ska återställas. Varje resurs representerar en tabell under databasen. Mer information finns i Återställningsbara tabellresurser. Om det här värdet är tomt återställs hela kontot.

Exempelresurs

Följande JSON är en exempeldatabaskontoresurs med kontinuerlig säkerhetskopiering aktiverad:

{
  "location": "westus",
  "properties": {
    "databaseAccountOfferType": "Standard",
    "locations": [
      {
        "failoverPriority": "0",
        "locationName": "southcentralus",
        "isZoneRedundant": "false"
      }
    ],
    "createMode": "Restore",
    "publicNetworkAccess":"Disabled",
    "restoreParameters": {
      "restoreMode": "PointInTime",
      "restoreWithTtlDisabled" : "true",
      "restoreSource": "/subscriptions/subid/providers/Microsoft.DocumentDB/locations/westus/restorableDatabaseAccounts/1a97b4bb-f6a0-430e-ade1-638d781830cc",
      "restoreTimestampInUtc": "2020-06-11T22:05:09Z",
      "databasesToRestore": [
        {
          "databaseName": "db1",
          "collectionNames": [
            "collection1",
            "collection2"
          ]
        },
        {
          "databaseName": "db2",
          "collectionNames": [
            "collection3",
            "collection4"
          ]
        }
      ]
    },
    "backupPolicy": {
      "type": "Continuous"
      ...
    }
  }
}

Återställningsbara resurser

Det finns en uppsättning nya resurser och API:er som hjälper dig att identifiera viktig information om resurser, bland annat:

  • Där resurserna kan återställas
  • Platser där resurserna kan återställas från
  • Tidsstämplar när nyckelåtgärder utfördes på dessa resurser.

Kommentar

Alla API:ar som används för att räkna upp dessa resurser kräver följande behörigheter:

  • Microsoft.DocumentDB/locations/restorableDatabaseAccounts/*/read
  • Microsoft.DocumentDB/locations/restorableDatabaseAccounts/read

Återställningsbart databaskonto

Den här resursen innehåller en databaskontoinstans som kan återställas. Databaskontot kan antingen vara ett borttaget eller ett livekonto. Den innehåller information som gör att du kan hitta det källdatabaskonto som du vill återställa.

Egenskapsnamn beskrivning
ID Resursens unika identifierare.
accountName Namnet på det globala databaskontot.
creationTime Tiden i UTC när kontot skapades eller migrerades.
deletionTime Tiden i UTC när kontot togs bort. Det här värdet är tomt om kontot är live.
apiType API-typen för Azure Cosmos DB-kontot.
restorableLocations Listan över platser där kontot fanns.
restorableLocations: locationName Regionnamnet för det regionala kontot.
restorableLocations: regionalDatabaseAccountInstanceId GUID för det regionala kontot.
restorableLocations: creationTime Tiden i UTC när det regionala kontot skapades migrerades.
restorableLocations: deletionTime Tiden i UTC när det regionala kontot togs bort. Det här värdet är tomt om det regionala kontot är live.
OldestRestorableTimeStamp Den tidigaste tiden i UTC som återställning kan utföras till. För 30-dagarsnivån kan den här tiden vara högst 30 dagar från och med nu, för sjudagarsnivån kan den här tiden vara upp till sju dagar från och med nu.

En lista över alla återställningsbara konton finns i Artikeln Om återställningsbara databaskonton – lista eller Återställningsbara databaskonton – lista efter plats .

Återställningsbar SQL-databas

Varje resurs innehåller information om en mutationshändelse, till exempel skapande och borttagning som inträffade i SQL Database. Den här informationen kan vara till hjälp i scenarier där databasen togs bort av misstag och om du behöver ta reda på när händelsen inträffade.

Egenskapsnamn beskrivning
eventTimestamp Tiden i UTC när databasen skapas eller tas bort.
ownerId Namnet på SQL-databasen.
ownerResourceId Resurs-ID för SQL-databasen,
operationType Åtgärdstypen för den här databashändelsen.
database Egenskaperna för SQL-databasen vid tidpunkten för händelsen,

Kommentar

Möjliga värden för operationType inkluderar:

  • Create: händelse för att skapa databas
  • Delete: databasborttagningshändelse
  • Replace: händelse för databasändring
  • SystemOperation: databasändringshändelse som utlöses av systemet. Den här händelsen initieras inte av användaren

En lista över alla databasmutationer finns i artikeln Restorable NoSQL Databases – List ( Återställningsbara NoSQL-databaser – lista).

Återställningsbar SQL-container

Varje resurs innehåller information om en mutationshändelse, till exempel skapande och borttagning som inträffade i SQL-containern. Den här informationen kan vara till hjälp i scenarier där containern har ändrats eller tagits bort och om du behöver ta reda på när händelsen inträffade.

Egenskapsnamn beskrivning
eventTimestamp Tiden i UTC när den här containerhändelsen inträffade.
ownerId Namnet på SQL-containern.
ownerResourceId Resurs-ID för SQL-containern.
operationType Åtgärdstypen för den här containerhändelsen.
container Egenskaperna för SQL-containern vid tidpunkten för händelsen.

Kommentar

Möjliga värden för operationType inkluderar:

  • Create: händelse för att skapa container
  • Delete: händelse för borttagning av containrar
  • Replace: händelse för containerändring
  • SystemOperation: händelse för containerändring som utlöses av systemet. Den här händelsen initieras inte av användaren

Information om hur du hämtar en lista över alla containermutationer under samma databas finns i artikeln Återställbara NoSQL-containrar – lista .

Återställningsbara SQL-resurser

Varje resurs representerar en enskild databas och alla containrar under databasen.

Egenskapsnamn beskrivning
databaseName Namnet på SQL-databasen.
collectionNames Listan över SQL-containrar under den här databasen.

En lista över SQL-databas- och containerkombinationer som finns på kontot vid den angivna tidsstämpeln och platsen finns i artikeln Återställningsbara NoSQL-resurser – lista .

Återställningsbar MongoDB-databas

Varje resurs innehåller information om en mutationshändelse, till exempel skapande och borttagning som inträffade i MongoDB-databasen. Den här informationen kan vara till hjälp i scenariot där databasen togs bort av misstag och användaren måste ta reda på när händelsen inträffade.

Egenskapsnamn beskrivning
eventTimestamp Tiden i UTC när den här databashändelsen inträffade.
ownerId Namnet på MongoDB-databasen.
ownerResourceId Resurs-ID för MongoDB-databasen.
operationType Åtgärdstypen för den här databashändelsen.

Kommentar

Möjliga värden för operationType inkluderar:

  • Create: händelse för att skapa databas
  • Delete: databasborttagningshändelse
  • Replace: händelse för databasändring
  • SystemOperation: databasändringshändelse som utlöses av systemet. Den här händelsen initieras inte av användaren

En lista över alla databasmutationer finns i artikeln Restorable Mongodb Databases – List .

Återställningsbar MongoDB-samling

Varje resurs innehåller information om en mutationshändelse, till exempel skapande och borttagning som inträffade i MongoDB-samlingen. Den här informationen kan vara till hjälp i scenarier där samlingen har ändrats eller tagits bort, och användaren måste ta reda på när händelsen inträffade.

Egenskapsnamn beskrivning
eventTimestamp Tiden i UTC när den här samlingshändelsen inträffade.
ownerId Namnet på MongoDB-samlingen.
ownerResourceId Resurs-ID för MongoDB-samlingen.
operationType Åtgärdstypen för den här samlingshändelsen.

Kommentar

Möjliga värden för operationType inkluderar:

  • Create: händelse för att skapa samling
  • Delete: händelse för borttagning av samling
  • Replace: händelse för insamlingsändring
  • SystemOperation: händelse för insamlingsändring som utlöses av systemet. Den här händelsen initieras inte av användaren

Information om hur du hämtar en lista över alla containermutationer under samma databas finns i avsnittet om återställningsbara MongoDB-resurser – lista.

Återställningsbara MongoDB-resurser

Varje resurs representerar en enskild databas och alla samlingar under databasen.

Egenskapsnamn beskrivning
databaseName Namnet på MongoDB-databasen.
collectionNames Listan över MongoDB-samlingar under den här databasen.

Information om hur du hämtar en lista över alla MongoDB-databas- och samlingskombinationer som finns på kontot vid den angivna tidsstämpeln och platsen finns i avsnittet om återställningsbara MongoDB-resurser – lista.

Återställningsbara Graph-resurser

Varje resurs representerar en enskild databas och alla grafer under den databasen.

Egenskapsnamn beskrivning
gremlinDatabaseName Namnet på Graph-databasen.
graphNames Listan över grafer under den här databasen.

En lista över alla Gremlin-databas- och grafkombinationer som finns på kontot vid den angivna tidsstämpeln och platsen finns i artikeln Restorable Graph Resources – List .

Återställningsbar Graph-databas

Varje resurs innehåller information om en mutationshändelse, till exempel en skapande och borttagning som inträffade i Graph-databasen. Den här informationen kan vara till hjälp i scenariot där databasen togs bort av misstag och användaren måste ta reda på när händelsen inträffade.

Egenskapsnamn beskrivning
eventTimestamp Tiden i UTC när den här databashändelsen inträffade.
ownerId Namnet på Graph-databasen.
ownerResourceId Resurs-ID för Graph-databasen.
operationType Åtgärdstypen för den här databashändelsen.

Kommentar

Möjliga värden för operationType inkluderar:

  • Create: händelse för att skapa databas
  • Delete: databasborttagningshändelse
  • Replace: händelse för databasändring
  • SystemOperation: databasändringshändelse som utlöses av systemet. Den här händelsen initieras inte av användaren.

Information om hur du hämtar en händelsefeed av alla mutationer i Gremlin-databasen finns i avsnittet om återställningsbara grafdatabaser – lista.

Återställningsbara diagram

Varje resurs innehåller information om en mutationshändelse, till exempel skapande och borttagning som inträffade i graph. Den här informationen kan vara till hjälp i scenarier där diagrammet ändrades eller togs bort och om du behöver ta reda på när händelsen inträffade.

Egenskapsnamn beskrivning
eventTimestamp Tiden i UTC när den här samlingshändelsen inträffade.
ownerId Namnet på Graph-samlingen.
ownerResourceId Resurs-ID för Graph-samlingen.
operationType Åtgärdstypen för den här samlingshändelsen.

Kommentar

Möjliga värden för operationType inkluderar:

  • Create: Händelse för att skapa diagram
  • Delete: Händelse för grafborttagning
  • Replace: Händelse för grafändring
  • SystemOperation: händelse för insamlingsändring som utlöses av systemet. Den här händelsen initieras inte av användaren.

Information om hur du hämtar en lista över alla containermutationer under samma databas finns i artikeln Graph Restorable Graphs – List .

Återställningsbara tabellresurser

Visar en lista över alla återställningsbara Azure Cosmos DB-tabeller som är tillgängliga för ett specifikt databaskonto vid en viss tidpunkt och plats. Observera att API:et för tabell inte anger någon explicit databas.

Egenskapsnamn beskrivning
TableNames Listan över tabellcontainrar under det här kontot.

Information om hur du hämtar en lista över tabeller som finns på kontot vid den angivna tidsstämpeln och platsen finns i artikeln Återställningsbara tabellresurser – lista .

Återställningsbar tabell

Varje resurs innehåller information om en mutationshändelse, till exempel skapande och borttagning som inträffade i tabellen. Den här informationen kan vara till hjälp i scenarier där tabellen har ändrats eller tagits bort och om du behöver ta reda på när händelsen inträffade.

Egenskapsnamn beskrivning
eventTimestamp Tiden i UTC när den här databashändelsen inträffade.
ownerId Namnet på tabelldatabasen.
ownerResourceId Resurs-ID för tabellresursen.
operationType Åtgärdstypen för den här tabellhändelsen.

Kommentar

Möjliga värden för operationType inkluderar:

  • Create: Händelse för att skapa tabell
  • Delete: Händelse för tabellborttagning
  • Replace: Händelse för tabelländring
  • SystemOperation: databasändringshändelse som utlöses av systemet. Den här händelsen initieras inte av användaren

Information om hur du hämtar en lista över alla tabellmutationer under samma databas finns i artikeln Återställbar tabell – lista .

Nästa steg