Aracılığıyla paylaş

az iot device c2d-message

  • Başvuru

Not

Bu başvuru, Azure CLI (sürüm 2.46.0 veya üzeri) için azure-iot uzantısının bir parçasıdır. Uzantı, az iot device c2d-message komutunu ilk kez çalıştırdığınızda otomatik olarak yüklenir. Uzantılar hakkında daha fazla bilgi edinin.

Buluttan cihaza mesajlaşma komutları.

Komutlar

Name Description Tür Durum
az iot device c2d-message abandon

Buluttan cihaza ileti bırakma.

 Dahili GA
az iot device c2d-message complete

Buluttan cihaza bir ileti tamamlayın.

 Dahili GA
az iot device c2d-message purge

Hedef cihaz için buluttan cihaza ileti kuyruğu temizleme.

 Dahili GA
az iot device c2d-message receive

Buluttan cihaza bir ileti alın.

 Dahili GA
az iot device c2d-message reject

Buluttan cihaza ileti reddetme veya yeniden oluşturma.

 Dahili GA
az iot device c2d-message send

Buluttan cihaza ileti gönderme.

 Dahili GA

az iot device c2d-message abandon

Buluttan cihaza ileti bırakma.

az iot device c2d-message abandon --device-id
                                  [--etag]
                                  [--hub-name]
                                  [--login]
                                  [--resource-group]

Gerekli Parametreler

--device-id -d

Hedef Cihaz Kimliği.

İsteğe Bağlı Parametreler

--etag -e

Kaynağın son durumuna karşılık gelen etag veya varlık etiketi. Etag sağlanmadıysa '*' değeri kullanılır.

--hub-name -n

IoT Hub adı veya ana bilgisayar adı. --login sağlanmadıysa gereklidir.

--login -l

Bu komut, eylem gerçekleştirme haklarına sahip bir varlık bağlantı dizesi destekler. "az login" aracılığıyla oturum açmaktan kaçınmak için kullanın. Hem varlık bağlantı dizesi hem de ad sağlanırsa, bağlantı dizesi öncelik alır. --hub-name sağlanmadıysa gereklidir.

--resource-group -g

Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>yapılandırabilirsiniz.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

Kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az iot device c2d-message complete

Buluttan cihaza bir ileti tamamlayın.

az iot device c2d-message complete --device-id
                                   [--etag]
                                   [--hub-name]
                                   [--login]
                                   [--resource-group]

Gerekli Parametreler

--device-id -d

Hedef Cihaz Kimliği.

İsteğe Bağlı Parametreler

--etag -e

Kaynağın son durumuna karşılık gelen etag veya varlık etiketi. Etag sağlanmadıysa '*' değeri kullanılır.

--hub-name -n

IoT Hub adı veya ana bilgisayar adı. --login sağlanmadıysa gereklidir.

--login -l

Bu komut, eylem gerçekleştirme haklarına sahip bir varlık bağlantı dizesi destekler. "az login" aracılığıyla oturum açmaktan kaçınmak için kullanın. Hem varlık bağlantı dizesi hem de ad sağlanırsa, bağlantı dizesi öncelik alır. --hub-name sağlanmadıysa gereklidir.

--resource-group -g

Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>yapılandırabilirsiniz.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

Kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az iot device c2d-message purge

Hedef cihaz için buluttan cihaza ileti kuyruğu temizleme.

az iot device c2d-message purge --device-id
                                [--hub-name]
                                [--login]
                                [--resource-group]

Gerekli Parametreler

--device-id -d

Hedef Cihaz Kimliği.

İsteğe Bağlı Parametreler

--hub-name -n

IoT Hub adı veya ana bilgisayar adı. --login sağlanmadıysa gereklidir.

--login -l

Bu komut, eylem gerçekleştirme haklarına sahip bir varlık bağlantı dizesi destekler. "az login" aracılığıyla oturum açmaktan kaçınmak için kullanın. Hem varlık bağlantı dizesi hem de ad sağlanırsa, bağlantı dizesi öncelik alır. --hub-name sağlanmadıysa gereklidir.

--resource-group -g

Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>yapılandırabilirsiniz.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

Kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az iot device c2d-message receive

Buluttan cihaza bir ileti alın.

Alınan ileti gövdesinin kodu yalnızca içerik kodlaması 'utf-8', 'utf-16' veya 'utf-32' olarak ayarlandığında çözülecektir. İçerik kodlaması yukarıdakilerden birine ayarlanmadığında veya içerik kodlama yukarıdakilerden birine ayarlandığında bile kodu çözülemediğinde ileti yükü {{kodu çözülemeyen yük}} olarak görüntülenir.

