Partisi Cadangan
Memicu pencadangan status partisi.
Membuat cadangan status partisi berlanjut yang bernegara. Jika partisi sudah dicadangkan secara berkala, maka secara default cadangan baru dibuat pada penyimpanan cadangan yang sama. Seseorang juga dapat mengambil alih hal yang sama dengan menentukan detail penyimpanan cadangan sebagai bagian dari isi permintaan. Setelah pencadangan dimulai, kemajuannya dapat dilacak menggunakan operasi GetBackupProgress. Jika, waktu operasi habis, tentukan nilai batas waktu pencadangan yang lebih besar dalam parameter kueri.
Minta
Metode | URI Permintaan |
---|---|
POST | /Partitions/{partitionId}/$/Backup?BackupTimeout={BackupTimeout}&api-version=6.4&timeout={timeout} |
Parameter
Nama | Jenis | Diperlukan | Lokasi |
---|---|---|---|
partitionId |
string (uuid) | Ya | Jalur |
BackupTimeout |
bilangan bulat | Tidak | Kueri |
api-version |
string | Ya | Kueri |
timeout |
bilangan bulat (int64) | Tidak | Kueri |
BackupPartitionDescription |
BackupPartitionDescription | Tidak | Isi |
partitionId
Jenis: string (uuid)
Diperlukan: Ya
Identitas partisi.
BackupTimeout
Jenis: bilangan bulat
Diperlukan: Tidak
Default: 10
Menentukan jumlah waktu maksimum, dalam menit, untuk menunggu operasi pencadangan selesai. Posting itu, operasi selesai dengan kesalahan waktu habis. Namun, dalam kasus sudut tertentu bisa jadi meskipun operasi mengembalikan waktu habis kembali, pencadangan benar-benar dilalui. Jika terjadi kesalahan waktu habis, disarankan untuk memanggil operasi ini lagi dengan nilai batas waktu yang lebih besar. Nilai default untuk hal yang sama adalah 10 menit.
api-version
Jenis: string
Diperlukan: Ya
Default: 6.4
Versi API. Parameter ini diperlukan dan nilainya harus '6.4'.
Versi SERVICE Fabric REST API didasarkan pada versi runtime tempat API diperkenalkan atau diubah. Runtime Service Fabric mendukung lebih dari satu versi API. Versi ini adalah versi TERBARU api yang didukung. Jika versi API yang lebih rendah diteruskan, respons yang dikembalikan mungkin berbeda dari yang didokumenkan dalam spesifikasi ini.
Selain itu, runtime menerima versi apa pun yang lebih tinggi dari versi terbaru yang didukung hingga versi runtime saat ini. Jadi, jika versi API terbaru adalah 6.0 dan runtime adalah 6.1, runtime akan menerima versi 6.1 untuk API tersebut. Namun perilaku API akan sesuai versi 6.0 yang didokumentasikan.
timeout
Jenis: bilangan bulat (int64)
Diperlukan: Tidak
Default: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1
Batas waktu server untuk melakukan operasi dalam hitungan detik. Batas waktu ini menentukan durasi waktu klien bersedia menunggu operasi yang diminta selesai. Nilai default untuk parameter ini adalah 60 detik.
BackupPartitionDescription
Jenis: BackupPartitionDescription
Diperlukan: Tidak
Menjelaskan parameter untuk mencadangkan partisi sekarang. Jika tidak ada, operasi pencadangan menggunakan parameter default dari kebijakan cadangan saat ini yang terkait dengan partisi ini.
Respons
Kode Status HTTP | Deskripsi | Skema Respons |
---|---|---|
202 (Diterima) | Kode status 202 menunjukkan permintaan operasi diterima dan pencadangan akan dimulai. Gunakan operasi GetPartitionBackupProgress untuk mendapatkan status operasi pencadangan. |
|
Semua kode status lainnya | Respons kesalahan terperinci. |
FabricError |
Contoh
Partisi cadangan
Contoh ini menunjukkan cara memicu pencadangan partisi sekarang, yang sudah dikonfigurasi untuk pencadangan berkala. Cadangan yang baru dibuat akan disimpan di lokasi yang sama tempat cadangan berkala disimpan.
Minta
POST http://localhost:19080/Partitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/Backup?api-version=6.4
Isi
{}
Respons 202
Isi
Isi respons kosong.
Partisi cadangan ke akun penyimpanan Azure tertentu
Contoh ini menunjukkan cara memicu pencadangan partisi sekarang, dan menyimpan cadangan ke akun penyimpanan blob Azure tertentu.
Minta
POST http://localhost:19080/Partitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/Backup?api-version=6.4
Isi
{
"BackupStorage": {
"StorageKind": "AzureBlobStore",
"ConnectionString": "DefaultEndpointsProtocol=https;AccountName=storagesample;AccountKey=<PutYourAccountKeyHere>",
"ContainerName": "BackupContainer"
}
}
Respons 202
Isi
Isi respons kosong.
Partisi cadangan ke lokasi penyimpanan Azure tertentu yang diakses menggunakan identitas terkelola
Contoh ini menunjukkan cara memicu pencadangan partisi sekarang, dan menyimpan cadangan ke akun penyimpanan blob Azure tertentu menggunakan identitas terkelola.
Minta
POST http://localhost:19080/Partitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/Backup?api-version=6.4
Isi
{
"BackupStorage": {
"StorageKind": "ManagedIdentityAzureBlobStore",
"BlobServiceUri": "https://managedidentitytest.blob.core.windows.net/",
"ContainerName": "BackupContainer",
"ManagedIdentityType": "Cluster"
}
}
Respons 202
Isi
Isi respons kosong.
Partisi cadangan ke berbagi file lokal tertentu
Contoh ini menunjukkan cara memicu pencadangan partisi sekarang, dan menyimpan cadangan ke berbagi file tertentu yang dapat diakses dari semua node kluster.
Minta
POST http://localhost:19080/Partitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/Backup?api-version=6.4
Isi
{
"BackupStorage": {
"StorageKind": "FileShare",
"Path": "\\\\myshare\\backupshare",
"PrimaryUserName": "mydomain\\backupaccount",
"PrimaryPassword": "abcd1234"
}
}
Respons 202
Isi
Isi respons kosong.
Partisi cadangan ke lokasi penyimpanan Azure Dsms tertentu
Contoh ini menunjukkan cara memicu pencadangan partisi sekarang, dan menyimpan cadangan ke lokasi penyimpanan blob Azure Dsms tertentu.
Minta
POST http://localhost:19080/Partitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/Backup?api-version=6.4
Isi
{
"BackupStorage": {
"StorageKind": "DsmsAzureBlobStore",
"StorageCredentialsSourceLocation": "https://sample-dsms.dsms.core.winows.net/dsms/samplecredentiallocation/storageaccounts/samplestorageac/servicefabricbackup/samplebackup",
"ContainerName": "BackupContainer"
}
}
Respons 202
Isi
Isi respons kosong.