Tüm Ürünler
Search
Belge Merkezi

:CreatePolicyV2

Son Güncelleme:Sep 30, 2026

Bir ilke oluşturur.

Operation description

Yedekleme ilkesi, yedekleme için gereken bilgileri kaydeder. Bir yedekleme ilkesi yürütüldükten sonra, yedekleme ilerlemesini ve sonucunu kaydetmek için bir yedekleme işi oluşturulur. Yedekleme işi başarılı olursa bir yedekleme anlık görüntüsü oluşturulur. Yedekleme anlık görüntüsünü bir geri yükleme işi oluşturmak için kullanabilirsiniz.

  • Bir yedekleme ilkesi; NAS yedekleme, OSS yedekleme, ECS örnek yedekleme, ECS Dosya Yedekleme Temel Sürümü, yerel dosya yedekleme, Tablestore yedekleme ve CPFS yedekleme dahil olmak üzere birden fazla veri kaynağı türünü destekler.

  • Bir yedekleme ilkesi, yalnızca sabit aralıklı tek bir yedekleme döngüsü ilkesini destekler.

  • Bir yedekleme ilkesi, verileri yalnızca bir yedekleme kasasına yedekleyebilir.

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

hbr:CreatePolicyV2

create

*All Resource

*

None None

Request parameters

Parameter

Type

Required

Description

Example

PolicyName

string

No

İlke adı.

Daily local backup + geo-redundancy

PolicyType

string

No

İlke türü. Geçerli değerler:

  • STANDARD: Genel yedekleme ilkesi. ECS örnekleri dışındaki veri kaynaklarının yedeklenmesini destekler.

  • UDM_ECS_ONLY: ECS örnek yedekleme ilkesi. Yalnızca ECS örneklerinin yedeklenmesini destekler.

İlke türünü belirtmezseniz Cloud Backup, ilke kurallarında bir yedekleme kasası belirtilip belirtilmediğine göre ilke türünü otomatik olarak ayarlar:

  • İlke kurallarında bir yedekleme kasası belirtilmişse: STANDARD

  • İlke kurallarında yedekleme kasası belirtilmemişse: UDM_ECS_ONLY

STANDARD

PolicyDescription

string

No

İlke açıklaması.

Backup once every day at 10:00 AM, with cross-region backup to Shanghai.

Rules

array<object>

No

İlke kuralları listesi.

array<object>

No

İlke kuralı.

RuleType

string

Yes

Kural türü. Her ilke en az bir BACKUP kuralına ve tam olarak bir TRANSITION kuralına sahip olmalıdır. Geçerli değerler:

  • BACKUP: Yedekleme kuralı.

  • TRANSITION: Yaşam döngüsü kuralı.

  • REPLICATION: Çoğaltma kuralı.

  • TAG: Etikete dayalı kaynak ilişkilendirme kuralı.

Valid values:

  • TRANSITION :

    yaşam döngüsü kuralı.

  • BACKUP :

    yedekleme kuralı.

  • REPLICATION :

    çoğaltma kuralı.

  • SECURITY :

    güvenlik kuralı.

  • TAG :

    etikete dayalı kaynak ilişkilendirme kuralı.

BACKUP

Schedule

string

No

Bu parametre yalnızca RuleType değeri BACKUP olarak ayarlandığında gereklidir. Yedekleme zamanlaması ayarları. Desteklenen biçimler:

  • I|{startTime}|{interval}: {startTime} zamanından başlayarak belirtilen aralıklarla bir yedekleme işinin yürütüleceğini belirtir. Örneğin, I|1631685600|P1D, 2021-09-15 14:00:00 tarihinden başlayarak günde bir kez yedekleme işi yürütüleceğini belirtir.

    • startTime: Yedeklemenin başlangıç zamanı. Bu değer bir UNIX zaman damgasıdır. Birim: saniye.

    • interval: ISO 8601 zaman aralığı. Örneğin, PT1H bir saatlik bir aralığı belirtir. P1D bir günlük bir aralığı belirtir.

  • C|{startTime}|{crontab}: {startTime} zamanından başlayarak {crontab} ifadesine göre bir yedekleme işinin yürütüleceğini belirtir. Örneğin, C|1631685600|0 0 2 ? * 3,5,7, 2021-09-15 14:00:00 tarihinden başlayarak her salı, perşembe ve cumartesi günü saat 02:00:00'de bir yedekleme işi yürütüleceğini belirtir.

    • startTime: Yedeklemenin başlangıç zamanı. Bu değer bir UNIX zaman damgasıdır. Birim: saniye.

    • crontab: Crontab ifadesi. Örneğin, 0 0 2 ? * 3,5,7 her salı, perşembe ve cumartesi günü saat 02:00:00'yi belirtir.

Kaçırılan yedekleme işleri telafi edilmez. Önceki yedekleme işi tamamlanmamışsa sonraki yedekleme işi tetiklenmez.

I|1648647166|P1D

BackupType

string

No

Bu parametre yalnızca RuleType değeri BACKUP olarak ayarlandığında gereklidir. Yedekleme türü. Değeri tam yedeklemeyi belirten COMPLETE olarak ayarlayın.

Valid values:

  • ARCHIVE_BY_SEARCH :

    arama sonuçlarına göre arşivleme.

  • COMPLETE :

    tam yedekleme.

  • LOG :

    günlük yedekleme.

  • ARCHIVE :

    arşiv.

  • DIFFERENTIAL :

    fark yedekleme.

  • INDEX :

    dizin.

  • INCREMENTAL :

    artımlı yedekleme.

COMPLETE

Retention

integer

No

