從 Azure DevTest Labs 匯出或刪除個人資料

本文提供從 Azure DevTest Labs 服務刪除及匯出個人資料的步驟。

DevTest Labs 會收集哪些個人資料？

DevTest Labs 會對使用者收集兩種主要的個人資料。 這兩種資料是使用者電子郵件地址和使用者物件識別碼。 這些都是服務為實驗室管理員和實驗室使用者提供服務功能所不可或缺的資訊。

使用者電子郵件地址

DevTest Labs 會依據使用者電子郵件地址，將自動關閉電子郵件通知傳送給實驗室使用者。 此電子郵件會通知使用者其機器即將關閉。 使用者可依需求自行選擇延後或略過關機作業。 您可以設定實驗室層級或 VM 層級的電子郵件地址。

設定實驗室的電子郵件：

設定 VM 的電子郵件：

使用者物件識別碼

DevTest Labs 會透過使用者物件識別碼向實驗室管理員顯示逐月的成本趨勢，以及依資源列出的成本資訊。 它可讓管理員追蹤成本及管理其實驗室的閾值。

目前行事曆月份的預估成本趨勢：

根據資源預估的本月費用：

我們為何需要這項個人資料？

DevTest Labs 服務會基於運作目的使用個人資料。 這是服務為了提供重要功能所不可或缺的資料。 如果您設定了使用者電子郵件地址的保留原則，實驗室使用者在其電子郵件地址從我們的系統中刪除後，就無法適時收到自動關閉電子郵件通知。 同樣地，如果使用者物件識別碼依據保留原則而刪除，實驗室管理員也無法就其在實驗室中的機器檢視逐月成本趨勢和個別資源的成本。 因此，只要使用者的資源在實驗室中仍有效用，就必須保留這項資料。

如何讓系統消除我的個人資料？

如果您是實驗室使用者，當您想要刪除這項個人資料時，可以藉由刪除實驗室中的對應資源來達到此目的。 DevTest Labs 服務會在使用者刪除其個人資料的 30 天後，將已刪除的資料匿名處理。

例如，如果您刪除了 VM，或移除了電子郵件地址，DevTest Labs 服務將會在資源刪除的 30 天後將這項資料匿名處理。 刪除後保留 30 天的原則，是為了確保我們能為實驗室管理員提供精確的逐月成本預測。

如何要求匯出我的個人資料？

您可以使用 Azure 入口網站或 PowerShell 來匯出個人和實驗室使用方式資料。 資料會匯出為兩個不同的 CSV 檔案：

• disks.csv - 包含不同 VM 所使用的磁碟相關資訊
• virtualmachines.csv - 包含實驗室中 VM 的相關資訊。

Azure 入口網站

身為實驗室使用者，您可以要求匯出 DevTest Labs 服務所儲存的個人資料。 若要要求匯出，請瀏覽至實驗室 [概觀] 頁面上的 [個人資料] 選項。 選取 [要求匯出] 按鈕，即可開始在您實驗室管理員的儲存體帳戶中建立可下載的 Excel 檔案。 接著，您可以連絡實驗室管理員以檢視這項資料。

1. 選取左側功能表上的 [個人資料]。

   

2. 選取包含實驗室的資源群組。

   

3. 選取資源群組中的儲存體帳戶。

4. 在 [儲存體帳戶] 頁面上，選取 [Blob]。

   

5. 在容器清單中選取名為 labresourceusage 的容器。

   

6. 選取以您的實驗室命名的資料夾。 在此資料夾中，您會看到您實驗室中的磁碟和虛擬機器的 csv 檔案。 您可以下載這些 csv 檔案、篩選出要求存取的實驗室使用者所適用的內容，並與他們共用。

   

Azure PowerShell

Param (
    [Parameter (Mandatory=$true, HelpMessage="The storage account name where to store usage data")]
    [string] $storageAccountName,

    [Parameter (Mandatory=$true, HelpMessage="The storage account key")]
    [string] $storageKey,

    [Parameter (Mandatory=$true, HelpMessage="The DevTest Lab name to get usage data from")]
    [string] $labName,

    [Parameter (Mandatory=$true, HelpMessage="The DevTest Lab subscription")]
    [string] $labSubscription
    )

#Login
Login-AzureRmAccount

# Set the subscription for the lab
Get-AzureRmSubscription -SubscriptionId $labSubscription  | Select-AzureRmSubscription

# DTL will create this container in the storage when invoking the action, cannot be changed currently
$containerName = "labresourceusage"

# Get the storage context
$Ctx = New-AzureStorageContext -StorageAccountName $storageAccountName -StorageAccountKey $storageKey 
$SasToken = New-AzureStorageAccountSASToken -Service Blob, File -ResourceType Container, Service, Object -Permission rwdlacup -Protocol HttpsOnly -Context $Ctx

# Generate the storage blob uri
$blobUri = $Ctx.BlobEndPoint + $SasToken

# blobStorageAbsoluteSasUri and usageStartDate are required
$actionParameters = @{
    'blobStorageAbsoluteSasUri' = $blobUri    
}

