DescribeContainerGroups - Elastic Container Instance: Central de Documentação do Alibaba Cloud

Consulta informações sobre instâncias do Elastic Container Instance (ECI) em lotes.

Descrição da operação

Após uma instância ECI parar de ser executada, os recursos de computação subjacentes são revogados. Outros recursos criados juntamente com a instância (como EIPs) são liberados junto com a instância por padrão.
Os metadados das instâncias em um estado desejado (Failed, Succeeded ou Expired) são retidos da seguinte forma:
- Todas as informações da instância dentro da última hora são retidas.
- Para instâncias com mais de uma hora, apenas os 100 registros mais recentes são retidos (calculados separadamente para cada região).
Se você usar um usuário do Resource Access Management (RAM) ou uma função RAM para realizar a consulta, uma lista vazia será retornada quando o usuário ou a função RAM não tiver as permissões necessárias para esta operação.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

eci:DescribeContainerGroups

get

ContainerGroup

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

ContainerGroup

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

eci:tag

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região da instância.	cn-hangzhou
RegionId	string	Sim	A zona da instância. Se este parâmetro for deixado vazio, o sistema seleciona automaticamente uma zona. Valor padrão: vazio.	cn-hangzhou-h
ZoneId	string	Não	O ID do vSwitch da instância.	vsw-bp1jrgfqqy54kg5hc****
VSwitchId	string	Não	O token para a próxima consulta. Um valor vazio de NextToken indica que não existem mais resultados. Nota Você não precisa especificar este parâmetro na primeira consulta. Para consultas subsequentes, obtenha o token da resposta da consulta anterior.	d78f2dd8-5979-42fe-****-b16db43be5bc
NextToken	string	Não	O número máximo de recursos a serem retornados. Se este parâmetro não for especificado, o valor padrão é 20. O valor máximo é 20. Nota O número de resultados retornados pode ser menor que o número especificado, mas nunca o excede.	20
Limit	integer	Não	A sequência de IDs de instâncias. Você pode especificar até 20 IDs. A string de caracteres deve estar no formato JSON.	["eci-bp17gw49eu09yiwm**", "eci-bp19aq49du01abcm", "eci-2zegym1qhbmdfr1s**"]
ContainerGroupIds	string	Não	O nome da instância, que é o nome do grupo de contêineres.	test
ContainerGroupName	string	Não	O status da instância. Valores válidos: Pending: iniciando. Running: em execução. Succeeded: execução bem-sucedida. Failed: falha na execução. Scheduling: sendo criada. ScheduleFailed: falha na criação. Restarting: reiniciando. Updating: sendo atualizada. Terminating: sendo encerrada. Expired: expirada.	Running
Status	string	Não	O ID do grupo de recursos ao qual a instância pertence.	rg-aekzh43v*****
ResourceGroupId	string	Não	Especifica se as informações de eventos devem ser retornadas.	true
WithEvent	boolean	Não	As informações de tag da instância.	true
Tag	array<object>	Não	A categoria de computação. Valores válidos: economy: econômica. general: uso geral.	economy
	object	Não	As tags das instâncias.
Key	string	Não	A chave da tag da instância.	name
Value	string	Não	O valor da tag da instância.	test
ComputeCategory	string	Não	O ID do grupo de segurança ao qual a instância pertence.	sg-uf66jeqopgqa9hdn****
SecurityGroupId	string	Não	O ID do grupo de segurança ao qual a instância pertence.	sg-uf66jeqopgqa9hdn****

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
TotalCount	integer	O número de instâncias.	1
NextToken	string	O token para a próxima consulta.	d78f2dd8-5979-42fe-****-b16db43be5bc
RequestId	string	O ID da solicitação.	89945DD3-9072-47D0-A318-353284CFC7B3
ContainerGroups	array<object>	A lista de informações do grupo de contêineres.
	array<object>	A lista de informações do grupo de contêineres.
