CreateOTAStaticUpgradeJob - IoT Platform - Alibaba Cloud Dokümantasyon Merkezi

Kullanım notları

CreateOTAFirmware işlemiyle bir güncelleme paketinin doğrulanmasına gerek olmadığını belirtirseniz, CreateOTAStaticUpgradeJob işlemiyle bir güncelleme toplu işi oluşturmadan önce güncelleme paketinin doğrulandığından emin olun. Güncelleme paketini doğrulamak için görev oluşturma hakkında daha fazla bilgi için bkz. CreateOTAVerifyJob.
Her çağrıda en fazla 200 cihaz için güncelleme görevi başlatabilirsiniz. Bir cihaz listesi dosyası kullanırsanız en fazla 1.000.000 cihaz için güncelleme görevi başlatabilirsiniz. Ancak öncelikle GenerateDeviceNameListURL işlemini çağırarak cihaz listesi dosyası için bir URL oluşturmanız gerekir. Ardından ekrandaki yönergeleri izleyerek cihaz listesi dosyasını yükleyebilirsiniz.
Birden çok cihaz için güncelleme görevi başlattığınızda, hedef yazılım sürümüne zaten sahip olan cihazlar atlanır.
Bir cihaz aynı anda yalnızca bir güncelleme görevinde bekleyen veya güncelleniyor durumunda olabilir. Bekleyen veya güncelleniyor durumundaki bir cihaz için başka bir güncelleme görevi başlatırsanız görev başarısız olur.
Tek bir güncelleme paketi kullanarak birden çok statik güncelleme toplu işi oluşturabilirsiniz.
MQTT protokolü üzerinden güncelleme paketlerinin indirilmesi yalnızca Çin (Şanghay), Çin (Pekin) ve Çin (Shenzhen) bölgelerinde desteklenir.

、华北2（北京）和华南1（深圳）

Sınırlamalar

Her Alibaba Cloud hesabı saniyede en fazla 20 sorgu (QPS) çalıştırabilir.

Not

Bir Alibaba Cloud hesabının RAM kullanıcıları, hesabın kotasını paylaşır.

Hata ayıklama

OpenAPI Explorer, imza değerini otomatik olarak hesaplar. Kolaylık sağlaması açısından bu işlemi OpenAPI Explorer üzerinden çağırmanızı öneririz. OpenAPI Explorer, farklı SDK'lar için işlem örnek kodlarını dinamik olarak oluşturur.

İstek parametreleri

