Disks - Grant Access

服務:: Compute

API 版本:: 2023-10-02

授與磁碟的存取權。

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/disks/{diskName}/beginGetAccess?api-version=2023-10-02

URI 參數

名稱	位於	必要	類型	Description
diskName	path	True	string	要建立之受控磁碟的名稱。建立磁碟之後，就無法變更名稱。名稱的支援字元為 a-z、A-Z、0-9、_ 和 -。名稱長度上限為80個字元。
resourceGroupName	path	True	string	資源群組的名稱。
subscriptionId	path	True	string	可唯一識別Microsoft Azure 訂用帳戶的訂用帳戶認證。訂用帳戶標識碼會形成每個服務呼叫 URI 的一部分。
api-version	query	True	string	用戶端 API 版本。

要求本文

名稱	必要	類型	Description
access	True	AccessLevel
durationInSeconds	True	integer (int32)	SAS 存取到期前的秒數持續時間。
fileFormat		FileFormat	在 VHDX 檔案格式快照集上提出 SAS 要求時，用來指定檔案格式
getSecureVMGuestStateSAS		boolean	將此旗標設定為 true 以取得 VM 客體狀態的其他 SAS

回應

名稱	類型	Description
200 OK	AccessUri	還行
202 Accepted		已接受

安全性

azure_auth

Azure Active Directory OAuth2 流

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱	Description
user_impersonation	模擬您的用戶帳戶

範例

Get a sas on a managed disk.

Get sas on managed disk and VM guest state

Get a sas on a managed disk.

範例要求

HTTP

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk/beginGetAccess?api-version=2023-10-02

{
  "access": "Read",
  "durationInSeconds": 300,
  "fileFormat": "VHD"
}

範例回覆

狀態碼:: 200

{
  "accessSAS": "https://md-gpvmcxzlzxgd.partition.blob.storage.azure.net/xx3cqcx53f0v/abcd?sv=2014-02-14&sr=b&sk=key1&sig=XXX&st=2021-05-24T18:02:34Z&se=2021-05-24T18:19:14Z&sp=r"
}

狀態碼:: 202

Location: https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/{location}/operations/{operationId}&monitor=true&api-version=2023-10-02

Get sas on managed disk and VM guest state

範例要求

HTTP

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk/beginGetAccess?api-version=2023-10-02

{
  "access": "Read",
  "durationInSeconds": 300,
  "getSecureVMGuestStateSAS": true
}

範例回覆

狀態碼:: 200

{
  "accessSAS": "https://md-gpvmcxzlzxgd.partition.blob.storage.azure.net/xx3cqcx53f0v/abcd?sv=2014-02-14&sr=b&sk=key1&sig=XXX&st=2021-05-24T18:02:34Z&se=2021-05-24T18:19:14Z&sp=r",
  "securityDataAccessSAS": "https://md-gpvmcxzlzxgd.partition.blob.storage.azure.net/xx3cqcx53f0v/b9bf5824-6122-49e0-ba22-042f76ccd8a1_vmgs?sv=2014-02-14&sr=b&sk=key1&sig=XXX&st=2021-05-24T18:02:34Z&se=2021-05-24T18:19:14Z&sp=r"
}

狀態碼:: 202

Location: https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/{location}/operations/{operationId}&monitor=true&api-version=2023-10-02

定義

名稱	Description
AccessLevel
AccessUri	磁碟存取SAS URI。
FileFormat	在 VHDX 檔案格式快照集上提出 SAS 要求時，用來指定檔案格式
GrantAccessData	用於要求 SAS 的數據。

AccessLevel

列舉型別

值	Description
None
Read
Write

AccessUri

Object

磁碟存取SAS URI。

名稱	類型	Description
accessSAS	string	用於存取磁碟的SAS URI。
securityDataAccessSAS	string	用來存取 VM 客體狀態的 SAS URI。

FileFormat

列舉型別

在 VHDX 檔案格式快照集上提出 SAS 要求時，用來指定檔案格式

值	Description
VHD	VHD 檔案是虛擬硬碟檔案格式的磁碟映像檔。
VHDX	VHDX 檔案是虛擬硬碟 v2 檔案格式的磁碟映像檔。

GrantAccessData

Object

用於要求 SAS 的數據。

名稱	類型	Description
access	AccessLevel
durationInSeconds	integer (int32)	SAS 存取到期前的秒數持續時間。
fileFormat	FileFormat	在 VHDX 檔案格式快照集上提出 SAS 要求時，用來指定檔案格式
getSecureVMGuestStateSAS	boolean	將此旗標設定為 true 以取得 VM 客體狀態的其他 SAS