إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
توضح هذه المقالة كيفية إنشاء مخزن النسخ الاحتياطي باستخدام واجهة برمجة تطبيقات REST. يمكنك أيضا إنشاء مخزن النسخ الاحتياطي باستخدام مدخل Microsoft Azure.
يوفر النظام الأساسي الجديد لحماية البيانات في Azure Backup إمكانات محسّنة للنسخ الاحتياطي والاستعادة لأحمال العمل الأحدث مثل الكائنات الثنائية كبيرة الحجم في حسابات التخزين والقرص المُدار ومنصة PaaS لخادم PostgreSQL. يهدف إلى تقليل النفقات الإدارية مع تسهيل تنظيم النسخ الاحتياطية. "مخزن النسخ الاحتياطي" هو حجر الزاوية لمنصة حماية البيانات وهذا يختلف عن مخزن "خدمات الاسترداد".
تم توضيح خطوات إنشاء مخزن النسخ الاحتياطي من Azure باستخدام REST API في وثائق إنشاء Vault REST API. دعونا نستخدم هذا المستند كمرجع لإنشاء مخزن يسمى testBkpVault في West US وضمن TestBkpVaultRG مجموعة الموارد.
لإنشاء مخزن النسخ الاحتياطي من Azure أو تحديثه، استخدم عملية PUT التالية.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/testBkpVault?api-version=2021-01-01
إنشاء طلب
لإنشاء طلب PUT، فإن المعلمة {subscription-id} مطلوبة. إذا كانت لديك اشتراكات متعددة، فراجع العمل مع الاشتراكات المتعددة. أنت تحدد {resourceGroupName} و{vaultName} لمواردك، جنبًا إلى جنب مع المعلمة api-version. يستخدم هذا المقال api-version=2021-01-01.
الرؤوس التالية مطلوبة:
| عنوان الطلب | الوصف |
|---|---|
| نوع المحتوى: | مطلوب. تعيين إلى application/json. |
| التفويض: | مطلوب. قم بالتعيين إلى Bearerرمز وصول صالح. |
للحصول على مزيدٍ من المعلومات عن كيفية إنشاء الطلب، راجع مكونات طلب/استجابة REST API.
قم بإنشاء نص الطلب
تُستخدم التعريفات الشائعة التالية لبناء نص طلب:
| الاسم | مطلوبة | نوع | الوصف |
|---|---|---|---|
| العلامة الإلكترونية | السلسلة | eTag اختيارية | |
| مكان | صحيح | السلسلة | موقع المورد |
| الخصائص | صحيح | BackupVault | خصائص المخزن |
| الهوية | DPPIdentityDetails | يحدد معرّف النظام الفريد لكل مورد Azure | |
| العلامات | الكائن | علامات المورد |
لاحظ أنه يتم توفير اسم المخزن واسم مجموعة الموارد في PUT URI. يحدد نص الطلب الموقع.
نموذج طلب النص الأساسي
يتم استخدام مثال النص التالي لإنشاء مخزن في "غرب الولايات المتحدة". حدد الموقع.
{
"location": "WestUS",
"tags": {
"key1": "val1"
},
"identity": {
"type": "None"
},
"properties": {
"storageSettings": [
{
"datastoreType": "VaultStore",
"type": "LocallyRedundant"
}
]
}
}
إذا كنت ترغب في إنشاء مخزن احتياطي وأيضًا إنشاء هوية مخصصة للنظام، فيجب تقديم نص الطلب التالي.
{
"location": "WestUS",
"tags": {
"key1": "val1"
},
"identity": {
"type": "systemAssigned"
},
"properties": {
"storageSettings": [
{
"datastoreType": "VaultStore",
"type": "LocallyRedundant"
}
]
}
}
الاستجابات
يُعد إنشاء مخزن احتياطي عملية غير متزامنة. وهذا يعني أن هذه العملية تنشئ عملية أخرى تحتاج إلى تعقبها بشكل منفصل. توجد استجابتان ناجحتان لعملية إنشاء أو تحديث مخزن النسخ الاحتياطي:
| الاسم | نوع | الوصف |
|---|---|---|
| 200 جيد | BackupVaultResource | موافق |
| 201 أُنشئ | BackupVaultResource | تم الإنشاء |
| رموز الحالة الأخرى | CloudError |
لمزيد من المعلومات حول استجابات REST API، راجع معالجة رسالة الاستجابة.
مثال على الاستجابة
تُظهر استجابة 201 تم الإنشاء المكثفة من نموذج طلب المثال السابق أنه تم تعيين معرف وحالة التوفيرتم النجاح:
{
"eTag": null,
"id": "/subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourcegroups/TestBkpVaultRG/providers/Microsoft.DataProtection/BackupVaults/testBkpVault",
"identity": {
"principalId": "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"tenantId": "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"type": "SystemAssigned"
},
"location": "westUS",
"name": "testBkpVault",
"properties": {
"provisioningState": "Succeeded",
"storageSettings": [
{
"datastoreType": "VaultStore",
"type": "GeoRedundant"
}
]
},
"resourceGroup": "TestBkpVaultRG",
"systemData": null,
"tags": {},
"type": "Microsoft.DataProtection/backupVaults"
}
الخطوات التالية
إنشاء نهج نسخ احتياطي لنسخ الكائنات الثنائية كبيرة الحجم احتياطيًا في هذا المخزن.
لمزيد من المعلومات حول Azure REST APIs، راجع المستندات التالية: