Udostępnij za pośrednictwem


Container Apps - Update

Aktualizowanie właściwości aplikacji kontenera
Poprawia aplikację kontenera przy użyciu poprawki scalanej JSON

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.App/containerApps/{containerAppName}?api-version=2024-03-01

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
containerAppName
path True

string

Nazwa aplikacji kontenera.

resourceGroupName
path True

string

Nazwa grupy zasobów. W nazwie jest uwzględniana wielkość liter.

subscriptionId
path True

string

Identyfikator subskrypcji docelowej.

api-version
query True

string

Wersja interfejsu API do użycia dla tej operacji.

Treść żądania

Nazwa Wymagane Typ Opis
location True

string

Lokalizacja geograficzna, w której znajduje się zasób

extendedLocation

ExtendedLocation

Typ złożony lokalizacji rozszerzonej.

identity

ManagedServiceIdentity

tożsamości zarządzane dla aplikacji kontenera umożliwiające interakcję z innymi usługami platformy Azure bez konieczności obsługi wpisów tajnych ani poświadczeń w kodzie.

managedBy

string

W pełni kwalifikowany identyfikator zasobu, który zarządza tym zasobem. Wskazuje, czy ten zasób jest zarządzany przez inny zasób platformy Azure. Jeśli jest to obecne, wdrożenie w trybie pełnym nie usunie zasobu, jeśli zostanie on usunięty z szablonu, ponieważ jest on zarządzany przez inny zasób.

properties.configuration

Configuration

Nieobsługiwane właściwości konfiguracji aplikacji kontenera.

properties.environmentId

string

Identyfikator zasobu środowiska.

properties.managedEnvironmentId

string

Przestarzałe. Identyfikator zasobu środowiska aplikacji kontenera.

properties.template

Template

Definicja aplikacji kontenera w wersji.

properties.workloadProfileName

string

Nazwa profilu obciążenia do przypięcia na potrzeby wykonywania aplikacji kontenera.

tags

object

Tagi zasobów.

Odpowiedzi

Nazwa Typ Opis
200 OK

ContainerApp

Ok

202 Accepted

Operacja stosowania poprawek jest w toku.

Nagłówki

Location: string

Other Status Codes

DefaultErrorResponse

Typowa odpowiedź na błąd.

Zabezpieczenia

azure_auth

Przepływ 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 Container App

Przykładowe żądanie

PATCH https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/containerApps/testcontainerapp0?api-version=2024-03-01

{
  "location": "East US",
  "tags": {
    "tag1": "value1",
    "tag2": "value2"
  },
  "properties": {
    "configuration": {
      "ingress": {
        "external": true,
        "targetPort": 3000,
        "customDomains": [
          {
            "name": "www.my-name.com",
            "bindingType": "SniEnabled",
            "certificateId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube/certificates/my-certificate-for-my-name-dot-com"
          },
          {
            "name": "www.my-other-name.com",
            "bindingType": "SniEnabled",
            "certificateId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube/certificates/my-certificate-for-my-other-name-dot-com"
          }
        ],
        "traffic": [
          {
            "weight": 100,
            "revisionName": "testcontainerapp0-ab1234",
            "label": "production"
          }
        ],
        "ipSecurityRestrictions": [
          {
            "name": "Allow work IP A subnet",
            "description": "Allowing all IP's within the subnet below to access containerapp",
            "ipAddressRange": "192.168.1.1/32",
            "action": "Allow"
          },
          {
            "name": "Allow work IP B subnet",
            "description": "Allowing all IP's within the subnet below to access containerapp",
            "ipAddressRange": "192.168.1.1/8",
            "action": "Allow"
          }
        ],
        "stickySessions": {
          "affinity": "sticky"
        }
      },
      "dapr": {
        "enabled": true,
        "appPort": 3000,
        "appProtocol": "http",
        "httpReadBufferSize": 30,
        "httpMaxRequestSize": 10,
        "logLevel": "debug",
        "enableApiLogging": true
      },
      "maxInactiveRevisions": 10,
      "service": {
        "type": "redis"
      }
    },
    "template": {
      "containers": [
        {
          "image": "repo/testcontainerapp0:v1",
          "name": "testcontainerapp0",
          "probes": [
            {
              "type": "Liveness",
              "httpGet": {
                "path": "/health",
                "port": 8080,
                "httpHeaders": [
                  {
                    "name": "Custom-Header",
                    "value": "Awesome"
                  }
                ]
              },
              "initialDelaySeconds": 3,
              "periodSeconds": 3
            }
          ]
        }
      ],
      "initContainers": [
        {
          "image": "repo/testcontainerapp0:v4",
          "name": "testinitcontainerApp0",
          "resources": {
            "cpu": 0.5,
            "memory": "1Gi"
          }
        }
      ],
      "scale": {
        "minReplicas": 1,
        "maxReplicas": 5,
        "rules": [
          {
            "name": "httpscalingrule",
            "custom": {
              "type": "http",
              "metadata": {
                "concurrentRequests": "50"
              }
            }
          }
        ]
      },
      "serviceBinds": [
        {
          "serviceId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/containerApps/service",
          "name": "service"
        }
      ]
    }
  }
}

Przykładowa odpowiedź

