Container Apps - Update

Referência

Service:: Azure Container Apps

API Version:: 2024-03-01

Atualizar propriedades de um Aplicativo de Contêiner
Corrige um aplicativo de contêiner usando o patch de mesclagem JSON

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
containerAppName	path	True	string	Nome do Aplicativo de Contêiner.
resourceGroupName	path	True	string	O nome do grupo de recursos. O nome diferencia maiúsculas de minúsculas.
subscriptionId	path	True	string	A ID da assinatura de destino.
api-version	query	True	string	A versão da API a ser usada para esta operação.

Corpo da solicitação

Nome	Obrigatório	Tipo	Description
location	True	string	A localização geográfica em que o recurso reside
extendedLocation		ExtendedLocation	O tipo complexo do local estendido.
identity		ManagedServiceIdentity	identidades gerenciadas para o Aplicativo de Contêiner interagir com outros serviços do Azure sem manter segredos ou credenciais no código.
managedBy		string	A ID de recurso totalmente qualificada do recurso que gerencia esse recurso. Indica se esse recurso é gerenciado por outro recurso do Azure. Se isso estiver presente, a implantação do modo completo não excluirá o recurso se ele for removido do modelo, pois ele é gerenciado por outro recurso.
properties.configuration		Configuration	Propriedades de configuração do Aplicativo de Contêiner não com controle de versão.
properties.environmentId		string	ID do recurso do ambiente.
properties.managedEnvironmentId		string	Preterido. ID do recurso do ambiente do Aplicativo de Contêiner.
properties.template		Template	Definição de aplicativo com controle de versão do Aplicativo de Contêiner.
properties.workloadProfileName		string	Nome do perfil de carga de trabalho a ser fixado para execução do aplicativo de contêiner.
tags		object	Marcas de recurso.

Respostas

Nome	Tipo	Description
200 OK	ContainerApp	Ok
202 Accepted		A operação de patch está em andamento. Headers Location: string
Other Status Codes	DefaultErrorResponse	Resposta de erro comum.

Nome

Tipo

Description

200 OK

ContainerApp

202 Accepted

A operação de patch está em andamento.

Headers

Location: string

Other Status Codes

DefaultErrorResponse

Resposta de erro comum.

Segurança

azure_auth

Fluxo do OAuth2 do Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

Patch Container App

Sample Request

HTTP

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"
        }
      ]
    }
  }
}

Sample Response

Status code:: 200

{
  "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"
  }
}

Status code:: 202

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

Definições

