Pool - Delete

Hizmet:

Batch Service

API Sürümü:

2023-11-01.18.0

Belirtilen Hesaptan bir Havuzu siler.
Bir Havuzun silinmesini istediğinizde aşağıdaki eylemler gerçekleşir: Havuz durumu silinecek şekilde ayarlanır; Havuzdaki devam eden yeniden boyutlandırma işlemleri durdurulur; Batch hizmeti Havuzu sıfır İşlem Düğümü olarak yeniden boyutlandırmaya başlar; Mevcut İşlem Düğümlerinde çalışan tüm Görevler sonlandırılır ve yeniden kuyruğrulanır (havuz yeniden boyutlandırma işlemi varsayılan yeniden sıralama seçeneğiyle 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 sıralama davranışını geçersiz kılmak istiyorsanız, Havuzu silmeden önce Havuzu sıfır boyuta küçültmek için yeniden boyutlandırma Havuzunu açıkça çağırmanız gerekir. Silme durumundaki bir Havuzda Güncelleştirme, Düzeltme Eki Uygulama veya Silme API'sini çağırırsanız, havuz PoolBeingDeleted hata koduyla 409 HTTP durum koduyla başarısız olur.

DELETE {batchUrl}/pools/{poolId}?api-version=2023-11-01.18.0

İsteğe bağlı parametrelerle:

DELETE {batchUrl}/pools/{poolId}?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.
poolId	path	True	string	Silinecek 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 tarafından oluşturulan istek kimliği, küme ayraçları gibi dekorasyonu olmayan 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 saatine ayarlar; REST API'yi doğrudan çağırıyorsanız açıkça ayarlayın.
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 değeri 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.
If-Modified-Since		string date-time-rfc1123	İstemci tarafından bilinen kaynağın son değiştirilme zamanını gösteren zaman damgası. İşlem yalnızca hizmet üzerindeki kaynak belirtilen süreden sonra değiştirilmişse gerçekleştirilir.
If-Unmodified-Since		string date-time-rfc1123	İstemci tarafından bilinen kaynağın son değiştirilme zamanını gösteren zaman damgası. İşlem yalnızca hizmet üzerindeki kaynak belirtilen süreden sonra değiştirilmediyse gerçekleştirilir.

Yanıtlar

Name	Tür	Description
202 Accepted		Batch hizmetine yapılan istek başarılı oldu. Üst Bilgiler 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

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

Kapsamlar

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

Authorization

Tür: apiKey
İçinde: header

Örnekler

Pool delete

Örnek isteği

HTTP

DELETE account.region.batch.azure.com/pools/poolId?api-version=2023-11-01.18.0

Ö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 eklenen ek bilgilerden oluşan bir öğe.
ErrorMessage	Azure Batch hata yanıtında bir hata iletisi alındı.

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.

ErrorMessage

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

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