Endpoints - Create

Создает новую конечную точку CDN с указанным именем конечной точки в указанной подписке, группе ресурсов и профиле.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}?api-version=2024-02-01

Параметры URI

Имя В Обязательно Тип Описание
endpointName
path True

string

Имя конечной точки в профиле, которое является уникальным глобально.

profileName
path True

string

Имя профиля CDN, уникального в пределах группы ресурсов.

resourceGroupName
path True

string

Имя группы ресурсов в подписке Azure.

Шаблон регулярного выражения: ^[-\w\._\(\)]+$

subscriptionId
path True

string

Идентификатор подписки Azure.

api-version
query True

string

Версия API для использования с клиентским запросом. Текущая версия — 01.02.2024.

Текст запроса

Имя Обязательно Тип Описание
location True

string

Расположение ресурса.

properties.origins True

DeepCreatedOrigin[]

Источник содержимого, доставляемого через CDN.

properties.contentTypesToCompress

string[]

Список типов контента, к которым применяется сжатие. Значение должно быть допустимым типом MIME.

properties.defaultOriginGroup

ResourceReference

Ссылка на группу источников.

properties.deliveryPolicy

DeliveryPolicy

Политика, указывающая правила доставки, которые будут использоваться для конечной точки.

properties.geoFilters

GeoFilter[]

Список правил, определяющих геодоступ пользователя в конечной точке CDN. Каждый геофильтр определяет правило доступа к указанному пути или содержимому, например блок APAC для пути /pictures/

properties.isCompressionEnabled

boolean

Указывает, включено ли сжатие содержимого в CDN. Значение по умолчанию — false. Если сжатие включено, содержимое будет использоваться как сжатое, если пользователь запрашивает сжатую версию. Содержимое не сжимается в CDN, если запрошенное содержимое меньше 1 байта или больше 1 МБ.

properties.isHttpAllowed

boolean

Указывает, разрешен ли http-трафик в конечной точке. Значение по умолчанию — true. Должен быть разрешен по крайней мере один протокол (HTTP или HTTPS).

properties.isHttpsAllowed

boolean

Указывает, разрешен ли трафик HTTPS в конечной точке. Значение по умолчанию — true. Должен быть разрешен по крайней мере один протокол (HTTP или HTTPS).

properties.optimizationType

OptimizationType

Указывает, для какого сценария клиент хочет оптимизировать эту конечную точку CDN, например скачивание, службы мультимедиа. Используя эти сведения, CDN может применять оптимизацию на основе сценария.

properties.originGroups

DeepCreatedOriginGroup[]

Группы источников, состоящие из источников, которые используются для балансировки нагрузки трафика на основе доступности.

properties.originHostHeader

string

Значение заголовка узла, отправляемое источнику с каждым запросом. Это свойство в конечной точке разрешено, только если конечная точка использует один источник, и может быть переопределено тем же свойством, указанным в источнике. Если оставить это поле пустым, имя узла запроса определяет это значение. Источники Azure CDN, такие как веб-приложения, хранилище BLOB-объектов и Облачные службы требуют, чтобы это значение заголовка узла соответствовало имени исходного узла по умолчанию.

properties.originPath

string

Путь к каталогу в источнике, который CDN может использовать для получения содержимого, например contoso.cloudapp.net/originpath.

properties.probePath

string

Путь к файлу, размещенном в источнике, что помогает ускорить доставку динамического содержимого и вычислить наиболее оптимальные маршруты для CDN. Это относится к исходному пути. Это свойство применимо только при использовании одного источника.

properties.queryStringCachingBehavior

QueryStringCachingBehavior

Определяет, как CDN кэширует запросы, включающие строки запроса. При кэшировании можно игнорировать любые строки запроса, обходить кэширование, чтобы предотвратить кэширование запросов, содержащих строки запроса, или кэшировать каждый запрос с уникальным URL-адресом.

properties.urlSigningKeys

UrlSigningKey[]

Список ключей, используемых для проверки хэшей подписанных URL-адресов.

properties.webApplicationFirewallPolicyLink

WebApplicationFirewallPolicyLink

Определяет политику Брандмауэр веб-приложений для конечной точки (если применимо).

tags

object

Теги ресурсов.

Ответы

Имя Тип Описание
200 OK

Endpoint

Все в порядке. Запрос выполнен успешно.

201 Created

Endpoint

Создан. Запрос выполнен и создана новая конечная точка.

202 Accepted

Endpoint

Принято, и операция будет завершена асинхронно.

Заголовки

location: string

Other Status Codes

ErrorResponse

Ответ об ошибке CDN, описывающий причину сбоя операции.

Безопасность

azure_auth

Поток OAuth2 в Azure Active Directory.

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя Описание
user_impersonation олицетворения учетной записи пользователя

Примеры

Endpoints_Create

Образец запроса

PUT https://management.azure.com/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1?api-version=2024-02-01

{
  "location": "WestUs",
  "tags": {
    "key1": "value1"
  },
  "properties": {
    "originHostHeader": "www.bing.com",
    "originPath": "/photos",
    "contentTypesToCompress": [
      "text/html",
      "application/octet-stream"
    ],
    "isCompressionEnabled": true,
    "isHttpAllowed": true,
    "isHttpsAllowed": true,
    "queryStringCachingBehavior": "BypassCaching",
    "defaultOriginGroup": {
      "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/originGroups/originGroup1"
    },
    "deliveryPolicy": {
      "description": "Test description for a policy.",
      "rules": [
        {
          "name": "rule1",
          "order": 1,
          "conditions": [
            {
              "name": "RemoteAddress",
              "parameters": {
                "operator": "IPMatch",
                "negateCondition": true,
                "matchValues": [
                  "192.168.1.0/24",
                  "10.0.0.0/24"
                ],
                "typeName": "DeliveryRuleRemoteAddressConditionParameters"
              }
            }
          ],
          "actions": [
            {
              "name": "CacheExpiration",
              "parameters": {
                "cacheBehavior": "Override",
                "cacheDuration": "10:10:09",
                "typeName": "DeliveryRuleCacheExpirationActionParameters",
                "cacheType": "All"
              }
            },
            {
              "name": "ModifyResponseHeader",
              "parameters": {
                "headerAction": "Overwrite",
                "headerName": "Access-Control-Allow-Origin",
                "value": "*",
                "typeName": "DeliveryRuleHeaderActionParameters"
              }
            },
            {
              "name": "ModifyRequestHeader",
              "parameters": {
                "headerAction": "Overwrite",
                "headerName": "Accept-Encoding",
                "value": "gzip",
                "typeName": "DeliveryRuleHeaderActionParameters"
              }
            }
          ]
        }
      ]
    },
    "origins": [
      {
        "name": "origin1",
        "properties": {
          "hostName": "www.someDomain1.net",
          "httpPort": 80,
          "httpsPort": 443,
          "originHostHeader": "www.someDomain1.net",
          "priority": 1,
          "weight": 50,
          "enabled": true
        }
      },
      {
        "name": "origin2",
        "properties": {
          "hostName": "www.someDomain2.net",
          "httpPort": 80,
          "httpsPort": 443,
          "originHostHeader": "www.someDomain2.net",
          "priority": 2,
          "weight": 50,
          "enabled": true
        }
      }
    ],
    "originGroups": [
      {
        "name": "originGroup1",
        "properties": {
          "healthProbeSettings": {
            "probePath": "/health.aspx",
            "probeRequestType": "GET",
            "probeProtocol": "Http",
            "probeIntervalInSeconds": 120
          },
          "origins": [
            {
              "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/origin1"
            },
            {
              "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/origin2"
            }
          ],
          "responseBasedOriginErrorDetectionSettings": {
            "responseBasedDetectedErrorTypes": "TcpErrorsOnly",
            "responseBasedFailoverThresholdPercentage": 10
          }
        }
      }
    ]
  }
}

Пример ответа

{
  "name": "endpoint4899",
  "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1",
  "type": "Microsoft.Cdn/profiles/endpoints",
  "tags": {
    "kay1": "value1"
  },
  "location": "WestUs",
  "properties": {
    "hostName": "endpoint4899.azureedge-test.net",
    "originHostHeader": "www.bing.com",
    "provisioningState": "Creating",
    "resourceState": "Creating",
    "isHttpAllowed": true,
    "isHttpsAllowed": true,
    "queryStringCachingBehavior": "BypassCaching",
    "originPath": "/photos",
    "defaultOriginGroup": {
      "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/originGroups/originGroup1"
    },
    "origins": [
      {
        "name": "origin1",
        "properties": {
          "hostName": "www.someDomain1.net",
          "httpPort": 80,
          "httpsPort": 443,
          "originHostHeader": "www.someDomain1.net",
          "priority": 1,
          "weight": 50,
          "enabled": true
        }
      },
      {
        "name": "origin2",
        "properties": {
          "hostName": "www.someDomain2.net",
          "httpPort": 80,
          "httpsPort": 443,
          "originHostHeader": "www.someDomain2.net",
          "priority": 2,
          "weight": 50,
          "enabled": true
        }
      }
    ],
    "originGroups": [
      {
        "name": "originGroup1",
        "properties": {
          "healthProbeSettings": {
            "probePath": "/health.aspx",
            "probeRequestType": "GET",
            "probeProtocol": "Http",
            "probeIntervalInSeconds": 120
          },
          "origins": [
            {
              "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/origin1"
            },
            {
              "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/origin2"
            }
          ],
          "responseBasedOriginErrorDetectionSettings": {
            "responseBasedDetectedErrorTypes": "TcpErrorsOnly",
            "responseBasedFailoverThresholdPercentage": 10
          }
        }
      }
    ],
    "contentTypesToCompress": [
      "text/html",
      "application/octet-stream"
    ],
    "isCompressionEnabled": true,
    "optimizationType": null,
    "probePath": null,
    "geoFilters": [],
    "deliveryPolicy": {
      "description": "Test description for a policy.",
      "rules": [
        {
          "name": "rule1",
          "order": 1,
          "conditions": [
            {
              "name": "RemoteAddress",
              "parameters": {
                "typeName": "DeliveryRuleRemoteAddressConditionParameters",
                "operator": "IPMatch",
                "negateCondition": true,
                "matchValues": [
                  "192.168.1.0/24",
                  "10.0.0.0/24"
                ],
                "transforms": []
              }
            }
          ],
          "actions": [
            {
              "name": "CacheExpiration",
              "parameters": {
                "typeName": "DeliveryRuleCacheExpirationActionParameters",
                "cacheBehavior": "Override",
                "cacheDuration": "10:10:09",
                "cacheType": "All"
              }
            },
            {
              "name": "ModifyResponseHeader",
              "parameters": {
                "typeName": "DeliveryRuleHeaderActionParameters",
                "headerAction": "Overwrite",
                "headerName": "Access-Control-Allow-Origin",
                "value": "*"
              }
            },
            {
              "name": "ModifyRequestHeader",
              "parameters": {
                "typeName": "DeliveryRuleHeaderActionParameters",
                "headerAction": "Overwrite",
                "headerName": "Accept-Encoding",
                "value": "gzip"
              }
            }
          ]
        }
      ]
    }
  }
}
{
  "name": "endpoint4899",
  "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1",
  "type": "Microsoft.Cdn/profiles/endpoints",
  "tags": {
    "kay1": "value1"
  },
  "location": "WestUs",
  "properties": {
    "hostName": "endpoint4899.azureedge-test.net",
    "originHostHeader": "www.bing.com",
    "provisioningState": "Creating",
    "resourceState": "Creating",
    "isHttpAllowed": true,
    "isHttpsAllowed": true,
    "queryStringCachingBehavior": "BypassCaching",
    "originPath": "/photos",
    "defaultOriginGroup": {
      "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/originGroups/originGroup1"
    },
    "origins": [
      {
        "name": "origin1",
        "properties": {
          "hostName": "www.someDomain1.net",
          "httpPort": 80,
          "httpsPort": 443,
          "originHostHeader": "www.someDomain1.net",
          "priority": 1,
          "weight": 50,
          "enabled": true
        }
      },
      {
        "name": "origin2",
        "properties": {
          "hostName": "www.someDomain2.net",
          "httpPort": 80,
          "httpsPort": 443,
          "originHostHeader": "www.someDomain2.net",
          "priority": 2,
          "weight": 50,
          "enabled": true
        }
      }
    ],
    "originGroups": [
      {
        "name": "originGroup1",
        "properties": {
          "healthProbeSettings": {
            "probePath": "/health.aspx",
            "probeRequestType": "GET",
            "probeProtocol": "Http",
            "probeIntervalInSeconds": 120
          },
          "origins": [
            {
              "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/origin1"
            },
            {
              "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/origin2"
            }
          ],
          "responseBasedOriginErrorDetectionSettings": {
            "responseBasedDetectedErrorTypes": "TcpErrorsOnly",
            "responseBasedFailoverThresholdPercentage": 10
          }
        }
      }
    ],
    "contentTypesToCompress": [
      "text/html",
      "application/octet-stream"
    ],
    "isCompressionEnabled": true,
    "optimizationType": null,
    "probePath": null,
    "geoFilters": [],
    "deliveryPolicy": {
      "description": "Test description for a policy.",
      "rules": [
        {
          "name": "rule1",
          "order": 1,
          "conditions": [
            {
              "name": "RemoteAddress",
              "parameters": {
                "typeName": "DeliveryRuleRemoteAddressConditionParameters",
                "operator": "IPMatch",
                "negateCondition": true,
                "matchValues": [
                  "192.168.1.0/24",
                  "10.0.0.0/24"
                ],
                "transforms": []
              }
            }
          ],
          "actions": [
            {
              "name": "CacheExpiration",
              "parameters": {
                "typeName": "DeliveryRuleCacheExpirationActionParameters",
                "cacheBehavior": "Override",
                "cacheDuration": "10:10:09",
                "cacheType": "All"
              }
            },
            {
              "name": "ModifyResponseHeader",
              "parameters": {
                "typeName": "DeliveryRuleHeaderActionParameters",
                "headerAction": "Overwrite",
                "headerName": "Access-Control-Allow-Origin",
                "value": "*"
              }
            },
            {
              "name": "ModifyRequestHeader",
              "parameters": {
                "typeName": "DeliveryRuleHeaderActionParameters",
                "headerAction": "Overwrite",
                "headerName": "Accept-Encoding",
                "value": "gzip"
              }
            }
          ]
        }
      ]
    }
  }
}
azure-asyncoperation: https://management.azure.com/subscriptions/subid/resourcegroups/resourceGroupName/providers/Microsoft.Cdn/operationresults/operationId?api-version=2024-02-01
{
  "name": "endpoint4899",
  "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1",
  "type": "Microsoft.Cdn/profiles/endpoints",
  "tags": {
    "kay1": "value1"
  },
  "location": "WestUs",
  "properties": {
    "hostName": "endpoint4899.azureedge-test.net",
    "originHostHeader": "www.bing.com",
    "provisioningState": "Creating",
    "resourceState": "Creating",
    "isHttpAllowed": true,
    "isHttpsAllowed": true,
    "queryStringCachingBehavior": "BypassCaching",
    "originPath": "/photos",
    "defaultOriginGroup": {
      "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/originGroups/originGroup1"
    },
    "origins": [
      {
        "name": "origin1",
        "properties": {
          "hostName": "www.someDomain1.net",
          "httpPort": 80,
          "httpsPort": 443,
          "originHostHeader": "www.someDomain1.net",
          "priority": 1,
          "weight": 50,
          "enabled": true
        }
      },
      {
        "name": "origin2",
        "properties": {
          "hostName": "www.someDomain2.net",
          "httpPort": 80,
          "httpsPort": 443,
          "originHostHeader": "www.someDomain2.net",
          "priority": 2,
          "weight": 50,
          "enabled": true
        }
      }
    ],
    "originGroups": [
      {
        "name": "originGroup1",
        "properties": {
          "healthProbeSettings": {
            "probePath": "/health.aspx",
            "probeRequestType": "GET",
            "probeProtocol": "Http",
            "probeIntervalInSeconds": 120
          },
          "origins": [
            {
              "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/origin1"
            },
            {
              "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/origin2"
            }
          ],
          "responseBasedOriginErrorDetectionSettings": {
            "responseBasedDetectedErrorTypes": "TcpErrorsOnly",
            "responseBasedFailoverThresholdPercentage": 10
          }
        }
      }
    ],
    "contentTypesToCompress": [
      "text/html",
      "application/octet-stream"
    ],
    "isCompressionEnabled": true,
    "optimizationType": null,
    "probePath": null,
    "geoFilters": [],
    "deliveryPolicy": {
      "description": "Test description for a policy.",
      "rules": [
        {
          "name": "rule1",
          "order": 1,
          "conditions": [
            {
              "name": "RemoteAddress",
              "parameters": {
                "typeName": "DeliveryRuleRemoteAddressConditionParameters",
                "operator": "IPMatch",
                "negateCondition": true,
                "matchValues": [
                  "192.168.1.0/24",
                  "10.0.0.0/24"
                ],
                "transforms": []
              }
            }
          ],
          "actions": [
            {
              "name": "CacheExpiration",
              "parameters": {
                "typeName": "DeliveryRuleCacheExpirationActionParameters",
                "cacheBehavior": "Override",
                "cacheDuration": "10:10:09",
                "cacheType": "All"
              }
            },
            {
              "name": "ModifyResponseHeader",
              "parameters": {
                "typeName": "DeliveryRuleHeaderActionParameters",
                "headerAction": "Overwrite",
                "headerName": "Access-Control-Allow-Origin",
                "value": "*"
              }
            },
            {
              "name": "ModifyRequestHeader",
              "parameters": {
                "typeName": "DeliveryRuleHeaderActionParameters",
                "headerAction": "Overwrite",
                "headerName": "Accept-Encoding",
                "value": "gzip"
              }
            }
          ]
        }
      ]
    }
  }
}

Определения

Имя Описание
algorithm

Алгоритм, используемый для подписывания URL-адреса

cacheBehavior

Поведение кэширования для запросов

