Applications - List Applications

Služba:

Batch Service

Verze rozhraní API:

2025-06-01

Uvádí všechny aplikace dostupné v daném účtu.
Tato operace vrací pouze aplikace a verze, které jsou dostupné pro použití na výpočetních uzlech; to znamená, že lze použít v referenci balíčku. Pro administrátorské informace o aplikacích a verzích, které ještě nejsou dostupné pro Compute Nodes, použijte portál Azure nebo API Azure Resource Manager.

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

S volitelnými parametry:

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
endpoint	path	True	string (uri)	Koncový bod účtu Batch (například: https://batchaccount.eastus2.batch.azure.com).
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.
maxresults	query		integer (int32) minimum: 1 maximum: 1000	Maximální počet položek, které se mají vrátit v odpovědi. Maximálně 1000 žádostí lze vrátit.
timeOut	query		integer (int32)	Maximální doba, po kterou může server strávit zpracováním požadavku v sekundách. Výchozí hodnota je 30 sekund. Pokud je hodnota větší než 30, použije se výchozí hodnota.".

Hlavička požadavku

Name	Vyžadováno	Typ	Description
client-request-id		string	Identita požadavku vygenerovaná volajícím ve formě identifikátoru GUID bez dekorace, jako jsou složené závorky, například 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id		boolean	Určuje, jestli má server v odpovědi vrátit ID požadavku klienta.
ocp-date		string (date-time-rfc7231)	Čas vydání žádosti. Klientské knihovny obvykle nastavily aktuální systémový čas; explicitně ji nastavte, pokud voláte přímo rozhraní REST API.

Odpovědi

Name	Typ	Description
200 OK	BatchApplicationListResult	Požadavek byl úspěšný. Hlavičky ETag: string Last-Modified: string client-request-id: string request-id: string
Other Status Codes	BatchError	Neočekávaná chybová odpověď

Zabezpečení

OAuth2Auth

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Rozsahy

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

Příklady

List applications

Ukázkový požadavek

HTTP

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

Ukázková odpověď

Stavový kód:

200

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

Definice

Name	Description
BatchApplication	Obsahuje informace o aplikaci v účtu Azure Batch.
BatchApplicationListResult	Výsledek výpisu aplikací dostupných v účtu
BatchError	Odpověď na chybu přijatá ze služby Azure Batch
BatchErrorDetail	Položka dalších informací zahrnutých v odpovědi na chybu služby Azure Batch
BatchErrorMessage	V odpovědi na chybu služby Azure Batch se zobrazila chybová zpráva.

BatchApplication

Objekt

Obsahuje informace o aplikaci v účtu Azure Batch.

Name	Typ	Description
displayName	string	Zobrazovaný název aplikace.
id	string	Řetězec, který jednoznačně identifikuje aplikaci v rámci účtu.
versions	string[]	Seznam dostupných verzí aplikace.

BatchApplicationListResult

Objekt

Výsledek výpisu aplikací dostupných v účtu

Name	Typ	Description
odata.nextLink	string (uri)	Adresa URL pro získání další sady výsledků.
value	BatchApplication[]	Seznam žádostí dostupných v Účtu.

BatchError

Objekt

Odpověď na chybu přijatá ze služby Azure Batch

Name	Typ	Description
code	string	Identifikátor chyby. Kódy jsou invariantní a mají být využity programově.
message	BatchErrorMessage	Zpráva popisující chybu, která má být vhodná pro zobrazení v uživatelském rozhraní.
values	BatchErrorDetail[]	Kolekce párů klíč-hodnota obsahující další podrobnosti o chybě.

BatchErrorDetail

Objekt

Položka dalších informací zahrnutých v odpovědi na chybu služby Azure Batch

Name	Typ	Description
key	string	Identifikátor určující význam vlastnosti Value.
value	string	Další informace zahrnuté v odpovědi na chybu.

BatchErrorMessage

Objekt

V odpovědi na chybu služby Azure Batch se zobrazila chybová zpráva.

Name	Typ	Description
lang	string	Jazykový kód chybové zprávy.
value	string	Text zprávy.