Nome	Description
action	Permitir ou negar regras para determinar o IP de entrada. Observação: as regras só podem consistir em ALL Allow ou ALL Deny
ActiveRevisionsMode	ActiveRevisionsMode controla como as revisões ativas são tratadas para o aplicativo contêiner: várias: várias revisões podem estar ativas.Único: apenas uma revisão pode estar ativa por vez. Os pesos de revisão não podem ser usados nesse modo. Se nenhum valor for fornecido, esse será o padrão.
affinity	Afinidade de sessão autoadesiva
appProtocol	Informa ao Dapr qual protocolo seu aplicativo está usando. As opções válidas são http e grpc. O padrão é http
bindingType	Custom Domain tipo de associação.
Configuration	Propriedades de configuração do Aplicativo de Contêiner não com controle de versão que definem as configurações mutáveis de um aplicativo de contêiner
Container	Definição de contêiner do Aplicativo de Contêiner
ContainerApp	Aplicativo de Contêiner.
ContainerAppProbe	A investigação descreve um marcar de integridade a ser executado em um contêiner para determinar se ele está ativo ou pronto para receber tráfego.
ContainerAppProvisioningState	Estado de provisionamento do Aplicativo de Contêiner.
ContainerResources	Requisitos de recurso de contêiner do Aplicativo de Contêiner.
CorsPolicy	Política entre origens e compartilhamento de recursos
createdByType	O tipo de identidade que criou o recurso.
CustomDomain	Custom Domain de um aplicativo de contêiner
CustomScaleRule	Contêiner do Aplicativo de Contêiner Regra de dimensionamento personalizada.
Dapr	Configuração do Dapr do Aplicativo de Contêiner.
DefaultErrorResponse	Serviço de Aplicativo resposta de erro.
Details	Detalhes ou o erro
EnvironmentVar	Variável de ambiente de contêiner do Aplicativo de Contêiner.
Error	Modelo de erro.
ExtendedLocation	O tipo complexo do local estendido.
ExtendedLocationTypes	O tipo do local estendido.
HttpGet	HTTPGet especifica a solicitação http a ser executada.
HttpHeaders	Cabeçalhos personalizados a serem definidos na solicitação. HTTP permite cabeçalhos repetidos.
HttpScaleRule	Regra de dimensionamento Http do contêiner do Aplicativo de Contêiner.
Ingress	Configuração de entrada do aplicativo de contêiner.
IngressClientCertificateMode	Modo de certificado do cliente para autenticação mTLS. Ignorar indica que o servidor descarta o certificado do cliente no encaminhamento. Accept indica que o servidor encaminha o certificado do cliente, mas não requer um certificado do cliente. Exigir indica que o servidor requer um certificado do cliente.
IngressPortMapping	Mapeamentos de porta de entrada do aplicativo de contêiner
IngressTransportMethod	Protocolo de transporte de entrada
InitContainer	Definição do contêiner de inicialização do Aplicativo de Contêiner
IpSecurityRestrictionRule	Regra para restringir o endereço IP de entrada.
logLevel	Define o nível de log para o sidecar do Dapr. Os valores permitidos são depuração, informações, aviso, erro. O padrão é informações.
ManagedServiceIdentity	Identidade de serviço gerenciada (identidades atribuídas pelo sistema e/ou atribuídas pelo usuário)
ManagedServiceIdentityType	Tipo de identidade de serviço gerenciada (em que os tipos SystemAssigned e UserAssigned são permitidos).
QueueScaleRule	Regra de dimensionamento baseada em Fila do Azure do contêiner do Aplicativo de Contêiner.
RegistryCredentials	Registro Privado do Aplicativo de Contêiner
Scale	Configurações de dimensionamento do Aplicativo de Contêiner.
ScaleRule	Regra de dimensionamento de contêiner do Aplicativo de Contêiner.
ScaleRuleAuth	Segredos de autenticação para regra de escala
Scheme	Esquema a ser usado para se conectar ao host. O padrão é HTTP.
Secret	Definição de segredo.
SecretVolumeItem	Segredo a ser adicionado ao volume.
Service	Aplicativo de Contêiner para ser um serviço de desenvolvimento
ServiceBind	Configuração para associar um ContainerApp a um Serviço de ContainerApp de desenvolvimento
StickySessions	Sessões autoadesivas para o modo de revisão única
StorageType	Tipo de armazenamento para o volume. Se não for fornecido, use EmptyDir.
systemData	Metadados relativos à criação e à última modificação do recurso.
TcpScaleRule	Regra de dimensionamento Tcp do contêiner do Aplicativo de Contêiner.
TcpSocket	TCPSocket especifica uma ação envolvendo uma porta TCP. Ainda não há suporte para ganchos TCP.
Template	Definição de aplicativo com controle de versão do Aplicativo de Contêiner. Define o estado desejado de uma revisão imutável. Todas as alterações nesta seção resultarão na criação de uma nova revisão
TrafficWeight	Peso do tráfego atribuído a uma revisão
Type	O tipo de investigação.
UserAssignedIdentity	Propriedades de identidade atribuídas pelo usuário
Volume	Definições de volume para o Aplicativo de Contêiner.
VolumeMount	Montagem de volume para o Aplicativo de Contêiner.

action

Permitir ou negar regras para determinar o IP de entrada. Observação: as regras só podem consistir em ALL Allow ou ALL Deny

Nome	Tipo	Description
Allow	string
Deny	string

ActiveRevisionsMode

ActiveRevisionsMode controla como as revisões ativas são tratadas para o aplicativo contêiner: várias: várias revisões podem estar ativas.Único: apenas uma revisão pode estar ativa por vez. Os pesos de revisão não podem ser usados nesse modo. Se nenhum valor for fornecido, esse será o padrão.

Nome	Tipo	Description
Multiple	string
Single	string

affinity

Afinidade de sessão autoadesiva

Nome	Tipo	Description
none	string
sticky	string

appProtocol

Informa ao Dapr qual protocolo seu aplicativo está usando. As opções válidas são http e grpc. O padrão é http

Nome	Tipo	Description
grpc	string
http	string

bindingType

Custom Domain tipo de associação.