CacheConfiguration

Параметры кэширования для маршрута типа кэширования. Чтобы отключить кэширование, не предоставляйте объект cacheConfiguration.

CacheExpirationActionParameters

Определяет параметры для действия истечения срока действия кэша.

CacheKeyQueryStringActionParameters

Определяет параметры для действия запроса ключа кэша.

CacheType

Уровень, на котором необходимо кэшировать содержимое.

ClientPortMatchConditionParameters

Определяет параметры для условий соответствия ClientPort.

ClientPortOperator

Описывает оператор для сопоставления

CookiesMatchConditionParameters

Определяет параметры для условий соответствия файлов cookie.

CookiesOperator

Описывает оператор для сопоставления

DeepCreatedCustomDomain

Личные домены, созданные в конечной точке CDN.

DeepCreatedOrigin

Main источник содержимого CDN, которое добавляется при создании конечной точки CDN.

DeepCreatedOriginGroup

Группа источников для содержимого CDN, добавляемого при создании конечной точки CDN. Трафик отправляется в источники в группе источников на основе работоспособности источника.

DeliveryPolicy

Политика, указывающая правила доставки, которые будут использоваться для конечной точки.

DeliveryRule

Правило, указывающее набор действий и условий.

DeliveryRuleCacheExpirationAction

Определяет действие истечения срока действия кэша для правила доставки.

DeliveryRuleCacheKeyQueryStringAction

Определяет действие строки запроса ключа кэша для правила доставки.

DeliveryRuleClientPortCondition

Определяет условие ClientPort для правила доставки.

DeliveryRuleCookiesCondition

Определяет условие файлов cookie для правила доставки.

DeliveryRuleHostNameCondition

Определяет условие HostName для правила доставки.

DeliveryRuleHttpVersionCondition

Определяет условие HttpVersion для правила доставки.

DeliveryRuleIsDeviceCondition

Определяет условие IsDevice для правила доставки.

DeliveryRulePostArgsCondition

Определяет условие PostArgs для правила доставки.

DeliveryRuleQueryStringCondition

Определяет условие QueryString для правила доставки.

DeliveryRuleRemoteAddressCondition

Определяет условие RemoteAddress для правила доставки.

DeliveryRuleRequestBodyCondition

Определяет условие RequestBody для правила доставки.

DeliveryRuleRequestHeaderAction

Определяет действие заголовка запроса для правила доставки.

DeliveryRuleRequestHeaderCondition

Определяет условие RequestHeader для правила доставки.

DeliveryRuleRequestMethodCondition

Определяет условие RequestMethod для правила доставки.

DeliveryRuleRequestSchemeCondition

Определяет условие RequestScheme для правила доставки.

DeliveryRuleRequestUriCondition

Определяет условие RequestUri для правила доставки.

DeliveryRuleResponseHeaderAction

Определяет действие заголовка ответа для правила доставки.

DeliveryRuleRouteConfigurationOverrideAction

Определяет действие переопределения конфигурации маршрута для правила доставки. Применимо только к профилям Frontdoor уровня "Стандартный" или "Премиум".

DeliveryRuleServerPortCondition

Определяет условие ServerPort для правила доставки.

DeliveryRuleSocketAddrCondition

Определяет условие SocketAddress для правила доставки.

DeliveryRuleSslProtocolCondition

Определяет условие SslProtocol для правила доставки.

DeliveryRuleUrlFileExtensionCondition

Определяет условие UrlFileExtension для правила доставки.

DeliveryRuleUrlFileNameCondition

Определяет условие UrlFileName для правила доставки.

DeliveryRuleUrlPathCondition

Определяет условие UrlPath для правила доставки.

DestinationProtocol

Протокол, используемый для перенаправления. Значение по умолчанию — MatchRequest.

Endpoint

Конечная точка CDN — это сущность в профиле CDN, содержащая сведения о конфигурации, такие как источник, протокол, кэширование содержимого и поведение доставки. Конечная точка CDN использует формат URL-адреса azureedge.net.

EndpointProvisioningState

Состояние подготовки конечной точки.

EndpointResourceState

Состояние ресурса конечной точки.

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

ErrorDetail

Сведения об ошибке.

ErrorResponse

Сообщение об ошибке

ForwardingProtocol

Протокол, который будет использоваться этим правилом при переадресации трафика на серверные серверы.

GeoFilter

Правила, определяющие геодоступ пользователя в конечной точке CDN.

GeoFilterActions

Действие геофильтра, т. е. разрешение или блокировка доступа.

HeaderAction

Осуществляемое действие

HeaderActionParameters

Определяет параметры для действия заголовка запроса.

HealthProbeParameters

Объект JSON, содержащий свойства для отправки проб работоспособности в источник.

HealthProbeRequestType

Тип выполненного запроса пробы работоспособности.

HostNameMatchConditionParameters

Определяет параметры для условий соответствия HostName.

HostNameOperator

Описывает оператор для сопоставления

HttpErrorRangeParameters

Объект JSON, представляющий диапазон для кодов состояния HTTP.

HttpVersionMatchConditionParameters

Определяет параметры для условий соответствия HttpVersion.

HttpVersionOperator

Описывает оператор для сопоставления

IdentityType

Тип удостоверения, создающего или изменяющего ресурсы

IsDeviceMatchConditionParameters

Определяет параметры для условий соответствия IsDevice.

IsDeviceOperator

Описывает оператор для сопоставления

KeyVaultSigningKeyParameters

Описание параметров для использования keyVault пользователя для ключа подписи URL-адреса.

MatchValues

Значение соответствия для условия правила доставки

OptimizationType

Указывает сценарий, в котором клиент хочет оптимизировать эту конечную точку CDN, например скачивание служб мультимедиа. С помощью этих сведений можно применить оптимизацию на основе сценария.

OriginGroupOverride

Определяет параметры для конфигурации переопределения группы-источника.

OriginGroupOverrideAction

Определяет действие переопределения группы-источника для правила доставки.

OriginGroupOverrideActionParameters

Определяет параметры для действия переопределения группы источников.

paramIndicator

Указывает назначение параметра.

PostArgsMatchConditionParameters

Определяет параметры для условий соответствия PostArgs.

PostArgsOperator

Описывает оператор для сопоставления

PrivateEndpointStatus

Состояние утверждения подключения к Приватный канал

ProbeProtocol

Протокол, используемый для пробы работоспособности.

queryStringBehavior

Поведение кэширования для запросов

QueryStringCachingBehavior

Определяет, как CDN кэширует запросы, включающие строки запроса. Вы можете игнорировать любые строки запроса при кэшировании, обходить кэширование, чтобы предотвратить кэширование запросов, содержащих строки запроса, или кэшировать каждый запрос с уникальным URL-адресом.

QueryStringMatchConditionParameters

Определяет параметры для условий соответствия QueryString.

QueryStringOperator

Описывает оператор для сопоставления

RedirectType

Тип перенаправления, который будет использоваться правилом при перенаправлении трафика.

RemoteAddressMatchConditionParameters

Определяет параметры для условий соответствия RemoteAddress.

RemoteAddressOperator

Описывает оператор для сопоставления

RequestBodyMatchConditionParameters

Определяет параметры для условий соответствия RequestBody.

RequestBodyOperator

Описывает оператор для сопоставления

RequestHeaderMatchConditionParameters

Определяет параметры для условий соответствия RequestHeader.

RequestHeaderOperator

Описывает оператор для сопоставления

RequestMethodMatchConditionParameters

Определяет параметры для условий соответствия RequestMethod.

RequestMethodOperator

Описывает оператор для сопоставления

RequestSchemeMatchConditionParameters

Определяет параметры для условий соответствия RequestScheme.

RequestUriMatchConditionParameters

Определяет параметры для условий соответствия RequestUri

RequestUriOperator

Описывает оператор для сопоставления

ResourceReference

Ссылка на другой ресурс.

ResponseBasedDetectedErrorTypes

Тип ошибок ответа для запросов реальных пользователей, источник которых будет считаться неработоспособным

ResponseBasedOriginErrorDetectionParameters

Объект JSON, содержащий свойства для определения работоспособности источника с помощью реальных запросов и ответов.

RouteConfigurationOverrideActionParameters

Определяет параметры для действия переопределения конфигурации маршрута.

ruleCacheBehavior

Поведение кэширования для запросов

ruleIsCompressionEnabled

Указывает, включено ли сжатие содержимого. Если сжатие включено, содержимое будет использоваться как сжатое, если пользователь запрашивает сжатую версию. Содержимое не сжимается в AzureFrontDoor, если запрошенное содержимое меньше 1 байта или больше 1 МБ.

ruleQueryStringCachingBehavior

Определяет, как Frontdoor кэширует запросы, включающие строки запроса. При кэшировании можно игнорировать любые строки запроса, игнорировать определенные строки запроса, кэшировать каждый запрос с уникальным URL-адресом или кэшировать определенные строки запроса.

ServerPortMatchConditionParameters

Определяет параметры для условий соответствия ServerPort.

ServerPortOperator

Описывает оператор для сопоставления

SocketAddrMatchConditionParameters

