DescribeSnapshots - - Alibaba Cloud Dokümantasyon Merkezi

Kullanım notları

Sorgulamak için InstanceId, DiskId ve SnapshotIds gibi birden fazla istek parametresi belirtebilirsiniz. Belirtilen parametreler arasında mantıksal VE ilişkisi bulunur. Filtreleme koşullarına yalnızca belirtilen parametreler dahil edilir.

API işlemini çağırmak için Alibaba Cloud CLI kullanırken farklı veri türlerine sahip istek parametre değerlerini gerekli biçimlerde belirtmeniz gerekir. Daha fazla bilgi için bkz. Parametre biçimine genel bakış.

Hata ayıklama

OpenAPI Explorer imza değerini otomatik olarak hesaplar. Kolaylık sağlaması açısından bu işlemi OpenAPI Explorer'da çağırmanızı öneririz. OpenAPI Explorer, farklı SDK'lar için örnek kodu dinamik olarak oluşturur.

İstek parametreleri

Parameter	Type	Required	Example	Description
Action	String	Yes	DescribeSnapshots	Gerçekleştirmek istediğiniz işlem. Değeri DescribeSnapshots olarak ayarlayın.
InstanceId	String	No	i-bp67acfmxazb4p****	Örnek kimliği.
DiskId	String	No	d-bp67acfmxazb4p****	Disk kimliği.
SnapshotLinkId	String	No	sl-bp1grgphbcc9brb5****	Anlık görüntü zinciri kimliği.
RegionId	String	Yes	cn-hangzhou	Diske ait bölge kimliği. En güncel bölge listesini sorgulamak için DescribeRegions işlemini çağırabilirsiniz.
SnapshotIds	String	No	["s-bp67acfmxazb4p**", "s-bp67acfmxazb5p", ... "s-bp67acfmxazb6p**"]	Anlık görüntü kimlikleri. Değer, en fazla 100 anlık görüntü kimliğinden oluşan bir JSON dizisi olabilir. Anlık görüntü kimliklerini virgül (,) ile ayırın.
PageNumber	Integer	No	1	Sayfa numarası. Sayfalama 1. sayfadan başlar. Varsayılan değer: 1.
PageSize	Integer	No	10	Sayfa başına giriş sayısı. Maksimum değer: 100. Varsayılan değer: 10.
NextToken	String	No	caeba0bbb2be03f84eb48b699f0a4883	Sonuçların yeni bir sayfasını almak için bu istekte kullanılan sayfalama belirteci. İlk istek için bu parametreyi belirtmeniz gerekmez. NextToken değeri olarak önceki sorgudan elde edilen belirteci belirtmeniz gerekir.
MaxResults	Integer	No	10	Sayfa başına maksimum giriş sayısı. Maksimum değer: 100. Varsayılan değer: 10.
SnapshotName	String	No	testSnapshotName	Anlık görüntü adı.
Status	String	No	all	Anlık görüntünün durumu. Geçerli değerler: progressing: Anlık görüntü oluşturuluyor. accomplished: Anlık görüntü oluşturuldu. failed: Anlık görüntü oluşturulamadı. all (varsayılan): Bu değer tüm anlık görüntü durumlarını gösterir.
SnapshotType	String	No	all	Anlık görüntü türü. Geçerli değerler: auto: otomatik anlık görüntü user: manuel anlık görüntü all (varsayılan): tüm anlık görüntü türleri
Filter.1.Key	String	No	CreationStartTime	Kaynakları sorgulamak için kullanılan 1. filtrenin anahtarı. Değeri `CreationStartTime` olarak ayarlayın. Hem `Filter.1.Key` hem de `Filter.1.Value` parametrelerini belirterek belirli bir zamandan sonra oluşturulan kaynakları sorgulayabilirsiniz.
Filter.2.Key	String	No	CreationEndTime	Kaynakları sorgulamak için kullanılan 2. filtrenin anahtarı. Değeri `CreationEndTime` olarak ayarlayın. Hem `Filter.2.Key` hem de `Filter.2.Value` parametrelerini belirterek belirli bir zamandan önce oluşturulan kaynakları sorgulayabilirsiniz.
Filter.1.Value	String	No	2019-12-13T17:00Z	Kaynakları sorgulamak için kullanılan 1. filtrenin değeri. Değeri bir zaman damgası olarak ayarlayın. Bu parametreyi belirtirseniz `Filter.1.Key` parametresini de belirtmeniz gerekir. Zaman damgasını `yyyy-MM-ddTHH:mmZ` biçiminde belirtin. Saat UTC cinsinden olmalıdır.
Filter.2.Value	String	No	2019-12-13T22:00Z	Kaynakları sorgulamak için kullanılan 2. filtrenin değeri. Değeri bir zaman damgası olarak ayarlayın. Bu parametreyi belirtirseniz `Filter.2.Key` parametresini de belirtmeniz gerekir. Zaman damgasını `yyyy-MM-ddTHH:mmZ` biçiminde belirtin. Saat UTC cinsinden olmalıdır.
Usage	String	No	none	Anlık görüntünün görüntü veya disk oluşturmak için kullanılıp kullanılmadığını belirtir. Geçerli değerler: image: Anlık görüntü özel görüntüler oluşturmak için kullanıldı. disk: Anlık görüntü diskler oluşturmak için kullanıldı. image_disk: Anlık görüntü özel görüntüler ve veri diskleri oluşturmak için kullanıldı. none: Anlık görüntü görüntü veya disk oluşturmak için kullanılmadı.
SourceDiskType	String	No	Data	Anlık görüntünün kaynak disk türü. Geçerli değerler: system: sistem diski data: veri diski Not Bu parametrenin değeri büyük/küçük harfe duyarlı değildir.
Encrypted	Boolean	No	false	Anlık görüntünün şifrelenip şifrelenmediğini belirtir. Varsayılan değer: false.
ResourceGroupId	String	No	rg-bp67acfmxazb4p****	Anlık 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 Varsayılan kaynak grubundaki kaynaklar, bu parametre nasıl ayarlanırsa ayarlansın yanıtta görüntülenir.
DryRun	Boolean	No	false	Gerçek isteği yürütmeden yalnızca kuru çalışma yapılıp yapılmayacağını belirtir. Geçerli değerler: true: Yalnızca kuru çalışma gerçekleştirir. Sistem AccessKey çiftini, RAM kullanıcısının izinlerini ve gerekli parametreleri kontrol eder. İstek kuru çalışmada başarısız olursa bir hata mesajı döndürülür. İstek kuru çalışmayı geçerse DryRunOperation hata kodu döndürülür. false (varsayılan): Kuru çalışma gerçekleştirir ve gerçek isteği yürütür. İstek kuru çalışmayı geçerse 2xx HTTP durum kodu döndürülür ve işlem gerçekleştirilir.
KMSKeyId	String	No	0e478b7a-4262-4802-b8cb-00d3fb40****	Veri diski tarafından kullanılan Key Management Service (KMS) anahtarının kimliği.
Category	String	No	Standard	Anlık görüntü kategorisi. Geçerli değerler: Standard: normal anlık görüntü Flash: yerel anlık görüntü Yerel anlık görüntü özelliği, anında erişim özelliği ile değiştirilmiştir. Bu parametreyi belirtirken aşağıdaki hususlara dikkat edin: 14 Aralık 2020 tarihinden önce yerel anlık görüntüler kullandıysanız bu parametreyi kullanabilirsiniz. 14 Aralık 2020 tarihinden önce yerel anlık görüntüler kullanmadıysanız bu parametreyi kullanamazsınız. Not Bu parametre gelecekte kaldırılacaktır. Gelecekteki uyumluluğu sağlamak için diğer parametreleri kullanmanızı öneririz.
Tag.N.key	String	No	SnapshotTest	Anlık 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 parametresini kullanmanızı öneririz.
Tag.N.Key	String	No	TestKey	Anlık görüntünün N. etiketinin anahtarı. N için geçerli değerler: 1 ila 20. Kaynakları sorgulamak için tek bir etiket belirtilirse bu etiket eklenmiş en fazla 1.000 kaynak döndürülür. Kaynakları sorgulamak için birden çok etiket belirtilirse bu etiketlerin tümü eklenmiş en fazla 1.000 kaynak döndürülür. Belirtilen etiketler eklenmiş 1.000'den fazla kaynağı sorgulamak için ListTagResources işlemini çağırın.
Tag.N.Value	String	No	TestValue	Anlık görüntünün N. etiketinin değeri. N için geçerli değerler: 1 ila 20.
Tag.N.value	String	No	SnapshotTest	Anlık 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.

