Partilhar via


Disks - Grant Access

Concede acesso a um disco.

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

Parâmetros do URI

Name Em Necessário Tipo Description
diskName
path True

string

O nome do disco gerido que está a ser criado. O nome não pode ser alterado após a criação do disco. Os carateres suportados para o nome são a-z, A-Z, 0-9, _ e -. O comprimento máximo do nome é de 80 carateres.

resourceGroupName
path True

string

O nome do grupo de recursos.

subscriptionId
path True

string

Credenciais de subscrição que identificam exclusivamente a subscrição do Microsoft Azure. O ID da subscrição faz parte do URI para cada chamada de serviço.

api-version
query True

string

Versão da API de Cliente.

Corpo do Pedido

Name Necessário Tipo Description
access True

AccessLevel

durationInSeconds True

integer

Duração do tempo em segundos até o acesso sas expirar.

fileFormat

FileFormat

Utilizado para especificar o formato de ficheiro ao fazer um pedido de SAS num instantâneo de formato de ficheiro VHDX

getSecureVMGuestStateSAS

boolean

Defina este sinalizador como verdadeiro para obter SAS adicional para o estado de convidado da VM

Respostas

Name Tipo Description
200 OK

AccessUri

OK

202 Accepted

Aceite

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name Description
user_impersonation representar a sua conta de utilizador

Exemplos

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

Get a sas on a managed disk.

Pedido de amostra

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

Resposta da amostra

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

Pedido de amostra

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
}

Resposta da amostra

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

Definições

Name Description
AccessLevel
AccessUri

Um uri de SAS de acesso ao disco.

FileFormat

Utilizado para especificar o formato de ficheiro ao fazer um pedido de SAS num instantâneo de formato de ficheiro VHDX

GrantAccessData

Dados utilizados para pedir uma SAS.

AccessLevel

Name Tipo Description
None

string

Read

string

Write

string

AccessUri

Um uri de SAS de acesso ao disco.

Name Tipo Description
accessSAS

string

Um uri de SAS para aceder a um disco.

securityDataAccessSAS

string

Um uri de SAS para aceder a um estado de convidado de VM.

FileFormat

Utilizado para especificar o formato de ficheiro ao fazer um pedido de SAS num instantâneo de formato de ficheiro VHDX

Name Tipo Description
VHD

string

Um ficheiro VHD é um ficheiro de imagem de disco no formato de ficheiro Disco Rígido Virtual.

VHDX

string

Um ficheiro VHDX é um ficheiro de imagem de disco no formato de ficheiro Virtual Hard Disk v2.

GrantAccessData

Dados utilizados para pedir uma SAS.

Name Tipo Description
access

AccessLevel

durationInSeconds

integer

Duração do tempo em segundos até o acesso sas expirar.

fileFormat

FileFormat

Utilizado para especificar o formato de ficheiro ao fazer um pedido de SAS num instantâneo de formato de ficheiro VHDX

getSecureVMGuestStateSAS

boolean

Defina este sinalizador como verdadeiro para obter SAS adicional para o estado de convidado da VM