Status	string	O status da instância. Valores válidos: Pending: iniciando. Running: em execução. Succeeded: execução bem-sucedida. Failed: falha na execução. Scheduling: sendo criada. ScheduleFailed: falha na criação. Restarting: reiniciando. Updating: atualizando. Terminating: terminando. Expired: expirada.	Running
CreationTime	string	A hora em que o sistema criou a instância após receber a solicitação. A hora é exibida em UTC no formato RFC 3339.	2018-08-02T15:00:00Z
VpcId	string	O ID da VPC à qual a instância pertence.	vpc-1vzjjflab6wvjox****
InternetIp	string	O endereço IP público.	192.0.XX.XX
TenantSecurityGroupId	string	Este parâmetro não está disponível para uso.	sg-xxx
SecurityGroupId	string	O ID do grupo de segurança.	sg-bp12ujq5zpxuyjfo3o8r
HostAliases	array<object>	Os mapeamentos de nome de host de um contêiner na instância.
	object	Os mapeamentos de nome de host de um contêiner na instância.
Hostnames	array	As informações do host.
	string	O nome do host.	['hehe.com', 'haha.com']
Ip	string	O endereço IP.	192.0.XX.XX
Tags	array<object>	As informações de tag da instância.
	object	As informações de tag da instância.
Key	string	A chave da tag.	name
Value	string	O valor da tag.	test-xh
Events	array<object>	As informações do evento. Um máximo de 50 eventos são retornados.
	object	As informações do evento. Um máximo de 50 eventos são retornados.
Type	string	O tipo de evento. Valores válidos: Normal Warning	Normal
LastTimestamp	string	A hora em que o evento terminou.	2018-08-02T15:00:00Z
Message	string	A mensagem do evento.	Started container
Name	string	O nome do objeto ao qual o evento pertence.	test-xxx
Reason	string	O nome do evento.	Created
Count	integer	O número de eventos.	20
FirstTimestamp	string	A hora em que o evento começou.	2018-08-02T15:00:00Z
SucceededTime	string	A hora em que todos os contêineres foram encerrados com êxito. A hora é exibida em UTC no formato RFC 3339.	2019-12-11T04:33:42Z
SpotStrategy	string	A estratégia de lance da instância. Valores válidos: NoSpot (padrão): uma instância pay-as-you-go. SpotWithPriceLimit: uma instância spot com um preço horário máximo. SpotAsPriceGo: uma instância spot que é cobrada com base no preço de mercado no momento da compra.	NoSpot
SpotPriceLimit	number	O preço horário máximo da instância spot. Este parâmetro é retornado apenas quando SpotStrategy está definido como SpotWithPriceLimit.	0.025
EphemeralStorage	integer	O tamanho do espaço de armazenamento temporário. Unidade: GiB.	20
TenantEniInstanceId	string	Este parâmetro não está disponível para uso.	i-xxx
Discount	integer	O desconto.	9
RestartPolicy	string	A política de reinicialização do grupo de contêineres. Valores válidos: Never: nunca reinicia. Always: sempre reinicia. OnFailure: reinicia em caso de falha.	Never
Memory	number	O tamanho da memória no nível da instância. Unidade: GiB.	4.0
TenantVSwitchId	string	Este parâmetro não está disponível para uso.	vsw-xxx
Containers	array<object>	A lista de contêineres na instância.
	array<object>	A lista de contêineres na instância.
LivenessProbe	object	A sonda de atividade.
SuccessThreshold	integer	O número mínimo de sucessos consecutivos para que a sonda seja considerada bem-sucedida após ter falhado. Valor padrão: 1. O valor atual deve ser 1.	1
InitialDelaySeconds	integer	O número de segundos após o início do contêiner antes que a sonda seja iniciada.	10
FailureThreshold	integer	O número mínimo de falhas consecutivas para que a sonda seja considerada como falha após ter sido bem-sucedida. Valor padrão: 3.	3
TimeoutSeconds	integer	O período de tempo limite da sonda. Valor padrão: 1 segundo. Valor mínimo: 1 segundo.	10
TcpSocket	object	TcpSocket.
Host	string	O nome do host.	1.2.3.4
Port	integer	O número da porta.	80
Execs	array	Os comandos a serem executados.
	string	Os comandos a serem executados.	["/bin/sh", "-c", "echo Hello world > /usr/share/message"]
HttpGet	object	HttpGet.
Scheme	string	HTTP ou HTTPS.	HTTP
Path	string	O caminho para a sonda HTTP GET.	/usr/nginx/
Port	integer	A porta para a sonda HTTP GET.	80
PeriodSeconds	integer	O intervalo no qual a sonda é executada. Valor padrão: 10 segundos. Valor mínimo: 1 segundo.	5
Commands	array	Os comandos de inicialização do contêiner.
	string	Os comandos de inicialização do contêiner.	[/bin/sh echo]
VolumeMounts	array<object>	As informações de montagem do volume.
	object	As informações de montagem do volume.
MountPropagation	string	A configuração de propagação de montagem do volume. A propagação de montagem permite que volumes montados por um contêiner sejam compartilhados com outros contêineres no mesmo pod ou até mesmo com outros pods no mesmo nó. Valores válidos: None: a montagem do volume não recebe montagens subsequentes que são montadas neste volume ou em seus subdiretórios. HostToCotainer: a montagem do volume recebe montagens subsequentes que são montadas neste volume ou em seus subdiretórios. Bidirectional: semelhante a HostToCotainer, a montagem do volume pode detectar operações de montagem. Além disso, o volume é propagado de volta para o host e todos os contêineres de todos os pods que usam o mesmo volume.	None
MountPath	string	O diretório de montagem. O conteúdo sob o diretório de montagem no contêiner é substituído pelo conteúdo do volume.	/usr/share/
ReadOnly	boolean	Indica se a montagem é somente leitura.	false
Name	string	O nome do volume.	test-empty
SubPath	string	O subdiretório do volume. Isso permite que a instância monte diferentes diretórios do mesmo volume em diferentes diretórios do contêiner.	/usr/sub
Args	array	Os argumentos de inicialização do contêiner.
	string	Os argumentos de inicialização do contêiner.	["hello"]
Image	string	A imagem do contêiner.	mysql
Ports	array<object>	As portas e protocolos expostos.
	object	As portas e protocolos expostos.
Protocol	string	O tipo de protocolo.	TCP
Port	integer	O número da porta. Valores válidos: 1 a 65535.	8080
RestartCount	integer	O número de reinicializações.	0
ImagePullPolicy	string	A política de pull da imagem. Valores válidos: Always: sempre faz o pull da imagem. A imagem é baixada todas as vezes. IfNotPresent: faz o pull da imagem sob demanda. A imagem local é usada preferencialmente. Se nenhuma imagem local estiver disponível, a imagem é baixada. Never: nunca faz o pull da imagem. Apenas a imagem local é usada.	Always
StdinOnce	boolean	Quando stdin é definido como true, o fluxo stdin permanece aberto em várias sessões de anexação. Se StdinOnce for definido como true, o stdin será aberto quando o contêiner iniciar, permanecerá vazio até que o primeiro cliente se anexe ao stdin e, em seguida, permanecerá aberto e aceitará dados até que o cliente se desconecte. Nesse ponto, o stdin entra no estado de desligamento e permanece nesse estado até que o contêiner seja reiniciado. Isso descreve o status de ativação do recurso StdinOnce.	true
Cpu	number	O número de vCPUs do contêiner.	2.0
PreviousState	object	O estado anterior.
StartTime	string	A hora em que o contêiner começou a executar.	2021-12-02T15:00:00Z
FinishTime	string	A hora em que o contêiner parou de executar.	2021-12-02T15:01:00Z
DetailStatus	string	Os detalhes do status.	working
State	string	O estado do contêiner. Valores válidos: Waiting: iniciando. Running: em execução. Terminated: terminado.	Terminated
Message	string	A mensagem de estado do contêiner.	Back-off 5m0s restarting failed container=test pod=test_eci-xxx(xxx)
Signal	integer	O sinal de estado do contêiner.	1
ExitCode	integer	O código de saída do contêiner.	0
Reason	string	O motivo pelo qual o contêiner está neste estado.	Completed
Tty	boolean	Indica se a interação está ativada. Valor padrão: false. Por exemplo, se Command estiver definido como `/bin/bash`, defina este parâmetro como true.	false
WorkingDir	string	O diretório de trabalho.	/usr/local/nginx
CurrentState	object	O estado atual do contêiner.
StartTime	string	A hora em que o contêiner começou a executar.	2021-12-02T15:00:00Z
FinishTime	string	A hora em que o contêiner parou de executar.	2021-12-02T15:01:00Z
DetailStatus	string	Os detalhes do estado do contêiner.	working
State	string	O estado do contêiner. Valores válidos: Waiting Running Terminated	Terminated
Message	string	A mensagem de estado do contêiner.	Back-off 5m0s restarting failed container=test pod=test_eci-xxx(xxx)
Signal	integer	O sinal de estado do contêiner.	1
ExitCode	integer	O código de saída do contêiner.	0
Reason	string	O motivo pelo qual o contêiner está neste estado.	Started
Ready	boolean	Indica se o contêiner passou em sua sonda de prontidão.	true
Gpu	integer	O número de GPUs.	1
SecurityContext	object	O contexto de segurança da instância.
ReadOnlyRootFilesystem	boolean	Indica se o sistema de arquivos raiz é somente leitura. Atualmente, apenas True é suportado.	true
RunAsUser	integer	O ID de usuário usado para executar o contêiner.	1000
Capability	object	As permissões específicas concedidas aos processos no contêiner.
Adds	array	As permissões específicas concedidas aos processos no contêiner.
	string	As permissões específicas concedidas aos processos no contêiner.	[NET_ADMIN]
