Dev Boxes - Set Active Hours

Référence

Service:: Dev Center

Version d'API:: 2025-04-01-preview

Permet à un utilisateur de définir ses propres heures d’activité pour sa zone de développement, en remplaçant les valeurs par défaut définies au niveau du pool.

POST {endpoint}/projects/{projectName}/users/{userId}/devboxes/{devBoxName}:setActiveHours?api-version=2025-04-01-preview

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
devBoxName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$	Nom complet de la zone de développement.
endpoint	path	True	string (uri)	URI spécifique à DevCenter sur lequel opérer.
projectName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$	Nom du projet.
userId	path	True	string minLength: 2 maxLength: 36 pattern: ^[a-zA-Z0-9]{8}-([a-zA-Z0-9]{4}-){3}[a-zA-Z0-9]{12}$\|^me$	ID d’objet AAD de l’utilisateur. Si la valeur est « moi », l’identité est extraite du contexte d’authentification.
api-version	query	True	string minLength: 1	Version de l’API à utiliser pour cette opération.

Corps de la demande

Nom	Type	Description
endTimeHour	integer (int32)	Heure de fin des heures d’activité.
startTimeHour	integer (int32)	Heure de début des heures actives.
timeZone	string	Fuseau horaire des heures actives.

Réponses

Nom	Type	Description
200 OK	DevBox	La demande a réussi.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Réponse d’erreur inattendue. En-têtes x-ms-error-code: string

Nom

Type

Description

200 OK

DevBox

La demande a réussi.

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Réponse d’erreur inattendue.

En-têtes

x-ms-error-code: string

Sécurité

OAuth2Auth

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
https://devcenter.azure.com/.default

Exemples

Lets a user set their own active hours for their Dev Box, overriding the defaults set at the pool level.

Exemple de requête

HTTP

POST https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/projects/myProject/users/me/devboxes/myDevBox:setActiveHours?api-version=2025-04-01-preview

{
  "timeZone": "America/Los_Angeles",
  "startTimeHour": 9,
  "endTimeHour": 17
}

Exemple de réponse

Code d’état:: 200

{
  "uri": "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/projects/myProject/users/b08e39b4-2ac6-4465-a35e-48322efb0f98/devboxes/MyDevBox",
  "name": "MyDevBox",
  "provisioningState": "Succeeded",
  "projectName": "ContosoProject",
  "poolName": "LargeDevWorkStationPool",
  "location": "centralus",
  "osType": "Windows",
  "user": "b08e39b4-2ac6-4465-a35e-48322efb0f98",
  "lastConnectedTime": "2022-04-01T00:13:23.323Z",
  "hardwareProfile": {
    "vCPUs": 8,
    "memoryGB": 32
  },
  "storageProfile": {
    "osDisk": {
      "diskSizeGB": 1024
    }
  },
  "hibernateSupport": "Enabled",
  "imageReference": {
    "name": "DevImage",
    "version": "1.0.0",
    "publishedDate": "2022-03-01T00:13:23.323Z"
  },
  "activeHoursConfiguration": {
    "keepAwakeEnableStatus": "Enabled",
    "autoStartEnableStatus": "Enabled",
    "timeZone": "America/Los_Angeles",
    "startTimeHour": 9,
    "endTimeHour": 17
  }
}

Définitions

Nom	Description
ActiveHoursConfiguration	Configuration des heures d’activité pour une zone de développement.
AutoStartEnableStatus	Active ou désactive si la zone de développement doit être démarrée automatiquement au début des heures d’activité.
Azure.Core.Foundations.Error	Objet d’erreur.
Azure.Core.Foundations.ErrorResponse	Réponse contenant les détails de l’erreur.
Azure.Core.Foundations.InnerError	Objet contenant des informations plus spécifiques sur l’erreur. Conformément aux instructions de l’API Microsoft One - https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.
DevBox	Une zone de développement.
DevBoxProvisioningState	Indique l’état d’approvisionnement de la zone de développement.
HardwareProfile	Spécifications matérielles pour la zone de développement.
HibernateSupport	Indique si la mise en veille prolongée est prise en charge et activée, désactivée ou non prise en charge par le système d’exploitation. La prise en charge de la mise en veille prolongée inconnue est représentée sous la forme null.
ImageReference	Spécifie des informations sur l’image utilisée.
KeepAwakeEnableStatus	Active ou désactive si la boîte de développement doit être conservée éveillée pendant les heures d’activité.
LocalAdminStatus	Indique si les propriétaires de Dev Boxes dans un pool sont des administrateurs locaux sur les zones de développement.
OsDisk	Paramètres du disque du système d’exploitation.
OsType	Type de système d’exploitation.
PowerState	États d’alimentation d’une zone de développement.
SkuName	Indique le calcul de la zone de développement.
StorageProfile	Paramètres de stockage pour les disques de Dev Box.
UserActiveHoursConfiguration	Configuration manuelle des heures d’activité définies par l’utilisateur.