Nome	Tipo	Description
Disabled	string
SniEnabled	string

Configuration

Propriedades de configuração do Aplicativo de Contêiner não com controle de versão que definem as configurações mutáveis de um aplicativo de contêiner

Nome	Tipo	Valor padrão	Description
activeRevisionsMode	ActiveRevisionsMode	Single	ActiveRevisionsMode controla como as revisões ativas são tratadas para o aplicativo contêiner: várias: várias revisões podem estar ativas.Único: apenas uma revisão pode estar ativa por vez. Os pesos de revisão não podem ser usados nesse modo. Se nenhum valor for fornecido, esse será o padrão.
dapr	Dapr		Configuração do Dapr para o Aplicativo de Contêiner.
ingress	Ingress		Configurações de entrada.
maxInactiveRevisions	integer		Opcional. Máximo de revisões inativas que um Aplicativo de Contêiner pode ter.
registries	RegistryCredentials[]		Coleção de credenciais de registro de contêiner privado para contêineres usados pelo aplicativo contêiner
secrets	Secret[]		Coleção de segredos usados por um aplicativo de contêiner
service	Service		Aplicativo de contêiner para ser um contêiner de desenvolvimento Serviço de Aplicativo

Container

Definição de contêiner do Aplicativo de Contêiner

Nome	Tipo	Description
args	string[]	Argumentos de comando de início de contêiner.
command	string[]	Comando de início do contêiner.
env	EnvironmentVar[]	Variáveis de ambiente de contêiner.
image	string	Marca de imagem de contêiner.
name	string	Nome do contêiner personalizado.
probes	ContainerAppProbe[]	Lista de investigações para o contêiner.
resources	ContainerResources	Requisitos de recursos do contêiner.
volumeMounts	VolumeMount[]	Montagens de volume de contêiner.

ContainerApp

Aplicativo de Contêiner.

Nome	Tipo	Description
extendedLocation	ExtendedLocation	O tipo complexo do local estendido.
id	string	ID de recurso totalmente qualificada para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	ManagedServiceIdentity	identidades gerenciadas para o Aplicativo de Contêiner interagir com outros serviços do Azure sem manter segredos ou credenciais no código.
location	string	A localização geográfica em que o recurso reside
managedBy	string	A ID de recurso totalmente qualificada do recurso que gerencia esse recurso. Indica se esse recurso é gerenciado por outro recurso do Azure. Se isso estiver presente, a implantação do modo completo não excluirá o recurso se ele for removido do modelo, pois ele é gerenciado por outro recurso.
name	string	O nome do recurso
properties.configuration	Configuration	Propriedades de configuração do Aplicativo de Contêiner não com controle de versão.
properties.customDomainVerificationId	string	ID usada para verificar a propriedade do nome de domínio
properties.environmentId	string	ID do recurso do ambiente.
properties.eventStreamEndpoint	string	O ponto de extremidade do fluxo de eventos do aplicativo de contêiner.
properties.latestReadyRevisionName	string	Nome da revisão pronta mais recente do Aplicativo de Contêiner.
properties.latestRevisionFqdn	string	Nome de Domínio Totalmente Qualificado da revisão mais recente do Aplicativo de Contêiner.
properties.latestRevisionName	string	Nome da revisão mais recente do Aplicativo de Contêiner.
properties.managedEnvironmentId	string	Preterido. ID do recurso do ambiente do Aplicativo de Contêiner.
properties.outboundIpAddresses	string[]	Endereços IP de saída para o aplicativo de contêiner.
properties.provisioningState	ContainerAppProvisioningState	Estado de provisionamento do Aplicativo de Contêiner.
properties.template	Template	Definição de aplicativo com controle de versão do Aplicativo de Contêiner.
properties.workloadProfileName	string	Nome do perfil de carga de trabalho a ser fixado para execução do aplicativo de contêiner.
systemData	systemData	Os metadados do Azure Resource Manager que contêm as informações createdBy e modifiedBy.
tags	object	Marcas de recurso.
type	string	Tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

ContainerAppProbe

A investigação descreve um marcar de integridade a ser executado em um contêiner para determinar se ele está ativo ou pronto para receber tráfego.