Not: [--complete, --reject, --abandon] tek bir ileti bağımsız değişkeni kabul edilir.

az iot device c2d-message receive --device-id
                                  [--abandon {false, true}]
                                  [--complete {false, true}]
                                  [--hub-name]
                                  [--lock-timeout]
                                  [--login]
                                  [--reject {false, true}]
                                  [--resource-group]

Örnekler

Temel kullanım

az iot device c2d-message receive -d {device_id} -n {hub_name} -g {resource_group}

bir ileti alın ve bu ileti için 30 saniyelik bir kilit zaman aşımı ayarlayın

az iot device c2d-message receive -d {device_id} -n {hub_name} -g {resource_group} --lt {30}

Bir ileti alın ve alındıktan sonra 'tamamlandı' olarak gönderin

az iot device c2d-message receive -d {device_id} -n {hub_name} -g {resource_group} --complete

Bir ileti alma ve alındıktan sonra reddetme

az iot device c2d-message receive -d {device_id} -n {hub_name} -g {resource_group} --reject

Gerekli Parametreler

--device-id -d

Hedef Cihaz Kimliği.

İsteğe Bağlı Parametreler

--abandon

Alındıktan sonra buluttan cihaza iletisini bırakın.

Kabul edilen değerler: false, true
Default value: False
--complete

Alındıktan sonra buluttan cihaza iletisini tamamlayın.

Kabul edilen değerler: false, true
Default value: False
--hub-name -n

IoT Hub adı veya ana bilgisayar adı. --login sağlanmadıysa gereklidir.

--lock-timeout --lt

İletinin diğer alma çağrıları için ne kadar süreyle görünmez olacağını belirtir.

Default value: 60
--login -l

Bu komut, eylem gerçekleştirme haklarına sahip bir varlık bağlantı dizesi destekler. "az login" aracılığıyla oturum açmaktan kaçınmak için kullanın. Hem varlık bağlantı dizesi hem de ad sağlanırsa, bağlantı dizesi öncelik alır. --hub-name sağlanmadıysa gereklidir.

--reject

Alındıktan sonra buluttan cihaza iletisini reddedin.

Kabul edilen değerler: false, true
Default value: False
--resource-group -g

Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>yapılandırabilirsiniz.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

Kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az iot device c2d-message reject

Buluttan cihaza ileti reddetme veya yeniden oluşturma.

az iot device c2d-message reject --device-id
                                 [--etag]
                                 [--hub-name]
                                 [--login]
                                 [--resource-group]

Gerekli Parametreler

--device-id -d

Hedef Cihaz Kimliği.

İsteğe Bağlı Parametreler

--etag -e

Kaynağın son durumuna karşılık gelen etag veya varlık etiketi. Etag sağlanmadıysa '*' değeri kullanılır.

--hub-name -n

IoT Hub adı veya ana bilgisayar adı. --login sağlanmadıysa gereklidir.

--login -l

Bu komut, eylem gerçekleştirme haklarına sahip bir varlık bağlantı dizesi destekler. "az login" aracılığıyla oturum açmaktan kaçınmak için kullanın. Hem varlık bağlantı dizesi hem de ad sağlanırsa, bağlantı dizesi öncelik alır. --hub-name sağlanmadıysa gereklidir.

--resource-group -g

Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>yapılandırabilirsiniz.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

Kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az iot device c2d-message send

Buluttan cihaza ileti gönderme.

Bu komut bağımlı Cython paketini (uamqp) ilk yürütmede kullanır ve yükleyebilir. https://github.com/Azure/azure-uamqp-python

Not: İçerik kodlama varsayılan olarak utf-8 olarak ayarlanır. komut, içerik kodlama özelliği utf-8, utf-16 veya utf-32 olduğunda ileti gövdesini kodlama eylemiyle gönderir. İçerik kodlama değeri bunlardan biri değilse, özellik kodlama eylemi yapılmadan gönderilmeye devam eder.

İkili ileti gövdesi gönderilirken, içerik bir dosyadan (aracılığıyla --data-file-path) sağlanmalıdır ve içerik türü olarak application/octet-streamayarlanmalıdır.

az iot device c2d-message send --device-id
                               [--ack {full, negative, positive}]
                               [--auth-type {key, login}]
                               [--ce]
                               [--cid]
                               [--content-type]
                               [--da]
                               [--data-file-path]
                               [--expiry]
                               [--hub-name]
                               [--login]
                               [--message-id]
                               [--properties]
                               [--repair {false, true}]
                               [--resource-group]
                               [--uid]
                               [--wait {false, true}]
                               [--yes {false, true}]