Parametre	Tür	Zorunlu	Örnek	Açıklama
Action	String	Evet	CreateOTAStaticUpgradeJob	Gerçekleştirmek istediğiniz işlem. Değeri CreateOTAStaticUpgradeJob olarak ayarlayın.
FirmwareId	String	Evet	nx3xxVvFdwvn6dim50PY03****	Güncelleme paketinin ID değeri. Güncelleme paketi ID değeri, paketi oluşturmak için CreateOTAFirmware işlemini çağırdığınızda döndürülür. ID değerini almak için ListOTAFirmware işlemini de kullanabilirsiniz.
ProductKey	String	Evet	a1Le6d0****	Güncelleme paketinin ait olduğu ürünün ProductKey değeri. ProductKey, IoT Platform'da bir ürünün benzersiz tanımlayıcısıdır. Mevcut Alibaba Cloud hesabınız kapsamındaki tüm ürünlerin bilgilerini IoT Platform konsolunda görüntüleyebilir veya QueryProductList işlemiyle listeleyebilirsiniz.
Tag.N.Key	String	Evet	key1	Güncelleme toplu işi etiketinin anahtarı. Anahtar 1 ila 30 karakter uzunluğunda olmalı ve harf, rakam ile nokta (.) içerebilir. Her güncelleme toplu işine en fazla 10 etiket ekleyebilirsiniz. IoT Platform güncelleme bildirimlerini cihazlara ittiğinde, güncelleme toplu işi etiketleri de cihazlara gönderilir. Not Güncelleme toplu işi etiketleri isteğe bağlıdır. Bir etiket belirtmek istiyorsanız Tag.N.Value ve Tag.N.Key parametrelerini çift halinde belirtmelisiniz.
Tag.N.Value	String	Evet	value1	Güncelleme toplu işi etiketinin değeri. Değer 1 ila 1.024 karakter uzunluğunda olmalıdır. Her güncelleme toplu işine en fazla 10 etiket ekleyebilirsiniz. Tüm güncelleme toplu işlerinin etiket anahtarlarının ve değerlerinin toplam uzunluğu 4.096 karakteri aşamaz. Not Güncelleme toplu işi etiketleri isteğe bağlıdır. Bir etiket belirtmek istiyorsanız Tag.N.Value ve Tag.N.Key parametrelerini çift halinde belirtmelisiniz.
TargetSelection	String	Evet	ALL	Güncelleme toplu işinin kapsamı. Geçerli değerler: ALL: Tüm cihazları günceller. SPECIFIC: Belirtilen cihazları günceller. GRAY: Aşamalı güncelleme gerçekleştirir. GROUP: Belirtilen grupları günceller.
IotInstanceId	String	Hayır	iot-cn-0pp1n8t****	Örneğin ID değeri. Örnek ID değerini IoT Platform konsolundaki Overview sayfasında görüntüleyebilirsiniz. Önemli Örneğinizin bir ID değeri varsa bu parametre için ID değerini belirtmeniz gerekir. Örnek ID değeri belirtilmezse çağrı başarısız olur. Örneğiniz için Overview sayfası veya ID oluşturulmamışsa bu parametreyi yapılandırmanıza gerek yoktur. Daha fazla bilgi için bkz. Overview.
SrcVersion.N	RepeatList	Hayır	V1.0.1	Güncellenecek yazılım sürümlerinin listesi. Not Bu parametre, TargetSelection parametresi `ALL` veya `GRAY` olarak ayarlandığında kullanılabilir. Tam güncelleme veya aşamalı güncelleme gerçekleştirmek için diferansiyel bir güncelleme paketi kullanıyorsanız bu parametrenin değeri SrcVersion parametresinin değeriyle aynı olmalıdır. TargetSelection parametresi `SPECIFIC` veya `GROUP` olarak ayarlandığında bu parametre kullanılamaz. QueryDeviceDetail işlemini çağırabilir ve yanıtta FirmwareVersion parametresini görüntüleyebilirsiniz. Sürüm numaraları listede benzersiz olmalıdır. En fazla 10 sürüm numarası belirtebilirsiniz.
ScheduleTime	Long	Hayır	1577808000000	Kablosuz (OTA) güncellemeyi başlatma zamanı. Zamanlanmış süre, mevcut zamandan 5 dakika ila 7 gün sonra arasında olmalıdır. Değer 13 basamaklı bir zaman damgası olmalıdır. Bu parametreyi belirtmezseniz güncelleme hemen başlar.
RetryInterval	Integer	Hayır	60	Bir cihaz güncellenemediğinde uygulanacak otomatik yeniden deneme aralığı. Birim: dakika. Geçerli değerler: 0: Otomatik yeniden deneme hemen yapılır. 10: Otomatik yeniden deneme 10 dakika sonra yapılır. 30: Otomatik yeniden deneme 30 dakika sonra yapılır. 60: Otomatik yeniden deneme 60 dakika (1 saat) sonra yapılır. 1440: Otomatik yeniden deneme 1.440 dakika (24 saat) sonra yapılır. Önemli RetryInterval parametresinin değeri TimeoutInMinutes parametresinin değerinden küçük olmalıdır. Örnekler: TimeoutInMinutes parametresinin değeri 60 ise RetryInterval parametresinin maksimum değeri 30 olur. TimeoutInMinutes parametresinin değeri 1440 ise RetryInterval parametresinin maksimum değeri 60 olur. RetryInterval parametresinin değeri 1440 ise TimeoutInMinutes parametresini belirtmemenizi öneririz. Bir güncelleme zaman aşımına uğrarsa yeniden deneme yapılmaz. Bu parametreyi belirtmezseniz yeniden deneme yapılmaz.
RetryCount	Integer	Hayır	1	Otomatik yeniden deneme sayısı. RetryInterval parametresini belirtirseniz bu parametreyi de belirtmelisiniz. Geçerli değerler: 1: Bir kez yeniden dener. 2: İki kez yeniden dener. 5: Beş kez yeniden dener.
TimeoutInMinutes	Integer	Hayır	1440	Güncelleme için zaman aşımı süresi. Cihaz belirtilen süre içinde güncellenmezse zaman aşımı hatası oluşur. Birim: dakika. Geçerli değerler: 1 ila 1440. Not Zaman aşımı süresi, belirtilen cihazın güncelleme ilerlemesini ilk kez gönderdiği andan itibaren başlar. Güncelleme sırasında, cihazın defalarca çevrimiçi ve çevrimdışı olması nedeniyle güncelleme paketi belirtilen cihaza tekrar tekrar itilebilir. Güncelleme süresinin başlangıç zamanı değişmez. Bir güncelleme zaman aşımı nedeniyle başarısız olursa yeniden deneme tetiklenmez. Bu parametreyi belirtmezseniz zaman aşımı hataları oluşmaz.
MaximumPerMinute	Integer	Hayır	1000	Güncelleme paketinin indirme URL'sinin dakika başında itildiği maksimum cihaz sayısı. Geçerli değerler: 10 ila 10000. Varsayılan değer: 10000.
GrayPercent	String	Hayır	33,33	Aşamalı güncelleme oranı. Değer, string formatında bir yüzde ifadesidir. En fazla üç ondalık basamak içerebilir. Hesaplanan cihaz sayısı aşağıya doğru en yakın tam sayıya yuvarlanır. Aşamalı güncelleme için en az bir cihaz belirtmeniz gerekir. Örneğin, 100 cihaz için aşamalı güncelleme oranını %33,33 olarak ayarlarsanız güncellenecek cihaz sayısı 33 olur. TargetSelection parametresini `GRAY` olarak ayarlarsanız bu parametreyi belirtmelisiniz.
TargetDeviceName.N	RepeatList	Hayır	deviceName1	Cihaz adlarının listesi. Not TargetSelection parametresini `SPECIFIC` olarak ayarlarsanız bu parametreyi veya DnListFileUrl parametresini belirtmelisiniz. İki parametreyi aynı anda belirtemezsiniz. Belirli bir güncelleme gerçekleştirmek için diferansiyel bir güncelleme paketi kullanıyorsanız, güncellenecek cihazın OTA modül sürümü SrcVersion parametresinin değeriyle aynı olmalıdır. QueryDeviceDetail işlemini çağırabilir ve yanıtta FirmwareVersion parametresini görüntüleyebilirsiniz. Listedeki cihazlar, güncelleme paketiyle aynı ürüne ait olmalıdır. Cihaz adları listede benzersiz olmalıdır. Liste en fazla 200 cihaz adı içerebilir.
ScheduleFinishTime	Long	Hayır	1577909000000	Güncellemeyi sonlandırma zamanı. Bitiş zamanı, ScheduleTime parametresiyle belirtilen başlangıç zamanından 1 saat ila 30 gün sonra olmalıdır. Değer 13 basamaklı bir zaman damgası olmalıdır. Bu parametreyi belirtmezseniz güncelleme zorla sonlandırılmaz.
OverwriteMode	Integer	Hayır	1	Önceki güncelleme görevinin üzerine yazılıp yazılmayacağını belirtir. Varsayılan değer: 1. Geçerli değerler: 1: Önceki güncelleme görevinin üzerine yazılmaz. Bir cihazda zaten bir güncelleme görevi varsa önceki güncelleme görevi uygulanır. 2: Önceki güncelleme görevinin üzerine yazılır. Yalnızca mevcut güncelleme görevi uygulanır. Bu durumda MultiModuleMode değerini true olarak ayarlayamazsınız. Not Devam eden güncelleme görevinin üzerine yazılmaz.
DnListFileUrl	String	Hayır	https://iotx-ota.oss-cn-shanghai.aliyuncs.com/ota/65dfcda0473be29836dfde585472**/ck2nfzljo00023g7kysg0**.bin	Belirli bir güncelleme gerçekleştirmek için kullanılan cihaz listesi dosyasının URL değeri. Not TargetSelection parametresini `SPECIFIC` olarak ayarlarsanız bu parametreyi veya TargetDeviceName.N parametresini belirtmelisiniz. İki parametreyi aynı anda belirtemezsiniz. GenerateDeviceNameListURL işlemini çağırarak bir dosya URL'si oluşturabilirsiniz. Ardından ekrandaki yönergeleri izleyerek cihaz listesi dosyasını yükleyebilirsiniz. Tam güncelleme sırasında, güncellenmiş cihazlar atlanır. Delta güncelleme sırasında, güncellenmiş cihazlar ve ilk sürüm numaraları güncelleme paketinden farklı olan cihazlar atlanır.
NeedPush	Boolean	Hayır	true	Güncelleme görevlerinin IoT Platform'dan cihazlara otomatik olarak itilip itilmeyeceğini belirtir. Varsayılan değer: true. Geçerli değerler: true: Bir güncelleme toplu işi oluşturulduktan sonra IoT Platform, güncelleme görevlerini belirtilen çevrimiçi cihazlara otomatik olarak iter. Bu durumda bir cihaz, IoT Platform'dan kablosuz (OTA) güncelleme görevi bilgilerini almak için yine de bir istek başlatabilir. false: Bir cihaz, IoT Platform'dan OTA güncelleme görevi bilgilerini almak için bir istek başlatmalıdır.
NeedConfirm	Boolean	Hayır	false	Güncellemenin bir mobil uygulama kullanılarak kontrol edilip edilmeyeceğini belirtir. Mobil uygulamayı ihtiyaca göre geliştirmeniz gerekir. Varsayılan false: true. Geçerli değerler: false: Bir cihaz, NeedPush parametresine göre OTA güncelleme görevi bilgilerini alır. true: Bir cihazda OTA güncellemesi gerçekleştirmek için güncellemeyi mobil uygulamanız kullanarak onaylamanız gerekir. Ardından cihaz, NeedPush parametresine göre OTA güncelleme görevi bilgilerini alabilir.
GroupId	String	Hayır	CtjzCkNuOx***	Grubun ID değeri. TargetSelection parametresini `GROUP` olarak ayarlarsanız bu parametreyi ve GroupType parametresini belirtmelisiniz. GroupId parametresini sorgulamak için QueryDeviceGroupList işlemini kullanabilirsiniz.
GroupType	String	Hayır	LINK_PLATFORM	Grubun türü. Geçerli değer: LINK_PLATFORM. TargetSelection parametresini `GROUP` olarak ayarlarsanız bu parametreyi ve GroupId parametresini belirtmelisiniz.
DownloadProtocol	String	Hayır	HTTPS	Güncelleme paketinin indirme protokolü. Geçerli değerler: HTTPS ve MQTT. Varsayılan değer: HTTPS. Cihaz, IoT Platform tarafından itilen güncelleme paketi bilgilerini aldıktan sonra güncelleme paketini indirmek için bu protokolü kullanır. Önemli Güncelleme paketini MQTT üzerinden indirmeniz gerekiyorsa aşağıdaki hususlara dikkat edin: Hizmetiniz Çin (Şanghay), Çin (Pekin) veya Çin (Shenzhen) bölgesinde dağıtılmalıdır. OTA güncelleme paketi yalnızca bir dosya içerebilir ve dosyanın boyutu 16 MB'ı aşamaz. OTA güncellemeleri gerçekleştirmek ve dosyaları MQTT üzerinden indirmek için cihaz özelliklerini geliştirmek amacıyla C için Link SDK'nın en son sürümünü kullanmanız gerekir. Daha fazla bilgi için bkz. Sample code.
MultiModuleMode	Boolean	Hayır	false	Cihazın birden çok modülün eşzamanlı güncellemelerini destekleyip desteklemediğini belirtir. Varsayılan değer: false. Geçerli değerler: false true: Bu durumda OverwriteMode değerini 2 olarak ayarlamayın. Aynı modüle ait güncelleme görevlerinin üzerine yazılır. Devam eden güncelleme görevlerinin üzerine yazılmaz. Modüllerin güncelleme görevleri birbirini etkilemez. Önemli Yalnızca Enterprise Edition örnekleri ve yeni genel örnekler desteklenir. Cihazı geliştirmek için C için Link SDK 4.x sürümünü kullanmanız gerekir. Daha fazla bilgi için bkz. Overview.

