App Attach Package - Update

Služba:: Desktop Virtualization

Verze rozhraní API:: 2025-10-10

Aktualizace balíčku pro připojení aplikace

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
appAttachPackageName	path	True	string minLength: 3 maxLength: 100 pattern: ^[a-z0-9]([a-z0-9]\|(-(?!-))){1,61}[a-z0-9]$	Název balíčku Připojení aplikace
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Název skupiny prostředků. Název nerozlišuje malá a velká písmena.
subscriptionId	path	True	string (uuid)	ID cílového předplatného. Hodnota musí být UUID.
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.

Text požadavku

Name	Typ	Description
properties	AppAttachPackagePatchProperties	Podrobné vlastnosti balíčku pro připojení aplikace

Odpovědi

Name	Typ	Description
200 OK	AppAttachPackage	Úspěšně aktualizován App Attach Package.
Other Status Codes	ErrorResponse	Chybová odpověď automatizace popisující, proč se operace nezdařila.

Příklady

AppAttachPackage_Update

Ukázkový požadavek

HTTP

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

Ukázková odpověď

Stavový kód:: 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": ""
  }
}

Definice

Name	Description
AppAttachPackage	Schéma pro vlastnosti balíčku pro připojení aplikace.
AppAttachPackageInfoProperties	Schéma pro vlastnosti importu informací o balíčku.
AppAttachPackagePatch	Schéma pro aktualizovatelné vlastnosti balíčku Připojení aplikace.
AppAttachPackagePatchProperties	Schéma pro opravitelná pole v balíčku pro připojení aplikace.
AppAttachPackageProperties	Schéma pro vlastnosti balíčku pro připojení aplikace.
createdByType	Typ identity, která prostředek vytvořila.
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ErrorDetail	Podrobnosti o chybě.
ErrorResponse	Chybová odpověď
failHealthCheckOnStagingFailure	Parametr označující, jak se má kontrola stavu chovat, pokud tento balíček selže při přípravě
MsixPackageApplications	Schéma pro vlastnosti aplikace balíčku MSIX.
MsixPackageDependencies	Schéma pro vlastnosti závislostí balíčků MSIX.
packageTimestamped	Je časové razítko balíčku, aby mohlo ignorovat datum vypršení platnosti certifikátu.
ProvisioningState	Aktuální stav zřizování.
systemData	Metadata týkající se vytvoření a poslední změny prostředku.

AppAttachPackage

Objekt

Schéma pro vlastnosti balíčku pro připojení aplikace.

Name	Typ	Description
id	string (arm-id)	Plně kvalifikované ID prostředku pro prostředek. Např. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Geografické umístění, ve kterém se nachází zdroj
name	string	Název prostředku
properties	AppAttachPackageProperties	Podrobné vlastnosti balíčku pro připojení aplikace
systemData	systemData	Metadata služby Azure Resource Manager obsahující informace o tom, kdo jej vytvořil a upravil.
tags	object	Značky prostředků
type	string	Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts

AppAttachPackageInfoProperties

Objekt

Schéma pro vlastnosti importu informací o balíčku.

Name	Typ	Description
certificateExpiry	string (date-time)	Datum vypršení platnosti certifikátu nalezeného v appxmanifest.xml.
certificateName	string	Název certifikátu nalezený v appxmanifest.xml.
displayName	string	Uživatelsky přívětivý název, který se má zobrazit na portálu.
imagePath	string	Cesta k imagi VHD/CIM ve sdílené síťové složce
isActive	boolean	Nastavte tuto verzi balíčku jako aktivní v rámci fondu hostitelů.
isPackageTimestamped	packageTimestamped	Je časové razítko balíčku, aby mohlo ignorovat datum vypršení platnosti certifikátu.
isRegularRegistration	boolean	Určuje, jak zaregistrovat balíček v informačním kanálu.
lastUpdated	string (date-time)	Datum balíčku bylo naposledy aktualizováno v appxmanifest.xml.
packageAlias	string	Alias balíčku pro připojení aplikace Přiřazeno při importu
packageApplications	MsixPackageApplications[]	Seznam aplikací balíčků
packageDependencies	MsixPackageDependencies[]	Seznam závislostí balíčků
packageFamilyName	string	Jméno rodiny balíčků z appxmanifest.xml. Obsahuje název balíčku a název vydavatele.
packageFullName	string	Úplný název balíčku z appxmanifest.xml.
packageName	string	Název balíčku z appxmanifest.xml.
packageRelativePath	string	Relativní cesta k balíčku uvnitř image.
version	string	Verze balíčku nalezená v appxmanifest.xml.

AppAttachPackagePatch

Objekt

Schéma pro aktualizovatelné vlastnosti balíčku Připojení aplikace.

