Sessions - Listv 2

Szolgáltatás:: Azure Quantum

API verzió:: 2026-01-15-preview

Az összes munkamenet listázása.

GET {endpoint}/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Quantum/workspaces/{workspaceName}/sessions?api-version=2026-01-15-preview

Opcionális paraméterekkel:

GET {endpoint}/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Quantum/workspaces/{workspaceName}/sessions?api-version=2026-01-15-preview&filter={filter}&skip={skip}&top={top}&orderby={orderby}

URI paraméterek

Név	Ban	Szükséges	Típus	Leírás
endpoint	path	True	string (uri)	Az Azure Quantum szolgáltatás végpontja. Például https://{region}.quantum.azure.com
resourceGroupName	path	True	string minLength: 1 maxLength: 90 pattern: ^[a-zA-Z][a-zA-Z0-9\-_\.]*$	Az Azure-erőforráscsoport neve.
subscriptionId	path	True	string minLength: 36 maxLength: 36 pattern: ^[0-9a-f]{8}-(?:[0-9a-f]{4}-){3}[0-9a-f]{12}$	Az Azure-előfizetés azonosítója.
workspaceName	path	True	string minLength: 2 maxLength: 50 pattern: ^[a-zA-Z][a-zA-Z0-9\-_]*$	Az Azure Quantum-munkaterület neve.
api-version	query	True	string minLength: 1	A művelethez használandó API-verzió.
filter	query		string	Az eredménylista szűrése a megadott kifejezéssel
orderby	query		string	A visszaküldött tételek sorrendje.
skip	query		integer (int32)	A kihagyandó eredményelemek száma.
top	query		integer (int32)	Az elfoglalt munkák száma.

Válaszok

Név	Típus	Leírás
200 OK	PagedSessionDetails	A kérés sikeres volt.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Váratlan hibaválasz. Fejlécek x-ms-error-code: string

Név

Típus

Leírás

200 OK

PagedSessionDetails

A kérés sikeres volt.

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Váratlan hibaválasz.

Fejlécek

x-ms-error-code: string

Biztonság

AzureEntraAuth

Azure Entra OAuth2-hitelesítés

Típus: oauth2
Flow: application
Token URL: https://login.microsoftonline.com/common/oauth2/v2.0/token

Hatókörök

Név	Leírás
https://quantum.microsoft.com/.default

x-ms-quantum-api-key

Azure Api-Key hitelesítés

Típus: apiKey
Ban: header

Példák

List sessions in a workspace.

Mintakérés

HTTP

GET {endpoint}/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Quantum/workspaces/my-workspace/sessions?api-version=2026-01-15-preview&filter=provider eq microsoft&skip=100&top=100&orderby=orderbytime

Mintaválasz

Állapotkód:: 200

{
  "value": [
    {
      "name": "VQE Session",
      "id": "60ba7795-6a13-4630-aec0-260b3904378c",
      "itemType": "Session",
      "beginExecutionTime": "2020-09-30T23:57:11.5659691Z",
      "creationTime": "2020-09-30T23:57:02.3737928+00:00",
      "createdBy": "user1@example.com",
      "createdByType": "User",
      "lastModifiedTime": "2020-10-01T01:20:00.0000000+00:00",
      "lastModifiedBy": "user2@example.com",
      "lastModifiedByType": "User",
      "lastUpdatedTime": "2020-10-01T01:25:00.0000000+00:00",
      "endExecutionTime": "2020-09-30T23:57:11.6180743Z",
      "errorData": null,
      "jobFailurePolicy": "Abort",
      "providerId": "ionq",
      "status": "Succeeded",
      "target": "ionq.qpu",
      "costEstimate": {
        "currencyCode": "USD",
        "estimatedTotal": 0.005
      }
    },
    {
      "name": "QAOA Session",
      "id": "a54a5d47-1591-4334-9c7b-7b692d5db26c",
      "itemType": "Session",
      "beginExecutionTime": "2022-06-30T23:58:11.5659691Z",
      "creationTime": "2022-06-30T23:58:11.5659691Z",
      "createdBy": "user3@example.com",
      "createdByType": "User",
      "lastModifiedTime": "2022-07-01T01:30:00.0000000+00:00",
      "lastModifiedBy": "user4@example.com",
      "lastModifiedByType": "User",
      "lastUpdatedTime": "2022-07-01T01:35:00.0000000+00:00",
      "errorData": null,
      "jobFailurePolicy": "Abort",
      "providerId": "ionq",
      "status": "Executing",
      "target": "ionq.qpu",
      "costEstimate": {
        "currencyCode": "USD",
        "estimatedTotal": 5.025
      }
    }
  ],
  "nextLink": null
}

