Kullanılabilir görüntüleri sorgular.
Kullanım notları
Özel görüntülerinizi, Alibaba Cloud tarafından sağlanan genel görüntüleri, Alibaba Cloud Marketplace görüntülerini ve diğer Alibaba Cloud hesaplarından paylaşılan görüntüleri sorgulayabilirsiniz.
Bu, sayfalı bir sorgudur. Yanıt, kullanılabilir toplam görüntü sayısını ve döndürülen sayfada yer alan görüntüleri içerir. Varsayılan olarak her sayfada 10 kayıt gösterilir.
Alibaba Cloud CLI kullanarak bir API işlemini çağırırken farklı türdeki istek parametre değerlerini gerekli biçimlerde belirtmeniz gerekir. Daha fazla bilgi için bkz. Parametre biçimine genel bakış.
DescribeImages işlemini çağırarak ImageOwnerAlias parametresini system veya others olarak ayarlarsanız (Alibaba Cloud tarafından sağlanan görüntüleri veya paylaşılan görüntüleri sorgulamak için), işlem sırasında Resource Access Management (RAM) kimlik doğrulama kuralları dikkate alınmaz. Daha fazla bilgi için bkz. Kimlik doğrulama kuralları.
Hata ayıklama
İstek parametreleri
|
Parametre |
Tür |
Gerekli |
Örnek |
Açıklama |
| Action | String | Evet | DescribeImages | Gerçekleştirmek istediğiniz işlem. Değeri DescribeImages olarak ayarlayın. |
| RegionId | String | Evet | cn-hangzhou | Görüntünün bölge kimliği. En güncel bölge listesini sorgulamak için DescribeRegions işlemini çağırabilirsiniz. |
| Status | String | Hayır | Available | Görüntünün durumu. Bu parametreyi belirtmezseniz varsayılan olarak yalnızca Available durumundaki görüntüler döndürülür. Geçerli değerler:
Varsayılan değer: Available. Bu parametre için birden fazla değer belirtebilirsiniz. Değerleri virgülle (,) ayırın. |
| ImageId | String | Hayır | m-bp1g7004ksh0oeuc**** | Görüntünün kimliği. |
| ShowExpired | Boolean | Hayır | false | Abonelik tabanlı görüntünün süresinin dolup dolmadığını belirtir. Not Bu parametre gelecekte kaldırılacaktır. Gelecekteki uyumluluğu sağlamak için diğer parametreleri kullanmanızı öneririz. |
| SnapshotId | String | Hayır | s-bp17ot2q7x72ggtw**** | Özel görüntüyü oluşturmak için kullanılan anlık görüntünün kimliği. |
| ImageName | String | Hayır | testImageName | Görüntünün adı. |
| ImageFamily | String | Hayır | hangzhou-daily-update | Görüntü ailesinin adı. Belirtilen görüntü ailesine ait görüntüleri sorgulamak için bu parametreyi ayarlayabilirsiniz. Bu parametre varsayılan olarak boştur. Not Alibaba Cloud tarafından sağlanan genel görüntülerle ilişkili görüntü aileleri hakkında bilgi için bkz. Genel Bakış. |
| ImageOwnerAlias | String | Hayır | self | Görüntünün kaynağı. Geçerli değerler:
Bu parametre varsayılan olarak boştur. Not Bu parametreyi boş bırakırsanız özel görüntüler, Alibaba Cloud tarafından sağlanan görüntüler, paylaşılan görüntüler ve topluluk görüntüleri sorgulanır. |
| InstanceType | String | Hayır | ecs.g5.large | Görüntünün kullanılabileceği örnek türü. |
| IsSupportIoOptimized | Boolean | Hayır | true | Görüntünün G/Ç iyileştirmeli örneklerde kullanılıp kullanılamayacağını belirtir. |
| IsSupportCloudinit | Boolean | Hayır | true | Görüntünün cloud-init'i destekleyip desteklemediğini belirtir. |
| OSType | String | Hayır | linux | Görüntünün işletim sistemi türü. Geçerli değerler:
|
| Architecture | String | Hayır | i386 | Görüntü mimarisi. Geçerli değerler:
|
| PageNumber | Integer | Hayır | 1 | Sayfa numarası. Sayfalar 1'den başlar. Varsayılan değer: 1. |
| PageSize | Integer | Hayır | 1 | Sayfa başına kayıt sayısı. Geçerli değerler: 1 ile 100 arasında. Varsayılan değer: 10. |
| Usage | String | Hayır | instance | Görüntünün bir ECS örneğinde çalışıp çalışmadığını belirtir. Geçerli değerler:
|
| DryRun | Boolean | Hayır | false | Gerçek isteği yürütmeden yalnızca kuru çalışma yapılıp yapılmayacağını belirtir. Geçerli değerler:
Varsayılan değer: false. |
| ActionType | String | Hayır | CreateEcs | Görüntünün kullanıldığı senaryo. Geçerli değerler:
|
| ResourceGroupId | String | Hayır | rg-bp67acfmxazb4p**** | Özel görüntünün ait olduğu kaynak grubunun kimliği. Kaynakları sorgulamak için bu parametre belirtilirse belirtilen kaynak grubuna ait en fazla 1.000 kaynak döndürülür. Not Bu parametrenin nasıl ayarlandığından bağımsız olarak varsayılan kaynak grubundaki kaynaklar yanıtta görüntülenir. |
| Tag.N.key | String | Hayır | null | Görüntünün N. etiketinin anahtarı. Not Bu parametre gelecekte kaldırılacaktır. Gelecekteki uyumluluğu sağlamak için Tag.N.Key kullanmanızı öneririz. |
| Tag.N.Key | String | Hayır | TestKey | Görüntünün N. etiketinin anahtarı. N için geçerli değerler: 1 ile 20 arasında. Kaynakları sorgulamak için tek bir etiket belirtilirse bu etikete sahip en fazla 1.000 kaynak döndürülür. Kaynakları sorgulamak için birden çok etiket belirtilirse bu etiketlerin tümüne sahip en fazla 1.000 kaynak döndürülür. Belirtilen etiketlere sahip 1.000'den fazla kaynağı sorgulamak için ListTagResources işlemini çağırın. |
| Tag.N.Value | String | Hayır | TestValue | Görüntünün N. etiketinin değeri. N için geçerli değerler: 1 ile 20 arasında. |
| Tag.N.value | String | Hayır | null | Görüntünün N. etiketinin değeri. Not Bu parametre gelecekte kaldırılacaktır. Gelecekteki uyumluluğu sağlamak için Tag.N.Value kullanmanızı öneririz. |
| Filter.N.Key | String | Hayır | CreationStartTime | Kaynakları sorgulamak için kullanılan N. filtrenin anahtarı. Geçerli değerler:
|
| Filter.N.Value | String | Hayır | 2017-12-05T22:40Z | Kaynakları sorgulamak için kullanılan N. filtrenin değeri. Değeri, sorgulanacak zaman aralığının başlangıcına veya bitişine ayarlayın. Bu parametreyi belirttiğinizde |
| IsPublic | Boolean | Hayır | false | Yayınlanmış topluluk görüntülerinin sorgulanıp sorgulanmayacağını belirtir. Geçerli değerler:
Varsayılan değer: false. |
| ImageOwnerId | Long | Hayır | 1234567890 | Görüntünün ait olduğu Alibaba Cloud hesabının kimliği. Bu parametre yalnızca paylaşılan görüntüleri veya topluluk görüntülerini sorguluyorsanız etkili olur. |
Yanıt parametreleri
Parametre |
Tür |
Örnek |
Açıklama |
| PageSize | Integer | 1 | Sayfa başına kayıt sayısı. |
| PageNumber | Integer | 1 | Sayfa numarası. |
| RequestId | String | 66189103-EDB2-43E2-BB60-BFF2B62F4EB8 | İsteğin kimliği. |
| TotalCount | Integer | 1 | Toplam görüntü sayısı. |
| RegionId | String | cn-hangzhou | Görüntünün bölge kimliği. |
| Images | Array of Image | Görüntüler hakkındaki bilgiler. |
|
| Image | |||
| CreationTime | String | 2019-11-15T06:07:05Z | Görüntünün oluşturulma zamanı. |
| Status | String | Available | Görüntünün durumu. Geçerli değerler:
|
| ImageFamily | String | hangzhou-daily-update | Görüntü ailesinin adı. |
| Progress | String | 100% | Görüntü oluşturma ilerlemesi. Birim: yüzde (%). |
| IsCopied | Boolean | false | Görüntünün başka bir görüntünün kopyası olup olmadığını gösterir. |
| IsSupportIoOptimized | Boolean | true | Görüntünün G/Ç iyileştirmeli örneklerde kullanılıp kullanılamayacağını gösterir. |
| ImageOwnerAlias | String | self | Görüntünün kaynağı. Geçerli değerler:
|
| IsSupportCloudinit | Boolean | true | Görüntünün cloud-init'i destekleyip desteklemediğini gösterir. |
| ImageVersion | String | 2 | Görüntü sürümü. |
| Usage | String | none | Görüntünün ECS örnekleri oluşturmak için kullanılıp kullanılmadığını gösterir. Geçerli değerler:
|
| IsSelfShared | String | true | Özel görüntünün diğer Alibaba Cloud hesaplarıyla paylaşılıp paylaşılmadığını gösterir. |
| Description | String | Archive log for Oracle | Görüntünün açıklaması. |
| Size | Integer | 60 | Görüntünün boyutu. Birim: GiB. |
| ResourceGroupId | String | rg-bp67acfmxazb4p**** | Görüntünün ait olduğu kaynak grubunun kimliği. |
| Platform | String | Windows Server 2016 | İşletim sistemi. |
| OSNameEn | String | Windows Server 2016 Data Center Edition 64bit Chinese Edition | İşletim sisteminin İngilizce olarak görüntülenen adı. |
| ImageName | String | testImageName | Görüntü adı. |
| OSName | String | Windows Server 2016 Datacenter 64-bit (Simplified Chinese) | İşletim sisteminin Çince olarak görüntülenen adı. |
| ImageId | String | m-bp1g7004ksh0oeuc**** | Görüntünün kimliği. |
| OSType | String | windows | İşletim sistemi türü. Geçerli değerler:
|
| IsSubscribed | Boolean | false | Ürün koduna karşılık gelen görüntü hizmetinin Hizmet Şartlarını kabul edip etmediğinizi gösterir. |
| ProductCode | String | test000**** | Görüntünün Alibaba Cloud Marketplace ürün kodu. |
| Architecture | String | x86_64 | Görüntünün mimarisi. Geçerli değerler:
|
| BootMode | String | BIOS | Görüntünün önyükleme modu. Geçerli değerler:
|
| DiskDeviceMappings | Array of DiskDeviceMapping | Görüntüdeki diskler ile anlık görüntüler arasındaki eşlemeler. |
|
| DiskDeviceMapping | |||
| Type | String | system | Görüntü türü. |
| ImportOSSBucket | String | testEcsImport | İçe aktarılan görüntü dosyasını içeren Object Storage Service (OSS) paketi. |
| Progress | String | 32% | Görüntü kopyalama görevinin ilerleme durumu. |
| SnapshotId | String | s-bp17ot2q7x72ggtw**** | Anlık görüntü kimliği. |
| ImportOSSObject | String | imageImport | İçe aktarılan görüntü dosyasına karşılık gelen OSS nesnesi. |
| Device | String | /dev/xvda | Diskin cihaz adı. Örnek: /dev/xvdb. Not Bu parametre gelecekte kaldırılacaktır. Uyumluluğu sağlamak için diğer parametreleri kullanmanızı öneririz. |
| Size | String | 60 | Diskin boyutu. Birim: GiB. |
| RemainTime | Integer | 233 | Bir görüntü kopyalama görevinin kalan süresi. Birim: saniye. |
| Format | String | qcow2 | Görüntü biçimi. |
| Tags | Array of Tag | Görüntünün etiketleri. |
|
| Tag | |||
| TagValue | String | Oracle | Görüntünün etiket değeri. |
| TagKey | String | DTS | Görüntünün etiket anahtarı. |
| IsPublic | Boolean | false | Görüntünün genel olarak kullanılabilir olup olmadığını gösterir. Genel olarak kullanılabilir görüntüler arasında Alibaba Cloud tarafından sağlanan genel görüntüler ve topluluk görüntüsü olarak yayınlanan özel görüntüler bulunur. Geçerli değerler:
|
| ImageOwnerId | Long | 1234567890 | Görüntünün ait olduğu Alibaba Cloud hesabının kimliği. Bu parametre yalnızca paylaşılan görüntüleri veya topluluk görüntülerini sorguluyorsanız etkili olur. |
| LoginAsNonRootSupported | Boolean | false | Görüntünün kök olmayan kullanıcıların oturum açmasını destekleyip desteklemediğini gösterir. Geçerli değerler:
|
| SupplierName | String | TestName | Topluluk görüntüsünü yayınlayan tedarikçinin adı. |
| DetectionOptions | Object | Görüntü üzerinde gerçekleştirilen denetimin ayrıntıları. |
|
| Status | String | Processing | Görüntü denetim görevinin durumu. Geçerli değerler:
|
| Items | Array of Item | Denetim öğeleri. |
|
| Item | |||
| Name | String | Nvme | Denetim öğesinin adı. |
| Value | String | Supported | Denetim öğesinin sonucu. |
| RiskLevel | String | High | İçe aktarılan özel görüntünün denetim öğesinin sahip olduğu riskin önem düzeyi. Denetim öğesi risk altındaysa bu parametre döndürülür. Denetim öğesi risk altında değilse bu parametre döndürülmez. Geçerli değerler:
|
| RiskCode | String | NVMe.NotInstalled | Denetim öğesinin sahip olabileceği risk. |
| Features | Object | Görüntünün nitelikleri. |
|
| NvmeSupport | String | supported | Görüntünün Non-Volatile Memory Express (NVMe) protokolünü destekleyip desteklemediğini gösterir. Geçerli değerler:
|
Örnekler
Örnek istekler
http(s)://ecs.aliyuncs.com/?Action=DescribeImages
&RegionId=cn-hangzhou
&PageNumber=1
&PageSize=1
&<Common request parameters>
Başarılı yanıt örnekleri
XML biçimi
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribeImagesResponse>
<TotalCount>1</TotalCount>
<PageSize>1</PageSize>
<RequestId>66189103-EDB2-43E2-BB60-BFF2B62F4EB8</RequestId>
<PageNumber>1</PageNumber>
<Images>
<Image>
<ImageOwnerAlias>self</ImageOwnerAlias>
<IsSelfShared>true</IsSelfShared>
<Description>Archive log for Oracle</Description>
<Platform>Windows Server 2016</Platform>
<ResourceGroupId>rg-bp67acfmxazb4p****</ResourceGroupId>
<Size>60</Size>
<IsSubscribed>false</IsSubscribed>
<BootMode>BIOS</BootMode>
<OSName>Windows Server 2016 Datacenter 64-bit (Simplified Chinese)</OSName>
<IsPublic>false</IsPublic>
<ImageId>m-bp1g7004ksh0oeuc****</ImageId>
<DetectionOptions/>
<Features>
<NvmeSupport>supported</NvmeSupport>
</Features>
<OSNameEn>Windows Server 2016 Data Center Edition 64bit Chinese Edition</OSNameEn>
<Tags>
<Tag>
<TagKey>DTS</TagKey>
<TagValue>Oracle</TagValue>
</Tag>
</Tags>
<LoginAsNonRootSupported>false</LoginAsNonRootSupported>
<Status>Available</Status>
<Progress>100%</Progress>
<Usage>none</Usage>
<Architecture>x86_64</Architecture>
<ProductCode>test000****</ProductCode>
<IsCopied>false</IsCopied>
<ImageFamily>hangzhou-daily-update</ImageFamily>
<IsSupportIoOptimized>true</IsSupportIoOptimized>
<IsSupportCloudinit>true</IsSupportCloudinit>
<ImageName>testImageName</ImageName>
<DiskDeviceMappings>
<DiskDeviceMapping>
<SnapshotId>s-bp17ot2q7x72ggtw****</SnapshotId>
<Type>system</Type>
<Progress>32%</Progress>
<Format>qcow2</Format>
<Device>/dev/xvda</Device>
<Size>60</Size>
<ImportOSSBucket>testEcsImport</ImportOSSBucket>
<ImportOSSObject>imageImport</ImportOSSObject>
</DiskDeviceMapping>
</DiskDeviceMappings>
<ImageVersion>2</ImageVersion>
<OSType>windows</OSType>
<CreationTime>2019-11-15T06:07:05Z</CreationTime>
</Image>
</Images>
<RegionId>cn-hangzhou</RegionId>
</DescribeImagesResponse>
JSON biçimi
HTTP/1.1 200 OK
Content-Type:application/json
{
"TotalCount" : 1,
"PageSize" : 1,
"RequestId" : "66189103-EDB2-43E2-BB60-BFF2B62F4EB8",
"PageNumber" : 1,
"Images" : {
"Image" : [ {
"ImageOwnerAlias" : "self",
"IsSelfShared" : "true",
"Description" : "Archive log for Oracle",
"Platform" : "Windows Server 2016",
"ResourceGroupId" : "rg-bp67acfmxazb4p****",
"Size" : 60,
"IsSubscribed" : false,
"BootMode" : "BIOS",
"OSName": "Windows Server 2016 Datacenter 64-bit (Simplified Chinese)",
"IsPublic" : false,
"ImageId" : "m-bp1g7004ksh0oeuc****",
"DetectionOptions" : { },
"Features" : {
"NvmeSupport" : "supported"
},
"OSNameEn" : "Windows Server 2016 Data Center Edition 64bit Chinese Edition",
"Tags" : {
"Tag" : [ {
"TagKey" : "DTS",
"TagValue" : "Oracle"
} ]
},
"LoginAsNonRootSupported" : false,
"Status" : "Available",
"Progress" : "100%",
"Usage" : "none",
"Architecture" : "x86_64",
"ProductCode" : "test000****",
"IsCopied" : false,
"ImageFamily" : "hangzhou-daily-update",
"IsSupportIoOptimized" : true,
"IsSupportCloudinit" : true,
"ImageName" : "testImageName",
"DiskDeviceMappings" : {
"DiskDeviceMapping" : [ {
"SnapshotId" : "s-bp17ot2q7x72ggtw****",
"Type" : "system",
"Progress" : "32%",
"Format" : "qcow2",
"Device" : "/dev/xvda",
"Size" : "60",
"ImportOSSBucket" : "testEcsImport",
"ImportOSSObject" : "imageImport"
} ]
},
"ImageVersion" : "2",
"OSType" : "windows",
"CreationTime" : "2019-11-15T06:07:05Z"
} ]
},
"RegionId" : "cn-hangzhou"
}
Hata kodları
|
HTTP durum kodu |
Hata kodu |
Hata mesajı |
Açıklama |
|
400 |
InvalidImageOwnerAlias.ValueNotSupported |
The specified ImageOwnerAlias value is not supported. |
Geçersiz ImageOwnerAlias değeri. |
|
400 |
InvalidParamter |
Invalid Parameter. |
Geçersiz parametre değeri. |
|
400 |
InvalidTag.Mismatch |
The specified Tag.n.Key and Tag.n.Value are not match. |
Tag.N.Key ve Tag.N.Value değerleri birbirine karşılık gelmiyor. |
|
400 |
InvalidTagCount |
The specified tags are beyond the permitted range. |
Belirtilen maksimum etiket sayısı aşıldı. |
|
400 |
InvalidInstanceType.ValueNotSupported |
The specified InstanceType does not exist or beyond the permitted range. |
Belirtilen örnek türü bulunamadı veya bu örnek türündeki örnekleri yönetme yetkiniz yok. |
|
403 |
CurrentAccount.NotSupportPublicImage |
Public image is not supported for current account. |
Mevcut hesap genel görüntüleri kullanamaz. |
|
404 |
InvalidFilterKey.NotFound |
The specified Filter Key is not found. |
Geçersiz Filter.N.Key değeri. |
|
404 |
InvalidFilterValue |
The specified Filter Value is not valid. |
Geçersiz Filter.N.Value değeri. |
|
404 |
InvalidUsage |
The specified Usage is not valid. |
Geçersiz Usage değeri. |
|
404 |
InvalidOSType |
The specified OSType is not valid. |
Geçersiz OSType değeri. |
|
404 |
InvalidArchitecture |
The specified Architecture is not valid. |
Geçersiz Architecture değeri. |
|
500 |
InternalError |
The request processing has failed due to some unknown error. |
Dahili bir hata oluştu. Daha sonra tekrar deneyin. |
Hata kodlarının listesi için bkz. Hizmet hata kodları.