{
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/containerApps/testcontainerapp0",
  "name": "testcontainerapp0",
  "type": "Microsoft.App/containerApps",
  "location": "East US",
  "properties": {
    "provisioningState": "Succeeded",
    "managedEnvironmentId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube",
    "workloadProfileName": "My-GP-01",
    "latestRevisionFqdn": "testcontainerapp0-pjxhsye.demokube-t24clv0g.eastus.containerApps.k4apps.io",
    "latestReadyRevisionName": "testcontainerapp0-pjxhsye",
    "configuration": {
      "ingress": {
        "fqdn": "testcontainerapp0.demokube-t24clv0g.eastus.containerApps.k4apps.io",
        "external": true,
        "targetPort": 3000,
        "transport": "auto",
        "customDomains": [
          {
            "name": "www.my-name.com",
            "bindingType": "SniEnabled",
            "certificateId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube/certificates/my-certificate-for-my-name-dot-com"
          },
          {
            "name": "www.my--other-name.com",
            "bindingType": "SniEnabled",
            "certificateId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube/certificates/my-certificate-for-my-other-name-dot-com"
          }
        ],
        "traffic": [
          {
            "weight": 80,
            "revisionName": "testcontainerapp0-ab1234"
          },
          {
            "weight": 20,
            "revisionName": "testcontainerapp0-ab4321",
            "label": "staging"
          }
        ],
        "ipSecurityRestrictions": [
          {
            "name": "Allow work IP A subnet",
            "description": "Allowing all IP's within the subnet below to access containerapp",
            "ipAddressRange": "192.168.1.1/32",
            "action": "Allow"
          },
          {
            "name": "Allow work IP B subnet",
            "description": "Allowing all IP's within the subnet below to access containerapp",
            "ipAddressRange": "192.168.1.1/8",
            "action": "Allow"
          }
        ]
      },
      "dapr": {
        "enabled": true,
        "appPort": 3000,
        "appProtocol": "http",
        "httpReadBufferSize": 30,
        "httpMaxRequestSize": 10,
        "logLevel": "debug",
        "enableApiLogging": true
      },
      "maxInactiveRevisions": 10
    },
    "template": {
      "containers": [
        {
          "image": "repo/testcontainerapp0:v4",
          "name": "testcontainerapp0",
          "resources": {
            "cpu": 0.5,
            "memory": "1Gi"
          }
        }
      ],
      "initContainers": [
        {
          "image": "repo/testcontainerapp0:v4",
          "name": "testinitcontainerApp0",
          "resources": {
            "cpu": 0.5,
            "memory": "1Gi"
          }
        }
      ],
      "scale": {
        "minReplicas": 1,
        "maxReplicas": 5,
        "rules": [
          {
            "name": "httpscalingrule",
            "http": {
              "metadata": {
                "concurrentRequests": "50"
              }
            }
          }
        ]
      }
    },
    "eventStreamEndpoint": "testEndpoint"
  }
}
azure-asyncoperation: https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/providers/Microsoft.App/locations/eastus/containerappOperationResults/62e4d893-d233-4005-988e-a428d9f77076?api-version=2024-03-01

Definicje

Nazwa Opis
action

Zezwalaj na reguły zezwalania lub odmawiania określania dla przychodzącego adresu IP. Uwaga: Reguły mogą składać się tylko ze wszystkich dozwolonych lub WSZYSTKICH odmów

ActiveRevisionsMode

Tryb ActiveRevisionsMode określa sposób obsługi aktywnych poprawek dla aplikacji kontenera: wiele: wiele wersji może być aktywnych.Pojedynczy: tylko jedna poprawka może być aktywna jednocześnie. Wagi poprawek nie mogą być używane w tym trybie. Jeśli nie podano żadnej wartości, jest to wartość domyślna.

affinity

Koligacja sesji sticky

appProtocol

Informuje dapr, którego protokołu używa aplikacja. Prawidłowe opcje to http i grpc. Wartość domyślna to http

bindingType

Custom Domain typ powiązania.

Configuration

Nieobsługiwane właściwości konfiguracji aplikacji kontenera definiujące ustawienia modyfikowalne aplikacji kontenera

Container

Definicja kontenera aplikacji kontenera

ContainerApp

Aplikacja kontenera.

ContainerAppProbe

Sonda opisuje kontrolę kondycji, która ma być wykonywana względem kontenera w celu określenia, czy jest ona aktywna, czy gotowa do odbierania ruchu.

ContainerAppProvisioningState

Stan aprowizacji aplikacji kontenera.

ContainerResources

Wymagania dotyczące zasobów kontenera aplikacji kontenera.

CorsPolicy

Zasady współużytkowania zasobów między źródłami

createdByType

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

CustomDomain

Custom Domain aplikacji kontenera

CustomScaleRule

Niestandardowa reguła skalowania kontenera aplikacji kontenera.

Dapr

Konfiguracja języka Dapr aplikacji kontenera.

DefaultErrorResponse

App Service odpowiedź na błąd.

Details

Szczegóły lub błąd

EnvironmentVar

Zmienna środowiskowa kontenera aplikacji kontenera.

Error

Model błędu.

ExtendedLocation

