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 |
|---|---|---|---|---|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas. |
|
snapshot
|
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. |
|
subscription
|
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 |
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 |
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 |
Operación de Azure completada con éxito. |
|
| 202 Accepted |
Operación de recursos aceptada. Encabezados
|
|
| Other Status Codes |
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
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 |
|---|---|
|
Access |
Los valores aceptados en el nivel de acceso incluyen Ninguno, Lectura, Escritura. |
|
Access |
Un URI de SAS de acceso al disco. |
|
Api |
Error de API. |
|
Api |
Base de errores de API. |
|
Cloud |
Una respuesta de error del servicio de proceso. |
|
File |
Se usa para especificar el formato de archivo al realizar una solicitud de SAS en una instantánea de formato de archivo VHDX |
|
Grant |
Datos usados para solicitar una SAS. |
|
Inner |
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 |
Detalles del error de la API |
|
| 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 |
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 |
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 |
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. |