Snapshots - Grant Access

Concede acceso a una instantánea.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/snapshots/{snapshotName}/beginGetAccess?api-version=2025-01-02

Parámetros de identificador URI

Nombre En Requerido Tipo Description
resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.

snapshotName
path True

string

Nombre de la instantánea que se va a crear. El nombre no se puede cambiar después de crear la instantánea. Los caracteres admitidos para el nombre son a-z, A-Z, 0-9, _ y -. La longitud máxima del nombre es de 80 caracteres.

subscriptionId
path True

string

minLength: 1

Identificador de la suscripción de destino.

api-version
query True

string

minLength: 1

Versión de API que se usará para la operación.

Cuerpo de la solicitud

Nombre Requerido Tipo Description
access True

AccessLevel

Los valores aceptados en el nivel de acceso incluyen Ninguno, Lectura, Escritura.

durationInSeconds True

integer (int32)

Duración del tiempo en segundos hasta que expire el acceso SAS.

fileFormat

FileFormat

Se usa para especificar el formato de archivo al realizar una solicitud de SAS en una instantánea de formato de archivo VHDX

getSecureVMGuestStateSAS

boolean

Establezca esta marca en true para obtener SAS adicional para el estado invitado de la máquina virtual

Respuestas

Nombre Tipo Description
200 OK

AccessUri

Operación de Azure completada con éxito.

202 Accepted

Operación de recursos aceptada.

Encabezados

  • Location: string
  • Retry-After: integer
Other Status Codes

CloudError

Una respuesta de error inesperada.

Seguridad

azure_auth

Azure Active Directory OAuth2 Flow.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre Description
user_impersonation suplantar la cuenta de usuario

Ejemplos

Get a sas on a snapshot.

Solicitud de ejemplo

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/snapshots/mySnapshot/beginGetAccess?api-version=2025-01-02

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

Respuesta de muestra

{
  "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=2025-01-02

Definiciones

Nombre Description
AccessLevel

Los valores aceptados en el nivel de acceso incluyen Ninguno, Lectura, Escritura.

AccessUri

Un URI de SAS de acceso al disco.

ApiError

Error de API.

ApiErrorBase

Base de errores de API.

CloudError

Una respuesta de error del servicio de proceso.

FileFormat

Se usa para especificar el formato de archivo al realizar una solicitud de SAS en una instantánea de formato de archivo VHDX

GrantAccessData

Datos usados para solicitar una SAS.

InnerError

Detalles del error interno.

AccessLevel

Los valores aceptados en el nivel de acceso incluyen Ninguno, Lectura, Escritura.

Valor Description
None
Read
Write

AccessUri

Un URI de SAS de acceso al disco.

Nombre Tipo Description
accessSAS

string

Un URI de SAS para acceder a un disco.

securityDataAccessSAS

string

Un URI de SAS para acceder a un estado de invitado de máquina virtual.

securityMetadataAccessSAS

string

Un URI de SAS para acceder a los metadatos de una máquina virtual.

ApiError

Error de API.

Nombre Tipo Description
code

string

Código de error.

details

ApiErrorBase[]

Detalles del error de la API

innererror

InnerError

El error interno de la API

message

string

El mensaje de error.

target

string

Destino del error concreto.

ApiErrorBase

Base de errores de API.

Nombre Tipo Description
code

string

Código de error.

message

string

El mensaje de error.

target

string

Destino del error concreto.

CloudError

Una respuesta de error del servicio de proceso.

Nombre Tipo Description
error

ApiError

Error de API.

FileFormat

Se usa para especificar el formato de archivo al realizar una solicitud de SAS en una instantánea de formato de archivo VHDX

Valor Description
VHD

Un archivo VHD es un archivo de imagen de disco en el formato de archivo de disco duro virtual.

VHDX

Un archivo VHDX es un archivo de imagen de disco en el formato de archivo de disco duro virtual v2.

GrantAccessData

Datos usados para solicitar una SAS.

Nombre Tipo Description
access

AccessLevel

Los valores aceptados en el nivel de acceso incluyen Ninguno, Lectura, Escritura.

durationInSeconds

integer (int32)

Duración del tiempo en segundos hasta que expire el acceso SAS.

fileFormat

FileFormat

Se usa para especificar el formato de archivo al realizar una solicitud de SAS en una instantánea de formato de archivo VHDX

getSecureVMGuestStateSAS

boolean

Establezca esta marca en true para obtener SAS adicional para el estado invitado de la máquina virtual

InnerError

Detalles del error interno.

Nombre Tipo Description
errordetail

string

El mensaje de error interno o el volcado de excepción.

exceptiontype

string

Tipo de la excepción.