Skapa Azure Recovery Services-valv med hjälp av REST API för Azure Backup
I den här artikeln beskrivs hur du skapar Azure Recovery Services-valv med hjälp av REST API. Information om hur du skapar valvet med hjälp av Azure Portal finns i den här artikeln.
Ett Recovery Services-valv är en lagringsenhet i Azure som innehåller data. Data är vanligtvis kopior av data eller konfigurationsinformation för virtuella datorer (VM), arbetsbelastningar, servrar eller arbetsstationer. Du kan använda Recovery Services-valv för att lagra säkerhetskopierade data för olika Azure-tjänster, till exempel virtuella IaaS-datorer (Linux eller Windows) och SQL Server på virtuella Azure-datorer. Recovery Services-valv stöder System Center DPM, Windows Server, Azure Backup Server med mera. Med Recovery Services-valv är det enkelt att organisera dina säkerhetskopierade data samtidigt som du minimerar hanteringskostnaden.
Innan du börjar
Innan du börjar skapa Recovery Services-valvet bör du läsa följande information:
- Processen för att skapa valvet använder
api-version=2016-06-01
. - Skapandet av ett Azure Recovery Services-valv med hjälp av REST API beskrivs i artikeln skapa rest-API för valv. Vi använder den här artikeln som referens för att skapa ett valv med namnet
testVault
iWest US
.
Om du vill skapa eller uppdatera ett Azure Recovery Services-valv använder du följande PUT-åtgärd :
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}?api-version=2016-06-01
Skapa en begäran
För att skapa PUT-begäran krävs parametern {subscription-id}
. Om du har flera prenumerationer kan du läsa Arbeta med flera prenumerationer. Du definierar en {resourceGroupName}
och {vaultName}
för dina resurser, tillsammans med parametern api-version
. Den här artikeln använder api-version=2016-06-01
.
Följande huvuden krävs:
Begärandehuvud | beskrivning |
---|---|
Innehållstyp: | Obligatoriskt. Ange till application/json . |
Auktorisering: | Obligatoriskt. Ange till en giltig Bearer -åtkomsttoken. |
Mer information om hur du skapar begäran finns i Komponenter i en REST API-begäran/-svar.
Skapa begärandetexten
Följande vanliga definitioner används för att skapa en begärandetext:
Namn | Obligatoriskt | Type | Beskrivning |
---|---|---|---|
eTag | String | Valfri eTag | |
plats | true | String | Resursplats |
egenskaper | ValvEgenskaper | Egenskaper för valvet | |
sku | Sku | Identifierar den unika systemidentifieraren för varje Azure-resurs | |
taggar | Objekt | Resurstaggar |
Observera att valvnamn och resursgruppsnamn anges i PUT-URI:n. Begärandetexten definierar platsen.
Exempel på begärandetext
Följande exempeltext används för att skapa ett valv i West US
. Ange platsen. SKU:n är alltid Standard
.
{
"properties": {},
"sku": {
"name": "Standard"
},
"location": "West US"
}
Svar
Det finns två lyckade svar för åtgärden för att skapa eller uppdatera ett Recovery Services-valv:
Namn | Type | Beskrivning |
---|---|---|
200 OK | Valv | OK |
201 Skapad | Valv | Skapad |
Mer information om REST API-svar finns i Bearbeta svarsmeddelandet.
Exempelsvar
Ett komprimerat svar från 201 Skapad från föregående exempelbegärandetext visar att ett ID har tilldelats och att provisioningState har slutförts:
{
"location": "westus",
"name": "testVault",
"properties": {
"provisioningState": "Succeeded"
},
"id": "/subscriptions/77777777-b0c6-47a2-b37c-d8e65a629c18/resourceGroups/Default-RecoveryServices-ResourceGroup/providers/Microsoft.RecoveryServices/vaults/testVault",
"type": "Microsoft.RecoveryServices/vaults",
"sku": {
"name": "Standard"
}
}
Nästa steg
Mer information om Azure REST-API:er finns i följande dokument: