Snapshots - Grant Access
Concede acesso a um instantâneo.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/snapshots/{snapshotName}/beginGetAccess?api-version=2023-10-02
Parâmetros do URI
Name | Em | Necessário | Tipo | Description |
---|---|---|---|---|
resource
|
path | True |
string |
O nome do grupo de recursos. |
snapshot
|
path | True |
string |
O nome do instantâneo que está a ser criado. O nome não pode ser alterado após a criação do instantâneo. Os carateres suportados para o nome são a-z, A-Z, 0-9, _ e -. O comprimento máximo do nome é de 80 carateres. |
subscription
|
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 do Cliente. |
Corpo do Pedido
Name | Necessário | Tipo | Description |
---|---|---|---|
access | True | ||
durationInSeconds | True |
integer |
Duração do tempo em segundos até o acesso à SAS expirar. |
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 |
OK |
|
202 Accepted |
Aceite |
Segurança
azure_auth
Fluxo OAuth2 do Azure Active Directory
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | representar a sua conta de utilizador |
Exemplos
Get a sas on a snapshot.
Sample Request
POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/snapshots/mySnapshot/beginGetAccess?api-version=2023-10-02
{
"access": "Read",
"durationInSeconds": 300,
"fileFormat": "VHDX"
}
Sample Response
{
"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
Definições
Name | Description |
---|---|
Access |
|
Access |
Um URI de SAS de acesso ao disco. |
File |
Utilizado para especificar o formato de ficheiro ao fazer um pedido de SAS num instantâneo de formato de ficheiro VHDX |
Grant |
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 ao estado de convidado de uma 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 | ||
durationInSeconds |
integer |
Duração do tempo em segundos até o acesso à SAS expirar. |
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 |