Typ złożony lokalizacji rozszerzonej.

ExtendedLocationTypes

Typ lokalizacji rozszerzonej.

HttpGet

HttpGet określa żądanie http do wykonania.

HttpHeaders

Nagłówki niestandardowe do ustawienia w żądaniu. Protokół HTTP umożliwia powtarzające się nagłówki.

HttpScaleRule

Reguła skalowania HTTP kontenera aplikacji kontenera.

Ingress

Konfiguracja ruchu przychodzącego aplikacji kontenera.

IngressClientCertificateMode

Tryb certyfikatu klienta na potrzeby uwierzytelniania mTLS. Ignoruj wskazuje, że serwer odrzuca certyfikat klienta podczas przekazywania dalej. Pozycja Accept wskazuje, że serwer przekazuje certyfikat klienta, ale nie wymaga certyfikatu klienta. Pozycja Wymagaj wskazuje, że serwer wymaga certyfikatu klienta.

IngressPortMapping

Mapowania portów ruchu przychodzącego aplikacji kontenera

IngressTransportMethod

Protokół transportu ruchu przychodzącego

InitContainer

Definicja kontenera init aplikacji kontenera

IpSecurityRestrictionRule

Reguła ograniczania przychodzącego adresu IP.

logLevel

Ustawia poziom dziennika dla przyczepki Dapr. Dozwolone wartości to debugowanie, informacje, ostrzeganie, błąd. Wartość domyślna to informacje.

ManagedServiceIdentity

Tożsamość usługi zarządzanej (tożsamości przypisane przez system i/lub przypisane przez użytkownika)

ManagedServiceIdentityType

Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned).

QueueScaleRule

Reguła skalowania oparta na kolejce na podstawie kontenera aplikacji kontenera platformy Azure.

RegistryCredentials

Rejestr prywatny aplikacji kontenera

Scale

Konfiguracje skalowania aplikacji kontenera.

ScaleRule

Reguła skalowania kontenera aplikacji kontenera.

ScaleRuleAuth

Wpisy tajne uwierzytelniania dla reguły skalowania

Scheme

Schemat używany do nawiązywania połączenia z hostem. Wartość domyślna to HTTP.

Secret

Definicja wpisu tajnego.

SecretVolumeItem

Wpis tajny do dodania do woluminu.

Service

Aplikacja kontenera, która ma być usługą dewelopera

ServiceBind

Konfiguracja powiązania aplikacji ContainerApp z usługą Dev ContainerApp Service

StickySessions

Sesje sticky dla trybu pojedynczej poprawki

StorageType

Typ magazynu woluminu. Jeśli nie podano, użyj wartości EmptyDir.

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

TcpScaleRule

Reguła skalowania tcp kontenera aplikacji kontenera.

TcpSocket

TcpSocket określa akcję obejmującą port TCP. Punkty zaczepienia TCP nie są jeszcze obsługiwane.

Template

Definicja aplikacji kontenera w wersji. Definiuje żądany stan niezmiennej poprawki. Wszelkie zmiany w tej sekcji spowodują utworzenie nowej poprawki

TrafficWeight

Waga ruchu przypisana do poprawki

Type

Typ sondy.

UserAssignedIdentity

Właściwości tożsamości przypisanej przez użytkownika

Volume

Definicje woluminów dla aplikacji kontenera.

VolumeMount

Instalacja woluminu dla aplikacji kontenera.

action

Zezwalaj na reguły zezwalania lub odmawiania określania dla przychodzącego adresu IP. Uwaga: Reguły mogą składać się tylko ze wszystkich dozwolonych lub WSZYSTKICH odmów

Nazwa Typ Opis
Allow

string

Deny

string

ActiveRevisionsMode

Tryb ActiveRevisionsMode określa sposób obsługi aktywnych poprawek dla aplikacji kontenera: wiele: wiele wersji może być aktywnych.Pojedynczy: tylko jedna poprawka może być aktywna jednocześnie. Wagi poprawek nie mogą być używane w tym trybie. Jeśli nie podano żadnej wartości, jest to wartość domyślna.

Nazwa Typ Opis
Multiple

string

Single

string

affinity

Koligacja sesji sticky

Nazwa Typ Opis
none

string

sticky

string

appProtocol

Informuje dapr, którego protokołu używa aplikacja. Prawidłowe opcje to http i grpc. Wartość domyślna to http

Nazwa Typ Opis
grpc

string

http

string

bindingType

Custom Domain typ powiązania.

Nazwa Typ Opis
Disabled

string

SniEnabled

string

Configuration

Nieobsługiwane właściwości konfiguracji aplikacji kontenera definiujące ustawienia modyfikowalne aplikacji kontenera

Nazwa Typ Domyślna wartość Opis
activeRevisionsMode

ActiveRevisionsMode

Single

Tryb ActiveRevisionsMode określa sposób obsługi aktywnych poprawek dla aplikacji kontenera: wiele: wiele wersji może być aktywnych.Pojedynczy: tylko jedna poprawka może być aktywna jednocześnie. Wagi poprawek nie mogą być używane w tym trybie. Jeśli nie podano żadnej wartości, jest to wartość domyślna.

dapr

Dapr

Konfiguracja języka Dapr dla aplikacji kontenera.

