Veri yedekleme dosyalarını sorgulama - - Alibaba Cloud Dokümantasyon Merkezi

Not

Veri yedekleme dosyası, yalnızca BackupStatus değeri Success olduğunda verileri geri yüklemek için kullanılabilir.

Hata Ayıklama

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

İstek parametreleri

Parameter	Type	Required	Example	Description
Action	String	Yes	DescribeBackups	Gerçekleştirmek istediğiniz işlem. Değeri DescribeBackups olarak ayarlayın.
DBInstanceId	String	Yes	rm-uf6wjk5xxxxxxx	Örneğin ID'si.
BackupId	String	No	327329803	Veri yedekleme dosyasının ID'si.
BackupStatus	String	No	Success	Veri yedekleme dosyasının durumu. Geçerli değerler: Success Failed
BackupMode	String	No	Automated	Veri yedekleme dosyasının yedekleme modu. Geçerli değerler: Automated Manual
StartTime	String	No	2011-06-01T16:00Z	Sorgulanacak zaman aralığının başlangıcı. Zamanı UTC diliminde yyyy-MM-ddTHH:mmZ biçiminde ISO 8601 standardına göre belirtin.
EndTime	String	No	2011-06-15T16:00Z	Sorgulanacak zaman aralığının bitişi. Bitiş zamanı başlangıç zamanından sonra olmalıdır. Zamanı UTC diliminde yyyy-MM-ddTHH:mmZ biçiminde ISO 8601 standardına göre belirtin.
PageSize	Integer	No	30	Her sayfada döndürülecek kayıt sayısı. Geçerli değerler: 30 50 100 Varsayılan değer: 30.
PageNumber	Integer	No	1	Döndürülecek sayfa numarası. Geçerli değerler: sıfır dışındaki herhangi bir pozitif tamsayı. Varsayılan değer: 1.
BackupType	String	No	FullBackup	Veri yedekleme dosyasının yedekleme türü. Geçerli değerler: FullBackup IncrementalBackup
ResourceGroupId	String	No	rg-acfmy*****	Kaynak grubunun ID'si.

Yanıt parametreleri