Memory	number	O tamanho da memória do contêiner. Unidade: GiB.	2.0
Stdin	boolean	Indica se este contêiner aloca um buffer para entrada padrão no runtime do contêiner. Se este parâmetro não for definido, as leituras da entrada padrão no contêiner resultarão em EOF. Valor padrão: false.	true
Name	string	O nome do contêiner.	nginx
EnvironmentVars	array<object>	As variáveis de ambiente.
	array<object>	As variáveis de ambiente.
Key	string	O nome da variável de ambiente.	PATH
Value	string	O valor da variável de ambiente.	/usr/bin/
ValueFrom	object	A origem do valor da variável de ambiente. Este parâmetro não pode ser usado se o valor não estiver vazio.
FieldRef	object	O campo especificado.
FieldPath	string	O caminho do campo.	status.podIP
ReadinessProbe	object	A sonda de prontidão, usada para verificar se o contêiner está pronto para atender solicitações.
SuccessThreshold	integer	O número mínimo de sucessos consecutivos para que a sonda seja considerada bem-sucedida após ter falhado. Valor padrão: 1. O valor atual deve ser 1.	1
InitialDelaySeconds	integer	O número de segundos após o início do contêiner antes que a sonda seja iniciada.	5
FailureThreshold	integer	O número mínimo de falhas consecutivas para que a sonda seja considerada como falha após ter sido bem-sucedida. Valor padrão: 3.	3
TimeoutSeconds	integer	O período de tempo limite da sonda. Valor padrão: 1 segundo. Valor mínimo: 1 segundo.	1
TcpSocket	object	O método de soquete TCP para verificações de integridade.
Host	string	Host.	1.2.3.4
Port	integer	O número da porta.	8888
Execs	array	Os comandos executados no contêiner quando o método de linha de comando é usado para verificações de integridade.
	string	Os comandos executados no contêiner quando o método de linha de comando é usado para verificações de integridade.	["/bin/sh", "-c", "echo Hello world > /usr/share/message"]
HttpGet	object	O método de solicitação HTTP para verificações de integridade.
Scheme	string	HTTP/HTTPS.	HTTP
Path	string	O caminho para a sonda HTTP GET.	/usr/local
Port	integer	O número da porta para a verificação de integridade HTTP GET.	8080
PeriodSeconds	integer	O intervalo no qual a sonda é executada. Valor padrão: 10 segundos. Valor mínimo: 1 segundo.	1
EniInstanceId	string	O ID do controlador de interface de rede elástica (NIC).	eni-bp14rzqi6fd8satm****
InitContainers	array<object>	Os contêineres de inicialização.
	array<object>	Os contêineres de inicialização.
VolumeMounts	array<object>	Os volumes montados no contêiner de inicialização.
	object	Os volumes montados no contêiner de inicialização.
MountPropagation	string	A configuração de propagação de montagem do volume. A propagação de montagem permite que volumes montados por um contêiner sejam compartilhados com outros contêineres no mesmo pod ou até mesmo com outros pods no mesmo nó. Valores válidos: None: a montagem do volume não recebe montagens subsequentes que são montadas neste volume ou em seus subdiretórios. HostToCotainer: a montagem do volume recebe montagens subsequentes que são montadas neste volume ou em seus subdiretórios. Bidirectional: semelhante a HostToCotainer, a montagem do volume pode detectar operações de montagem. Além disso, o volume é propagado de volta para o host e todos os contêineres de todos os pods que usam o mesmo volume.	None
MountPath	string	O diretório de montagem. O conteúdo sob o diretório de montagem no contêiner é substituído pelo conteúdo do volume.	/usr/share/
ReadOnly	boolean	Indica se a montagem é somente leitura.	false
Name	string	O nome do volume, que é igual ao valor Name em Volume.	test-empty
Args	array	Os argumentos de inicialização.
	string	Os argumentos de inicialização.	['hello world']