ingress

Ingress

Konfiguracje ruchu przychodzącego.

maxInactiveRevisions

integer

Opcjonalny. Maksymalna liczba nieaktywnych poprawek, które może mieć aplikacja kontenera.

registries

RegistryCredentials[]

Kolekcja prywatnych poświadczeń rejestru kontenerów dla kontenerów używanych przez aplikację kontenerów

secrets

Secret[]

Zbieranie wpisów tajnych używanych przez aplikację kontenera

service

Service

Aplikacja kontenera, która ma być deweloperem App Service kontenera

Container

Definicja kontenera aplikacji kontenera

Nazwa Typ Opis
args

string[]

Argumenty polecenia uruchamiania kontenera.

command

string[]

Polecenie uruchamiania kontenera.

env

EnvironmentVar[]

Zmienne środowiskowe kontenera.

image

string

Tag obrazu kontenera.

name

string

Niestandardowa nazwa kontenera.

probes

ContainerAppProbe[]

Lista sond dla kontenera.

resources

ContainerResources

Wymagania dotyczące zasobów kontenera.

volumeMounts

VolumeMount[]

Instalacja woluminu kontenera.

ContainerApp

Aplikacja kontenera.

Nazwa Typ Opis
extendedLocation

ExtendedLocation

Typ złożony lokalizacji rozszerzonej.

id

string

W pełni kwalifikowany identyfikator zasobu dla zasobu. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

identity

ManagedServiceIdentity

tożsamości zarządzane dla aplikacji kontenera umożliwiające interakcję z innymi usługami platformy Azure bez konieczności obsługi wpisów tajnych ani poświadczeń w kodzie.

location

string

Lokalizacja geograficzna, w której znajduje się zasób

managedBy

string

W pełni kwalifikowany identyfikator zasobu, który zarządza tym zasobem. Wskazuje, czy ten zasób jest zarządzany przez inny zasób platformy Azure. Jeśli jest to obecne, wdrożenie w trybie pełnym nie usunie zasobu, jeśli zostanie on usunięty z szablonu, ponieważ jest on zarządzany przez inny zasób.

name

string

Nazwa zasobu

properties.configuration

Configuration

Nieobsługiwane właściwości konfiguracji aplikacji kontenera.

properties.customDomainVerificationId

string

Identyfikator używany do weryfikowania własności nazwy domeny

properties.environmentId

string

Identyfikator zasobu środowiska.

properties.eventStreamEndpoint

string

Punkt końcowy strumienia zdarzeń aplikacji kontenera.

properties.latestReadyRevisionName

string

Nazwa najnowszej gotowej wersji aplikacji kontenera.

properties.latestRevisionFqdn

string

W pełni kwalifikowana nazwa domeny najnowszej wersji aplikacji kontenera.

properties.latestRevisionName

string

Nazwa najnowszej wersji aplikacji kontenera.

properties.managedEnvironmentId

string

Przestarzałe. Identyfikator zasobu środowiska aplikacji kontenera.

properties.outboundIpAddresses

string[]

Wychodzące adresy IP dla aplikacji kontenera.

properties.provisioningState

ContainerAppProvisioningState

Stan aprowizacji aplikacji kontenera.

properties.template

Template

Definicja aplikacji kontenera w wersji.

properties.workloadProfileName

string

Nazwa profilu obciążenia do przypięcia na potrzeby wykonywania aplikacji kontenera.

systemData

systemData

Metadane usługi Azure Resource Manager zawierające informacje createdBy i modifiedBy.

tags

object

Tagi zasobów.

type

string

Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

ContainerAppProbe

Sonda opisuje kontrolę kondycji, która ma być wykonywana względem kontenera w celu określenia, czy jest ona aktywna, czy gotowa do odbierania ruchu.

Nazwa Typ Opis
failureThreshold

integer

Minimalna liczba kolejnych niepowodzeń dla sondy, które mają zostać uznane za zakończone niepowodzeniem po pomyślnym zakończeniu. Wartość domyślna to 3. Wartość minimalna to 1. Maksymalna wartość to 10.

httpGet

HttpGet

HttpGet określa żądanie http do wykonania.

initialDelaySeconds

integer

Liczba sekund po uruchomieniu kontenera przed zainicjowanymi sondami aktualności. Wartość minimalna to 1. Maksymalna wartość to 60.

periodSeconds

integer

Jak często (w sekundach) wykonać sondę. Wartość domyślna to 10 sekund. Wartość minimalna to 1. Maksymalna wartość to 240.

successThreshold

integer

Minimalna liczba kolejnych sukcesów dla sondy, która ma zostać uznana za pomyślną po nieudanej awarii. Wartość domyślna to 1. Musi być 1 dla utrzymania i uruchamiania. Wartość minimalna to 1. Maksymalna wartość to 10.

tcpSocket

TcpSocket

TcpSocket określa akcję obejmującą port TCP. Punkty zaczepienia TCP nie są jeszcze obsługiwane.

terminationGracePeriodSeconds

integer