Parameter	Type	Example	Description
RequestId	String	1A6D328C-84B8-40DC-BF49-6C73984D7494	İsteğin ID'si.
TotalEcsSnapshotSize	Long	0	Örneğin anlık görüntü zincirinin boyutu. Birim: bayt.
PageRecordCount	String	30	Sayfadaki veri yedekleme dosyası sayısı.
TotalRecordCount	String	100	Döndürülen toplam kayıt sayısı.
PageNumber	String	1	Döndürülen sayfanın numarası.
Items	Array of Backup		Döndürülen veri yedekleme dosyalarının ayrıntılarını içeren dizi.
Backup
StorageClass	String	0	Veri yedekleme dosyasının depolama sınıfı. Geçerli değerler: 0: normal depolama 1: arşiv depolama
Encryption	String	{}	Veri yedekleme dosyasının şifreleme bilgileri.
BackupStatus	String	Success	Veri yedekleme dosyasının durumu.
StoreStatus	String	Disabled	Veri yedekleme dosyasının silinebilip silinemeyeceğini gösterir. Geçerli değerler: Enabled: Veri yedekleme dosyası silinebilir. Disabled: Veri yedekleme dosyası silinemez.
ConsistentTime	Long	1576506856	Veri yedekleme dosyasındaki verilerin tutarlı olduğu zaman noktası. Bu parametrenin dönüş değeri bir zaman damgasıdır. Not Örnek MySQL 5.6 çalıştırıyorsa bir zaman damgası döndürülür. Aksi takdirde 0 değeri döndürülür.
BackupType	String	FullBackup	Veri yedekleme dosyasının yedekleme türü. Geçerli değerler: FullBackup IncrementalBackup
CopyOnlyBackup	String	0	Veri yedekleme dosyasının yedekleme modu. Geçerli değerler: 0: standart mod. Bu mod, tam yedeklemeleri ve artımlı yedeklemeleri destekler. 1: kopyalama-only modu. Bu mod yalnızca tam yedeklemeleri destekler. Not Bu parametre yalnızca örnek SQL Server çalıştırıyorsa döndürülür.
BackupEndTime	String	2019-02-13T12:20:00Z	Yedekleme görevinin bitiş zamanı. Zaman, yyyy-MM-ddTHH:mmZ biçiminde ISO 8601 standardını izler. Zaman UTC olarak gösterilir.
MetaStatus	String	OK	Tek tek veritabanlarını veya tabloları geri yüklemek için kullanılan veri yedekleme dosyasının durumu. Geçerli değerler: OK: Veri yedekleme dosyası normal. LARGE: Veri yedekleme dosyası anormal derecede büyük sayıda tablo içerir. Tek tek veritabanlarını veya tabloları geri yüklemek için kullanılamaz. EMPTY: Veri yedekleme dosyası başarısız bir yedekleme görevinden oluşturulmuştur. Not Boş bir dize döndürülürse veri yedekleme dosyası tek tek veritabanlarını veya tabloları geri yüklemek için kullanılamaz.
BackupInitiator	String	System	Yedekleme görevini başlatan taraf. Geçerli değerler: System User
BackupIntranetDownloadURL	String	http://rdsbak-hz-v3.oss-cn-hangzhou-internal.aliyuncs.com/xxxxx	Veri yedekleme dosyasını dahili ağ üzerinden indirmek için kullanılan URL. Veri yedekleme dosyası indirilemiyorsa null döndürülür. Not Örneğin örnek SQL Server çalıştırıyorsa ve BackupMethod parametresi Snapshot olarak ayarlanmışsa null döndürülür.
BackupMethod	String	Physical	Veri yedekleme dosyasını oluşturmak için kullanılan yöntem. Geçerli değerler: Logical: mantıksal yedekleme Physical: fiziksel yedekleme Snapshot: anlık görüntü yedeklemesi
BackupStartTime	String	2019-02-03T12:20:00Z	Yedekleme görevinin başlangıç zamanı. Zaman, yyyy-MM-ddTHH:mmZ biçiminde ISO 8601 standardını izler. Zaman UTC olarak gösterilir.
BackupDownloadURL	String	http://rdsbak-hz-v3.oss-cn-hangzhou.aliyuncs.com/xxxxx	Veri yedekleme dosyasını İnternet üzerinden indirmek için kullanılan URL. Veri yedekleme dosyası indirilemiyorsa null döndürülür. Not Örneğin örnek SQL Server çalıştırıyorsa ve BackupMethod parametresi Snapshot olarak ayarlanmışsa null döndürülür.
IsAvail	Integer	1	Veri yedekleme dosyasının kullanılabilir olup olmadığını gösterir. Geçerli değerler: 0: Veri yedekleme dosyası kullanılamıyor. 1: Veri yedekleme dosyası kullanılabilir.
BackupId	String	321020562	Veri yedekleme dosyasının ID'si.
HostInstanceID	String	5882781	Veri yedekleme dosyasını oluşturan örneğin numarası. Bu parametre, veri yedekleme dosyasını oluşturan örneğin birincil mi yoksa ikincil mi olduğunu belirtmek için kullanılır.
BackupSize	Long	2167808	Veri yedekleme dosyasının boyutu. Birim: bayt.
BackupMode	String	Automated	Veri yedekleme dosyasının yedekleme modu. Geçerli değerler: Automated Manual
DBInstanceId	String	rm-uf6wjk5xxxxxxx	Örneğin ID'si.
Checksum	String	1835830439**********	Sağlama toplamı. Bu parametrenin değeri CRC64 algoritması kullanılarak hesaplanır.
BackupDownloadLinkByDB	Array of BackupDownloadLinkByDB		Tek tek veritabanının veri yedekleme dosyasını indirebileceğiniz URL.
BackupDownloadLinkByDB
IntranetDownloadLink	String	https://cn-hangzhou-internal.bak.rds.aliyuncs.com/custins53664665/hins18676859_2021072909473127987849.zip?Expires=*****&dbList=tb1	Veri yedekleme dosyasını indirebileceğiniz dahili URL.
DataBase	String	dbs	Veritabanının adı.
DownloadLink	String	https://cn-hangzhou.bak.rds.aliyuncs.com/custins53664665/hins18676859_2021072909473127987849.zip?Expires=*****&dbList=tb1	Veri yedekleme dosyasını indirebileceğiniz genel URL.
ResourceGroupId	String	rg-acfmy*****	Kaynak grubunun ID'si.

Örnekler

Örnek istekler

http(s)://rds.aliyuncs.com/?Action=DescribeBackups
&DBInstanceId=rm-uf6wjk5xxxxxxx
&<Common request parameters>

Örnek başarılı yanıtlar

XML formatı

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

