Aracılığıyla paylaş

Nodes - Reimage Node

Hizmet:
Batch Service
API Sürümü:
2025-06-01

belirtilen İşlem Düğümünde işletim sistemini yeniden yükler.
İşletim sistemini bir İşlem Düğümüne yalnızca boşta veya çalışır durumdaysa yeniden yükleyebilirsiniz. Bu API yalnızca bulut servisi yapılandırma özelliğiyle oluşturulan havuzlarda çağrılabilir.

POST {endpoint}/pools/{poolId}/nodes/{nodeId}/reimage?api-version=2025-06-01
İsteğe bağlı parametrelerle: 
POST {endpoint}/pools/{poolId}/nodes/{nodeId}/reimage?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

Yeniden başlatmak 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

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 Tür Description
nodeReimageOption

BatchNodeReimageOption

İşlem Düğümü ne zaman yeniden yönetilsin ve şu anda çalışan Görevlerle ne yapmalı? Varsayılan değer yeniden sorgulanır.

Yanıtlar

Name Tür Description
202 Accepted

İstek işleme için kabul edildi, ancak işleme henüz tamamlanmadı.

Üst Bilgiler

  • DataServiceId: string
  • 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

Node reimage

Örnek isteği

POST {endpoint}/pools/poolId/nodes/tvm-1695681911_1-20161122t193202z/reimage?api-version=2025-06-01

Örnek yanıt

Durum kodu:
202

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ı.
BatchNodeReimageOption

BatchNodeReimageOption enums
BatchNodeReimageOptions

Azure Batch İşlem Düğümünü yeniden görüntülemek için parametreler.

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.

BatchNodeReimageOption

Numaralandırma

BatchNodeReimageOption enums

Değer Description
requeue

Çalışan Görev işlemlerini sonlandırın ve Görevleri yeniden sıraya getirin. İşlem Düğümü kullanılabilir olduğunda Görevler yeniden çalışır. Görevler sonlandırıldıktan hemen sonra İşlem Düğümünü yeniden görüntüleyin.
terminate

Çalışan Görevleri sonlandır. Görevler, sonlandırıldıklarını belirten failureInfo ile tamamlanır ve yeniden çalıştırılmaz. Görevler sonlandırıldıktan hemen sonra İşlem Düğümünü yeniden görüntüleyin.
taskcompletion

Çalışmakta olan Görevlerin tamamlanmasına izin verin. Beklerken yeni Görev zamanlama. Tüm Görevler tamamlandığında İşlem Düğümünü yeniden görüntüleyin.
retaineddata

Kullanım dışı olduğundan, görev verilerini görevinizdeki Azure Depolama'ya yüklemenizi ve bunun yerine kullanmanızı TaskCompletion öneririz. Çalışmakta olan Görevlerin tamamlanmasına izin verin, ardından tüm Görev verileri saklama sürelerinin dolmasını bekleyin. Beklerken yeni Görev zamanlama. Tüm Görev saklama sürelerinin süresi dolduğunda İşlem Düğümünü yeniden oluşturun.

BatchNodeReimageOptions

Nesne

Azure Batch İşlem Düğümünü yeniden görüntülemek için parametreler.

Name Tür Description
nodeReimageOption

BatchNodeReimageOption

İşlem Düğümü ne zaman yeniden yönetilsin ve şu anda çalışan Görevlerle ne yapmalı? Varsayılan değer yeniden sorgulanır.