Opcjonalny czas trwania w sekundach zasobnika musi zakończyć się bezproblemowo po awarii sondy. Okres prolongaty to czas trwania w sekundach po wysłaniu sygnału zakończenia procesów uruchomionych w zasobniku i czasie, w którym procesy są wymuszone zatrzymane za pomocą sygnału zabijania. Ustaw tę wartość dłużej niż oczekiwany czas oczyszczania procesu. Jeśli ta wartość jest zerowa, zostanie użyte zakończenie zasobnikaGracePeriodSeconds. W przeciwnym razie ta wartość zastępuje wartość podaną przez specyfikację zasobnika. Wartość musi być nie ujemną liczbą całkowitą. Wartość zero wskazuje, że zatrzymaj się natychmiast za pośrednictwem sygnału zabijania (brak możliwości zamknięcia). Jest to pole alfa i wymaga włączenia bramki funkcji ProbeTerminationGracePeriod. Maksymalna wartość to 3600 sekund (1 godzina)

timeoutSeconds

integer

Liczba sekund, po których sonda upłynął limit czasu. Wartość domyślna to 1 sekunda. Wartość minimalna to 1. Maksymalna wartość to 240.

type

Type

Typ sondy.

ContainerAppProvisioningState

Stan aprowizacji aplikacji kontenera.

Nazwa Typ Opis
Canceled

string

Deleting

string

Failed

string

InProgress

string

Succeeded

string

ContainerResources

Wymagania dotyczące zasobów kontenera aplikacji kontenera.

Nazwa Typ Opis
cpu

number

Wymagany procesor CPU w rdzeniach, np. 0,5

ephemeralStorage

string

Efemeryczny magazyn, np. "1Gi"

memory

string

Wymagana pamięć, np. "250 Mb"

CorsPolicy

Zasady współużytkowania zasobów między źródłami

Nazwa Typ Opis
allowCredentials

boolean

Określa, czy zasób zezwala na poświadczenia

allowedHeaders

string[]

Określa zawartość nagłówka access-control-allow-headers

allowedMethods

string[]

Określa zawartość nagłówka access-control-allow-methods

allowedOrigins

string[]

Określa zawartość nagłówka access-control-allow-origins

exposeHeaders

string[]

Określa zawartość nagłówka access-control-expose-headers

maxAge

integer

Określa zawartość nagłówka access-control-max-age

createdByType

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

Nazwa Typ Opis
Application

string

Key

string

ManagedIdentity

string

User

string

CustomDomain

Custom Domain aplikacji kontenera

Nazwa Typ Opis
bindingType

bindingType

Custom Domain typ powiązania.

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.

CustomScaleRule

Niestandardowa reguła skalowania kontenera aplikacji kontenera.

Nazwa Typ Opis
auth

ScaleRuleAuth[]

Wpisy tajne uwierzytelniania dla reguły skalowania niestandardowego.

metadata

object

Właściwości metadanych opisujące niestandardową regułę skalowania.

type

string

Typ niestandardowej reguły skalowania, np. azure-servicebus, redis itp.

Dapr

Konfiguracja języka Dapr aplikacji kontenera.

Nazwa Typ Domyślna wartość Opis
appId

string

Identyfikator aplikacji języka Dapr

appPort

integer

Informuje dapr, na którym porcie nasłuchuje aplikacja

appProtocol

appProtocol

http

Informuje dapr, którego protokołu używa aplikacja. Prawidłowe opcje to http i grpc. Wartość domyślna to http

enableApiLogging

boolean

Włącza rejestrowanie interfejsu API dla przyczepki Dapr

enabled

boolean

False

Wartość logiczna wskazująca, czy samochód boczny Dapr jest włączony

httpMaxRequestSize

integer

Zwiększenie maksymalnego rozmiaru treści żądania http i grpc server parametru w MB do obsługi przekazywania dużych plików. Wartość domyślna to 4 MB.

httpReadBufferSize

integer

Maksymalny rozmiar buforu odczytu nagłówka HTTP w bazie wiedzy dapr do obsługi podczas wysyłania nagłówków z wieloma kb. Wartość domyślna to 65 KB.

logLevel

logLevel

Ustawia poziom dziennika dla przyczepki Dapr. Dozwolone wartości to debugowanie, informacje, ostrzeganie, błąd. Wartość domyślna to informacje.

DefaultErrorResponse

App Service odpowiedź na błąd.

Nazwa Typ Opis
error

Error

Model błędu.

Details

Szczegóły lub błąd

Nazwa Typ Opis
code

string

Ustandaryzowany ciąg w celu 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.

EnvironmentVar

Zmienna środowiskowa kontenera aplikacji kontenera.

Nazwa Typ Opis
name

string

Nazwa zmiennej środowiskowej.

secretRef

string

Nazwa wpisu tajnego aplikacji kontenera, z którego ma być pobierana wartość zmiennej środowiskowej.

value

string

Wartość zmiennej środowiskowej bez wpisu tajnego.

Error

Model błędu.

Nazwa Typ Opis
code

string

Ustandaryzowany ciąg w celu 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.

ExtendedLocation

Typ złożony lokalizacji rozszerzonej.

Nazwa Typ Opis
name

string

Nazwa lokalizacji rozszerzonej.

type

ExtendedLocationTypes

Typ lokalizacji rozszerzonej.

ExtendedLocationTypes

Typ lokalizacji rozszerzonej.