ActiveHoursConfiguration

Object

Configuration des heures d’activité pour une zone de développement.

Nom	Type	Description
autoStartEnableStatus	AutoStartEnableStatus	Active ou désactive si la zone de développement doit être démarrée automatiquement au début des heures d’activité.
endTimeHour	integer (int32)	Heure de fin des heures d’activité.
keepAwakeEnableStatus	KeepAwakeEnableStatus	Active ou désactive si la boîte de développement doit être conservée éveillée pendant les heures d’activité.
startTimeHour	integer (int32)	Heure de début des heures actives.
timeZone	string	Fuseau horaire des heures actives.

AutoStartEnableStatus

Énumération

Active ou désactive si la zone de développement doit être démarrée automatiquement au début des heures d’activité.

Valeur	Description
Disabled	Le démarrage automatique est désactivé.
Enabled	Le démarrage automatique est activé.

Azure.Core.Foundations.Error

Object

Objet d’erreur.

Nom	Type	Description
code	string	Un ensemble de codes d’erreur définis par le serveur.
details	Azure.Core.Foundations.Error[]	Tableau de détails sur des erreurs spécifiques qui ont conduit à cette erreur signalée.
innererror	Azure.Core.Foundations.InnerError	Objet contenant des informations plus spécifiques que l’objet actuel sur l’erreur.
message	string	Représentation lisible par l’homme de l’erreur.
target	string	Cible de l’erreur.

Azure.Core.Foundations.ErrorResponse

Object

Réponse contenant les détails de l’erreur.

Nom	Type	Description
error	Azure.Core.Foundations.Error	Objet d’erreur.

Azure.Core.Foundations.InnerError

Object

Objet contenant des informations plus spécifiques sur l’erreur. Conformément aux instructions de l’API Microsoft One - https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.

Nom	Type	Description
code	string	Un ensemble de codes d’erreur définis par le serveur.
innererror	Azure.Core.Foundations.InnerError	Erreur interne.

DevBox

Object

Une zone de développement.

Nom	Type	Description
actionState	string	État actuel de l’action de la zone de développement. Cet état est basé sur l’action précédente effectuée par l’utilisateur.
activeHoursConfiguration	ActiveHoursConfiguration	Configuration des heures d’activité pour cette zone de développement, si elle est activée.
createdTime	string (date-time)	Heure de création de cette zone de développement, au format RFC3339.
error	Azure.Core.Foundations.Error	Détails de l’erreur d’approvisionnement ou d’action. Renseigné uniquement pour les états d’erreur.
hardwareProfile	HardwareProfile	Informations sur les ressources matérielles de Dev Box.
hibernateSupport	HibernateSupport	Indique si la mise en veille prolongée est activée/désactivée ou inconnue.
imageReference	ImageReference	Informations sur l’image utilisée pour cette zone de développement.
lastConnectedTime	string (date-time)	Dernière fois qu’un utilisateur est connecté à cette Dev Box, au format RFC3339.
localAdministrator	LocalAdminStatus	Indique si le propriétaire de la zone de développement est un administrateur local.
location	string	Région Azure où se trouve cette zone de développement. Il s’agit de la même région que le réseau virtuel auquel il est attaché.
name	string minLength: 3 maxLength: 63 pattern: ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$	Nom complet de la zone de développement.
osType	OsType	Type de système d’exploitation de cette Zone de développement.
poolName	string minLength: 3 maxLength: 63 pattern: ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$	Nom du pool Dev Box auquel appartient cet ordinateur.
powerState	PowerState	État actuel de l’alimentation du Dev Box.
projectName	string	Nom du projet auquel appartient cette zone de développement.
provisioningState	DevBoxProvisioningState	État d’approvisionnement actuel de la zone de développement.
storageProfile	StorageProfile	Paramètres de stockage pour cette zone de développement.
uniqueId	string (uuid)	Identificateur unique pour la zone de développement. Il s’agit d’une chaîne au format GUID (par exemple, 000000000-0000-0000-0000-00000000000000000000000).
uri	string (uri)	URI unique de la zone de développement.
user	string (uuid)	L’ID d’objet AAD de l’utilisateur auquel cette zone de développement est affectée.