Yukarıdaki işleme özel istek parametrelerine ek olarak, bu işlemi çağırırken ortak istek parametrelerini de belirtmeniz gerekir. Daha fazla bilgi için bkz. Common parameters.

Yanıt parametreleri

Parametre	Tür	Örnek	Açıklama
Code	String	MissingFirmwareId	Çağrı başarısız olursa döndürülen hata kodu. Daha fazla bilgi için bkz. Error codes.
Data	Struct		Çağrı başarılı olursa döndürülen güncelleme toplu işi bilgileri. Daha fazla bilgi için bkz. Data.
JobId	String	wahVIzGkCMuAUE2gDERM02****	Güncelleme toplu işinin benzersiz tanımlayıcısı.
UtcCreate	String	2019-11-04T06:22:19.566Z	Güncelleme toplu işinin oluşturulma zamanı. Zaman UTC olarak gösterilir.
ErrorMessage	String	FirmwareId is mandatory for this action.	Çağrı başarısız olursa döndürülen hata mesajı.
RequestId	String	29EC7245-0FA4-4BB6-B4F5-5F04818FDFB1	İsteğin ID değeri.
Success	Boolean	true	Çağrının başarılı olup olmadığını gösterir. Geçerli değerler: true: İstek başarılı oldu. false: İstek başarısız oldu.

