Compute Node - Upload Batch Service Logs

Service:

Batch Service

API Version:

2023-11-01.18.0

Belirtilen İşlem Düğümünden Azure Batch hizmet günlüğü dosyalarını Azure Blob Depolama yükleyin.
Bu, hatayla karşılaşıyorsanız ve Azure desteği'a geçmek istiyorsanız Azure Batch hizmet günlüğü dosyalarını İşlem Düğümlerinden otomatik bir şekilde toplamaya yöneliktir. Batch hizmetiyle ilgili hata ayıklama sorunlarına yardımcı olmak için Azure Batch hizmet günlük dosyaları Azure desteği ile paylaşılmalıdır.

POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/uploadbatchservicelogs?api-version=2023-11-01.18.0

With optional parameters:

POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/uploadbatchservicelogs?timeout={timeout}&api-version=2023-11-01.18.0

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
batchUrl	path	True	string	Tüm Azure Batch hizmet isteklerinin temel URL'si.
nodeId	path	True	string	Azure Batch hizmet günlük dosyalarını karşıya yüklemek istediğiniz İşlem Düğümünün kimliği.
poolId	path	True	string	İşlem Düğümünü içeren Havuzun Kimliği.
api-version	query	True	string	İstemci API Sürümü.
timeout	query		integer int32	Sunucunun isteği işlemek için harcayabileceği en uzun süre (saniye olarak). Varsayılan değer 30 saniyedir.

İstek Başlığı

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

Name	Gerekli	Tür	Description
client-request-id		string uuid	Çağıranın oluşturduğu istek kimliği, küme ayraçları gibi süsleme içermeyen bir GUID biçimindedir; ö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-rfc1123	İsteğin verildiği saat. İstemci kitaplıkları bunu genellikle geçerli sistem saat saati olarak 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	Batch Hizmeti günlük dosyasının yüklendiği Azure Blob Depolama içindeki kapsayıcının URL'si. Kullanıcı tarafından atanan yönetilen kimlik kullanılmıyorsa, URL'nin kapsayıcıya yazma izinleri veren bir Paylaşılan Erişim İmzası (SAS) içermesi gerekir. SAS süresi, karşıya yüklemenin bitebilmesi için yeterli süreye izin vermelidir. SAS için başlangıç saati isteğe bağlıdır ve belirtilmemesi önerilir.
startTime	True	string	Batch Hizmeti günlük dosyasının yüklendiği zaman aralığının başlangıcı. Zaman aralığında günlük iletisi içeren tüm günlük dosyaları karşıya yüklenir. Bu, günlük dosyasının tamamı her zaman karşıya yüklendiğinden işlemin istenenden daha fazla günlük alabileceği, ancak işlemin istenenden daha az günlük almaması gerektiği anlamına gelir.
endTime		string	Batch Hizmeti günlük dosyasının yüklendiği zaman aralığının sonu. Zaman aralığında günlük iletisi içeren tüm günlük dosyaları karşıya yüklenir. Bu, günlük dosyasının tamamı her zaman karşıya yüklendiğinden işlemin istenenden daha fazla günlük alabileceği, ancak işlemin istenenden daha az günlük almaması gerektiği anlamına gelir. Atlanırsa, varsayılan ayar startTime sonrasında kullanılabilen tüm günlükleri karşıya yüklemektir.
identityReference		ComputeNodeIdentityReference	containerUrl tarafından belirtilen Azure Blob Depolama erişmek için kullanılacak kullanıcı tarafından atanan kimliğe başvuru. Kimliğin Azure Blob Depolama kapsayıcısına yazma erişimi olmalıdır.

Yanıtlar

Name	Tür	Description
200 OK	UploadBatchServiceLogsResult	Batch hizmetine yapılan istek başarılı oldu. Headers client-request-id: string request-id: string
Other Status Codes	BatchError	Batch hizmetinden gelen hata.

Güvenlik

azure_auth

OAuth 2.0 kimlik doğrulama kodu akışını Microsoft Entra

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	Kullanıcı hesabınızın kimliğine bürünme