Nome	Tipo	Description
failureThreshold	integer	Falhas mínimas consecutivas para que a investigação seja considerada com falha depois de ter sido bem-sucedida. O valor padrão é 3. O valor mínimo é 1. O valor máximo é 10.
httpGet	HttpGet	HTTPGet especifica a solicitação http a ser executada.
initialDelaySeconds	integer	Número de segundos depois que o contêiner é iniciado antes que as investigações de atividade sejam iniciadas. O valor mínimo é 1. O valor máximo é 60.
periodSeconds	integer	A frequência (em segundos) para realizar a investigação. O padrão é 10 segundos. O valor mínimo é 1. O valor máximo é 240.
successThreshold	integer	Mínimo de sucessos consecutivos para que a investigação seja considerada bem-sucedida depois de ter falhado. O valor padrão é 1. Deve ser 1 para vida e inicialização. O valor mínimo é 1. O valor máximo é 10.
tcpSocket	TcpSocket	TCPSocket especifica uma ação envolvendo uma porta TCP. Ainda não há suporte para ganchos TCP.
terminationGracePeriodSeconds	integer	Duração opcional em segundos, o pod precisa terminar normalmente após a falha da investigação. O período de carência é a duração em segundos após os processos em execução no pod serem enviados um sinal de encerramento e a hora em que os processos são interrompidos à força com um sinal de encerramento. Defina esse valor por mais tempo do que o tempo de limpeza esperado para seu processo. Se esse valor for nulo, os terminationGracePeriodSeconds do pod serão usados. Caso contrário, esse valor substituirá o valor fornecido pela especificação de pod. O valor deve ser um inteiro não negativo. O valor zero indica parar imediatamente por meio do sinal de encerramento (sem oportunidade de desligar). Esse é um campo alfa e requer a habilitação do portão de recursos ProbeTerminationGracePeriod. O valor máximo é de 3600 segundos (1 hora)
timeoutSeconds	integer	Número de segundos após o qual a investigação atinge o tempo limite. O padrão é 1 segundo. O valor mínimo é 1. O valor máximo é 240.
type	Type	O tipo de investigação.

ContainerAppProvisioningState

Estado de provisionamento do Aplicativo de Contêiner.

Nome	Tipo	Description
Canceled	string
Deleting	string
Failed	string
InProgress	string
Succeeded	string

ContainerResources

Requisitos de recurso de contêiner do Aplicativo de Contêiner.

Nome	Tipo	Description
cpu	number	CPU necessária em núcleos, por exemplo, 0,5
ephemeralStorage	string	Armazenamento efêmero, por exemplo, "1Gi"
memory	string	Memória necessária, por exemplo, "250 Mb"

CorsPolicy

Política entre origens e compartilhamento de recursos

Nome	Tipo	Description
allowCredentials	boolean	Especifica se o recurso permite credenciais
allowedHeaders	string[]	Especifica o conteúdo do cabeçalho access-control-allow-headers
allowedMethods	string[]	Especifica o conteúdo do cabeçalho access-control-allow-methods
allowedOrigins	string[]	Especifica o conteúdo do cabeçalho access-control-allow-origins
exposeHeaders	string[]	Especifica o conteúdo do cabeçalho access-control-expose-headers
maxAge	integer	Especifica o conteúdo do cabeçalho access-control-max-age

createdByType

O tipo de identidade que criou o recurso.

Nome	Tipo	Description
Application	string
Key	string
ManagedIdentity	string
User	string

CustomDomain

Custom Domain de um aplicativo de contêiner

Nome	Tipo	Description
bindingType	bindingType	Custom Domain tipo de associação.
certificateId	string	ID do recurso do Certificado a ser associado a esse nome de host. Deve existir no Ambiente Gerenciado.
name	string	Hostname.

CustomScaleRule

Contêiner do Aplicativo de Contêiner Regra de dimensionamento personalizada.

Nome	Tipo	Description
auth	ScaleRuleAuth[]	Segredos de autenticação para a regra de escala personalizada.
metadata	object	Propriedades de metadados para descrever a regra de escala personalizada.
type	string	Tipo da regra de escala personalizada, por exemplo: azure-servicebus, redis etc.

Dapr

Configuração do Dapr do Aplicativo de Contêiner.

