Compartir a través de

az ml service

  • Referencia

Nota:

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

Administrar servicios operativos.

Comandos

Nombre Description Tipo Estado
az ml service delete

Elimine un servicio del área de trabajo.

 Extensión GA
az ml service get-access-token

Obtenga un token para emitir solicitudes de un servicio.

 Extensión GA
az ml service get-keys

Obtenga claves para emitir solicitudes en un servicio.

 Extensión GA
az ml service get-logs

Obtiene los registros de un servicio.

 Extensión GA
az ml service list

Enumerar los servicios en el área de trabajo.

 Extensión GA
az ml service regen-key

Regenera las claves de un servicio.

 Extensión GA
az ml service run

Ejecute un servicio en el área de trabajo.

 Extensión GA
az ml service show

Mostrar detalles de un servicio en el área de trabajo.

 Extensión GA
az ml service update

Actualice un servicio en el área de trabajo.

 Extensión GA

az ml service delete

Elimine un servicio del área de trabajo.

az ml service delete --name
                     [--path]
                     [--resource-group]
                     [--subscription-id]
                     [--workspace-name]
                     [-v]

Parámetros requeridos

--name -n

Nombre del servicio que se va a eliminar.

Parámetros opcionales

--path

Ruta de acceso a una carpeta del proyecto. Valor predeterminado: directorio actual.

--resource-group -g

Grupo de recursos correspondiente al área de trabajo proporcionada.

--subscription-id

Especifica el identificador de suscripción.

--workspace-name -w

Nombre del área de trabajo que contiene el servicio que se va a eliminar.

-v

Marca de detalle.

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 ml service get-access-token

Obtenga un token para emitir solicitudes de un servicio.

az ml service get-access-token --name
                               [--path]
                               [--resource-group]
                               [--subscription-id]
                               [--workspace-name]
                               [-v]

Parámetros requeridos

--name -n

Nombre del servicio.

Parámetros opcionales

--path

Ruta de acceso a una carpeta del proyecto. Valor predeterminado: directorio actual.

--resource-group -g

Grupo de recursos correspondiente al área de trabajo proporcionada.

--subscription-id

Especifica el identificador de suscripción.

--workspace-name -w

Nombre del área de trabajo que contiene el servicio que se va a mostrar.

-v

Marca de detalle.

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 ml service get-keys

Obtenga claves para emitir solicitudes en un servicio.

az ml service get-keys --name
                       [--path]
                       [--resource-group]
                       [--subscription-id]
                       [--workspace-name]
                       [-v]

Parámetros requeridos

--name -n

Nombre del servicio.

Parámetros opcionales

--path

Ruta de acceso a una carpeta del proyecto. Valor predeterminado: directorio actual.

--resource-group -g

Grupo de recursos correspondiente al área de trabajo proporcionada.

--subscription-id

Especifica el identificador de suscripción.

--workspace-name -w

Nombre del área de trabajo que contiene el servicio que se va a mostrar.

-v

Marca de detalle.

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 ml service get-logs

Obtiene los registros de un servicio.

az ml service get-logs --name
                       [--init]
                       [--num_lines]
                       [--path]
                       [--resource-group]
                       [--subscription-id]
                       [--workspace-name]
                       [-v]

Parámetros requeridos

--name -n

Nombre del servicio.

Parámetros opcionales

--init -i

Obtiene los registros del contenedor de inicialización en lugar del contenedor de puntuación.

valor predeterminado: False
--num_lines -l

Número de líneas de registro que se van a devolver del final (el valor predeterminado es 5000).

valor predeterminado: 5000
--path

Ruta de acceso a una carpeta del proyecto. Valor predeterminado: directorio actual.

--resource-group -g

Grupo de recursos correspondiente al área de trabajo proporcionada.

--subscription-id

Especifica el identificador de suscripción.

--workspace-name -w

Nombre del área de trabajo que contiene el servicio que se va a mostrar.

-v

Marca de detalle.

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 ml service list

Enumerar los servicios en el área de trabajo.

az ml service list [--compute-type]
                   [--image-digest]
                   [--model-id]
                   [--model-name]
                   [--path]
                   [--property]
                   [--resource-group]
                   [--subscription-id]
                   [--tag]
                   [--workspace-name]
                   [-v]

Parámetros opcionales

--compute-type -c

Si se proporciona, solo mostrará los servicios que tienen el tipo de proceso especificado. (Las opciones son "ACI", "AKS").

--image-digest

Si se proporciona, solo mostrará los servicios que tienen el resumen de imagen especificado.

--model-id