Image	string	A imagem.	nginx
Ports	array<object>	As portas e protocolos expostos.
	object	As portas e protocolos expostos.
Protocol	string	O tipo de protocolo.	TCP
Port	integer	O número da porta. Valores válidos: 1 a 65535.	8888
RestartCount	integer	O número de reinicializações.	5
ImagePullPolicy	string	A política de pull da imagem. Valores válidos: Always: sempre faz o pull da imagem. A imagem é baixada todas as vezes. IfNotPresent: faz o pull da imagem sob demanda. A imagem local é usada preferencialmente. Se nenhuma imagem local estiver disponível, a imagem é baixada. Never: nunca faz o pull da imagem. Apenas a imagem local é usada.	Always
PreviousState	object	O estado anterior.
StartTime	string	A hora em que o contêiner começou a executar.	2021-12-02T15:00:00Z
FinishTime	string	A hora em que o contêiner parou de executar.	2021-12-02T15:01:00Z
DetailStatus	string	Os detalhes do status.	working
State	string	O estado do contêiner. Valores válidos: Waiting, Running e Terminated.	Terminated
Message	string	A mensagem de estado do contêiner.	Started container
Signal	integer	O sinal de estado do contêiner.	1
ExitCode	integer	O código de saída do contêiner.	0
Reason	string	O motivo pelo qual o contêiner está neste estado.	completed
WorkingDir	string	O diretório de trabalho.	/usr/test
Cpu	number	O número de vCPUs.	1.0
CurrentState	object	O estado atual.
StartTime	string	A hora em que o contêiner começou a executar.	2021-12-02T15:00:00Z
FinishTime	string	A hora em que o contêiner parou de executar.	2021-12-02T15:01:00Z
DetailStatus	string	Os detalhes do status.	working
State	string	O estado do contêiner. Valores válidos: Waiting Running Terminated	Running
Message	string	A mensagem do evento.	Created container
Signal	integer	O sinal de estado do contêiner.	1
ExitCode	integer	O código de saída do contêiner.	0
Reason	string	O motivo pelo qual o contêiner está neste estado.	Started
Command	array	O comando de inicialização.
	string	O comando de inicialização.	[/bin/sh echo]
Ready	boolean	Indica se o contêiner passou em sua sonda de prontidão.	true
Gpu	integer	O número de GPUs.	1
SecurityContext	object	O contexto de segurança do contêiner.
ReadOnlyRootFilesystem	boolean	Indica se o sistema de arquivos raiz é somente leitura. Atualmente, apenas True é suportado.	true
RunAsUser	integer	O UID usado para executar o ponto de entrada do processo do contêiner.	1557
Capability	object	As permissões específicas concedidas aos processos no contêiner.
Adds	array	As permissões específicas concedidas aos processos no contêiner.
	string	As permissões específicas concedidas aos processos no contêiner.	NET_ADMIN
Memory	number	O tamanho da memória do contêiner de inicialização. Unidade: GiB.	2.0
Name	string	O nome do contêiner.	Init-xxx
EnvironmentVars	array<object>	As variáveis de ambiente.
	array<object>	As variáveis de ambiente.
Key	string	O nome da variável de ambiente.	PATH
Value	string	O valor da variável de ambiente.	/usr/local/bin
ValueFrom	object	A origem do valor da variável de ambiente. Este parâmetro não pode ser usado se o valor não estiver vazio.
FieldRef	object	O campo especificado.
FieldPath	string	O caminho do campo a ser selecionado na versão especificada. Atualmente, apenas `status.podIP` é suportado.	status.podIP
ContainerGroupId	string	O ID da instância.	eci-bp1jrgfqqy54kg5hc****
TenantEniIp	string	Este parâmetro não está disponível para uso.	10.10.XX.XX
InstanceType	string	O tipo de instância ECS especificado.	ecs.g5.large
IntranetIp	string	O endereço IP interno.	172.16.XX.XX
Ipv6Address	string	O endereço IPv6.	2001:XXXX:4:4:4:4:4:4
RegionId	string	O ID da região da instância.	cn-hangzhou
DnsConfig	object	A configuração de DNS.
Searches	array	A lista de domínios de pesquisa DNS.
	string	O domínio de pesquisa DNS.	svc.local.kubenetes