Örnekler

Örnek istekler

http(s)://iot.cn-shanghai.aliyuncs.com/?Action=CreateOTAStaticUpgradeJob
&FirmwareId=nx3xxVvFdwvn6dim50PY03****
&ProductKey=a1Le6d0****
&Tag.1.Key=key1
&Tag.1.Value=value1
&TargetSelection=ALL
&MaximumPerMinute=1000
&RetryCount=1
&RetryInterval=60
&TimeoutInMinutes=1440
&SrcVersion.1=V1.0.1
&<Common request parameters>

Örnek başarılı yanıtlar

XML formatı

<CreateOTAStaticUpgradeJobResponse>
   <Data>
       <JobId>wahVIzGkCMuAUE2gDERM02****</JobId>
       <UtcCreate>2019-11-04T06:22:19.566Z</UtcCreate>
   </Data>
   <RequestId>29EC7245-0FA4-4BB6-B4F5-5F04818FDFB1</RequestId>
   <Success>true</Success>
</CreateOTAStaticUpgradeJobResponse>

JSON formatı

{
  "Data": {
    "JobId": "wahVIzGkCMuAUE2gDERM02****",
    "UtcCreate": "2019-11-04T06:22:19.566Z"
  },
  "RequestId": "29EC7245-0FA4-4BB6-B4F5-5F04818FDFB1",
  "Success": true
}

Hata kodları

Hata kodlarının listesi için bkz. IoT Platform hata kodları.