Aracılığıyla paylaş


Jobs - Get

Container Apps İşinin özelliklerini alın.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.App/jobs/{jobName}?api-version=2024-03-01

URI Parametreleri

Name İçinde Gerekli Tür Description
jobName
path True

string

İş Adı

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

resourceGroupName
path True

string

Kaynak grubunun adı. Ad büyük/küçük harfe duyarlı değildir.

subscriptionId
path True

string

Hedef aboneliğin kimliği.

api-version
query True

string

Bu işlem için kullanılacak API sürümü.

Yanıtlar

Name Tür Description
200 OK

Job

Tamam ögesini seçin.

Other Status Codes

DefaultErrorResponse

Yaygın hata yanıtı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation kullanıcı hesabınızın kimliğine bürünme

Örnekler

Get Container Apps Job

Sample Request

GET https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/jobs/testcontainerappsjob0?api-version=2024-03-01

Sample Response

{
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/jobs/testcontainerappsjob0",
  "name": "testcontainerappsjob0",
  "type": "Microsoft.App/jobs",
  "location": "East US",
  "properties": {
    "provisioningState": "Succeeded",
    "environmentId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube",
    "configuration": {
      "replicaTimeout": 10,
      "replicaRetryLimit": 10,
      "manualTriggerConfig": {
        "replicaCompletionCount": 1,
        "parallelism": 4
      },
      "triggerType": "Manual"
    },
    "template": {
      "containers": [
        {
          "image": "repo/testcontainerappsjob0:v4",
          "name": "testcontainerappsjob0",
          "resources": {
            "cpu": 0.5,
            "memory": "1Gi"
          }
        }
      ],
      "initContainers": [
        {
          "image": "repo/testcontainerappsjob0:v4",
          "name": "testinitcontainerAppsJob0",
          "resources": {
            "cpu": 0.5,
            "memory": "1Gi"
          }
        }
      ]
    }
  }
}

Tanımlar

Name Description
Container

Container App kapsayıcı tanımı

ContainerAppProbe

Yoklama, kapsayıcının etkin olup olmadığını veya trafiği almaya hazır olup olmadığını belirlemek için kapsayıcıya karşı gerçekleştirilecek sistem durumu denetimini açıklar.

ContainerResources

Container App kapsayıcı kaynak gereksinimleri.

createdByType

Kaynağı oluşturan kimliğin türü.

DefaultErrorResponse

hata yanıtı App Service.

Details

Ayrıntılar veya hata

EnvironmentVar

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

Error

Hata modeli.

EventTriggerConfig

Olay temelli bir işin yapılandırmasını tetikleme.

HttpGet

HTTPGet gerçekleştirilecek http isteğini belirtir.

HttpHeaders

İstekte ayarlanacağı özel üst bilgiler. HTTP yinelenen üst bilgiler sağlar.

InitContainer

Kapsayıcı Uygulaması başlatma kapsayıcı tanımı

Job

Kapsayıcı Uygulaması İşi

JobConfiguration

Sürümlenmemiş Container Apps İş yapılandırma özellikleri

JobProvisioningState

Container Apps İşinin sağlama durumu.

JobScale

Olay temelli işler için yapılandırmaları ölçeklendirme.

JobScaleRule

Ölçeklendirme kuralı.

JobTemplate

Container Apps İşi sürüm uygulama tanımı. Sabit düzeltmenin istenen durumunu tanımlar. Bu bölümde yapılan değişiklikler yeni bir düzeltme oluşturulmasına neden olur

ManagedServiceIdentity

Yönetilen hizmet kimliği (sistem tarafından atanan ve/veya kullanıcı tarafından atanan kimlikler)

ManagedServiceIdentityType

Yönetilen hizmet kimliğinin türü (hem SystemAssigned hem de UserAssigned türlerine izin verilir).

ManualTriggerConfig

Tek bir yürütme işi için el ile tetikleyici yapılandırması. replicaCompletionCount ve paralellik özellikleri varsayılan olarak 1 olarak ayarlanır

RegistryCredentials

Container App Özel Kayıt Defteri

ScaleRuleAuth

Ölçek Kuralı için Gizli Dizileri Doğrulama

ScheduleTriggerConfig

Cronjobs için cron biçimlendirilmiş yinelenen tetikleyici zamanlaması ("* * * * *"). Özellikler tamamlamaları ve paralellik varsayılan olarak 1 olarak ayarlanır

Scheme

