Compartir a través de

az cdn endpoint rule

  • Vista previa
  • Referencia

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 Vista previa
az cdn endpoint rule action add

Agregue una acción a una regla de entrega.

 Core Vista previa
az cdn endpoint rule action remove

Quite una acción de una regla de entrega.

 Core Vista previa
az cdn endpoint rule action show

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

 Core Vista previa
az cdn endpoint rule add

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

 Core Vista previa
az cdn endpoint rule condition

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

 Core Vista previa
az cdn endpoint rule condition add

Agregue una condición a una regla de entrega.

 Core Vista previa
az cdn endpoint rule condition remove

Quite una condición de una regla de entrega.

 Core Vista previa
az cdn endpoint rule condition show

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

 Core Vista previa
az cdn endpoint rule remove

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

 Core Vista previa
az cdn endpoint rule show

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

 Core Vista previa

az cdn endpoint rule add

Editar
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://docs.microsoft.com/en-us/azure/cdn/cdn-standard-rules-engine-actions.

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

--cache-behavior

Comportamiento de almacenamiento en caché de las solicitudes.

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.

--custom-fragment

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

--custom-hostname

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

--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.

--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.

--destination

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

--header-action

Acción de encabezado para las solicitudes.

Valores aceptados: Append, Delete, Overwrite
--header-name

Nombre del encabezado que se va a modificar.

--header-value

Valor del encabezado.

--ids

Uno o varios identificadores de recursos (delimitados por espacios). 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".

--match-values

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

--match-variable

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

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.

--negate-condition

Si es true, niega la condición.

Valores aceptados: false, true
--operator

Operador de la condición de coincidencia.

--origin-group

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

--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.

Valores aceptados: false, true
--profile-name

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

--query-parameters

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

--query-string-behavior

Comportamiento de cadena de consulta para las solicitudes.

Valores aceptados: Exclude, ExcludeAll, Include, IncludeAll
--redirect-protocol

Protocolo que se va a usar para el redireccionamiento.

Valores aceptados: Http, Https, MatchRequest
--redirect-type

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

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>.

--rule-name

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

--selector

Selector de la condición de coincidencia.

--source-pattern

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

--subscription

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

--transform

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

Valores aceptados: Lowercase, Uppercase
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 cdn endpoint rule remove

Editar
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

--ids

Uno o varios identificadores de recursos (delimitados por espacios). 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".

--name -n

Nombre del punto de conexión de CDN.

--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.

--resource-group -g

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

--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.

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 cdn endpoint rule show

Editar
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

--ids

Uno o varios identificadores de recursos (delimitados por espacios). 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".

--name -n

Nombre del punto de conexión de CDN.

--profile-name

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

--resource-group -g

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

--subscription

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

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.