Jobs - Start

Hizmet:

Azure Container Apps

API Sürümü:

2026-07-01

Container Apps İşi Başlatma

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
jobName	path	True	string pattern: ^[-\w\._\(\)]+$	İş Adı
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Kaynak grubunun adı. İsim büyük/küçük harfe duyarsızdır.
subscriptionId	path	True	string (uuid)	Hedef aboneliğin kimliği. Değer bir UUID olmalıdır.
api-version	query	True	string minLength: 1	Bu işlem için kullanılacak API sürümü.

İstek Gövdesi

Name	Tür	Description
containers	JobExecutionContainer[]	Container Apps İşi için kapsayıcı tanımlarının listesi.
initContainers	JobExecutionContainer[]	İş kapsayıcılarından önce çalışan özelleştirilmiş kapsayıcıların listesi.

Yanıtlar

Name	Tür	Description
200 OK	JobExecutionBase	Azure işlemi başarıyla tamamlandı.
202 Accepted		Kaynak işlemi kabul edildi. Üst Bilgiler Location: string Retry-After: integer
Other Status Codes	DefaultErrorResponse	Beklenmeyen bir hata yanıtı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 Akışı.

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

Name	Description
user_impersonation	kullanıcı hesabınızı taklit etme

Örnekler

Run a Container Apps Job

Örnek isteği

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

Örnek yanıt

Durum kodu:

200

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

Durum kodu:

202

Location: location

Tanımlar

Name	Description
ContainerResources	Kapsayıcı Uygulaması kapsayıcı kaynak gereksinimleri.
DefaultErrorResponse	App Service hata yanıtı.
DefaultErrorResponseError	Hata modeli.
DefaultErrorResponseErrorDetailsItem	Ayrıntılı hatalar.
EnvironmentVar	Container App kapsayıcı ortam değişkeni.
JobExecutionBase	Kapsayıcı Uygulamasının İş yürütme adı.
JobExecutionContainer	Container Apps İşleri yürütme kapsayıcı tanımı.
JobExecutionTemplate	İşin yürütülmesi için kapsayıcı yapılandırmasını içeren işin yürütme şablonu

ContainerResources

Nesne

Kapsayıcı Uygulaması kapsayıcı kaynak gereksinimleri.

Name	Tür	Description
cpu	number (double)	Çekirdeklerde gerekli CPU, örneğin 0,5
ephemeralStorage	string	Kısa Ömürlü Depolama, örneğin "1Gi"
memory	string	Gerekli bellek, örneğin "250 Mb"

DefaultErrorResponse

Nesne

App Service hata yanıtı.

Name	Tür	Description
error	DefaultErrorResponseError	Hata modeli.

DefaultErrorResponseError

Nesne

Hata modeli.

Name	Tür	Description
code	string	Hatayı program aracılığıyla tanımlamak için standartlaştırılmış dize.
details	DefaultErrorResponseErrorDetailsItem[]	Ayrıntılar veya hata
innererror	string	Hata ayıklamak için daha fazla bilgi.
message	string	Ayrıntılı hata açıklaması ve hata ayıklama bilgileri.
target	string	Ayrıntılı hata açıklaması ve hata ayıklama bilgileri.

DefaultErrorResponseErrorDetailsItem

Nesne

Ayrıntılı hatalar.

Name	Tür	Description
code	string	Hatayı program aracılığıyla tanımlamak için standartlaştırılmış dize.
message	string	Ayrıntılı hata açıklaması ve hata ayıklama bilgileri.
target	string	Ayrıntılı hata açıklaması ve hata ayıklama bilgileri.

EnvironmentVar

Nesne

Container App kapsayıcı ortam değişkeni.

Name	Tür	Description
name	string	Ortam değişkeni adı.
secretRef	string	Ortam değişkeni değerinin çekildiği Container App gizli dizisinin adı.
value	string	Gizli dizi olmayan ortam değişkeni değeri.

JobExecutionBase

Nesne

Kapsayıcı Uygulamasının İş yürütme adı.

Name	Tür	Description
id	string	İş yürütme kimliği.
name	string	İş yürütme adı.

JobExecutionContainer

Nesne

Container Apps İşleri yürütme kapsayıcı tanımı.

Name	Tür	Description
args	string[]	Kapsayıcı başlatma komutu bağımsız değişkenleri.
command	string[]	Kapsayıcı başlatma komutu.
env	EnvironmentVar[]	Kapsayıcı ortamı değişkenleri.
image	string	Kapsayıcı görüntüsü etiketi.
name	string	Özel kapsayıcı adı.
resources	ContainerResources	Kapsayıcı kaynağı gereksinimleri.

JobExecutionTemplate

Nesne

İşin yürütülmesi için kapsayıcı yapılandırmasını içeren işin yürütme şablonu

Name	Tür	Description
containers	JobExecutionContainer[]	Container Apps İşi için kapsayıcı tanımlarının listesi.
initContainers	JobExecutionContainer[]	İş kapsayıcılarından önce çalışan özelleştirilmiş kapsayıcıların listesi.