Nodes - Upload Node Logs

Hizmet:

Batch Service

API Sürümü:

2025-06-01

Azure Batch service log files from the specified Compute Node'dan Azure Blob Storage'a upload et.
Bu, bir hata yaşarsanız ve Azure desteğine yükseltmek istiyorsanız, Compute Nodes'tan otomatik olarak Azure Batch servis logu dosyalarını toplamak içindir. Batch hizmetiyle ilgili hata ayıklama sorunlarına yardımcı olmak için Azure Batch hizmet günlük dosyaları Azure desteğiyle paylaşılmalıdır.

POST {endpoint}/pools/{poolId}/nodes/{nodeId}/uploadbatchservicelogs?api-version=2025-06-01

İsteğe bağlı parametrelerle:

POST {endpoint}/pools/{poolId}/nodes/{nodeId}/uploadbatchservicelogs?api-version=2025-06-01&timeOut={timeOut}

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
endpoint	path	True	string (uri)	Batch hesabı uç noktası (örneğin: https://batchaccount.eastus2.batch.azure.com).
nodeId	path	True	string	Uzak Masaüstü Protokolü dosyasını almak istediğiniz Compute Node'un kimliği.
poolId	path	True	string	İşlem Düğümünü içeren Havuzun Kimliği.
api-version	query	True	string minLength: 1	Bu işlem için kullanılacak API sürümü.
timeOut	query		integer (int32)	Sunucunun isteği işlemek için harcayabileceği en uzun süre (saniye cinsinden). Varsayılan değer 30 saniyedir. Değer 30'dan büyükse, varsayılan kullanılacaktır.".

İstek Başlığı

Media Types: "application/json; odata=minimalmetadata"

Name	Gerekli	Tür	Description
client-request-id		string	Arayan tarafından oluşturulan istek kimliği, küme ayraçları gibi süslemesi olmayan bir GUID biçiminde, örneğin 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id		boolean	Sunucunun yanıtta client-request-id döndürip döndürmeyeceği.
ocp-date		string (date-time-rfc7231)	İsteğin verildiği saat. İstemci kitaplıkları bunu genellikle geçerli sistem saat saatine ayarlar; REST API'yi doğrudan çağırıyorsanız açıkça ayarlayın.

İstek Gövdesi

Media Types: "application/json; odata=minimalmetadata"

Name	Gerekli	Tür	Description
containerUrl	True	string (uri)	Azure Blob Storage içindeki konteynerin URL'si, Batch Service log dosyasının yükleneceği. Kullanıcıya atanan yönetilen kimlik kullanılmıyorsa, URL konteynere yazma izinleri veren Paylaşılan Erişim İmzası (SAS) içermelidir. SAS süresi, yüklemenin bitmesi için yeterli zaman tanımalıdır. SAS için başlangıç saati isteğe bağlıdır ve belirtilmemesi tavsiye edilir.
startTime	True	string (date-time)	Toplu Servis günlük dosyasının yükleneceği zaman aralığının başlangıcı. Zaman aralığında bir günlük mesajı içeren herhangi bir log dosyası yüklenecektir. Bu, tüm log dosyası her zaman yüklendiği için işlemin istenenden daha fazla log alabileceği anlamına gelir, ancak işlem istenenden daha az log almamalıdır.
endTime		string (date-time)	Toplu Servis günlük dosyalarının yükleneceği zaman aralığının sonu. Zaman aralığında bir günlük mesajı içeren herhangi bir log dosyası yüklenecektir. Bu, tüm log dosyası her zaman yüklendiği için işlemin istenenden daha fazla log alabileceği anlamına gelir, ancak işlem istenenden daha az log almamalıdır. Eğer atlanırsa, varsayılan olarak startTime'dan sonra mevcut tüm logları yüklemek olur.
identityReference		BatchNodeIdentityReference	Azure Blob Storage'a erişmek için containerUrl tarafından belirlenen kullanıcı atadığı kimlik referansı. Kimlik Azure Blob Storage konteynerine yazma erişimine sahip olmalıdır.

Yanıtlar

Name	Tür	Description
200 OK	UploadBatchServiceLogsResult	İstek başarılı oldu. Üst Bilgiler ETag: string Last-Modified: string client-request-id: string request-id: string
Other Status Codes	BatchError	Beklenmeyen bir hata yanıtı.

Güvenlik

OAuth2Auth

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Kapsamlar

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

Örnekler

Upload BatchService Logs

Örnek isteği

HTTP

POST {endpoint}/pools/poolId/nodes/tvm-1695681911_1-20161121t182739z/uploadbatchservicelogs?api-version=2025-06-01



{
  "containerUrl": "https://somestorageacct.blob.core.windows.net/batch-compute-node-logs?se=2025-12-09T18%3A51%3A00Z&sp=w&sv=2025-05-31&sr=c&sig",
  "startTime": "2025-11-27T00:00:00Z"
}

Örnek yanıt

Durum kodu:

200

{
  "virtualDirectoryName": "poolId/tvm-1695681911-1-20161121t182739z/0795539d-82fe-48e3-bbff-2964905b6de0",
  "numberOfFilesUploaded": 8
}

Tanımlar

Name	Description
BatchError	Azure Batch hizmetinden alınan bir hata yanıtı.
BatchErrorDetail	Azure Batch hata yanıtına dahil edilen ek bilgilerden oluşan bir öğe.
BatchErrorMessage	Azure Batch hata yanıtında bir hata iletisi alındı.
BatchNodeIdentityReference	İşlem düğümlerinin kullanacağı Batch havuzuyla ilişkili kullanıcı tarafından atanan kimliğe başvuru.
UploadBatchServiceLogsOptions	Azure Batch hizmet günlük dosyaları, bir İşlem Düğümü için parametreleri karşıya yükler.
UploadBatchServiceLogsResult	Belirli bir İşlem Düğümünden Batch hizmet günlüğü dosyalarını karşıya yüklemenin sonucu.

BatchError

Nesne

Azure Batch hizmetinden alınan bir hata yanıtı.

Name	Tür	Description
code	string	Hatanın tanımlayıcısı. Kodlar sabittir ve program aracılığıyla kullanılması amaçlanmıştır.
message	BatchErrorMessage	Hatayı açıklayan ve kullanıcı arabiriminde görüntülenmeye uygun olması amaçlanan bir ileti.
values	BatchErrorDetail[]	Hata hakkında ek ayrıntılar içeren anahtar-değer çiftleri koleksiyonu.

BatchErrorDetail

Nesne

Azure Batch hata yanıtına dahil edilen ek bilgilerden oluşan bir öğe.

Name	Tür	Description
key	string	Value özelliğinin anlamını belirten tanımlayıcı.
value	string	Hata yanıtına eklenen ek bilgiler.

BatchErrorMessage

Nesne

Azure Batch hata yanıtında bir hata iletisi alındı.

Name	Tür	Description
lang	string	Hata mesajının dil kodu.
value	string	İletinin metni.

BatchNodeIdentityReference

Nesne

İşlem düğümlerinin kullanacağı Batch havuzuyla ilişkili kullanıcı tarafından atanan kimliğe başvuru.

Name	Tür	Description
resourceId	string (arm-id)	Kullanıcı tarafından atanan kimliğin ARM kaynak kimliği.

UploadBatchServiceLogsOptions

Nesne

Azure Batch hizmet günlük dosyaları, bir İşlem Düğümü için parametreleri karşıya yükler.

Name	Tür	Description
containerUrl	string (uri)	Azure Blob Storage içindeki konteynerin URL'si, Batch Service log dosyasının yükleneceği. Kullanıcıya atanan yönetilen kimlik kullanılmıyorsa, URL konteynere yazma izinleri veren Paylaşılan Erişim İmzası (SAS) içermelidir. SAS süresi, yüklemenin bitmesi için yeterli zaman tanımalıdır. SAS için başlangıç saati isteğe bağlıdır ve belirtilmemesi tavsiye edilir.
endTime	string (date-time)	Toplu Servis günlük dosyalarının yükleneceği zaman aralığının sonu. Zaman aralığında bir günlük mesajı içeren herhangi bir log dosyası yüklenecektir. Bu, tüm log dosyası her zaman yüklendiği için işlemin istenenden daha fazla log alabileceği anlamına gelir, ancak işlem istenenden daha az log almamalıdır. Eğer atlanırsa, varsayılan olarak startTime'dan sonra mevcut tüm logları yüklemek olur.
identityReference	BatchNodeIdentityReference	Azure Blob Storage'a erişmek için containerUrl tarafından belirlenen kullanıcı atadığı kimlik referansı. Kimlik Azure Blob Storage konteynerine yazma erişimine sahip olmalıdır.
startTime	string (date-time)	Toplu Servis günlük dosyasının yükleneceği zaman aralığının başlangıcı. Zaman aralığında bir günlük mesajı içeren herhangi bir log dosyası yüklenecektir. Bu, tüm log dosyası her zaman yüklendiği için işlemin istenenden daha fazla log alabileceği anlamına gelir, ancak işlem istenenden daha az log almamalıdır.

UploadBatchServiceLogsResult

Nesne

Belirli bir İşlem Düğümünden Batch hizmet günlüğü dosyalarını karşıya yüklemenin sonucu.

Name	Tür	Description
numberOfFilesUploaded	integer (int32)	Yüklenecek log dosyalarının sayısı.
virtualDirectoryName	string	Azure Blob Storage konteyneri içindeki sanal dizin, Batch Service log dosyalarının yükleneceği. Sanal dizin adı, yüklenen her log dosyası için blob adının bir parçasıdır ve oluşturulmuş poolId, nodeId ve benzersiz bir tanımlayıcıdır.