AWaws-samples
Virtual Desktops

Update software stack

Changed on

Updates an existing software stack configuration for virtual desktop deployment (admin access required)

put/api/dcv/virtual_desktops/software_stacks

Request

  • The document declares no server URL.
  • Auth
    socaAuth (a scheme the document does not define) and socaToken (a scheme the document does not define)

Headers

X-EDH-USERstring required
Example:admin.user

SOCA username for authentication (must be admin)

X-EDH-TOKENstring required
Example:eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

SOCA authentication token

Request body multipart/form-data

software_stack_idstring required

ID of the software stack to update

ami_idstring required

Updated AMI ID for the software stack

base_osstring required

Updated base operating system

root_sizestring required

Updated root volume size in GB

virtual_desktop_profile_idstring required

Updated virtual desktop profile ID

launch_tenancy'default' | 'dedicated' | 'host'

Updated EC2 launch tenancy

launch_hoststring

Updated dedicated host ID (only for host tenancy)

descriptionstring

Updated description of the software stack (max 500 characters)

thumbnailstring binary

Updated thumbnail image for the software stack

hardware_profile_idstring

Hardware profile ID to bind to this software stack

Example request

{
  "software_stack_id": "1",
  "ami_id": "ami-0abcdef1234567890",
  "base_os": "ubuntu2004",
  "root_size": "50",
  "virtual_desktop_profile_id": "1",
  "launch_tenancy": "default",
  "launch_host": "h-1234567890abcdef0",
  "description": "Updated Ubuntu 20.04 with desktop environment and development tools"
}

Response

Software stack updated successfully

successboolean required
messagestring required

Example response

{
  "success": true,
  "message": "ami-0abcdef1234567890 updated successfully in SOCA"
}

Changes

  • v1058396b8f0f1Revision changes
    • info

      the endpoint scheme security socaAuth AND socaToken was added to the API

    • info

      the endpoint scheme security edhAuth AND edhToken was removed from the API

    • info

      added the new optional request property

  • v16db97cead8dfRevision changes
    • info

      the endpoint scheme security edhAuth AND edhToken was added to the API

    • info

      the endpoint scheme security socaAuth AND socaToken was removed from the API