Konağa bağlanmak için kullanılacak düzen. Varsayılan olarak HTTP'yi kullanır.

Secret

Gizli dizi tanımı.

SecretVolumeItem

Birime eklenecek gizli dizi.

StorageType

Birimin depolama türü. Sağlanmadıysa EmptyDir kullanın.

systemData

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

TcpSocket

TCPSocket, TCP bağlantı noktası içeren bir eylemi belirtir. TCP kancaları henüz desteklenmiyor.

TriggerType

İşin tetikleyici türü

Type

Yoklama türü.

UserAssignedIdentity

Kullanıcı tarafından atanan kimlik özellikleri

Volume

Kapsayıcı Uygulaması için birim tanımları.

VolumeMount

Kapsayıcı Uygulaması için birim bağlama.

Container

Container App 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ı.

probes

ContainerAppProbe[]

Kapsayıcı için yoklamaların listesi.

resources

ContainerResources

Kapsayıcı kaynağı gereksinimleri.

volumeMounts

VolumeMount[]

Kapsayıcı birimi bağlamaları.

ContainerAppProbe

Yoklama, kapsayıcının etkin olup olmadığını veya trafiği almaya hazır olup olmadığını belirlemek için kapsayıcıya karşı gerçekleştirilecek sistem durumu denetimini açıklar.

Name Tür Description
failureThreshold

integer

Yoklamanın dikkate alınması için en düşük ardışık hatalar başarılı olduktan sonra başarısız oldu. Varsayılan değer 3'tir. En düşük değer 1'dir. En büyük değer 10'dur.

httpGet

HttpGet

HTTPGet gerçekleştirilecek http isteğini belirtir.

initialDelaySeconds

integer

Canlılık yoklamaları başlatılmadan önce kapsayıcı başlatıldıktan sonraki saniye sayısı. En düşük değer 1'dir. En yüksek değer 60'tır.

periodSeconds

integer

Araştırmayı gerçekleştirme sıklıkları (saniye olarak). Varsayılan olarak 10 saniyedir. En düşük değer 1'dir. En büyük değer 240'tır.

successThreshold

integer

Yoklamanın başarısız olduktan sonra başarılı olarak kabul edilmesi için en düşük ardışık başarı. Varsayılan değer 1'tir. Canlılık ve başlangıç için 1 olmalıdır. En düşük değer 1'dir. En büyük değer 10'dur.

tcpSocket

TcpSocket

TCPSocket, TCP bağlantı noktası içeren bir eylemi belirtir. TCP kancaları henüz desteklenmiyor.

terminationGracePeriodSeconds

integer

Saniye cinsinden isteğe bağlı süre, yoklama hatası durumunda podun düzgün bir şekilde sonlandırılması gerekir. Yetkisiz kullanım süresi, podda çalışan işlemlerin sonlandırma sinyali gönderilmesinden ve işlemlerin sonlandırma sinyaliyle zorla durdurulmasından sonraki saniye cinsinden süredir. Bu değeri, işleminiz için beklenen temizleme süresinden daha uzun ayarlayın. Bu değer sıfırsa pod'un terminationGracePeriodSeconds değeri kullanılır. Aksi takdirde, bu değer pod belirtimi tarafından sağlanan değeri geçersiz kılar. Değer negatif olmayan bir tamsayı olmalıdır. Sıfır değeri sonlandırma sinyaliyle hemen durmayı gösterir (kapatma fırsatı yoktur). Bu bir alfa alanıdır ve ProbeTerminationGracePeriod özellik geçidinin etkinleştirilmesini gerektirir. Maksimum değer 3600 saniyedir (1 saat)

timeoutSeconds

integer

Araştırmanın zaman aşımına uğradıktan sonra geçmesi gereken saniye sayısı. Varsayılan değer 1 saniyedir. En düşük değer 1'dir. En büyük değer 240'tır.

type

Type

Yoklama türü.

ContainerResources

Container App kapsayıcı kaynak gereksinimleri.

Name Tür Description
cpu

number

Çekirdek olarak gerekli CPU, örneğin 0,5

ephemeralStorage

string

Kısa Ömürlü Depolama, örneğin "1Gi"

memory

string

Gerekli bellek, örn. "250 Mb"

createdByType

Kaynağı oluşturan kimliğin türü.

Name Tür Description
Application

string

Key

string

ManagedIdentity

string

User

string

DefaultErrorResponse

hata yanıtı App Service.

Name Tür Description
error

Error

Hata modeli.

Details

