Megosztás a következőn keresztül:


Workspaces - Create Or Update

Munkaterület-erőforrást hoz létre vagy frissít.

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

URI-paraméterek

Name In Kötelező Típus Description
resourceGroupName
path True

string

minLength: 1
maxLength: 90

Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket.

subscriptionId
path True

string (uuid)

A cél-előfizetés azonosítója. Az értéknek UUID-nek kell lennie.

workspaceName
path True

string

pattern: ^[a-zA-Z0-9]+(-*[a-zA-Z0-9])*$

A kvantum-munkaterület erőforrásának neve.

api-version
query True

string

minLength: 1

A művelethez használandó API-verzió.

Kérelem törzse

Name Kötelező Típus Description
location True

string

Az a földrajzi hely, ahol az erőforrás él

identity

ManagedServiceIdentity

Az erőforráshoz rendelt felügyeltszolgáltatás-identitások.

properties

WorkspaceResourceProperties

Lekéri vagy beállítja a tulajdonságokat. A kvantum-munkaterület konkrét tulajdonságainak meghatározása.

tags

object

Erőforráscímkék.

Válaszok

Name Típus Description
200 OK

QuantumWorkspace

A QuantumWorkspace erőforrás frissítési művelete sikeres volt

201 Created

QuantumWorkspace

A QuantumWorkspace erőforrás létrehozási művelete sikeres volt

Fejlécek

  • Azure-AsyncOperation: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

Váratlan hibaválasz.

Biztonság

azure_auth

Azure Active Directory OAuth2-folyamat.

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name Description
user_impersonation a felhasználói fiók megszemélyesítése

Példák

Workspaces_CreateOrUpdate

Mintakérelem

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

Mintaválasz

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

Definíciók

Name Description
createdByType

Az erőforrást létrehozó identitás típusa.

ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.

ErrorDetail

A hiba részletei.

ErrorResponse

Hibaválasz

ManagedOnBehalfOfConfiguration

Managed-On-Behalf-Of konfigurációs tulajdonságok. Ez a konfiguráció azokhoz az erőforrásokhoz létezik, amelyeknél az erőforrás-szolgáltató kezeli ezeket az erőforrásokat az erőforrás tulajdonosának nevében.

ManagedServiceIdentity

Felügyeltszolgáltatás-identitás (rendszer által hozzárendelt és/vagy felhasználó által hozzárendelt identitások)

ManagedServiceIdentityType

A felügyelt szolgáltatás identitásának típusa (ahol a SystemAssigned és a UserAssigned típus is engedélyezett).

MoboBrokerResource

Managed-On-Behalf-Of közvetítői erőforrás. Ezt az erőforrást az erőforrás-szolgáltató hozza létre bizonyos erőforrások kezeléséhez a felhasználó nevében.

Provider

Információ egy szolgáltatóról. A szolgáltató olyan entitás, amely célokat kínál az Azure Quantum Jobs futtatásához.

ProviderStatus

Kiépítési állapotmező

QuantumWorkspace

A Quantum Workspace erőforrásproxy-definíciós objektuma.

systemData

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

UsableStatus

Azt jelzi, hogy az aktuális munkaterület készen áll-e a feladatok elfogadására.

UserAssignedIdentity

Felhasználó által hozzárendelt identitástulajdonságok

WorkspaceProvisioningStatus

A munkaterület kiépítési állapota.

WorkspaceResourceProperties

Munkaterület tulajdonságai

createdByType

Az erőforrást létrehozó identitás típusa.

Érték Description
Application
Key
ManagedIdentity
User

ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.

Name Típus Description
info

object

A további információk.

type

string

A további információtípus.

ErrorDetail

A hiba részletei.

Name Típus Description
additionalInfo

ErrorAdditionalInfo[]

A hiba további információi.

code

string

A hibakód.

details

ErrorDetail[]

A hiba részletei.

message

string

A hibaüzenet.

target

string

A hibacél.

ErrorResponse

Hibaválasz

Name Típus Description
error

ErrorDetail

A hibaobjektum.

ManagedOnBehalfOfConfiguration

Managed-On-Behalf-Of konfigurációs tulajdonságok. Ez a konfiguráció azokhoz az erőforrásokhoz létezik, amelyeknél az erőforrás-szolgáltató kezeli ezeket az erőforrásokat az erőforrás tulajdonosának nevében.

Name Típus Description
moboBrokerResources

MoboBrokerResource[]

MenedzseltBehalf-Of közvetítői erőforrások

ManagedServiceIdentity

Felügyeltszolgáltatás-identitás (rendszer által hozzárendelt és/vagy felhasználó által hozzárendelt identitások)

Name Típus Description
principalId

string (uuid)

A rendszer által hozzárendelt identitás szolgáltatásnév-azonosítója. Ez a tulajdonság csak a rendszer által hozzárendelt identitáshoz lesz megadva.

tenantId

string (uuid)

A rendszer által hozzárendelt identitás bérlőazonosítója. Ez a tulajdonság csak a rendszer által hozzárendelt identitáshoz lesz megadva.

type

ManagedServiceIdentityType

A felügyelt szolgáltatás identitásának típusa (ahol a SystemAssigned és a UserAssigned típus is engedélyezett).

userAssignedIdentities

<string,  UserAssignedIdentity>