<DescribeBackupsResponse>
    <TotalRecordCount>100</TotalRecordCount>
    <TotalEcsSnapshotSize>0</TotalEcsSnapshotSize>
    <PageRecordCount>30</PageRecordCount>
    <RequestId>1A6D328C-84B8-40DC-BF49-6C73984D7494</RequestId>
    <PageNumber>1</PageNumber>
    <Items>
        <Backup>
            <BackupMethod>Physical</BackupMethod>
            <BackupInitiator>System</BackupInitiator>
            <StorageClass>0</StorageClass>
            <BackupIntranetDownloadURL>http://rdsbak-hz-v3.oss-cn-hangzhou-internal.aliyuncs.com/xxxxx</BackupIntranetDownloadURL>
            <BackupSize>2167808</BackupSize>
            <BackupMode>Automated</BackupMode>
            <BackupId>321020562</BackupId>
            <IsAvail>1</IsAvail>
            <Encryption>{}</Encryption>
            <HostInstanceID>5882781</HostInstanceID>
            <StoreStatus>Disabled</StoreStatus>
            <BackupDownloadURL>http://rdsbak-hz-v3.oss-cn-hangzhou.aliyuncs.com/xxxxx</BackupDownloadURL>
            <DBInstanceId>rm-uf6wjk5xxxxxxx</DBInstanceId>
            <CopyOnlyBackup>0</CopyOnlyBackup>
            <BackupEndTime>2019-02-13T12:20:00Z</BackupEndTime>
            <ConsistentTime>1576506856</ConsistentTime>
            <BackupStartTime>2019-02-03T12:20:00Z</BackupStartTime>
            <MetaStatus>OK</MetaStatus>
            <BackupType>FullBackup</BackupType>
            <BackupStatus>Success</BackupStatus>
            <BackupDownloadLinkByDB>
                <BackupDownloadLinkByDB>
                    <DownloadLink>https://cn-hangzhou.bak.rds.aliyuncs.com/custins53664665/hins18676859_2021072909473127987849.zip?Expires=*****&amp;dbList=tb1</DownloadLink>
                    <IntranetDownloadLink>https://cn-hangzhou-internal.bak.rds.aliyuncs.com/custins53664665/hins18676859_2021072909473127987849.zip?Expires=*****&amp;dbList=tb1</IntranetDownloadLink>
                    <DataBase>dbs</DataBase>
                </BackupDownloadLinkByDB>
            </BackupDownloadLinkByDB>
        </Backup>
    </Items>
</DescribeBackupsResponse>

JSON formatı

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

{
  "DescribeBackupsResponse" : {
    "TotalRecordCount" : 100,
    "TotalEcsSnapshotSize" : 0,
    "PageRecordCount" : 30,
    "RequestId" : "1A6D328C-84B8-40DC-BF49-6C73984D7494",
    "PageNumber" : 1,
    "Items" : {
      "Backup" : {
        "BackupMethod" : "Physical",
        "BackupInitiator" : "System",
        "StorageClass" : 0,
        "BackupIntranetDownloadURL" : "http://rdsbak-hz-v3.oss-cn-hangzhou-internal.aliyuncs.com/xxxxx",
        "BackupSize" : 2167808,
        "BackupMode" : "Automated",
        "BackupId" : 321020562,
        "IsAvail" : 1,
        "Encryption" : "{}",
        "HostInstanceID" : 5882781,
        "StoreStatus" : "Disabled",
        "BackupDownloadURL" : "http://rdsbak-hz-v3.oss-cn-hangzhou.aliyuncs.com/xxxxx",
        "DBInstanceId" : "rm-uf6wjk5xxxxxxx",
        "CopyOnlyBackup" : 0,
        "BackupEndTime" : "2019-02-13T12:20:00Z",
        "ConsistentTime" : 1576506856,
        "BackupStartTime" : "2019-02-03T12:20:00Z",
        "MetaStatus" : "OK",
        "BackupType" : "FullBackup",
        "BackupStatus" : "Success",
        "BackupDownloadLinkByDB" : {
          "BackupDownloadLinkByDB" : {
            "DownloadLink" : "https://cn-hangzhou.bak.rds.aliyuncs.com/custins53664665/hins18676859_2021072909473127987849.zip?Expires=*****&amp;dbList=tb1",
            "IntranetDownloadLink" : "https://cn-hangzhou-internal.bak.rds.aliyuncs.com/custins53664665/hins18676859_2021072909473127987849.zip?Expires=*****&amp;dbList=tb1",
            "DataBase" : "dbs"
          }
        }
      }
    }
  }
}

Hata kodları

Hata kodlarının listesi için API Hata Merkezi adresini ziyaret edin.