Jobs - Start

Iniciar um trabalho de aplicativos de contêiner

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.App/jobs/{jobName}/start?api-version=2026-07-01

Parâmetros do URI

Nome Em Obrigatório Tipo Descrição
jobName
path True

string

pattern: ^[-\w\._\(\)]+$

Nome da Tarefa

resourceGroupName
path True

string

minLength: 1
maxLength: 90

O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.

subscriptionId
path True

string (uuid)

O ID da assinatura de destino. O valor deve ser um UUID.

api-version
query True

string

minLength: 1

A versão da API a utilizar para esta operação.

Corpo do Pedido

Nome Tipo Descrição
containers

JobExecutionContainer[]

Lista de definições de contêiner para o Trabalho de Aplicativos de Contêiner.

initContainers

JobExecutionContainer[]

Lista de contêineres especializados que são executados antes dos contêineres de trabalho.

Respostas

Nome Tipo Descrição
200 OK

JobExecutionBase

Operação do Azure concluída com êxito.

202 Accepted

Operação de recurso aceita.

Cabeçalhos

  • Location: string
  • Retry-After: integer
Other Status Codes

DefaultErrorResponse

Uma resposta de erro inesperada.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

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

Âmbitos

Nome Descrição
user_impersonation assumir a identidade da sua conta de utilizador

Exemplos

Run a Container Apps Job

Pedido de amostra

POST https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/jobs/testcontainerAppsJob0/start?api-version=2026-07-01

{
  "containers": [
    {
      "name": "testcontainerAppsJob0",
      "image": "repo/testcontainerAppsJob0:v4",
      "resources": {
        "cpu": 0.2,
        "memory": "100Mi"
      }
    }
  ],
  "initContainers": [
    {
      "name": "testinitcontainerAppsJob0",
      "args": [
        "-c",
        "while true; do echo hello; sleep 10;done"
      ],
      "command": [
        "/bin/sh"
      ],
      "image": "repo/testcontainerAppsJob0:v4",
      "resources": {
        "cpu": 0.2,
        "memory": "100Mi"
      }
    }
  ]
}

Resposta da amostra

{
  "name": "testcontainerAppsJob0-pjxhsye",
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/jobs/{containerAppsJobName}/executions/{jobExecutionName}"
}
Location: location

Definições

Nome Descrição
ContainerResources

Requisitos de recursos de contêiner do aplicativo de contêiner.

DefaultErrorResponse

Resposta de erro do Serviço de Aplicativo.

DefaultErrorResponseError

Modelo de erro.

DefaultErrorResponseErrorDetailsItem

Erros detalhados.

EnvironmentVar

Variável de ambiente de contêiner do aplicativo de contêiner.

JobExecutionBase

Nome de execução do trabalho do aplicativo de contêiner.

JobExecutionContainer

Definição de contêiner de execução de Aplicativos de Contêiner.

JobExecutionTemplate

Modelo de execução do trabalho, contendo a configuração do contêiner para a execução de um trabalho

ContainerResources

Requisitos de recursos de contêiner do aplicativo de contêiner.

Nome Tipo Descrição
cpu

number (double)

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, "250Mb"

DefaultErrorResponse

Resposta de erro do Serviço de Aplicativo.

Nome Tipo Descrição
error

DefaultErrorResponseError

Modelo de erro.

DefaultErrorResponseError

Modelo de erro.

Nome Tipo Descrição
code

string

String padronizada para identificar programaticamente o erro.

details

DefaultErrorResponseErrorDetailsItem[]

Detalhes ou o erro

innererror

string

Mais informações para depurar erro.

message

string

Descrição detalhada do erro e informações de depuração.

target

string

Descrição detalhada do erro e informações de depuração.

DefaultErrorResponseErrorDetailsItem

Erros detalhados.

Nome Tipo Descrição
code

string

String padronizada para identificar programaticamente o erro.

message

string

Descrição detalhada do erro e informações de depuração.

target

string

Descrição detalhada do erro e informações de depuração.

EnvironmentVar

Variável de ambiente de contêiner do aplicativo de contêiner.

Nome Tipo Descrição
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 da variável de ambiente não secreto.

JobExecutionBase

Nome de execução do trabalho do aplicativo de contêiner.

Nome Tipo Descrição
id

string

Id de execução do trabalho.

name

string

Nome da execução do trabalho.

JobExecutionContainer

Definição de contêiner de execução de Aplicativos de Contêiner.

Nome Tipo Descrição
args

string[]

Argumentos do comando Container start.

command

string[]

Comando Container start.

env

EnvironmentVar[]

Variáveis de ambiente de contêiner.

image

string

Tag de imagem de contêiner.

name

string

Nome do contêiner personalizado.

resources

ContainerResources

Requisitos de recursos de contêiner.

JobExecutionTemplate

Modelo de execução do trabalho, contendo a configuração do contêiner para a execução de um trabalho

Nome Tipo Descrição
containers

JobExecutionContainer[]

Lista de definições de contêiner para o Trabalho de Aplicativos de Contêiner.

initContainers

JobExecutionContainer[]

Lista de contêineres especializados que são executados antes dos contêineres de trabalho.