App Attach Package - Update

服務:: Desktop Virtualization

API 版本:: 2024-04-03

更新應用程式附加套件

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DesktopVirtualization/appAttachPackages/{appAttachPackageName}?api-version=2024-04-03

URI 參數

名稱	位於	必要	類型	Description
appAttachPackageName	path	True	string minLength: 3 maxLength: 100 pattern: ^[a-z0-9]([a-z0-9]\|(-(?!-))){1,61}[a-z0-9]$	應用程式附加套件的名稱
resourceGroupName	path	True	string minLength: 1 maxLength: 90	資源群組的名稱。名稱不區分大小寫。
subscriptionId	path	True	string (uuid)	目標訂用帳戶的標識碼。此值必須是 UUID。
api-version	query	True	string minLength: 1	要用於這項作業的 API 版本。

要求本文

名稱	類型	Description
properties	AppAttachPackagePatchProperties	應用程式附加套件的詳細屬性

回應

名稱	類型	Description
200 OK	AppAttachPackage	已成功更新應用程式附加套件。
Other Status Codes	ErrorResponse	描述作業失敗原因的自動化錯誤回應。

範例

AppAttachPackage_Update

範例要求

HTTP

PATCH https://management.azure.com/subscriptions/daefabc0-95b4-48b3-b645-8a753a63c4fa/resourceGroups/resourceGroup1/providers/Microsoft.DesktopVirtualization/appAttachPackages/msixpackagefullname?api-version=2024-04-03

範例回覆

狀態碼:: 200

{
  "name": "packageName",
  "id": "/subscriptions/d15725f7-6577-4a8c-95f1-3da903b42364/resourcegroups/charlesk-southcentralus/providers/Microsoft.DesktopVirtualization/appattachpackages/ModifierPackage",
  "type": "Microsoft.DesktopVirtualization/appattachpackages",
  "location": "southcentralus",
  "tags": {},
  "systemData": {
    "createdBy": "user1",
    "createdByType": "User",
    "createdAt": "2023-09-28T23:44:56.13Z",
    "lastModifiedBy": "user1",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2023-10-09T01:43:31.07Z"
  },
  "properties": {
    "image": {
      "packageAlias": "msixpackagealias",
      "imagePath": "imagepath",
      "packageName": "MsixPackageName",
      "packageFamilyName": "MsixPackage_FamilyName",
      "packageFullName": "MsixPackage_FullName",
      "displayName": "displayname",
      "packageRelativePath": "packagerelativepath",
      "isRegularRegistration": false,
      "isActive": false,
      "packageDependencies": [
        {
          "dependencyName": "MsixPackage_Dependency_Name",
          "publisher": "MsixPackage_Dependency_Publisher",
          "minVersion": "packageDep_version"
        }
      ],
      "version": "packageversion",
      "lastUpdated": "2008-09-22T14:01:54.9571247Z",
      "packageApplications": [
        {
          "appId": "AppId",
          "description": "PackageApplicationDescription",
          "appUserModelID": "AppUserModelId",
          "friendlyName": "FriendlyName",
          "iconImageName": "Iconimagename",
          "rawIcon": "VGhpcyBpcyBhIHN0cmluZyB0byBoYXNo",
          "rawPng": "VGhpcyBpcyBhIHN0cmluZyB0byBoYXNo"
        }
      ],
      "certificateName": "certName",
      "certificateExpiry": "2023-01-02T17:18:19.1234567Z"
    },
    "hostPoolReferences": [],
    "failHealthCheckOnStagingFailure": "NeedsAssistance",
    "keyVaultURL": ""
  }
}

定義

名稱	Description
AppAttachPackage	應用程式附加套件屬性的架構。
AppAttachPackageInfoProperties	匯入封裝資訊屬性的架構。
AppAttachPackagePatch	可更新應用程式附加套件屬性的架構。
AppAttachPackagePatchProperties	應用程式附加套件上可修補欄位的架構。
AppAttachPackageProperties	應用程式附加套件屬性的架構。
createdByType	建立資源的身分識別類型。
ErrorAdditionalInfo	資源管理錯誤其他資訊。
ErrorDetail	錯誤詳細數據。
ErrorResponse	錯誤回應
failHealthCheckOnStagingFailure	參數，指出如果此套件失敗暫存，健康情況檢查應該如何運作
MsixPackageApplications	MSIX 封裝應用程式屬性的架構。
MsixPackageDependencies	MSIX 套件相依性屬性的架構。
packageTimestamped	封裝是否已時間戳，因此它可以忽略憑證到期日
ProvisioningState	目前的布建狀態。
systemData	與建立和上次修改資源相關的元數據。

AppAttachPackage

Object

應用程式附加套件屬性的架構。

名稱	類型	Description
id	string (arm-id)	資源的完整資源標識碼。例如 “/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}”
location	string	資源所在的地理位置
name	string	資源的名稱
properties	AppAttachPackageProperties	應用程式附加套件的詳細屬性
systemData	systemData	包含 createdBy 和 modifiedBy 資訊的 Azure Resource Manager 元數據。
tags	object	資源標籤。
type	string	資源的型別。例如“Microsoft.Compute/virtualMachines” 或 “Microsoft.Storage/storageAccounts”

AppAttachPackageInfoProperties

Object

匯入封裝資訊屬性的架構。