Meghatározások

Név	Leírás
Azure.Core.Foundations.Error	A hibaobjektum.
Azure.Core.Foundations.ErrorResponse	Hibaadatokat tartalmazó válasz.
Azure.Core.Foundations.InnerError	Egy objektum, amely részletesebb információkat tartalmaz a hibáról. Az Azure REST API irányelvei szerint – https://aka.ms/AzureRestApiGuidelines#handling-errors.
CostEstimate	A szolgáltató által számlázott munkaköltség. A számlán szereplő végső költség némileg eltérhet a hozzáadott adók és a valutaátváltási árfolyamok miatt.
CreatedByType	Az identitás típusa, amely létrehozta a tárgyat.
Errors.WorkspaceItemError	A hibaobjektum.
ItemType	A munkaterületi elem típusa.
PagedSessionDetails	SessionDetails elemek lapozható gyűjteménye
Priority	Feladatprioritási szintek.
SessionDetails	Munkamenet, a feladatok logikai csoportosítása.
SessionJobFailurePolicy	A munkamenet viselkedését szabályozó szabályzat, ha a munkamenetben egy feladat meghiúsul.
SessionStatus	A munkamenet állapota.
UsageEvent	Használati esemény részletei.

Azure.Core.Foundations.Error

Tárgy

A hibaobjektum.

Név	Típus	Leírás
code	string	A kiszolgáló által definiált hibakódok egyike.
details	Azure.Core.Foundations.Error[]	A jelentett hibához vezető konkrét hibák részleteinek tömbje.
innererror	Azure.Core.Foundations.InnerError	Egy objektum, amely az aktuális objektumnál pontosabb információt tartalmaz a hibáról.
message	string	A hiba ember által olvasható ábrázolása.
target	string	A hiba célja.

Azure.Core.Foundations.ErrorResponse

Tárgy

Hibaadatokat tartalmazó válasz.

Név	Típus	Leírás
error	Azure.Core.Foundations.Error	A hibaobjektum.

Azure.Core.Foundations.InnerError

Tárgy

Egy objektum, amely részletesebb információkat tartalmaz a hibáról. Az Azure REST API irányelvei szerint – https://aka.ms/AzureRestApiGuidelines#handling-errors.

Név	Típus	Leírás
code	string	A kiszolgáló által definiált hibakódok egyike.
innererror	Azure.Core.Foundations.InnerError	Belső hiba.

CostEstimate

Tárgy

A szolgáltató által számlázott munkaköltség. A számlán szereplő végső költség némileg eltérhet a hozzáadott adók és a valutaátváltási árfolyamok miatt.

Név	Típus	Leírás
currencyCode	string	A pénznem kódja.
estimatedTotal	number (float)	A becsült összeg.
events	UsageEvent[]	Használati események listája.

CreatedByType

Felsorolás

Az identitás típusa, amely létrehozta a tárgyat.

Érték	Leírás
User	Az elemet a felhasználó hozza létre
Application	Az elemet alkalmazás hozza létre
ManagedIdentity	Az elem kezelt identitással készül
Key	Az elemet kulcs használatával hozza létre

Errors.WorkspaceItemError

Tárgy

A hibaobjektum.

Név	Típus	Leírás
code	string	A kiszolgáló által definiált hibakódok egyike.
details	Azure.Core.Foundations.Error[]	A jelentett hibához vezető konkrét hibák részleteinek tömbje.
innererror	Azure.Core.Foundations.InnerError	Egy objektum, amely az aktuális objektumnál pontosabb információt tartalmaz a hibáról.
message	string	A hiba ember által olvasható ábrázolása.
target	string	A hiba célja.