Nazwa Typ Opis
CustomLocation

string

HttpGet

HttpGet określa żądanie http do wykonania.

Nazwa Typ Opis
host

string

Nazwa hosta, z którymi ma nawiązać połączenie, domyślnie jest to adres IP zasobnika. Prawdopodobnie chcesz ustawić wartość "Host" w elementach httpHeaders.

httpHeaders

HttpHeaders[]

Nagłówki niestandardowe do ustawienia w żądaniu. Protokół HTTP zezwala na powtarzające się nagłówki.

path

string

Ścieżka dostępu do serwera HTTP.

port

integer

Nazwa lub numer portu do uzyskania dostępu do kontenera. Liczba musi należeć do zakresu od 1 do 65535. Nazwa musi być IANA_SVC_NAME.

scheme

Scheme

Schemat używany do nawiązywania połączenia z hostem. Wartość domyślna to HTTP.

HttpHeaders

Nagłówki niestandardowe do ustawienia w żądaniu. Protokół HTTP umożliwia powtarzające się nagłówki.

Nazwa Typ Opis
name

string

Nazwa pola nagłówka

value

string

Wartość pola nagłówka

HttpScaleRule

Reguła skalowania HTTP kontenera aplikacji kontenera.

Nazwa Typ Opis
auth

ScaleRuleAuth[]

Wpisy tajne uwierzytelniania dla reguły skalowania niestandardowego.

metadata

object

Właściwości metadanych opisujące regułę skalowania http.

Ingress

Konfiguracja ruchu przychodzącego aplikacji kontenera.

Nazwa Typ Domyślna wartość Opis
additionalPortMappings

IngressPortMapping[]

Ustawienia umożliwiające uwidocznienie dodatkowych portów w aplikacji kontenera

allowInsecure

boolean

False

Wartość logiczna wskazująca, czy połączenia HTTP z są dozwolone. W przypadku ustawienia wartości false połączeń HTTP są automatycznie przekierowywane do połączeń HTTPS

clientCertificateMode

IngressClientCertificateMode

Tryb certyfikatu klienta na potrzeby uwierzytelniania mTLS. Ignoruj wskazuje, że serwer odrzuca certyfikat klienta podczas przekazywania dalej. Pozycja Accept wskazuje, że serwer przekazuje certyfikat klienta, ale nie wymaga certyfikatu klienta. Pozycja Wymagaj wskazuje, że serwer wymaga certyfikatu klienta.

corsPolicy

CorsPolicy

Zasady CORS dla aplikacji kontenera

customDomains

CustomDomain[]

niestandardowe powiązania domeny dla nazw hostów usługi Container Apps.

exposedPort

integer

Uwidoczniony port w kontenerach dla ruchu TCP z ruchu przychodzącego

external

boolean

False

Wartość logiczna wskazująca, czy aplikacja uwidacznia zewnętrzny punkt końcowy HTTP

fqdn

string

Nazwa hosta.

ipSecurityRestrictions

IpSecurityRestrictionRule[]

Reguły ograniczania przychodzącego adresu IP.

stickySessions

StickySessions

Sesje sticky dla trybu pojedynczej poprawki

targetPort

integer

Docelowy port w kontenerach dla ruchu przychodzącego

traffic

TrafficWeight[]

Wagi ruchu dla wersji aplikacji

transport

IngressTransportMethod

auto

Protokół transportu ruchu przychodzącego

IngressClientCertificateMode

Tryb certyfikatu klienta na potrzeby uwierzytelniania mTLS. Ignoruj wskazuje, że serwer odrzuca certyfikat klienta podczas przekazywania dalej. Pozycja Accept wskazuje, że serwer przekazuje certyfikat klienta, ale nie wymaga certyfikatu klienta. Pozycja Wymagaj wskazuje, że serwer wymaga certyfikatu klienta.

Nazwa Typ Opis
accept

string

ignore

string

require

string

IngressPortMapping

Mapowania portów ruchu przychodzącego aplikacji kontenera

Nazwa Typ Opis
exposedPort

integer

Określa uwidoczniony port dla portu docelowego. Jeśli nie zostanie określony, domyślnie jest to port docelowy

external

boolean

Określa, czy port aplikacji jest dostępny poza środowiskiem

targetPort

integer

Określa nasłuchuje kontenera użytkownika portu

IngressTransportMethod

Protokół transportu ruchu przychodzącego

Nazwa Typ Opis
auto

string

http

string

http2

string

tcp

string

InitContainer

Definicja kontenera init aplikacji kontenera

Nazwa Typ Opis
args

string[]

Argumenty polecenia uruchamiania kontenera.

command

string[]

Polecenie uruchamiania kontenera.

env

EnvironmentVar[]

Zmienne środowiskowe kontenera.

image

string

Tag obrazu kontenera.

name

string

Niestandardowa nazwa kontenera.

resources

ContainerResources

Wymagania dotyczące zasobów kontenera.

volumeMounts

VolumeMount[]

Instalacja woluminu kontenera.

IpSecurityRestrictionRule

Reguła ograniczania przychodzącego adresu IP.

Nazwa Typ Opis
action

action

