Tworzenie magazynu usługi Azure Recovery Services przy użyciu interfejsu API REST dla usługi Azure Backup
W tym artykule opisano sposób tworzenia magazynu usługi Azure Recovery Services przy użyciu interfejsu API REST. Aby utworzyć magazyn przy użyciu witryny Azure Portal, zobacz ten artykuł.
Magazyn usługi Recovery Services to jednostka magazynowa przechowująca dane na platformie Azure. Dane są zazwyczaj kopiami danych lub informacjami o konfiguracji maszyn wirtualnych, obciążeń, serwerów lub stacji roboczych. Magazynów usługi Recovery Services można używać do przechowywania danych kopii zapasowych dla różnych usług platformy Azure, takich jak maszyny wirtualne IaaS (Linux lub Windows) i SQL Server na maszynach wirtualnych platformy Azure. Magazyny usługi Recovery Services obsługują programy System Center DPM, Windows Server, Azure Backup Server i nie tylko. Magazyny usługi Recovery Services ułatwiają organizowanie danych kopii zapasowych przy jednoczesnym zmniejszeniu nakładów pracy związanych z zarządzaniem.
Przed rozpoczęciem
Tworzenie magazynu usługi Azure Recovery Services przy użyciu interfejsu API REST zostało opisane w artykule tworzenie interfejsu API REST magazynu. Użyjmy tego artykułu jako odwołania do utworzenia magazynu o nazwie testVault
w West US
pliku .
Aby utworzyć lub zaktualizować magazyn usługi Azure Recovery Services, użyj następującej operacji PUT :
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}?api-version=2016-06-01
Utwórz żądanie
Aby utworzyć żądanie PUT , {subscription-id}
wymagany jest parametr . Jeśli masz wiele subskrypcji, zobacz Praca z wieloma subskrypcjami. Zdefiniuj element {resourceGroupName}
i {vaultName}
dla zasobów wraz z parametrem api-version
. W tym artykule jest używany program api-version=2016-06-01
.
Wymagane są następujące nagłówki:
Nagłówek żądania | opis |
---|---|
Typ zawartości: | Wymagany. Ustaw wartość application/json . |
Autoryzacja: | Wymagany. Ustaw na prawidłowy token dostępu Bearer . |
Aby uzyskać więcej informacji na temat tworzenia żądania, zobacz Składniki żądania/odpowiedzi interfejsu API REST.
Tworzenie treści żądania
Następujące typowe definicje służą do tworzenia treści żądania:
Nazwisko | Wymagania | Type | Opis |
---|---|---|---|
eTag | String | Opcjonalny element eTag | |
lokalizacja | prawda | String | Lokalizacja zasobu |
właściwości | Właściwości magazynu | Właściwości magazynu | |
sku | Jednostka SKU | Identyfikuje unikatowy identyfikator systemu dla każdego zasobu platformy Azure | |
tags | Objekt | Tagi zasobów |
Pamiętaj, że nazwa magazynu i nazwa grupy zasobów są podane w identyfikatorze URI PUT. Treść żądania definiuje lokalizację.
Przykładowa treść żądania
Poniższa przykładowa treść służy do tworzenia magazynu w programie West US
. Określ lokalizację. Jednostka SKU jest zawsze Standard
.
{
"properties": {},
"sku": {
"name": "Standard"
},
"location": "West US"
}
Odpowiedzi
Istnieją dwie pomyślne odpowiedzi dla operacji tworzenia lub aktualizowania magazynu usługi Recovery Services:
Nazwisko | Pisz | Opis |
---|---|---|
200 OK | Magazyn | OK |
Utworzono 201 | Magazyn | Utworzone |
Aby uzyskać więcej informacji na temat odpowiedzi interfejsu API REST, zobacz Przetwarzanie komunikatu odpowiedzi.
Przykładowa odpowiedź
Skondensowana odpowiedź utworzona 201 z poprzedniej przykładowej treści żądania pokazuje , że przypisano identyfikator , a stan provisioningState to Powodzenie:
{
"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"
}
}
Następne kroki
Aby uzyskać więcej informacji na temat interfejsów API REST platformy Azure, zobacz następujące dokumenty: