Compartilhar via


Container Apps - Update

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.

Cabeçalhos

Location: string

Other Status Codes

DefaultErrorResponse

Resposta de erro comum.

Segurança

azure_auth

Fluxo do OAuth2 do Azure Active Directory

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome Description
user_impersonation representar sua conta de usuário

Exemplos

Patch Container App

Solicitação de exemplo

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

Resposta de exemplo

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

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.