Zezwalaj na reguły zezwalania lub odmowy w celu określenia dla przychodzącego adresu IP. Uwaga: Reguły mogą składać się tylko ze wszystkich dozwolonych lub WSZYSTKICH odmów

description

string

Opisz regułę ograniczeń adresów IP, która jest wysyłana do kontenera-app. Jest to pole opcjonalne.

ipAddressRange

string

Notacja CIDR zgodna z przychodzącym adresem IP

name

string

Nazwa reguły ograniczeń adresów IP.

logLevel

Ustawia poziom dziennika dla przyczepki Dapr. Dozwolone wartości to debugowanie, informacje, ostrzeganie, błąd. Wartość domyślna to informacje.

Nazwa Typ Opis
debug

string

error

string

info

string

warn

string

ManagedServiceIdentity

Tożsamość usługi zarządzanej (tożsamości przypisane przez system i/lub przypisane przez użytkownika)

Nazwa Typ Opis
principalId

string

Identyfikator jednostki usługi tożsamości przypisanej przez system. Ta właściwość zostanie udostępniona tylko dla tożsamości przypisanej przez system.

tenantId

string

Identyfikator dzierżawy tożsamości przypisanej przez system. Ta właściwość zostanie udostępniona tylko dla tożsamości przypisanej przez system.

type

ManagedServiceIdentityType

Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned).

userAssignedIdentities

<string,  UserAssignedIdentity>

tożsamości User-Assigned
Zestaw tożsamości przypisanych przez użytkownika skojarzonych z zasobem. Klucze słownika userAssignedIdentities będą identyfikatorami zasobów usługi ARM w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Wartości słownika mogą być pustymi obiektami ({}) w żądaniach.

ManagedServiceIdentityType

Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned).

Nazwa Typ Opis
None

string

SystemAssigned

string

SystemAssigned,UserAssigned

string

UserAssigned

string

QueueScaleRule

Reguła skalowania oparta na kolejce na podstawie kontenera aplikacji kontenera platformy Azure.

Nazwa Typ Opis
auth

ScaleRuleAuth[]

Wpisy tajne uwierzytelniania dla reguły skalowania kolejek.

queueLength

integer

Długość kolejki.

queueName

string

Nazwa kolejki.

RegistryCredentials

Rejestr prywatny aplikacji kontenera

Nazwa Typ Opis
identity

string

Tożsamość zarządzana używana do uwierzytelniania za pomocą Azure Container Registry. W przypadku tożsamości przypisanych przez użytkownika użyj pełnego identyfikatora zasobu tożsamości przypisanej przez użytkownika. W przypadku tożsamości przypisanych przez system użyj polecenia "system"

passwordSecretRef

string

Nazwa wpisu tajnego zawierającego hasło logowania rejestru

server

string

Serwer usługi Container Registry

username

string

Nazwa użytkownika usługi Container Registry

Scale

Konfiguracje skalowania aplikacji kontenera.

Nazwa Typ Domyślna wartość Opis
maxReplicas

integer

10

Opcjonalny. Maksymalna liczba replik kontenerów. Wartość domyślna to 10, jeśli nie jest ustawiona.

minReplicas

integer

Opcjonalny. Minimalna liczba replik kontenerów.

rules

ScaleRule[]

Reguły skalowania.

ScaleRule

Reguła skalowania kontenera aplikacji kontenera.

Nazwa Typ Opis
azureQueue

QueueScaleRule

Skalowanie oparte na kolejce platformy Azure.

custom

CustomScaleRule

Niestandardowa reguła skalowania.

http

HttpScaleRule

Skalowanie na podstawie żądań HTTP.

name

string

Nazwa reguły skalowania

tcp

TcpScaleRule

Skalowanie oparte na żądaniach TCP.

ScaleRuleAuth

Wpisy tajne uwierzytelniania dla reguły skalowania

Nazwa Typ Opis
secretRef

string

Nazwa wpisu tajnego, z którego mają być pobierane parametry uwierzytelniania.

triggerParameter

string

Parametr wyzwalacza, który używa wpisu tajnego

Scheme

Schemat używany do nawiązywania połączenia z hostem. Wartość domyślna to HTTP.

Nazwa Typ Opis
HTTP

string

HTTPS

string

Secret

Definicja wpisu tajnego.

Nazwa Typ Opis
identity

string

Identyfikator zasobu tożsamości zarządzanej do uwierzytelniania za pomocą usługi Azure Key Vault lub system do używania tożsamości przypisanej przez system.

keyVaultUrl

string

Adres URL usługi Azure Key Vault wskazujący wpis tajny przywołyny przez aplikację kontenera.

name

string

Nazwa wpisu tajnego.

value

string

Wartość wpisu tajnego.

SecretVolumeItem

Wpis tajny do dodania do woluminu.

Nazwa Typ Opis
path

string

Ścieżka do wpisu tajnego projektu. Jeśli nie podano żadnej ścieżki, ścieżka jest domyślnie określana jako nazwa wpisu tajnego wymienionego w elemecie secretRef.

secretRef

string

Nazwa wpisu tajnego aplikacji kontenera, z którego ma być pobierana wartość wpisu tajnego.

Service

Aplikacja kontenera, która ma być usługą dewelopera

Nazwa Typ Opis
type

string