Определяет параметры для условий соответствия SocketAddress.

SocketAddrOperator

Описывает оператор для сопоставления

SslProtocol

Протокол установленного подключения TLS.

SslProtocolMatchConditionParameters

Определяет параметры для условий соответствия SslProtocol

SslProtocolOperator

Описывает оператор для сопоставления

SystemData

Чтение только системных данных

transform

Описывает, какие преобразования применяются перед сопоставлением

UrlFileExtensionMatchConditionParameters

Определяет параметры для условий соответствия UrlFileExtension.

UrlFileExtensionOperator

Описывает оператор для сопоставления

UrlFileNameMatchConditionParameters

Определяет параметры для условий соответствия UrlFilename.

UrlFileNameOperator

Описывает оператор для сопоставления

UrlPathMatchConditionParameters

Определяет параметры для условий соответствия UrlPath.

UrlPathOperator

Описывает оператор для сопоставления

UrlRedirectAction

Определяет действие перенаправления URL-адреса для правила доставки.

UrlRedirectActionParameters

Определяет параметры для действия перенаправления URL-адреса.

UrlRewriteAction

Определяет действие перезаписи URL-адреса для правила доставки.

UrlRewriteActionParameters

Определяет параметры для действия переопределения URL-адреса.

UrlSigningAction

Определяет действие подписывания URL-адреса для правила доставки.

UrlSigningActionParameters

Определяет параметры для действия Подписывание URL-адресов.

UrlSigningKey

Ключ подписывания URL-адреса

UrlSigningParamIdentifier

Определяет, как определить параметр для определенной цели, например истекает

WebApplicationFirewallPolicyLink

Определяет политику Брандмауэр веб-приложений для конечной точки (если применимо).

algorithm

Алгоритм, используемый для подписывания URL-адреса

Имя Тип Описание
SHA256

string

cacheBehavior

Поведение кэширования для запросов

Имя Тип Описание
BypassCache

string

Override

string

SetIfMissing

string

CacheConfiguration

Параметры кэширования для маршрута типа кэширования. Чтобы отключить кэширование, не предоставляйте объект cacheConfiguration.

Имя Тип Описание
cacheBehavior

ruleCacheBehavior

Поведение кэширования для запросов

cacheDuration

string

Длительность кэширования содержимого. Допустимый формат: [d.]чч:мм:сс

isCompressionEnabled

ruleIsCompressionEnabled

Указывает, включено ли сжатие содержимого. Если сжатие включено, содержимое будет использоваться как сжатое, если пользователь запрашивает сжатую версию. Содержимое не сжимается в AzureFrontDoor, если запрошенное содержимое меньше 1 байта или больше 1 МБ.

queryParameters

string

параметры запроса для включения или исключения (разделенные запятыми).

queryStringCachingBehavior

ruleQueryStringCachingBehavior

Определяет, как Frontdoor кэширует запросы, включающие строки запроса. При кэшировании можно игнорировать любые строки запроса, игнорировать определенные строки запроса, кэшировать каждый запрос с уникальным URL-адресом или кэшировать определенные строки запроса.

CacheExpirationActionParameters

Определяет параметры для действия истечения срока действия кэша.

Имя Тип Описание
cacheBehavior

cacheBehavior

Поведение кэширования для запросов

cacheDuration

string

Длительность, в течение которой содержимое должно быть кэшировано. Допустимый формат: [d.]чч:мм:сс

cacheType

CacheType

Уровень, на котором необходимо кэшировать содержимое.

typeName enum:

DeliveryRuleCacheExpirationActionParameters

CacheKeyQueryStringActionParameters

Определяет параметры для действия запроса ключа кэша.

Имя Тип Описание
queryParameters

string

параметры запроса для включения или исключения (разделенные запятыми).

queryStringBehavior

queryStringBehavior

Поведение кэширования для запросов

typeName enum:

DeliveryRuleCacheKeyQueryStringBehaviorActionParameters

CacheType

Уровень, на котором необходимо кэшировать содержимое.

Имя Тип Описание
All

string

ClientPortMatchConditionParameters

Определяет параметры для условий соответствия ClientPort.

Имя Тип Default value Описание
matchValues

string[]

Значение соответствия для условия правила доставки

negateCondition

boolean

False

Описывает, является ли это условие неуявным или нет

operator

ClientPortOperator

Описывает оператор для сопоставления

transforms

transform[]

Список преобразований.

typeName enum:

DeliveryRuleClientPortConditionParameters

ClientPortOperator

Описывает оператор для сопоставления

Имя Тип Описание
Any

string

BeginsWith

string

Contains

string

EndsWith

string

Equal

string

GreaterThan

string

GreaterThanOrEqual

string

LessThan

string

LessThanOrEqual

string

RegEx

string

CookiesMatchConditionParameters

Определяет параметры для условий соответствия файлов cookie.

Имя Тип Default value Описание
matchValues

string[]

Значение соответствия для условия правила доставки

negateCondition

boolean

False

Описывает, является ли это условие неуявным или нет

operator

CookiesOperator

Описывает оператор для сопоставления

selector

string

Имя файлов cookie для сопоставления

transforms

transform[]

Список преобразований.

typeName enum:

DeliveryRuleCookiesConditionParameters

CookiesOperator

Описывает оператор для сопоставления

Имя Тип Описание
Any

string

BeginsWith

string

Contains

string

EndsWith

string

Equal

string

GreaterThan

string

GreaterThanOrEqual

string

LessThan

string

LessThanOrEqual

string

RegEx

string

DeepCreatedCustomDomain

Личные домены, созданные в конечной точке CDN.

Имя Тип Описание
name

string

Имя личного домена.

properties.hostName

string

Имя узла личного домена. Это должно быть доменное имя.

properties.validationData

string

При доставке CDN в некоторые регионы может потребоваться специальная проверка или данные из-за локальных причин соответствия требованиям. Например, для доставки содержимого в Китай требуется номер лицензии ICP личного домена.

DeepCreatedOrigin

Main источник содержимого CDN, которое добавляется при создании конечной точки CDN.

Имя Тип Описание
name

string

Имя источника, которое должно быть уникальным в пределах конечной точки.

properties.enabled

boolean

Источник включен для балансировки нагрузки. По умолчанию источник всегда включен.

properties.hostName

string

Адрес источника. Это может быть доменное имя, IPv4-адрес или IPv6-адрес. Он должен быть уникальным для всех источников в конечной точке.

properties.httpPort

integer

Значение HTTP-порта. Значение должно находиться в диапазоне от 1 до 65535.

properties.httpsPort

integer

Значение порта HTTPS. Значение должно находиться в диапазоне от 1 до 65535.

properties.originHostHeader

string

Значение заголовка узла, отправляемое источнику с каждым запросом. Если оставить это поле пустым, имя узла запроса определяет это значение. Источники Azure CDN, такие как веб-приложения, хранилище BLOB-объектов и Облачные службы требуют, чтобы это значение заголовка узла соответствовало имени исходного узла по умолчанию.

properties.priority

integer

Приоритет источника в заданной группе источников для балансировки нагрузки. Более высокие приоритеты не будут использоваться для балансировки нагрузки, если какой-либо источник с более низким приоритетом работоспособен. Значение должно находиться в диапазоне от 1 до 5.

properties.privateEndpointStatus

PrivateEndpointStatus

Состояние утверждения подключения к Приватный канал

properties.privateLinkAlias

string

Псевдоним ресурса Приватный канал. Заполнение этого необязательного поля указывает, что источником является "Частный"

properties.privateLinkApprovalMessage

string

Пользовательское сообщение, включаемое в запрос на утверждение для подключения к Приватный канал.

properties.privateLinkLocation

string

Расположение ресурса Приватный канал. Требуется только при заполнении "privateLinkResourceId"

properties.privateLinkResourceId

string

Идентификатор ресурса Приватный канал. Заполнение этого необязательного поля указывает, что серверная часть является частной.

properties.weight

integer

Вес источника в заданной группе источников для балансировки нагрузки. Должно быть от 1 до 1000

DeepCreatedOriginGroup

Группа источников для содержимого CDN, добавляемого при создании конечной точки CDN. Трафик отправляется в источники в группе источников на основе работоспособности источника.

Имя Тип Описание
name

string

Имя группы источников, которое должно быть уникальным в пределах конечной точки.

properties.healthProbeSettings

HealthProbeParameters

Параметры пробы работоспособности для источника, используемого для определения работоспособности источника.

properties.origins

ResourceReference[]

Источник содержимого, доставляемого через CDN в заданной исходной группе.

properties.responseBasedOriginErrorDetectionSettings

ResponseBasedOriginErrorDetectionParameters

Объект JSON, содержащий свойства для определения работоспособности источника с помощью реальных запросов и ответов. В настоящее время это свойство не поддерживается.

properties.trafficRestorationTimeToHealedOrNewEndpointsInMinutes

integer

Время в минутах для постепенного перемещения трафика в конечную точку, когда неработоспособная конечная точка становится работоспособной или добавляется новая конечная точка. Значение по умолчанию — 10 минут. В настоящее время это свойство не поддерживается.

DeliveryPolicy