ItemType

Felsorolás

A munkaterületi elem típusa.

Érték	Leírás
Job	Feldolgozásra benyújtott program, probléma vagy alkalmazás.
Session	A feladatok logikai csoportosítása.

PagedSessionDetails

Tárgy

SessionDetails elemek lapozható gyűjteménye

Név	Típus	Leírás
nextLink	string (uri)	Az elemek következő oldalára mutató hivatkozás
value	SessionDetails[]	A SessionDetails elemek ezen az oldalon

Priority

Felsorolás

Feladatprioritási szintek.

Érték	Leírás
Standard	A feladat alapprioritása.
High	A feladat prioritása megemelt.

SessionDetails

Tárgy

Munkamenet, a feladatok logikai csoportosítása.

Név	Típus	Leírás
beginExecutionTime	string (date-time)	Az az időpont, amikor a tétel végrehajtása megkezdődött.
costEstimate	CostEstimate	Költségbecslés.
createdBy	string	Az identitás, amely létrehozta a tárgyat.
createdByType	CreatedByType	Az identitás típusa, amely létrehozta a tárgyat.
creationTime	string (date-time)	Az elem létrehozásának ideje.
endExecutionTime	string (date-time)	Az az idő, amikor az elem befejezte a végrehajtást.
errorData	Errors.WorkspaceItemError	Hibainformációk.
id	string maxLength: 36 pattern: ^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$	Az ülés azonosítója.
itemType	string: Session	A Quantum Workspace elem típusa
jobFailurePolicy	SessionJobFailurePolicy	A munkamenet viselkedését szabályozó szabályzat, ha a munkamenetben egy feladat meghiúsul.
lastModifiedBy	string	Az a személyazonosság, amely utoljára módosította a tárgyat.
lastModifiedByType	CreatedByType	Az a típus, amely utoljára módosította az eszközt.
lastModifiedTime	string (date-time)	Az ügyfél által indított utolsó módosítás időbélyegje.
lastUpdatedTime	string (date-time)	Legutóbb a rendszer frissítette az eszközt.
name	string	A cikk neve. Nem szükséges, hogy a név egyedi legyen, és csak megjelenítési célokra használható.
priority	Priority	A munka vagy munkamenet prioritása.
providerId	string	A szolgáltató egyedi azonosítója.
status	SessionStatus	A munkamenet állapota.
tags	string[]	A feladathoz társított, felhasználó által megadott címkék listája.
target	string	A feladat futtatásához szükséges célazonosító.
usage	object	Erőforrás-felhasználási metrikák, amelyek szolgáltatóspecifikus használati adatokat tartalmaznak, például végrehajtási időt, felhasznált kvantumfelvételeket stb.

SessionJobFailurePolicy

Felsorolás

A munkamenet viselkedését szabályozó szabályzat, ha a munkamenetben egy feladat meghiúsul.

Érték	Leírás
Abort	A feladat sikertelensége után beküldött új feladatokat a rendszer elutasítja.
Continue	A sikertelen állások után benyújtott új állásokat elfogadják.

SessionStatus

Felsorolás

A munkamenet állapota.

Érték	Leírás
Waiting	A munkamenet a várólistában várja a végrehajtást.
Executing	A munkamenet végrehajtása folyamatban van.
Succeeded	Az ülés sikeresen zárult.
Failed	A munkamenet sikertelenül fejeződött be.
Failure(s)	A munkamenet néhány hibával fejeződött be.
TimedOut	A munkamenet időtúllépést ért el.

UsageEvent

Tárgy

Használati esemény részletei.

Név	Típus	Leírás
amountBilled	number (float)	A számlázott összeg.
amountConsumed	number (float)	Az elfogyasztott mennyiség.
dimensionId	string	A dimenzió azonosítója.
dimensionName	string	A dimenzió neve.
measureUnit	string	A mértékegység.
unitPrice	number (float)	Az egységár.