DevBoxProvisioningState

Énumération

Indique l’état d’approvisionnement de la zone de développement.

Valeur	Description
Canceled	L’approvisionnement dev Box a été annulé.
Creating	Dev Box est en cours de création.
Deleting	Dev Box est en cours de suppression.
Failed	La zone de développement n’a pas pu être configurée.
InGracePeriod	Dev Box est en période de grâce.
NotProvisioned	La zone de développement n’est pas provisionnée.
PendingApproval	Dev Box est en attente d’approbation.
ProvisionedWithWarning	Dev Box a été provisionné avec avertissement.
Provisioning	Dev Box provisionne.
Starting	Dev Box démarre.
Stopping	Dev Box s’arrête.
Succeeded	Dev Box a été correctement approvisionné.
Updating	Dev Box est mis à jour.

HardwareProfile

Object

Spécifications matérielles pour la zone de développement.

Nom	Type	Description
memoryGB	integer (int32)	Quantité de mémoire disponible pour la zone de développement.
skuName	SkuName	Nom de la référence SKU.
vCPUs	integer (int32)	Nombre de processeurs virtuels disponibles pour la zone de développement.

HibernateSupport

Énumération

Indique si la mise en veille prolongée est prise en charge et activée, désactivée ou non prise en charge par le système d’exploitation. La prise en charge de la mise en veille prolongée inconnue est représentée sous la forme null.

Valeur	Description
Disabled	La mise en veille prolongée n’est pas activée.
Enabled	Hibernate est activé.
OsUnsupported	La mise en veille prolongée n’est pas prise en charge par le système d’exploitation.

ImageReference

Object

Spécifie des informations sur l’image utilisée.

Nom	Type	Description
name	string	Nom de l’image utilisée.
operatingSystem	string	Système d’exploitation de l’image.
osBuildNumber	string	Numéro de build du système d’exploitation de l’image.
publishedDate	string (date-time)	Datetime de publication de la version de l’image de stockage au format RFC3339.
version	string	Version de l’image.

KeepAwakeEnableStatus

Énumération

Active ou désactive si la boîte de développement doit être conservée éveillée pendant les heures d’activité.

Valeur	Description
Disabled	Garder éveillé est désactivé.
Enabled	Garder éveillé est activé.

LocalAdminStatus

Énumération

Indique si les propriétaires de Dev Boxes dans un pool sont des administrateurs locaux sur les zones de développement.

Valeur	Description
Disabled	Les propriétaires de Dev Boxes dans le pool ne sont pas des administrateurs locaux dans les zones de développement.
Enabled	Les propriétaires de Dev Boxes dans le pool sont des administrateurs locaux sur les zones de développement.

OsDisk

Object

Paramètres du disque du système d’exploitation.

Nom	Type	Description
diskSizeGB	integer (int32)	Taille du disque du système d’exploitation en gigaoctets.

OsType

Énumération

Type de système d’exploitation.

Valeur	Description
Windows	Système d’exploitation Windows.

PowerState

Énumération

États d’alimentation d’une zone de développement.

Valeur	Description
Deallocated	La zone de développement est libérée.
Hibernated	Le Dev Box est hibernated.
PoweredOff	Le Dev Box est hors tension.
Running	La boîte de développement est en cours d’exécution.
Unknown	L’état d’alimentation de Dev Box n’est pas connu.

SkuName

Énumération

Indique le calcul de la zone de développement.

