Share via


az cdn endpoint rule

Este grupo de comandos está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Gerencie regras de entrega para um ponto de extremidade.

Comandos

Name Description Tipo Estado
az cdn endpoint rule action

Gerencie ações de regra de entrega para um ponto de extremidade.

Principal Pré-visualizar
az cdn endpoint rule action add

Adicione uma ação a uma regra de entrega.

Principal Pré-visualizar
az cdn endpoint rule action remove

Remova uma ação de uma regra de entrega.

Principal Pré-visualizar
az cdn endpoint rule action show

Mostrar regras de entrega de acordo com o ponto de extremidade.

Principal Pré-visualizar
az cdn endpoint rule add

Adicione uma regra de entrega a um ponto de extremidade CDN.

Principal Pré-visualizar
az cdn endpoint rule condition

Gerencie as condições da regra de entrega para um ponto de extremidade.

Principal Pré-visualizar
az cdn endpoint rule condition add

Adicione uma condição a uma regra de entrega.

Principal Pré-visualizar
az cdn endpoint rule condition remove

Remova uma condição de uma regra de entrega.

Principal Pré-visualizar
az cdn endpoint rule condition show

Mostrar regras de entrega associadas ao ponto de extremidade.

Principal Pré-visualizar
az cdn endpoint rule remove

Remova uma regra de entrega de um ponto de extremidade.

Principal Pré-visualizar
az cdn endpoint rule show

Mostrar regras de entrega associadas ao ponto de extremidade.

Principal Pré-visualizar

az cdn endpoint rule add

Pré-visualizar

O grupo de comandos 'cdn endpoint rule' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Adicione uma regra de entrega a um ponto de extremidade 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}]

Exemplos

Crie uma regra global para desativar o cache.

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

Crie uma regra para o redirecionamento http para 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

Crie uma regra para distribuir solicitações com "/test1" em seu caminho de URL para o grupo de origem com o nome "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 Obrigatórios

--action-name

O nome da ação para a regra de entrega: https://docs.microsoft.com/en-us/azure/cdn/cdn-standard-rules-engine-actions.

valores aceites: CacheExpiration, CacheKeyQueryString, ModifyRequestHeader, ModifyResponseHeader, OriginGroupOverride, UrlRedirect, UrlRewrite
--order

A ordem em que as regras são aplicadas para o ponto de extremidade. Valores possíveis {0,1,2,3,.........}. Uma regra com uma ordem inferior será aplicada antes de uma regra com uma ordem superior. A regra com ordem 0 é uma regra especial. Ele não requer nenhuma condição e as ações listadas nele serão sempre aplicadas.

Parâmetros Opcionais

--cache-behavior

Comportamento de cache para as solicitações.

valores aceites: BypassCache, Override, SetIfMissing
--cache-duration

A duração durante a qual o conteúdo precisa ser armazenado em cache. O formato permitido é [d.]hh:mm:ss.

--custom-fragment

Fragmente para adicionar ao URL de redirecionamento.

--custom-hostname

Host para redirecionar. Deixe em branco para usar o host de entrada como host de destino.

--custom-path

O caminho completo para redirecionar. O caminho não pode estar vazio e deve começar com /. Deixe em branco para usar o caminho de entrada como caminho de destino.

--custom-querystring

O conjunto de cadeias de caracteres de consulta a serem colocadas na URL de redirecionamento. Deixe em branco para preservar a cadeia de caracteres de consulta de entrada.

--destination

O caminho de destino a ser usado na regravação.

--header-action

Ação de cabeçalho para as solicitações.

valores aceites: Append, Delete, Overwrite
--header-name

Nome do cabeçalho a ser modificado.

--header-value

Valor do cabeçalho.

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--match-values

Corresponder valores da condição de correspondência. por exemplo, valores separados por espaço "GET" "HTTP".

--match-variable

Nome da condição de correspondência: https://docs.microsoft.com/en-us/azure/cdn/cdn-standard-rules-engine-match-conditions.

valores aceites: ClientPort, Cookies, HostName, HttpVersion, IsDevice, PostArgs, QueryString, RemoteAddress, RequestBody, RequestHeader, RequestMethod, RequestScheme, RequestUri, ServerPort, SocketAddr, SslProtocol, UrlFileExtension, UrlFileName, UrlPath
--name -n

Nome do ponto de extremidade CDN.

--negate-condition

Se verdadeiro, nega a condição.

valores aceites: false, true
--operator

Operador da condição de correspondência.

--origin-group

Nome ou ID do OriginGroup que substituiria o OriginGroup padrão.

--preserve-unmatched-path

Se True, o caminho restante após o padrão de origem será anexado ao novo caminho de destino.

valores aceites: false, true
--profile-name

Nome do perfil CDN que é exclusivo dentro do grupo de recursos.

--query-parameters

Parâmetros de consulta a serem incluídos ou excluídos (separados por vírgula).

--query-string-behavior

Comportamento da cadeia de caracteres de consulta para as solicitações.

valores aceites: Exclude, ExcludeAll, Include, IncludeAll
--redirect-protocol

Protocolo a ser usado para o redirecionamento.

valores aceites: Http, Https, MatchRequest
--redirect-type

O tipo de redirecionamento que a regra usará ao redirecionar o tráfego.

valores aceites: Found, Moved, PermanentRedirect, TemporaryRedirect
--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--rule-name

Nome da regra, necessário apenas para Microsoft SKU.

--selector

Seletor da condição de correspondência.

--source-pattern

Um padrão de URI de solicitação que identifica o tipo de solicitações que podem ser reescritas.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--transform

Transforme para aplicar antes de combinar.

valores aceites: Lowercase, Uppercase
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az cdn endpoint rule remove

Pré-visualizar

O grupo de comandos 'cdn endpoint rule' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Remova uma regra de entrega de um ponto de extremidade.

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

Exemplos

Remova a regra global.

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

Remova a regra com a ordem 4.

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

Parâmetros Opcionais

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--name -n

Nome do ponto de extremidade CDN.

--order

A ordem em que as regras são aplicadas para o ponto de extremidade. Valores possíveis {0,1,2,3,.........}. Uma regra com uma ordem inferior será aplicada antes de uma regra com uma ordem superior. A regra com ordem 0 é uma regra especial. Ele não requer nenhuma condição e as ações listadas nele serão sempre aplicadas.

--profile-name

Nome do perfil CDN que é exclusivo dentro do grupo de recursos.

--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--rule-name

Nome da regra.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az cdn endpoint rule show

Pré-visualizar

O grupo de comandos 'cdn endpoint rule' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Mostrar regras de entrega associadas ao ponto de extremidade.

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

Exemplos

Mostrar regras de entrega associadas ao ponto de extremidade.

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

Parâmetros Opcionais

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--name -n

Nome do ponto de extremidade CDN.

--profile-name

Nome do perfil CDN que é exclusivo dentro do grupo de recursos.

--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.