使用 REST API 建立 Azure 復原服務保存庫以進行 Azure 備份
本文說明如何使用 REST API 建立 Azure 復原服務保存庫。 若要使用 Azure 入口網站 建立保存庫,請參閱這篇文章。
復原服務保存庫是 Azure 中裝載資料的儲存體實體。 資料通常是資料的副本,或是虛擬機器 (VM)、工作負載、伺服器或工作站的設定資訊。 您可以使用復原服務保存庫來保存各種 Azure 服務 (例如 IaaS VM (Linux 或 Windows) 以及 Azure VM 中的 SQL Server) 的備份資料。 復原服務保存庫支援 System Center DPM、Windows Server、Azure 備份伺服器等項目。 復原服務保存庫可輕鬆地組織您的備份資料,同時可減輕管理負擔。
在您開始使用 Intune 之前
開始建立復原服務保存庫之前,請先檢閱下列詳細數據:
- 儲存庫建立程式會使用
api-version=2016-06-01
。 - 使用 REST API 建立 Azure 復原服務保存庫的概述 ,請參閱建立保存庫 REST API 一文。 讓我們使用本文作為參考,在 中
West US
建立名為testVault
的保存庫。
若要建立或更新 Azure 復原服務保存庫,請使用下列 PUT 作業:
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}?api-version=2016-06-01
建立要求
若要建立 PUT 要求,{subscription-id}
是必要參數。 如果您有多個訂用帳戶,請參閱使用多個訂用帳戶。 您需針對資源定義 {resourceGroupName}
和 {vaultName}
,以及定義 api-version
參數。 本文使用 api-version=2016-06-01
。
以下是必要標頭:
要求標頭 | 描述 |
---|---|
內容類型: | 必要。 設定為 application/json 。 |
Authorization: | 必要。 設定為有效的 Bearer 存取權杖。 |
如需如何建立要求的詳細資訊,請參閱 REST API 要求/回應的元件。
建立要求本文
以下是用來建立要求本文的常用定義:
名稱 | 必要 | 類型 | 描述 |
---|---|---|---|
eTag | String | 選擇性 eTag | |
location | true | String | 資源位置 |
內容 | VaultProperties | 保存庫的屬性 | |
SKU | Sku | 識別每個 Azure 資源的唯一系統識別碼 | |
標記 | Object | 資源標籤 |
請注意,保存庫名稱和資源群組名稱會在 PUT URI 中提供。 要求本文會定義位置。
要求本文範例
下列範例主體是用來在 中 West US
建立保存庫。 指定位置。 SKU 一律 Standard
為 。
{
"properties": {},
"sku": {
"name": "Standard"
},
"location": "West US"
}
回覆
建立或更新復原服務保存庫的作業會有兩個成功的回應:
名稱 | 類型 | 描述 |
---|---|---|
200 OK | 保存庫 | 確定 |
201 Created | 保存庫 | 建立時間 |
如需 REST API 回應的詳細資訊,請參閱處理回應訊息。
範例回應
先前範例要求本文所建立的壓縮 201 回應會顯示已指派標識碼,且 provisioningState 為 Succeeded:
{
"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"
}
}
下一步
如需 Azure REST API 的詳細資訊,請參閱下列文件:
- Azure 復原服務提供者 REST API
- Get started with Azure REST API (開始使用 Azure REST API)