Compartir a través de


az cdn endpoint rule

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

Administrar reglas de entrega para un punto de conexión.

Comandos

Nombre Description Tipo Estado
az cdn endpoint rule action

Administrar acciones de regla de entrega para un punto de conexión.

Core Preview
az cdn endpoint rule action add

Agregue una acción a una regla de entrega.

Core Preview
az cdn endpoint rule action remove

Quite una acción de una regla de entrega.

Core Preview
az cdn endpoint rule action show

Mostrar las reglas de entrega ascociate con el punto de conexión.

Core Preview
az cdn endpoint rule add

Agregue una regla de entrega a un punto de conexión de CDN.

Core Preview
az cdn endpoint rule condition

Administrar las condiciones de las reglas de entrega para un punto de conexión.

Core Preview
az cdn endpoint rule condition add

Agregue una condición a una regla de entrega.

Core Preview
az cdn endpoint rule condition remove

Quite una condición de una regla de entrega.

Core Preview
az cdn endpoint rule condition show

Mostrar reglas de entrega asociadas al punto de conexión.

Core Preview
az cdn endpoint rule remove

Quite una regla de entrega de un punto de conexión.

Core Preview
az cdn endpoint rule show

Mostrar reglas de entrega asociadas al punto de conexión.

Core Preview

az cdn endpoint rule add

Vista previa

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

Agregue una regla de entrega a un punto de conexión de CDN.

az cdn endpoint rule add --action-name {CacheExpiration, CacheKeyQueryString, ModifyRequestHeader, ModifyResponseHeader, OriginGroupOverride, UrlRedirect, UrlRewrite}
                         --order
                         [--cache-behavior {BypassCache, Override, SetIfMissing}]
                         [--cache-duration]
                         [--custom-fragment]
                         [--custom-hostname]
                         [--custom-path]
                         [--custom-querystring]
                         [--destination]
                         [--header-action {Append, Delete, Overwrite}]
                         [--header-name]
                         [--header-value]
                         [--ids]
                         [--match-values]
                         [--match-variable {ClientPort, Cookies, HostName, HttpVersion, IsDevice, PostArgs, QueryString, RemoteAddress, RequestBody, RequestHeader, RequestMethod, RequestScheme, RequestUri, ServerPort, SocketAddr, SslProtocol, UrlFileExtension, UrlFileName, UrlPath}]
                         [--name]
                         [--negate-condition {false, true}]
                         [--operator]
                         [--origin-group]
                         [--preserve-unmatched-path {false, true}]
                         [--profile-name]
                         [--query-parameters]
                         [--query-string-behavior {Exclude, ExcludeAll, Include, IncludeAll}]
                         [--redirect-protocol {Http, Https, MatchRequest}]
                         [--redirect-type {Found, Moved, PermanentRedirect, TemporaryRedirect}]
                         [--resource-group]
                         [--rule-name]
                         [--selector]
                         [--source-pattern]
                         [--subscription]
                         [--transform {Lowercase, Uppercase}]

Ejemplos

Cree una regla global para deshabilitar el almacenamiento en caché.

az cdn endpoint rule add -g group -n endpoint --profile-name profile --order 0 --rule-name global --action-name CacheExpiration --cache-behavior BypassCache

Cree una regla para la redirección http a https.

az cdn endpoint rule add -g group -n endpoint --profile-name profile --order 1 --rule-name "redirect" --match-variable RequestScheme --operator Equal --match-values HTTP --action-name "UrlRedirect" --redirect-protocol Https --redirect-type Moved

Cree una regla para distribuir las solicitudes con "/test1" en su ruta de acceso URL al grupo de origen con el nombre "origingroup1".

az cdn endpoint rule add -g group -n endpoint --profile-name profile --order 1 --rule-name "origin-group-override" --match-variable UrlPath --operator Contains --match-values /test1 --action-name "OriginGroupOverride" --origin-group origingroup1

Parámetros requeridos

--action-name