Si se proporciona, solo mostrará los servicios que tienen el identificador de modelo especificado.

--model-name

Si se proporciona, solo mostrará los servicios que tienen el nombre del modelo especificado.

--path

Ruta de acceso a una carpeta del proyecto. Valor predeterminado: directorio actual.

--property

Si se proporciona, filtrará en función de la clave o el valor proporcionados (e.g. key o key=value). Se pueden especificar varias propiedades con varias opciones de --property.

valor predeterminado: []
--resource-group -g

Grupo de recursos correspondiente al área de trabajo proporcionada.

--subscription-id

Especifica el identificador de suscripción.

--tag

Si se proporciona, filtrará en función de la clave o el valor proporcionados (e.g. key o key=value). Se pueden especificar varias etiquetas con varias opciones de etiqueta.

valor predeterminado: []
--workspace-name -w

Nombre del área de trabajo que contiene los servicios que se van a enumerar.

-v

Marca de detalle.

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 ml service regen-key

Regenera las claves de un servicio.

az ml service regen-key --key
                        --name
                        [--path]
                        [--resource-group]
                        [--set-key]
                        [--subscription-id]
                        [--workspace-name]
                        [-v]

Parámetros requeridos

--key -k

Clave que se va a regenerar, si se especifica regen. Opciones: Principal, Secundario.

--name -n

Nombre del servicio.

Parámetros opcionales

--path

Ruta de acceso a una carpeta del proyecto. Valor predeterminado: directorio actual.

--resource-group -g

Grupo de recursos correspondiente al área de trabajo proporcionada.

--set-key -s

Proporcione el valor de autenticación para la clave especificada.

--subscription-id

Especifica el identificador de suscripción.

--workspace-name -w

Nombre del área de trabajo que contiene el servicio que se va a mostrar.

-v

Marca de detalle.

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 ml service run

Ejecute un servicio en el área de trabajo.

az ml service run --name
                  [--input-data]
                  [--path]
                  [--resource-group]
                  [--subscription-id]
                  [--workspace-name]
                  [-v]

Parámetros requeridos

--name -n

Nombre del servicio en el que se va a puntuar.

Parámetros opcionales

--input-data -d

Datos que se usarán para llamar al servicio web.

--path

Ruta de acceso a una carpeta del proyecto. Valor predeterminado: directorio actual.

--resource-group -g

Grupo de recursos correspondiente al área de trabajo proporcionada.

--subscription-id

Especifica el identificador de suscripción.

--workspace-name -w

Nombre del área de trabajo que contiene el servicio que se va a ejecutar.

-v

Marca de detalle.

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 ml service show

Mostrar detalles de un servicio en el área de trabajo.

az ml service show --name
                   [--path]
                   [--resource-group]
                   [--subscription-id]
                   [--workspace-name]
                   [-v]

Parámetros requeridos

--name -n

Nombre del servicio web que se va a mostrar.

Parámetros opcionales

--path

Ruta de acceso a una carpeta del proyecto. Valor predeterminado: directorio actual.

--resource-group -g

Grupo de recursos correspondiente al área de trabajo proporcionada.

--subscription-id

Especifica el identificador de suscripción.

--workspace-name -w

Nombre del área de trabajo que contiene el servicio que se va a mostrar.

-v

Marca de detalle.

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 ml service update

Actualice un servicio en el área de trabajo.

az ml service update --name
                     [--add-property]
                     [--add-tag]
                     [--ae]
                     [--ai]
                     [--ar]
                     [--as]
                     [--at]
                     [--autoscale-max-replicas]
                     [--autoscale-min-replicas]
                     [--base-image]
                     [--base-image-registry]
                     [--cc]
                     [--ccl]
                     [--cf]
                     [--collect-model-data]
                     [--compute-target]
                     [--cuda-version]
                     [--dc]
                     [--description]
                     [--dn]
                     [--ds]
                     [--ed]
                     [--eg]
                     [--entry-script]
                     [--environment-name]
                     [--environment-version]
                     [--failure-threshold]
                     [--gb]
                     [--gbl]
                     [--gc]
                     [--ic]
                     [--id]
                     [--is-migration]
                     [--kp]
                     [--ks]
                     [--lo]
                     [--max-request-wait-time]
                     [--model]
                     [--model-metadata-file]
                     [--no-wait]
                     [--nr]
                     [--path]
                     [--period-seconds]
                     [--po]
                     [--remove-tag]
                     [--replica-max-concurrent-requests]
                     [--resource-group]
                     [--rt]
                     [--sc]
                     [--scoring-timeout-ms]
                     [--sd]
                     [--se]
                     [--sk]
                     [--sp]
                     [--st]
                     [--subscription-id]
                     [--timeout-seconds]
                     [--token-auth-enabled]
                     [--workspace-name]
                     [-v]