Nome	Tipo	Valor padrão	Description
appId	string		Identificador de aplicativo dapr
appPort	integer		Informa ao Dapr em qual porta seu aplicativo está escutando
appProtocol	appProtocol	http	Informa ao Dapr qual protocolo seu aplicativo está usando. As opções válidas são http e grpc. O padrão é http
enableApiLogging	boolean		Habilita o registro em log de API para o sidecar do Dapr
enabled	boolean	False	Booliano indicando se o carro lateral do Dapr está habilitado
httpMaxRequestSize	integer		Aumento do tamanho máximo do parâmetro de servidores http e grpc do corpo da solicitação em MB para lidar com o carregamento de arquivos grandes. O padrão é 4 MB.
httpReadBufferSize	integer		Tamanho máximo do dapr do buffer de leitura de cabeçalho http em KB a ser manipulado ao enviar cabeçalhos de vários KB. O padrão é 65 KB.
logLevel	logLevel		Define o nível de log para o sidecar do Dapr. Os valores permitidos são depuração, informações, aviso, erro. O padrão são as informações.

DefaultErrorResponse

Serviço de Aplicativo resposta de erro.

Nome	Tipo	Description
error	Error	Modelo de erro.

Details

Detalhes ou o erro

Nome	Tipo	Description
code	string	Cadeia de caracteres padronizada para identificar programaticamente o erro.
message	string	Informações detalhadas de descrição e depuração de erro.
target	string	Informações detalhadas de descrição e depuração de erro.

EnvironmentVar

Variável de ambiente de contêiner do Aplicativo de Contêiner.

Nome	Tipo	Description
name	string	Nome da variável de ambiente.
secretRef	string	Nome do segredo do Aplicativo de Contêiner do qual extrair o valor da variável de ambiente.
value	string	Valor de variável de ambiente não secreto.

Error

Modelo de erro.

Nome	Tipo	Description
code	string	Cadeia de caracteres padronizada para identificar programaticamente o erro.
details	Details[]	Detalhes ou o erro
innererror	string	Mais informações sobre o erro de depuração.
message	string	Informações detalhadas de descrição e depuração de erros.
target	string	Informações detalhadas de descrição e depuração de erros.

ExtendedLocation

O tipo complexo do local estendido.

Nome	Tipo	Description
name	string	O nome do local estendido.
type	ExtendedLocationTypes	O tipo do local estendido.

ExtendedLocationTypes

O tipo do local estendido.

Nome	Tipo	Description
CustomLocation	string

HttpGet

HTTPGet especifica a solicitação http a ser executada.

Nome	Tipo	Description
host	string	O nome do host ao qual se conectar, o padrão é o IP do pod. Você provavelmente deseja definir "Host" em httpHeaders.
httpHeaders	HttpHeaders[]	Cabeçalhos personalizados a serem definidos na solicitação. HTTP permite cabeçalhos repetidos.
path	string	Caminho para acessar no servidor HTTP.
port	integer	Nome ou número da porta a ser acessada no contêiner. O número deve estar no intervalo de 1 a 65535. O nome deve ser um IANA_SVC_NAME.
scheme	Scheme	Esquema a ser usado para se conectar ao host. O padrão é HTTP.

HttpHeaders

Cabeçalhos personalizados a serem definidos na solicitação. HTTP permite cabeçalhos repetidos.

Nome	Tipo	Description
name	string	O nome do campo de cabeçalho
value	string	O valor do campo de cabeçalho

HttpScaleRule

Regra de dimensionamento Http do contêiner do Aplicativo de Contêiner.

Nome	Tipo	Description
auth	ScaleRuleAuth[]	Segredos de autenticação para a regra de escala personalizada.
metadata	object	Propriedades de metadados para descrever a regra de escala http.

Ingress

Configuração de entrada do aplicativo de contêiner.

Nome	Tipo	Valor padrão	Description
additionalPortMappings	IngressPortMapping[]		Configurações para expor portas adicionais no aplicativo de contêiner
allowInsecure	boolean	False	Bool indicando se as conexões HTTP com são permitidas. Se definido como conexões HTTP falsas, serão redirecionados automaticamente para conexões HTTPS
clientCertificateMode	IngressClientCertificateMode		Modo de certificado do cliente para autenticação mTLS. Ignorar indica que o servidor descarta o certificado do cliente no encaminhamento. Accept indica que o servidor encaminha o certificado do cliente, mas não requer um certificado do cliente. Exigir indica que o servidor requer um certificado do cliente.
corsPolicy	CorsPolicy		Política cors para aplicativo de contêiner
customDomains	CustomDomain[]		associações de domínio personalizadas para nomes de host dos Aplicativos de Contêiner.
exposedPort	integer		Porta exposta em contêineres para tráfego TCP de entrada
external	boolean	False	Bool indicando se o aplicativo expõe um ponto de extremidade http externo
fqdn	string		Hostname.
ipSecurityRestrictions	IpSecurityRestrictionRule[]		Regras para restringir o endereço IP de entrada.
stickySessions	StickySessions		Sessões autoadesivas para o modo de revisão única
targetPort	integer		Porta de destino em contêineres para tráfego de entrada
traffic	TrafficWeight[]		Pesos de tráfego para revisões do aplicativo
transport	IngressTransportMethod	auto	Protocolo de transporte de entrada