Nombre de la acción para la regla de entrega: https://learn.microsoft.com/en-us/azure/cdn/cdn-standard-rules-engine-actions.

Propiedad Valor
Parameter group: Action Arguments
Valores aceptados: CacheExpiration, CacheKeyQueryString, ModifyRequestHeader, ModifyResponseHeader, OriginGroupOverride, UrlRedirect, UrlRewrite
--order

Orden en el que se aplican las reglas para el punto de conexión. Valores posibles {0,1,2,.........}. Se aplicará una regla con un orden inferior antes de una con un orden superior. La regla con el orden 0 es una regla especial. No requiere ninguna condición y acciones enumeradas en él siempre se aplicarán.

Parámetros opcionales

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--cache-behavior

Comportamiento de almacenamiento en caché de las solicitudes.

Propiedad Valor
Parameter group: Action Arguments
Valores aceptados: BypassCache, Override, SetIfMissing
--cache-duration

Duración durante la que se debe almacenar en caché el contenido. El formato permitido es hh:mm:ss.xxxxxx.

Propiedad Valor
Parameter group: Action Arguments
--custom-fragment

Fragmento que se va a agregar a la dirección URL de redireccionamiento.

Propiedad Valor
Parameter group: Action Arguments
--custom-hostname

Host para redirigir. Deje vacío para usar el host entrante como host de destino.

Propiedad Valor
Parameter group: Action Arguments
--custom-path

Ruta de acceso completa que se va a redirigir. La ruta de acceso no puede estar vacía y debe comenzar con /. Deje vacío para usar la ruta de acceso entrante como ruta de acceso de destino.

Propiedad Valor
Parameter group: Action Arguments
--custom-querystring

Conjunto de cadenas de consulta que se colocarán en la dirección URL de redireccionamiento. deje vacío para conservar la cadena de consulta entrante.

Propiedad Valor
Parameter group: Action Arguments
--destination

Ruta de acceso de destino que se usará en la reescritura.

Propiedad Valor
Parameter group: Action Arguments
--header-action

Acción de encabezado para las solicitudes.

Propiedad Valor
Parameter group: Action Arguments
Valores aceptados: Append, Delete, Overwrite
--header-name

Nombre del encabezado que se va a modificar.

Propiedad Valor
Parameter group: Action Arguments
--header-value

Valor del encabezado.

Propiedad Valor
Parameter group: Action Arguments
--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

Propiedad Valor
Parameter group: Resource Id Arguments
--match-values

Coincide con los valores de la condición de coincidencia. Por ejemplo, valores separados por espacios "GET" "HTTP".

Propiedad Valor
Parameter group: Match Condition Arguments
--match-variable

Nombre de la condición de coincidencia: https://learn.microsoft.com/en-us/azure/cdn/cdn-standard-rules-engine-match-conditions.

Propiedad Valor
Parameter group: Match Condition Arguments
Valores aceptados: ClientPort, Cookies, HostName, HttpVersion, IsDevice, PostArgs, QueryString, RemoteAddress, RequestBody, RequestHeader, RequestMethod, RequestScheme, RequestUri, ServerPort, SocketAddr, SslProtocol, UrlFileExtension, UrlFileName, UrlPath
--name -n

Nombre del punto de conexión de CDN.

Propiedad Valor
Parameter group: Resource Id Arguments
--negate-condition

Si es true, niega la condición.

Propiedad Valor
Parameter group: Match Condition Arguments
Valores aceptados: false, true
--operator

Operador de la condición de coincidencia.

Propiedad Valor
Parameter group: Match Condition Arguments
--origin-group

Nombre o identificador del OriginGroup que invalidaría el originGroup predeterminado.

Propiedad Valor
Parameter group: Action Arguments
--preserve-unmatched-path

Si es True, la ruta de acceso restante después del patrón de origen se anexará a la nueva ruta de acceso de destino.

Propiedad Valor
Parameter group: Action Arguments
Valores aceptados: false, true
--profile-name

