Jobs - Start

Dienst:: Azure Container Apps

API-Version:: 2026-07-01

Starten eines Container Apps-Auftrags

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
jobName	path	True	string pattern: ^[-\w\._]+$	Auftragsname
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.
subscriptionId	path	True	string (uuid)	Die ID des Zielabonnements. Der Wert muss eine UUID sein.
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.

Anforderungstext

Name	Typ	Beschreibung
containers	JobExecutionContainer[]	Liste der Containerdefinitionen für den Container-Apps-Auftrag.
initContainers	JobExecutionContainer[]	Liste der speziellen Container, die vor Auftragscontainern ausgeführt werden.

Antworten

Name	Typ	Beschreibung
200 OK	JobExecutionBase	Der Azure-Vorgang wurde erfolgreich abgeschlossen.
202 Accepted		Ressourcenvorgang akzeptiert. Header Location: string Retry-After: integer
Other Status Codes	DefaultErrorResponse	Unerwartete Fehlerantwort.

Name

Typ

Beschreibung

200 OK

JobExecutionBase

Der Azure-Vorgang wurde erfolgreich abgeschlossen.

202 Accepted

Ressourcenvorgang akzeptiert.

Header

Location: string
Retry-After: integer

Other Status Codes

DefaultErrorResponse

Unerwartete Fehlerantwort.

Sicherheit

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Sich als Ihr Benutzerkonto ausgeben

Beispiele

Run a Container Apps Job

Beispielanforderung

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

from azure.identity import DefaultAzureCredential

from azure.mgmt.appcontainers import ContainerAppsAPIClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-appcontainers
# USAGE
    python job_start.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = ContainerAppsAPIClient(
        credential=DefaultAzureCredential(),
        subscription_id="SUBSCRIPTION_ID",
    )

    response = client.jobs.begin_start(
        resource_group_name="rg",
        job_name="testcontainerAppsJob0",
    ).result()
    print(response)


# x-ms-original-file: 2026-07-01/Job_Start.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

package armappcontainers_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/appcontainers/armappcontainers/v5"
)

// Generated from example definition: 2026-07-01/Job_Start.json
func ExampleJobsClient_BeginStart() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armappcontainers.NewClientFactory("34adfa4f-cedf-4dc0-ba29-b6d1a69ab345", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewJobsClient().BeginStart(ctx, "rg", "testcontainerAppsJob0", &armappcontainers.JobsClientBeginStartOptions{
		Template: &armappcontainers.JobExecutionTemplate{
			Containers: []*armappcontainers.JobExecutionContainer{
				{
					Name:  to.Ptr("testcontainerAppsJob0"),
					Image: to.Ptr("repo/testcontainerAppsJob0:v4"),
					Resources: &armappcontainers.ContainerResources{
						CPU:    to.Ptr[float64](0.2),
						Memory: to.Ptr("100Mi"),
					},
				},
			},
			InitContainers: []*armappcontainers.JobExecutionContainer{
				{
					Name: to.Ptr("testinitcontainerAppsJob0"),
					Args: []*string{
						to.Ptr("-c"),
						to.Ptr("while true; do echo hello; sleep 10;done"),
					},
					Command: []*string{
						to.Ptr("/bin/sh"),
					},
					Image: to.Ptr("repo/testcontainerAppsJob0:v4"),
					Resources: &armappcontainers.ContainerResources{
						CPU:    to.Ptr[float64](0.2),
						Memory: to.Ptr("100Mi"),
					},
				},
			},
		}})
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to poll the result: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res = armappcontainers.JobsClientStartResponse{
	// 	JobExecutionBase: armappcontainers.JobExecutionBase{
	// 		Name: to.Ptr("testcontainerAppsJob0-pjxhsye"),
	// 		ID: to.Ptr("/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/jobs/{containerAppsJobName}/executions/{jobExecutionName}"),
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

const { ContainerAppsAPIClient } = require("@azure/arm-appcontainers");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to start a Container Apps Job
 *
 * @summary start a Container Apps Job
 * x-ms-original-file: 2026-07-01/Job_Start.json
 */
async function runAContainerAppsJob() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "34adfa4f-cedf-4dc0-ba29-b6d1a69ab345";
  const client = new ContainerAppsAPIClient(credential, subscriptionId);
  const result = await client.jobs.start("rg", "testcontainerAppsJob0", {
    template: {
      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" },
        },
      ],
    },
  });
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Beispiel für eine Antwort