IngressClientCertificateMode

Modo de certificado do cliente para autenticação mTLS. Ignorar indica que o servidor descarta o certificado do cliente no encaminhamento. Accept indica que o servidor encaminha o certificado do cliente, mas não requer um certificado do cliente. Exigir indica que o servidor requer um certificado do cliente.

Nome	Tipo	Description
accept	string
ignore	string
require	string

IngressPortMapping

Mapeamentos de porta de entrada do aplicativo de contêiner

Nome	Tipo	Description
exposedPort	integer	Especifica a porta exposta para a porta de destino. Se não for especificado, o padrão será a porta de destino
external	boolean	Especifica se a porta do aplicativo está acessível fora do ambiente
targetPort	integer	Especifica a porta em que o contêiner do usuário escuta

IngressTransportMethod

Protocolo de transporte de entrada

Nome	Tipo	Description
auto	string
http	string
http2	string
tcp	string

InitContainer

Definição do contêiner de inicialização do Aplicativo de Contêiner

Nome	Tipo	Description
args	string[]	Argumentos de comando de início de contêiner.
command	string[]	Comando de início do contêiner.
env	EnvironmentVar[]	Variáveis de ambiente de contêiner.
image	string	Marca de imagem de contêiner.
name	string	Nome do contêiner personalizado.
resources	ContainerResources	Requisitos de recursos do contêiner.
volumeMounts	VolumeMount[]	Montagens de volume de contêiner.

IpSecurityRestrictionRule

Regra para restringir o endereço IP de entrada.

Nome	Tipo	Description
action	action	Permitir ou negar regras para determinar o IP de entrada. Observação: as regras só podem consistir em ALL Allow ou ALL Deny
description	string	Descreva a regra de restrição de IP que está sendo enviada para o contêiner-aplicativo. Esse é um campo opcional.
ipAddressRange	string	Notação CIDR para corresponder ao endereço IP de entrada
name	string	Nome da regra de restrição de IP.

logLevel

Define o nível de log para o sidecar do Dapr. Os valores permitidos são depuração, informações, aviso, erro. O padrão é informações.

Nome	Tipo	Description
debug	string
error	string
info	string
warn	string

ManagedServiceIdentity

Identidade de serviço gerenciada (identidades atribuídas pelo sistema e/ou atribuídas pelo usuário)

Nome	Tipo	Description
principalId	string	A ID da entidade de serviço da identidade atribuída pelo sistema. Essa propriedade só será fornecida para uma identidade atribuída pelo sistema.
tenantId	string	A ID do locatário da identidade atribuída pelo sistema. Essa propriedade só será fornecida para uma identidade atribuída pelo sistema.
type	ManagedServiceIdentityType	Tipo de identidade de serviço gerenciada (em que os tipos SystemAssigned e UserAssigned são permitidos).
userAssignedIdentities	<string, UserAssignedIdentity>	Identidades User-Assigned O conjunto de identidades atribuídas pelo usuário associadas ao recurso. As chaves do dicionário userAssignedIdentities serão IDs de recurso do ARM no formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores do dicionário podem ser objetos vazios ({}) em solicitações.

ManagedServiceIdentityType

Tipo de identidade de serviço gerenciada (em que os tipos SystemAssigned e UserAssigned são permitidos).

Nome	Tipo	Description
None	string
SystemAssigned	string
SystemAssigned,UserAssigned	string
UserAssigned	string

QueueScaleRule

Regra de dimensionamento baseada em Fila do Azure do contêiner do Aplicativo de Contêiner.

Nome	Tipo	Description
auth	ScaleRuleAuth[]	Segredos de autenticação para a regra de escala de fila.
queueLength	integer	Comprimento da fila.
queueName	string	Nome da fila.

