Web Apps - List Backups

Layanan:

App Service

Versi API:

2026-07-15

Deskripsi untuk Mendapatkan cadangan aplikasi yang ada.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/backups?api-version=2026-07-15

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
name	path	True	string	Nama aplikasi.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nama grup sumber daya. Nama tidak sensitif terhadap penggunaan huruf besar atau kecil.
subscriptionId	path	True	string (uuid)	ID langganan target. Nilainya harus sebuah UUID.
api-version	query	True	string minLength: 1	Versi API yang akan digunakan untuk operasi ini.

Respons

Nama	Jenis	Deskripsi
200 OK	BackupItemCollection	Operasi Azure berhasil diselesaikan.
Other Status Codes	DefaultErrorResponse	Respons kesalahan yang tidak terduga.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory.

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama	Deskripsi
user_impersonation	meniru akun pengguna Anda

Contoh

List web app backups

Permintaan sampel

HTTP

GET https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/sites/sitef6141/backups?api-version=2026-07-15

Respon sampel

Kode status:

200

{
  "value": [
    {
      "name": "sitef6141",
      "type": "Microsoft.Web/sites",
      "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/sites/sitef6141/backups/12345",
      "properties": {
        "name": "sitef6141_2024-11-01",
        "blobName": "sitef6141_2024-11-01",
        "created": "2022-09-03T17:33:11.641Z",
        "databases": [
          {
            "name": "backenddb",
            "connectionString": "DSN=data-source-name[;SERVER=value] [;PWD=value] [;UID=value] [;<Attribute>=<value>]",
            "connectionStringName": "backend",
            "databaseType": "SqlAzure"
          },
          {
            "name": "statsdb",
            "connectionString": "DSN=data-source-name[;SERVER=value] [;PWD=value] [;UID=value] [;<Attribute>=<value>]",
            "connectionStringName": "stats",
            "databaseType": "SqlAzure"
          }
        ],
        "finishedTimeStamp": "2022-09-05T17:33:11.641Z",
        "id": 12345,
        "lastRestoreTimeStamp": "2022-09-04T17:33:11.641Z",
        "log": "Succeeded",
        "scheduled": true,
        "sizeInBytes": 56091883,
        "status": "InProgress",
        "storageAccountUrl": "DefaultEndpointsProtocol=https;AccountName=storagesample;AccountKey=<account-key>",
        "websiteSizeInBytes": 56091883
      }
    }
  ]
}

Definisi

Nama	Deskripsi
BackupItem	Deskripsi cadangan.
BackupItemCollection	Pengumpulan item cadangan.
BackupItemStatus	Status cadangan.
createdByType	Jenis identitas yang membuat sumber daya tersebut.
DatabaseBackupSetting	Pengaturan pencadangan database.
DatabaseType	Jenis database (misalnya SqlAzure / MySql).
DefaultErrorResponse	Respons kesalahan App Service.
DefaultErrorResponseError	Model kesalahan.
DefaultErrorResponseErrorDetailsItem	Kesalahan terperinci.
systemData	Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

BackupItem

Objek

Deskripsi cadangan.

