Http Route Config - Update

Odwołanie

Usługa:: Azure Container Apps

Wersja interfejsu API:: 2025-02-02-preview

Aktualizowanie tagów obiektu trasy http manged
Poprawia zasób konfiguracji trasy http. Obsługiwane jest tylko stosowanie poprawek tagów

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
environmentName	path	True	string	Nazwa środowiska zarządzanego.
httpRouteName	path	True	string	Nazwa zasobu konfiguracji trasy HTTP.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.
subscriptionId	path	True	string minLength: 1	Identyfikator subskrypcji docelowej.
api-version	query	True	string minLength: 1	Wersja interfejsu API do użycia dla tej operacji.

Treść żądania

Nazwa	Typ	Opis
properties	Properties	Właściwości konfiguracji trasy HTTP

Odpowiedzi

Nazwa	Typ	Opis
200 OK	HttpRouteConfig	Pomyślnie zaktualizowano zarządzane trasy HTTP.
Other Status Codes	DefaultErrorResponse	Typowa odpowiedź na błąd.

Zabezpieczenia

azure_auth

Przepływ protokołu OAuth2 usługi Azure Active Directory

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

Patch Managed Http Route

Przykładowe żądanie

HTTP

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

{
  "properties": {
    "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": "capp-1",
            "revision": "rev-1",
            "weight": 100
          }
        ],
        "routes": [
          {
            "match": {
              "path": "/v1",
              "caseSensitive": true
            },
            "action": {
              "prefixRewrite": "/v1/api"
            }
          }
        ],
        "description": "random-description"
      }
    ]
  }
}

Przykładowa odpowiedź

Kod stanu:: 200

{
  "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": "InProgress",
    "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": "capp-1",
            "revision": "rev-1",
            "weight": 100
          }
        ],
        "routes": [
          {
            "match": {
              "path": "/v1",
              "caseSensitive": true
            },
            "action": {
              "prefixRewrite": "/v1/api"
            }
          }
        ],
        "description": "random-description"
      }
    ]
  }
}

Definicje

Nazwa	Opis
bindingType	Niestandardowy typ powiązania domeny.
createdByType	Typ tożsamości, która utworzyła zasób.
CustomDomain	Domena niestandardowa aplikacji kontenera
DefaultErrorResponse	Odpowiedź na błąd usługi App Service.
Details	Szczegóły lub błąd
Error	Model błędu.
HttpRoute	Konfiguracja tras HTTP, w tym ścieżki, które mają być zgodne i czy mają zostać przepisane.
HttpRouteAction	Akcja do wykonania po zakończeniu dopasowywania tras
HttpRouteConfig	Zaawansowany routing ruchu przychodzącego dla routingu opartego na ścieżkach/nagłówkach dla środowiska aplikacji kontenera
HttpRouteMatch	Kryteria dopasowania
HttpRouteProvisioningErrors	Lista błędów aprowizacji dla obiektu konfiguracji trasy http
HttpRouteProvisioningState	Bieżący stan aprowizacji.
HttpRouteRule	Reguła trasy HTTP.
HttpRouteTarget	Cele — nazwy aplikacji kontenera, nazwy poprawek, etykiety.
Properties	Właściwości konfiguracji trasy HTTP
systemData	Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

bindingType

Wyliczanie

Niestandardowy typ powiązania domeny.

Wartość	Opis
Auto
Disabled
SniEnabled

createdByType

Wyliczanie

Typ tożsamości, która utworzyła zasób.

Wartość	Opis
Application
Key
ManagedIdentity
User

CustomDomain

Objekt

Domena niestandardowa aplikacji kontenera

Nazwa	Typ	Opis
bindingType	bindingType	Niestandardowy typ powiązania domeny.
certificateId	string	Identyfikator zasobu certyfikatu, który ma być powiązany z tą nazwą hosta. Musi istnieć w środowisku zarządzanym.
name	string	Nazwa hosta.

DefaultErrorResponse

Objekt

Odpowiedź na błąd usługi App Service.

Nazwa	Typ	Opis
error	Error	Model błędu.

Details

Objekt

Szczegóły lub błąd

Nazwa	Typ	Opis
code	string	Ustandaryzowany ciąg do programowego identyfikowania błędu.
message	string	Szczegółowy opis błędu i informacje o debugowaniu.
target	string	Szczegółowy opis błędu i informacje o debugowaniu.

Error

Objekt

Model błędu.

Nazwa	Typ	Opis
code	string	Ustandaryzowany ciąg do programowego identyfikowania błędu.
details	Details[]	Szczegóły lub błąd
innererror	string	Więcej informacji na temat debugowania błędu.
message	string	Szczegółowy opis błędu i informacje o debugowaniu.
target	string	Szczegółowy opis błędu i informacje o debugowaniu.

HttpRoute

Objekt

Konfiguracja tras HTTP, w tym ścieżki, które mają być zgodne i czy mają zostać przepisane.

Nazwa	Typ	Opis
action	HttpRouteAction	Po dopasowaniu trasy jaka jest żądana akcja
match	HttpRouteMatch	Trasa warunków będzie zgodna z

HttpRouteAction

Objekt

Akcja do wykonania po zakończeniu dopasowywania tras

Nazwa	Typ	Opis
prefixRewrite	string	Ponowne zapisywanie prefiksu, wartość domyślna to brak ponownego zapisywania