名稱	類型	Description
certificateExpiry	string (date-time)	日期憑證到期，可在 appxmanifest.xml中找到。
certificateName	string	appxmanifest.xml中找到的憑證名稱。
displayName	string	要顯示在入口網站中的使用者易記名稱。
imagePath	string	網路共用上的 VHD/CIM 映射路徑。
isActive	boolean	將此版本的套件設為跨主機集區的作用中套件。
isPackageTimestamped	packageTimestamped	封裝是否已時間戳，因此它可以忽略憑證到期日
isRegularRegistration	boolean	指定如何在摘要中註冊封裝。
lastUpdated	string (date-time)	上次更新日期套件，可在 appxmanifest.xml中找到。
packageAlias	string	應用程式附加套件的別名。在匯入時指派
packageApplications	MsixPackageApplications[]	套件應用程式清單。
packageDependencies	MsixPackageDependencies[]	套件相依性清單。
packageFamilyName	string	appxmanifest.xml的套件系列名稱。包含套件名稱和發行者名稱。
packageFullName	string	appxmanifest.xml的套件完整名稱。
packageName	string	appxmanifest.xml的套件名稱。
packageRelativePath	string	映射內封裝的相對路徑。
version	string	appxmanifest.xml中找到的套件版本。

AppAttachPackagePatch

Object

可更新應用程式附加套件屬性的架構。

名稱	類型	Description
id	string (arm-id)	資源的完整資源標識碼。例如 “/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}”
name	string	資源的名稱
properties	AppAttachPackagePatchProperties	應用程式附加套件的詳細屬性
systemData	systemData	包含 createdBy 和 modifiedBy 資訊的 Azure Resource Manager 元數據。
type	string	資源的型別。例如“Microsoft.Compute/virtualMachines” 或 “Microsoft.Storage/storageAccounts”

AppAttachPackagePatchProperties

Object

應用程式附加套件上可修補欄位的架構。

名稱	類型	Description
failHealthCheckOnStagingFailure	failHealthCheckOnStagingFailure	參數，指出如果此套件失敗暫存，健康情況檢查應該如何運作
hostPoolReferences	string[] (arm-id)	Hostpool 資源標識碼的清單。
image	AppAttachPackageInfoProperties	應用程式附加套件的詳細屬性
keyVaultURL	string	位於 keyVault 中憑證名稱的 URL 路徑

AppAttachPackageProperties

Object

應用程式附加套件屬性的架構。

名稱	類型	Description
failHealthCheckOnStagingFailure	failHealthCheckOnStagingFailure	參數，指出如果此套件失敗暫存，健康情況檢查應該如何運作
hostPoolReferences	string[]	Hostpool 資源標識碼的清單。
image	AppAttachPackageInfoProperties	應用程式附加套件的詳細屬性
keyVaultURL	string	位於 keyVault 中憑證名稱的 URL 路徑
provisioningState	ProvisioningState	應用程式附加套件的布建狀態。

createdByType

列舉型別

建立資源的身分識別類型。

值	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Object

資源管理錯誤其他資訊。

名稱	類型	Description
info	object	其他資訊。
type	string	其他信息類型。

ErrorDetail

Object

錯誤詳細數據。

名稱	類型	Description
additionalInfo	ErrorAdditionalInfo[]	錯誤其他資訊。
code	string	錯誤碼。
details	ErrorDetail[]	錯誤詳細數據。
message	string	錯誤訊息。
target	string	錯誤目標。

ErrorResponse

Object

錯誤回應

名稱	類型	Description
error	ErrorDetail	error 物件。

failHealthCheckOnStagingFailure

列舉型別

參數，指出如果此套件失敗暫存，健康情況檢查應該如何運作

值	Description
Unhealthy
NeedsAssistance
DoNotFail

MsixPackageApplications

Object

MSIX 封裝應用程式屬性的架構。

名稱	類型	Description
appId	string	套件應用程式識別碼，位於 appxmanifest.xml。
appUserModelID	string	用來啟動封裝應用程式。由套件名稱和ApplicationID所組成。在 appxmanifest.xml中找到。
description	string	封裝應用程式的描述。
friendlyName	string	用戶易記名稱。
iconImageName	string	用戶易記名稱。
rawIcon	string (byte)	圖示 64 位字串做為位元組陣列。
rawPng	string (byte)	圖示 64 位字串做為位元組陣列。

MsixPackageDependencies

Object

MSIX 套件相依性屬性的架構。

名稱	類型	Description
dependencyName	string	套件相依性的名稱。
minVersion	string	需要相依性版本。
publisher	string	相依性發行者的名稱。

packageTimestamped

列舉型別

封裝是否已時間戳，因此它可以忽略憑證到期日

值	Description
Timestamped
NotTimestamped

ProvisioningState

列舉型別

目前的布建狀態。

值	Description
Succeeded
Provisioning
Failed
Canceled

systemData

Object

與建立和上次修改資源相關的元數據。

名稱	類型	Description
createdAt	string (date-time)	資源建立的時間戳（UTC）。
createdBy	string	建立資源的身分識別。
createdByType	createdByType	建立資源的身分識別類型。
lastModifiedAt	string (date-time)	上次修改的資源時間戳（UTC）
lastModifiedBy	string	上次修改資源的身分識別。
lastModifiedByType	createdByType	上次修改資源的身分識別類型。

共用方式為

App Attach Package - Update

URI 參數

要求本文

回應

範例

AppAttachPackage_Update

範例要求

範例回覆

定義

AppAttachPackage

AppAttachPackageInfoProperties

AppAttachPackagePatch

AppAttachPackagePatchProperties

AppAttachPackageProperties

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

failHealthCheckOnStagingFailure

MsixPackageApplications

MsixPackageDependencies

packageTimestamped

ProvisioningState

systemData