RegistryCredentials

Registro Privado do Aplicativo de Contêiner

Nome	Tipo	Description
identity	string	Uma Identidade Gerenciada a ser usada para autenticar com Registro de Contêiner do Azure. Para identidades atribuídas pelo usuário, use a ID de recurso de identidade atribuída pelo usuário completa. Para identidades atribuídas pelo sistema, use 'system'
passwordSecretRef	string	O nome do Segredo que contém a senha de logon do Registro
server	string	Servidor do Registro de Contêiner
username	string	Nome de usuário do Registro de Contêiner

Scale

Configurações de dimensionamento do Aplicativo de Contêiner.

Nome	Tipo	Valor padrão	Description
maxReplicas	integer	10	Opcional. Número máximo de réplicas de contêiner. O padrão será 10 se não estiver definido.
minReplicas	integer		Opcional. Número mínimo de réplicas de contêiner.
rules	ScaleRule[]		Regras de dimensionamento.

ScaleRule

Regra de dimensionamento de contêiner do Aplicativo de Contêiner.

Nome	Tipo	Description
azureQueue	QueueScaleRule	Dimensionamento baseado em Fila do Azure.
custom	CustomScaleRule	Regra de escala personalizada.
http	HttpScaleRule	Dimensionamento baseado em solicitações HTTP.
name	string	Nome da regra de escala
tcp	TcpScaleRule	Dimensionamento baseado em solicitações Tcp.

ScaleRuleAuth

Segredos de autenticação para regra de escala

Nome	Tipo	Description
secretRef	string	Nome do segredo do qual efetuar pull dos parâmetros de autenticação.
triggerParameter	string	Parâmetro trigger que usa o segredo

Scheme

Esquema a ser usado para se conectar ao host. O padrão é HTTP.

Nome	Tipo	Description
HTTP	string
HTTPS	string

Secret

Definição de segredo.

Nome	Tipo	Description
identity	string	ID de recurso de uma identidade gerenciada para autenticar com o Azure Key Vault ou o Sistema para usar uma identidade atribuída pelo sistema.
keyVaultUrl	string	URL de Key Vault do Azure apontando para o segredo referenciado pelo aplicativo de contêiner.
name	string	Nome do Segredo.
value	string	Valor do segredo.

SecretVolumeItem

Segredo a ser adicionado ao volume.

Nome	Tipo	Description
path	string	Caminho para o qual o segredo do projeto será. Se nenhum caminho for fornecido, o caminho usará como padrão o nome do segredo listado em secretRef.
secretRef	string	Nome do segredo do Aplicativo de Contêiner do qual extrair o valor do segredo.

Service

Aplicativo de Contêiner para ser um serviço de desenvolvimento

Nome	Tipo	Description
type	string	Tipo de serviço Dev ContainerApp

ServiceBind

Configuração para associar um ContainerApp a um Serviço de ContainerApp de desenvolvimento

Nome	Tipo	Description
name	string	Nome da associação de serviço
serviceId	string	ID do recurso do serviço de destino

StickySessions

Sessões autoadesivas para o modo de revisão única

Nome	Tipo	Description
affinity	affinity	Afinidade de sessão autoadesiva

StorageType

Tipo de armazenamento para o volume. Se não for fornecido, use EmptyDir.

Nome	Tipo	Description
AzureFile	string
EmptyDir	string
Secret	string

systemData

Metadados relativos à criação e à última modificação do recurso.

