File - List From Compute Node
Vypíše všechny soubory v adresářích úkolů na zadaném výpočetním uzlu.
GET {batchUrl}/pools/{poolId}/nodes/{nodeId}/files?api-version=2023-11-01.18.0
GET {batchUrl}/pools/{poolId}/nodes/{nodeId}/files?$filter={$filter}&recursive={recursive}&maxresults={maxresults}&timeout={timeout}&api-version=2023-11-01.18.0
Parametry identifikátoru URI
Name | V | Vyžadováno | Typ | Description |
---|---|---|---|---|
batch
|
path | True |
string |
Základní adresa URL pro všechny požadavky Azure Batch služby. |
node
|
path | True |
string |
ID výpočetního uzlu, jehož soubory chcete vypsat. |
pool
|
path | True |
string |
ID fondu, který obsahuje výpočetní uzel. |
api-version
|
query | True |
string |
Verze rozhraní API klienta. |
$filter
|
query |
string |
Klauzule $filter OData. Další informace o vytváření tohoto filtru najdete v tématu https://docs.microsoft.com/en-us/rest/api/batchservice/odata-filters-in-batch#list-compute-node-files. |
|
maxresults
|
query |
integer int32 |
Maximální počet položek, které se mají v odpovědi vrátit. Může se vrátit maximálně 1000 souborů. |
|
recursive
|
query |
boolean |
Určuje, jestli se mají zobrazit podřízené položky adresáře. |
|
timeout
|
query |
integer int32 |
Maximální doba, kterou může server strávit zpracováním požadavku( v sekundách). Výchozí hodnota je 30 sekund. |
Hlavička požadavku
Media Types: "application/json; odata=minimalmetadata"
Name | Vyžadováno | Typ | Description |
---|---|---|---|
client-request-id |
string uuid |
Identita požadavku vygenerovaná volajícím ve formě identifikátoru GUID bez dekorace, například 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0. |
|
return-client-request-id |
boolean |
Určuje, jestli má server v odpovědi vrátit client-request-id. |
|
ocp-date |
string date-time-rfc1123 |
Čas, kdy byla žádost vydána. Klientské knihovny obvykle nastavit na aktuální systémový čas hodin; pokud voláte rozhraní REST API přímo, explicitně ho nastavte. |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
Odpověď obsahující seznam souborů. Hlavičky
|
|
Other Status Codes |
Chyba ze služby Batch. |
Zabezpečení
azure_auth
Microsoft Entra tok ověřovacího kódu OAuth 2.0
Typ:
oauth2
Tok:
implicit
URL autorizace:
https://login.microsoftonline.com/common/oauth2/authorize
Rozsahy
Name | Description |
---|---|
user_impersonation | Zosobnění uživatelského účtu |
Authorization
Typ:
apiKey
V:
header
Příklady
File list from node
Ukázkový požadavek
GET account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_1-20161122t193202z/files?recursive=False&api-version=2023-11-01.18.0
Ukázková odpověď
{
"value": [
{
"name": "shared",
"url": "https://account.region.batch.azure.com/pools/poolId/nodes/tvm-2167304207_2-20140919t215614z/files/shared",
"isDirectory": true
},
{
"name": "startup\\ProcessEnv.cmd",
"url": "https://account.region.batch.azure.com/pools/poolId/nodes/tvm-2167304207_2-20140919t215614z/files/startup\\ProcessEnv.cmd",
"isDirectory": false,
"properties": {
"creationTime": "2014-09-19T21:56:17.679195Z",
"lastModified": "2014-09-19T21:56:17.679195Z",
"contentLength": 1813,
"contentType": "application/octet-stream"
}
},
{
"name": "startup\\stderr.txt",
"url": "https://account.region.batch.azure.com/pools/poolId/nodes/tvm-2167304207_2-20140919t215614z/files/startup\\stderr.txt",
"isDirectory": false,
"properties": {
"creationTime": "2014-09-19T21:56:17.5590855Z",
"lastModified": "2014-09-19T21:56:17.5590855Z",
"contentLength": 0,
"contentType": "application/octet-stream"
}
}
]
}
Definice
Name | Description |
---|---|
Batch |
Služba Azure Batch obdržela chybovou odpověď. |
Batch |
Položka s dalšími informacemi, které jsou součástí Azure Batch chybové odpovědi. |
Error |
Chybová zpráva přijatá v Azure Batch chybovou odpověď. |
File |
Vlastnosti souboru na výpočetním uzlu. |
Node |
Informace o souboru nebo adresáři na výpočetním uzlu. |
Node |
Výsledek výpisu souborů na výpočetním uzlu nebo souborů přidružených k úkolu na výpočetním uzlu. |
BatchError
Služba Azure Batch obdržela chybovou odpověď.
Name | Typ | Description |
---|---|---|
code |
string |
Identifikátor chyby. Kódy jsou neutrální a mají být využívány programově. |
message |
Zpráva popisující chybu, která má být vhodná k zobrazení v uživatelském rozhraní. |
|
values |
Kolekce párů klíč-hodnota obsahující další podrobnosti o chybě. |
BatchErrorDetail
Položka s dalšími informacemi, které jsou součástí Azure Batch chybové odpovědi.
Name | Typ | Description |
---|---|---|
key |
string |
Identifikátor určující význam value vlastnost. |
value |
string |
Další informace zahrnuté v chybové odpovědi. |
ErrorMessage
Chybová zpráva přijatá v Azure Batch chybovou odpověď.
Name | Typ | Description |
---|---|---|
lang |
string |
Kód jazyka chybové zprávy |
value |
string |
Text zprávy |
FileProperties
Vlastnosti souboru na výpočetním uzlu.
Name | Typ | Description |
---|---|---|
contentLength |
integer |
Délka souboru. |
contentType |
string |
Typ obsahu souboru. |
creationTime |
string |
Čas vytvoření souboru. |
fileMode |
string |
Atribut file mode v osmičkovém formátu. |
lastModified |
string |
Čas poslední změny souboru. |
NodeFile
Informace o souboru nebo adresáři na výpočetním uzlu.
Name | Typ | Description |
---|---|---|
isDirectory |
boolean |
Určuje, zda objekt představuje adresář. |
name |
string |
Cesta k souboru. |
properties |
Vlastnosti souboru. |
|
url |
string |
Adresa URL souboru. |
NodeFileListResult
Výsledek výpisu souborů na výpočetním uzlu nebo souborů přidružených k úkolu na výpočetním uzlu.
Name | Typ | Description |
---|---|---|
odata.nextLink |
string |
Adresa URL pro získání další sady výsledků |
value |
Node |
Seznam souborů. |