App Attach Package - Update

Dienst:

Desktop Virtualization

API-Version:

2024-04-03

Aktualisieren eines App Attach-Pakets

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
appAttachPackageName	path	True	string minLength: 3 maxLength: 100 pattern: ^[a-z0-9]([a-z0-9]|(-(?!-))){1,61}[a-z0-9]$	Der Name des App Attach-Pakets
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.
subscriptionId	path	True	string (uuid)	Die ID des Zielabonnements. Der Wert muss eine UUID sein.
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.

Anforderungstext

Name	Typ	Beschreibung
properties	AppAttachPackagePatchProperties	Detaillierte Eigenschaften für das App Attach-Paket

Antworten

Name	Typ	Beschreibung
200 OK	AppAttachPackage	Das App Attach-Paket wurde erfolgreich aktualisiert.
Other Status Codes	ErrorResponse	Automatisierungsfehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Beispiele

AppAttachPackage_Update

Beispielanforderung

HTTP

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

Java

import com.azure.resourcemanager.desktopvirtualization.models.AppAttachPackage;

/**
 * Samples for AppAttachPackage Update.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/desktopvirtualization/resource-manager/Microsoft.DesktopVirtualization/stable/2024-04-03/examples/
     * AppAttachPackage_Update.json
     */
    /**
     * Sample code: AppAttachPackage_Update.
     * 
     * @param manager Entry point to DesktopVirtualizationManager.
     */
    public static void
        appAttachPackageUpdate(com.azure.resourcemanager.desktopvirtualization.DesktopVirtualizationManager manager) {
        AppAttachPackage resource = manager.appAttachPackages()
            .getByResourceGroupWithResponse("resourceGroup1", "msixpackagefullname", com.azure.core.util.Context.NONE)
            .getValue();
        resource.update().apply();
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Python

from azure.identity import DefaultAzureCredential

from azure.mgmt.desktopvirtualization import DesktopVirtualizationMgmtClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-desktopvirtualization
# USAGE
    python app_attach_package_update.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = DesktopVirtualizationMgmtClient(
        credential=DefaultAzureCredential(),
        subscription_id="daefabc0-95b4-48b3-b645-8a753a63c4fa",
    )

    response = client.app_attach_package.update(
        resource_group_name="resourceGroup1",
        app_attach_package_name="msixpackagefullname",
    )
    print(response)


# x-ms-original-file: specification/desktopvirtualization/resource-manager/Microsoft.DesktopVirtualization/stable/2024-04-03/examples/AppAttachPackage_Update.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Go

package armdesktopvirtualization_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/desktopvirtualization/armdesktopvirtualization/v2"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/4883fa5dbf6f2c9093fac8ce334547e9dfac68fa/specification/desktopvirtualization/resource-manager/Microsoft.DesktopVirtualization/stable/2024-04-03/examples/AppAttachPackage_Update.json
func ExampleAppAttachPackageClient_Update() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armdesktopvirtualization.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewAppAttachPackageClient().Update(ctx, "resourceGroup1", "msixpackagefullname", &armdesktopvirtualization.AppAttachPackageClientUpdateOptions{AppAttachPackagePatch: nil})
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.AppAttachPackage = armdesktopvirtualization.AppAttachPackage{
	// 	Name: to.Ptr("packageName"),
	// 	Type: to.Ptr("Microsoft.DesktopVirtualization/appattachpackages"),
	// 	ID: to.Ptr("/subscriptions/d15725f7-6577-4a8c-95f1-3da903b42364/resourcegroups/charlesk-southcentralus/providers/Microsoft.DesktopVirtualization/appattachpackages/ModifierPackage"),
	// 	SystemData: &armdesktopvirtualization.SystemData{
	// 		CreatedAt: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2023-09-28T23:44:56.130Z"); return t}()),
	// 		CreatedBy: to.Ptr("user1"),
	// 		CreatedByType: to.Ptr(armdesktopvirtualization.CreatedByTypeUser),
	// 		LastModifiedAt: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2023-10-09T01:43:31.070Z"); return t}()),
	// 		LastModifiedBy: to.Ptr("user1"),
	// 		LastModifiedByType: to.Ptr(armdesktopvirtualization.CreatedByTypeUser),
	// 	},
	// 	Location: to.Ptr("southcentralus"),
	// 	Tags: map[string]*string{
	// 	},
	// 	Properties: &armdesktopvirtualization.AppAttachPackageProperties{
	// 		FailHealthCheckOnStagingFailure: to.Ptr(armdesktopvirtualization.FailHealthCheckOnStagingFailureNeedsAssistance),
	// 		HostPoolReferences: []*string{
	// 		},
	// 		Image: &armdesktopvirtualization.AppAttachPackageInfoProperties{
	// 			CertificateExpiry: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2023-01-02T17:18:19.123Z"); return t}()),
	// 			CertificateName: to.Ptr("certName"),
	// 			DisplayName: to.Ptr("displayname"),
	// 			ImagePath: to.Ptr("imagepath"),
	// 			IsActive: to.Ptr(false),
	// 			IsRegularRegistration: to.Ptr(false),
	// 			LastUpdated: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2008-09-22T14:01:54.957Z"); return t}()),
	// 			PackageAlias: to.Ptr("msixpackagealias"),
	// 			PackageApplications: []*armdesktopvirtualization.MsixPackageApplications{
	// 				{
	// 					Description: to.Ptr("PackageApplicationDescription"),
	// 					AppID: to.Ptr("AppId"),
	// 					AppUserModelID: to.Ptr("AppUserModelId"),
	// 					FriendlyName: to.Ptr("FriendlyName"),
	// 					IconImageName: to.Ptr("Iconimagename"),
	// 					RawIcon: []byte("VGhpcyBpcyBhIHN0cmluZyB0byBoYXNo"),
	// 					RawPNG: []byte("VGhpcyBpcyBhIHN0cmluZyB0byBoYXNo"),
	// 			}},
	// 			PackageDependencies: []*armdesktopvirtualization.MsixPackageDependencies{
	// 				{
	// 					DependencyName: to.Ptr("MsixPackage_Dependency_Name"),
	// 					MinVersion: to.Ptr("packageDep_version"),
	// 					Publisher: to.Ptr("MsixPackage_Dependency_Publisher"),
	// 			}},
	// 			PackageFamilyName: to.Ptr("MsixPackage_FamilyName"),
	// 			PackageFullName: to.Ptr("MsixPackage_FullName"),
	// 			PackageName: to.Ptr("MsixPackageName"),
	// 			PackageRelativePath: to.Ptr("packagerelativepath"),
	// 			Version: to.Ptr("packageversion"),
	// 		},
	// 		KeyVaultURL: to.Ptr(""),
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

JavaScript

const { DesktopVirtualizationAPIClient } = require("@azure/arm-desktopvirtualization");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Update an App Attach Package
 *
 * @summary Update an App Attach Package
 * x-ms-original-file: specification/desktopvirtualization/resource-manager/Microsoft.DesktopVirtualization/stable/2024-04-03/examples/AppAttachPackage_Update.json
 */
async function appAttachPackageUpdate() {
  const subscriptionId =
    process.env["DESKTOPVIRTUALIZATION_SUBSCRIPTION_ID"] || "daefabc0-95b4-48b3-b645-8a753a63c4fa";
  const resourceGroupName = process.env["DESKTOPVIRTUALIZATION_RESOURCE_GROUP"] || "resourceGroup1";
  const appAttachPackageName = "msixpackagefullname";
  const credential = new DefaultAzureCredential();
  const client = new DesktopVirtualizationAPIClient(credential, subscriptionId);
  const result = await client.appAttachPackageOperations.update(
    resourceGroupName,
    appAttachPackageName,
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

dotnet

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.DesktopVirtualization.Models;
using Azure.ResourceManager.DesktopVirtualization;

// Generated from example definition: specification/desktopvirtualization/resource-manager/Microsoft.DesktopVirtualization/stable/2024-04-03/examples/AppAttachPackage_Update.json
// this example is just showing the usage of "AppAttachPackage_Update" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this AppAttachPackageResource created on azure
// for more information of creating AppAttachPackageResource, please refer to the document of AppAttachPackageResource
string subscriptionId = "daefabc0-95b4-48b3-b645-8a753a63c4fa";
string resourceGroupName = "resourceGroup1";
string appAttachPackageName = "msixpackagefullname";
ResourceIdentifier appAttachPackageResourceId = AppAttachPackageResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, appAttachPackageName);
AppAttachPackageResource appAttachPackage = client.GetAppAttachPackageResource(appAttachPackageResourceId);

// invoke the operation
AppAttachPackagePatch patch = new AppAttachPackagePatch();
AppAttachPackageResource result = await appAttachPackage.UpdateAsync(patch);

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
AppAttachPackageData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Beispiel für eine Antwort

Statuscode:

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": ""
  }
}

Definitionen

Name	Beschreibung
AppAttachPackage	Schema für App Attach-Paketeigenschaften.
AppAttachPackageInfoProperties	Schema für Eigenschaften des Importpaketinformations.
AppAttachPackagePatch	Schema für aktualisierbare App Attach-Paketeigenschaften.
AppAttachPackagePatchProperties	Schema für patchbare Felder in einem App Attach-Paket.
AppAttachPackageProperties	Schema für App Attach-Paketeigenschaften.
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
ErrorAdditionalInfo	Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorDetail	Das Fehlerdetails.
ErrorResponse	Fehlerantwort
failHealthCheckOnStagingFailure	Parameter, der angibt, wie sich die Integritätsprüfung verhalten soll, wenn das Staging dieses Pakets fehlschlägt
MsixPackageApplications	Schema für MSIX-Paketanwendungseigenschaften.
MsixPackageDependencies	Schema für MSIX Package Dependencies-Eigenschaften.
packageTimestamped	Ist paketzeitstempelt, sodass es das Ablaufdatum des Zertifikats ignorieren kann
ProvisioningState	Der aktuelle Bereitstellungsstatus.
systemData	Metadaten zur Erstellung und letzten Änderung der Ressource.

AppAttachPackage

Objekt

Schema für App Attach-Paketeigenschaften.

Name	Typ	Beschreibung
id	string (arm-id)	Vollqualifizierte Ressourcen-ID für die Ressource. Z. B. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Der geografische Standort, an dem sich die Ressource befindet
name	string	Der Name der Ressource
properties	AppAttachPackageProperties	Detaillierte Eigenschaften für das App Attach-Paket
systemData	systemData	Azure Resource Manager-Metadaten, die createdBy- und modifiedBy-Informationen enthalten.
tags	object	Ressourcentags.
type	string	Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

AppAttachPackageInfoProperties

Objekt

Schema für Eigenschaften des Importpaketinformations.

Name	Typ	Beschreibung
certificateExpiry	string (date-time)	Das Datum läuft ab, das im appxmanifest.xmlgefunden wird.
certificateName	string	Im appxmanifest.xmlgefundener Zertifikatname.
displayName	string	Benutzerfreundlicher Name, der im Portal angezeigt werden soll.
imagePath	string	VHD/CIM-Imagepfad auf der Netzwerkfreigabe.
isActive	boolean	Legen Sie diese Version des Pakets für das aktive Paket im Hostpool fest.
isPackageTimestamped	packageTimestamped	Ist paketzeitstempelt, sodass es das Ablaufdatum des Zertifikats ignorieren kann
isRegularRegistration	boolean	Gibt an, wie Paket im Feed registriert wird.
lastUpdated	string (date-time)	Das Datumspaket wurde zuletzt aktualisiert, das im appxmanifest.xmlgefunden wurde.
packageAlias	string	Alias des App Attach-Pakets. Zur Importzeit zugewiesen
packageApplications	MsixPackageApplications[]	Liste der Paketanwendungen.
packageDependencies	MsixPackageDependencies[]	Liste der Paketabhängigkeiten.
packageFamilyName	string	Paketfamilienname aus appxmanifest.xml. Enthält den Paketnamen und den Herausgebernamen.
packageFullName	string	Vollständiger Paketname aus appxmanifest.xml.
packageName	string	Paketname aus appxmanifest.xml.
packageRelativePath	string	Relativer Pfad zum Paket innerhalb des Bilds.
version	string	Paketversion im appxmanifest.xmlgefunden.

AppAttachPackagePatch

Objekt

Schema für aktualisierbare App Attach-Paketeigenschaften.

Name	Typ	Beschreibung
id	string (arm-id)	Vollqualifizierte Ressourcen-ID für die Ressource. Z. B. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Der Name der Ressource
properties	AppAttachPackagePatchProperties	Detaillierte Eigenschaften für das App Attach-Paket
systemData	systemData	Azure Resource Manager-Metadaten, die createdBy- und modifiedBy-Informationen enthalten.
type	string	Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

AppAttachPackagePatchProperties

Objekt

Schema für patchbare Felder in einem App Attach-Paket.

Name	Typ	Beschreibung
failHealthCheckOnStagingFailure	failHealthCheckOnStagingFailure	Parameter, der angibt, wie sich die Integritätsprüfung verhalten soll, wenn das Staging dieses Pakets fehlschlägt
hostPoolReferences	string[] (arm-id)	Liste der Hostpool-Ressourcen-IDs.
image	AppAttachPackageInfoProperties	Detaillierte Eigenschaften für das App Attach-Paket
keyVaultURL	string	URL-Pfad zum Zertifikatnamen, der sich in keyVault befindet

AppAttachPackageProperties

Objekt

Schema für App Attach-Paketeigenschaften.

Name	Typ	Beschreibung
failHealthCheckOnStagingFailure	failHealthCheckOnStagingFailure	Parameter, der angibt, wie sich die Integritätsprüfung verhalten soll, wenn das Staging dieses Pakets fehlschlägt
hostPoolReferences	string[]	Liste der Hostpool-Ressourcen-IDs.
image	AppAttachPackageInfoProperties	Detaillierte Eigenschaften für das App Attach-Paket
keyVaultURL	string	URL-Pfad zum Zertifikatnamen, der sich in keyVault befindet
provisioningState	ProvisioningState	Der Bereitstellungsstatus des App Attach-Pakets.

createdByType

Enumeration

Der Identitätstyp, der die Ressource erstellt hat.

Wert	Beschreibung
Application
Key
ManagedIdentity
User

ErrorAdditionalInfo

Objekt

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name	Typ	Beschreibung
info	object	Die zusätzlichen Informationen.
type	string	Der zusätzliche Informationstyp.

ErrorDetail

Objekt

Das Fehlerdetails.

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Informationen des Fehlers.
code	string	Der Fehlercode.
details	ErrorDetail[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

ErrorResponse

Objekt

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

failHealthCheckOnStagingFailure

Enumeration

Parameter, der angibt, wie sich die Integritätsprüfung verhalten soll, wenn das Staging dieses Pakets fehlschlägt

Wert	Beschreibung
DoNotFail
NeedsAssistance
Unhealthy

MsixPackageApplications

Objekt

Schema für MSIX-Paketanwendungseigenschaften.

Name	Typ	Beschreibung
appId	string	Paketanwendungs-ID, in appxmanifest.xmlgefunden.
appUserModelID	string	Wird zum Aktivieren der Paketanwendung verwendet. Besteht aus Paketname und ApplicationID. In appxmanifest.xmlgefunden.
description	string	Beschreibung der Paketanwendung.
friendlyName	string	Benutzerfreundlicher Name.
iconImageName	string	Benutzerfreundlicher Name.
rawIcon	string (byte)	das Symbol eine 64-Bit-Zeichenfolge als Bytearray.
rawPng	string (byte)	das Symbol eine 64-Bit-Zeichenfolge als Bytearray.

MsixPackageDependencies

Objekt

Schema für MSIX Package Dependencies-Eigenschaften.

Name	Typ	Beschreibung
dependencyName	string	Name der Paketabhängigkeit.
minVersion	string	Abhängigkeitsversion erforderlich.
publisher	string	Name des Abhängigkeitsherausgebers.

packageTimestamped

Enumeration

Ist paketzeitstempelt, sodass es das Ablaufdatum des Zertifikats ignorieren kann

Wert	Beschreibung
NotTimestamped
Timestamped

ProvisioningState

Enumeration

Der aktuelle Bereitstellungsstatus.

Wert	Beschreibung
Canceled
Failed
Provisioning
Succeeded

systemData

Objekt

Metadaten zur Erstellung und letzten Änderung der Ressource.

Name	Typ	Beschreibung
createdAt	string (date-time)	Der Zeitstempel der Ressourcenerstellung (UTC).
createdBy	string	Die Identität, die die Ressource erstellt hat.
createdByType	createdByType	Der Identitätstyp, der die Ressource erstellt hat.
lastModifiedAt	string (date-time)	Der Zeitstempel der letzten Änderung der Ressource (UTC)
lastModifiedBy	string	Die Identität, die die Ressource zuletzt geändert hat.
lastModifiedByType	createdByType	Der Identitätstyp, der die Ressource zuletzt geändert hat.