Nome	Tipo	Description
createdAt	string	O carimbo de data/hora da criação de recursos (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string	O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	O tipo de identidade que modificou o recurso pela última vez.

TcpScaleRule

Regra de dimensionamento Tcp do contêiner do Aplicativo de Contêiner.

Nome	Tipo	Description
auth	ScaleRuleAuth[]	Segredos de autenticação para a regra de escala tcp.
metadata	object	Propriedades de metadados para descrever a regra de escala tcp.

TcpSocket

TCPSocket especifica uma ação envolvendo uma porta TCP. Ainda não há suporte para ganchos TCP.

Nome	Tipo	Description
host	string	Opcional: nome do host ao qual se conectar, o padrão é o IP do pod.
port	integer	Número ou nome da porta a ser acessada no contêiner. O número deve estar no intervalo de 1 a 65535. O nome deve ser um IANA_SVC_NAME.

Template

Definição de aplicativo com controle de versão do Aplicativo de Contêiner. Define o estado desejado de uma revisão imutável. Todas as alterações nesta seção resultarão na criação de uma nova revisão

Nome	Tipo	Description
containers	Container[]	Lista de definições de contêiner para o Aplicativo de Contêiner.
initContainers	InitContainer[]	Lista de contêineres especializados que são executados antes dos contêineres de aplicativo.
revisionSuffix	string	Sufixo amigável que é acrescentado ao nome da revisão
scale	Scale	Dimensionamento de propriedades para o Aplicativo de Contêiner.
serviceBinds	ServiceBind[]	Lista de serviços de aplicativos de contêiner associados ao aplicativo
terminationGracePeriodSeconds	integer	Duração opcional em segundos em que a Instância do Aplicativo de Contêiner precisa terminar normalmente. O valor deve ser um inteiro não negativo. O valor zero indica parar imediatamente por meio do sinal de encerramento (sem oportunidade de desligar). Se esse valor for zero, o período de carência padrão será usado. Defina esse valor por mais tempo do que o tempo de limpeza esperado para seu processo. O padrão é 30 segundos.
volumes	Volume[]	Lista de definições de volume para o Aplicativo de Contêiner.

TrafficWeight

Peso do tráfego atribuído a uma revisão

Nome	Tipo	Valor padrão	Description
label	string		Associa um rótulo de tráfego a uma revisão
latestRevision	boolean	False	Indica que o peso do tráfego pertence a uma revisão estável mais recente
revisionName	string		Nome de uma revisão
weight	integer		Peso do tráfego atribuído a uma revisão

Type

O tipo de investigação.

Nome	Tipo	Description
Liveness	string
Readiness	string
Startup	string

UserAssignedIdentity

Propriedades de identidade atribuídas pelo usuário

Nome	Tipo	Description
clientId	string	A ID do cliente da identidade atribuída.
principalId	string	A ID da entidade de segurança da identidade atribuída.

Volume

Definições de volume para o Aplicativo de Contêiner.

Nome	Tipo	Description
mountOptions	string	Opções de montagem usadas durante a montagem do AzureFile. Deve ser uma cadeia de caracteres separada por vírgulas.
name	string	Nome do volume.
secrets	SecretVolumeItem[]	Lista de segredos a serem adicionados no volume. Se nenhum segredo for fornecido, todos os segredos na coleção serão adicionados ao volume.
storageName	string	Nome do recurso de armazenamento. Não é necessário fornecer para EmptyDir e Secret.
storageType	StorageType	Tipo de armazenamento para o volume. Se não for fornecido, use EmptyDir.

VolumeMount

Montagem de volume para o Aplicativo de Contêiner.

Nome	Tipo	Description
mountPath	string	Caminho dentro do contêiner no qual o volume deve ser montado. Não deve conter ':'.
subPath	string	Caminho dentro do volume do qual o volume do contêiner deve ser montado. O padrão é "" (raiz do volume).
volumeName	string	Isso deve corresponder ao Nome de um Volume.

Container Apps - Update

Parâmetros de URI

Corpo da solicitação

Respostas

Segurança

azure_auth

Scopes

Exemplos

Patch Container App

Sample Request

Sample Response

Definições

action

ActiveRevisionsMode

affinity

appProtocol

bindingType

Configuration

Container

ContainerApp

ContainerAppProbe

ContainerAppProvisioningState

ContainerResources

CorsPolicy

createdByType

CustomDomain

CustomScaleRule

Dapr

DefaultErrorResponse

Details

EnvironmentVar

Error

ExtendedLocation

ExtendedLocationTypes

HttpGet

HttpHeaders

HttpScaleRule

Ingress

IngressClientCertificateMode

IngressPortMapping

IngressTransportMethod

InitContainer

IpSecurityRestrictionRule

logLevel

ManagedServiceIdentity

ManagedServiceIdentityType

QueueScaleRule

RegistryCredentials

Scale

ScaleRule

ScaleRuleAuth

Scheme

Secret

SecretVolumeItem

Service

ServiceBind

StickySessions

StorageType

systemData

TcpScaleRule

TcpSocket

Template

TrafficWeight

Type

UserAssignedIdentity

Volume

VolumeMount

Recursos adicionais