Workspaces - Create Or Update

Service:: Azure Quantum

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

Crée ou met à jour une ressource Workspace

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Quantum/workspaces/{workspaceName}?api-version=2025-11-01-preview

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nom du groupe de ressources. Le nom ne respecte pas la casse.
subscriptionId	path	True	string (uuid)	ID de l’abonnement cible. La valeur doit être un UUID.
workspaceName	path	True	string pattern: ^[a-zA-Z0-9]+(-[a-zA-Z0-9])$	Nom de la ressource d’espace de travail quantique.
api-version	query	True	string minLength: 1	Version de l’API à utiliser pour cette opération.

Corps de la demande

Nom	Obligatoire	Type	Description
location	True	string	Emplacement géographique où réside la ressource
identity		ManagedServiceIdentity	Identités de service managées affectées à cette ressource.
properties		WorkspaceResourceProperties	Obtient ou définit les propriétés. Définissez les propriétés spécifiques de l’espace de travail quantique.
tags		object	Balises de ressource.

Réponses

Nom	Type	Description
200 OK	QuantumWorkspace	Réussite de l’opération de mise à jour de la ressource « QuantumWorkspace »
201 Created	QuantumWorkspace	Réussite de l’opération de création de la ressource 'QuantumWorkspace' En-têtes Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	Réponse d’erreur inattendue.

Nom

Type

Description

200 OK

QuantumWorkspace

Réussite de l’opération de mise à jour de la ressource « QuantumWorkspace »

201 Created

QuantumWorkspace

Réussite de l’opération de création de la ressource 'QuantumWorkspace'

En-têtes

Azure-AsyncOperation: string
Retry-After: integer

Other Status Codes

ErrorResponse

Réponse d’erreur inattendue.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory.

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

Étendues

Nom	Description
user_impersonation	emprunter l’identité de votre compte d’utilisateur

Exemples

Workspaces_CreateOrUpdate

Exemple de requête

HTTP

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/quantumResourcegroup/providers/Microsoft.Quantum/workspaces/quantumworkspace1?api-version=2025-11-01-preview

{
  "location": "West US",
  "properties": {
    "providers": [
      {
        "providerId": "Honeywell",
        "providerSku": "Basic"
      },
      {
        "providerId": "IonQ",
        "providerSku": "Basic"
      },
      {
        "providerId": "OneQBit",
        "providerSku": "Basic"
      }
    ],
    "storageAccount": "/subscriptions/1C4B2828-7D49-494F-933D-061373BE28C2/resourceGroups/quantumResourcegroup/providers/Microsoft.Storage/storageAccounts/testStorageAccount",
    "quotas": {
      "standardMinutesLifetime": 500,
      "highMinutesLifetime": 50
    }
  }
}

Exemple de réponse

Code d’état:: 200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/quantumResourcegroup/providers/Microsoft.Quantum/Workspaces/quantumworkspace1",
  "name": "quantumworkspace1",
  "type": "Microsoft.Quantum/Workspaces",
  "properties": {
    "providers": [
      {
        "providerId": "Honeywell",
        "providerSku": "Basic",
        "applicationName": "quantumworkspace1-h1",
        "instanceUri": "https://h1.endpoint.com",
        "provisioningState": "Succeeded",
        "resourceUsageId": "00000000-1111-2222-3333-444444444444"
      },
      {
        "providerId": "IonQ",
        "provisioningState": "Succeeded",
        "applicationName": "quantumworkspace1-i1",
        "instanceUri": "https://i1.endpoint.com",
        "providerSku": "Basic",
        "resourceUsageId": "00000000-1111-2222-3333-444444444445"
      },
      {
        "providerId": "OneQBit",
        "provisioningState": "Succeeded",
        "applicationName": "quantumworkspace1-o1",
        "instanceUri": "https://o1.endpoint.com",
        "providerSku": "Basic",
        "resourceUsageId": "00000000-1111-2222-3333-444444444446"
      }
    ],
    "provisioningState": "Succeeded",
    "usable": "Yes",
    "workspaceKind": "V1",
    "storageAccount": "/subscriptions/1C4B2828-7D49-494F-933D-061373BE28C2/resourceGroups/quantumResourcegroup/providers/Microsoft.Storage/storageAccounts/testStorageAccount",
    "endpointUri": "https://quantumworkspace1.westus.quantum.azure.com",
    "apiKeyEnabled": true,
    "quotas": {
      "standardMinutesLifetime": 500,
      "highMinutesLifetime": 50
    }
  },
  "location": "West US",
  "tags": {
    "department": "MightyMight",
    "company": "Contoso"
  },
  "identity": {
    "type": "SystemAssigned",
    "principalId": "00000000-1111-2222-3333-444444444444",
    "tenantId": "00000000-1111-2222-3333-444444444444"
  },
  "systemData": {
    "createdBy": "user1",
    "createdByType": "User",
    "createdAt": "2020-01-01T17:18:19.1234567Z",
    "lastModifiedBy": "user2",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-01-02T17:18:19.1234567Z"
  }
}