Nombre del perfil de cdn que es único dentro del grupo de recursos.

Propiedad Valor
Parameter group: Resource Id Arguments
--query-parameters

Parámetros de consulta para incluir o excluir (separados por comas).

Propiedad Valor
Parameter group: Action Arguments
--query-string-behavior

Comportamiento de cadena de consulta para las solicitudes.

Propiedad Valor
Parameter group: Action Arguments
Valores aceptados: Exclude, ExcludeAll, Include, IncludeAll
--redirect-protocol

Protocolo que se va a usar para el redireccionamiento.

Propiedad Valor
Parameter group: Action Arguments
Valores aceptados: Http, Https, MatchRequest
--redirect-type

El tipo de redireccionamiento que usará la regla al redirigir el tráfico.

Propiedad Valor
Parameter group: Action Arguments
Valores aceptados: Found, Moved, PermanentRedirect, TemporaryRedirect
--resource-group -g

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

Propiedad Valor
Parameter group: Resource Id Arguments
--rule-name

Nombre de la regla, solo es necesario para la SKU de Microsoft.

--selector

Selector de la condición de coincidencia.

Propiedad Valor
Parameter group: Match Condition Arguments
--source-pattern

Patrón de URI de solicitud que identifica el tipo de solicitudes que se pueden reescribir.

Propiedad Valor
Parameter group: Action Arguments
--subscription

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

Propiedad Valor
Parameter group: Resource Id Arguments
--transform

Transformación que se va a aplicar antes de la coincidencia.

Propiedad Valor
Parameter group: Match Condition Arguments
Valores aceptados: Lowercase, Uppercase
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Output format.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az cdn endpoint rule remove

Vista previa

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

Quite una regla de entrega de un punto de conexión.

az cdn endpoint rule remove [--ids]
                            [--name]
                            [--order]
                            [--profile-name]
                            [--resource-group]
                            [--rule-name]
                            [--subscription]

Ejemplos

Quite la regla global.

az cdn endpoint rule remove -g group -n endpoint --profile-name profile --rule-name Global

Quite la regla con el orden 4.

az cdn endpoint rule remove -g group -n endpoint --profile-name profile --order 4

Parámetros opcionales

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

Propiedad Valor
Parameter group: Resource Id Arguments
--name -n

Nombre del punto de conexión de CDN.

Propiedad Valor
Parameter group: Resource Id Arguments
--order

Orden en el que se aplican las reglas para el punto de conexión. Valores posibles {0,1,2,.........}. Se aplicará una regla con un orden inferior antes de una con un orden superior. La regla con el orden 0 es una regla especial. No requiere ninguna condición y acciones enumeradas en él siempre se aplicarán.

--profile-name

Nombre del perfil de cdn que es único dentro del grupo de recursos.

Propiedad Valor
Parameter group: Resource Id Arguments
--resource-group -g

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

Propiedad Valor
Parameter group: Resource Id Arguments
--rule-name

Nombre de la regla.

--subscription

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

Propiedad Valor
Parameter group: Resource Id Arguments
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Output format.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az cdn endpoint rule show

Vista previa

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

Mostrar reglas de entrega asociadas al punto de conexión.

az cdn endpoint rule show [--ids]
                          [--name]
                          [--profile-name]
                          [--resource-group]
                          [--subscription]

Ejemplos

mostrar reglas de entrega asociadas al punto de conexión.

az cdn endpoint rule show -g group -n endpoint --profile-name profile

Parámetros opcionales

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

Propiedad Valor
Parameter group: Resource Id Arguments
--name -n

Nombre del punto de conexión de CDN.

Propiedad Valor
Parameter group: Resource Id Arguments
--profile-name

Nombre del perfil de cdn que es único dentro del grupo de recursos.

Propiedad Valor
Parameter group: Resource Id Arguments
--resource-group -g

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

Propiedad Valor
Parameter group: Resource Id Arguments
--subscription

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

Propiedad Valor
Parameter group: Resource Id Arguments
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Output format.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False