Политика, указывающая правила доставки, которые будут использоваться для конечной точки.

Имя Тип Описание
description

string

Понятное описание политики.

rules

DeliveryRule[]

Список правил доставки.

DeliveryRule

Правило, указывающее набор действий и условий.

Имя Тип Описание
actions DeliveryRuleAction[]:

Список действий, выполняемых при выполнении всех условий правила.

conditions DeliveryRuleCondition[]:

Список условий, которые должны быть сопоставлены для выполнения действий.

name

string

Имя правила.

order

integer

Порядок применения правил для конечной точки. Возможные значения {0,1,2,3,.........}. Правило с меньшим порядком будет применяться перед правилом с большим порядком. Правило в порядке 0 — это специальное правило. Для него не требуется никаких условий, и действия, перечисленные в нем, будут применяться всегда.

DeliveryRuleCacheExpirationAction

Определяет действие истечения срока действия кэша для правила доставки.

Имя Тип Описание
name string:

CacheExpiration

Имя действия для правила доставки.

parameters

CacheExpirationActionParameters

Определяет параметры для действия.

DeliveryRuleCacheKeyQueryStringAction

Определяет действие строки запроса ключа кэша для правила доставки.

Имя Тип Описание
name string:

CacheKeyQueryString

Имя действия для правила доставки.

parameters

CacheKeyQueryStringActionParameters

Определяет параметры для действия.

DeliveryRuleClientPortCondition

Определяет условие ClientPort для правила доставки.

Имя Тип Описание
name string:

ClientPort

Имя условия для правила доставки.

parameters

ClientPortMatchConditionParameters

Определяет параметры условия.

DeliveryRuleCookiesCondition

Определяет условие файлов cookie для правила доставки.

Имя Тип Описание
name string:

Cookies

Имя условия для правила доставки.

parameters

CookiesMatchConditionParameters

Определяет параметры для условия.

DeliveryRuleHostNameCondition

Определяет условие HostName для правила доставки.

Имя Тип Описание
name string:

HostName

Имя условия для правила доставки.

parameters

HostNameMatchConditionParameters

Определяет параметры условия.

DeliveryRuleHttpVersionCondition

Определяет условие HttpVersion для правила доставки.

Имя Тип Описание
name string:

HttpVersion

Имя условия для правила доставки.

parameters

HttpVersionMatchConditionParameters

Определяет параметры для условия.

DeliveryRuleIsDeviceCondition

Определяет условие IsDevice для правила доставки.

Имя Тип Описание
name string:

IsDevice

Имя условия для правила доставки.

parameters

IsDeviceMatchConditionParameters

Определяет параметры для условия.

DeliveryRulePostArgsCondition

Определяет условие PostArgs для правила доставки.

Имя Тип Описание
name string:

PostArgs

Имя условия для правила доставки.

parameters

PostArgsMatchConditionParameters

Определяет параметры для условия.

DeliveryRuleQueryStringCondition

Определяет условие QueryString для правила доставки.

Имя Тип Описание
name string:

QueryString

Имя условия для правила доставки.

parameters

QueryStringMatchConditionParameters

Определяет параметры для условия.

DeliveryRuleRemoteAddressCondition

Определяет условие RemoteAddress для правила доставки.

Имя Тип Описание
name string:

RemoteAddress

Имя условия для правила доставки.

parameters

RemoteAddressMatchConditionParameters

Определяет параметры для условия.

DeliveryRuleRequestBodyCondition

Определяет условие RequestBody для правила доставки.

Имя Тип Описание
name string:

RequestBody

Имя условия для правила доставки.

parameters

RequestBodyMatchConditionParameters

Определяет параметры для условия.

DeliveryRuleRequestHeaderAction

Определяет действие заголовка запроса для правила доставки.

Имя Тип Описание
name string:

ModifyRequestHeader

Имя действия для правила доставки.

parameters

HeaderActionParameters

Определяет параметры для действия.

DeliveryRuleRequestHeaderCondition

Определяет условие RequestHeader для правила доставки.

Имя Тип Описание
name string:

RequestHeader

Имя условия для правила доставки.

parameters

RequestHeaderMatchConditionParameters

Определяет параметры для условия.

DeliveryRuleRequestMethodCondition

Определяет условие RequestMethod для правила доставки.

Имя Тип Описание
name string:

RequestMethod

Имя условия для правила доставки.

parameters

RequestMethodMatchConditionParameters

Определяет параметры для условия.

DeliveryRuleRequestSchemeCondition

Определяет условие RequestScheme для правила доставки.

Имя Тип Описание
name string:

RequestScheme

Имя условия для правила доставки.

parameters

RequestSchemeMatchConditionParameters

Определяет параметры для условия.

DeliveryRuleRequestUriCondition

Определяет условие RequestUri для правила доставки.

Имя Тип Описание
name string:

RequestUri

Имя условия для правила доставки.

parameters

RequestUriMatchConditionParameters

Определяет параметры для условия.

DeliveryRuleResponseHeaderAction

Определяет действие заголовка ответа для правила доставки.

Имя Тип Описание
name string:

ModifyResponseHeader

Имя действия для правила доставки.

parameters

HeaderActionParameters

Определяет параметры для действия.

DeliveryRuleRouteConfigurationOverrideAction

Определяет действие переопределения конфигурации маршрута для правила доставки. Применимо только к профилям Frontdoor уровня "Стандартный" или "Премиум".

Имя Тип Описание
name string:

RouteConfigurationOverride

Имя действия для правила доставки.

parameters

RouteConfigurationOverrideActionParameters

Определяет параметры для действия.

DeliveryRuleServerPortCondition

Определяет условие ServerPort для правила доставки.

Имя Тип Описание
name string:

ServerPort

Имя условия для правила доставки.

parameters

ServerPortMatchConditionParameters

Определяет параметры условия.

DeliveryRuleSocketAddrCondition

Определяет условие SocketAddress для правила доставки.

Имя Тип Описание
name string:

SocketAddr

Имя условия для правила доставки.

parameters

SocketAddrMatchConditionParameters

Определяет параметры условия.

DeliveryRuleSslProtocolCondition

Определяет условие SslProtocol для правила доставки.

Имя Тип Описание
name string:

SslProtocol

Имя условия для правила доставки.

parameters

SslProtocolMatchConditionParameters

Определяет параметры условия.

DeliveryRuleUrlFileExtensionCondition

Определяет условие UrlFileExtension для правила доставки.

Имя Тип Описание
name string:

UrlFileExtension

Имя условия для правила доставки.

parameters

UrlFileExtensionMatchConditionParameters

Определяет параметры для условия.

DeliveryRuleUrlFileNameCondition

Определяет условие UrlFileName для правила доставки.

Имя Тип Описание
name string:

UrlFileName

Имя условия для правила доставки.

parameters

UrlFileNameMatchConditionParameters

Определяет параметры для условия.

DeliveryRuleUrlPathCondition

Определяет условие UrlPath для правила доставки.

Имя Тип Описание
name string:

UrlPath

Имя условия для правила доставки.

parameters

UrlPathMatchConditionParameters

Определяет параметры для условия.

DestinationProtocol

Протокол, используемый для перенаправления. Значение по умолчанию — MatchRequest.

Имя Тип Описание
Http

string

Https

string

MatchRequest

string

Endpoint

Конечная точка CDN — это сущность в профиле CDN, содержащая сведения о конфигурации, такие как источник, протокол, кэширование содержимого и поведение доставки. Конечная точка CDN использует формат URL-адреса azureedge.net.

Имя Тип Default value Описание
id

string

Идентификатор ресурса.

location

string

Расположение ресурса.

name

string

Имя ресурса.

properties.contentTypesToCompress

string[]

Список типов контента, к которым применяется сжатие. Значение должно быть допустимым типом MIME.

properties.customDomains

DeepCreatedCustomDomain[]

Личные домены в конечной точке.

properties.defaultOriginGroup

ResourceReference

Ссылка на группу источников.

properties.deliveryPolicy

DeliveryPolicy

Политика, указывающая правила доставки, используемые для конечной точки.

properties.geoFilters

GeoFilter[]

Список правил, определяющих геодоступ пользователя в конечной точке CDN. Каждый геофильтр определяет правило доступа к указанному пути или содержимому, например блокировать APAC для пути /pictures/

properties.hostName

string

Имя узла конечной точки, структурированное как {endpointName}. {DNSZone}, например contoso.azureedge.net

properties.isCompressionEnabled

boolean

Указывает, включено ли сжатие содержимого в CDN. Значение по умолчанию — false. Если сжатие включено, содержимое будет использоваться как сжатое, если пользователь запрашивает сжатую версию. Содержимое не сжимается в CDN, если запрошенное содержимое меньше 1 байта или больше 1 МБ.

properties.isHttpAllowed

boolean

True

Указывает, разрешен ли http-трафик в конечной точке. Значение по умолчанию — true. Должен быть разрешен по крайней мере один протокол (HTTP или HTTPS).

properties.isHttpsAllowed

boolean

True

Указывает, разрешен ли трафик HTTPS в конечной точке. Значение по умолчанию — true. Должен быть разрешен по крайней мере один протокол (HTTP или HTTPS).