Ayrıntılar veya hata

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

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.

Error

Hata modeli.

Name Tür Description
code

string

Hatayı program aracılığıyla tanımlamak için standartlaştırılmış dize.

details

Details[]

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.

EventTriggerConfig

Olay temelli bir işin yapılandırmasını tetikleme.

Name Tür Description
parallelism

integer

Bir işin belirli bir zamanda çalışabilen paralel çoğaltmalarının sayısı.

replicaCompletionCount

integer

Genel iş tamamlanmadan önce en az başarılı çoğaltma tamamlama sayısı.

scale

JobScale

Olay temelli işler için yapılandırmaları ölçeklendirme.

HttpGet

HTTPGet gerçekleştirilecek http isteğini belirtir.

Name Tür Description
host

string

Bağlanacak ana bilgisayar adı, pod IP'sini varsayılan olarak kullanır. Bunun yerine httpHeaders içinde "Host" ayarlamak isteyebilirsiniz.

httpHeaders

HttpHeaders[]

İstekte ayarlanacağı özel üst bilgiler. HTTP yinelenen üst bilgiler sağlar.

path

string

HTTP sunucusunda erişim yolu.

port

integer

Kapsayıcıda erişecek bağlantı noktasının adı veya numarası. Sayı 1 ile 65535 arasında olmalıdır. Ad bir IANA_SVC_NAME olmalıdır.

scheme

Scheme

Konağa bağlanmak için kullanılacak düzen. Varsayılan olarak HTTP'yi kullanır.

HttpHeaders

İstekte ayarlanacağı özel üst bilgiler. HTTP yinelenen üst bilgiler sağlar.

Name Tür Description
name

string

Üst bilgi alanı adı

value

string

Üst bilgi alanı değeri

InitContainer

Kapsayıcı Uygulaması başlatma 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.

volumeMounts

VolumeMount[]

Kapsayıcı birimi bağlamaları.

Job

Kapsayıcı Uygulaması İşi

Name Tür Description
id

string

Kaynağın tam kaynak kimliği. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

identity

ManagedServiceIdentity

Kodda gizli dizileri veya kimlik bilgilerini korumamak için diğer Azure hizmetleriyle etkileşime geçmek için kapsayıcı uygulama işinin ihtiyaç duyduğu yönetilen kimlikler.

location

string

Kaynağın bulunduğu coğrafi konum

name

string

Kaynağın adı

properties.configuration

JobConfiguration

Container Apps İş yapılandırma özellikleri.

properties.environmentId

string

Ortamın kaynak kimliği.

properties.eventStreamEndpoint

string

Kapsayıcı uygulamaları işinin olay akışının uç noktası.

properties.outboundIpAddresses

string[]

Kapsayıcı uygulamaları işinin Giden IP Adresleri.

properties.provisioningState

JobProvisioningState

Container Apps İşinin sağlama durumu.

properties.template

JobTemplate

Container Apps iş tanımı.

properties.workloadProfileName

string

Kapsayıcı uygulamaları iş yürütmesi için sabitlemek üzere iş yükü profili adı.

systemData

systemData

Azure Resource Manager createdBy ve modifiedBy bilgilerini içeren meta veriler.

tags

object

Kaynak etiketleri.

type

string

Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts"

JobConfiguration

Sürümlenmemiş Container Apps İş yapılandırma özellikleri

Name Tür Varsayılan değer Description
eventTriggerConfig

EventTriggerConfig

Olay temelli bir işin yapılandırmasını tetikleme.

manualTriggerConfig

ManualTriggerConfig

Tek bir yürütme işi için el ile tetikleyici yapılandırması. replicaCompletionCount ve paralellik özellikleri varsayılan olarak 1 olarak ayarlanır

registries

RegistryCredentials[]

Kapsayıcı uygulamaları işi tarafından kullanılan özel kapsayıcı kayıt defteri kimlik bilgilerinin toplanması

replicaRetryLimit

integer

İşi başarısız olmadan önce en fazla yeniden deneme sayısı.

replicaTimeout

integer

Çoğaltmanın çalışmasına izin verilen en fazla saniye sayısı.

scheduleTriggerConfig

ScheduleTriggerConfig

Cronjobs için cron biçimlendirilmiş yinelenen tetikleyici zamanlaması ("* * * * *"). Özellikler tamamlamaları ve paralellik varsayılan olarak 1 olarak ayarlanır

secrets

Secret[]

Container Apps İşi tarafından kullanılan gizli dizi koleksiyonu

