az iot device c2d-message

Dekont

Bu başvuru, Azure CLI (sürüm 2.37.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

varsayılan değer: 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

varsayılan değer: 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

varsayılan değer: 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

varsayılan değer: False

--complete

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

kabul edilen değerler: false, true

varsayılan değer: 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.

varsayılan değer: 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

varsayılan değer: 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

varsayılan değer: 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

varsayılan değer: 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

varsayılan değer: key

--ce --content-encoding

C2D ileti gövdesi için kodlama.

varsayılan değer: 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.

varsayılan değer: 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

varsayılan değer: 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

varsayılan değer: 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

varsayılan değer: 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

varsayılan değer: 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.