Yanıt parametreleri

Parameter	Type	Example	Description
NextToken	String	caeba0bbb2be03f84eb48b699f0a4883	Bir sayfalama belirteci. Sonuçların yeni bir sayfasını almak için sonraki istekte kullanılabilir.
PageSize	Integer	10	Sayfa başına giriş sayısı.
PageNumber	Integer	1	Sayfa numarası.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	İstek kimliği.
TotalCount	Integer	1	Döndürülen toplam anlık görüntü sayısı.
Snapshots	Array of Snapshot		Anlık görüntülerle ilgili ayrıntılar.
Snapshot
Status	String	accomplished	Anlık görüntünün durumu. Geçerli değerler: progressing accomplished failed
CreationTime	String	2020-08-20T14:52:28Z	Anlık görüntünün oluşturulduğu zaman. Zaman, yyyy-MM-ddTHH:mm:ssZ biçiminde ISO 8601 standardını izler. Zaman UTC olarak görüntülenir.
Progress	String	100%	Anlık görüntü oluşturma görevinin ilerleme durumu. Birim: yüzde (%).
InstantAccess	Boolean	false	Anında erişim özelliğinin etkin olup olmadığını gösterir. Geçerli değerler: true: Anında erişim özelliği etkindir. Bu özellik yalnızca Gelişmiş SSD'ler (ESSD) için etkinleştirilebilir. false: Anında erişim özelliği devre dışıdır. Anlık görüntü, anında erişim özelliği devre dışı bırakılmış normal bir anlık görüntüdür.
Available	Boolean	false	Anlık görüntünün disk oluşturmak veya geri yüklemek için kullanılıp kullanılamayacağını gösterir. Geçerli değerler: true: Anlık görüntü disk oluşturmak veya geri yüklemek için kullanılabilir. false: Anlık görüntü disk oluşturmak veya geri yüklemek için kullanılamaz.
RemainTime	Integer	38	Anlık görüntünün oluşturulması için kalan süre. Birim: saniye.
SourceDiskSize	String	40	Kaynak diskin kapasitesi. Birim: GiB.
RetentionDays	Integer	30	Otomatik anlık görüntünün saklama süresi.
SourceDiskType	String	system	Kaynak disk türü. Geçerli değerler: system data
SourceStorageType	String	disk	Kaynak disk türü. Not Bu parametre gelecekte kaldırılacaktır. Gelecekteki uyumluluğu sağlamak için diğer parametreleri kullanmanızı öneririz.
Usage	String	image	Anlık görüntünün görüntü veya disk oluşturmak için kullanılıp kullanılmadığını gösterir. Geçerli değerler: image disk image_disk none
LastModifiedTime	String	2020-08-25T14:18:09Z	Anlık görüntünün en son değiştirildiği zaman. Zaman, yyyy-MM-ddTHH:mm:ssZ biçiminde ISO 8601 standardını izler. Zaman UTC olarak görüntülenir.
Encrypted	Boolean	false	Anlık görüntünün şifrelenip şifrelenmediğini gösterir.
SnapshotType	String	all	Anlık görüntü türü. Geçerli değerler: auto veya timer: otomatik anlık görüntü user: manuel anlık görüntü all: tüm anlık görüntü türleri
SourceDiskId	String	d-bp67acfmxazb4ph****	Kaynak disk kimliği. Anlık görüntünün oluşturulduğu kaynak disk serbest bırakıldıktan sonra bile bu parametre korunur.
SnapshotName	String	testSnapshotName	Anlık görüntü adı. Bu parametre yalnızca anlık görüntü oluşturulurken bir anlık görüntü adı belirtildiyse döndürülür.
InstantAccessRetentionDays	Integer	30	Anında erişim özelliğinin süresi. Belirtilen süre dolduğunda anında erişim özelliği otomatik olarak devre dışı bırakılır. Varsayılan olarak bu parametrenin değeri `RetentionDays` değeriyle aynıdır.
Description	String	testDescription	Anlık görüntü açıklaması.
SnapshotId	String	s-bp67acfmxazb4p****	Anlık görüntü kimliği.
ResourceGroupId	String	rg-bp67acfmxazb4p****	Kaynak grubu kimliği.
Category	String	standard	Anlık görüntü kategorisi. Not Bu parametre gelecekte kaldırılacaktır. Gelecekteki uyumluluğu sağlamak için `InstantAccess` parametresini kullanmanızı öneririz.
KMSKeyId	String	0e478b7a-4262-4802-b8cb-00d3fb40****	Veri diski tarafından kullanılan KMS anahtarının kimliği.
SnapshotSN	String	64472-116742336-61976****	Anlık görüntünün seri numarası.
ProductCode	String	jxsc000****	Alibaba Cloud Marketplace görüntüsünün ürün kodu.
SourceSnapshotId	String	s-bp67acfmxazb4p****	Kaynak anlık görüntü kimliği.
SourceRegionId	String	cn-hangzhou	Kaynak anlık görüntünün bölge kimliği.
Tags	Array of Tag		Anlık görüntünün etiketleri.
Tag
TagValue	String	TestValue	Anlık görüntünün etiket değeri.
TagKey	String	TestKey	Anlık görüntünün etiket anahtarı.