Authorization

Type: apiKey
In: header

Örnekler

Upload BatchService Logs

Sample Request

HTTP

POST account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_1-20161121t182739z/uploadbatchservicelogs?api-version=2023-11-01.18.0



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

Sample Response

Status code:

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 eklenen ek bilgilerden oluşan bir öğe.
ComputeNodeIdentityReference	İşlem düğümlerinin kullanacağı Batch havuzuyla ilişkilendirilmiş kullanıcı tarafından atanan kimliğe başvuru.
ErrorMessage	Azure Batch hata yanıtında alınan bir hata iletisi.
UploadBatchServiceLogsConfiguration	Azure Batch hizmet günlüğü dosyaları bir İşlem Düğümü için yapılandırmayı karşıya yükler.
UploadBatchServiceLogsResult	Batch hizmet günlüğü dosyalarını belirli bir İşlem Düğümünden karşıya yüklemenin sonucu.

BatchError

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	ErrorMessage	Hatayı açıklayan ve kullanıcı arabiriminde görüntülenmeye uygun olması amaçlanan bir ileti.
values	BatchErrorDetail[]	Hatayla ilgili ek ayrıntıları içeren anahtar-değer çiftleri koleksiyonu.

BatchErrorDetail

Azure Batch hata yanıtına eklenen 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.

ComputeNodeIdentityReference

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

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

ErrorMessage

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

Name	Tür	Description
lang	string	Hata iletisinin dil kodu
value	string	İletinin metni.

UploadBatchServiceLogsConfiguration

Azure Batch hizmet günlüğü dosyaları bir İşlem Düğümü için yapılandırmayı karşıya yükler.

Name	Tür	Description
containerUrl	string	Batch Hizmeti günlük dosyasının yüklendiği Azure Blob Depolama içindeki kapsayıcının URL'si. Kullanıcı tarafından atanan yönetilen kimlik kullanılmıyorsa, URL'nin kapsayıcıya yazma izinleri veren bir Paylaşılan Erişim İmzası (SAS) içermesi gerekir. SAS süresi, karşıya yüklemenin bitebilmesi için yeterli süreye izin vermelidir. SAS için başlangıç saati isteğe bağlıdır ve belirtilmemesi önerilir.
endTime	string	Batch Hizmeti günlük dosyasının yüklendiği zaman aralığının sonu. Zaman aralığında günlük iletisi içeren tüm günlük dosyaları karşıya yüklenir. Bu, günlük dosyasının tamamı her zaman karşıya yüklendiğinden işlemin istenenden daha fazla günlük alabileceği, ancak işlemin istenenden daha az günlük almaması gerektiği anlamına gelir. Atlanırsa, varsayılan ayar startTime sonrasında kullanılabilen tüm günlükleri karşıya yüklemektir.
identityReference	ComputeNodeIdentityReference	containerUrl tarafından belirtilen Azure Blob Depolama erişmek için kullanılacak kullanıcı tarafından atanan kimliğe başvuru. Kimliğin Azure Blob Depolama kapsayıcısına yazma erişimi olmalıdır.
startTime	string	Batch Hizmeti günlük dosyasının yüklendiği zaman aralığının başlangıcı. Zaman aralığında günlük iletisi içeren tüm günlük dosyaları karşıya yüklenir. Bu, günlük dosyasının tamamı her zaman karşıya yüklendiğinden işlemin istenenden daha fazla günlük alabileceği, ancak işlemin istenenden daha az günlük almaması gerektiği anlamına gelir.

UploadBatchServiceLogsResult

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

Name	Tür	Description
numberOfFilesUploaded	integer	Karşıya yüklenecek günlük dosyalarının sayısı.
virtualDirectoryName	string	Batch Hizmeti günlük dosyasının yüklendiği Azure Blob Depolama kapsayıcı içindeki sanal dizin. Sanal dizin adı, karşıya yüklenen her günlük dosyasının blob adının bir parçasıdır ve yerleşik poolId, nodeId ve benzersiz bir tanımlayıcıdır.