Jobs - Start

Serviço:

Azure Container Apps

Versão da API:

2026-07-01

Iniciar um trabalho dos 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 de URI

Nome	Em	Obrigatório	Tipo	Description
jobName	path	True	string pattern: ^[-\w\._\(\)]+$	Nome do Trabalho
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 uma UUID.
api-version	query	True	string minLength: 1	A versão da API a ser usada para esta operação.

Corpo da solicitação

Nome	Tipo	Description
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	Description
200 OK	JobExecutionBase	A operação do Azure foi 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 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	se passar pela sua conta de usuário

Exemplos

Run a Container Apps Job

Solicitação de exemplo

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

Resposta de exemplo

Código de status:

200

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

Código de status:

202

Location: location

Definições

Nome	Description
ContainerResources	Requisitos de recurso 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 Trabalhos de Aplicativos de Contêiner.
JobExecutionTemplate	Modelo de execução do trabalho, que contém a configuração de contêiner para a execução de um trabalho

ContainerResources

Objeto

Requisitos de recurso de contêiner do Aplicativo de Contêiner.

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

DefaultErrorResponse

Objeto

Resposta de erro do Serviço de Aplicativo.

Nome	Tipo	Description
error	DefaultErrorResponseError	Modelo de erro.

DefaultErrorResponseError

Objeto

Modelo de erro.

Nome	Tipo	Description
code	string	Cadeia de caracteres padronizada para identificar programaticamente o erro.
details	DefaultErrorResponseErrorDetailsItem[]	Detalhes ou o erro
innererror	string	Mais informações para depurar 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.

DefaultErrorResponseErrorDetailsItem

Objeto

Erros detalhados.

Nome	Tipo	Description
code	string	Cadeia de caracteres 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

Objeto

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.

JobExecutionBase

Objeto

Nome de execução do Trabalho do Aplicativo de Contêiner.

Nome	Tipo	Description
id	string	ID de execução do trabalho.
name	string	Nome da execução do trabalho.

JobExecutionContainer

Objeto

Definição de contêiner de execução de Trabalhos de Aplicativos 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 de contêiner.

JobExecutionTemplate

Objeto

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

Nome	Tipo	Description
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.