Pools - Delete Pool

Hizmet:

Batch Service

API Sürümü:

2025-06-01

Belirtilen Hesaptan bir Havuzu siler.
Bir Havuzun silinmesini istediğinizde şu eylemler gerçekleşir: Havuz durumu silme olarak ayarlanır; Havuzdaki devam eden yeniden boyutlandırma işlemleri durdurulur; Batch hizmeti Havuzu sıfır İşlem Düğümlerine yeniden boyutlandırmaya başlar; Mevcut İşlem Düğümlerinde çalışan görevler sonlandırılır ve yeniden kuyruhlanır (varsayılan yeniden sorgulama seçeneğiyle Havuz yeniden boyutlandırma işlemi istenmiş gibi); son olarak, Havuz sistemden kaldırılır. Çalışan Görevler yeniden sorgulandığından, kullanıcı işini farklı bir Havuzu hedeflemek üzere güncelleştirerek bu Görevleri yeniden çalıştırabilir. Görevler daha sonra yeni Havuzda çalıştırılabilir. Yeniden sorgulama davranışını geçersiz kılmak istiyorsanız, Havuzu silmeden önce Havuzu sıfır boyuta küçültmek için havuzu açıkça yeniden boyutlandırmayı çağırmalısınız. Silme durumundaki bir Havuzdaki Güncelleştirme, Düzeltme Eki veya Silme API'sini çağırırsanız, poolBeingDeleted hata koduyla 409 HTTP durum koduyla başarısız olur.

DELETE {endpoint}/pools/{poolId}?api-version=2025-06-01

İsteğe bağlı parametrelerle:

DELETE {endpoint}/pools/{poolId}?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).
poolId	path	True	string	Alınacak 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ığı

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.
If-Modified-Since		string (date-time-rfc7231)	İstemci tarafından bilinen kaynağın son değiştirme zamanını gösteren zaman damgası. İşlem yalnızca hizmet üzerindeki kaynak belirtilen süreden bu yana değiştirilmişse gerçekleştirilir.
If-Unmodified-Since		string (date-time-rfc7231)	İstemci tarafından bilinen kaynağın son değiştirme zamanını gösteren zaman damgası. İşlem yalnızca hizmet üzerindeki kaynak belirtilen süreden bu yana değiştirilmemişse gerçekleştirilir.
If-Match		string	İstemci tarafından bilinen kaynağın sürümüyle ilişkili bir ETag değeri. İşlem yalnızca kaynağın hizmetteki geçerli ETag'i istemci tarafından belirtilen değerle tam olarak eşleşiyorsa gerçekleştirilir.
If-None-Match		string	İstemci tarafından bilinen kaynağın sürümüyle ilişkili bir ETag değeri. İşlem yalnızca kaynağın hizmetteki geçerli ETag'i istemci tarafından belirtilen değerle eşleşmiyorsa gerçekleştirilir.

Yanıtlar

Name	Tür	Description
202 Accepted		İstek işleme için kabul edildi, ancak işleme henüz tamamlanmadı. Üst Bilgiler 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

Pool delete

Örnek isteği

HTTP

DELETE {endpoint}/pools/poolId?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ı.

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.