Code d’état:: 201

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/quantumResourcegroup/providers/Microsoft.Quantum/Workspaces/quantumworkspace1",
  "name": "quantumworkspace1",
  "properties": {
    "providers": [
      {
        "providerId": "Honeywell",
        "providerSku": "Basic",
        "applicationName": "quantumworkspace1-h1",
        "provisioningState": "Launching"
      },
      {
        "providerId": "IonQ",
        "provisioningState": "Launching",
        "applicationName": "quantumworkspace1-i1",
        "providerSku": "Basic"
      },
      {
        "providerId": "OneQBit",
        "provisioningState": "Launching",
        "applicationName": "quantumworkspace1-o1",
        "providerSku": "Basic"
      }
    ],
    "provisioningState": "ProviderLaunching",
    "usable": "No",
    "workspaceKind": "V1",
    "apiKeyEnabled": true,
    "quotas": {
      "standardMinutesLifetime": 500,
      "highMinutesLifetime": 50
    }
  },
  "location": "West US",
  "tags": {
    "department": "MightyMight",
    "company": "Contoso"
  },
  "identity": {
    "type": "SystemAssigned",
    "principalId": "00000000-1111-2222-3333-444444444444",
    "tenantId": "00000000-1111-2222-3333-444444444444"
  },
  "systemData": {
    "createdBy": "user1",
    "createdByType": "User",
    "createdAt": "2020-01-01T17:18:19.1234567Z",
    "lastModifiedBy": "user2",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-01-02T17:18:19.1234567Z"
  }
}

Définitions

Nom	Description
createdByType	Type d’identité qui a créé la ressource.
ErrorAdditionalInfo	Informations supplémentaires sur l’erreur de gestion des ressources.
ErrorDetail	Détail de l’erreur.
ErrorResponse	Réponse d’erreur
ManagedOnBehalfOfConfiguration	Managed-On-Behalf-Of propriétés de configuration. Cette configuration existe pour les ressources où un fournisseur de ressources gère ces ressources pour le compte du propriétaire de la ressource.
ManagedServiceIdentity	Identité de service managée (identités affectées par le système et/ou identités affectées par l’utilisateur)
ManagedServiceIdentityType	Type d’identité de service managé (où les types SystemAssigned et UserAssigned sont autorisés).
MoboBrokerResource	Managed-On-Behalf-Of ressource de courtier. Cette ressource est créée par le fournisseur de ressources pour gérer certaines ressources au nom de l’utilisateur.
Provider	Informations sur un Prestataire. Un fournisseur est une entité qui propose des cibles pour exécuter des travaux Azure Quantum.
ProviderStatus	Champ d’état d’approvisionnement
QuantumWorkspace	Objet de définition de proxy de ressource pour Quantum Workspace.
QuotaAllocations	Allocations de quotas, chaque champ représentant un type de quota différent.
systemData	Métadonnées relatives à la création et à la dernière modification de la ressource.
UsableStatus	Si l’espace de travail actuel est prêt à accepter les Jobs.
UserAssignedIdentity	Propriétés d’identité affectées par l’utilisateur
WorkspaceKind	Type d’espace de travail.
WorkspaceProvisioningStatus	L’état de provisionnement de l’espace de travail.
WorkspaceResourceProperties	Propriétés d’un espace de travail

