Compartir a través de

az acr webhook

  • Referencia

Administración de webhooks para Azure Container Registries.

Comandos

Nombre Description Tipo Estado
az acr webhook create

Crea un webhook para una instancia de Azure Container Registry.

 Principal GA
az acr webhook delete

Elimina un webhook de una instancia de Azure Container Registry.

 Principal GA
az acr webhook get-config

Obtiene el URI del servicio y los encabezados personalizados para el webhook.

 Principal GA
az acr webhook list

Enumera todos los webhooks de una instancia de Azure Container Registry.

 Principal GA
az acr webhook list-events

Enumera los eventos recientes de un webhook.

 Principal GA
az acr webhook ping

Desencadena un evento de ping para un webhook.

 Principal GA
az acr webhook show

Obtiene los detalles de un webhook.

 Principal GA
az acr webhook update

Actualiza un webhook.

 Principal GA

az acr webhook create

Editar

Crea un webhook para una instancia de Azure Container Registry.

az acr webhook create --actions {chart_delete, chart_push, delete, push, quarantine}
                      --name
                      --registry
                      --uri
                      [--headers]
                      [--location]
                      [--resource-group]
                      [--scope]
                      [--status {disabled, enabled}]
                      [--tags]

Ejemplos

Cree un webhook para una instancia de Azure Container Registry que entregue eventos de inserción y eliminación de Docker a un URI de servicio.

az acr webhook create -n mywebhook -r myregistry --uri http://myservice.com --actions push delete

Cree un webhook para una instancia de Azure Container Registry que entregue eventos de inserción de Docker a un URI de servicio con un encabezado de autenticación básico.

az acr webhook create -n mywebhook -r myregistry --uri http://myservice.com --actions push --headers "Authorization=Basic 000000"

Cree un webhook para una instancia de Azure Container Registry que entregue eventos de inserción y eliminación de gráficos de Helm a un URI de servicio.

az acr webhook create -n mywebhook -r myregistry --uri http://myservice.com --actions chart_push chart_delete

Parámetros requeridos

--actions

Lista separada por espacios de acciones que desencadenan el webhook para publicar notificaciones.

Valores aceptados: chart_delete, chart_push, delete, push, quarantine
--name -n

Nombre del webhook.

--registry -r

Nombre del registro de contenedor. Debe especificarse en minúsculas. Puede configurar el nombre del Registro predeterminado mediante az configure --defaults acr=<registry name>.

--uri

URI del servicio para que el webhook publique notificaciones.

Parámetros opcionales

--headers

Encabezados personalizados separados por espacios en formato 'key[=value]' que se agregarán a las notificaciones de webhook. Use "" para borrar los encabezados existentes.

--location -l

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

--resource-group -g

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

--scope

El ámbito de los repositorios en los que se puede desencadenar el evento. Por ejemplo, "foo:*" significa eventos para todas las etiquetas del repositorio "foo". 'foo:bar' significa solo eventos para 'foo:bar'. 'foo' es equivalente a 'foo:latest'. Vacío significa eventos para todos los repositorios.

--status

Indica si el webhook está habilitado.

Valores aceptados: disabled, enabled
Valor predeterminado: enabled
--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

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 acr webhook delete

Editar

Elimina un webhook de una instancia de Azure Container Registry.

az acr webhook delete --name
                      --registry
                      [--resource-group]

Ejemplos

Elimina un webhook de una instancia de Azure Container Registry.

az acr webhook delete -n mywebhook -r myregistry

Parámetros requeridos

--name -n

Nombre del webhook.

--registry -r

Nombre del registro de contenedor. Debe especificarse en minúsculas. Puede configurar el nombre del Registro predeterminado mediante az configure --defaults acr=<registry name>.

Parámetros opcionales

--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 acr webhook get-config

Editar

Obtiene el URI del servicio y los encabezados personalizados para el webhook.

az acr webhook get-config --name
                          --registry
                          [--resource-group]

Ejemplos

Obtenga la información de configuración de un webhook.

az acr webhook get-config -n mywebhook -r myregistry

Parámetros requeridos

--name -n

Nombre del webhook.

--registry -r

Nombre del registro de contenedor. Debe especificarse en minúsculas. Puede configurar el nombre del Registro predeterminado mediante az configure --defaults acr=<registry name>.

Parámetros opcionales

--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 acr webhook list

Editar

Enumera todos los webhooks de una instancia de Azure Container Registry.

az acr webhook list --registry
                    [--resource-group]

Ejemplos