Options	array<object>	A lista de opções de objeto. Cada objeto consiste em um Name e um Value opcional.
	object	A lista de opções de objeto. Cada objeto consiste em um Name e um Value opcional.
Value	string	O valor da variável do objeto.	value
Name	string	O nome da variável do objeto.	name
NameServers	array	A lista de endereços IP dos servidores DNS.
	string	O endereço IP.	[10.2..]
Volumes	array<object>	As informações do volume.
	array<object>	As informações do volume.
Type	string	O tipo de volume. Valores válidos: EmptyDirVolume NFSVolume ConfigFileVolume FlexVolume	EmptyDirVolume
DiskVolumeDiskId	string	O ID do DiskVolume.	d-xxxx
NFSVolumeReadOnly	boolean	Indica se a montagem é somente leitura.	false
ConfigFileVolumeConfigFileToPaths	array<object>	A lista de caminhos de arquivos de configuração.
	object	A lista de caminhos de arquivos de configuração.
Path	string	O caminho relativo do arquivo.	/usr/bin/
Content	string	O conteúdo do arquivo de configuração (32 KB).	hello world
FlexVolumeFsType	string	O tipo do sistema de arquivos montado. O valor padrão depende do script FlexVolume.	ntfs
FlexVolumeDriver	string	O nome do driver usado para o FlexVolume.	flexvolume
DiskVolumeFsType	string	O tipo de volume.	xfs
FlexVolumeOptions	string	A lista de opções de objeto FlexVolume.	[nolock,tcp,noresvport]
NFSVolumeServer	string	O endereço do servidor NFS.	0eafxxxxx-xxxxx.cn-hangzhou.nas.aliyuncs.com
NFSVolumePath	string	O caminho do volume NFS.	/eci
Name	string	O nome do volume.	test-empty
EmptyDirVolumeMedium	string	O meio de armazenamento do volume EmptyDir. Por padrão, este parâmetro está vazio, o que indica que o sistema de arquivos do nó é usado. Valores válidos: Memory: usa memória. LocalRaid0: combina discos locais em RAID 0. Este valor é aplicável apenas a cenários em que uma instância de disco local é criada e discos locais são montados. Para mais informações, consulte Criar uma instância de disco local.	Memory
EmptyDirVolumeSizeLimit	string	O tamanho do volume EmptyDir.	256Mi
RamRoleName	string	O nome da função RAM da instância. O Elastic Container Instance e o ECS compartilham a função RAM da instância. Para mais informações, consulte Usar uma função RAM de instância chamando operações de API.	ram:PassRole
VSwitchId	string	O ID do vSwitch.	vsw-bp1vzjjflab6wvjox****
Cpu	number	O número de vCPUs no nível da instância.	2.0
ExpiredTime	string	A hora em que a instância falhou devido a pagamento em atraso. A hora está em UTC e no formato RFC 3339.	2018-08-02T15:00:00Z
ResourceGroupId	string	O ID do grupo de recursos.	rg-8db03793gfrz****
ZoneId	string	A zona onde a instância reside.	cn-hangzhou-h
ContainerGroupName	string	O nome da instância.	test
EciSecurityContext	object	O contexto de segurança do grupo de contêineres.
Sysctls	array<object>	Os parâmetros sysctl.
	object	Os parâmetros sysctl.
Value	string	O valor do parâmetro sysctl.	65536
Name	string	O nome do parâmetro sysctl.	kernel.msgmax
FailedTime	string	A hora em que a instância falhou. A hora está em UTC e no formato RFC 3339.	2018-08-02T15:00:00Z
ComputeCategory	string	A categoria de computação. Valores válidos: economy: econômica general: uso geral	economy
DnsPolicy	string	A política de DNS. Valores válidos: None: usa o DNS configurado no campo DnsConfig. Default: herda as configurações de DNS do ambiente de execução.	None

Exemplos

Resposta de sucesso

JSON formato

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

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidParameter.MismatchInstanceType	The instanceId mismatch instance type.	O tipo de instância é inválido.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.