Tüm Ürünler
Search

Bu Ürün

    :CreateBackup

    Belge Merkezi

    :CreateBackup

    Son Güncelleme:Oct 02, 2026

    Bir RDS örneği için yedekleme kümesi oluşturur.

    Operation description

    Desteklenen motorlar

    • RDS MySQL

    • RDS PostgreSQL

    • RDS SQL Server

    • RDS MariaDB

    İşlev

    Bu API, yerleşik RDS yedekleme API'sini sarmalar. DBS'yi de kullanabilirsiniz. Daha fazla bilgi için DBS API'sine genel bakış konusuna bakın.

    Ön koşullar

    Örnek aşağıdaki koşulları karşılamadığı sürece API çağrısı başarısız olur.

    • Örnek çalışıyor durumda olmalıdır.

    • Devam eden bir yedekleme görevi bulunmamalıdır.

    • Bir örnek için günde en fazla 20 yedekleme kümesi oluşturabilirsiniz.

    İlgili belgeler

    Try it now

    Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

    Test

    RAM authorization

    The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

    • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

    • API: The API that you can call to perform the action.

    • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

    • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

      • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

      • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

    • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

    • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    rds:CreateBackup

    create

    *DBInstance.

    acs:rds:{#regionId}:{#accountId}:dbinstance/{#dbinstanceId}
    • rds:ResourceTag
    • rds:ResourceTag
    • rds:ResourceTag
    		 None

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    DBInstanceId

    string

    Yes

    Örneğin kimliği. Bu kimliği almak için DescribeDBInstances işlemini çağırın.

    rm-uf6wjk5****
    DBName

    string

    No

    Yedeklenecek veritabanlarının adları. Birden fazla veritabanı adını virgül (,) ile ayırın.

    Not

    Bu parametre yalnızca BackupStrategy parametresi db olarak ayarlandığında geçerlidir.

    rds_mysql
    BackupStrategy

    string

    No

    Yedekleme stratejisi. Geçerli değerler:

    • db: veritabanı yedeklemesi

    • instance: örnek yedeklemesi

    Not

    Bu parametre yalnızca aşağıdaki koşullardan biri karşılandığında geçerlidir:

    • MySQL örneği için BackupMethod parametresi Logical olarak ayarlanmıştır.

    • SQL Server örneği için BackupType parametresi FullBackup olarak ayarlanmıştır.

    db
    BackupMethod

    string

    No

    Yedekleme türü. Geçerli değerler:

    • Logical: mantıksal yedekleme (yalnızca yerel disk kullanan MySQL örnekleri için desteklenir).

    • Physical: fiziksel yedekleme (yerel disk kullanan MySQL örnekleri, SQL Server ve PostgreSQL örnekleri için desteklenir).

    • Snapshot: anlık görüntü (bulut diski kullanan MySQL örnekleri, SQL Server, PostgreSQL ve MariaDB örnekleri için desteklenir).

    Varsayılan değer: Physical.

    Not

    • Mantıksal yedekleme için veritabanı boş olmamalıdır.

    • MariaDB örnekleri yalnızca anlık görüntüleri destekler. Ancak MariaDB örnekleri için bu parametreyi Physical olarak ayarlamanız gerekir.

    Physical
    BackupType

    string

    No

    SQL Server örneği için yedekleme türü. Geçerli değerler:

    • Auto (Varsayılan): Sistem, tam yedekleme mi yoksa artımlı yedekleme mi yapılacağını otomatik olarak belirler.

    • FullBackup: Tam yedekleme.

    Not

    Bu parametre yalnızca BackupMethod parametresi Physical olarak ayarlandığında geçerlidir.

    Auto
    BackupRetentionPeriod

    integer

    No

    • SQL Server: Yedekleme kümesinin saklanacağı gün sayısı. Bu parametre yalnızca BackupStrategy değeri db, BackupMethod değeri Physical ve BackupType değeri FullBackup olarak ayarlandığında geçerlidir. Geçerli değerler: 7 ile 730 arası. -1 değeri uzun süreli saklamayı belirtir.

    • MySQL: Yedekleme kümesinin saklanacağı gün sayısı. Geçerli değerler: 7 ile 730 arası. -1 değeri uzun süreli saklamayı belirtir.

    7

    İsteğe bağlı parametreler

    Bu API dört isteğe bağlı parametre kabul eder: BackupMethod, BackupStrategy, BackupType ve DBName. Gerekli parametre kombinasyonu motora ve kullanım senaryonuza bağlıdır.

    MySQL

    • Fiziksel ve anlık görüntü yedeklemeleri için yalnızca BackupMethod parametresini belirtin. Varsayılan olarak tüm veritabanları yedeklenir. Tek veritabanı yedeklemeleri desteklenmez.

    • Mantıksal yedeklemeler için:

      • Tek bir veritabanını yedeklemek için BackupMethod, BackupStrategy ve DBName parametrelerini belirtin.

      • Örneğin tamamını yedeklemek için BackupMethod ve BackupStrategy parametrelerini belirtin.

    SQL Server

    • Anlık görüntü yedeklemeleri için yalnızca BackupMethod parametresini belirtin. Varsayılan olarak tüm veritabanları yedeklenir. Tek veritabanı yedeklemeleri desteklenmez.

    • Fiziksel yedeklemeler için:

      • Tek bir veritabanının tam yedeklemesi için dört isteğe bağlı parametrenin tamamını belirtin: BackupMethod, BackupStrategy, BackupType ve DBName.

      • Örneğin tamamının tam yedeklemesini gerçekleştirmek için BackupMethod, BackupType ve BackupStrategy parametrelerini belirtin.

      • Sistemin tam veya artımlı yedekleme arasında otomatik olarak seçim yapmasını sağlamak için BackupMethod ve BackupType parametrelerini belirtin.

    • Mantıksal yedeklemeler desteklenmez.

    PostgreSQL

    • Fiziksel ve anlık görüntü yedeklemeleri için yalnızca BackupMethod parametresini belirtin. Varsayılan olarak tüm veritabanları yedeklenir. Tek veritabanı yedeklemeleri desteklenmez.

    • Mantıksal yedeklemeler desteklenmez.

    MariaDB

    • Anlık görüntü yedeklemeleri için yalnızca BackupMethod parametresini belirtin. Varsayılan olarak tüm veritabanları yedeklenir. Tek veritabanı yedeklemeleri desteklenmez.

    • Fiziksel ve mantıksal yedeklemeler desteklenmez.

    Response elements

    Element

    Type

    Description

    Example

    object

    Yanıt verileri.

    BackupJobId

    string

    Yedekleme işi kimliği.

    507****
    RequestId

    string

    İstek kimliği.

    2C125605-266F-41CA-8AC5-3A643D4F42C5

    Examples

    Success response

    JSON format

    {
  "BackupJobId": "507****",
  "RequestId": "2C125605-266F-41CA-8AC5-3A643D4F42C5"
}

    Error codes

    HTTP status code

    Error code

    Error message

    Description
    400 BackupType.NotSupport the specified backup type not support Belirtilen yedekleme türü desteklenmiyor.
    400 InvalidBackupMethod.ValueNotSupport The specified parameter "BackupMethod" is not valid. Yedekleme yöntemi geçersiz. Geçerli bir yedekleme yöntemi seçin. Yedekleme yöntemleri mantıksal yedekleme (Logical) ve fiziksel yedeklemeyi (Physical) içerir. Varsayılan değer Physical. Mantıksal yedekleme, veritabanı olmayan örnekleri desteklemez. SQL Server yalnızca fiziksel yedeklemeyi destekler.
    400 ReadDBInstanceNotSupport The operation is not permitted due to type of the instance. Salt okunur örneklerde bu işleme izin verilmiyor.
    400 IncorrectDBInstanceLockMode.ValueNotSupported The Current DB instance lock mode does not support this operation. İşlem başarısız oldu. Veritabanı örneğinin mevcut kilit modu bu işlemi desteklemiyor.
    400 BackupJobExists A backup job already exists in the specified DB instance. Yedekleme zaten mevcut.
    400 InvalidPreferredBackupTime.Format Specified preferred backup time is not valid. Beklenen yedekleme tarihi biçimi geçersiz. Biçim standart GMT biçiminde olmalıdır: YYYY-MM-DDThh:mmZ. Örnek: 2012-06-11T15:00Z.
    400 InvalidDBName.Format Specified DB name is not valid. Veritabanı adı geçersiz. Veritabanını yeniden adlandırın. Veritabanı adı küçük harf, rakam ve alt çizgiden (_) oluşmalı, bir harfle başlamalı, bir harf veya rakamla bitmeli ve uzunluğu en fazla 16 karakter olmalıdır.
    400 Order.ComboInstanceNotAllowOperate A package instance is not allowed to operate independently. Paketteki örnekler üzerinde ayrı ayrı işlem yapılamaz.
    400 Price.PricingPlanResultNotFound Pricing plan price result not found. Fiyatlandırma planı sonucu bulunamadı.
    400 Order.NoRealNameAuthentication You have not passed the real-name authentication and do not meet the purchase conditions. Please log in to the user center for real-name authentication. Gerçek ad doğrulamasını tamamlamadınız ve satın alma işlemi yapma uygunluğuna sahip değilsiniz. Gerçek ad doğrulamasını tamamlamak için Giderler ve Maliyetler'de oturum açın.
    400 InsufficientAvailableQuota Your account quota limit is less than 0, please recharge before trying to purchase. Hesap bakiyeniz 0'dan azdır. Satın alma işlemi yapmadan önce hesabınıza bakiye yükleyin.
    400 CommodityServiceCalling.Exception Failed to call commodity service. Ticari hizmet çağrısı başarısız oldu.
    400 RegionDissolvedEOM Dear customer, Alibaba Cloud plans to optimize and adjust the current region. Cloud services in this region will cease operations. You are currently unable to operate new purchase orders. Thank you for your understanding and support. Alibaba Cloud, mevcut bölgeyi optimize etmeyi ve ayarlamayı planlamaktadır. Bu bölgedeki bulut hizmetleri operasyonlarını sonlandıracaktır. İş sürekliliğinizi ve sorunsuz bir veri geçişini sağlamak için şu anda yeni satın alma siparişleri veremezsiniz. Anlayışınız ve desteğiniz için teşekkür ederiz.
    400 Commodity.InvalidComponent The module you purchased is not legal, please buy it again. Satın aldığınız modül geçersiz. Modülü yeniden satın alın.
    400 RegionEndTimeDissolvedAustralia Cloud services in the Australia (Sydney) region will be discontinued. Set the validity date to September 30, 2024 or earlier than September 30, 2024. Belirtilen bölge kullanımdan kaldırılmıştır.
    400 Price.CommoditySys Commodity system call exception. Ticari sistem çağrılırken bir istisna oluştu.
    400 Pay.InsufficientBalance Insufficient available balance. Mevcut hesap bakiyesi 100'den az. Satın alma işlemi yapmadan önce hesabınıza bakiye yükleyin.
    400 Order.PeriodInvalid There is a problem with the period you selected, please choose again. Seçilen abonelik süresi geçersiz. Farklı bir abonelik süresi seçin.
    400 pay.noCreditCard Account not bound to credit card.
    400 Order.InstHasUnpaidOrder There is an unpaid order for the service you have purchased. Please pay or void it before placing the order. Seçtiğiniz hizmet için ödenmemiş bir sipariş mevcut. Yeni bir sipariş vermeden önce mevcut siparişi ödeyin veya iptal edin.
    400 noAvailablePaymentMethod No payment method is specified for your account. We recommend that you add a payment method.
    400 BasicInfoUncompleted Your information is incomplete. Complete your information before the operation. Bilgileriniz eksik. Devam etmeden önce bilgilerinizi tamamlayın.
    400 Risk.RiskControlRejection Your account is abnormal, please contact customer service for details. Hesabınızda bir istisna durumu bulunmaktadır. Ayrıntılar için müşteri hizmetleriyle iletişime geçin.
    400 Api.NotSupport Specified api is not supported. Mevcut işlem desteklenmez.
    400 ContainForbiddenLabelError There is a label that prohibits placing orders. Please contact your distributor for assistance. Siparişi engelleyen bir etiket mevcut. Bu sorunu çözmek için distribütörünüzle iletişime geçin.
    400 InvalidDBInstanceId.NotFound The DBInstanceId provided does not exist in records. Belirtilen örnek mevcut değil. Örneğin var olup olmadığını ve silinmemiş olduğunu kontrol edin.
    400 InvalidInstanceLevel.DiskType Specified instance level not support request disk type Mevcut örnek türü bu depolama türünü desteklememektedir.
    400 InvalidParam Sepcified wal level Parameter is invalid. There are still logical slots in instance, so it can not be set as replica. İşlem başarısız oldu. Parametre geçersiz.
    400 KmsApiError User secret key invalid. Kullanıcı anahtarı geçersiz.
    400 System.SaleValidateFailed Sales expression validation system error. İstek geçerli bir abonelik süresi içermiyor. Period veya UsedTime parametresini kontrol edin.
    400 Abs.InvalidAccount.NotFound account is not found. Hesap mevcut değil.
    400 SqlExecuteFailedOrTimeout sql command execution failed or timed out:%s. SQL komutu yürütülemedi veya zaman aşımına uğradı.
    400 ColdData.EngineVersionNotSupport The current instance engine version not support coldDataEnabled. Mevcut örnek DPI motoru sürümü soğuk veri arşivlemeyi desteklemez.
    400 ColdData.MinorVersionNotSupport The current instance minor version not support coldDataEnabled. Mevcut çekirdek sürümü soğuk veri arşivlemeyi desteklemez.
    400 IncorrectTargetClasscode The current instance type does not support this operation. Mevcut örnek türü bu işlemi desteklemez.
    400 InvalidConnectionString.Duplicate Specified connection string already exists in the RDS. Bağlantı adresi adı yineleniyor. Farklı bir bağlantı dizesi belirtin.
    400 RequiredParam.NotFound Required input param is not found. Gerekli bir parametre eksik.
    400 Parameters.Invalid Parameter error, please check the parameters. Parametre geçersiz. Parametreleri kontrol edin.
    400 BackupPolicyNotSupport Cold Data won't open with CrossBackup or Flash Backup, please check Backup Policy. Soğuk veri arşivleme, bölgeler arası yedeklemeyi veya yüksek frekanslı anlık görüntü yedeklemesini desteklemez. Yedekleme politikasını kontrol edin.
    400 InvalideStatus.Format The instance status does not support this operation. Örnek durumu bu işlemi desteklemiyor.
    400 InvalidReleasedKeepPolicy.Format Specified Released Keep Policy is not valid. Örnek serbest bırakıldıktan sonraki arşivlenmiş yedek veri saklama politikası geçersiz.
    400 InvalidDBInstanceEngineType.Format the DB instance engine type does not support this operation. Örneğin veritabanı motoru türü bu işlemi desteklemez.
    400 Pay.NoCreditCard No credit cards. Hesap bir kredi kartına bağlı değil.
    400 VpcNetworkTypeNotSupport The vpc network type instance does not support this operation. Bu işlem, VPC ağ türündeki örnekler için desteklenmez.
    400 MirrorInsExists Specified DB instance mirror ins already existed. Veritabanı örneği görüntüsü zaten mevcut.
    400 UnsupportedClassCode The specified DB instance class stops selling. Örnek türü artık satın alıma sunulmamaktadır.
    400 InvalidBackupSet The specified database does not exist in the backup set. Belirtilen veritabanı yedekleme kümesinde mevcut değil.
    400 OrdTCommodityQueryError Failed to query for product. Ürün sorgulanamadı.
    400 ProductInstanceReleased The instance has been released. Please check before placing the order. Örnek serbest bırakılmıştır. Sipariş vermeden önce örneği doğrulayın.
    400 RegionEndTimeDissolvedIndia The region is no longer supported. Belirtilen bölge kullanımdan kaldırılmıştır.
    500 ExternalFailure The request processing has failed due to external service failure. İstek başarısız oldu. Daha sonra tekrar deneyin.
    500 RequestMetaDataFailed The service request failed. Please try again later or contact service personnel. İstek başarısız oldu. Daha sonra tekrar deneyin veya teknik destek ile iletişime geçin.
    500 InvokeProxyFailure The request processing has failed due to service failure of rds api. İstek, RDS API hizmetindeki bir hata nedeniyle başarısız oldu.
    403 OperationDenied.ApiForbidden operation not permitted. Mevcut işleme izin verilmiyor.
    403 IncorrectDBInstanceEngine Current DB Instance engine does not support this operation. İşlem başarısız oldu. Mevcut veritabanı motoru desteklenmiyor.
    403 IncorrectDBInstanceType Current DB instance engine and type does not support operations. İşlem başarısız oldu. Mevcut veritabanı örneği motoru ve türü desteklenmiyor.
    403 IncorrectDBInstanceState Current DB instance state does not support this operation. İşlem başarısız oldu. Mevcut örnek durumu bu işlemi desteklemiyor. Daha sonra tekrar deneyin.
    403 IncorrectDBInstanceCharacterType Current DB Instance character_type does not support this operation. Bu işlem, DB örneğinin mevcut karakter türü için desteklenmez.
    403 Exceeded.BackupTimes The backup times exceeds. Belirtilen BackupTimes bilgisi geçersiz.
    403 OrderStatus.UnPaid The specified db instance has unpaid order. Örneğin ödenmemiş bir siparişi var. Siparişi ödeyin ve tekrar deneyin.
    403 InvalidReduceDiskSize The storage capacity after the scale-down must be larger than the used amount. Ölçek küçültme için hedef kapasite, mevcut depolama kullanımından az olamaz.
    403 CloudSSDNotSupport Cloud ssd does not support this operation, please upgrade to essd. SSD bulut diskleri bu işlemi desteklemez. ESSD'ye yükseltin.
    403 InvalidUserOperatorPermission The user permission does not support this operation. Kullanıcı izinleri bu işlemi desteklemez.
    403 InvalidVswitchId Specified conn vswitch id is not valid. Belirtilen VSwitchId geçersiz bir formatta veya boş.
    403 IncorrectMinorVersion Current engine minor version does not support operations. Mevcut alt motor sürümü bu işlemi desteklemiyor.
    403 OperationDenied.ZoneResource There is no available zone for inventory. Kullanılabilir stok bölgesi bulunmuyor.
    403 NotInFlowController Sorry,no permission. Bu işlem, kurumsal olmayan bulut kullanıcıları için kullanılamaz. Gerekli izinlere sahip değilsiniz.
    403 InvalidKmsKey Kms key is disabled. KMS anahtarı devre dışı.
    403 InvalidInstanceLevel.Malformed Current DB instance level does not support this operation. İşlem başarısız oldu. Belirtilen teknik özellik kodu, belirtilen uç nokta sayısını desteklememektedir. Parça sayısını ve mevcut uç nokta sayısını kontrol edin.
    404 InvalidDBInstanceName.NotFound The database instance does not exist. Belirtilen örnek kimliği mevcut değil. Örnek kimliğini doğrulayın ve tekrar deneyin.
    404 InvalidDB.NotFound Specified db does not exist or DB status does not support this operation. İşlem başarısız oldu. Veritabanı bulunmuyor veya veritabanı durumu bu işlemi desteklemiyor. Veritabanı bilgilerini kontrol edin ve veritabanının mevcut olduğundan ve Çalışıyor durumunda olduğundan emin olun.
    404 InvalidClusterKms The current instance does not authorized to access the Key Management Service. Mevcut örneğin Key Management Service'e erişim yetkisi bulunmuyor.
    404 Request.NotFound The requested resource is not available. İstenen kaynak kullanılamıyor.
    404 HostInfo.NotFound The specified host info is not found. Belirtilen ana makine bilgileri mevcut değil.

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.