properties.optimizationType

OptimizationType

Указывает, для какого сценария клиент хочет оптимизировать эту конечную точку CDN, например скачивание, службы мультимедиа. Используя эти сведения, CDN может применять оптимизацию на основе сценария.

properties.originGroups

DeepCreatedOriginGroup[]

Группы источников, состоящие из источников, которые используются для балансировки нагрузки трафика на основе доступности.

properties.originHostHeader

string

Значение заголовка узла, отправляемое источнику с каждым запросом. Это свойство в конечной точке разрешено, только если конечная точка использует один источник, и может быть переопределено тем же свойством, указанным в источнике. Если оставить это поле пустым, имя узла запроса определяет это значение. Источники Azure CDN, такие как веб-приложения, хранилище BLOB-объектов и Облачные службы требуют, чтобы это значение заголовка узла соответствовало имени исходного узла по умолчанию.

properties.originPath

string

Путь к каталогу в источнике, который CDN может использовать для получения содержимого, например contoso.cloudapp.net/originpath.

properties.origins

DeepCreatedOrigin[]

Источник содержимого, доставляемого через CDN.

properties.probePath

string

Путь к файлу, размещенном в источнике, что помогает ускорить доставку динамического содержимого и вычислить наиболее оптимальные маршруты для CDN. Это относится к исходному пути. Это свойство применимо только при использовании одного источника.

properties.provisioningState

EndpointProvisioningState

Состояние подготовки конечной точки.

properties.queryStringCachingBehavior

QueryStringCachingBehavior

NotSet

Определяет, как CDN кэширует запросы, включающие строки запроса. При кэшировании можно игнорировать любые строки запроса, обходить кэширование, чтобы предотвратить кэширование запросов, содержащих строки запроса, или кэшировать каждый запрос с уникальным URL-адресом.

properties.resourceState

EndpointResourceState

Состояние ресурса конечной точки.

properties.urlSigningKeys

UrlSigningKey[]

Список ключей, используемых для проверки хэшей подписанных URL-адресов.

properties.webApplicationFirewallPolicyLink

WebApplicationFirewallPolicyLink

Определяет политику Брандмауэр веб-приложений для конечной точки (если применимо).

systemData

SystemData

Чтение только системных данных

tags

object

Теги ресурсов.

type

string

Тип ресурса.

EndpointProvisioningState

Состояние подготовки конечной точки.

Имя Тип Описание
Creating

string

Deleting

string

Failed

string

Succeeded

string

Updating

string

EndpointResourceState

Состояние ресурса конечной точки.

Имя Тип Описание
Creating

string

Deleting

string

Running

string

Starting

string

Stopped

string

Stopping

string

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

Имя Тип Описание
info

object

Дополнительные сведения.

type

string

Тип дополнительных сведений.

ErrorDetail

Сведения об ошибке.

Имя Тип Описание
additionalInfo

ErrorAdditionalInfo[]

Дополнительные сведения об ошибке.

code

string

Код ошибки.

details

ErrorDetail[]

Сведения об ошибке.

message

string

Сообщение об ошибке.

target

string

Целевой объект ошибки.

ErrorResponse

Сообщение об ошибке

Имя Тип Описание
error

ErrorDetail

Объект error.

ForwardingProtocol

Протокол, который будет использоваться этим правилом при переадресации трафика на серверные серверы.

Имя Тип Описание
HttpOnly

string

HttpsOnly

string

MatchRequest

string

GeoFilter

Правила, определяющие геодоступ пользователя в конечной точке CDN.

Имя Тип Описание
action

GeoFilterActions

Действие геофильтра, т. е. разрешение или блокировка доступа.

countryCodes

string[]

Двухбуквенный код страны или региона, определяющий доступ пользователя к стране или региону в географическом фильтре, например AU, MX, США.

relativePath

string

Относительный путь, применимый к геофильтру. (например, "/mypictures", "/mypicture/kitty.jpg" и т. д.)

GeoFilterActions

Действие геофильтра, т. е. разрешение или блокировка доступа.

Имя Тип Описание
Allow

string

Block

string

HeaderAction

Осуществляемое действие

Имя Тип Описание
Append

string

Delete

string

Overwrite

string

HeaderActionParameters

Определяет параметры для действия заголовка запроса.

Имя Тип Описание
headerAction

HeaderAction

Осуществляемое действие

headerName

string

Имя заголовка для изменения

typeName enum:

DeliveryRuleHeaderActionParameters

value

string

Значение для указанного действия

HealthProbeParameters

Объект JSON, содержащий свойства для отправки проб работоспособности в источник.

Имя Тип Описание
probeIntervalInSeconds

integer

Количество секунд между пробами работоспособности. Значение по умолчанию — 240 секунд.

probePath

string

Путь относительно источника, который используется для определения работоспособности источника.

probeProtocol

ProbeProtocol

Протокол, используемый для пробы работоспособности.

probeRequestType

HealthProbeRequestType

Тип выполненного запроса пробы работоспособности.

HealthProbeRequestType

Тип выполненного запроса пробы работоспособности.

Имя Тип Описание
GET

string

HEAD

string

NotSet

string

HostNameMatchConditionParameters

Определяет параметры для условий соответствия HostName.

Имя Тип Default value Описание
matchValues

string[]

Значение соответствия для условия правила доставки

negateCondition

boolean

False

Описывает, является ли это условие неуявным или нет

operator

HostNameOperator

Описывает оператор для сопоставления

transforms

transform[]

Список преобразований.

typeName enum:

DeliveryRuleHostNameConditionParameters

HostNameOperator

Описывает оператор для сопоставления

Имя Тип Описание
Any

string

BeginsWith

string

Contains

string

EndsWith

string

Equal

string

GreaterThan

string

GreaterThanOrEqual

string

LessThan

string

LessThanOrEqual

string

RegEx

string

HttpErrorRangeParameters

Объект JSON, представляющий диапазон для кодов состояния HTTP.

Имя Тип Описание
begin

integer

Инклюзивное начало диапазона кодов состояния HTTP.

end

integer

Инклюзивный конец диапазона кодов состояния HTTP.

HttpVersionMatchConditionParameters

Определяет параметры для условий соответствия HttpVersion.

Имя Тип Default value Описание
matchValues

string[]

Значение соответствия для условия правила доставки

negateCondition

boolean

False

Описывает, является ли это условие неуявным или нет

operator

HttpVersionOperator

Описывает оператор для сопоставления

transforms

transform[]

Список преобразований.

typeName enum:

DeliveryRuleHttpVersionConditionParameters

HttpVersionOperator

Описывает оператор для сопоставления

Имя Тип Описание
Equal

string

IdentityType

Тип удостоверения, создающего или изменяющего ресурсы

Имя Тип Описание
application

string

key

string

managedIdentity

string

user

string

IsDeviceMatchConditionParameters

Определяет параметры для условий соответствия IsDevice.

Имя Тип Default value Описание
matchValues

MatchValues[]

Значение соответствия для условия правила доставки

negateCondition

boolean

False

Описывает, является ли это условие неуявным или нет

operator

IsDeviceOperator

Описывает оператор для сопоставления

transforms

transform[]

Список преобразований.

typeName enum:

DeliveryRuleIsDeviceConditionParameters

IsDeviceOperator

Описывает оператор для сопоставления

Имя Тип Описание
Equal

string

KeyVaultSigningKeyParameters

Описание параметров для использования keyVault пользователя для ключа подписи URL-адреса.

Имя Тип Описание
resourceGroupName

string

Группа ресурсов Key Vault пользователя, содержащая секрет

secretName

string

Имя секрета в Key Vault.

secretVersion

string

Версия (GUID) секрета в Key Vault.

subscriptionId

string

Идентификатор подписки Key Vault пользователя, содержащего секрет

typeName enum:

KeyVaultSigningKeyParameters

vaultName

string

Имя Key Vault пользователя, содержащего секрет.

MatchValues

Значение соответствия для условия правила доставки

Имя Тип Описание
DELETE

string

GET

string

HEAD

string

OPTIONS

string

POST

string

PUT

string

TRACE

string

OptimizationType

Указывает сценарий, в котором клиент хочет оптимизировать эту конечную точку CDN, например скачивание служб мультимедиа. С помощью этих сведений можно применить оптимизацию на основе сценария.

Имя Тип Описание
DynamicSiteAcceleration

string

GeneralMediaStreaming

string

GeneralWebDelivery

string

LargeFileDownload

string

VideoOnDemandMediaStreaming

string

OriginGroupOverride

Определяет параметры для конфигурации переопределения группы-источника.

Имя Тип Описание
forwardingProtocol

ForwardingProtocol

Протокол, который будет использоваться этим правилом при переадресации трафика на серверные серверы.

originGroup

ResourceReference

определяет OriginGroup, которая переопределяет DefaultOriginGroup в маршруте.

OriginGroupOverrideAction

Определяет действие переопределения группы-источника для правила доставки.

Имя Тип Описание
name string:

OriginGroupOverride

Имя действия для правила доставки.

parameters

