Tüm Ürünler
Search
Belge Merkezi

:DescribeContainerGroups

Son Güncelleme:Sep 30, 2026

Elastic Container Instance (ECI) konteyner grupları hakkındaki bilgileri toplu olarak sorgular.

Operation description

  • Bir ECI örneği çalışmayı durdurduktan sonra, temel alınan işlem kaynakları geri alınır. Örnekle birlikte oluşturulan diğer kaynaklar (EIP'ler gibi) varsayılan olarak örnekle birlikte serbest bırakılır.

  • İstenen bir durumda (Failed, Succeeded veya Expired) olan örneklerin üst verileri şu şekilde saklanır:
    • Son bir saat içindeki tüm örnek bilgileri saklanır.

    • Bir saatten daha eski örnekler için yalnızca en son 100 kayıt saklanır (her bölge için ayrı ayrı hesaplanır).

  • Sorguyu gerçekleştirmek için bir Resource Access Management (RAM) kullanıcısı veya RAM rolü kullanıyorsanız ve RAM kullanıcısı veya rolü bu işlem için gerekli izinlere sahip değilse, boş bir liste döndürülür.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

  • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

  • API: The API that you can call to perform the action.

  • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

  • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

    • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

    • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

  • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

  • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

eci:DescribeContainerGroups

get

ContainerGroup

acs:eci:{#regionId}:{#accountId}:containergroup/*

ContainerGroup

acs:eci:{#regionId}:{#accountId}:containergroup/{#containergroupId}

  • eci:tag
None

Request parameters

Parameter

Type

Required

Description

Example

RegionId

string

Yes

Örneğin bölge kimliği.

cn-hangzhou

RegionId

string

Yes

Örneğin bölgesi. Bu parametre boş bırakılırsa, sistem otomatik olarak bir bölge seçer.

Varsayılan değer: boş.

cn-hangzhou-h

ZoneId

string

No

Örneğin vSwitch kimliği.

vsw-bp1jrgfqqy54kg5hc****

VSwitchId

string

No

Sonraki sorgu için belirteç. NextToken değerinin boş olması, daha fazla sonuç bulunmadığını gösterir.

Not

İlk sorgu için bu parametreyi belirtmeniz gerekmez. Sonraki sorgular için belirteci önceki sorgunun yanıtından alın.

d78f2dd8-5979-42fe-****-b16db43be5bc

NextToken

string

No

Döndürülecek maksimum kaynak sayısı. Bu parametre belirtilmezse, varsayılan değer 20'dir. Maksimum değer 20'dir.

Not

Döndürülen sonuç sayısı belirtilen sayıdan az olabilir ancak asla bu sayıyı aşmaz.

20

Limit

integer

No

Örnek kimlikleri dizisi. En fazla 20 kimlik belirtebilirsiniz. Karakter dizesi JSON biçiminde olmalıdır.

["eci-bp17gw49eu09yiwm****", "eci-bp19aq49du01abcm****", "eci-2zegym1qhbmdfr1s****"]

ContainerGroupIds

string

No

Örnek adı, yani konteyner grubu adı.

test

ContainerGroupName

string

No

Örnek durumu. Geçerli değerler:

  • Pending: başlatılıyor.

  • Running: çalışıyor.

  • Succeeded: çalıştırma başarılı.

  • Failed: çalıştırma başarısız.

  • Scheduling: oluşturuluyor.

  • ScheduleFailed: oluşturma başarısız.

  • Restarting: yeniden başlatılıyor.

  • Updating: güncelleniyor.

  • Terminating: sonlandırılıyor.

  • Expired: süresi dolmuş.

Running

Status

string

No

Örneğin ait olduğu kaynak grubunun kimliği.

rg-aekzh43v*****

ResourceGroupId

string

No

Olay bilgilerinin döndürülüp döndürülmeyeceğini belirtir.

true

WithEvent

boolean

No

Örnek etiket bilgileri.

true

Tag

array<object>

No

İşlem kategorisi. Geçerli değerler:

  • economy: ekonomi.

  • general: genel amaçlı.

economy

object

No

The tags of the instances.

Key

string

No

The tag key of the instance.

name

Value

string

No

The tag value of the instance.

test

ComputeCategory

string

No

Örneğin ait olduğu güvenlik grubunun kimliği.

sg-uf66jeqopgqa9hdn****

SecurityGroupId

string

No

The ID of the security group to which the instance belongs.

sg-uf66jeqopgqa9hdn****

Response elements

Element

Type

Description

Example

object

TotalCount

integer

Örnek sayısı.

1

NextToken

string

Sonraki sorgu için belirteç.

d78f2dd8-5979-42fe-****-b16db43be5bc

RequestId

string

İstek kimliği.

89945DD3-9072-47D0-A318-353284CFC7B3

ContainerGroups

array<object>

Konteyner grubu bilgileri listesi.

array<object>

Konteyner grubu bilgileri listesi.

Status

string

Örnek durumu. Geçerli değerler:

  • Pending: başlatılıyor.

  • Running: çalışıyor.

  • Succeeded: çalıştırma başarılı oldu.

  • Failed: çalıştırma başarısız oldu.

  • Scheduling: oluşturuluyor.

  • ScheduleFailed: oluşturma başarısız oldu.

  • Restarting: yeniden başlatılıyor.

  • Updating: güncelleniyor.

  • Terminating: sonlandırılıyor.

  • Expired: süresi doldu.

Running

CreationTime

string

Sistemin isteği aldıktan sonra örneği oluşturduğu zaman. Zaman, UTC cinsinden RFC 3339 formatında görüntülenir.

2018-08-02T15:00:00Z

VpcId

string

Örneğin ait olduğu VPC'nin kimliği.

vpc-1vzjjflab6wvjox****

InternetIp

string

Genel IP adresi.

192.0.XX.XX

TenantSecurityGroupId

string

Bu parametre kullanıma sunulmamıştır.

sg-xxx

SecurityGroupId

string

Güvenlik grubu kimliği.

sg-bp12ujq5zpxuyjfo3o8r

HostAliases

array<object>

Örnekteki bir konteynerin ana bilgisayar adı eşlemeleri.

object

Örnekteki bir konteynerin ana bilgisayar adı eşlemeleri.

Hostnames

array

Ana bilgisayar bilgileri.

string

Ana bilgisayar adı.

['hehe.com', 'haha.com']

Ip

string

IP adresi.

192.0.XX.XX

Tags

array<object>

Örnek etiket bilgileri.

object

Örnek etiket bilgileri.

Key

string

Etiket anahtarı.

name

Value

string

Etiket değeri.

test-xh

Events

array<object>

Olay bilgileri. En fazla 50 olay döndürülür.

object

Olay bilgileri. En fazla 50 olay döndürülür.

Type

string

Olay türü. Geçerli değerler:

  • Normal

  • Warning

Normal

LastTimestamp

string

Olayın sona erdiği zaman.

2018-08-02T15:00:00Z

Message

string

Olay mesajı.

Started container

Name

string

Olayın ait olduğu nesnenin adı.

test-xxx

Reason

string

Olay adı.

Created

Count

integer

Olay sayısı.

20

FirstTimestamp

string

Olayın başladığı zaman.

2018-08-02T15:00:00Z

SucceededTime

string

Tüm konteynerlerin başarıyla çıkış yaptığı zaman. Zaman, UTC cinsinden RFC 3339 formatında görüntülenir.

2019-12-11T04:33:42Z

SpotStrategy

string

Örneğin teklif stratejisi. Geçerli değerler:

  • NoSpot (varsayılan): kullandıkça öde örneği.

  • SpotWithPriceLimit: maksimum saatlik fiyatı olan spot örnek.

  • SpotAsPriceGo: satın alma anındaki piyasa fiyatına göre faturalandırılan spot örnek.

NoSpot

SpotPriceLimit

number

Spot örneğin maksimum saatlik fiyatı.

Bu parametre yalnızca SpotStrategy, SpotWithPriceLimit olarak ayarlandığında döndürülür.

0.025

EphemeralStorage

integer

Geçici depolama alanının boyutu. Birim: GiB.

20

TenantEniInstanceId

string

Bu parametre kullanıma sunulmamıştır.

i-xxx

Discount

integer

İndirim.

9

RestartPolicy

string

Konteyner grubunun yeniden başlatma politikası. Geçerli değerler:

  • Never: asla yeniden başlatılmaz.

  • Always: her zaman yeniden başlatılır.

  • OnFailure: başarısızlık durumunda yeniden başlatılır.

Never

Memory

number

Örnek düzeyindeki bellek boyutu. Birim: GiB.

4.0

TenantVSwitchId

string

Bu parametre kullanıma sunulmamıştır.

vsw-xxx

Containers

array<object>

Örnekteki konteynerlerin listesi.

array<object>

Örnekteki konteynerlerin listesi.

LivenessProbe

object

Canlılık sondası.

SuccessThreshold

integer

Sondanın başarısız olduktan sonra başarılı sayılması için gereken minimum ardışık başarı sayısı. Varsayılan değer: 1. Mevcut değer 1 olmalıdır.

1

InitialDelaySeconds

integer

Konteyner başlatıldıktan sonra sondanın başlatılmasına kadar geçen saniye sayısı.

10

FailureThreshold

integer

Sondanın başarılı olduktan sonra başarısız sayılması için gereken minimum ardışık başarısızlık sayısı. Varsayılan değer: 3.

3

TimeoutSeconds

integer

Sondanın zaman aşımı süresi. Varsayılan değer: 1 saniye. Minimum değer: 1 saniye.

10

TcpSocket

object

TcpSocket.

Host

string

Ana bilgisayar adı.

1.2.3.4

Port

integer

Bağlantı noktası numarası.

80

Execs

array

Yürütülecek komutlar.

string

Yürütülecek komutlar.

["/bin/sh", "-c", "echo Hello world > /usr/share/message"]

HttpGet

object

HttpGet.

Scheme

string

HTTP veya HTTPS.

HTTP

Path

string

HTTP GET sondası için yol.

/usr/nginx/

Port

integer

HTTP GET sondası için bağlantı noktası.

80

PeriodSeconds

integer

Sondanın gerçekleştirilme aralığı. Varsayılan değer: 10 saniye. Minimum değer: 1 saniye.

5

Commands

array

Konteyner başlatma komutları.

string

Konteyner başlatma komutları.

[/bin/sh echo]

VolumeMounts

array<object>

Birim bağlama bilgileri.

object

Birim bağlama bilgileri.

MountPropagation

string

Birimin bağlama yayılımı ayarı. Bağlama yayılımı, bir konteyner tarafından bağlanan birimlerin aynı poddaki diğer konteynerlerle veya aynı düğümdeki diğer podlarla bile paylaşılmasına olanak tanır. Geçerli değerler:

  • None: birim bağlaması, bu birime veya alt dizinlerine yapılan sonraki bağlamaları almaz.

  • HostToCotainer: birim bağlaması, bu birime veya alt dizinlerine yapılan sonraki bağlamaları alır.

  • Bidirectional: HostToCotainer'a benzer şekilde, birim bağlaması bağlama işlemlerini algılayabilir. Ayrıca birim, ana bilgisayara ve aynı birimi kullanan tüm podların tüm konteynerlerine geri yayılır.

None

MountPath

string

Bağlama dizini. Konteynerdeki bağlama dizini altındaki içerik, birimin içeriği tarafından üzerine yazılır.

/usr/share/

ReadOnly

boolean

Bağlamanın salt okunur olup olmadığını gösterir.

false

Name

string

Birim adı.

test-empty

SubPath

string

Birimin alt dizini. Bu, örneğin aynı birimin farklı dizinlerini konteynerin farklı dizinlerine bağlamasına olanak tanır.

/usr/sub

Args

array

Konteyner başlatma bağımsız değişkenleri.

string

Konteyner başlatma bağımsız değişkenleri.

["hello"]

Image

string

Konteyner görüntüsü.

mysql

Ports

array<object>

Kullanıma sunulan bağlantı noktaları ve protokoller.

object

Kullanıma sunulan bağlantı noktaları ve protokoller.

Protocol

string

Protokol türü.

TCP

Port

integer

Bağlantı noktası numarası. Geçerli değerler: 1 ile 65535 arası.

8080

RestartCount

integer

Yeniden başlatma sayısı.

0

ImagePullPolicy

string

Görüntü çekme politikası. Geçerli değerler:

  • Always: görüntüyü her zaman çeker. Görüntü her seferinde çekilir.

  • IfNotPresent: görüntüyü isteğe bağlı olarak çeker. Öncelikle yerel görüntü kullanılır. Yerel görüntü yoksa görüntü çekilir.

  • Never: görüntüyü asla çekmez. Yalnızca yerel görüntü kullanılır.

Always

StdinOnce

boolean

stdin true olarak ayarlandığında, stdin akışı birden fazla bağlanma oturumu boyunca açık kalır. StdinOnce true olarak ayarlanırsa, konteyner başlatıldığında stdin açılır, ilk istemci stdin'e bağlanana kadar boş kalır ve ardından istemci bağlantısı kesilene kadar açık kalır ve veri kabul eder. Bu noktada stdin kapatma durumundadır ve konteyner yeniden başlatılana kadar kapatma durumunda kalır. Bu, StdinOnce özelliğinin etkinleştirilme durumunu açıklar.

true

Cpu

number

Konteynerin vCPU sayısı.

2.0

PreviousState

object

Önceki durum.

StartTime

string

Konteynerin çalışmaya başladığı zaman.

2021-12-02T15:00:00Z

FinishTime

string

Konteynerin çalışmayı durdurduğu zaman.

2021-12-02T15:01:00Z

DetailStatus

string

Durum ayrıntıları.

working

State

string

Konteyner durumu. Geçerli değerler:

  • Waiting: başlatılıyor.

  • Running: çalışıyor.

  • Terminated: sonlandırıldı.

Terminated

Message

string

Konteyner durum mesajı.

Back-off 5m0s restarting failed container=test pod=test_eci-xxx(xxx)

Signal

integer

Konteyner durum sinyali.

1

ExitCode

integer

Konteynerin çıkış kodu.

0

Reason

string

Konteynerin bu durumda olmasının nedeni.

Completed

Tty

boolean

Etkileşimin etkinleştirilip etkinleştirilmediğini gösterir. Varsayılan değer: false. Örneğin, Command /bin/bash olarak ayarlanmışsa, bu parametreyi true olarak ayarlayın.

false

WorkingDir

string

Çalışma dizini.

/usr/local/nginx

CurrentState

object

Konteynerin mevcut durumu.

StartTime

string

Konteynerin çalışmaya başladığı zaman.

2021-12-02T15:00:00Z

FinishTime

string

Konteynerin çalışmayı durdurduğu zaman.

2021-12-02T15:01:00Z

DetailStatus

string

Konteyner durumunun ayrıntıları.

working

State

string

Konteynerin durumu. Geçerli değerler:

  • Waiting

  • Running

  • Terminated

Terminated

Message

string

Konteyner durum mesajı.

Back-off 5m0s restarting failed container=test pod=test_eci-xxx(xxx)

Signal

integer

Konteyner durum sinyali.

1

ExitCode

integer

Konteynerin çıkış kodu.

0

Reason

string

Konteynerin bu durumda olmasının nedeni.

Started

Ready

boolean

Konteynerin hazırlık probunu geçip geçmediğini gösterir.

true

Gpu

integer

GPU sayısı.

1

SecurityContext

object

Örneğin güvenlik bağlamı.

ReadOnlyRootFilesystem

boolean

Kök dosya sisteminin salt okunur olup olmadığını gösterir. Şu anda yalnızca True desteklenmektedir.

true

RunAsUser

integer

Konteyneri çalıştırmak için kullanılan kullanıcı kimliği.

1000

Capability

object

Konteynerdeki işlemlere verilen belirli izinler.

Adds

array

Konteynerdeki işlemlere verilen belirli izinler.

string

Konteynerdeki işlemlere verilen belirli izinler.

[NET_ADMIN]

Memory

number

Konteynerin bellek boyutu. Birim: GiB.

2.0

Stdin

boolean

Bu konteynerin konteyner çalışma zamanında standart giriş için bir arabellek ayırıp ayırmadığını gösterir. Bu parametre ayarlanmazsa, konteynerdeki standart girişten yapılan okumalar EOF ile sonuçlanır. Varsayılan değer: false.

true

Name

string

Konteyner adı.

nginx

EnvironmentVars

array<object>

Ortam değişkenleri.

array<object>

Ortam değişkenleri.

Key

string

Ortam değişkeninin adı.

PATH

Value

string

Ortam değişkeninin değeri.

/usr/bin/

ValueFrom

object

Ortam değişkeni değerinin kaynağı. Değer boş değilse bu parametre kullanılamaz.

FieldRef

object

Belirtilen alan.

FieldPath

string

Alanın yolu.

status.podIP

ReadinessProbe

object

Konteynerin istekleri sunmaya hazır olup olmadığını kontrol etmek için kullanılan hazırlık probu.

SuccessThreshold

integer

Sondanın başarısız olduktan sonra başarılı sayılması için gereken minimum ardışık başarı sayısı. Varsayılan değer: 1. Mevcut değer 1 olmalıdır.

1

InitialDelaySeconds

integer

Konteyner başlatıldıktan sonra sondanın başlatılmasına kadar geçen saniye sayısı.

5

FailureThreshold

integer

Sondanın başarılı olduktan sonra başarısız sayılması için gereken minimum ardışık başarısızlık sayısı. Varsayılan değer: 3.

3

TimeoutSeconds

integer

Sondanın zaman aşımı süresi. Varsayılan değer: 1 saniye. Minimum değer: 1 saniye.

1

TcpSocket

object

Sağlık kontrolleri için TCP soket yöntemi.

Host

string

Ana bilgisayar.

1.2.3.4

Port

integer

Bağlantı noktası numarası.

8888

Execs

array

Sağlık kontrolleri için komut satırı yöntemi kullanıldığında konteynerde yürütülen komutlar.

string

Sağlık kontrolleri için komut satırı yöntemi kullanıldığında konteynerde yürütülen komutlar.

["/bin/sh", "-c", "echo Hello world > /usr/share/message"]

HttpGet

object

Sağlık kontrolleri için HTTP istek yöntemi.

Scheme

string

HTTP/HTTPS.

HTTP

Path

string

HTTP GET sondası için yol.

/usr/local

Port

integer

HTTP GET sağlık kontrolü için bağlantı noktası numarası.

8080

PeriodSeconds

integer

Sondanın gerçekleştirilme aralığı. Varsayılan değer: 10 saniye. Minimum değer: 1 saniye.

1

EniInstanceId

string

Esnek ağ arabirimi denetleyicisinin (NIC) kimliği.

eni-bp14rzqi6fd8satm****

InitContainers

array<object>

Başlatma konteynerleri.

array<object>

Başlatma konteynerleri.

VolumeMounts

array<object>

Başlatma konteynerine bağlanan birimler.

object

Başlatma konteynerine bağlanan birimler.

MountPropagation

string

Birimin bağlama yayılımı ayarı. Bağlama yayılımı, bir konteyner tarafından bağlanan birimlerin aynı poddaki diğer konteynerlerle veya aynı düğümdeki diğer podlarla bile paylaşılmasına olanak tanır. Geçerli değerler:

  • None: birim bağlaması, bu birime veya alt dizinlerine yapılan sonraki bağlamaları almaz.

  • HostToCotainer: birim bağlaması, bu birime veya alt dizinlerine yapılan sonraki bağlamaları alır.

  • Bidirectional: HostToCotainer'a benzer şekilde, birim bağlaması bağlama işlemlerini algılayabilir. Ayrıca birim, ana bilgisayara ve aynı birimi kullanan tüm podların tüm konteynerlerine geri yayılır.

None

MountPath

string

Bağlama dizini. Konteynerdeki bağlama dizini altındaki içerik, birimin içeriği tarafından üzerine yazılır.

/usr/share/

ReadOnly

boolean

Bağlamanın salt okunur olup olmadığını gösterir.

false

Name

string

Birim adı, Volume içindeki Name değeriyle aynıdır.

test-empty

Args

array

Başlangıç bağımsız değişkenleri.

string

Başlangıç bağımsız değişkenleri.

['hello world']

Image

string

Görüntü.

nginx

Ports

array<object>

Kullanıma sunulan bağlantı noktaları ve protokoller.

object

Kullanıma sunulan bağlantı noktaları ve protokoller.

Protocol

string

Protokol türü.

TCP

Port

integer

Bağlantı noktası numarası. Geçerli değerler: 1 ile 65535 arası.

8888

RestartCount

integer

Yeniden başlatma sayısı.

5

ImagePullPolicy

string

Görüntü çekme politikası. Geçerli değerler:

  • Always: görüntüyü her zaman çeker. Görüntü her seferinde çekilir.

  • IfNotPresent: görüntüyü isteğe bağlı olarak çeker. Öncelikle yerel görüntü kullanılır. Yerel görüntü yoksa görüntü çekilir.

  • Never: görüntüyü asla çekmez. Yalnızca yerel görüntü kullanılır.

Always

PreviousState

object

Önceki durum.

StartTime

string

Konteynerin çalışmaya başladığı zaman.

2021-12-02T15:00:00Z

FinishTime

string

Konteynerin çalışmayı durdurduğu zaman.

2021-12-02T15:01:00Z

DetailStatus

string

Durum ayrıntıları.

working

State

string

Konteynerin durumu. Geçerli değerler: Waiting, Running ve Terminated.

Terminated

Message

string

Konteyner durum mesajı.

Started container

Signal

integer

Konteyner durum sinyali.

1

ExitCode

integer

Konteynerin çıkış kodu.

0

Reason

string

Konteynerin bu durumda olmasının nedeni.

completed

WorkingDir

string

Çalışma dizini.

/usr/test

Cpu

number

vCPU sayısı.

1.0

CurrentState

object

Mevcut durum.

StartTime

string

Konteynerin çalışmaya başladığı zaman.

2021-12-02T15:00:00Z

FinishTime

string

Konteynerin çalışmayı durdurduğu zaman.

2021-12-02T15:01:00Z

DetailStatus

string

Durum ayrıntıları.

working

State

string

Konteynerin durumu. Geçerli değerler:

  • Waiting

  • Running

  • Terminated

Running

Message

string

Olay mesajı.

Created container

Signal

integer

Konteyner durum sinyali.

1

ExitCode

integer

Konteynerin çıkış kodu.

0

Reason

string

Konteynerin bu durumda olmasının nedeni.

Started

Command

array

Başlangıç komutu.

string

Başlangıç komutu.

[/bin/sh echo]

Ready

boolean

Konteynerin hazırlık probunu geçip geçmediğini gösterir.

true

Gpu

integer

GPU sayısı.

1

SecurityContext

object

Konteynerin güvenlik bağlamı.

ReadOnlyRootFilesystem

boolean

Kök dosya sisteminin salt okunur olup olmadığını gösterir. Şu anda yalnızca True desteklenmektedir.

true

RunAsUser

integer

Konteyner işleminin giriş noktasını çalıştırmak için kullanılan UID.

1557

Capability

object

Konteynerdeki işlemlere verilen belirli izinler.

Adds

array

Konteynerdeki işlemlere verilen belirli izinler.

string

Konteynerdeki işlemlere verilen belirli izinler.

NET_ADMIN

Memory

number

Başlatma konteynerinin bellek boyutu. Birim: GiB.

2.0

Name

string

Konteyner adı.

Init-xxx

EnvironmentVars

array<object>

Ortam değişkenleri.

array<object>

Ortam değişkenleri.

Key

string

Ortam değişkeninin adı.

PATH

Value

string

Ortam değişkeninin değeri.

/usr/local/bin

ValueFrom

object

Ortam değişkeni değerinin kaynağı. Değer boş değilse bu parametre kullanılamaz.

FieldRef

object

Belirtilen alan.

FieldPath

string

Belirtilen sürümde seçilecek alanın yolu. Şu anda yalnızca status.podIP desteklenmektedir.

status.podIP

ContainerGroupId

string

Örnek kimliği.

eci-bp1jrgfqqy54kg5hc****

TenantEniIp

string

Bu parametre kullanıma sunulmamıştır.

10.10.XX.XX

InstanceType

string

Belirtilen ECS örnek türü.

ecs.g5.large

IntranetIp

string

Dahili IP adresi.

172.16.XX.XX

Ipv6Address

string

IPv6 adresi.

2001:XXXX:4:4:4:4:4:4

RegionId

string

Örneğin bölge kimliği.

cn-hangzhou

DnsConfig

object

DNS yapılandırması.

Searches

array

DNS arama etki alanlarının listesi.

string

DNS arama etki alanı.

svc.local.kubenetes

Options

array<object>

Nesne seçeneklerinin listesi. Her nesne bir ad ve isteğe bağlı bir değerden oluşur.

object

Nesne seçeneklerinin listesi. Her nesne bir ad ve isteğe bağlı bir değerden oluşur.

Value

string

Nesnenin değişken değeri.

value

Name

string

Nesnenin değişken adı.

name

NameServers

array

DNS sunucularının IP adreslerinin listesi.

string

IP adresi.

[10.2.*.*]

Volumes

array<object>

Birim bilgileri.

array<object>

Birim bilgileri.

Type

string

Birim türü. Geçerli değerler:

  • EmptyDirVolume

  • NFSVolume

  • ConfigFileVolume

  • FlexVolume

EmptyDirVolume

DiskVolumeDiskId

string

DiskVolume kimliği.

d-xxxx

NFSVolumeReadOnly

boolean

Bağlamanın salt okunur olup olmadığını gösterir.

false

ConfigFileVolumeConfigFileToPaths

array<object>

Yapılandırma dosyası yollarının listesi.

object

Yapılandırma dosyası yollarının listesi.

Path

string

Göreli dosya yolu.

/usr/bin/

Content

string

Yapılandırma dosyasının içeriği (32 KB).

hello world

FlexVolumeFsType

string

Bağlı dosya sisteminin türü. Varsayılan değer, FlexVolume betiğine bağlıdır.

ntfs

FlexVolumeDriver

string

FlexVolume için kullanılan sürücü adı.

flexvolume

DiskVolumeFsType

string

Birim türü.

xfs

FlexVolumeOptions

string

FlexVolume nesne seçeneklerinin listesi.

[nolock,tcp,noresvport]

NFSVolumeServer

string

NFS sunucusu adresi.

0eafxxxxx-xxxxx.cn-hangzhou.nas.aliyuncs.com

NFSVolumePath

string

NFS birim yolu.

/eci

Name

string

Birim adı.

test-empty

EmptyDirVolumeMedium

string

EmptyDir biriminin depolama ortamı. Varsayılan olarak bu parametre boştur ve bu durum düğüm dosya sisteminin kullanıldığını gösterir. Geçerli değerler:

  • Memory: Bellek kullanır.

  • LocalRaid0: Yerel diskleri RAID 0 olarak birleştirir. Bu değer yalnızca yerel disk örneğinin oluşturulduğu ve yerel disklerin bağlandığı senaryolar için geçerlidir. Daha fazla bilgi için Yerel disk örneği oluşturma konusuna bakın.

Memory

EmptyDirVolumeSizeLimit

string

EmptyDir biriminin boyutu.

256Mi

RamRoleName

string

Örnek RAM rolünün adı. Elastic Container Instance ve ECS, örnek RAM rolünü paylaşır. Daha fazla bilgi için API işlemlerini çağırarak örnek RAM rolü kullanma konusuna bakın.

ram:PassRole

VSwitchId

string

vSwitch kimliği.

vsw-bp1vzjjflab6wvjox****

Cpu

number

Örnek düzeyindeki vCPU sayısı.

2.0

ExpiredTime

string

Ödeme gecikmesi nedeniyle örneğin başarısız olduğu zaman. Saat UTC zaman diliminde ve RFC 3339 biçimindedir.

2018-08-02T15:00:00Z

ResourceGroupId

string

Kaynak grubu kimliği.

rg-8db03793gfrz****

ZoneId

string

Örneğin bulunduğu bölge.

cn-hangzhou-h

ContainerGroupName

string

Örnek adı.

test

EciSecurityContext

object

Konteyner grubunun güvenlik bağlamı.

Sysctls

array<object>

sysctl parametreleri.

object

sysctl parametreleri.

Value

string

sysctl parametresinin değeri.

65536

Name

string

sysctl parametresinin adı.

kernel.msgmax

FailedTime

string

Örneğin başarısız olduğu zaman. Saat UTC zaman diliminde ve RFC 3339 biçimindedir.

2018-08-02T15:00:00Z

ComputeCategory

string

İşlem kategorisi. Geçerli değerler:

  • economy: ekonomik

  • general: genel amaçlı

economy

DnsPolicy

string

DNS ilkesi. Geçerli değerler:

  • None: DnsConfig alanında yapılandırılan DNS'yi kullanır.

  • Default: DNS ayarlarını çalışma zamanı ortamından devralır.

None

Examples

Success response

JSON format

{
  "TotalCount": 1,
  "NextToken": "d78f2dd8-5979-42fe-****-b16db43be5bc",
  "RequestId": "89945DD3-9072-47D0-A318-353284CFC7B3",
  "ContainerGroups": [
    {
      "Status": "Running",
      "CreationTime": "2018-08-02T15:00:00Z",
      "VpcId": "vpc-1vzjjflab6wvjox****",
      "InternetIp": "192.0.XX.XX",
      "TenantSecurityGroupId": "sg-xxx",
      "SecurityGroupId": "sg-bp12ujq5zpxuyjfo3o8r",
      "HostAliases": [
        {
          "Hostnames": [
            "['hehe.com', 'haha.com']"
          ],
          "Ip": "192.0.XX.XX"
        }
      ],
      "Tags": [
        {
          "Key": "name",
          "Value": "test-xh"
        }
      ],
      "Events": [
        {
          "Type": "Normal",
          "LastTimestamp": "2018-08-02T15:00:00Z",
          "Message": "Started container",
          "Name": "test-xxx",
          "Reason": "Created",
          "Count": 20,
          "FirstTimestamp": "2018-08-02T15:00:00Z"
        }
      ],
      "SucceededTime": "2019-12-11T04:33:42Z",
      "SpotStrategy": "NoSpot",
      "SpotPriceLimit": 0.025,
      "EphemeralStorage": 20,
      "TenantEniInstanceId": "i-xxx",
      "Discount": 9,
      "RestartPolicy": "Never",
      "Memory": 4,
      "TenantVSwitchId": "vsw-xxx",
      "Containers": [
        {
          "LivenessProbe": {
            "SuccessThreshold": 1,
            "InitialDelaySeconds": 10,
            "FailureThreshold": 3,
            "TimeoutSeconds": 10,
            "TcpSocket": {
              "Host": "1.2.3.4",
              "Port": 80
            },
            "Execs": [
              "[\"/bin/sh\", \"-c\", \"echo Hello world > /usr/share/message\"]"
            ],
            "HttpGet": {
              "Scheme": "HTTP",
              "Path": "/usr/nginx/",
              "Port": 80
            },
            "PeriodSeconds": 5
          },
          "Commands": [
            "[/bin/sh echo]"
          ],
          "VolumeMounts": [
            {
              "MountPropagation": "None",
              "MountPath": "/usr/share/",
              "ReadOnly": false,
              "Name": "test-empty",
              "SubPath": "/usr/sub"
            }
          ],
          "Args": [
            "[\"hello\"]"
          ],
          "Image": "mysql",
          "Ports": [
            {
              "Protocol": "TCP",
              "Port": 8080
            }
          ],
          "RestartCount": 0,
          "ImagePullPolicy": "Always",
          "StdinOnce": true,
          "Cpu": 2,
          "PreviousState": {
            "StartTime": "2021-12-02T15:00:00Z",
            "FinishTime": "2021-12-02T15:01:00Z",
            "DetailStatus": "working",
            "State": "Terminated",
            "Message": "Back-off 5m0s restarting failed container=test pod=test_eci-xxx(xxx)",
            "Signal": 1,
            "ExitCode": 0,
            "Reason": "Completed"
          },
          "Tty": false,
          "WorkingDir": "/usr/local/nginx",
          "CurrentState": {
            "StartTime": "2021-12-02T15:00:00Z",
            "FinishTime": "2021-12-02T15:01:00Z",
            "DetailStatus": "working",
            "State": "Terminated",
            "Message": "Back-off 5m0s restarting failed container=test pod=test_eci-xxx(xxx)",
            "Signal": 1,
            "ExitCode": 0,
            "Reason": "Started"
          },
          "Ready": true,
          "Gpu": 1,
          "SecurityContext": {
            "ReadOnlyRootFilesystem": true,
            "RunAsUser": 1000,
            "Capability": {
              "Adds": [
                "[NET_ADMIN]"
              ]
            }
          },
          "Memory": 2,
          "Stdin": true,
          "Name": "nginx",
          "EnvironmentVars": [
            {
              "Key": "PATH",
              "Value": "/usr/bin/",
              "ValueFrom": {
                "FieldRef": {
                  "FieldPath": "status.podIP"
                }
              }
            }
          ],
          "ReadinessProbe": {
            "SuccessThreshold": 1,
            "InitialDelaySeconds": 5,
            "FailureThreshold": 3,
            "TimeoutSeconds": 1,
            "TcpSocket": {
              "Host": "1.2.3.4",
              "Port": 8888
            },
            "Execs": [
              "[\"/bin/sh\", \"-c\", \"echo Hello world > /usr/share/message\"]"
            ],
            "HttpGet": {
              "Scheme": "HTTP",
              "Path": "/usr/local",
              "Port": 8080
            },
            "PeriodSeconds": 1
          }
        }
      ],
      "EniInstanceId": "eni-bp14rzqi6fd8satm****",
      "InitContainers": [
        {
          "VolumeMounts": [
            {
              "MountPropagation": "None",
              "MountPath": "/usr/share/",
              "ReadOnly": false,
              "Name": "test-empty"
            }
          ],
          "Args": [
            "['hello world']"
          ],
          "Image": "nginx",
          "Ports": [
            {
              "Protocol": "TCP",
              "Port": 8888
            }
          ],
          "RestartCount": 5,
          "ImagePullPolicy": "Always",
          "PreviousState": {
            "StartTime": "2021-12-02T15:00:00Z",
            "FinishTime": "2021-12-02T15:01:00Z",
            "DetailStatus": "working",
            "State": "Terminated",
            "Message": "Started container",
            "Signal": 1,
            "ExitCode": 0,
            "Reason": "completed"
          },
          "WorkingDir": "/usr/test",
          "Cpu": 1,
          "CurrentState": {
            "StartTime": "2021-12-02T15:00:00Z",
            "FinishTime": "2021-12-02T15:01:00Z",
            "DetailStatus": "working",
            "State": "Running",
            "Message": "Created container",
            "Signal": 1,
            "ExitCode": 0,
            "Reason": "Started"
          },
          "Command": [
            "[/bin/sh echo]"
          ],
          "Ready": true,
          "Gpu": 1,
          "SecurityContext": {
            "ReadOnlyRootFilesystem": true,
            "RunAsUser": 1557,
            "Capability": {
              "Adds": [
                "NET_ADMIN"
              ]
            }
          },
          "Memory": 2,
          "Name": "Init-xxx",
          "EnvironmentVars": [
            {
              "Key": "PATH",
              "Value": "/usr/local/bin",
              "ValueFrom": {
                "FieldRef": {
                  "FieldPath": "status.podIP"
                }
              }
            }
          ]
        }
      ],
      "ContainerGroupId": "eci-bp1jrgfqqy54kg5hc****",
      "TenantEniIp": "10.10.XX.XX",
      "InstanceType": "ecs.g5.large",
      "IntranetIp": "172.16.XX.XX",
      "Ipv6Address": "2001:XXXX:4:4:4:4:4:4",
      "RegionId": "cn-hangzhou",
      "DnsConfig": {
        "Searches": [
          "svc.local.kubenetes"
        ],
        "Options": [
          {
            "Value": "value",
            "Name": "name"
          }
        ],
        "NameServers": [
          "[10.2.*.*]"
        ]
      },
      "Volumes": [
        {
          "Type": "EmptyDirVolume",
          "DiskVolumeDiskId": "d-xxxx",
          "NFSVolumeReadOnly": false,
          "ConfigFileVolumeConfigFileToPaths": [
            {
              "Path": "/usr/bin/",
              "Content": "hello world"
            }
          ],
          "FlexVolumeFsType": "ntfs",
          "FlexVolumeDriver": "flexvolume",
          "DiskVolumeFsType": "xfs",
          "FlexVolumeOptions": "[nolock,tcp,noresvport]",
          "NFSVolumeServer": "0eafxxxxx-xxxxx.cn-hangzhou.nas.aliyuncs.com",
          "NFSVolumePath": "/eci",
          "Name": "test-empty",
          "EmptyDirVolumeMedium": "Memory",
          "EmptyDirVolumeSizeLimit": "256Mi"
        }
      ],
      "RamRoleName": "ram:PassRole",
      "VSwitchId": "vsw-bp1vzjjflab6wvjox****",
      "Cpu": 2,
      "ExpiredTime": "2018-08-02T15:00:00Z",
      "ResourceGroupId": "rg-8db03793gfrz****",
      "ZoneId": "cn-hangzhou-h",
      "ContainerGroupName": "test",
      "EciSecurityContext": {
        "Sysctls": [
          {
            "Value": "65536",
            "Name": "kernel.msgmax"
          }
        ]
      },
      "FailedTime": "2018-08-02T15:00:00Z",
      "ComputeCategory": "economy",
      "DnsPolicy": "None"
    }
  ]
}

Error codes

HTTP status code

Error code

Error message

Description

400 InvalidParameter.MismatchInstanceType The instanceId mismatch instance type.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.