Parámetros requeridos

--name -n

Nombre del servicio que se va a actualizar.

Parámetros opcionales

--add-property

Propiedad Key/value que se va a agregar (e.g. key=value ). Se pueden especificar varias propiedades con varias opciones de --add-property.

valor predeterminado: []
--add-tag

Etiqueta clave-valor que se va a agregar (e.g. key=valor ). Se pueden especificar varias etiquetas con varias opciones de --add-tag.

valor predeterminado: []
--ae --auth-enabled

Indica si se debe habilitar o no la autenticación de clave para este Webservice. El valor predeterminado es False.

--ai --enable-app-insights

Indica si se debe habilitar o no AppInsights para este servicio web. El valor predeterminado es False.

--ar --autoscale-refresh-seconds

Frecuencia con la que el escalador automático debe intentar escalar este Webservice. De manera predeterminada, su valor es 1.

--as --autoscale-enabled

Indica si se debe habilitar o no la escalabilidad automática para este Webservice. El valor predeterminado es True si num_replicas es Ninguno.

--at --autoscale-target-utilization

Uso objetivo (en un porcentaje de 100) que el escalador automático debe intentar mantener para este Webservice. El valor predeterminado es 70.

--autoscale-max-replicas --ma

Número máximo de contenedores que se van a usar al escalar automáticamente este Webservice. El valor predeterminado es 10.

--autoscale-min-replicas --mi

Número mínimo de contenedores que se van a usar al escalar automáticamente este Webservice. De manera predeterminada, su valor es 1.

--base-image --bi

una imagen personalizada que se usará como imagen base. Si no se especifica ninguna imagen base, la imagen base se usará en función del parámetro de runtime proporcionado.

--base-image-registry --ir

registro de imágenes que contiene la imagen base.

--cc --cpu-cores

Número de núcleos de CPU que se asignarán a este Webservice. Puede ser un decimal. El valor predeterminado es 0,1.

--ccl --cpu-cores-limit

Número máximo de núcleos de CPU que puede usar este servicio web. Puede ser un decimal.

--cf --conda-file

ruta de acceso al archivo local que contiene una definición de entorno de conda que se usará para la imagen.

--collect-model-data --md

Indica si se debe habilitar o no la recopilación de datos del modelo para este Webservice. El valor predeterminado es False.

--compute-target

(Versión preliminar) Especifica el destino de proceso con la extensión AzureML instalada para hospedar el punto de conexión y la implementación en línea de Kubernetes migrados.

--cuda-version --cv

versión de CUDA que se debe instalar para las imágenes que requieren compatibilidad con GPU. La imagen GPU se debe usar en servicios de Microsoft Azure como Azure Container Instances, Azure Machine Learning Compute, Azure Virtual Machines y Azure Kubernetes Service. Las versiones compatibles son 9.0, 9.1 y 10.0. Si se establece "enable_gpu", el valor predeterminado es "9.1".

--dc --deploy-config-file

Ruta de acceso a un archivo JSON que contiene metadatos de implementación.

--description -d

Descripción del servicio.

--dn --dns-name-label

Nombre dns de este servicio web.

--ds --extra-docker-file-steps

ruta de acceso al archivo local que contiene los pasos de Docker adicionales que se deben ejecutar al configurar la imagen.

--ed --environment-directory

Directorio del entorno de Azure Machine Learning para la implementación. Es la misma ruta de acceso de directorio que se proporciona en el comando "az ml environment scaffold".

--eg --enable-gpu

determina si se habilita o no la compatibilidad con GPU en la imagen. La imagen GPU se debe usar en servicios de Microsoft Azure como Azure Container Instances, Azure Machine Learning Compute, Azure Virtual Machines y Azure Kubernetes Service. El valor predeterminado es False.

--entry-script --es

Ruta de acceso al archivo local que contiene el código que se va a ejecutar para el servicio (ruta de acceso relativa de source_directory si se proporciona una).

--environment-name -e

Nombre del entorno de Azure Machine Learning para la implementación.

--environment-version --ev

Versión de un entorno de Azure Machine Learning existente para la implementación.

--failure-threshold --ft

Cuando se inicia un pod y se produce un error en el sondeo de ejecución, Kubernetes probará los tiempos de umbral de error antes de renunciar. El valor predeterminado es 3. El valor mínimo es 1.