Valeur	Description
general_a_16c64gb1024ssd_v2	AMD, 16 processeurs virtuels, 64 Go de RAM, 1024 Go de stockage.
general_a_16c64gb2048ssd_v2	AMD, 16 processeurs virtuels, 64 Go de RAM, 2048 Go de stockage.
general_a_16c64gb256ssd_v2	AMD, 16 processeurs virtuels, 64 Go de RAM, 256 Go de stockage.
general_a_16c64gb512ssd_v2	AMD, 16 processeurs virtuels, 64 Go de RAM, 512 Go de stockage.
general_a_32c128gb1024ssd_v2	AMD, 32 processeurs virtuels, 128 Go de RAM, 1024 Go de stockage.
general_a_32c128gb2048ssd_v2	AMD, 32 processeurs virtuels, 128 Go de RAM, 2048 Go de stockage.
general_a_32c128gb512ssd_v2	AMD, 32 processeurs virtuels, 128 Go de RAM, 512 Go de stockage.
general_a_8c32gb1024ssd_v2	AMD, 8 processeurs virtuels, 32 Go de RAM, 1024 Go de stockage.
general_a_8c32gb2048ssd_v2	AMD, 8 processeurs virtuels, 32 Go de RAM, 2048 Go de stockage.
general_a_8c32gb256ssd_v2	AMD, 8 processeurs virtuels, 32 Go de RAM, 256 Go de stockage.
general_a_8c32gb512ssd_v2	AMD, 8 processeurs virtuels, 32 Go de RAM, 512 Go de stockage.
general_i_16c64gb1024ssd_v2	Intel, 16 processeurs virtuels, 64 Go de RAM, 1024 Go de stockage.
general_i_16c64gb2048ssd_v2	Intel, 16 processeurs virtuels, 64 Go de RAM, 2048 Go de stockage.
general_i_16c64gb256ssd_v2	Intel, 16 processeurs virtuels, 64 Go de RAM, 256 Go de stockage.
general_i_16c64gb512ssd_v2	Intel, 16 processeurs virtuels, 64 Go de RAM, 512 Go de stockage.
general_i_32c128gb1024ssd_v2	Intel, 32 processeurs virtuels, 128 Go de RAM, 1024 Go de stockage.
general_i_32c128gb2048ssd_v2	Intel, 32 processeurs virtuels, 128 Go de RAM, 2048 Go de stockage.
general_i_32c128gb512ssd_v2	Intel, 32 processeurs virtuels, 128 Go de RAM, 512 Go de stockage.
general_i_8c32gb1024ssd_v2	Intel, 8 processeurs virtuels, 32 Go de RAM, 1024 Go de stockage.
general_i_8c32gb2048ssd_v2	Intel, 8 processeurs virtuels, 32 Go de RAM, 2048 Go de stockage.
general_i_8c32gb256ssd_v2	Intel, 8 processeurs virtuels, 32 Go de RAM, 256 Go de stockage.
general_i_8c32gb512ssd_v2	Intel, 8 processeurs virtuels, 32 Go de RAM, 512 Go de stockage.

StorageProfile

Object

Paramètres de stockage pour les disques de Dev Box.

Nom	Type	Description
osDisk	OsDisk	Paramètres du disque du système d’exploitation.

UserActiveHoursConfiguration

Object

Configuration manuelle des heures d’activité définies par l’utilisateur.

Nom	Type	Description
endTimeHour	integer (int32)	Heure de fin des heures d’activité.
startTimeHour	integer (int32)	Heure de début des heures actives.
timeZone	string	Fuseau horaire des heures actives.

Partager via

Dev Boxes - Set Active Hours

Paramètres URI

Corps de la demande

Réponses

Sécurité

OAuth2Auth

Étendues

Exemples

Lets a user set their own active hours for their Dev Box, overriding the defaults set at the pool level.

Exemple de requête

Exemple de réponse

Définitions

ActiveHoursConfiguration

AutoStartEnableStatus

Azure.Core.Foundations.Error

Azure.Core.Foundations.ErrorResponse

Azure.Core.Foundations.InnerError

DevBox

DevBoxProvisioningState

HardwareProfile

HibernateSupport

ImageReference

KeepAwakeEnableStatus

LocalAdminStatus

OsDisk

OsType

PowerState

SkuName

StorageProfile

UserActiveHoursConfiguration