Workspaces - Create Or Update

Riferimento

Servizio:: Azure Quantum

Versione API:: 2025-01-01-preview

Crea o aggiorna una risorsa dell'area di lavoro.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole.
subscriptionId	path	True	string (uuid)	ID della sottoscrizione di destinazione. Il valore deve essere un UUID.
workspaceName	path	True	string pattern: ^[a-zA-Z0-9]+(-[a-zA-Z0-9])$	Nome della risorsa dell'area di lavoro quantistica.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
location	True	string	Posizione geografica in cui risiede la risorsa
identity		ManagedServiceIdentity	Identità del servizio gestito assegnate a questa risorsa.
properties		WorkspaceResourceProperties	Ottiene o imposta le proprietà. Definire le proprietà specifiche dell'area di lavoro quantistica.
tags		object	Tag di risorsa.

Risposte

Nome	Tipo	Descrizione
200 OK	QuantumWorkspace	Operazione di aggiornamento della risorsa 'QuantumWorkspace' riuscita
201 Created	QuantumWorkspace	Operazione di creazione della risorsa 'QuantumWorkspace' riuscita Intestazioni Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	Risposta di errore imprevista.

Nome

Tipo

Descrizione

200 OK

QuantumWorkspace

Operazione di aggiornamento della risorsa 'QuantumWorkspace' riuscita

201 Created

QuantumWorkspace

Operazione di creazione della risorsa 'QuantumWorkspace' riuscita

Intestazioni

Azure-AsyncOperation: string
Retry-After: integer

Other Status Codes

ErrorResponse

Risposta di errore imprevista.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

Workspaces_CreateOrUpdate

Esempio di richiesta

HTTP

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/quantumResourcegroup/providers/Microsoft.Quantum/workspaces/quantumworkspace1?api-version=2025-01-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"
  }
}

Risposta di esempio

Codice di stato:: 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",
    "storageAccount": "/subscriptions/1C4B2828-7D49-494F-933D-061373BE28C2/resourceGroups/quantumResourcegroup/providers/Microsoft.Storage/storageAccounts/testStorageAccount",
    "endpointUri": "https://quantumworkspace1.westus.quantum.azure.com",
    "apiKeyEnabled": true
  },
  "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"
  }
}

Codice di stato:: 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",
    "apiKeyEnabled": true
  },
  "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"
  }
}

Definizioni

Nome	Descrizione
createdByType	Tipo di identità che ha creato la risorsa.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
ManagedOnBehalfOfConfiguration	Proprietà di configurazioneBehalf-Of Managed-On. Questa configurazione esiste per le risorse in cui un provider di risorse gestisce tali risorse per conto del proprietario della risorsa.
ManagedServiceIdentity	Identità del servizio gestita (identità assegnate dal sistema e/o assegnate dall'utente)
ManagedServiceIdentityType	Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned).
MoboBrokerResource	Risorsa broker gestita suBehalf-Of. Questa risorsa viene creata dal provider di risorse per gestire alcune risorse per conto dell'utente.
Provider	Informazioni su un provider. Un provider è un'entità che offre Destinazioni per l'esecuzione di processi di Azure Quantum.
ProviderStatus	Campo Stato provisioning
QuantumWorkspace	Oggetto definizione proxy risorsa per l'area di lavoro quantistica.
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.
UsableStatus	Indica se l'area di lavoro corrente è pronta per accettare processi.
UserAssignedIdentity	Proprietà di identità assegnate dall'utente
WorkspaceProvisioningStatus	Stato del provisioning dell'area di lavoro.
WorkspaceResourceProperties	Proprietà di un'area di lavoro

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore	Descrizione
Application
Key
ManagedIdentity
User

ErrorAdditionalInfo

Object

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Object

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Object

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

ManagedOnBehalfOfConfiguration

Object

Proprietà di configurazioneBehalf-Of Managed-On. Questa configurazione esiste per le risorse in cui un provider di risorse gestisce tali risorse per conto del proprietario della risorsa.

Nome	Tipo	Descrizione
moboBrokerResources	MoboBrokerResource[]	Risorse del broker Managed-On-Behalf-Of

ManagedServiceIdentity

Object

Identità del servizio gestita (identità assegnate dal sistema e/o assegnate dall'utente)

Nome	Tipo	Descrizione
principalId	string (uuid)	ID entità servizio dell'identità assegnata dal sistema. Questa proprietà verrà fornita solo per un'identità assegnata dal sistema.
tenantId	string (uuid)	ID tenant dell'identità assegnata dal sistema. Questa proprietà verrà fornita solo per un'identità assegnata dal sistema.
type	ManagedServiceIdentityType	Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned).
userAssignedIdentities	<string, UserAssignedIdentity>	identità User-Assigned Set di identità assegnate dall'utente associate alla risorsa. Le chiavi del dizionario userAssignedIdentities saranno ID risorsa ARM nel formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. I valori del dizionario possono essere oggetti vuoti ({}) nelle richieste.

ManagedServiceIdentityType

Enumerazione

Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned).

Valore	Descrizione
None
SystemAssigned
SystemAssigned,UserAssigned
UserAssigned

MoboBrokerResource

Object