Typ usługi Dev ContainerApp

ServiceBind

Konfiguracja powiązania aplikacji ContainerApp z usługą Dev ContainerApp Service

Nazwa Typ Opis
name

string

Nazwa powiązania usługi

serviceId

string

Identyfikator zasobu usługi docelowej

StickySessions

Sesje sticky dla trybu pojedynczej poprawki

Nazwa Typ Opis
affinity

affinity

Koligacja sesji sticky

StorageType

Typ magazynu woluminu. Jeśli nie podano, użyj wartości EmptyDir.

Nazwa Typ Opis
AzureFile

string

EmptyDir

string

Secret

string

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa Typ Opis
createdAt

string

Sygnatura czasowa tworzenia zasobów (UTC).

createdBy

string

Tożsamość, która utworzyła zasób.

createdByType

createdByType

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

lastModifiedAt

string

Sygnatura czasowa ostatniej modyfikacji zasobu (UTC)

lastModifiedBy

string

Tożsamość, która ostatnio zmodyfikowała zasób.

lastModifiedByType

createdByType

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

TcpScaleRule

Reguła skalowania tcp kontenera aplikacji kontenera.

Nazwa Typ Opis
auth

ScaleRuleAuth[]

Wpisy tajne uwierzytelniania dla reguły skalowania tcp.

metadata

object

Właściwości metadanych opisujące regułę skalowania tcp.

TcpSocket

TcpSocket określa akcję obejmującą port TCP. Punkty zaczepienia TCP nie są jeszcze obsługiwane.

Nazwa Typ Opis
host

string

Opcjonalnie: nazwa hosta do nawiązania połączenia domyślnie z adresem IP zasobnika.

port

integer

Numer lub nazwa portu w celu uzyskania dostępu do kontenera. Liczba musi należeć do zakresu od 1 do 65535. Nazwa musi być IANA_SVC_NAME.

Template

Definicja aplikacji kontenera w wersji. Definiuje żądany stan niezmiennej poprawki. Wszelkie zmiany w tej sekcji spowodują utworzenie nowej poprawki

Nazwa Typ Opis
containers

Container[]

Lista definicji kontenerów dla aplikacji kontenera.

initContainers

InitContainer[]

Lista wyspecjalizowanych kontenerów uruchamianych przed kontenerami aplikacji.

revisionSuffix

string

Sufiks przyjazny dla użytkownika, który jest dołączany do nazwy poprawki

scale

Scale

Właściwości skalowania dla aplikacji kontenera.

serviceBinds

ServiceBind[]

Lista usług app services kontenera powiązanych z aplikacją

terminationGracePeriodSeconds

integer

Opcjonalny czas trwania w sekundach, przez który wystąpienie aplikacji kontenera musi zostać bezpiecznie zakończone. Wartość musi być nieujemną liczbą całkowitą. Wartość zero wskazuje zatrzymać się natychmiast za pośrednictwem sygnału zabicia (brak możliwości zamknięcia). Jeśli ta wartość jest zerowa, zostanie użyty domyślny okres prolongaty. Ustaw tę wartość dłużej niż oczekiwany czas oczyszczania dla procesu. Wartość domyślna to 30 sekund.

volumes

Volume[]

Lista definicji woluminów dla aplikacji kontenera.

TrafficWeight

Waga ruchu przypisana do poprawki

Nazwa Typ Domyślna wartość Opis
label

string

Kojarzy etykietę ruchu z poprawką

latestRevision

boolean

False

Wskazuje, że waga ruchu należy do najnowszej stabilnej wersji

revisionName

string

Nazwa poprawki

weight

integer

Waga ruchu przypisana do poprawki

Type

Typ sondy.

Nazwa Typ Opis
Liveness

string

Readiness

string

Startup

string

UserAssignedIdentity

Właściwości tożsamości przypisanej przez użytkownika

Nazwa Typ Opis
clientId

string

Identyfikator klienta przypisanej tożsamości.

principalId

string

Identyfikator podmiotu zabezpieczeń przypisanej tożsamości.

Volume

Definicje woluminów dla aplikacji kontenera.

Nazwa Typ Opis
mountOptions

string

Opcje instalacji używane podczas instalowania pliku AzureFile. Musi być ciągiem rozdzielanym przecinkami.

name

string

Nazwa woluminu.

secrets

SecretVolumeItem[]

Lista wpisów tajnych do dodania w woluminie. Jeśli nie podano żadnych wpisów tajnych, wszystkie wpisy tajne w kolekcji zostaną dodane do woluminu.

storageName

string

Nazwa zasobu magazynu. Nie trzeba podawać wartości EmptyDir i Secret.

storageType

StorageType

Typ magazynu dla woluminu. Jeśli nie zostanie podana, użyj wartości EmptyDir.

VolumeMount

Instalacja woluminu dla aplikacji kontenera.

Nazwa Typ Opis
mountPath

string

Ścieżka w kontenerze, w którym należy zamontować wolumin. Nie może zawierać elementu ":".

subPath

string

Ścieżka w woluminie, z którego należy zamontować wolumin kontenera. Wartość domyślna to "" (katalog główny woluminu).

volumeName

string

Musi to być zgodne z nazwą woluminu.