Örnekler

Örnek istekler

https://ecs.aliyuncs.com/?Action=DescribeSnapshots
&RegionId=cn-hangzhou
&InstanceId=i-bp67acfmxazb4p****
&DiskId=d-bp67acfmxazb4p****
&SnapshotIds=["s-bp67acfmxazb4p****", "s-bp67acfmxazb5p****", ... "s-bp67acfmxazb6p****"]
&PageNumber=1
&PageSize=10
&SnapshotName=testSnapshotName
&Status=all
&SnapshotType=all
&Usage=none
&SourceDiskType=Data
&Tag.1.Key=TestKey
&Tag.1.Value=TestValue
&Encrypted=false
&DryRun=false
&<Common request parameters>

Örnek başarılı yanıt

XML biçimi

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeSnapshotsResponse>
    <TotalCount>1</TotalCount>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
    <PageSize>10</PageSize>
    <NextToken>caeba0bbb2be03f84eb48b699f0a4883</NextToken>
    <PageNumber>1</PageNumber>
    <Snapshots>
        <Snapshot>
            <Status>accomplished</Status>
            <InstantAccess>false</InstantAccess>
            <Progress>100%</Progress>
            <Available>false</Available>
            <Usage>image</Usage>
            <Description>testDescription</Description>
            <Category>standard</Category>
            <KMSKeyId>0e478b7a-4262-4802-b8cb-00d3fb40****</KMSKeyId>
            <ProductCode>jxsc000****</ProductCode>
            <Encrypted>false</Encrypted>
            <SnapshotName>testSnapshotName</SnapshotName>
            <SourceDiskId>d-bp67acfmxazb4ph****</SourceDiskId>
            <SourceStorageType>disk</SourceStorageType>
            <SnapshotId>s-bp67acfmxazb4p****</SnapshotId>
            <SnapshotSN>64472-116742336-61976****</SnapshotSN>
            <SourceDiskSize>40</SourceDiskSize>
            <CreationTime>2020-08-20T14:52:28Z</CreationTime>
            <LastModifiedTime>2020-08-25T14:18:09Z</LastModifiedTime>
            <SnapshotType>all</SnapshotType>
            <SourceDiskType>system</SourceDiskType>
            <Tags>
            </Tags>
        </Snapshot>
    </Snapshots>