Enumerar webhooks y mostrar los resultados en una tabla.

az acr webhook list -r myregistry -o table

Parámetros requeridos

--registry -r

Nombre del registro de contenedor. Debe especificarse en minúsculas. Puede configurar el nombre del Registro predeterminado mediante az configure --defaults acr=<registry name>.

Parámetros opcionales

--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 acr webhook list-events

Editar

Enumera los eventos recientes de un webhook.

az acr webhook list-events --name
                           --registry
                           [--resource-group]

Ejemplos

Enumera los eventos recientes de un webhook.

az acr webhook list-events -n mywebhook -r myregistry

Parámetros requeridos

--name -n

Nombre del webhook.

--registry -r

Nombre del registro de contenedor. Debe especificarse en minúsculas. Puede configurar el nombre del Registro predeterminado mediante az configure --defaults acr=<registry name>.

Parámetros opcionales

--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 acr webhook ping

Editar

Desencadena un evento de ping para un webhook.

az acr webhook ping --name
                    --registry
                    [--resource-group]

Ejemplos

Desencadena un evento de ping para un webhook.

az acr webhook ping -n mywebhook -r myregistry

Parámetros requeridos

--name -n

Nombre del webhook.

--registry -r

Nombre del registro de contenedor. Debe especificarse en minúsculas. Puede configurar el nombre del Registro predeterminado mediante az configure --defaults acr=<registry name>.

Parámetros opcionales

--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 acr webhook show

Editar

Obtiene los detalles de un webhook.

az acr webhook show --name
                    --registry
                    [--resource-group]

Ejemplos

Obtiene los detalles de un webhook.

az acr webhook show -n mywebhook -r myregistry

Parámetros requeridos

--name -n

Nombre del webhook.

--registry -r

Nombre del registro de contenedor. Debe especificarse en minúsculas. Puede configurar el nombre del Registro predeterminado mediante az configure --defaults acr=<registry name>.

Parámetros opcionales

--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 acr webhook update

Editar

Actualiza un webhook.

az acr webhook update --name
                      --registry
                      [--actions {chart_delete, chart_push, delete, push, quarantine}]
                      [--add]
                      [--force-string]
                      [--headers]
                      [--remove]
                      [--resource-group]
                      [--scope]
                      [--set]
                      [--status {disabled, enabled}]
                      [--tags]
                      [--uri]

Ejemplos

Actualice los encabezados de un webhook.

az acr webhook update -n mywebhook -r myregistry --headers "Authorization=Basic 000000"

Actualice el URI del servicio y las acciones de un webhook.

az acr webhook update -n mywebhook -r myregistry --uri http://myservice.com --actions push delete

Deshabilite un webhook.

az acr webhook update -n mywebhook -r myregistry --status disabled

Parámetros requeridos

--name -n

Nombre del webhook.

--registry -r

Nombre del registro de contenedor. Debe especificarse en minúsculas. Puede configurar el nombre del Registro predeterminado mediante az configure --defaults acr=<registry name>.

Parámetros opcionales

--actions

Lista separada por espacios de acciones que desencadenan el webhook para publicar notificaciones.

Valores aceptados: chart_delete, chart_push, delete, push, quarantine
--add

Agregue un objeto a una lista de objetos especificando una ruta de acceso y pares clave-valor. Ejemplo: --add property.listProperty <key=value, string or JSON string>.

Valor predeterminado: []
--force-string

Al usar 'set' o 'add', conserve los literales de cadena en lugar de intentar convertir en JSON.

Valor predeterminado: False
--headers

Encabezados personalizados separados por espacios en formato 'key[=value]' que se agregarán a las notificaciones de webhook. Use "" para borrar los encabezados existentes.

--remove

Quite una propiedad o un elemento de una lista. Ejemplo: --remove property.list <indexToRemove> O --remove propertyToRemove.

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

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

--scope

El ámbito de los repositorios en los que se puede desencadenar el evento. Por ejemplo, "foo:*" significa eventos para todas las etiquetas del repositorio "foo". 'foo:bar' significa solo eventos para 'foo:bar'. 'foo' es equivalente a 'foo:latest'. Vacío significa eventos para todos los repositorios.

--set

Actualice un objeto especificando una ruta de acceso de propiedad y un valor que se va a establecer. Ejemplo: --set property1.property2=<value>.

Valor predeterminado: []
--status

Indica si el webhook está habilitado.

Valores aceptados: disabled, enabled
--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

--uri

URI del servicio para que el webhook publique notificaciones.

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.