triggerType

TriggerType

Manual

İşin tetikleyici türü

JobProvisioningState

Container Apps İşinin sağlama durumu.

Name Tür Description
Canceled

string

Deleting

string

Failed

string

InProgress

string

Succeeded

string

JobScale

Olay temelli işler için yapılandırmaları ölçeklendirme.

Name Tür Varsayılan değer Description
maxExecutions

integer

100

Tetikleyici için oluşturulan en fazla iş yürütme sayısı (varsayılan 100).

minExecutions

integer

0

Tetikleyici için oluşturulan en az iş yürütmesi sayısı (varsayılan 0)

pollingInterval

integer

Her olay kaynağını saniye cinsinden denetleme aralığı. Varsayılan olarak 30'lar

rules

JobScaleRule[]

Ölçeklendirme kuralları.

JobScaleRule

Ölçeklendirme kuralı.

Name Tür Description
auth

ScaleRuleAuth[]

Ölçek kuralı için kimlik doğrulama gizli dizileri.

metadata

object

Ölçek kuralını açıklayan meta veri özellikleri.

name

string

Ölçek Kuralı Adı

type

string

Ölçek kuralının türü: azure-servicebus, redis vb.

JobTemplate

Container Apps İşi sürüm uygulama tanımı. Sabit düzeltmenin istenen durumunu tanımlar. Bu bölümde yapılan değişiklikler yeni bir düzeltme oluşturulmasına neden olur

Name Tür Description
containers

Container[]

Kapsayıcı Uygulaması için kapsayıcı tanımlarının listesi.

initContainers

InitContainer[]

Uygulama kapsayıcılarından önce çalışan özelleştirilmiş kapsayıcıların listesi.

volumes

Volume[]

Kapsayıcı Uygulaması için birim tanımlarının listesi.

ManagedServiceIdentity

Yönetilen hizmet kimliği (sistem tarafından atanan ve/veya kullanıcı tarafından atanan kimlikler)

Name Tür Description
principalId

string

Sistem tarafından atanan kimliğin hizmet sorumlusu kimliği. Bu özellik yalnızca sistem tarafından atanan kimlik için sağlanacaktır.

tenantId

string

Sistem tarafından atanan kimliğin kiracı kimliği. Bu özellik yalnızca sistem tarafından atanan kimlik için sağlanacaktır.

type

ManagedServiceIdentityType

Yönetilen hizmet kimliğinin türü (hem SystemAssigned hem de UserAssigned türlerine izin verilir).

userAssignedIdentities

<string,  UserAssignedIdentity>

kimlikleri User-Assigned
Kaynakla ilişkili kullanıcı tarafından atanan kimlik kümesi. userAssignedIdentities sözlük anahtarları şu biçimde ARM kaynak kimlikleri olacaktır: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Sözlük değerleri, isteklerdeki boş nesneler ({}) olabilir.

ManagedServiceIdentityType

Yönetilen hizmet kimliğinin türü (hem SystemAssigned hem de UserAssigned türlerine izin verilir).

Name Tür Description
None

string

SystemAssigned

string

SystemAssigned,UserAssigned

string

UserAssigned

string

ManualTriggerConfig

Tek bir yürütme işi için el ile tetikleyici yapılandırması. replicaCompletionCount ve paralellik özellikleri varsayılan olarak 1 olarak ayarlanır

Name Tür Description
parallelism

integer

Bir işin belirli bir zamanda çalışabilen paralel çoğaltmalarının sayısı.

replicaCompletionCount

integer

Genel iş tamamlanmadan önce en az başarılı çoğaltma tamamlama sayısı.

RegistryCredentials

Container App Özel Kayıt Defteri

Name Tür Description
identity

string

Azure Container Registry kimlik doğrulaması için kullanılacak Yönetilen Kimlik. Kullanıcı tarafından atanan kimlikler için, kullanıcı tarafından atanan tam kimlik Kaynak Kimliğini kullanın. Sistem tarafından atanan kimlikler için 'system' kullanın

passwordSecretRef

string

Kayıt defteri oturum açma parolasını içeren Gizli Dizinin adı

server

string

Container Registry Sunucusu

username

string

Kapsayıcı Kayıt Defteri Kullanıcı Adı

ScaleRuleAuth

Ölçek Kuralı için Gizli Dizileri Doğrulama

Name Tür Description
secretRef

string

Kimlik doğrulama parametrelerinin çekildiği gizli dizinin adı.

