Snapshots - Grant Access

スナップショットへのアクセス権を付与します。

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

URI パラメーター

Name / 必須 型 説明
resourceGroupName
path True

string

minLength: 1
maxLength: 90

リソース グループの名前。 名前は大文字と小文字を区別しません。

snapshotName
path True

string

作成されるスナップショットの名前。 スナップショットの作成後に名前を変更することはできません。 名前でサポートされている文字は、a~z、A~Z、0~9、_ および -です。 名前の最大長は 80 文字です。

subscriptionId
path True

string

minLength: 1

ターゲット サブスクリプションの ID。

api-version
query True

string

minLength: 1

この操作に使用する API バージョン。

要求本文

Name 必須 型 説明
access True

AccessLevel

アクセスレベル、受け入れられる値には、なし、読み取り、書き込みが含まれます。

durationInSeconds True

integer (int32)

SAS アクセスの有効期限が切れるまでの時間 (秒単位)。

fileFormat

FileFormat

VHDX ファイル形式のスナップショットで SAS を要求するときにファイル形式を指定するために使用します

getSecureVMGuestStateSAS

boolean

このフラグを true に設定すると、追加の SAS for VM ゲスト状態が取得されます

応答

Name 型 説明
200 OK

AccessUri

Azureの運用は無事に完了しました。

202 Accepted

リソース操作が受け入れられます。

ヘッダー

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

CloudError

予期しないエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー。

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

Name 説明
user_impersonation あなたのユーザー アカウントになりすます

例

Get a sas on a snapshot.

要求のサンプル

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

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

応答のサンプル

{
  "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=2026-03-02

定義

Name 説明
AccessLevel

アクセスレベル、受け入れられる値には、なし、読み取り、書き込みが含まれます。

AccessUri

ディスク アクセス SAS URI。

ApiError

API エラー。

ApiErrorBase

API エラーベース。

CloudError

コンピューティング サービスからのエラー応答。

FileFormat

VHDX ファイル形式のスナップショットで SAS を要求するときにファイル形式を指定するために使用します

GrantAccessData

SAS の要求に使用されるデータ。

InnerError

内部エラーの詳細。

AccessLevel

アクセスレベル、受け入れられる値には、なし、読み取り、書き込みが含まれます。

値 説明
None
Read
Write

AccessUri

ディスク アクセス SAS URI。

Name 型 説明
accessSAS

string

ディスクにアクセスするための SAS URI。

securityDataAccessSAS

string

VM ゲスト状態にアクセスするための SAS URI。

securityMetadataAccessSAS

string

VM メタデータにアクセスするための SAS uri。

ApiError

API エラー。

Name 型 説明
code

string

エラー コード。

details

ApiErrorBase[]

Api エラーの詳細

innererror

InnerError

Api 内部エラー

message

string

エラー メッセージ。

target

string

特定のエラーのターゲット。

ApiErrorBase

API エラーベース。

Name 型 説明
code

string

エラー コード。

message

string

エラー メッセージ。

target

string

特定のエラーのターゲット。

CloudError

コンピューティング サービスからのエラー応答。

Name 型 説明
error

ApiError

API エラー。

FileFormat

VHDX ファイル形式のスナップショットで SAS を要求するときにファイル形式を指定するために使用します

値 説明
VHD

VHD ファイルは、仮想ハード ディスク ファイル形式のディスク イメージ ファイルです。

VHDX

VHDX ファイルは、仮想ハード ディスク v2 ファイル形式のディスク イメージ ファイルです。

GrantAccessData

SAS の要求に使用されるデータ。

Name 型 説明
access

AccessLevel

アクセスレベル、受け入れられる値には、なし、読み取り、書き込みが含まれます。

durationInSeconds

integer (int32)

SAS アクセスの有効期限が切れるまでの時間 (秒単位)。

fileFormat

FileFormat

VHDX ファイル形式のスナップショットで SAS を要求するときにファイル形式を指定するために使用します

getSecureVMGuestStateSAS

boolean

このフラグを true に設定すると、追加の SAS for VM ゲスト状態が取得されます

InnerError

内部エラーの詳細。

Name 型 説明
errordetail

string

内部エラー メッセージまたは例外ダンプ。

exceptiontype

string

例外の種類。