Örnekler

Varsayılan ileti gövdesi ile temel kullanım

az iot device c2d-message send -d {device_id} -n {iothub_name}

Özel veriler ve özelliklerle buluttan cihaza ileti gönderme.

az iot device c2d-message send -d {device_id} -n {iothub_name} --data 'Hello World' --props 'key0=value0;key1=value1'

C2D iletisi gönderin ve cihazın onaylanmasını bekleyin

az iot device c2d-message send -d {device_id} -n {iothub_name} --ack full --wait

Dosyadan ikili biçimde bir C2D iletisi gönderin.

az iot device c2d-message send -d {device_id} -n {iothub_name} --data-file-path {file_path} --content-type 'application/octet-stream'

Bir dosyadan JSON biçiminde bir C2D iletisi gönderin.

az iot device c2d-message send -d {device_id} -n {iothub_name} --data-file-path {file_path} --content-type 'application/json'

Gerekli Parametreler

--device-id -d

Hedef Cihaz Kimliği.

İsteğe Bağlı Parametreler

--ack

İletinin son durumuyla ilgili ileti başına geri bildirimin teslimini isteyin. ack değerlerinin açıklaması aşağıdaki gibidir. Pozitif: c2d iletisi Tamamlandı durumuna ulaşırsa IoT Hub bir geri bildirim iletisi oluşturur. Negatif: c2d iletisi Ölü harfli durumuna ulaşırsa IoT Hub bir geri bildirim iletisi oluşturur. Tam: IoT Hub her iki durumda da bir geri bildirim iletisi oluşturur. Varsayılan olarak, istekte bulunmaz.

Kabul edilen değerler: full, negative, positive
--auth-type

İşlemin bir ilke anahtarını otomatik olarak türetmesi mi yoksa geçerli Azure AD oturumunu mu kullanması gerektiğini gösterir. Kimlik doğrulama türü oturum açma bilgisiyse ve kaynak ana bilgisayar adı sağlanmışsa, gerekmedikçe kaynak araması atlanır. kullanarak varsayılanı az configure --defaults iothub-data-auth-type=<auth-type-value>yapılandırabilirsiniz.

Kabul edilen değerler: key, login
Default value: key
--ce --content-encoding

C2D ileti gövdesi için kodlama.

Default value: utf-8
--cid --correlation-id

C2D iletisiyle ilişkili bağıntı kimliği.

--content-type --ct

C2D ileti gövdesi için içerik türü.

--da --data

İleti gövdesi. Metin veya ham json sağlayın.

Default value: Ping from Az CLI IoT Extension
--data-file-path --dfp
Önizleme

İleti gövdesi yükü için dosyanın yolunu belirtin. Yükün ikili biçimde gönderilmesi gerektiğinde içerik türünü application/octet-stream olarak ayarlayın.

--expiry --expiry-time-utc

Unix dönemlerinden bu yana birimler milisaniyedir. Zaman belirtilmemişse varsayılan IoT Hub C2D iletisi TTL kullanılır.

--hub-name -n

IoT Hub adı veya ana bilgisayar adı. --login sağlanmadıysa gereklidir.

--login -l

Bu komut, eylem gerçekleştirme haklarına sahip bir varlık bağlantı dizesi destekler. "az login" aracılığıyla oturum açmaktan kaçınmak için kullanın. Hem varlık bağlantı dizesi hem de ad sağlanırsa, bağlantı dizesi öncelik alır. --hub-name sağlanmadıysa gereklidir.

--message-id --mid

C2D ileti kimliği. İleti kimliği sağlanmazsa bir UUID oluşturulur.

--properties --props -p

Anahtar-değer çiftlerinde şu biçime sahip ileti özelliği paketi: a=b; c=d.

--repair -r

Uzantı sürümüyle uyumlu uamqp bağımlılığını yeniden yükleyin. Varsayılan: false.

Kabul edilen değerler: false, true
Default value: False
--resource-group -g

Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>yapılandırabilirsiniz.

--uid --user-id

C2D iletisi, kullanıcı kimliği özelliği.

--wait -w

Ayarlanırsa, cihaz geri bildirimi alınana kadar c2d gönderme işlemi engellenir.

Kabul edilen değerler: false, true
Default value: False
--yes -y

Kullanıcı istemlerini atlayın. Eylemin kabul edilmesini gösterir. Öncelikle otomasyon senaryoları için kullanılır. Varsayılan: false.

Kabul edilen değerler: false, true
Default value: False
Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

Kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.