Nama	Jenis	Deskripsi
id	string (arm-id)	ID sumber daya lengkap untuk sumber daya tersebut. Misalnya "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind	string	Jenis sumber daya.
name	string	Nama sumber daya.
properties.blobName	string	Nama blob yang berisi data untuk cadangan ini.
properties.correlationId	string	Pengidentifikasi korelasi unik. Gunakan ini bersama dengan stempel waktu saat berkomunikasi dengan Azure support.
properties.created	string (date-time)	Stempel waktu pembuatan cadangan.
properties.databases	DatabaseBackupSetting[]	Daftar database yang disertakan dalam cadangan.
properties.finishedTimeStamp	string (date-time)	Stempel waktu saat pencadangan ini selesai.
properties.id	integer (int32)	Id cadangan.
properties.lastRestoreTimeStamp	string (date-time)	Stempel waktu operasi pemulihan terakhir yang menggunakan cadangan ini.
properties.log	string	Detail mengenai cadangan ini. Mungkin berisi pesan kesalahan.
properties.name	string	Nama cadangan ini.
properties.scheduled	boolean	Benar jika cadangan ini telah dibuat karena jadwal dipicu.
properties.sizeInBytes	integer (int64)	Ukuran cadangan dalam byte.
properties.status	BackupItemStatus	Status cadangan.
properties.storageAccountUrl	string	URL SAS untuk kontainer akun penyimpanan yang berisi cadangan ini.
properties.websiteSizeInBytes	integer (int64)	Ukuran aplikasi web asli yang telah dicadangkan.
systemData	systemData	Metadata Azure Resource Manager yang berisi informasi createBy dan modifiedBy.
type	string	Jenis sumber daya. Misalnya, "Microsoft.Compute/virtualMachines" atau "Microsoft.Storage/storageAccounts"

BackupItemCollection

Objek

Pengumpulan item cadangan.

Nama	Jenis	Deskripsi
nextLink	string (uri)	Tautan ke halaman item berikutnya
value	BackupItem[]	Item BackupItem di halaman ini

BackupItemStatus

Enumerasi

Status cadangan.

Nilai	Deskripsi
InProgress
Failed
Succeeded
TimedOut
Created
Skipped
PartiallySucceeded
DeleteInProgress
DeleteFailed
Deleted

createdByType

Enumerasi

Jenis identitas yang membuat sumber daya tersebut.

Nilai	Deskripsi
User
Application
ManagedIdentity
Key

DatabaseBackupSetting

Objek

Pengaturan pencadangan database.

Nama	Jenis	Deskripsi
connectionString	string	Berisi string koneksi ke database yang sedang dicadangkan atau dipulihkan. Jika pemulihan harus terjadi pada database baru, nama database di dalamnya adalah yang baru.
connectionStringName	string	Berisi nama string koneksi yang ditautkan ke SiteConfig.ConnectionStrings. Ini digunakan selama pemulihan dengan opsi timpa string koneksi.
databaseType	DatabaseType	Jenis database (misalnya SqlAzure / MySql).
name	string

DatabaseType

Enumerasi

Jenis database (misalnya SqlAzure / MySql).

Nilai	Deskripsi
SqlAzure
MySql
LocalMySql
PostgreSql

DefaultErrorResponse

Objek

Respons kesalahan App Service.

Nama	Jenis	Deskripsi
error	DefaultErrorResponseError	Model kesalahan.

DefaultErrorResponseError

Objek

Model kesalahan.

Nama	Jenis	Deskripsi
code	string	String standar untuk mengidentifikasi kesalahan secara terprogram.
details	DefaultErrorResponseErrorDetailsItem[]	Kesalahan terperinci.
innererror	string	Informasi selengkapnya untuk men-debug kesalahan.
message	string	Deskripsi kesalahan terperinci dan informasi debugging.
target	string	Deskripsi kesalahan terperinci dan informasi debugging.

DefaultErrorResponseErrorDetailsItem

Objek

Kesalahan terperinci.

Nama	Jenis	Deskripsi
code	string	String standar untuk mengidentifikasi kesalahan secara terprogram.
message	string	Deskripsi kesalahan terperinci dan informasi debugging.
target	string	Deskripsi kesalahan terperinci dan informasi debugging.

systemData

Objek

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

Nama	Jenis	Deskripsi
createdAt	string (date-time)	Tanda waktu pembuatan sumber daya (UTC).
createdBy	string	Identitas yang membuat sumber daya tersebut.
createdByType	createdByType	Jenis identitas yang membuat sumber daya tersebut.
lastModifiedAt	string (date-time)	Tanda waktu modifikasi terakhir sumber daya (UTC)
lastModifiedBy	string	Identitas yang terakhir kali mengubah sumber daya.
lastModifiedByType	createdByType	Jenis identitas yang terakhir memodifikasi sumber daya.