</DescribeSnapshotsResponse>

JSON biçimi

HTTP/1.1 200 OK
Content-Type:application/json

{
  "TotalCount" : 1,
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "PageSize" : 10,
  "NextToken" : "caeba0bbb2be03f84eb48b699f0a4883",
  "PageNumber" : 1,
  "Snapshots" : {
    "Snapshot" : [ {
      "Status" : "accomplished",
      "InstantAccess" : false,
      "Progress" : "100%",
      "Available" : "false",
      "Usage" : "image",
      "Description" : "testDescription",
      "Category" : "standard",
      "KMSKeyId" : "0e478b7a-4262-4802-b8cb-00d3fb40****",
      "ProductCode" : "jxsc000****",
      "Encrypted" : false,
      "SnapshotName" : "testSnapshotName",
      "SourceDiskId" : "d-bp67acfmxazb4ph****",
      "SourceStorageType" : "disk",
      "SnapshotId" : "s-bp67acfmxazb4p****",
      "SnapshotSN" : "64472-116742336-61976****",
      "SourceDiskSize" : 40,
      "CreationTime" : "2020-08-20T14:52:28Z",
      "LastModifiedTime" : "2020-08-25T14:18:09Z",
      "SnapshotType" : "all",
      "SourceDiskType" : "system",
      "Tags" : {
        "Tag" : [ ]
      }
    } ]
  }
}

Hata kodları

HTTP status code	Error code	Error message	Description
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.	Maksimum etiket sayısı aşıldı.
403	InvalidSnapshotIds.Malformed	The amount of specified specified snapshot Ids exceeds the limit.	Geçersiz SnapshotIds biçimi.
403	InvalidSnapshotCategory.Malformed	The specified Category is not valid.	Geçersiz Category değeri.
404	InvalidFilterKey.NotFound	The specified FilterKey is not found.	Filtre anahtarı bulunamadı.
404	InvalidFilterValue	The specified FilterValue exceeds the limit.	Geçersiz filtre değeri.
404	InvalidUsage	The specifed Usage is not valid.	Geçersiz Usage değeri.
404	InvalidStatus.NotFound	The specified Status is not found.	Geçersiz Status değeri.
404	InvalidSnapshotLinkId.NotFound	The specified snapshot link is not found.	SnapshotLinkId değeri bulunamadı.
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ı.