$startdate = (Get-Date).AddDays(-7)

$actionParameters.Add('usageStartDate', $startdate.Date.ToString())

# Get the lab resource group
$resourceGroupName = (Find-AzureRmResource -ResourceType 'Microsoft.DevTestLab/labs' | Where-Object { $_.Name -eq $labName}).ResourceGroupName
    
# Create the lab resource id
$resourceId = "/subscriptions/" + $labSubscription + "/resourceGroups/" + $resourceGroupName + "/providers/Microsoft.DevTestLab/labs/" + $labName + "/"

# !!!!!!! this is the new resource action to get the usage data.
$result = Invoke-AzureRmResourceAction -Action 'exportLabResourceUsage' -ResourceId $resourceId -Parameters $actionParameters -Force
 
# Finish up cleanly
if ($result.Status -eq "Succeeded") {
    Write-Output "Telemetry successfully downloaded for " $labName
    return 0
}
else
{
    Write-Output "Failed to download lab: " + $labName
    Write-Error $result.toString()
    return -1
}

上述樣本中的主要元件包括：

• Invoke-AzureRmResourceAction 命令。

  Invoke-AzureRmResourceAction -Action 'exportLabResourceUsage' -ResourceId $resourceId -Parameters $actionParameters -Force
  

• 兩個動作參數

  • blobStorageAbsoluteSasUri - 具有共用存取簽章 (SAS) 權杖的儲存體帳戶 URI。 在 PowerShell 指令碼中，此值可以傳入，而不是儲存體金鑰。
  • usageStartDate - 提取資料的開始日期，結束日期是執行動作的目前日期。 細微性位於日期層級，因此即使您新增時間資訊，其也會遭到忽略。

匯出的資料 - 更仔細地查看

現在讓我們進一步查看匯出的資料。 如先前所述，成功匯出資料之後，將會有兩個 CSV 檔案。

virtualmachines.csv 包含下列資料行：

資料行名稱	描述
SubscriptionId	實驗室存在於其中的訂用帳戶識別碼。
LabUId	實驗室的唯一 GUID 識別碼。
LabName	實驗室名稱。
LabResourceId	完整實驗室資源識別碼。
resourceGroupName	包含 VM 的資源群組名稱
ResourceId	VM 的完整資源識別碼。
ResourceUId	VM 的 GUID
名稱	虛擬機器名稱。
CreatedTime	VM 的建立日期時間。
DeletedDate	VM 的刪除日期時間。 如果是空的，則尚未發生刪除。
ResourceOwner	VM 的擁有者。 如果值是空的，則其是可宣告的 VM 或由服務主體所建立。
PricingTier	VM 的定價層
ResourceStatus	VM 的可用性狀態。 如果仍然存在，則為作用中，或如果 VM 已遭刪除，則為非作用中。
ComputeResourceId	完整虛擬機器計算資源識別碼。
可宣告	如果 VM 是可宣告的 VM，請設定為 true
EnvironmentId	在其中建立虛擬機器的環境資源識別碼。 當 VM 未建立為環境資源的一部分時，會是空的。
ExpirationDate	VM 的到期日。 如果尚未設定到期日，則會設定為空白。
GalleryImageReferenceVersion	VM 基礎映像的版本。
GalleryImageReferenceOffer	VM 基礎映像的供應項目。
GalleryImageReferencePublisher	VM 基礎映像的發行者。
GalleryImageReferenceSku	VM 基礎映像的 Sku
GalleryImageReferenceOsType	VM 基礎映像的 OS 類型
CustomImageId	VM 基礎自訂映像的完整識別碼。

下列列出 disks.csv 中包含的資料行：

資料行名稱	描述
SubscriptionId	包含實驗室的訂用帳戶識別碼
LabUId	實驗室的 GUID
LabName	實驗室名稱
LabResourceId	實驗室的完整資源識別碼
resourceGroupName	包含實驗室的資源群組名稱
ResourceId	VM 的完整資源識別碼。
ResourceUId	VM 的 GUID
名稱	連結磁碟的名稱
CreatedTime	資料磁碟的建立日期和時間。
DeletedDate	資料磁碟的刪除日期和時間。
ResourceStatus	資源的狀態。 如果資源存在，則為作用中。 刪除時為非作用中。
DiskBlobName	資料磁碟的 Blob 名稱。
DiskSizeGB	資料磁碟的大小。
DiskType	資料磁碟的類型。 若為標準，則為 0，若為進階，則為 1。
LeasedByVmId	已連結資料磁碟的 VM 資源識別碼。

注意

如果您要處理多個實驗室並想要取得整體資訊，這兩個索引鍵資料行是 LabUID 和 ResourceUId，這兩者是跨訂用帳戶的唯一識別碼。

您可以使用 SQL Server、Power BI 等工具來操作和視覺化匯出的資料。當您想要將實驗室的使用狀況回報給可能未使用與您相同的 Azure 訂用帳戶的管理小組時，這項功能特別有用。

下一步

請參閱以下文章：

• 設定實驗室的原則