Freigeben über

Applications - List Applications

Dienst:
Batch Service
API-Version:
2025-06-01

Listet alle Anwendungen auf, die im angegebenen Konto verfügbar sind.
Diese Operation liefert nur Anwendungen und Versionen zurück, die für die Nutzung auf Compute Nodes verfügbar sind; das heißt, das kann in einer Paketreferenz verwendet werden. Für Administratorinformationen zu Anwendungen und Versionen, die den Compute Nodes noch nicht zur Verfügung stehen, verwenden Sie das Azure-Portal oder die Azure Resource Manager API.

GET {endpoint}/applications?api-version=2025-06-01
Mit optionalen Parametern: 
GET {endpoint}/applications?api-version=2025-06-01&timeOut={timeOut}&maxresults={maxresults}

URI-Parameter

Name In Erforderlich Typ Beschreibung
endpoint
 path True

string (uri)

Batchkontoendpunkt (z. B. https://batchaccount.eastus2.batch.azure.com).
api-version
 query True

string

minLength: 1

Die API-Version, die für diesen Vorgang verwendet werden soll.
maxresults
 query

integer (int32)

minimum: 1
maximum: 1000

Die maximale Anzahl von Elementen, die in der Antwort zurückgegeben werden sollen. Maximal 1000 Anträge können zurückgeschickt werden.
timeOut
 query

integer (int32)

Die maximale Zeit, die der Server für die Verarbeitung der Anforderung in Sekunden ausgeben kann. Der Standardwert ist 30 Sekunden. Ist der Wert größer als 30, wird stattdessen der Standard verwendet."

Anforderungsheader

Name Erforderlich Typ Beschreibung
client-request-id

string

Die vom Aufrufer generierte Anforderungsidentität in Form einer GUID ohne Dekoration wie geschweifte Klammern, z. B. 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id

boolean

Gibt an, ob der Server die Clientanforderungs-ID in der Antwort zurückgeben soll.
ocp-date

string (date-time-rfc7231)

Der Zeitpunkt, zu dem die Anforderung ausgestellt wurde. Clientbibliotheken legen dies in der Regel auf die aktuelle Systemuhrzeit fest. legen Sie sie explizit fest, wenn Sie die REST-API direkt aufrufen.

Antworten

Name Typ Beschreibung
200 OK

BatchApplicationListResult

Die Anforderung ist erfolgreich.

Header

  • ETag: string
  • Last-Modified: string
  • client-request-id: string
  • request-id: string
Other Status Codes

BatchError

Unerwartete Fehlerantwort.

Sicherheit

OAuth2Auth

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Bereiche

Name Beschreibung
https://batch.core.windows.net//.default

Beispiele

List applications

Beispielanforderung

GET {endpoint}/applications?api-version=2025-06-01

Beispiel für eine Antwort

Statuscode:
200 
{
  "value": [
    {
      "id": "my_application_id",
      "versions": [
        "v1.0"
      ],
      "displayName": "my_display_name"
    }
  ]
}

Definitionen

Name Beschreibung
BatchApplication

Enthält Informationen zu einer Anwendung in einem Azure-Batchkonto.
BatchApplicationListResult

Das Ergebnis der Auflistung der anwendungen, die in einem Konto verfügbar sind.
BatchError

Eine Vom Azure Batch-Dienst empfangene Fehlerantwort.
BatchErrorDetail

Ein Element mit zusätzlichen Informationen, die in einer Azure Batch-Fehlerantwort enthalten sind.
BatchErrorMessage

Eine Fehlermeldung, die in einer Azure Batch-Fehlerantwort empfangen wurde.

BatchApplication

Objekt

Enthält Informationen zu einer Anwendung in einem Azure-Batchkonto.

Name Typ Beschreibung
displayName

string

Der Anzeigename der Anwendung.
id

string

Eine Zeichenkette, die die Anwendung innerhalb des Kontos eindeutig identifiziert.
versions

string[]

Die Liste der verfügbaren Versionen der Anwendung.

BatchApplicationListResult

Objekt

Das Ergebnis der Auflistung der anwendungen, die in einem Konto verfügbar sind.

Name Typ Beschreibung
odata.nextLink

string (uri)

Die URL zum Abrufen der nächsten Ergebnisse.
value

BatchApplication[]

Die Liste der Bewerbungen ist im Konto verfügbar.

BatchError

Objekt

Eine Vom Azure Batch-Dienst empfangene Fehlerantwort.

Name Typ Beschreibung
code

string

Ein Bezeichner für den Fehler. Codes sind unveränderlich und sollen programmgesteuert genutzt werden.
message

BatchErrorMessage

Eine Meldung, die den Fehler beschreibt, der für die Anzeige in einer Benutzeroberfläche geeignet ist.
values

BatchErrorDetail[]

Eine Sammlung von Schlüssel-Wert-Paaren, die zusätzliche Details zum Fehler enthalten.

BatchErrorDetail

Objekt

Ein Element mit zusätzlichen Informationen, die in einer Azure Batch-Fehlerantwort enthalten sind.

Name Typ Beschreibung
key

string

Ein Bezeichner, der die Bedeutung der Value-Eigenschaft angibt.
value

string

Die zusätzlichen Informationen, die in der Fehlerantwort enthalten sind.

BatchErrorMessage

Objekt

Eine Fehlermeldung, die in einer Azure Batch-Fehlerantwort empfangen wurde.

Name Typ Beschreibung
lang

string

Der Sprachcode der Fehlermeldung.
value

string

Der Text der Nachricht.