--gb --memory-gb

Cantidad de memoria (en GB) que se va a asignar a este servicio web. Puede ser un decimal.

--gbl --memory-gb-limit

Cantidad máxima de memoria (en GB) que puede usar este servicio web. Puede ser un decimal.

--gc --gpu-cores

Número de núcleos de GPU que se van a asignar para este servicio web. El valor predeterminado es 1.

--ic --inference-config-file

Ruta de acceso a un archivo JSON o YAML que contiene la configuración de inferencia.

--id --initial-delay-seconds

Número de segundos después de que se haya iniciado el contenedor antes de que se inicien los sondeos de ejecución. El valor predeterminado es 310.

--is-migration

(Versión preliminar) Independientemente de si se va a migrar o no el servicio web de AKS al punto de conexión y la implementación en línea de Kubernetes. El valor predeterminado es False.

--kp --primary-key

Clave de autenticación principal que se usará para este Webservice.

--ks --secondary-key

Clave de autenticación secundaria que se usará para este Webservice.

--lo --location

Región de Azure en la que se implementará este servicio web. Si no se especifica, se usará la ubicación del área de trabajo. Puede encontrar más detalles sobre las regiones disponibles aquí: https://azure.microsoft.com/en-us/global-infrastructure/services/?regions=all& products=container-instances.

--max-request-wait-time --mr

Cantidad máxima de tiempo que permanecerá una solicitud en la cola (en milisegundos) antes de devolver un error 503. El valor predeterminado es 500.

--model -m

Identificador del modelo que se va a implementar. Se pueden especificar varios modelos con argumentos -m adicionales. Los modelos deben registrarse primero.

valor predeterminado: []
--model-metadata-file -f

Ruta de acceso a un archivo JSON que contiene metadatos de registro de modelos. Se pueden proporcionar varios modelos mediante varios parámetros -f.

valor predeterminado: []
--no-wait

Marca para no esperar llamadas asincrónicas.

--nr --num-replicas

Número de contenedores que se asignarán a este Webservice. No tiene un valor predeterminado. Si no se establece este parámetro, el escalador automático se habilita de manera predeterminada.

--path

Ruta de acceso a una carpeta del proyecto. Valor predeterminado: directorio actual.

--period-seconds --ps

Frecuencia (en segundos) en que se ejecutará el sondeo de ejecución. El valor predeterminado es de 10 segundos. El valor mínimo es 1.

--po --port

Puerto local en el que se va a exponer el punto de conexión HTTP del servicio.

--remove-tag

Clave de etiqueta que se va a quitar. Se pueden especificar varias etiquetas con varias opciones --remove-tag.

valor predeterminado: []
--replica-max-concurrent-requests --rm

Número de solicitudes simultáneas máximas por nodo que permiten este servicio web. De manera predeterminada, su valor es 1.

--resource-group -g

Grupo de recursos correspondiente al área de trabajo proporcionada.

--rt --runtime

Tiempo de ejecución que se va a usar para la imagen. Los entornos de ejecución compatibles actuales son "spark-py" y "python"spark-py|python|python-slim.

--sc --ssl-cname

CNAME si SSL está habilitado. Solo es aplicable al actualizar un servicio de ACI.

--scoring-timeout-ms --tm

Tiempo de espera para aplicar a las llamadas de puntuación a este Webservice. El valor predeterminado es 60 000.

--sd --source-directory

Ruta de acceso a las carpetas que contienen todos los archivos para crear la imagen.

--se --ssl-enabled

Indica si se debe habilitar o no SSL para este servicio web. El valor predeterminado es False.

--sk --ssl-key-pem-file

Archivo de clave necesario si SSL está habilitado.

--sp --ssl-cert-pem-file

Archivo de certificado necesario si SSL está habilitado.

--st --success-threshold

Número mínimo de valores correctos consecutivos para que el sondeo de ejecución se considere correcto después de que se haya producido un error. De manera predeterminada, su valor es 1. El valor mínimo es 1.

--subscription-id

Especifica el identificador de suscripción.

--timeout-seconds --ts

Número de segundos tras los cuales el sondeo de ejecución agota el tiempo de espera. El valor predeterminado es de 2 segundos. El valor mínimo es 1.

--token-auth-enabled

Si se va a habilitar o no la autenticación de tokens para este servicio web. Solo está disponible para los servicios web de AKS. El valor predeterminado es False.

--workspace-name -w

Nombre del área de trabajo que contiene el servicio que se va a actualizar.

-v

Marca de detalle.

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.