AttachDestination - IoT Platform - Alibaba Cloud Dokümantasyon Merkezi

Kullanım notları

Bu işlemi çağırmadan önce, veri hedefi oluşturmak için CreateDestination ve çözümleyici oluşturmak için CreateParser işlemlerini çağırın.

Saniye başı sorgu (QPS) sınırları

Her Alibaba Cloud hesabı saniyede en fazla 10 sorgu (QPS) gönderebilir.

Not

Bir Alibaba Cloud hesabının RAM kullanıcıları, söz konusu 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'ler için işlem örnek kodunu dinamik olarak oluşturur.

İstek parametreleri

Parametre	Tür	Gerekli	Örnek	Açıklama
Action	String	Evet	AttachDestination	Gerçekleştirmek istediğiniz işlem. Değeri AttachDestination olarak ayarlayın.
DestinationId	Long	Evet	1002	Veri hedefinin ID'si. Veri hedeflerini sorgulamak ve veri hedefinin ID'sini almak için ListDestination işlemini çağırabilirsiniz.
IsFailover	Boolean	Evet	false	Veri hedefinin hata işlemi verilerini iletip iletmeyeceğini belirtir. Hata işlemi verileri, diğer Alibaba Cloud hizmetlerine yönlendirilemeyen ve yeniden yönlendirilen verilerdir. true: hata işlemi verilerini iletir. false: hata işlemi verileri yerine normal verileri iletir. Varsayılan değer: false.
ParserId	Long	Evet	1000	Çözümleyicinin ID'si. Çözümleyicileri sorgulamak ve çözümleyicinin ID'sini almak için ListParser işlemini çağırabilirsiniz.
IotInstanceId	String	Hayır	iot-2w****	Örneğin ID'si. Örnek ID'sini IoT Platform konsolunun Overview sayfasında görüntüleyebilirsiniz. Önemli Örneğinizin bir ID'si varsa bu parametre için ID'yi belirtmeniz gerekir. Aksi takdirde çağrı başarısız olur. Örneğiniz için bir Overview sayfası veya ID oluşturulmadıysa bu parametreyi yapılandırmanız gerekmez. Daha fazla bilgi için bkz. Overview.

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

Yanıt parametreleri

Parametre	Tür	Örnek	Açıklama
Code	String	iot.system.SystemException	Çağrı başarısız olursa döndürülen hata kodu. Daha fazla bilgi için bkz. Hata kodları.
ErrorMessage	String	A system exception occurred.	Çağrı başarısız olursa döndürülen hata mesajı.
RequestId	String	E4C0FF92-2A86-41DB-92D3-73B60310D25E	İsteğin ID'si.
Success	Boolean	true	Çağrının başarılı olup olmadığını gösterir. true: Çağrı başarılı oldu. false: Çağrı başarısız oldu.

Örnekler

Örnek istekler

http(s)://iot.cn-shanghai.aliyuncs.com/?Action=AttachDestination
&DestinationId=1002
&IsFailover=false
&ParserId=1000
&<Common request parameters>

Başarılı yanıt örnekleri

XML biçimi

<AttachDestinationResponse>
  <RequestId>E4C0FF92-2A86-41DB-92D3-73B60310D25E</RequestId>
  <Success>true</Success>
</AttachDestinationResponse>

JSON biçimi

{
    "RequestId": "E4C0FF92-2A86-41DB-92D3-73B60310D25E",
    "Success": true
}

Hata kodları

HttpCode	Hata kodu	Hata mesajı	Açıklama
400	iot.system.IllegalRequest	The request parameter is invalid.	İstek parametresi geçersiz olduğu için döndürülen hata mesajı.
400	iot.system.SystemException	An internal error occurred. Try again later.	Sistem istisnası oluştuğu için döndürülen hata mesajı.
400	iot.rule.destinationNotExists	Destination not found	Belirtilen veri hedefi bulunamadığı için döndürülen hata mesajı.

Hata kodlarının listesi için API Hata Merkezi adresini ziyaret edin.