Consulta os detalhes de um ou mais modelos de imagem.
Descrição da operação
Você pode definir o token de consulta NextToken como o valor NextToken retornado da chamada anterior do DescribeImagePipelines e usar MaxResults para especificar o número máximo de entradas por página para a consulta.
Experimente agora
Testar
Autorização RAM
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
Exemplo |
| RegionId |
string |
Sim |
O ID da região. Você pode chamar a operação DescribeRegions para consultar a lista de regiões mais recente. |
cn-hangzhou |
| ResourceGroupId |
string |
Não |
O ID do grupo de recursos. Ao usar este parâmetro para filtrar recursos, a contagem de recursos não pode exceder 1.000. Nota
A filtragem pelo grupo de recursos padrão não é suportada. |
rg-bp67acfmxazb4p**** |
| Tag |
array<object> |
Não |
As tags. |
|
|
object |
Não |
As tags. |
||
| Key |
string |
Não |
A chave da tag. Valores válidos de N: 1 a 20. |
TestKey |
| Value |
string |
Não |
O valor da tag. Valores válidos de N: 1 a 20. |
TestValue |
| Name |
string |
Não |
O nome do modelo. |
testImagePipeline |
| NextToken |
string |
Não |
O token de consulta. Defina o valor como o valor NextToken retornado da chamada de API anterior. Você não precisa especificar este parâmetro na primeira chamada. |
AAAAAdDWBF2**** |
| MaxResults |
integer |
Não |
O número máximo de entradas por página para paginação. Valores válidos: 1 a 500. Valor padrão: 50. |
50 |
| ImagePipelineId |
array |
Não |
O ID do modelo de imagem. Valores válidos de N: 1 a 20. |
ip-2ze5tsl5bp6nf2b3**** |
|
string |
Não |
O ID do modelo de imagem. Valores válidos de N: 1 a 20. |
ip-2ze5tsl5bp6nf2b3**** |
Elementos de resposta
|
Elemento |
Tipo |
Descrição |
Exemplo |
|
object |
|||
| ImagePipeline |
object |
||
| ImagePipelineSet |
array<object> |
A lista de modelos de imagem. |
|
|
array<object> |
|||
| AddAccounts |
object |
||
| AddAccount |
array |
O ID da conta Alibaba Cloud para compartilhamento da imagem de destino. |
|
|
string |
O ID da conta Alibaba Cloud para compartilhamento da imagem de destino. |
["1234567890"] |
|
| AdvancedOptions |
object |
As configurações avançadas. |
|
| ImageNameSuffix |
string |
Especifica se deve ser desativada a adição automática de um sufixo ao nome da imagem de destino. Valores válidos:
|
disable |
| RetainCloudAssistant |
boolean |
Especifica se o Cloud Assistant deve ser retido. Durante o processo de compilação, o sistema instala automaticamente o Cloud Assistant na instância intermediária para executar comandos. Você pode escolher se deseja retê-lo na imagem de destino compilada. Valores válidos:
Nota
Esta configuração não afeta o Cloud Assistant que está pré-instalado na sua imagem. |
true |
| BaseImage |
string |
A imagem de origem.
|
m-bp67acfmxazb4p**** |
| BaseImageType |
string |
O tipo da imagem de origem. Valores válidos:
|
IMAGE |
| BuildContent |
string |
O conteúdo do modelo de imagem. |
COMPONENT ic-bp12dvdzvr9k9***** COMPONENT acs:ecs:cn-hangzhou:18689161186*****:imagecomponent/ComponentName/1.*.* |
| CreationTime |
string |
A hora em que o modelo foi criado. A hora segue o padrão ISO 8601 e é exibida em UTC. |
2020-11-24T06:00:00Z |
| DeleteInstanceOnFailure |
boolean |
Especifica se a instância intermediária deve ser liberada se a compilação da imagem falhar. |
true |
| Description |
string |
A descrição. |
This is description. |
ImageFamily
deprecated
|
string |
A família de imagens da imagem de destino. Importante
[Deprecated] Use ImageOptions.ImageFamily.
|
family |
ImageName
deprecated
|
string |
O prefixo do nome da imagem de destino. Importante
[Deprecated] Use ImageOptions.ImageName.
|
testImageName |
| ImageOptions |
object |
As propriedades da imagem de destino. |
|
| Description |
string |
A descrição da imagem de destino. |
description. |
| ImageFamily |
string |
A família de imagens da imagem de destino. |
family |
| ImageFeatures |
object |
As propriedades relacionadas a recursos da imagem de destino. |
|
| NvmeSupport |
string |
Especifica se a imagem de destino compilada oferece suporte a NVMe. Valores válidos:
|
auto |
| ImageName |
string |
O prefixo do nome da imagem de destino. |
imageName |
| ImageTags |
object |
||
| ImageTag |
array<object> |
As tags da imagem de destino. |
|
|
object |
|||
| TagKey |
string |
A chave da tag. |
testKey |
| TagValue |
string |
O valor da tag. |
testValue |
| ImagePipelineId |
string |
O ID do modelo de imagem. |
ip-2ze5tsl5bp6nf2b3**** |
| ImageSecurityOptions |
object |
As propriedades e configurações relacionadas à segurança da imagem. |
|
| SecurityScanMode |
string |
O modo de verificação de segurança. Valores válidos:
|
agentless |
| ImportImageOptions |
object |
As propriedades e configurações da imagem importada. |
|
| Architecture |
string |
A arquitetura do sistema. Valores válidos:
|
x86_64 |
| BootMode |
string |
O modo de inicialização da imagem importada. Valores válidos:
|
BIOS |
| Description |
string |
A descrição da imagem importada. |
created by acc |
| DiskDeviceMappings |
object |
||
| DiskDeviceMapping |
array<object> |
A lista de informações da imagem personalizada.
|
|
|
object |
|||
| DiskImageSize |
integer |
O tamanho da imagem personalizada após a importação da imagem. O espaço consiste no disco de sistema e nos discos de dados. Você deve garantir que o tamanho do disco de sistema seja maior ou igual ao tamanho do arquivo de imagem importado. Valores válidos:
Depois de fazer upload do arquivo de imagem de origem para o OSS, você pode visualizar o tamanho do arquivo de imagem no bucket do OSS. |
40 |
| Format |
string |
O formato da imagem. Valores válidos:
|
RAW |
| OSSBucket |
string |
O bucket do OSS onde o arquivo de imagem está armazenado. |
ecsimageos |
| OSSObject |
string |
O nome (chave) do arquivo de imagem salvo no bucket do OSS após o upload da imagem. |
CentOS_5.4_32.raw |
| Features |
object |
As propriedades relacionadas a recursos da imagem. |
|
| ImdsSupport |
string |
O modo de acesso aos metadados da imagem. Valores válidos:
Valor padrão: v1. |
v2 |
| NvmeSupport |
string |
Especifica se a imagem importada oferece suporte a NVMe. Valores válidos:
|
supported |
| ImageName |
string |
O nome da imagem importada. |
fvt-ecs-imported-image-1812b2d7 |
| ImportImageTags |
object |
||
| ImportImageTag |
array<object> |
A lista de tags usadas quando a imagem é importada. |
|
|
object |
O par chave-valor da tag da imagem importada. |
||
| Key |
string |
A chave da tag da imagem. |
testKey |
| Value |
string |
O valor da tag da imagem. |
testValue |
| LicenseType |
string |
O tipo de licença usado para ativar o sistema operacional após a importação da imagem. Valores válidos:
|
Auto |
| OSType |
string |
O tipo de sistema operacional. Valores válidos:
|
linux |
| Platform |
string |
A versão do sistema operacional. Valores válidos:
|
Aliyun |
| RetainImportedImage |
boolean |
Importante
**[Deprecated]** Use ImportImageOptions.RetentionStrategy.
|
false |
| RetentionStrategy |
string |
A política de retenção de dados para a imagem importada. Valores válidos:
Valor padrão: RetainNever. |
RetainAlways |
| RoleName |
string |
O nome da função RAM usada quando a imagem é importada. |
AliyunECSImageImportDefaultRole |
| InstanceType |
string |
O tipo de instância. |
ecs.g6.large |
| InternetMaxBandwidthOut |
integer |
A largura de banda pública de saída da instância intermediária. Unidade: Mbit/s. |
0 |
| Name |
string |
O nome do modelo. |
testImagePipeline |
NvmeSupport
deprecated
|
string |
Especifica se a imagem de destino compilada oferece suporte a NVMe. Importante
[Deprecated] Use ImageOptions.ImageFeatures.NvmeSupport.
|
auto |
| RepairItems |
object |
||
| RepairItem |
array |
Os itens de reparo da imagem.
|
|
|
string |
O item de reparo da imagem. |
fstab |
|
| RepairMode |
string |
A opção de reparo no modelo de imagem. Valores válidos:
Nota
À medida que os recursos de detecção e reparo continuam a melhorar, os itens de reparo incluídos podem aumentar. Para obter mais informações sobre os significados específicos dos itens de reparo, consulte Visão geral da inspeção de imagem. |
Standard |
| ResourceGroupId |
string |
O ID do grupo de recursos. |
rg-bp67acfmxazb4p**** |
| SystemDiskSize |
integer |
O tamanho do disco de sistema da instância intermediária. Unidade: GiB. |
40 |
| Tags |
object |
||
| Tag |
array<object> |
A lista de pares chave-valor de tag. |
|
|
object |
|||
| TagKey |
string |
A chave da tag. |
TestKey |
| TagValue |
string |
O valor da tag. |
TestValue |
| TestContent |
string |
O conteúdo do modelo de teste de imagem. |
COMPONENT ic-bp12dvdzvr9k9***** COMPONENT acs:ecs:cn-hangzhou:18689161186*****:imagecomponent/ComponentName/1.*.* |
| ToRegionIds |
object |
||
| ToRegionId |
array |
A lista de regiões para as quais a imagem de destino será distribuída. |
|
|
string |
A lista de regiões para as quais a imagem de destino será distribuída. |
["cn-hangzhou"] |
|
| VSwitchId |
string |
O ID do vSwitch na VPC. |
vsw-bp67acfmxazb4p**** |
| MaxResults |
integer |
O número de entradas por página em uma consulta paginada. |
50 |
| NextToken |
string |
O token de consulta retornado por esta chamada. Para obter mais informações sobre como usar o token, consulte a descrição da operação. |
AAAAAdDWBF2**** |
| RequestId |
string |
O ID da solicitação. |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
| TotalCount |
integer |
O número total de modelos de imagem retornados. |
1 |
Exemplos
Resposta de sucesso
JSON formato
{
"ImagePipeline": {
"ImagePipelineSet": [
{
"AddAccounts": {
"AddAccount": [
"[\"1234567890\"]"
]
},
"AdvancedOptions": {
"ImageNameSuffix": "disable",
"RetainCloudAssistant": true
},
"BaseImage": "m-bp67acfmxazb4p****",
"BaseImageType": "IMAGE",
"BuildContent": "COMPONENT ic-bp12dvdzvr9k9*****\nCOMPONENT acs:ecs:cn-hangzhou:18689161186*****:imagecomponent/ComponentName/1.*.*",
"CreationTime": "2020-11-24T06:00:00Z",
"DeleteInstanceOnFailure": true,
"Description": "This is description.",
"ImageFamily": "family",
"ImageName": "testImageName",
"ImageOptions": {
"Description": "description.",
"ImageFamily": "family",
"ImageFeatures": {
"NvmeSupport": "auto"
},
"ImageName": "imageName",
"ImageTags": {
"ImageTag": [
{
"TagKey": "testKey",
"TagValue": "testValue"
}
]
}
},
"ImagePipelineId": "ip-2ze5tsl5bp6nf2b3****",
"ImageSecurityOptions": {
"SecurityScanMode": "agentless"
},
"ImportImageOptions": {
"Architecture": "x86_64",
"BootMode": "BIOS",
"Description": "created by acc",
"DiskDeviceMappings": {
"DiskDeviceMapping": [
{
"DiskImageSize": 40,
"Format": "RAW",
"OSSBucket": "ecsimageos",
"OSSObject": "CentOS_5.4_32.raw"
}
]
},
"Features": {
"ImdsSupport": "v2",
"NvmeSupport": "supported"
},
"ImageName": "fvt-ecs-imported-image-1812b2d7",
"ImportImageTags": {
"ImportImageTag": [
{
"Key": "testKey",
"Value": "testValue"
}
]
},
"LicenseType": "Auto",
"OSType": "linux",
"Platform": "Aliyun",
"RetainImportedImage": false,
"RetentionStrategy": "RetainAlways",
"RoleName": "AliyunECSImageImportDefaultRole"
},
"InstanceType": "ecs.g6.large",
"InternetMaxBandwidthOut": 0,
"Name": "testImagePipeline",
"NvmeSupport": "auto",
"RepairItems": {
"RepairItem": [
"fstab"
]
},
"RepairMode": "Standard",
"ResourceGroupId": "rg-bp67acfmxazb4p****",
"SystemDiskSize": 40,
"Tags": {
"Tag": [
{
"TagKey": "TestKey",
"TagValue": "TestValue"
}
]
},
"TestContent": "COMPONENT ic-bp12dvdzvr9k9*****\nCOMPONENT acs:ecs:cn-hangzhou:18689161186*****:imagecomponent/ComponentName/1.*.*",
"ToRegionIds": {
"ToRegionId": [
"[\"cn-hangzhou\"]"
]
},
"VSwitchId": "vsw-bp67acfmxazb4p****"
}
]
},
"MaxResults": 50,
"NextToken": "AAAAAdDWBF2****",
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
"TotalCount": 1
}
Códigos de erro
|
Código de status HTTP |
Código de erro |
Mensagem de erro |
Descrição |
|---|---|---|---|
| 400 | InvalidImagePipelineIdSize.ExceededMaxNumber | %s | O número de parâmetros ImagePipelineId.N excede o limite superior. Valores válidos para N: 1 a 20. |
| 400 | InvalidName.Malformed | %s | |
| 403 | Invalid.NextToken | The specified NextToken is not valid. |
Consulte Códigos de Erro para uma lista completa.
Notas de versão
Consulte Notas de Versão para uma lista completa.