Jobs - Start

Inicio de un trabajo de Container Apps

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
jobName
path True

string

pattern: ^[-\w\._\(\)]+$

Nombre del trabajo

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.

subscriptionId
path True

string (uuid)

Identificador de la suscripción de destino. El valor debe ser un UUID.

api-version
query True

string

minLength: 1

Versión de la API que se va a usar para esta operación.

Cuerpo de la solicitud

Nombre Tipo Description
containers

JobExecutionContainer[]

Lista de definiciones de contenedor para el trabajo de aplicaciones de contenedor.

initContainers

JobExecutionContainer[]

Lista de contenedores especializados que se ejecutan antes de los contenedores de trabajos.

Respuestas

Nombre Tipo Description
200 OK

JobExecutionBase

La operación de Azure se completó correctamente.

202 Accepted

Operación de recursos aceptada.

Encabezados

  • Location: string
  • Retry-After: integer
Other Status Codes

DefaultErrorResponse

Una respuesta de error inesperada.

Seguridad

azure_auth

Flujo OAuth2 de Azure Active Directory.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre Description
user_impersonation suplantar su cuenta de usuario

Ejemplos

Run a Container Apps Job

Solicitud de ejemplo

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

Respuesta de muestra

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

Definiciones

Nombre Description
ContainerResources

Requisitos de recursos de contenedor de la aplicación contenedora.

DefaultErrorResponse

Respuesta de error de App Service.

DefaultErrorResponseError

Modelo de error.

DefaultErrorResponseErrorDetailsItem

Errores detallados.

EnvironmentVar

Variable de entorno de contenedor de la aplicación contenedora.

JobExecutionBase

Nombre de ejecución del trabajo de la aplicación contenedora.

JobExecutionContainer

Definición de contenedor de ejecución de trabajos de Container Apps.

JobExecutionTemplate

Plantilla de ejecución del trabajo, que contiene la configuración del contenedor para la ejecución de un trabajo

ContainerResources

Requisitos de recursos de contenedor de la aplicación contenedora.

Nombre Tipo Description
cpu

number (double)

CPU necesaria en núcleos, por ejemplo, 0,5

ephemeralStorage

string

Almacenamiento efímero, por ejemplo, "1Gi"

memory

string

Memoria necesaria, por ejemplo, "250 Mb"

DefaultErrorResponse

Respuesta de error de App Service.

Nombre Tipo Description
error

DefaultErrorResponseError

Modelo de error.

DefaultErrorResponseError

Modelo de error.

Nombre Tipo Description
code

string

Cadena estandarizada para identificar el error mediante programación.

details

DefaultErrorResponseErrorDetailsItem[]

Detalles o el error

innererror

string

Más información para depurar el error.

message

string

Descripción detallada del error e información de depuración.

target

string

Descripción detallada del error e información de depuración.

DefaultErrorResponseErrorDetailsItem

Errores detallados.

Nombre Tipo Description
code

string

Cadena estandarizada para identificar el error mediante programación.

message

string

Descripción detallada del error e información de depuración.

target

string

Descripción detallada del error e información de depuración.

EnvironmentVar

Variable de entorno de contenedor de la aplicación contenedora.

Nombre Tipo Description
name

string

Nombre de la variable de entorno.

secretRef

string

Nombre del secreto de aplicación contenedora del que se va a extraer el valor de la variable de entorno.

value

string

Valor de variable de entorno no secreto.

JobExecutionBase

Nombre de ejecución del trabajo de la aplicación contenedora.

Nombre Tipo Description
id

string

Id. de ejecución del trabajo.

name

string

Nombre de ejecución del trabajo.

JobExecutionContainer

Definición de contenedor de ejecución de trabajos de Container Apps.

Nombre Tipo Description
args

string[]

Argumentos de comando de inicio de contenedor.

command

string[]

Comando container start.

env

EnvironmentVar[]

Variables de entorno de contenedor.

image

string

Etiqueta de imagen de contenedor.

name

string

Nombre de contenedor personalizado.

resources

ContainerResources

Requisitos de recursos de contenedor.

JobExecutionTemplate

Plantilla de ejecución del trabajo, que contiene la configuración del contenedor para la ejecución de un trabajo

Nombre Tipo Description
containers

JobExecutionContainer[]

Lista de definiciones de contenedor para el trabajo de aplicaciones de contenedor.

initContainers

JobExecutionContainer[]

Lista de contenedores especializados que se ejecutan antes de los contenedores de trabajos.