Jobs - Start

Servizio:: Azure Container Apps

Versione API:: 2026-07-01

Avvia un processo di App contenitore

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
jobName	path	True	string pattern: ^[-\w\._]+$	Nome lavoro
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole.
subscriptionId	path	True	string (uuid)	ID della sottoscrizione di destinazione. Il valore deve essere un UUID.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Corpo della richiesta

Nome	Tipo	Descrizione
containers	JobExecutionContainer[]	Elenco delle definizioni di contenitore per il processo app contenitore.
initContainers	JobExecutionContainer[]	Elenco di contenitori specializzati eseguiti prima dei contenitori di processi.

Risposte

Nome	Tipo	Descrizione
200 OK	JobExecutionBase	Operazione di Azure completata correttamente.
202 Accepted		Operazione sulle risorse accettata. Intestazioni Location: string Retry-After: integer
Other Status Codes	DefaultErrorResponse	Risposta di errore imprevista.

Nome

Tipo

Descrizione

200 OK

JobExecutionBase

Operazione di Azure completata correttamente.

202 Accepted

Operazione sulle risorse accettata.

Intestazioni

Location: string
Retry-After: integer

Other Status Codes

DefaultErrorResponse

Risposta di errore imprevista.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	impersonare il tuo account utente

Esempio

Run a Container Apps Job

Esempio di richiesta

HTTP

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

Risposta di esempio

Codice di stato:: 200

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

Codice di stato:: 202

Location: location

Definizioni

Nome	Descrizione
ContainerResources	Requisiti delle risorse contenitore dell'app contenitore contenitore.
DefaultErrorResponse	Risposta di errore del servizio app.
DefaultErrorResponseError	Modello di errore.
DefaultErrorResponseErrorDetailsItem	Errori dettagliati.
EnvironmentVar	Variabile di ambiente contenitore dell'app contenitore.
JobExecutionBase	Nome dell'esecuzione del processo dell'app contenitore.
JobExecutionContainer	Definizione del contenitore per l'esecuzione dei processi di App contenitore.
JobExecutionTemplate	Modello di esecuzione del processo contenente la configurazione del contenitore per l'esecuzione di un processo

ContainerResources

Oggetto

Requisiti delle risorse contenitore dell'app contenitore contenitore.

Nome	Tipo	Descrizione
cpu	number (double)	CPU necessaria nei core, ad esempio 0,5
ephemeralStorage	string	Archiviazione temporanea, ad es. "1Gi"
memory	string	Memoria necessaria, ad esempio "250 Mb"

DefaultErrorResponse

Oggetto

Risposta di errore del servizio app.

Nome	Tipo	Descrizione
error	DefaultErrorResponseError	Modello di errore.

DefaultErrorResponseError

Oggetto

Modello di errore.

Nome	Tipo	Descrizione
code	string	Stringa standardizzata per identificare l'errore a livello di codice.
details	DefaultErrorResponseErrorDetailsItem[]	Dettagli o errore
innererror	string	Ulteriori informazioni per eseguire il debug dell'errore.
message	string	Descrizione dettagliata dell'errore e informazioni di debug.
target	string	Descrizione dettagliata dell'errore e informazioni di debug.

DefaultErrorResponseErrorDetailsItem

Oggetto

Errori dettagliati.

Nome	Tipo	Descrizione
code	string	Stringa standardizzata per identificare l'errore a livello di codice.
message	string	Descrizione dettagliata dell'errore e informazioni di debug.
target	string	Descrizione dettagliata dell'errore e informazioni di debug.

EnvironmentVar

Oggetto

Variabile di ambiente contenitore dell'app contenitore.

Nome	Tipo	Descrizione
name	string	Nome della variabile di ambiente.
secretRef	string	Nome del segreto dell'app contenitore da cui eseguire il pull del valore della variabile di ambiente.
value	string	Valore della variabile di ambiente non segreto.

JobExecutionBase

Oggetto

Nome dell'esecuzione del processo dell'app contenitore.

Nome	Tipo	Descrizione
id	string	ID di esecuzione del processo.
name	string	Nome dell'esecuzione del processo.

JobExecutionContainer

Oggetto

Definizione del contenitore per l'esecuzione dei processi di App contenitore.

Nome	Tipo	Descrizione
args	string[]	Argomenti del comando di avvio del contenitore.
command	string[]	Comando start del contenitore.
env	EnvironmentVar[]	Variabili di ambiente del contenitore.
image	string	Tag immagine contenitore.
name	string	Nome del contenitore personalizzato.
resources	ContainerResources	Requisiti delle risorse del contenitore.

JobExecutionTemplate

Oggetto

Modello di esecuzione del processo contenente la configurazione del contenitore per l'esecuzione di un processo

Nome	Tipo	Descrizione
containers	JobExecutionContainer[]	Elenco delle definizioni di contenitore per il processo app contenitore.
initContainers	JobExecutionContainer[]	Elenco di contenitori specializzati eseguiti prima dei contenitori di processi.