createdByType

Énumération

Type d’identité qui a créé la ressource.

Valeur	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Object

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom	Type	Description
info	object	Informations supplémentaires.
type	string	Type d’informations supplémentaire.

ErrorDetail

Object

Détail de l’erreur.

Nom	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Informations supplémentaires sur l’erreur.
code	string	Code d'erreur.
details	ErrorDetail[]	Détails de l’erreur.
message	string	Message d’erreur.
target	string	Cible d’erreur.

ErrorResponse

Object

Réponse d’erreur

Nom	Type	Description
error	ErrorDetail	Objet d’erreur.

ManagedOnBehalfOfConfiguration

Object

Managed-On-Behalf-Of propriétés de configuration. Cette configuration existe pour les ressources où un fournisseur de ressources gère ces ressources pour le compte du propriétaire de la ressource.

Nom	Type	Description
moboBrokerResources	MoboBrokerResource[]	Ressources du courtier Managed-On-Behalf-Of

ManagedServiceIdentity

Object

Identité de service managée (identités affectées par le système et/ou identités affectées par l’utilisateur)

Nom	Type	Description
principalId	string (uuid)	ID principal de service de l’identité attribuée au système. Cette propriété ne sera fournie que pour une identité affectée par le système.
tenantId	string (uuid)	ID de locataire de l’identité attribuée par le système. Cette propriété ne sera fournie que pour une identité affectée par le système.
type	ManagedServiceIdentityType	Type d’identité de service managé (où les types SystemAssigned et UserAssigned sont autorisés).
userAssignedIdentities	<string, UserAssignedIdentity>	User-Assigned Identités Ensemble d’identités affectées par l’utilisateur associées à la ressource. Les clés de dictionnaire userAssignedIdentities seront des ID de ressource ARM sous la forme : « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Les valeurs de dictionnaire peuvent être des objets vides ({}) dans les requêtes.

ManagedServiceIdentityType

Énumération

Type d’identité de service managé (où les types SystemAssigned et UserAssigned sont autorisés).

Valeur	Description
None
SystemAssigned
UserAssigned
SystemAssigned,UserAssigned

MoboBrokerResource

Object

Managed-On-Behalf-Of ressource de courtier. Cette ressource est créée par le fournisseur de ressources pour gérer certaines ressources au nom de l’utilisateur.

Nom	Type	Description
id	string (arm-id)	Identificateur de ressource d’une ressource de broker Managed-On-Behalf-Of

Provider

Object

Informations sur un Prestataire. Un fournisseur est une entité qui propose des cibles pour exécuter des travaux Azure Quantum.

Nom	Type	Description
applicationName	string	Nom complet de l’application de la Place de marché du fournisseur.
instanceUri	string	Uri identifiant l’instance spécifique de ce fournisseur.
providerId	string	ID unique de ce fournisseur.
providerSku	string	Référence SKU associée aux informations de tarification de ce fournisseur.
provisioningState	ProviderStatus	Champ d’état d’approvisionnement
resourceUsageId	string	ID pour suivre l’utilisation des ressources pour le fournisseur.

ProviderStatus

Énumération

Champ d’état d’approvisionnement

Valeur	Description
Succeeded	Le fournisseur est correctement provisionné.
Launching	Le fournisseur commence le provisionnement.
Updating	Le fournisseur est en cours de mise à jour.
Deleting	Le fournisseur supprime.
Deleted	Le fournisseur est supprimé.
Failed	Le fournisseur n’a pas réussi.

QuantumWorkspace

Object

Objet de définition de proxy de ressource pour Quantum Workspace.

Nom	Type	Description
id	string (arm-id)	ID de ressource complet pour la ressource. Par exemple, « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} »
identity	ManagedServiceIdentity	Identités de service managées affectées à cette ressource.
location	string	Emplacement géographique où réside la ressource
name	string	Nom de la ressource
properties	WorkspaceResourceProperties	Obtient ou définit les propriétés. Définissez les propriétés spécifiques de l’espace de travail quantique.
systemData	systemData	Métadonnées Azure Resource Manager contenant les informations createdBy et modifiedBy.
tags	object	Balises de ressource.
type	string	Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

