다음을 통해 공유

Web Apps - List Backup Status Secrets

  • 참조
서비스:
App Service
API 버전:
2023-12-01

Azure Storage SAS URL과 같이 백업과 연결된 비밀을 포함하여 진행 중일 수 있는 웹앱 백업의 상태 가져오기에 대한 설명입니다. 또한 요청 본문에 새 URL이 전달되는 경우 백업에 대한 SAS URL을 업데이트하는 데 사용할 수 있습니다.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/backups/{backupId}/list?api-version=2023-12-01

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
backupId
 path True

string

백업 ID입니다.
name
 path True

string

웹앱의 이름입니다.
resourceGroupName
 path True

string

리소스가 속한 리소스 그룹의 이름입니다.

regex 패턴: ^[-\w\._\(\)]+[^\.]$
subscriptionId
 path True

string

Azure 구독 ID. GUID 형식 문자열입니다(예: 000000000-0000-0000-0000-0000-000000000000).
api-version
 query True

string

API 버전

요청 본문

Name 필수 형식 Description
properties.storageAccountUrl True

string

컨테이너에 대한 SAS URL입니다.
kind

string

리소스 종류입니다.
properties.backupName

string

백업의 이름입니다.
properties.backupSchedule

BackupSchedule

백업이 주기적으로 실행되는 경우 백업을 예약합니다.
properties.databases

DatabaseBackupSetting[]

백업에 포함된 데이터베이스입니다.
properties.enabled

boolean

True이면 백업 일정을 사용하도록 설정하고(이 경우 포함해야 함), 백업 일정을 사용하지 않도록 설정해야 하는 경우 false입니다.

응답

Name 형식 Description
200 OK

BackupItem

정상
Other Status Codes

DefaultErrorResponse

오류 응답을 App Service.

보안

azure_auth

Azure Active Directory OAuth2 Flow

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name Description
user_impersonation 사용자 계정 가장

예제

Get web app backup with secrets

샘플 요청

POST https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/sites/sitef6141/backups/12345/list?api-version=2023-12-01

{
  "properties": {
    "storageAccountUrl": "DefaultEndpointsProtocol=https;AccountName=storagesample;AccountKey=<account-key>",
    "backupName": "abcdwe",
    "enabled": true,
    "databases": [
      {
        "databaseType": "SqlAzure",
        "name": "backenddb",
        "connectionStringName": "backend",
        "connectionString": "DSN=data-source-name[;SERVER=value] [;PWD=value] [;UID=value] [;<Attribute>=<value>]"
      },
      {
        "databaseType": "SqlAzure",
        "name": "statsdb",
        "connectionStringName": "stats",
        "connectionString": "DSN=data-source-name[;SERVER=value] [;PWD=value] [;UID=value] [;<Attribute>=<value>]"
      }
    ],
    "backupSchedule": {
      "frequencyInterval": 7,
      "frequencyUnit": "Day",
      "keepAtLeastOneBackup": true,
      "retentionPeriodInDays": 30,
      "startTime": "2022-09-02T17:33:11.641Z"
    }
  }
}

샘플 응답

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

정의

Name Description
BackupItem

백업 설명.
BackupItemStatus

백업 상태.
BackupRequest

수행될 백업에 대한 설명입니다.
BackupSchedule

백업 일정에 대한 설명입니다. 백업을 수행해야 하는 빈도와 보존 정책을 설명합니다.
DatabaseBackupSetting

데이터베이스 백업 설정.
DatabaseType

데이터베이스 유형(예: SqlAzure/MySql).
DefaultErrorResponse

오류 응답을 App Service.
Details
Error

오류 모델.
FrequencyUnit

백업을 실행해야 하는 빈도에 대한 시간 단위입니다(예: 주간 백업의 경우 일로 설정해야 하고 FrequencyInterval은 7로 설정해야 합니다).

BackupItem

백업 설명.

Name 형식 Description
id

string

리소스 ID입니다.
kind

string

리소스 종류입니다.
name

string

리소스 이름입니다.
properties.blobName

string

이 백업에 대한 데이터를 포함하는 Blob의 이름입니다.
properties.correlationId

string

고유 상관 관계 식별자입니다. Azure 지원 통신하는 동안 타임스탬프와 함께 사용하세요.
properties.created

string

백업 만들기의 타임스탬프입니다.
properties.databases

DatabaseBackupSetting[]

백업에 포함된 데이터베이스 목록입니다.
properties.finishedTimeStamp

string

이 백업이 완료되면 타임스탬프입니다.
properties.id

integer

백업의 ID입니다.
properties.lastRestoreTimeStamp

string

이 백업을 사용한 마지막 복원 작업의 타임스탬프입니다.
properties.log