Bu parametre yalnızca RuleType değeri BACKUP, TRANSITION veya REPLICATION olarak ayarlandığında gereklidir.

  • RuleType değeri BACKUP olarak ayarlandığında: Yedeklerin saklama süresi. Bu parametrenin önceliği, RuleType değeri TRANSITION olan kuralın Retention parametresinden düşüktür. Minimum değer: 1. Maksimum değer: 364635. Birim: gün.

  • RuleType değeri TRANSITION olarak ayarlandığında: Yedeklerin saklama süresi. Minimum değer: 1. Maksimum değer: 364635. Birim: gün.

  • RuleType değeri REPLICATION olarak ayarlandığında: Bölgeler arası yedeklerin saklama süresi. Minimum değer: 1. Maksimum değer: 364635. Birim: gün.

7

ReplicationRegionId

string

No

Bu parametre yalnızca RuleType değeri REPLICATION olarak ayarlandığında gereklidir. Çoğaltma için hedef bölgenin kimliği.

cn-shanghai

ArchiveDays

integer

No

Bu parametre yalnızca RuleType değeri TRANSITION olarak ayarlandığında gereklidir. Bir yedeğin otomatik olarak arşiv katmanına taşınacağı gün sayısı. Yedekler standart katmanda en az 30 gün, arşiv katmanında ise en az 60 gün saklanmalıdır. Birim: gün.

90

RetentionRules

array<object>

No

Bu parametre yalnızca RuleType değeri TRANSITION olarak ayarlandığında gereklidir. Özel saklama kuralları.

object

No

Özel saklama kuralı.

AdvancedRetentionType

string

No

Özel saklama kuralının türü. Geçerli değerler:

  • DAILY: Günlük yedekleme.

  • WEEKLY: Haftalık yedekleme.

  • MONTHLY: Aylık yedekleme.

  • YEARLY: Yıllık yedekleme.

YEARLY

WhichSnapshot

integer

No

Kuralın uygulandığı yedek. Şu anda yalnızca ilk yedek desteklenmektedir. Değeri 1 olarak ayarlayın.

1

Retention

integer

No

Yedeğin özel saklama süresi. Minimum değer: 1. Birim: gün.

730

VaultId

string

No

Bu parametre yalnızca RuleType değeri BACKUP olarak ayarlandığında gereklidir. Yedekleme kasası kimliği.

v-0001************aseg

KeepLatestSnapshots

integer

No

En az bir yedekleme sürümünün saklanıp saklanmayacağını belirtir. Geçerli değerler:

  • 0: Saklanmaz.

  • 1: Saklanır.

1

Immutable

boolean

No

Bu parametre yalnızca PolicyType değeri UDM_ECS_ONLY ve RuleType değeri SECURITY olarak ayarlandığında gereklidir. Yedekleme kilitlemesinin etkinleştirilip etkinleştirilmeyeceğini belirtir.

true

DataSourceFilters

array<object>

No

Bu parametre yalnızca RuleType değeri TAG olarak ayarlandığında gereklidir. Veri kaynağı filtre kuralları.

array<object>

No

SourceType

string

No

Veri kaynağı türü. Geçerli değerler:

  • UDM_ECS: ECS örnek yedekleme. Bu veri kaynağı türü yalnızca PolicyType değeri UDM_ECS_ONLY olarak ayarlandığında desteklenir.

  • OSS: OSS yedekleme. Bu veri kaynağı türü yalnızca PolicyType değeri STANDARD olarak ayarlandığında desteklenir.

  • NAS: Alibaba Cloud NAS yedekleme. Bu veri kaynağı türü yalnızca PolicyType değeri STANDARD olarak ayarlandığında desteklenir.

  • ECS_FILE: ECS Dosya Yedekleme Temel Sürümü. Bu veri kaynağı türü yalnızca PolicyType değeri STANDARD olarak ayarlandığında desteklenir.

  • OTS: Tablestore yedekleme. Bu veri kaynağı türü yalnızca PolicyType değeri STANDARD olarak ayarlandığında desteklenir.

UDM_ECS

DataSourceIds deprecated

array

No

Kullanımdan kaldırıldı.

deprecated

string

No

Kullanımdan kaldırıldı.

Deprecated

AccountScope

string

No

Accounts

array<object>

No

object

No

CrossAccountType

string

No

CrossAccountUserId

integer

No

CrossAccountRoleName

string

No

TagFilters

array<object>

No

Bu parametre yalnızca RuleType değeri TAG olarak ayarlandığında gereklidir. Kaynak etiketi filtre kuralları.

object

No

Key

string

No

Etiket anahtarı.

env

Value

string

No

Etiket değeri. Boş bir değer, herhangi bir değeri belirtir.

prod

Operator

string

No

Etiket eşleştirme kuralı. Geçerli değerler:

  • EQUAL: Hem etiket anahtarını hem de etiket değerini eşleştirir.

  • NOT: Etiket anahtarını eşleştirir ancak etiket değerini eşleştirmez.

EQUAL

Response elements

Element

Type

Description

Example

object

CreatePolicyResponse.

Success

boolean

İsteğin başarılı olup olmadığını gösterir. Geçerli değerler:

  • true

  • false

true

Code

string

Yanıt kodu. 200 başarılı olduğunu gösterir.

200

Message

string

Döndürülen mesaj. Başarılı bir istek için "successful" değeri döndürülür. Başarısız bir istek için bir hata mesajı döndürülür.

successful

RequestId

string

İstek kimliği.

EEC65C22-2152-5E31-8AD6-D6CBF1BFF49F

PolicyId

string

İlke kimliği.

po-000000zemnuyx2li3y9y

Examples

Success response

JSON format

{
  "Success": true,
  "Code": "200",
  "Message": "successful",
  "RequestId": "EEC65C22-2152-5E31-8AD6-D6CBF1BFF49F",
  "PolicyId": "po-000000zemnuyx2li3y9y"
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.