Freigeben über


Disks - Grant Access

Gewährt Zugriff auf einen Datenträger.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
diskName
path True

string

Der Name des verwalteten Datenträgers, der erstellt wird. Der Name kann nicht geändert werden, nachdem der Datenträger erstellt wurde. Unterstützte Zeichen für den Namen sind a-z, A-Z, 0-9, _ und -. Die maximale Namenslänge ist 80 Zeichen.

resourceGroupName
path True

string

Der Name der Ressourcengruppe.

subscriptionId
path True

string

Abonnementanmeldeinformationen, die das Microsoft Azure-Abonnement eindeutig identifizieren. Die Abonnement-ID ist Teil des URI für jeden Dienstaufruf.

api-version
query True

string

Client-API-Version.

Anforderungstext

Name Erforderlich Typ Beschreibung
access True

AccessLevel

durationInSeconds True

integer

Zeitdauer in Sekunden, bis der SAS-Zugriff abläuft.

fileFormat

FileFormat

Wird verwendet, um das Dateiformat anzugeben, wenn sas für ein VHDX-Dateiformat Momentaufnahme

getSecureVMGuestStateSAS

boolean

Legen Sie dieses Flag auf true fest, um zusätzliche SAS für den VM-Gaststatus zu erhalten.

Antworten

Name Typ Beschreibung
200 OK

AccessUri

OK

202 Accepted

Akzeptiert

Sicherheit

azure_auth

Azure Active Directory-OAuth2-Flow

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel Ihres Benutzerkontos

Beispiele

Get a sas on a managed disk.
Get sas on managed disk and VM guest state

Get a sas on a managed disk.

Beispielanforderung

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"
}

Beispiel für eine Antwort

{
  "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"
}
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

Beispielanforderung

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
}

Beispiel für eine Antwort

{
  "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"
}
Location: https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/{location}/operations/{operationId}&monitor=true&api-version=2023-10-02

Definitionen

Name Beschreibung
AccessLevel
AccessUri

Ein SAS-URI für den Datenträgerzugriff.

FileFormat

Wird verwendet, um das Dateiformat anzugeben, wenn sas für ein VHDX-Dateiformat Momentaufnahme

GrantAccessData

Daten, die zum Anfordern einer SAS verwendet werden.

AccessLevel

Name Typ Beschreibung
None

string

Read

string

Write

string

AccessUri

Ein SAS-URI für den Datenträgerzugriff.

Name Typ Beschreibung
accessSAS

string

Ein SAS-URI für den Zugriff auf einen Datenträger.

securityDataAccessSAS

string

Ein SAS-URI für den Zugriff auf einen VM-Gaststatus.

FileFormat

Wird verwendet, um das Dateiformat anzugeben, wenn sas für ein VHDX-Dateiformat Momentaufnahme

Name Typ Beschreibung
VHD

string

Eine VHD-Datei ist eine Datenträgerimagedatei im Dateiformat "Virtuelle Festplatte".

VHDX

string

Eine VHDX-Datei ist eine Datenträgerimagedatei im Dateiformat Virtual Hard Disk v2.

GrantAccessData

Daten, die zum Anfordern einer SAS verwendet werden.

Name Typ Beschreibung
access

AccessLevel

durationInSeconds

integer

Zeitdauer in Sekunden, bis der SAS-Zugriff abläuft.

fileFormat

FileFormat

Wird verwendet, um das Dateiformat anzugeben, wenn sas für ein VHDX-Dateiformat Momentaufnahme

getSecureVMGuestStateSAS

boolean

Legen Sie dieses Flag auf true fest, um zusätzliche SAS für den VM-Gaststatus zu erhalten.