Name	Typ	Description
id	string (arm-id)	Plně kvalifikované ID prostředku pro prostředek. Např. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Název prostředku
properties	AppAttachPackagePatchProperties	Podrobné vlastnosti balíčku pro připojení aplikace
systemData	systemData	Metadata služby Azure Resource Manager obsahující informace o tom, kdo jej vytvořil a upravil.
type	string	Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts

AppAttachPackagePatchProperties

Objekt

Schéma pro opravitelná pole v balíčku pro připojení aplikace.

Name	Typ	Description
failHealthCheckOnStagingFailure	failHealthCheckOnStagingFailure	Parametr označující, jak se má kontrola stavu chovat, pokud tento balíček selže při přípravě
hostPoolReferences	string[] (arm-id)	Seznam ID prostředků fondu hostitelů
image	AppAttachPackageInfoProperties	Podrobné vlastnosti balíčku pro připojení aplikace
keyVaultURL	string	Cesta url k názvu certifikátu umístěnému ve službě KeyVault

AppAttachPackageProperties

Objekt

Schéma pro vlastnosti balíčku pro připojení aplikace.

Name	Typ	Description
failHealthCheckOnStagingFailure	failHealthCheckOnStagingFailure	Parametr označující, jak se má kontrola stavu chovat, pokud tento balíček selže při přípravě
hostPoolReferences	string[]	Seznam ID prostředků fondu hostitelů
image	AppAttachPackageInfoProperties	Podrobné vlastnosti balíčku pro připojení aplikace
keyVaultURL	string	Cesta url k názvu certifikátu umístěnému ve službě KeyVault
provisioningState	ProvisioningState	Stav zřizování balíčku pro připojení aplikace.

createdByType

Výčet

Typ identity, která prostředek vytvořila.

Hodnota	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objekt

Další informace o chybě správy prostředků

Name	Typ	Description
info	object	Další informace.
type	string	Další typ informací.

ErrorDetail

Objekt

Podrobnosti o chybě.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě.
code	string	Kód chyby.
details	ErrorDetail[]	Podrobnosti o chybě.
message	string	Chybová zpráva.
target	string	Cíl chyby.

ErrorResponse

Objekt

Chybová odpověď

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

failHealthCheckOnStagingFailure

Výčet

Parametr označující, jak se má kontrola stavu chovat, pokud tento balíček selže při přípravě

Hodnota	Description
Unhealthy
NeedsAssistance
DoNotFail

MsixPackageApplications

Objekt

Schéma pro vlastnosti aplikace balíčku MSIX.

Name	Typ	Description
appId	string	ID aplikace balíčku nalezené v appxmanifest.xml.
appUserModelID	string	Slouží k aktivaci aplikace balíčku. Skládá se z názvu balíčku a ID aplikace. Nachází se v appxmanifest.xml.
description	string	Popis aplikace balíčku
friendlyName	string	Uživatelsky přívětivý název.
iconImageName	string	Uživatelsky přívětivý název.
rawIcon	string (byte)	ikona 64bitového řetězce jako pole bajtů.
rawPng	string (byte)	ikona 64bitového řetězce jako pole bajtů.

MsixPackageDependencies

Objekt

Schéma pro vlastnosti závislostí balíčků MSIX.

Name	Typ	Description
dependencyName	string	Název závislosti balíčku
minVersion	string	Vyžaduje se verze závislostí.
publisher	string	Název vydavatele závislostí

packageTimestamped

Výčet

Je časové razítko balíčku, aby mohlo ignorovat datum vypršení platnosti certifikátu.

Hodnota	Description
Timestamped
NotTimestamped

ProvisioningState

Výčet

Aktuální stav zřizování.

Hodnota	Description
Succeeded
Provisioning
Failed
Canceled

systemData

Objekt

Metadata týkající se vytvoření a poslední změny prostředku.

Name	Typ	Description
createdAt	string (date-time)	Časové razítko vytvoření prostředku (UTC).
createdBy	string	Identita, která prostředek vytvořila.
createdByType	createdByType	Typ identity, která prostředek vytvořila.
lastModifiedAt	string (date-time)	Časové razítko poslední změny zdroje (UTC)
lastModifiedBy	string	Identita, která naposledy změnila prostředek.
lastModifiedByType	createdByType	Typ identity, která naposledy změnila prostředek.

Sdílet prostřednictvím

App Attach Package - Update

Parametry identifikátoru URI

Text požadavku

Odpovědi

Příklady

AppAttachPackage_Update

Ukázkový požadavek

Ukázková odpověď

Definice

AppAttachPackage

AppAttachPackageInfoProperties

AppAttachPackagePatch

AppAttachPackagePatchProperties

AppAttachPackageProperties

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

failHealthCheckOnStagingFailure

MsixPackageApplications

MsixPackageDependencies

packageTimestamped

ProvisioningState

systemData