Jobs - Start

Service:

Azure Container Apps

Version d’API:

2026-07-01

Obtient un travail Container Apps

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
jobName	path	True	string pattern: ^[-\w\._\(\)]+$	Nom du travail
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nom du groupe de ressources. Le nom ne respecte pas la casse.
subscriptionId	path	True	string (uuid)	ID de l’abonnement cible. La valeur doit être un UUID.
api-version	query	True	string minLength: 1	Version de l’API à utiliser pour cette opération.

Corps de la demande

Nom	Type	Description
containers	JobExecutionContainer[]	Liste des définitions de conteneur pour le travail Container Apps.
initContainers	JobExecutionContainer[]	Liste des conteneurs spécialisés qui s’exécutent avant les conteneurs de travaux.

Réponses

Nom	Type	Description
200 OK	JobExecutionBase	L’opération Azure s’est terminée avec succès.
202 Accepted		Exploitation des ressources acceptée. En-têtes Location: string Retry-After: integer
Other Status Codes	DefaultErrorResponse	Réponse d’erreur inattendue.

Sécurité

azure_auth

Flux OAuth2 d’Azure Active Directory.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	Usurper l’identité de votre compte utilisateur

Exemples

Run a Container Apps Job

Exemple de requête

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

Java

import com.azure.resourcemanager.appcontainers.models.ContainerResources;
import com.azure.resourcemanager.appcontainers.models.JobExecutionContainer;
import com.azure.resourcemanager.appcontainers.models.JobExecutionTemplate;
import java.util.Arrays;

/**
 * Samples for Jobs Start.
 */
public final class Main {
    /*
     * x-ms-original-file: 2026-07-01/Job_Start.json
     */
    /**
     * Sample code: Run a Container Apps Job.
     * 
     * @param manager Entry point to ContainerAppsApiManager.
     */
    public static void runAContainerAppsJob(com.azure.resourcemanager.appcontainers.ContainerAppsApiManager manager) {
        manager.jobs().start("rg", "testcontainerAppsJob0",
            new JobExecutionTemplate()
                .withContainers(Arrays.asList(new JobExecutionContainer().withImage("repo/testcontainerAppsJob0:v4")
                    .withName("testcontainerAppsJob0")
                    .withResources(new ContainerResources().withCpu(0.2D).withMemory("100Mi"))))
                .withInitContainers(Arrays.asList(new JobExecutionContainer().withImage("repo/testcontainerAppsJob0:v4")
                    .withName("testinitcontainerAppsJob0").withCommand(Arrays.asList("/bin/sh"))
                    .withArgs(Arrays.asList("-c", "while true; do echo hello; sleep 10;done"))
                    .withResources(new ContainerResources().withCpu(0.2D).withMemory("100Mi")))),
            com.azure.core.util.Context.NONE);
    }
}

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

Python

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

Go

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

JavaScript

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

Exemple de réponse

Code d’état:

200

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

Code d’état:

202

Location: location

Définitions

Nom	Description
ContainerResources	Configuration requise pour les ressources de conteneur d’application conteneur.
DefaultErrorResponse	Réponse d’erreur App Service.
DefaultErrorResponseError	Modèle d’erreur.
DefaultErrorResponseErrorDetailsItem	Erreurs détaillées.
EnvironmentVar	Variable d’environnement de conteneur d’application conteneur.
JobExecutionBase	Nom d’exécution du travail de l’application conteneur.
JobExecutionContainer	Définition du conteneur d’exécution des travaux Container Apps.
JobExecutionTemplate	Modèle d’exécution du travail contenant la configuration du conteneur pour l’exécution d’un travail

ContainerResources

Objet

Configuration requise pour les ressources de conteneur d’application conteneur.

Nom	Type	Description
cpu	number (double)	Processeur requis dans les cœurs, par exemple 0,5
ephemeralStorage	string	Stockage éphémère, par exemple « 1Gi »
memory	string	Mémoire requise, par exemple « 250 Mo »

DefaultErrorResponse

Objet

Réponse d’erreur App Service.

Nom	Type	Description
error	DefaultErrorResponseError	Modèle d’erreur.

DefaultErrorResponseError

Objet

Modèle d’erreur.

Nom	Type	Description
code	string	Chaîne standardisée pour identifier l’erreur par programmation.
details	DefaultErrorResponseErrorDetailsItem[]	Détails ou l’erreur
innererror	string	Plus d’informations pour déboguer l’erreur.
message	string	Description détaillée de l’erreur et informations de débogage.
target	string	Description détaillée de l’erreur et informations de débogage.

DefaultErrorResponseErrorDetailsItem

Objet

Erreurs détaillées.

Nom	Type	Description
code	string	Chaîne standardisée pour identifier l’erreur par programmation.
message	string	Description détaillée de l’erreur et informations de débogage.
target	string	Description détaillée de l’erreur et informations de débogage.

EnvironmentVar

Objet

Variable d’environnement de conteneur d’application conteneur.

Nom	Type	Description
name	string	Nom de la variable d’environnement.
secretRef	string	Nom du secret de l’application conteneur à partir duquel extraire la valeur de la variable d’environnement.
value	string	Valeur de variable d’environnement non secrète.

JobExecutionBase

Objet

Nom d’exécution du travail de l’application conteneur.

Nom	Type	Description
id	string	Exécution de la tâche Id.
name	string	Nom de l’exécution du travail.

JobExecutionContainer

Objet

Définition du conteneur d’exécution des travaux Container Apps.

Nom	Type	Description
args	string[]	Arguments de commande de démarrage du conteneur.
command	string[]	Commande de démarrage du conteneur.
env	EnvironmentVar[]	Variables d’environnement de conteneur.
image	string	Balise d’image conteneur.
name	string	Nom du conteneur personnalisé.
resources	ContainerResources	Exigences en matière de ressources de conteneur.

JobExecutionTemplate

Objet

Modèle d’exécution du travail contenant la configuration du conteneur pour l’exécution d’un travail

Nom	Type	Description
containers	JobExecutionContainer[]	Liste des définitions de conteneur pour le travail Container Apps.
initContainers	JobExecutionContainer[]	Liste des conteneurs spécialisés qui s’exécutent avant les conteneurs de travaux.