OriginGroupOverrideActionParameters

Определяет параметры для действия.

OriginGroupOverrideActionParameters

Определяет параметры для действия переопределения группы источников.

Имя Тип Описание
originGroup

ResourceReference

определяет OriginGroup, которая переопределяет DefaultOriginGroup.

typeName enum:

DeliveryRuleOriginGroupOverrideActionParameters

paramIndicator

Указывает назначение параметра.

Имя Тип Описание
Expires

string

KeyId

string

Signature

string

PostArgsMatchConditionParameters

Определяет параметры для условий соответствия PostArgs.

Имя Тип Default value Описание
matchValues

string[]

Значение соответствия для условия правила доставки

negateCondition

boolean

False

Описывает, является ли это неувечающее условие

operator

PostArgsOperator

Описывает оператор для сопоставления

selector

string

Имя Сопоставляемого postArg

transforms

transform[]

Список преобразований.

typeName enum:

DeliveryRulePostArgsConditionParameters

PostArgsOperator

Описывает оператор для сопоставления

Имя Тип Описание
Any

string

BeginsWith

string

Contains

string

EndsWith

string

Equal

string

GreaterThan

string

GreaterThanOrEqual

string

LessThan

string

LessThanOrEqual

string

RegEx

string

PrivateEndpointStatus

Состояние утверждения подключения к Приватный канал

Имя Тип Описание
Approved

string

Disconnected

string

Pending

string

Rejected

string

Timeout

string

ProbeProtocol

Протокол, используемый для пробы работоспособности.

Имя Тип Описание
Http

string

Https

string

NotSet

string

queryStringBehavior

Поведение кэширования для запросов

Имя Тип Описание
Exclude

string

ExcludeAll

string

Include

string

IncludeAll

string

QueryStringCachingBehavior

Определяет, как CDN кэширует запросы, включающие строки запроса. Вы можете игнорировать любые строки запроса при кэшировании, обходить кэширование, чтобы предотвратить кэширование запросов, содержащих строки запроса, или кэшировать каждый запрос с уникальным URL-адресом.

Имя Тип Описание
BypassCaching

string

IgnoreQueryString

string

NotSet

string

UseQueryString

string

QueryStringMatchConditionParameters

Определяет параметры для условий соответствия QueryString.

Имя Тип Default value Описание
matchValues

string[]

Значение соответствия для условия правила доставки

negateCondition

boolean

False

Описывает, является ли это неувечающее условие

operator

QueryStringOperator

Описывает оператор для сопоставления

transforms

transform[]

Список преобразований.

typeName enum:

DeliveryRuleQueryStringConditionParameters

QueryStringOperator

Описывает оператор для сопоставления

Имя Тип Описание
Any

string

BeginsWith

string

Contains

string

EndsWith

string

Equal

string

GreaterThan

string

GreaterThanOrEqual

string

LessThan

string

LessThanOrEqual

string

RegEx

string

RedirectType

Тип перенаправления, который будет использоваться правилом при перенаправлении трафика.

Имя Тип Описание
Found

string

Moved

string

PermanentRedirect

string

TemporaryRedirect

string

RemoteAddressMatchConditionParameters

Определяет параметры для условий соответствия RemoteAddress.

Имя Тип Default value Описание
matchValues

string[]

Сопоставление значений для сопоставления. Оператор будет применяться к каждому значению в семантике ИЛИ. Если какой-либо из них соответствует переменной с заданным оператором, это условие соответствия считается соответствием.

negateCondition

boolean

False

Описывает, является ли это неувечающее условие

operator

RemoteAddressOperator

Описывает оператор для сопоставления

transforms

transform[]

Список преобразований.

typeName enum:

DeliveryRuleRemoteAddressConditionParameters

RemoteAddressOperator

Описывает оператор для сопоставления

Имя Тип Описание
Any

string

GeoMatch

string

IPMatch

string

RequestBodyMatchConditionParameters

Определяет параметры для условий соответствия RequestBody.

Имя Тип Default value Описание
matchValues

string[]

Значение соответствия для условия правила доставки

negateCondition

boolean

False

Описывает, является ли это неувечающее условие

operator

RequestBodyOperator

Описывает оператор для сопоставления

transforms

transform[]

Список преобразований.

typeName enum:

DeliveryRuleRequestBodyConditionParameters

RequestBodyOperator

Описывает оператор для сопоставления

Имя Тип Описание
Any

string

BeginsWith

string

Contains

string

EndsWith

string

Equal

string

GreaterThan

string

GreaterThanOrEqual

string

LessThan

string

LessThanOrEqual

string

RegEx

string

RequestHeaderMatchConditionParameters

Определяет параметры для условий соответствия RequestHeader.

Имя Тип Default value Описание
matchValues

string[]

Значение соответствия для условия правила доставки

negateCondition

boolean

False

Описывает, является ли это неувечающее условие

operator

RequestHeaderOperator

Описывает оператор для сопоставления

selector

string

Имя соответствующего заголовка

transforms

transform[]

Список преобразований.

typeName enum:

DeliveryRuleRequestHeaderConditionParameters

RequestHeaderOperator

Описывает оператор для сопоставления

Имя Тип Описание
Any

string

BeginsWith

string

Contains

string

EndsWith

string

Equal

string

GreaterThan

string

GreaterThanOrEqual

string

LessThan

string

LessThanOrEqual

string

RegEx

string

RequestMethodMatchConditionParameters

Определяет параметры для условий соответствия RequestMethod.

Имя Тип Default value Описание
matchValues

MatchValues[]

Значение соответствия для условия правила доставки

negateCondition

boolean

False

Описывает, является ли это неувечающее условие

operator

RequestMethodOperator

Описывает оператор для сопоставления

transforms

transform[]

Список преобразований.

typeName enum:

DeliveryRuleRequestMethodConditionParameters

RequestMethodOperator

Описывает оператор для сопоставления

Имя Тип Описание
Equal

string

RequestSchemeMatchConditionParameters

Определяет параметры для условий соответствия RequestScheme.

Имя Тип Default value Описание
matchValues

MatchValues[]

Значение соответствия для условия правила доставки

negateCondition

boolean

False

Описывает, является ли это неувечающее условие

operator enum:

Equal

Описывает оператор для сопоставления

transforms

transform[]

Список преобразований.

typeName enum:

DeliveryRuleRequestSchemeConditionParameters

RequestUriMatchConditionParameters

Определяет параметры для условий соответствия RequestUri

Имя Тип Default value Описание
matchValues

string[]

Значение соответствия для условия правила доставки

negateCondition

boolean

False

Описывает, является ли это неувечающее условие

operator

RequestUriOperator

Описывает оператор для сопоставления

transforms

transform[]

Список преобразований.

typeName enum:

DeliveryRuleRequestUriConditionParameters

RequestUriOperator

Описывает оператор для сопоставления

Имя Тип Описание
Any

string

BeginsWith

string

Contains

string

EndsWith

string

Equal

string

GreaterThan

string

GreaterThanOrEqual

string

LessThan

string

LessThanOrEqual

string

RegEx

string

ResourceReference

Ссылка на другой ресурс.

Имя Тип Описание
id

string

Идентификатор ресурса.

ResponseBasedDetectedErrorTypes

Тип ошибок ответа для запросов реальных пользователей, источник которых будет считаться неработоспособным

Имя Тип Описание
None

string

TcpAndHttpErrors

string

TcpErrorsOnly

string

ResponseBasedOriginErrorDetectionParameters

Объект JSON, содержащий свойства для определения работоспособности источника с помощью реальных запросов и ответов.

Имя Тип Описание
httpErrorRanges

HttpErrorRangeParameters[]

Список диапазонов кодов состояния HTTP, которые считаются ошибками сервера для источника и помечены как неработоспособные.

responseBasedDetectedErrorTypes

ResponseBasedDetectedErrorTypes

Тип ошибок ответа для запросов реальных пользователей, источник которых будет считаться неработоспособным

responseBasedFailoverThresholdPercentage

integer

Процент неудачных запросов в примере, в котором должна активироваться отработка отказа.

RouteConfigurationOverrideActionParameters

Определяет параметры для действия переопределения конфигурации маршрута.

Имя Тип Описание
cacheConfiguration

CacheConfiguration

Конфигурация кэширования, связанная с этим правилом. Чтобы отключить кэширование, не предоставляйте объект cacheConfiguration.

originGroupOverride

OriginGroupOverride

Ссылка на конфигурацию переопределения группы источников. Оставьте пустым, чтобы использовать группу источников по умолчанию для маршрута.

typeName enum:

DeliveryRuleRouteConfigurationOverrideActionParameters

ruleCacheBehavior

Поведение кэширования для запросов

Имя Тип Описание
HonorOrigin

string

OverrideAlways

string

OverrideIfOriginMissing

string

ruleIsCompressionEnabled

Указывает, включено ли сжатие содержимого. Если сжатие включено, содержимое будет использоваться как сжатое, если пользователь запрашивает сжатую версию. Содержимое не сжимается в AzureFrontDoor, если запрошенное содержимое меньше 1 байта или больше 1 МБ.

Имя Тип Описание
Disabled