string

이 백업에 대한 세부 정보입니다. 오류 메시지가 포함될 수 있습니다.
properties.name

string

이 백업의 이름입니다.
properties.scheduled

boolean

True이면 트리거되는 일정으로 인해 이 백업이 생성되었습니다.
properties.sizeInBytes

integer

백업 크기(바이트)입니다.
properties.status

BackupItemStatus

백업 상태.
properties.storageAccountUrl

string

이 백업을 포함하는 스토리지 계정 컨테이너에 대한 SAS URL입니다.
properties.websiteSizeInBytes

integer

백업된 원래 웹앱의 크기입니다.
type

string

리소스 종류.

BackupItemStatus

백업 상태.

Name 형식 Description
Created

string

DeleteFailed

string

DeleteInProgress

string

Deleted

string

Failed

string

InProgress

string

PartiallySucceeded

string

Skipped

string

Succeeded

string

TimedOut

string

BackupRequest

수행될 백업에 대한 설명입니다.

Name 형식 Description
id

string

리소스 ID입니다.
kind

string

리소스 종류입니다.
name

string

리소스 이름입니다.
properties.backupName

string

백업의 이름입니다.
properties.backupSchedule

BackupSchedule

백업이 주기적으로 실행되는 경우 백업을 예약합니다.
properties.databases

DatabaseBackupSetting[]

백업에 포함된 데이터베이스입니다.
properties.enabled

boolean

True이면 백업 일정을 사용하도록 설정하고(이 경우 포함해야 함), 백업 일정을 사용하지 않도록 설정해야 하는 경우 false입니다.
properties.storageAccountUrl

string

컨테이너에 대한 SAS URL입니다.
type

string

리소스 종류.

BackupSchedule

백업 일정에 대한 설명입니다. 백업을 수행해야 하는 빈도와 보존 정책을 설명합니다.

Name 형식 Default value Description
frequencyInterval

integer

7

백업을 실행해야 하는 빈도(예: 주간 백업의 경우 7로 설정하고 FrequencyUnit을 Day로 설정해야 합니다).
frequencyUnit

FrequencyUnit

Day

백업을 실행해야 하는 빈도에 대한 시간 단위입니다(예: 주간 백업의 경우 일로 설정해야 하고 FrequencyInterval은 7로 설정해야 합니다).
keepAtLeastOneBackup

boolean

True

True이면 보존 정책이 오래되었는지에 관계없이 스토리지 계정에 항상 하나 이상의 백업을 유지해야 합니다. false이면 이고, 그렇지 않으면 입니다.
lastExecutionTime

string

이 일정이 트리거된 마지막 시간입니다.
retentionPeriodInDays

integer

30

백업을 삭제해야 하는 일 수 후입니다.
startTime

string

일정이 작동을 시작해야 하는 경우

DatabaseBackupSetting

데이터베이스 백업 설정.

Name 형식 Description
connectionString

string

백업 또는 복원 중인 데이터베이스에 대한 연결 문자열 포함합니다. 복원이 새 데이터베이스에 발생하는 경우 내부의 데이터베이스 이름은 새 데이터베이스 이름입니다.
connectionStringName

string

SiteConfig.ConnectionStrings에 연결된 연결 문자열 이름을 포함합니다. 이는 연결 문자열 덮어쓰기 옵션을 사용하여 복원하는 동안 사용됩니다.
databaseType

DatabaseType

데이터베이스 유형(예: SqlAzure/MySql).
name

string

DatabaseType

데이터베이스 유형(예: SqlAzure/MySql).

Name 형식 Description
LocalMySql

string

MySql

string

PostgreSql

string

SqlAzure

string

DefaultErrorResponse

오류 응답을 App Service.

Name 형식 Description
error

Error

오류 모델.

Details

Name 형식 Description
code

string

프로그래밍 방식으로 오류를 식별하는 표준화된 문자열입니다.
message

string

자세한 오류 설명 및 디버깅 정보입니다.
target

string

자세한 오류 설명 및 디버깅 정보입니다.

Error

오류 모델.

Name 형식 Description
code

string

프로그래밍 방식으로 오류를 식별하는 표준화된 문자열입니다.
details

Details[]

자세한 오류입니다.
innererror

string

디버그 오류에 대한 자세한 정보입니다.
message

string

자세한 오류 설명 및 디버깅 정보입니다.
target

string

자세한 오류 설명 및 디버깅 정보입니다.

FrequencyUnit

백업을 실행해야 하는 빈도에 대한 시간 단위입니다(예: 주간 백업의 경우 일로 설정해야 하고 FrequencyInterval은 7로 설정해야 합니다).

Name 형식 Description
Day

string

Hour

string