Hizmeti Çözümleme

Makale
08/05/2023

Service Fabric bölümünü çözün.

Hizmet çoğaltmalarının uç noktalarını almak için bir Service Fabric hizmet bölümünü çözün.

İstek

Yöntem	İstek URI'si
GET	`/Services/{serviceId}/$/ResolvePartition?api-version=6.0&PartitionKeyType={PartitionKeyType}&PartitionKeyValue={PartitionKeyValue}&PreviousRspVersion={PreviousRspVersion}&timeout={timeout}`

Parametreler

Ad	Tür	Gerekli	Konum
`serviceId`	string	Yes	Yol
`api-version`	string	Yes	Sorgu
`PartitionKeyType`	tamsayı	No	Sorgu
`PartitionKeyValue`	dize	No	Sorgu
`PreviousRspVersion`	dize	No	Sorgu
`timeout`	integer (int64)	No	Sorgu

`serviceId`

Tür: dize
Gerekli: Evet

Hizmetin kimliği. Bu kimlik genellikle 'fabric:' URI şeması olmayan hizmetin tam adıdır. Sürüm 6.0'dan başlayarak, hiyerarşik adlar "~" karakteriyle sınırlandırılır. Örneğin, hizmet adı "fabric:/myapp/app1/svc1" ise, hizmet kimliği 6.0+ sürümünde "myapp~app1~svc1" ve önceki sürümlerde "myapp/app1/svc1" olur.

`api-version`

Tür: dize
Gerekli: Evet
Varsayılan: 6.0

API'nin sürümü. Bu parametre gereklidir ve değeri '6.0' olmalıdır.

Service Fabric REST API sürümü, API'nin tanıtıldığı veya değiştirildiği çalışma zamanı sürümünü temel alır. Service Fabric çalışma zamanı API'nin birden fazla sürümünü destekler. Bu, API'nin desteklenen en son sürümüdür. Daha düşük bir API sürümü geçirilirse, döndürülen yanıt bu belirtimde belgelenen yanıttan farklı olabilir.

Ayrıca çalışma zamanı, çalışma zamanının geçerli sürümüne kadar desteklenen en son sürümden daha yüksek olan tüm sürümleri kabul edin. Bu nedenle, en son API sürümü 6.0 ise ancak çalışma zamanı 6.1 ise, istemcileri yazmayı kolaylaştırmak için çalışma zamanı bu API için sürüm 6.1'i kabul eder. Ancak API'nin davranışı, belgelenen 6.0 sürümüne göre olacaktır.

`PartitionKeyType`

Tür: tamsayı
Gerekli: Hayır

Bölüm için anahtar türü. Hizmetin bölüm düzeni Int64Range veya Named ise bu parametre gereklidir. Olası değerler aşağıdaki gibidir.

Hiçbiri (1) - PartitionKeyValue parametresinin belirtilmediğini gösterir. Bu, bölümleme şeması Singleton olan bölümler için geçerlidir. Varsayılan değer budur. Değer 1'dir.
Int64Range (2) - PartitionKeyValue parametresinin bir int64 bölüm anahtarı olduğunu gösterir. Bu, bölümleme şeması Int64Range olan bölümler için geçerlidir. Değer 2'dir.
Named (3) - PartitionKeyValue parametresinin bölümün adı olduğunu gösterir. Bu, bölümleme şeması Adlandırılmış olan bölümler için geçerlidir. Değer 3'dür.

`PartitionKeyValue`

Tür: dize
Gerekli: Hayır

Bölüm anahtarı. Hizmetin bölüm düzeni Int64Range veya Named ise bu gereklidir. Bu, bölüm kimliği değil, tamsayı anahtar değeri veya bölüm kimliğinin adıdır. Örneğin, hizmetiniz 0 ile 10 arasında aralıklı bölümler kullanıyorsa PartitionKeyValue bu aralıktaki bir tamsayı olacaktır. Aralığı veya adı görmek için sorgu hizmeti açıklaması.

`PreviousRspVersion`

Tür: dize
Gerekli: Hayır

Daha önce alınan yanıtın Sürüm alanındaki değer. Kullanıcı daha önce alınan sonucun eski olduğunu biliyorsa bu gereklidir.

`timeout`

Tür: tamsayı (int64)
Gerekli: Hayır
Varsayılan: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1

İşlemi saniyeler içinde gerçekleştirmek için sunucu zaman aşımı. Bu zaman aşımı, istemcinin istenen işlemin tamamlanmasını beklemeye istekli olduğu süreyi belirtir. Bu parametre için varsayılan değer 60 saniyedir.

Yanıtlar

HTTP Durum Kodu	Description	Yanıt Şeması
200 (Tamam)	Başarılı bir işlem 200 durum kodu döndürür.	ResolvedServicePartition
Diğer tüm durum kodları	Ayrıntılı hata yanıtı.	Doku Oluşturucu

Aracılığıyla paylaş