string

Enabled

string

ruleQueryStringCachingBehavior

Определяет, как Frontdoor кэширует запросы, включающие строки запроса. При кэшировании можно игнорировать любые строки запроса, игнорировать определенные строки запроса, кэшировать каждый запрос с уникальным URL-адресом или кэшировать определенные строки запроса.

Имя Тип Описание
IgnoreQueryString

string

IgnoreSpecifiedQueryStrings

string

IncludeSpecifiedQueryStrings

string

UseQueryString

string

ServerPortMatchConditionParameters

Определяет параметры для условий соответствия ServerPort.

Имя Тип Default value Описание
matchValues

string[]

Значение соответствия для условия правила доставки

negateCondition

boolean

False

Описывает, является ли это условие неуявным или нет

operator

ServerPortOperator

Описывает оператор для сопоставления

transforms

transform[]

Список преобразований.

typeName enum:

DeliveryRuleServerPortConditionParameters

ServerPortOperator

Описывает оператор для сопоставления

Имя Тип Описание
Any

string

BeginsWith

string

Contains

string

EndsWith

string

Equal

string

GreaterThan

string

GreaterThanOrEqual

string

LessThan

string

LessThanOrEqual

string

RegEx

string

SocketAddrMatchConditionParameters

Определяет параметры для условий соответствия SocketAddress.

Имя Тип Default value Описание
matchValues

string[]

Значение соответствия для условия правила доставки

negateCondition

boolean

False

Описывает, является ли это условие неуявным или нет

operator

SocketAddrOperator

Описывает оператор для сопоставления

transforms

transform[]

Список преобразований.

typeName enum:

DeliveryRuleSocketAddrConditionParameters

SocketAddrOperator

Описывает оператор для сопоставления

Имя Тип Описание
Any

string

IPMatch

string

SslProtocol

Протокол установленного подключения TLS.

Имя Тип Описание
TLSv1

string

TLSv1.1

string

TLSv1.2

string

SslProtocolMatchConditionParameters

Определяет параметры для условий соответствия SslProtocol

Имя Тип Default value Описание
matchValues

SslProtocol[]

Значение соответствия для условия правила доставки

negateCondition

boolean

False

Описывает, является ли это условие неуявным или нет

operator

SslProtocolOperator

Описывает оператор для сопоставления

transforms

transform[]

Список преобразований.

typeName enum:

DeliveryRuleSslProtocolConditionParameters

SslProtocolOperator

Описывает оператор для сопоставления

Имя Тип Описание
Equal

string

SystemData

Чтение только системных данных

Имя Тип Описание
createdAt

string

Метка времени создания ресурса (UTC)

createdBy

string

Идентификатор удостоверения, создавшего ресурс.

createdByType

IdentityType

Тип удостоверения, создавшего ресурс.

lastModifiedAt

string

Метка времени последнего изменения ресурса (UTC)

lastModifiedBy

string

Идентификатор удостоверения, который последний раз изменял ресурс.

lastModifiedByType

IdentityType

Тип удостоверения, который последний раз изменял ресурс.

transform

Описывает, какие преобразования применяются перед сопоставлением

Имя Тип Описание
Lowercase

string

RemoveNulls

string

Trim

string

Uppercase

string

UrlDecode

string

UrlEncode

string

UrlFileExtensionMatchConditionParameters

Определяет параметры для условий соответствия UrlFileExtension.

Имя Тип Default value Описание
matchValues

string[]

Значение соответствия для условия правила доставки

negateCondition

boolean

False

Описывает, является ли это неувечающее условие

operator

UrlFileExtensionOperator

Описывает оператор для сопоставления

transforms

transform[]

Список преобразований.

typeName enum:

DeliveryRuleUrlFileExtensionMatchConditionParameters

UrlFileExtensionOperator

Описывает оператор для сопоставления

Имя Тип Описание
Any

string

BeginsWith

string

Contains

string

EndsWith

string

Equal

string

GreaterThan

string

GreaterThanOrEqual

string

LessThan

string

LessThanOrEqual

string

RegEx

string

UrlFileNameMatchConditionParameters

Определяет параметры для условий соответствия UrlFilename.

Имя Тип Default value Описание
matchValues

string[]

Значение соответствия для условия правила доставки

negateCondition

boolean

False

Описывает, является ли это неувечающее условие

operator

UrlFileNameOperator

Описывает оператор для сопоставления

transforms

transform[]

Список преобразований.

typeName enum:

DeliveryRuleUrlFilenameConditionParameters

UrlFileNameOperator

Описывает оператор для сопоставления

Имя Тип Описание
Any

string

BeginsWith

string

Contains

string

EndsWith

string

Equal

string

GreaterThan

string

GreaterThanOrEqual

string

LessThan

string

LessThanOrEqual

string

RegEx

string

UrlPathMatchConditionParameters

Определяет параметры для условий соответствия UrlPath.

Имя Тип Default value Описание
matchValues

string[]

Значение соответствия для условия правила доставки

negateCondition

boolean

False

Описывает, является ли это неувечающее условие

operator

UrlPathOperator

Описывает оператор для сопоставления

transforms

transform[]

Список преобразований.

typeName enum:

DeliveryRuleUrlPathMatchConditionParameters

UrlPathOperator

Описывает оператор для сопоставления

Имя Тип Описание
Any

string

BeginsWith

string

Contains

string

EndsWith

string

Equal

string

GreaterThan

string

GreaterThanOrEqual

string

LessThan

string

LessThanOrEqual

string

RegEx

string

Wildcard

string

UrlRedirectAction

Определяет действие перенаправления URL-адреса для правила доставки.

Имя Тип Описание
name string:

UrlRedirect

Имя действия для правила доставки.

parameters

UrlRedirectActionParameters

Определяет параметры для действия.

UrlRedirectActionParameters

Определяет параметры для действия перенаправления URL-адреса.

Имя Тип Описание
customFragment

string

Фрагмент для добавления в URL-адрес перенаправления. Фрагмент — это часть URL-адреса, которая поступает после #. Не включайте #.

customHostname

string

Узел для перенаправления. Оставьте пустым, чтобы использовать входящий узел в качестве конечного узла.

customPath

string

Полный путь для перенаправления. Путь не может быть пустым и должен начинаться с /. Оставьте пустым, чтобы использовать входящий путь в качестве пути назначения.

customQueryString

string

Набор строк запроса, помещаемых в URL-адрес перенаправления. Установка этого значения заменит любую существующую строку запроса; Оставьте пустым, чтобы сохранить строку входящего запроса. Строка запроса должна быть в формате =. ? и & будут добавлены автоматически, поэтому не включайте их.

destinationProtocol

DestinationProtocol

Протокол, используемый для перенаправления. Значение по умолчанию — MatchRequest.

redirectType

RedirectType

Тип перенаправления, который будет использоваться правилом при перенаправлении трафика.

typeName enum:

DeliveryRuleUrlRedirectActionParameters

UrlRewriteAction

Определяет действие перезаписи URL-адреса для правила доставки.

Имя Тип Описание
name string:

UrlRewrite

Имя действия для правила доставки.

parameters

UrlRewriteActionParameters

Определяет параметры для действия.

UrlRewriteActionParameters

Определяет параметры для действия переопределения URL-адреса.

Имя Тип Описание
destination

string

Определите относительный URL-адрес, на который будут переписаны указанные выше запросы.

preserveUnmatchedPath

boolean

Следует ли сохранять несоответвленный путь. Значение по умолчанию — true.

sourcePattern

string

определите шаблон URI запроса, который определяет тип запросов, которые могут быть перезаписаны. Если значение пусто, сопоставляются все строки.

typeName enum:

DeliveryRuleUrlRewriteActionParameters

UrlSigningAction

Определяет действие подписывания URL-адреса для правила доставки.

Имя Тип Описание
name string:

UrlSigning

Имя действия для правила доставки.

parameters

UrlSigningActionParameters

Определяет параметры для действия.

UrlSigningActionParameters

Определяет параметры для действия Подписывание URL-адресов.

Имя Тип Описание
algorithm

algorithm

Алгоритм, используемый для подписывания URL-адреса

parameterNameOverride

UrlSigningParamIdentifier[]

Определяет параметры строки запроса в URL-адресе, которые будут учитываться для истечения срока действия, идентификатора ключа и т. д.

typeName enum:

DeliveryRuleUrlSigningActionParameters

UrlSigningKey

Ключ подписывания URL-адреса

Имя Тип Описание
keyId

string

Определяет определенный клиентом идентификатор ключа. Этот идентификатор будет существовать во входящем запросе для указания ключа, используемого для формирования хэша.

keySourceParameters

KeyVaultSigningKeyParameters

Определяет параметры для использования хранилища ключей клиента для ключа подписывания URL-адреса.

UrlSigningParamIdentifier

Определяет, как определить параметр для определенной цели, например истекает

Имя Тип Описание
paramIndicator

paramIndicator

Указывает назначение параметра.

paramName

string

Имя параметра

Определяет политику Брандмауэр веб-приложений для конечной точки (если применимо).

Имя Тип Описание
id

string

Идентификатор ресурса.