az iot ops asset

Vista previa
Referencia

Nota:

Esta referencia forma parte de la extensión azure-iot-ops para la CLI de Azure (versión 2.53.0 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az iot ops asset . Obtenga más información sobre las extensiones.

El grupo de comandos "iot ops" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Administrar recursos.

Comandos

Nombre	Description	Tipo	Estado
az iot ops asset create	Cree un recurso.	Extensión	Vista previa
az iot ops asset data-point	Administrar puntos de datos en un recurso.	Extensión	Vista previa
az iot ops asset data-point add	Agregue un punto de datos a un recurso.	Extensión	Vista previa
az iot ops asset data-point export	Exportar puntos de datos en un recurso.	Extensión	Vista previa
az iot ops asset data-point import	Importe puntos de datos en un recurso.	Extensión	Vista previa
az iot ops asset data-point list	Enumere los puntos de datos de un recurso.	Extensión	Vista previa
az iot ops asset data-point remove	Quite un punto de datos de un recurso.	Extensión	Vista previa
az iot ops asset delete	Eliminar un recurso.	Extensión	Vista previa
az iot ops asset endpoint	Administrar perfiles de punto de conexión de recursos.	Extensión	Vista previa
az iot ops asset endpoint certificate	Administrar certificados propiedad en un punto de conexión de recurso.	Extensión	Vista previa
az iot ops asset endpoint certificate add	Agregue un certificado propiedad a un punto de conexión de recurso.	Extensión	Vista previa
az iot ops asset endpoint certificate list	Enumera los certificados propiedad de un punto de conexión de recurso.	Extensión	Vista previa
az iot ops asset endpoint certificate remove	Quite un certificado de propiedad en un punto de conexión de recurso.	Extensión	Vista previa
az iot ops asset endpoint create	Cree un punto de conexión de recurso.	Extensión	Vista previa
az iot ops asset endpoint delete	Elimine un punto de conexión de recurso.	Extensión	Vista previa
az iot ops asset endpoint query	Consulte Resource Graph para los puntos de conexión de recursos.	Extensión	Vista previa
az iot ops asset endpoint show	Mostrar un punto de conexión de recurso.	Extensión	Vista previa
az iot ops asset endpoint update	Actualice un punto de conexión de recurso.	Extensión	Vista previa
az iot ops asset event	Administrar eventos en un recurso.	Extensión	Vista previa
az iot ops asset event add	Agregue un evento a un recurso.	Extensión	Vista previa
az iot ops asset event export	Exportar eventos en un recurso.	Extensión	Vista previa
az iot ops asset event import	Importar eventos en un recurso.	Extensión	Vista previa
az iot ops asset event list	Enumerar eventos en un recurso.	Extensión	Vista previa
az iot ops asset event remove	Quite un evento en un recurso.	Extensión	Vista previa
az iot ops asset query	Consulte resource Graph para los recursos.	Extensión	Vista previa
az iot ops asset show	Mostrar un recurso.	Extensión	Vista previa
az iot ops asset update	Actualice un recurso.	Extensión	Vista previa

az iot ops asset create

Vista previa

El grupo de comandos "iot ops" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Cree un recurso.

Debe proporcionarse la ubicación personalizada o el nombre del clúster. Este comando comprobará la existencia de la ubicación personalizada y el clúster asociados y garantizará que ambas estén configuradas correctamente con la extensión microsoft.deviceregistry.assets.

Se debe definir al menos un punto de datos o evento durante la creación de recursos. Para obtener ejemplos de formatos de archivo, consulte aka.ms/aziotops-assets.

az iot ops asset create --endpoint
                        --name
                        --resource-group
                        [--asset-type]
                        [--attr]
                        [--cg]
                        [--cl]
                        [--clg]
                        [--cls]
                        [--cluster]
                        [--cluster-subscription]
                        [--data]
                        [--data-file]
                        [--data-publish-int]
                        [--data-queue-size]
                        [--data-sample-int]
                        [--description]
                        [--disable {false, true}]
                        [--display-name]
                        [--documentation-uri]
                        [--eai]
                        [--ef]
                        [--epi]
                        [--eqs]
                        [--esi]
                        [--event]
                        [--hardware-revision]
                        [--location]
                        [--manufacturer]
                        [--manufacturer-uri]
                        [--model]
                        [--pc]
                        [--serial-number]
                        [--software-revision]
                        [--tags]

Ejemplos

Cree un recurso mediante la ubicación personalizada especificada.

az iot ops asset create --name {asset_name} -g {resource_group} --custom-location {custom_location} --endpoint {endpoint} --data data_source={data_source}

Cree un recurso mediante la ubicación personalizada y el grupo de recursos especificados para la ubicación personalizada. El grupo de recursos debe incluirse si hay varias ubicaciones personalizadas con el mismo nombre dentro de una suscripción.

az iot ops asset create --name {asset_name} -g {resource_group} --custom-location {custom_location} --custom-location-resource-group {custom_location_resource_group} --endpoint {endpoint} --data data_source={data_source}

Cree un recurso con el nombre de clúster especificado. El grupo de recursos debe incluirse si hay varios clústeres con el mismo nombre dentro de una suscripción.

az iot ops asset create --name {asset_name} -g {resource_group} --cluster {cluster} --cluster-resource-group {cluster_resource_group} --endpoint {endpoint} --event event_notifier={event_notifier}

Cree un recurso con el nombre de clúster y la ubicación personalizada especificados.

az iot ops asset create --name {asset_name} -g {resource_group} --cluster {cluster} --custom-location {custom_location} --endpoint {endpoint} --event event_notifier={event_notifier}

Cree un recurso con los valores predeterminados de evento y punto de datos personalizados.

az iot ops asset create --name {asset_name} -g {resource_group} --custom-location {custom_location} --endpoint {endpoint} --data-publish-int {data_point_publishing_interval} --data-queue-size {data_point_queue_size} --data-sample-int {data_point_sampling_interval} --event-publish-int {event_publishing_interval} --event-queue-size {event_queue_size} --event-sample-int {event_sampling_interval} --event event_notifier={event_notifier}

Cree un recurso con atributos personalizados adicionales.

az iot ops asset create --name {asset_name} -g {resource_group} --custom-location {custom_location} --endpoint {endpoint} --custom-attribute {attribute_key}={attribute_value} --custom-attribute {attribute_key}={attribute_value}

Cree un recurso con tipo de recurso personalizado, descripción, uri de documentación, identificador de recurso externo, revisión de hardware, código de producto y revisión de software.

az iot ops asset create --name {asset_name} -g {resource_group} --custom-location {custom_location} --endpoint {endpoint} --asset-type {asset_type} --description {description} --documentation-uri {documentation_uri} --external-asset-id {external_asset_id} --hardware-revision {hardware_revision} --product-code {product_code} --software-revision {software_revision} --data data_source={data_source}

Cree un recurso con dos eventos, fabricante, URI de fabricante, modelo, número de serie.

az iot ops asset create --name {asset_name} -g {resource_group} --custom-location {custom_location} --endpoint {endpoint} --event capability_id={capability_id} event_notifier={event_notifier} name={name} observability_mode={observability_mode} sampling_interval={sampling_interval} queue_size={queue_size} --event event_notifier={event_notifier} --manufacturer {manufacturer} --manufacturer-uri {manufacturer_uri} --model {model} --serial-number {serial_number}

Cree un recurso deshabilitado con dos puntos de datos.

az iot ops asset create --name {asset_name} -g {resource_group} --custom-location {custom_location} --endpoint {endpoint} --disable --data capability_id={capability_id} data_source={data_source} name={name} observability_mode={observability_mode} sampling_interval={sampling_interval} queue_size={queue_size} --data data_source={data_source}

Cree un recurso mediante un archivo que contenga puntos de datos y otro archivo que contenga eventos.

az iot ops asset create --name MyAsset -g MyRg --custom-location MyLocation --endpoint exampleEndpoint --data-file /path/to/myasset_datapoints.json --event-file /path/to/myasset_events.csv

Cree un recurso con los valores rellenados previamente especificados.

az iot ops asset create --name MyAsset -g MyRg --custom-location MyLocation --endpoint exampleEndpoint --data capability_id=myTagId data_source=NodeID1 name=myTagName1 observability_mode=counter sampling_interval=10 queue_size=2 --data data_source=NodeID2 --data-publish-int 1000 --data-queue-size 1 --data-sample-int 30 --asset-type customAsset --description 'Description for a test asset.' --documentation-uri www.help.com --external-asset-id 000-000-0000 --hardware-revision 10.0 --product-code XXX100 --software-revision 0.1 --manufacturer Contoso --manufacturer-uri constoso.com --model AssetModel --serial-number 000-000-ABC10 --custom-attribute work_location=factory

Parámetros requeridos

--endpoint

Nombre del punto de conexión del recurso.

--name -n

Nombre del recurso.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--asset-type --at

Tipo de recurso.

--attr --custom-attribute

Pares clave=valor separados por espacios correspondientes a atributos personalizados adicionales para el recurso.

--cg --cluster-resource-group

Grupo de recursos para el clúster.

--cl --custom-location

Ubicación personalizada que se usa para asociar un recurso al clúster.

--clg --custom-location-resource-group

Grupo de recursos para la ubicación personalizada.

--cls --custom-location-subscription

Identificador de suscripción para la ubicación personalizada. Si no se proporciona, se usará el identificador de suscripción de recurso.

--cluster -c

Clúster al que se va a asociar el recurso.

--cluster-subscription --cs

Identificador de suscripción para el clúster. Si no se proporciona, se usará el identificador de suscripción de recurso.

--data

Pares clave=valor separados por espacios correspondientes a las propiedades del punto de datos que se va a crear. Se admiten los siguientes valores de clave: capability_id, data_source (obligatorio), name, observability_mode (none, gauge, counter, histogram o log), sampling_interval (int), queue_size (int). --data se puede usar 1 o más veces. Revise los ejemplos de ayuda para ver el uso completo de parámetros.

--data-file --df

Ruta de acceso del archivo que contiene los puntos de datos. Se admiten los siguientes tipos de archivo: csv, json, portal-csv, yaml.

--data-publish-int --dpi

Intervalo de publicación predeterminado para puntos de datos.

Valor predeterminado: 1000

--data-queue-size --dqs

Tamaño de cola predeterminado para puntos de datos.

Valor predeterminado: 1

--data-sample-int --dsi

Intervalo de muestreo predeterminado (en milisegundos) para los puntos de datos.

Valor predeterminado: 500

--description -d

Descripción.

--disable

Deshabilite un recurso.

Valores aceptados: false, true

Valor predeterminado: False

--display-name --dn

Nombre para mostrar.

--documentation-uri --du

URI de documentación.

--eai --external-asset-id

Id. de recurso externo.

--ef --event-file

Ruta de acceso del archivo que contiene los eventos. Se admiten los siguientes tipos de archivo: csv, json, portal-csv, yaml.

--epi --event-publish-int

Intervalo de publicación predeterminado para eventos.

Valor predeterminado: 1000

--eqs --event-queue-size

Tamaño de cola predeterminado para eventos.

Valor predeterminado: 1

--esi --event-sample-int

Intervalo de muestreo predeterminado (en milisegundos) para eventos.

Valor predeterminado: 500

--event

Pares clave=valor separados por espacios correspondientes a las propiedades del evento que se van a crear. Se admiten los siguientes valores de clave: capability_id, event_notifier (obligatorio), name, observability_mode (none o log), sampling_interval (int), queue_size (int). --event se puede usar 1 o más veces. Revise los ejemplos de ayuda para ver el uso completo de parámetros.

--hardware-revision --hr

Revisión de hardware.

--location -l

Ubicación. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.

--manufacturer

Fabricante.

--manufacturer-uri --mu

URI del fabricante.

--model

Modelo.

--pc --product-code

Código del producto.

--serial-number --sn

Número de serie.

--software-revision --sr

Revisión de software.

--tags

Etiquetas de recursos. Contenedor de propiedades en pares clave-valor con el formato siguiente: a=b c=d.

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az iot ops asset delete

Vista previa

El grupo de comandos "iot ops" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Eliminar un recurso.

az iot ops asset delete --name
                        --resource-group

Ejemplos

Eliminar un recurso.

az iot ops asset delete --name {asset_name} -g {resource_group}

Parámetros requeridos

--name -n

Nombre del recurso.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az iot ops asset query

Vista previa

El grupo de comandos "iot ops" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Consulte resource Graph para los recursos.

az iot ops asset query [--asset-type]
                       [--cl]
                       [--description]
                       [--disabled {false, true}]
                       [--display-name]
                       [--documentation-uri]
                       [--eai]
                       [--endpoint]
                       [--hardware-revision]
                       [--location]
                       [--manufacturer]
                       [--manufacturer-uri]
                       [--model]
                       [--pc]
                       [--resource-group]
                       [--serial-number]
                       [--software-revision]

Ejemplos

Consulte los recursos que están deshabilitados dentro de un grupo de recursos determinado.

az iot ops asset query -g {resource_group} --disabled

Consulte los recursos que tienen el modelo, el fabricante y el número de serie especificados.

az iot ops asset query --model {model} --manufacturer {manufacturer} --serial-number {serial_number}

Parámetros opcionales

--asset-type --at

Tipo de recurso.

--cl --custom-location

Ubicación personalizada que se usa para asociar un recurso al clúster.

--description -d

Descripción.

--disabled

Estado del recurso.

Valores aceptados: false, true

--display-name --dn

Nombre para mostrar.

--documentation-uri --du

URI de documentación.

--eai --external-asset-id

Id. de recurso externo.

--endpoint

Nombre del punto de conexión del recurso.

--hardware-revision --hr

Revisión de hardware.

--location -l

Ubicación. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.

--manufacturer

Fabricante.

--manufacturer-uri --mu

URI del fabricante.

--model

Modelo.

--pc --product-code

Código del producto.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--serial-number --sn

Número de serie.

--software-revision --sr

Revisión de software.

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az iot ops asset show

Vista previa

El grupo de comandos "iot ops" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Mostrar un recurso.

az iot ops asset show --name
                      --resource-group

Ejemplos

Muestra los detalles de un recurso.

az iot ops asset show --name {asset_name} -g {resource_group}

Parámetros requeridos

--name -n

Nombre del recurso.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az iot ops asset update

Vista previa

El grupo de comandos "iot ops" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Actualice un recurso.

Para actualizar los puntos de datos y los eventos, use los grupos az iot ops asset data-point de comandos y az iot ops asset events respectivamente.

az iot ops asset update --name
                        --resource-group
                        [--asset-type]
                        [--attr]
                        [--data-publish-int]
                        [--data-queue-size]
                        [--data-sample-int]
                        [--description]
                        [--disable {false, true}]
                        [--display-name]
                        [--documentation-uri]
                        [--eai]
                        [--epi]
                        [--eqs]
                        [--esi]
                        [--hardware-revision]
                        [--manufacturer]
                        [--manufacturer-uri]
                        [--model]
                        [--pc]
                        [--serial-number]
                        [--software-revision]
                        [--tags]

Ejemplos

Actualice los valores predeterminados del punto de datos y del evento de un recurso.

az iot ops asset update --name {asset_name} -g {resource_group} --data-publish-int {data_point_publishing_interval} --data-queue-size {data_point_queue_size} --data-sample-int {data_point_sampling_interval} --event-publish-int {event_publishing_interval} --event-queue-size {event_queue_size} --event-sample-int {event_sampling_interval}

Actualice el tipo de recurso, la descripción, el URI de documentación, el identificador de recurso externo, la revisión de hardware, el código de producto y la revisión de software.

az iot ops asset update --name {asset_name} -g {resource_group} --asset-type {asset_type} --description {description} --documentation-uri {documentation_uri} --external-asset-id {external_asset_id} --hardware-revision {hardware_revision} --product-code {product_code} --software-revision {software_revision}

Actualice el fabricante, el URI del fabricante, el modelo, el número de serie y el atributo personalizado de un recurso.

az iot ops asset update --name {asset_name} -g {resource_group} --manufacturer {manufacturer} --manufacturer-uri {manufacturer_uri} --model {model} --serial-number {serial_number} --custom-attribute {attribute_key}={attribute_value}

Deshabilite un recurso y quite un atributo personalizado denominado "work_site".

az iot ops asset update --name {asset_name} -g {resource_group} --disable --custom-attribute work_site=""

Parámetros requeridos

--name -n

Nombre del recurso.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--asset-type --at

Tipo de recurso.

--attr --custom-attribute

Pares clave=valor separados por espacios correspondientes a atributos personalizados adicionales para el recurso. Para quitar un atributo personalizado, establezca el valor del atributo en "".

--data-publish-int --dpi

Intervalo de publicación predeterminado para puntos de datos.

--data-queue-size --dqs

Tamaño de cola predeterminado para puntos de datos.

--data-sample-int --dsi

Intervalo de muestreo predeterminado (en milisegundos) para los puntos de datos.

--description -d

Descripción.

--disable

Deshabilite un recurso.

Valores aceptados: false, true

--display-name --dn

Nombre para mostrar.

--documentation-uri --du

URI de documentación.

--eai --external-asset-id

Id. de recurso externo.

--epi --event-publish-int

Intervalo de publicación predeterminado para eventos.

--eqs --event-queue-size

Tamaño de cola predeterminado para eventos.

--esi --event-sample-int

Intervalo de muestreo predeterminado (en milisegundos) para eventos.

--hardware-revision --hr

Revisión de hardware.

--manufacturer

Fabricante.

--manufacturer-uri --mu

URI del fabricante.

--model

Modelo.

--pc --product-code

Código del producto.

--serial-number --sn

Número de serie.

--software-revision --sr

Revisión de software.

--tags

Etiquetas de recursos. Contenedor de propiedades en pares clave-valor con el formato siguiente: a=b c=d.

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

Compartir a través de

az iot ops asset

Comandos

az iot ops asset create

Ejemplos

Parámetros requeridos

Parámetros opcionales

az iot ops asset delete

Ejemplos

Parámetros requeridos

az iot ops asset query

Ejemplos

Parámetros opcionales

az iot ops asset show

Ejemplos

Parámetros requeridos

az iot ops asset update

Ejemplos

Parámetros requeridos

Parámetros opcionales

Recursos adicionales