triggerParameter

string

Gizli diziyi kullanan Tetikleyici Parametresi

ScheduleTriggerConfig

Cronjobs için cron biçimlendirilmiş yinelenen tetikleyici zamanlaması ("* * * * *"). Özellikler tamamlamaları ve paralellik varsayılan olarak 1 olarak ayarlanır

Name Tür Description
cronExpression

string

Cron işinin cron biçimlendirilmiş yinelenen zamanlaması ("* * * *").

parallelism

integer

Bir işin belirli bir zamanda çalışabilen paralel çoğaltmalarının sayısı.

replicaCompletionCount

integer

Genel iş tamamlanmadan önce en az başarılı çoğaltma tamamlama sayısı.

Scheme

Konağa bağlanmak için kullanılacak düzen. Varsayılan olarak HTTP'yi kullanır.

Name Tür Description
HTTP

string

HTTPS

string

Secret

Gizli dizi tanımı.

Name Tür Description
identity

string

Azure Key Vault ile kimlik doğrulaması yapmak için yönetilen kimliğin kaynak kimliği veya sistem tarafından atanan kimliği kullanmak için Sistem.

keyVaultUrl

string

Kapsayıcı uygulaması tarafından başvuruda bulunan gizli diziye işaret eden Azure Key Vault URL'si.

name

string

Gizli Dizi Adı.

value

string

Gizli Dizi Değeri.

SecretVolumeItem

Birime eklenecek gizli dizi.

Name Tür Description
path

string

Proje gizli dizisinin yolu. Yol sağlanmazsa, yol varsayılan olarak secretRef içinde listelenen gizli dizinin adını kullanır.

secretRef

string

Gizli dizi değerinin çekildiği Container App gizli dizisinin adı.

StorageType

Birimin depolama türü. Sağlanmadıysa EmptyDir kullanın.

Name Tür Description
AzureFile

string

EmptyDir

string

Secret

string

systemData

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

Name Tür Description
createdAt

string

Kaynak oluşturma (UTC) zaman damgası.

createdBy

string

Kaynağı oluşturan kimlik.

createdByType

createdByType

Kaynağı oluşturan kimliğin türü.

lastModifiedAt

string

Kaynağın son değişikliğinin zaman damgası (UTC)

lastModifiedBy

string

Kaynağı en son değiştiren kimlik.

lastModifiedByType

createdByType

Kaynağı en son değiştiren kimliğin türü.

TcpSocket

TCPSocket, TCP bağlantı noktası içeren bir eylemi belirtir. TCP kancaları henüz desteklenmiyor.

Name Tür Description
host

string

İsteğe bağlı: Bağlanacak ana bilgisayar adı, varsayılan olarak pod IP'sini kullanır.

port

integer

Kapsayıcıda erişecek bağlantı noktasının numarası veya adı. Sayı 1 ile 65535 arasında olmalıdır. Ad bir IANA_SVC_NAME olmalıdır.

TriggerType

İşin tetikleyici türü

Name Tür Description
Event

string

Manual

string

Schedule

string

Type

Yoklama türü.

Name Tür Description
Liveness

string

Readiness

string

Startup

string

UserAssignedIdentity

Kullanıcı tarafından atanan kimlik özellikleri

Name Tür Description
clientId

string

Atanan kimliğin istemci kimliği.

principalId

string

Atanan kimliğin asıl kimliği.

Volume

Kapsayıcı Uygulaması için birim tanımları.

Name Tür Description
mountOptions

string

AzureFile'ın bağlaması sırasında kullanılan bağlama seçenekleri. Virgülle ayrılmış bir dize olmalıdır.

name

string

Birim adı.

secrets

SecretVolumeItem[]

Birime eklenecek gizli dizilerin listesi. Gizli dizi sağlanmazsa koleksiyondaki tüm gizli diziler birime eklenir.

storageName

string

Depolama kaynağının adı. EmptyDir ve Secret için sağlamanız gerekmez.

storageType

StorageType

Birimin depolama türü. Sağlanmadıysa EmptyDir kullanın.

VolumeMount

Kapsayıcı Uygulaması için birim bağlama.

Name Tür Description
mountPath

string

Birimin bağlanacağı kapsayıcının içindeki yol. ':' içermemelidir.

subPath

string

Kapsayıcının biriminin bağlanacağı birim içindeki yol. Varsayılan olarak "" (birimin kökü) kullanılır.

volumeName

string

Bu, Birimin Adı ile eşleşmelidir.