Http Route Config - List

Referencia

Servicio:: Azure Container Apps

Versión de la API:: 2025-02-02-preview

Obtenga las rutas HTTP administradas en un entorno administrado determinado.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.App/managedEnvironments/{environmentName}/httpRouteConfigs?api-version=2025-02-02-preview

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
environmentName	path	True	string pattern: ^[-\w\._]+$	Nombre del entorno administrado.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.
subscriptionId	path	True	string minLength: 1	Identificador de la suscripción de destino.
api-version	query	True	string minLength: 1	Versión de la API que se va a usar para esta operación.

Respuestas

Nombre	Tipo	Description
200 OK	HttpRouteConfigCollection	De acuerdo
Other Status Codes	DefaultErrorResponse	Respuesta de error.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantar la cuenta de usuario

Ejemplos

List Managed Http Routes by Managed Environment

Solicitud de ejemplo

HTTP

GET https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/examplerg/providers/Microsoft.App/managedEnvironments/testcontainerenv/httpRouteConfigs?api-version=2025-02-02-preview

Respuesta de muestra

status code:: 200

{
  "value": [
    {
      "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/examplerg/providers/Microsoft.App/managedEnvironments/testcontainerenv/httpRouteConfigs/route-1",
      "type": "Microsoft.App/managedEnvironments/httpRouteConfigs",
      "properties": {
        "fqdn": "app1.example.com",
        "provisioningState": "Succeeded",
        "customDomains": [
          {
            "name": "example.com",
            "bindingType": "SniEnabled",
            "certificateId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/examplerg/providers/Microsoft.App/managedEnvironments/testcontainerenv/certificates/certificate-1"
          }
        ],
        "rules": [
          {
            "targets": [
              {
                "containerApp": "containerApp1"
              }
            ],
            "routes": [
              {
                "match": {
                  "prefix": "/api",
                  "caseSensitive": true
                },
                "action": {
                  "prefixRewrite": "/v1/api"
                }
              }
            ]
          }
        ]
      }
    },
    {
      "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/examplerg/providers/Microsoft.App/managedEnvironments/testcontainerenv/httpRouteConfigs/route-2",
      "type": "Microsoft.App/managedEnvironments/httpRouteConfigs",
      "properties": {
        "fqdn": "app2.example.com",
        "provisioningState": "Succeeded",
        "customDomains": [
          {
            "name": "example.com",
            "bindingType": "SniEnabled",
            "certificateId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/examplerg/providers/Microsoft.App/managedEnvironments/testcontainerenv/certificates/certificate-2"
          }
        ],
        "rules": [
          {
            "targets": [
              {
                "containerApp": "containerApp2",
                "revision": "rev-2",
                "weight": 50
              },
              {
                "containerApp": "containerApp2",
                "revision": "rev-3",
                "weight": 50
              }
            ],
            "routes": [
              {
                "match": {
                  "prefix": "/api",
                  "caseSensitive": false
                },
                "action": {
                  "prefixRewrite": "/v2/api"
                }
              }
            ]
          }
        ]
      }
    }
  ]
}

Definiciones

Nombre	Description
bindingType	Tipo de enlace dominio personalizado.
createdByType	Tipo de identidad que creó el recurso.
CustomDomain	Dominio personalizado de una aplicación contenedora
DefaultErrorResponse	Respuesta de error de App Service.
Details	Detalles o el error
Error	Modelo de error.
HttpRoute	Configuración de rutas HTTP, incluidas las rutas de acceso para que coincidan en y si se van a realizar reescrituras o no.
HttpRouteAction	Acción que se va a realizar una vez que se realiza la coincidencia de rutas
HttpRouteConfig	Enrutamiento de entrada avanzado para el enrutamiento basado en ruta de acceso o encabezado para un entorno de aplicación de contenedor
HttpRouteConfigCollection	Colección de recursos de configuración de enrutamiento de entrada avanzada.
HttpRouteMatch	Criterios para que coincidan
HttpRouteProvisioningErrors	Lista de errores de aprovisionamiento de un objeto de configuración de ruta http
HttpRouteProvisioningState	Estado de aprovisionamiento actual.
HttpRouteRule	Regla de ruta Http.
HttpRouteTarget	Destinos: nombres de aplicación de contenedor, nombres de revisión, etiquetas.
Properties	Propiedades de configuración de ruta http
systemData	Metadatos relativos a la creación y última modificación del recurso.

bindingType

Enumeración

Tipo de enlace dominio personalizado.

Valor	Description
Auto
Disabled
SniEnabled

createdByType

Enumeración

Tipo de identidad que creó el recurso.

Valor	Description
Application
Key
ManagedIdentity
User

CustomDomain

Object

Dominio personalizado de una aplicación contenedora

Nombre	Tipo	Description
bindingType	bindingType	Tipo de enlace dominio personalizado.
certificateId	string	Identificador de recurso del certificado que se va a enlazar a este nombre de host. Debe existir en el entorno administrado.
name	string	Nombre de host.

DefaultErrorResponse

Object

Respuesta de error de App Service.

Nombre	Tipo	Description
error	Error	Modelo de error.

Details

Object

Detalles o el error

Nombre	Tipo	Description
code	string	Cadena estandarizada para identificar mediante programación el error.
message	string	Descripción detallada del error e información de depuración.
target	string	Descripción detallada del error e información de depuración.

Error

Object

Modelo de error.

Nombre	Tipo	Description
code	string	Cadena estandarizada para identificar mediante programación el error.
details	Details[]	Detalles o el error
innererror	string	Más información para depurar el error.
message	string	Descripción detallada del error e información de depuración.
target	string	Descripción detallada del error e información de depuración.

HttpRoute

Object

Configuración de rutas HTTP, incluidas las rutas de acceso para que coincidan en y si se van a realizar reescrituras o no.

Nombre	Tipo	Description
action	HttpRouteAction	Una vez que la ruta coincide, cuál es la acción deseada
match	HttpRouteMatch	La ruta de condiciones coincidirá con

HttpRouteAction

Object

Acción que se va a realizar una vez que se realiza la coincidencia de rutas

Nombre	Tipo	Description
prefixRewrite	string	Prefijo de reescritura; el valor predeterminado no es reescritura