Cihaz SDK'ları, IoT Platform SDK'ları veya AMQP SDK'ları geliştirirken hedef örneğin uç noktası olarak erişim alan adını yapılandırmanız gerekir. Bu konuda, her örnek türü için uç nokta bilgilerinin nasıl alınacağı açıklanmaktadır.
Ön koşullar
SDK geliştirme kılavuzları için bkz. Cihaz tarafı SDK'ları, IoT Platform SDK ve AMQP istemcisini bağlama.
-
Örnek türlerinin karşılaştırması için bkz. Örneklere genel bakış.
Örnek
Bölge
Açıklama
Nasıl görüntülenir
Eski genel örnek
Çin (Şanghay), Japonya (Tokyo), Singapur, Almanya (Frankfurt), ABD (Silikon Vadisi) ve ABD (Virginia)
IoT Platform konsolundaki Overview sayfasında örnek ID için bir değer gösterilmez.
IoT Platform konsolunda Development Configurations paneli kullanılamaz. Uç nokta ayrıntıları için bkz. Eski genel örnekler için uç noktaları görüntüleme.
Genel örnek
-
IoT Platform konsolundaki Overview sayfasında örnek ID için bir değer gösterilir ve bir Instance Details sayfası kullanılabilir.
-
IoT Platform'u etkinleştirdiğinizde varsayılan olarak bir genel örnek oluşturulur.
Konsolda Development Configurations paneli kullanılabilir. Genel ve Enterprise Edition örnekleri için uç noktaları görüntüleyin.
Enterprise Edition örneği
Çin (Şanghay), Çin (Pekin), Çin (Shenzhen), Japonya (Tokyo), Singapur, Almanya (Frankfurt), ABD (Silikon Vadisi) ve ABD (Virginia)
-
Arka plan
-
Uç nokta türleri
Uç noktalar genel uç noktalar ve VPC uç noktaları olarak sınıflandırılır. VPC uç noktaları ağ gecikme süresini ve genel bant genişliği maliyetlerini azaltırken bağlantı güvenliğini ve kararlılığını artırır.
Cihazlar MQTT, CoAP veya HTTP üzerinden IoT Platform'a bağlanabilir. Premium Enterprise Edition örnekleri ayrıca VPC bağlantılarını destekler; bu sayede cihazlar MQTT VPC uç noktasını kullanabilir.
Bir VPC içindeki bir ECS örneğinden IoT Platform'a erişmek için AMQP sunucu tarafı abonelikleri ve IoT Platform API çağrıları için VPC uç noktalarını yapılandırın.
-
Örnek türleri
Çin (Şanghay), Çin (Pekin) ve Çin (Shenzhen) bölgelerindeki Standard ve Premium Enterprise Edition örnekleri, MQTT uç noktasına sabit bir IP adresi bağlamayı destekler.
Premium Enterprise Edition örneklerinde özel bir MQTT uç noktası manuel olarak oluşturulmalıdır. Bağlantı noktası numarasını ve sertifikayı da özelleştirebilirsiniz.
Eski genel örnekler için uç noktaları görüntüleyin
|
İletişim protokolü |
Uç nokta biçimi |
Bağlantı noktası |
|
MQTT |
|
1883 veya 443. WebSocket üzerinden MQTT için 443 bağlantı noktasını kullanın. |
|
CoAP |
|
|
|
HTTP |
Cihaz başına benzersiz sertifika: |
443. |
|
Ürün başına benzersiz sertifika için ön kayıt: Önemli
HTTPS üzerinden ürün başına benzersiz sertifika için ön kayıt yalnızca Çin (Şanghay) bölgesinde desteklenir. |
||
|
AMQP |
|
|
|
IoT Platform API |
İstek yapısı şu şekildedir: |
Uygulanamaz. |
|
ID² |
Yalnızca ve Japonya (Tokyo) bölgelerinde desteklenir. |
1883. |
Uç nokta URL'lerindeki aşağıdaki parametreleri değiştirin.
|
|
|
|
|
|
|
|
|
|
|
|
Genel ve Enterprise Edition örnekleri için uç noktaları görüntüleyin
IoT Platform konsoluna giriş yapın. Sayfanın sol üst köşesinde örneğinizin bulunduğu bölgeyi seçin.
Overview sayfasında örnek takma adına veya ID değerine tıklayın.
Instance Details sayfasının sağ üst köşesinde View Development Configurations seçeneğine tıklayın.
-
Development Configurations panelinde uç nokta bilgilerini görüntülemek için MQTT, CoAP, AMQP veya diğer protokol sekmelerine tıklayın. Alan adını kopyalamak için yanındaki Copy düğmesine tıklayın. Bağlantı noktasını görüntülemek için yardım simgesine
tıklayın. Bağlantı noktası ayrıntıları için bkz. Eski genel örnekler için uç noktaları görüntüleyin.ÖnemliPremium Enterprise Edition örnekleri için MQTT uç noktasını manuel olarak oluşturmanız gerekir. Premium Enterprise Edition örneği için özel bir MQTT uç noktası oluşturun.
-
HTTPS üzerinden cihaz bağlantıları için yalnızca cihaz başına benzersiz sertifika ve ön kayda dayalı ürün başına benzersiz sertifika yöntemleri desteklenir. Bu yöntemler farklı uç noktalar kullanır:
Cihaz başına benzersiz sertifika yöntemini kullanıyorsanız uç nokta HTTP sekmesinde gösterilir.
Ön kayda dayalı ürün başına benzersiz sertifika yöntemi yalnızca Çin (Şanghay) bölgesinde desteklenir. Uç nokta
iot-auth.cn-shanghai.aliyuncs.comşeklindedir.
Enterprise Edition örneğiniz için ID² kimlik doğrulamasını etkinleştirdiyseniz Development Configurations panelinin Manage ID² sekmesindeki ID² Authentication Address gösterilmez. Adres biçimi için bkz. Eski genel örnekler için uç noktaları görüntüleyin.
Development Configurations paneli Public Endpoint ve VPC Network Endpoint olmak üzere iki bölümden oluşur. Her bölümde desteklenen protokoller (MQTT, CoAP, HTTP, AMQP) için sekmeler bulunur. Bu sekmelerde uç nokta adreslerini, bağlantı noktalarını ve ilgili ayarları bulabilirsiniz. Örneğin, MQTT sekmesi uç nokta adresini, bağlantı noktasını ve Fixed IP bağlama durumunu gösterir.
Bir uç noktaya sabit IP adresi bağlayın
Bu özellik yalnızca Çin (Şanghay), Çin (Pekin) ve Çin (Shenzhen) bölgelerindeki Standard ve Premium Enterprise Edition örnekleri için kullanılabilir.
Sabit bir IP adresi, IoT Platform IP adreslerini ölçeklendirdiğinde DNS çözümlemesinin kararlı kalmasını sağlar. Veri planları belirli IP adresleriyle kısıtlanmış IoT SIM kartları kullanıyorsanız ve operatörünüz alan adı yapılandırmasını desteklemiyorsa sabit IP adresini operatörün IP izin listesine ekleyin.
Operatör veri merkezi taşıma gibi bazı durumlarda IP adresi değişebilir. Cihazınız bir uç nokta yerine sabit bir IP adresi kullanarak bağlanıyorsa buluttan cihaza komutlar veya bir OTA güncellemesi aracılığıyla yeni IP adresini cihaza iletmeniz gerekir. Aksi takdirde cihaz IoT Platform'a bağlanamaz.
Cihaz bağlantıları için bir uç nokta kullanmanızı öneririz. IoT Platform, IP adresi değişikliklerini önceden bildirir.
Bir örneğin genel MQTT uç noktasına sabit bir IP adresi bağlamak için:
-
Genel örnekler için MQTT bağlantıları amacıyla iki sabit IP adresi atayabilirsiniz.
Genel örneğin Instance Details sayfasının sağ üst köşesinde View Development Configurations seçeneğine tıklayın.
Development Configurations panelinde MQTT sekmesinde Fixed IP yanındaki Set düğmesine tıklayın.
Görüntülenen iletişim kutusunda iki sabit IP adresi almak için OK seçeneğine tıklayın.
MQTT bağlantıları için sabit IP adreslerine artık ihtiyaç duyulmuyorsa Unbind seçeneğine tıklayın.
Premium Enterprise Edition örnekleri için genel bir MQTT uç noktasını manuel olarak oluşturduğunuzda otomatik olarak bir sabit IP adresi atanır. Bağlantıyı kaldırma işlemi desteklenmez.
Premium Enterprise Edition örnekleri için özel bir MQTT uç noktası oluşturun
Premium Enterprise Edition örneği için bir MQTT uç noktası oluşturmak için:
Premium Enterprise Edition örneğinin Instance Details sayfasının sağ üst köşesinde View Development Configurations seçeneğine tıklayın.
Development Configurations panelinde MQTT sekmesinde Create düğmesine tıklayın.
-
Create Endpoint iletişim kutusunda uç nokta bilgilerini yapılandırın.
Parametre
Açıklama
Özel bağlantı noktası
MQTT bağlantıları için bağlantı noktası numarası. Varsayılan bağlantı noktası 1883'tür.
VPC'yi etkinleştir
-
Evet: VPC bağlantılarını etkinleştirir. VPC, vSwitch Zone, vSwitch ve güvenlik grubunu yapılandırın.
Bu işlem hem genel hem de VPC MQTT uç noktaları oluşturur.
ÖnemliVPC üzerinden bir MQTT uç noktasını etkinleştirmek için PrivateLink hizmetini etkinleştirin. PrivateLink etkinleştirilmemişse Enable seçeneğine tıklayarak VPC konsoluna gidin ve hizmeti etkinleştirin.
-
Hayır (Varsayılan): VPC bağlantılarını devre dışı bırakır.
Bu işlem yalnızca genel bir MQTT uç noktası oluşturur.
ÖnemliNo seçeneğini belirlerseniz bu uç nokta için daha sonra VPC bağlantılarını etkinleştiremezsiniz.
Yetkilendirme
VPC bağlantılarını etkinleştirirseniz yetkilendirme yapmanız gerekir.
Authorize seçeneğine tıklayın. Sistem, cihazların VPC üzerinden IoT Platform'a bağlanmasına izin vermek için bir rol ve yetkilendirme ilkesi oluşturur. Hizmet bağlantılı roller.
VPC
VPC bağlantılarını etkinleştirdikten ve yetkilendirmeyi tamamladıktan sonra bu parametreleri yapılandırın.
Mevcut bir VPC ve vSwitch seçin.
Yeni olanları oluşturmak için Create VPC veya Create vSwitch seçeneklerine tıklayabilirsiniz. VPC oluşturma ve vSwitch oluşturma.
vSwitch alanı
vSwitch
Güvenlik grubu
VPC bağlantılarını etkinleştirdikten ve yetkilendirmeyi tamamladıktan sonra bu parametreyi yapılandırın.
Mevcut bir güvenlik grubu seçin.
Bir tane oluşturmak için Create Security Group seçeneğine tıklayabilirsiniz. Güvenlik grubu oluşturma.
-
-
OK seçeneğine tıklayın.
Uç nokta oluşturulduktan sonra yeni uç nokta MQTT Device Connection altında görünür.
Premium Enterprise Edition örnekleri için MQTT sertifikasını özelleştirin
Premium Enterprise Edition örneğine MQTT bağlantıları için sertifikayı ve alan adını özelleştirmek için:
Aynı özel sertifika hem genel hem de VPC uç noktaları için kullanılır.
Premium Enterprise Edition örneğinin Instance Details sayfasının sağ üst köşesinde View Development Configurations seçeneğine tıklayın.
Development Configurations panelinde MQTT sekmesinde Custom Certificate altındaki Configure seçeneğine tıklayın.
-
Custom Certificate iletişim kutusunda Custom Configuration için On seçeneğine tıklayın.
NotCustom Configuration zaten etkinse bu adımı atlayın.
-
Sertifika yetkilinizden (CA) aldığınız PEM biçimli sertifika içeriğini ve özel anahtarı girin ardından OK seçeneğine tıklayın.
Uyarıİlk yapılandırmadan sonra sertifika içeriğini veya özel anahtarı güncellemek sertifika doğrulamasının başarısız olmasına neden olabilir. Bu durum cihazların IoT Platform ile bağlantısının kesilmesine ve hizmetlerin kesintiye uğramasına yol açar. Dikkatli ilerleyin.
Sayfa, sertifikanızdan ayrıştırılan özel alan adını gösterir. MQTT cihaz bağlantıları için bu alan adını kullanın.
ÖnemliÖzel alan adını örneğin varsayılan MQTT uç noktasına çözmek için alan adı sağlayıcınızla bir CNAME kaydı yapılandırın.