Statuscode:: 200

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

Statuscode:: 202

Location: location

Definitionen

Name	Beschreibung
ContainerResources	Container-App-Containerressourcenanforderungen.
DefaultErrorResponse	Fehlerantwort des App-Diensts.
DefaultErrorResponseError	Fehlermodell.
DefaultErrorResponseErrorDetailsItem	Detaillierte Fehler.
EnvironmentVar	Container-App-Umgebungsvariable.
JobExecutionBase	Auftragsausführungsname der Container-App.
JobExecutionContainer	Containerdefinition für Container-Apps-Aufträge.
JobExecutionTemplate	Ausführungsvorlage des Auftrags, die containerkonfiguration für die Ausführung eines Auftrags enthält

ContainerResources

Objekt

Container-App-Containerressourcenanforderungen.

Name	Typ	Beschreibung
cpu	number (double)	Erforderliche CPU in Kernen, z. B. 0,5
ephemeralStorage	string	Ephemere Lagerung, z.B. "1Gi"
memory	string	Erforderlicher Arbeitsspeicher, z. B. "250Mb"

DefaultErrorResponse

Objekt

Fehlerantwort des App-Diensts.

Name	Typ	Beschreibung
error	DefaultErrorResponseError	Fehlermodell.

DefaultErrorResponseError

Objekt

Fehlermodell.

Name	Typ	Beschreibung
code	string	Standardisierte Zeichenfolge zur programmgesteuerten Identifizierung des Fehlers.
details	DefaultErrorResponseErrorDetailsItem[]	Details oder der Fehler
innererror	string	Weitere Informationen zum Debuggen von Fehlern.
message	string	Detaillierte Fehlerbeschreibung und Informationen zum Debuggen.
target	string	Detaillierte Fehlerbeschreibung und Informationen zum Debuggen.

DefaultErrorResponseErrorDetailsItem

Objekt

Detaillierte Fehler.

Name	Typ	Beschreibung
code	string	Standardisierte Zeichenfolge zur programmgesteuerten Identifizierung des Fehlers.
message	string	Detaillierte Fehlerbeschreibung und Informationen zum Debuggen.
target	string	Detaillierte Fehlerbeschreibung und Informationen zum Debuggen.

EnvironmentVar

Objekt

Container-App-Umgebungsvariable.

Name	Typ	Beschreibung
name	string	Name der Umgebungsvariable.
secretRef	string	Name des geheimen Container-App-Schlüssels, aus dem der Umgebungsvariablenwert abgerufen werden soll.
value	string	Nicht geheimer Umgebungsvariablenwert.

JobExecutionBase

Objekt

Auftragsausführungsname der Container-App.

Name	Typ	Beschreibung
id	string	ID der Auftragsausführung.
name	string	Auftragsausführungsname.

JobExecutionContainer

Objekt

Containerdefinition für Container-Apps-Aufträge.

Name	Typ	Beschreibung
args	string[]	Argumente für containerstartbefehle.
command	string[]	Containerstartbefehl.
env	EnvironmentVar[]	Containerumgebungsvariablen.
image	string	Containerimage-Tag.
name	string	Benutzerdefinierter Containername.
resources	ContainerResources	Containerressourcenanforderungen.

JobExecutionTemplate

Objekt

Ausführungsvorlage des Auftrags, die containerkonfiguration für die Ausführung eines Auftrags enthält

Name	Typ	Beschreibung
containers	JobExecutionContainer[]	Liste der Containerdefinitionen für den Container-Apps-Auftrag.
initContainers	JobExecutionContainer[]	Liste der speziellen Container, die vor Auftragscontainern ausgeführt werden.