QuotaAllocations

Object

Allocations de quotas, chaque champ représentant un type de quota différent.

Nom	Type	Description
highMinutesLifetime	integer (int32) minimum: 0	Limite de durée de vie pour l’exécution des tâches prioritaires en quelques minutes.
standardMinutesLifetime	integer (int32) minimum: 0	Limite de durée de vie pour l’exécution des tâches prioritaires standard en minutes.

systemData

Object

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom	Type	Description
createdAt	string (date-time)	Horodatage de la création de ressources (UTC).
createdBy	string	Identité qui a créé la ressource.
createdByType	createdByType	Type d’identité qui a créé la ressource.
lastModifiedAt	string (date-time)	Horodatage de la dernière modification de ressource (UTC)
lastModifiedBy	string	Identité qui a modifié la ressource pour la dernière fois.
lastModifiedByType	createdByType	Type d’identité qui a modifié la ressource pour la dernière fois.

UsableStatus

Énumération

Si l’espace de travail actuel est prêt à accepter les Jobs.

Valeur	Description
Yes	L’espace de travail est utilisable et peut accepter des tâches.
No	L’espace de travail n’est pas utilisable et ne peut pas accepter de tâches.
Partial	L’espace de travail est partiellement utilisable.

UserAssignedIdentity

Object

Propriétés d’identité affectées par l’utilisateur

Nom	Type	Description
clientId	string (uuid)	ID client de l’identité affectée.
principalId	string (uuid)	ID principal de l’identité affectée.

WorkspaceKind

Énumération

Type d’espace de travail.

Valeur	Description
V1	L’espace de travail est un espace de travail à usage général.
V2	L’espace de travail est un espace de travail V2.

WorkspaceProvisioningStatus

Énumération

L’état de provisionnement de l’espace de travail.

Valeur	Description
Succeeded	Le provisionnement de l’espace de travail est réussi.
Failed	Le provisionnement de l’espace de travail a échoué.
Canceled	La création de ressources a été annulée.
ProviderLaunching	L’espace de travail commence actuellement à provisionner un fournisseur.
ProviderUpdating	L’espace de travail est actuellement en train de mettre à jour un fournisseur.
ProviderDeleting	L’espace de travail est actuellement en train de supprimer un fournisseur.
ProviderProvisioning	L’espace de travail provisionne actuellement un fournisseur.

WorkspaceResourceProperties

Object

Propriétés d’un espace de travail

Nom	Type	Description
apiKeyEnabled	boolean	Indicateur d’activation des clés API de l’espace de travail Quantum.
endpointUri	string	URI du point de terminaison de l’espace de travail.
managedOnBehalfOfConfiguration	ManagedOnBehalfOfConfiguration	Géré pour le compte de la configuration.
managedStorageAccount	string (arm-id)	ID de ressource ARM du compte de stockage géré associé à cet espace de travail.
providers	Provider[]	Liste des fournisseurs sélectionnés pour cet espace de travail
provisioningState	WorkspaceProvisioningStatus	Champ d’état d’approvisionnement
quotas	QuotaAllocations	Allocations de quotas associées à cet espace de travail. Disponible uniquement pour les fournisseurs spéciaux.
storageAccount	string (arm-id)	ID de ressource ARM du compte de stockage associé à cet espace de travail.
usable	UsableStatus	Si l’espace de travail actuel est prêt à accepter les Jobs.
workspaceKind	WorkspaceKind	Que cet espace de travail soit V1 ou V2.

Partager via

Workspaces - Create Or Update

Paramètres URI

Corps de la demande

Réponses

Sécurité

azure_auth

Étendues

Exemples

Workspaces_CreateOrUpdate

Exemple de requête

Exemple de réponse

Définitions

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ManagedOnBehalfOfConfiguration

ManagedServiceIdentity

ManagedServiceIdentityType

MoboBrokerResource

Provider

ProviderStatus

QuantumWorkspace

QuotaAllocations

systemData

UsableStatus

UserAssignedIdentity

WorkspaceKind

WorkspaceProvisioningStatus

WorkspaceResourceProperties