User-Assigned identitások
Az erőforráshoz társított felhasználó által hozzárendelt identitások készlete. A userAssignedIdentities szótárkulcsok arm-erőforrásazonosítók lesznek a következő formában: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. A szótár értékei lehetnek üres objektumok ({}) a kérelmekben.

ManagedServiceIdentityType

A felügyelt szolgáltatás identitásának típusa (ahol a SystemAssigned és a UserAssigned típus is engedélyezett).

Érték Description
None
SystemAssigned
SystemAssigned,UserAssigned
UserAssigned

MoboBrokerResource

Managed-On-Behalf-Of közvetítői erőforrás. Ezt az erőforrást az erőforrás-szolgáltató hozza létre bizonyos erőforrások kezeléséhez a felhasználó nevében.

Name Típus Description
id

string (arm-id)

FelügyeltBehalf-Of közvetítő erőforrás-azonosítója

Provider

Információ egy szolgáltatóról. A szolgáltató olyan entitás, amely célokat kínál az Azure Quantum Jobs futtatásához.

Name Típus Description
applicationName

string

A szolgáltató marketplace-alkalmazásának megjelenítendő neve.

instanceUri

string

A szolgáltató adott példányát azonosító URI.

providerId

string

A szolgáltató egyedi azonosítója.

providerSku

string

A szolgáltató díjszabási információihoz társított termékváltozat.

provisioningState

ProviderStatus

Kiépítési állapotmező

resourceUsageId

string

A szolgáltató erőforrás-használatának nyomon követésére szolgáló azonosító.

ProviderStatus

Kiépítési állapotmező

Érték Description
Deleted

A szolgáltató törlődik.

Deleting

A szolgáltató töröl.

Failed

A szolgáltató nem működik.

Launching

A szolgáltató megkezdi a kiépítést.

Succeeded

A szolgáltató kiépítése sikeresen megtörtént.

Updating

A szolgáltató frissül.

QuantumWorkspace

A Quantum Workspace erőforrásproxy-definíciós objektuma.

Name Típus Description
id

string (arm-id)

Az erőforrás teljes erőforrás-azonosítója. Például: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

identity

ManagedServiceIdentity

Az erőforráshoz rendelt felügyeltszolgáltatás-identitások.

location

string

Az a földrajzi hely, ahol az erőforrás él

name

string

Az erőforrás neve

properties

WorkspaceResourceProperties

Lekéri vagy beállítja a tulajdonságokat. A kvantum-munkaterület konkrét tulajdonságainak meghatározása.

systemData

systemData

A createdBy és a modifiedBy adatokat tartalmazó Azure Resource Manager-metaadatok.

tags

object

Erőforráscímkék.

type

string

Az erőforrás típusa. Pl. "Microsoft.Compute/virtualMachines" vagy "Microsoft.Storage/storageAccounts"

systemData

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

Name Típus Description
createdAt

string (date-time)

Az erőforrás-létrehozás időbélyege (UTC).

createdBy

string

Az erőforrást létrehozó identitás.

createdByType

createdByType

Az erőforrást létrehozó identitás típusa.

lastModifiedAt

string (date-time)

Az erőforrás utolsó módosításának időbélyege (UTC)

lastModifiedBy

string

Az erőforrást legutóbb módosító identitás.

lastModifiedByType

createdByType

Az erőforrást legutóbb módosító identitás típusa.

UsableStatus

Azt jelzi, hogy az aktuális munkaterület készen áll-e a feladatok elfogadására.

Érték Description
No

A munkaterület nem használható, és nem tud feladatokat fogadni.

Partial

A munkaterület részben használható.

Yes

A munkaterület használható, és képes feladatokat fogadni.

UserAssignedIdentity

Felhasználó által hozzárendelt identitástulajdonságok

Name Típus Description
clientId

string (uuid)

A hozzárendelt identitás ügyfélazonosítója.

principalId

string (uuid)

A hozzárendelt identitás egyszerű azonosítója.

WorkspaceProvisioningStatus

A munkaterület kiépítési állapota.

Érték Description
Canceled

Az erőforrás létrehozása megszakadt.

Failed

A munkaterület kiépítése nem sikerült.

ProviderDeleting

A munkaterület jelenleg töröl egy szolgáltatót.

ProviderLaunching

A munkaterület jelenleg kezd szolgáltatót kiépíteni.

ProviderProvisioning

A munkaterület jelenleg egy szolgáltatót épít ki.

ProviderUpdating

A munkaterület jelenleg frissít egy szolgáltatót.

Succeeded

A munkaterület kiépítése sikeres.

WorkspaceResourceProperties

Munkaterület tulajdonságai

Name Típus Description
apiKeyEnabled

boolean

A Quantum Workspace API-kulcsok engedélyezésének jelzője.

endpointUri

string

A munkaterület végpontjának URI-ja.

managedOnBehalfOfConfiguration

ManagedOnBehalfOfConfiguration

A konfiguráció nevében felügyelve.

managedStorageAccount

string (arm-id)

A munkaterülethez társított felügyelt tárfiók ARM-erőforrás-azonosítója.

providers

Provider[]

A munkaterülethez kiválasztott szolgáltatók listája

provisioningState

WorkspaceProvisioningStatus

Kiépítési állapotmező

storageAccount

string (arm-id)

A munkaterülethez társított tárfiók ARM-erőforrás-azonosítója.

usable

UsableStatus

Azt jelzi, hogy az aktuális munkaterület készen áll-e a feladatok elfogadására.