Risorsa broker gestita suBehalf-Of. Questa risorsa viene creata dal provider di risorse per gestire alcune risorse per conto dell'utente.

Nome	Tipo	Descrizione
id	string (arm-id)	Identificatore di risorsa di una risorsa broker gestita inBehalf-Of

Provider

Object

Informazioni su un provider. Un provider è un'entità che offre Destinazioni per l'esecuzione di processi di Azure Quantum.

Nome	Tipo	Descrizione
applicationName	string	Nome visualizzato dell'applicazione marketplace del provider.
instanceUri	string	Uri che identifica l'istanza specifica di questo provider.
providerId	string	ID univoco di questo provider.
providerSku	string	Sku associato alle informazioni sui prezzi per questo provider.
provisioningState	ProviderStatus	Campo Stato provisioning
resourceUsageId	string	ID per tenere traccia dell'utilizzo delle risorse per il provider.

ProviderStatus

Enumerazione

Campo Stato provisioning

Valore	Descrizione
Deleted	Il provider viene eliminato.
Deleting	Il provider sta eliminando.
Failed	Il provider non è riuscito.
Launching	Il provider sta avviando il provisioning.
Succeeded	Provisioning del provider completato.
Updating	Il provider sta aggiornando.

QuantumWorkspace

Object

Oggetto definizione proxy risorsa per l'area di lavoro quantistica.

Nome	Tipo	Descrizione
id	string (arm-id)	ID risorsa completo per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
identity	ManagedServiceIdentity	Identità del servizio gestito assegnate a questa risorsa.
location	string	Posizione geografica in cui risiede la risorsa
name	string	Nome della risorsa
properties	WorkspaceResourceProperties	Ottiene o imposta le proprietà. Definire le proprietà specifiche dell'area di lavoro quantistica.
systemData	systemData	Metadati di Azure Resource Manager contenenti le informazioni createdBy e modifiedBy.
tags	object	Tag di risorsa.
type	string	Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

systemData

Object

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome	Tipo	Descrizione
createdAt	string (date-time)	Timestamp della creazione della risorsa (UTC).
createdBy	string	Identità che ha creato la risorsa.
createdByType	createdByType	Tipo di identità che ha creato la risorsa.
lastModifiedAt	string (date-time)	Timestamp dell'ultima modifica della risorsa (UTC)
lastModifiedBy	string	Identità che ha modificato l'ultima volta la risorsa.
lastModifiedByType	createdByType	Tipo di identità che ha modificato l'ultima volta la risorsa.

UsableStatus

Enumerazione

Indica se l'area di lavoro corrente è pronta per accettare processi.

Valore	Descrizione
No	L'area di lavoro non è utilizzabile e non può accettare processi.
Partial	L'area di lavoro è parzialmente utilizzabile.
Yes	L'area di lavoro è utilizzabile e può accettare processi.

UserAssignedIdentity

Object

Proprietà di identità assegnate dall'utente

Nome	Tipo	Descrizione
clientId	string (uuid)	ID client dell'identità assegnata.
principalId	string (uuid)	ID entità dell'identità assegnata.

WorkspaceProvisioningStatus

Enumerazione

Stato del provisioning dell'area di lavoro.

Valore	Descrizione
Canceled	La creazione della risorsa è stata annullata.
Failed	Provisioning dell'area di lavoro non riuscita.
ProviderDeleting	L'area di lavoro sta attualmente eliminando un provider.
ProviderLaunching	L'area di lavoro sta attualmente avviando il provisioning di un provider.
ProviderProvisioning	L'area di lavoro sta attualmente eseguendo il provisioning di un provider.
ProviderUpdating	L'area di lavoro sta attualmente aggiornando un provider.
Succeeded	Il provisioning dell'area di lavoro è riuscito.

WorkspaceResourceProperties

Object

Proprietà di un'area di lavoro

Nome	Tipo	Descrizione
apiKeyEnabled	boolean	Indicatore dell'abilitazione delle chiavi API dell'area di lavoro Quantum.
endpointUri	string	URI dell'endpoint dell'area di lavoro.
managedOnBehalfOfConfiguration	ManagedOnBehalfOfConfiguration	Gestito per conto della configurazione.
managedStorageAccount	string (arm-id)	ID risorsa ARM dell'account di archiviazione gestito associato a questa area di lavoro.
providers	Provider[]	Elenco di provider selezionati per questa area di lavoro
provisioningState	WorkspaceProvisioningStatus	Campo Stato provisioning
storageAccount	string (arm-id)	ID risorsa ARM dell'account di archiviazione associato a questa area di lavoro.
usable	UsableStatus	Indica se l'area di lavoro corrente è pronta per accettare processi.

Condividi tramite

Workspaces - Create Or Update

Parametri dell'URI

Corpo della richiesta

Risposte

Sicurezza

azure_auth

Ambiti

Esempio

Workspaces_CreateOrUpdate

Esempio di richiesta

Risposta di esempio

Definizioni

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ManagedOnBehalfOfConfiguration

ManagedServiceIdentity

ManagedServiceIdentityType

MoboBrokerResource

Provider

ProviderStatus

QuantumWorkspace

systemData

UsableStatus

UserAssignedIdentity

WorkspaceProvisioningStatus

WorkspaceResourceProperties