삭제된 인스턴스의 백업 관리
인스턴스 삭제 후 백업 보관 을 선택했거나 인스턴스를 삭제하기 전에 최종 백업을 수행 한 경우 인스턴스가 삭제된 후 백업을 관리할 수 있습니다. 보관된 백업에는 인스턴스가 사용 중일 때 생성된 자동 백업 및 주문형 백업이 포함됩니다. 인스턴스를 삭제하면 이러한 백업은 인스턴스와 독립적으로 프로젝트 수준에 저장됩니다. 백업 작동 방식과 보관되는 백업에 대한 자세한 내용은 Cloud SQL 백업 개요 를 참고하세요.
인스턴스가 삭제된 후 이러한 백업을 사용하여 인스턴스를 복원 할 수 있습니다.
시작하기 전에
Cloud de Confiance 프로젝트에서 보관된 백업을 관리하려면 다음 권한이 필요합니다.
콘솔
작업
필수 권한
백업 표시
cloudsql.backupRuns.list
백업 설명
cloudsql.backupRuns.get
백업 업데이트
cloudsql.backupRuns.update
백업 삭제
cloudsql.backupRuns.delete
gcloud
작업
명령어
필수 권한
백업 표시
gcloud sql backups list
cloudsql.backupRuns.list
백업 설명
gcloud sql backups describe
cloudsql.backupRuns.get
백업 업데이트
gcloud sql backups patch
cloudsql.backupRuns.update
백업 삭제
gcloud sql backups delete
cloudsql.backupRuns.delete
REST
작업
메서드
필수 권한
백업 표시
backups.listBackup
cloudsql.backupRuns.list
백업 설명
backups.getBackup
cloudsql.backupRuns.get
백업 업데이트
backups.updateBackup
cloudsql.backupRuns.update
백업 삭제
backups.deleteBackup
cloudsql.backupRuns.delete
삭제된 인스턴스의 모든 백업 나열
Cloud de Confiance 콘솔 프로젝트의 삭제된 인스턴스에 대해 보관된 모든 백업과 최종 백업의 목록을 볼 수 있습니다. 백업에는 백업 이름, 백업에 속한 인스턴스, 백업 유형, 인스턴스 삭제 시간과 같은 세부정보가 포함됩니다. 삭제된 인스턴스의 이름은 삭제 후 재사용될 수 있으므로 instance deletion time
필드를 사용하여 특정 백업이 속한 인스턴스를 구분하는 것이 좋습니다. 실시간 인스턴스의 경우 이 필드는 비어 있습니다.
콘솔
Cloud de Confiance 콘솔에서 Cloud SQL 백업 페이지로 이동합니다.
Cloud SQL 백업으로 이동
인스턴스의 백업 옵션 (표준 등급 또는 고급 등급 )을 선택합니다.
필터 , 인스턴스 상태 를 차례로 클릭하고 삭제된 인스턴스 를 선택합니다.
이 페이지에는Cloud de Confiance 콘솔 프로젝트에서 삭제된 모든 인스턴스가 나열됩니다.
백업을 보려는 삭제된 인스턴스의 이름을 클릭합니다.
이 페이지에는 삭제된 인스턴스의 모든 보관된 자동 및 주문형 백업과 최종 백업(있는 경우)이 나열됩니다.
gcloud
Cloud de Confiance 프로젝트와 연결된 모든 백업 목록을 가져오려면 gcloud sql backups list 명령어를 사용합니다.
gcloud sql backups list
--project=PROJECT_ID
다음을 바꿉니다.
PROJECT_ID
: Cloud de Confiance 프로젝트의 ID입니다.
특정 보관된 백업에 대한 세부정보를 보려면 gcloud sql backups describe 명령어를 사용합니다.
gcloud sql backups describe BACKUP_NAME
--project=PROJECT_ID
다음을 바꿉니다.
BACKUP_NAME
: 보관된 백업 이름입니다.
PROJECT_ID
: Cloud de Confiance 프로젝트의 ID입니다.
REST v1 모든 백업 목록 가져오기
이 예시를 사용하여 Cloud de Confiance 프로젝트와 연결된 모든 보관된 백업과 최종 백업의 목록을 가져옵니다. 이 호출의 전체 파라미터 목록은 backups.listBackups
페이지를 참조하세요.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
HTTP 메서드 및 URL:
GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
cURL(Linux, macOS, Cloud Shell)
다음 명령어를 실행합니다.
curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups"
PowerShell(Windows)
다음 명령어를 실행합니다.
$cred = gcloud auth print-access-token $headers = @{ "Authorization" = "Bearer $cred" } Invoke-WebRequest ` -Method GET ` -Headers $headers ` -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups" | Select-Object -Expand Content
다음과 비슷한 JSON 응답이 표시됩니다.
응답
{
"name": "projects/PROJECT_ID /backups/BACKUP_ID ",
"kind": "sql#backup",
"state": "SUCCESSFUL",
"backupInterval": {
"startTime": "2020-01-21T11:25:33.858Z",
"endTime": "2020-01-21T11:26:18.663Z",
}
"type": "FINAL",
"instance": "INSTANCE_ID ",
"selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID ",
"location": "us"
"description": "This is a final backup.",
"backupKind": "SNAPSHOT",
"dataDiskSizeGB": "10",
"expiryTime": "2020-01-30T11:26:18.663Z",
"backup_run": "projects/PROJECT_ID /instances/INSTANCE_ID /backupRuns/BACKUP_RUN_ID ",
"satisfies_pzs": false,
"satisfies_pzi": false
}
백업 세부정보 보기
이 예시를 사용하여 보관된 백업 또는 최종 백업의 세부정보를 봅니다. 이 호출의 전체 파라미터 목록은 backup.getBackup
페이지를 참고하세요.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
PROJECT_ID : 프로젝트 ID
BACKUP_ID : 백업 ID. 이 ID는 이전 호출 실행의 출력에서 가져옵니다.
HTTP 메서드 및 URL:
GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
cURL(Linux, macOS, Cloud Shell)
다음 명령어를 실행합니다.
curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID "
PowerShell(Windows)
다음 명령어를 실행합니다.
$cred = gcloud auth print-access-token $headers = @{ "Authorization" = "Bearer $cred" } Invoke-WebRequest ` -Method GET ` -Headers $headers ` -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID " | Select-Object -Expand Content
다음과 비슷한 JSON 응답이 표시됩니다.
응답
{
"name": "projects/PROJECT_ID /backups/BACKUP_ID ",
"kind": "sql#backup",
"status": "SUCCESSFUL",
"backupInterval": {
"startTime": "2020-01-21T11:25:33.858Z",
"endTime": "2020-01-21T11:26:18.663Z",
}
"type": "FINAL",
"instance": "INSTANCE_ID ",
"selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID ",
"location": "us"
"description": "final backup",
"backupKind": "SNAPSHOT",
"dataDiskSizeGB": "10",
"expiryTime": "2020-01-30T11:26:18.663Z",
"backup_run": "projects/PROJECT_ID /instances/INSTANCE_ID /backupRuns/BACKUP_RUN_ID ",
"satisfies_pzs": false,
"satisfies_pzi": false
}
REST v1beta4 모든 보관된 백업 목록 가져오기
이 예시를 사용하여Cloud de Confiance 프로젝트와 연결된 모든 보관된 백업과 최종 백업의 목록을 가져옵니다. 이 호출의 전체 파라미터 목록은 backups.listBackups
페이지를 참조하세요.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
HTTP 메서드 및 URL:
GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
cURL(Linux, macOS, Cloud Shell)
다음 명령어를 실행합니다.
curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups"
PowerShell(Windows)
다음 명령어를 실행합니다.
$cred = gcloud auth print-access-token $headers = @{ "Authorization" = "Bearer $cred" } Invoke-WebRequest ` -Method GET ` -Headers $headers ` -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups" | Select-Object -Expand Content
다음과 비슷한 JSON 응답이 표시됩니다.
응답
{
"name": "projects/PROJECT_ID /backups/BACKUP_ID ",
"kind": "sql#backup",
"state": "SUCCESSFUL",
"backupInterval": {
"startTime": "2020-01-21T11:25:33.858Z",
"endTime": "2020-01-21T11:26:18.663Z",
}
"type": "FINAL",
"instance": "INSTANCE_ID ",
"selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID ",
"location": "us"
"description": "This is a final backup.",
"backupKind": "SNAPSHOT",
"dataDiskSizeGB": "10",
"expiryTime": "2020-01-30T11:26:18.663Z",
"backup_run": "projects/PROJECT_ID /instances/INSTANCE_ID /backupRuns/BACKUP_RUN_ID ",
"satisfies_pzs": false,
"satisfies_pzi": false
}
보관된 백업 세부정보 보기
이 예시를 사용하여 보관된 백업 또는 최종 백업의 세부정보를 봅니다. 이 호출의 전체 파라미터 목록은 backups.getBackup
페이지를 참고하세요.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
PROJECT_ID : 프로젝트 ID
BACKUP_ID : 백업 ID. 이 ID는 이전 호출 실행의 출력에서 가져옵니다.
HTTP 메서드 및 URL:
GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
cURL(Linux, macOS, Cloud Shell)
다음 명령어를 실행합니다.
curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID "
PowerShell(Windows)
다음 명령어를 실행합니다.
$cred = gcloud auth print-access-token $headers = @{ "Authorization" = "Bearer $cred" } Invoke-WebRequest ` -Method GET ` -Headers $headers ` -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID " | Select-Object -Expand Content
다음과 비슷한 JSON 응답이 표시됩니다.
응답
{
"name": "projects/PROJECT_ID /backups/BACKUP_ID ",
"kind": "sql#backup",
"status": "SUCCESSFUL",
"backupInterval": {
"startTime": "2020-01-21T11:25:33.858Z",
"endTime": "2020-01-21T11:26:18.663Z",
}
"type": "FINAL",
"instance": "INSTANCE_ID ",
"selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID ",
"location": "us"
"description": "final backup",
"backupKind": "SNAPSHOT",
"dataDiskSizeGB": "10",
"expiryTime": "2020-01-30T11:26:18.663Z",
"backup_run": "projects/PROJECT_ID /instances/INSTANCE_ID /backupRuns/BACKUP_RUN_ID ",
"satisfies_pzs": false,
"satisfies_pzi": false
}
인스턴스 삭제 후 보관된 백업 또는 최종 백업 업데이트
인스턴스를 삭제한 후에는 프로젝트 수준에 저장된 해당 인스턴스와 연결된 보관된 백업 또는 최종 백업의 설정을 업데이트할 수 있습니다. 백업 유형에 따라 업데이트할 수 있는 세부정보가 다를 수 있습니다.
인스턴스를 삭제하기 전에 수행한 최종 백업의 설명과 보관 설정을 업데이트할 수 있습니다. 하지만 인스턴스 삭제 후 보관되는 주문형 또는 자동 백업의 경우 이러한 백업의 설명만 업데이트할 수 있습니다. 보관된 백업의 경우 인스턴스가 사용 중일 때 백업의 보관 설정에 따라 보관 설정이 지정됩니다. 자세한 내용은 인스턴스 삭제 후 백업 보관 을 참조하세요.
최종 백업 업데이트
인스턴스를 삭제하기 전에 생성된 최종 백업의 보관 설정과 설명을 업데이트할 수 있습니다. 백업을 업데이트하려면 다음을 수행하세요.
콘솔
Cloud de Confiance 콘솔에서 Cloud SQL 백업 페이지로 이동합니다.
Cloud SQL 백업으로 이동
백업을 보려는 삭제된 인스턴스의 이름을 클릭합니다.
모든 보관된 백업과 최종 백업의 목록 및 삭제된 인스턴스의 세부정보가 표시됩니다.
업데이트하려는 최종 백업의 경우 추가 작업 을 클릭한 후 다음 단계를 따르세요.
최종 백업의 설명을 수정하려면 설명 수정 을 클릭합니다.
이 백업 설명 필드에 설명을 입력한 다음 업데이트 를 클릭합니다.
최종 백업의 보관 기간을 수정하려면 보관 기간 수정 을 클릭합니다.
백업 보관 기한 필드에서 날짜를 선택합니다. 보관 기간은 인스턴스 삭제 후 1~365일입니다. 백업 보관 기한을 선택한 후 업데이트 를 클릭합니다.
gcloud 업데이트할 최종 백업의 backup-name
이 필요합니다.
backup-name
를 가져오려면 삭제된 인스턴스의 백업 나열 을 참고하세요.
최종 백업의 보관 기간 또는 설명을 업데이트하려면 gcloud sql backups patch 명령어를 사용하고 백업에 대해 expiry-time
또는 ttl-days
를 지정합니다.
gcloud sql backups patch BACKUP_NAME
--description=BACKUP_DESCRIPTION
--expiry-time=EXPIRY_TIME | --ttl-days=TTL_DAYS
다음을 바꿉니다.
BACKUP_NAME
: 최종 백업의 이름입니다.
BACKUP_DESCRIPTION
: 최종 백업에 추가할 새 설명
다음 중 하나입니다.
EXPIRY_TIME
: 최종 백업을 삭제할 새 날짜와 시간입니다. 최대 시간은 인스턴스 삭제 후 365일입니다.
TTL_DAYS
: 최종 백업을 보관할 일수입니다. 이 값은 1~365일 범위에서 설정할 수 있으며 기본값은 30일입니다.
REST v1 업데이트할 최종 백업의 backup-name
이 필요합니다.
backup-name
를 가져오려면 삭제된 인스턴스의 백업 나열 을 참고하세요.
최종 백업의 설명과 보관 설정을 업데이트할 수 있습니다. 보관 설정은 다음 방법 중 하나를 사용하여 업데이트할 수 있습니다.
최종 백업의 보관 일수 업데이트
최종 백업의 만료 시간 업데이트
보관 일수를 사용하여 보관 기간 업데이트
이 예시를 사용하여 보관 기간(일) 매개변수를 사용하여 최종 백업의 보관 설정을 업데이트합니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
PROJECT_ID : 프로젝트 ID
BACKUP_ID : 백업 ID. 이 ID는 이전 호출 실행의 출력에서 가져옵니다.
TTL_DAYS : 최종 백업의 보관 기간입니다(1~365일). 이를 TTL(수명) 이라고 합니다. 보관 기간은 현재 날짜 및 시간부터 시작되며 Cloud SQL에서 허용하는 최대 보관 기간은 1년(365일)입니다.
HTTP 메서드 및 URL:
PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID ?update_mask=ttl_days
JSON 요청 본문:
{
"backup": {
expiration: {
"ttl_days": TTL_DAYS ,
}
},
}
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
cURL(Linux, macOS, Cloud Shell)
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
curl -X PATCH \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ -d @request.json \ "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID ?update_mask=ttl_days"
PowerShell(Windows)
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
$cred = gcloud auth print-access-token $headers = @{ "Authorization" = "Bearer $cred" } Invoke-WebRequest ` -Method PATCH ` -Headers $headers ` -ContentType: "application/json; charset=utf-8" ` -InFile request.json ` -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID ?update_mask=ttl_days" | Select-Object -Expand Content
다음과 비슷한 JSON 응답이 표시됩니다.
응답
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID ",
"status": "DONE",
"user": "user@example.com",
"insertTime": "2024-02-15T00:10:22.078Z",
"operationType": "UPDATE_BACKUP",
"name": "OPERATION_ID ",
"targetId": "BACKUP_ID ",
"selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /operations/OPERATION_ID ",
"targetProject": "PROJECT_ID "
}
만료 시간을 사용하여 보관 기간 업데이트
만료 시간 매개변수를 사용하여 최종 백업의 보관 설정을 업데이트하려면 다음 예시를 사용하세요.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
PROJECT_ID : 프로젝트 ID
BACKUP_ID : 백업 ID. 이 ID는 이전 호출 실행의 출력에서 가져옵니다.
DATE_AND_TIME_STAMP : Cloud SQL에서 최종 백업을 자동으로 삭제한 날짜 및 시간 스탬프입니다.
HTTP 메서드 및 URL:
PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID ?update_mask=expiry_time
JSON 요청 본문:
{
"backup": {
expiration: {
"expiry_time": DATE_AND_TIME_STAMP ,
}
},
}
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
cURL(Linux, macOS, Cloud Shell)
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
curl -X PATCH \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ -d @request.json \ "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID ?update_mask=expiry_time"
PowerShell(Windows)
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
$cred = gcloud auth print-access-token $headers = @{ "Authorization" = "Bearer $cred" } Invoke-WebRequest ` -Method PATCH ` -Headers $headers ` -ContentType: "application/json; charset=utf-8" ` -InFile request.json ` -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID ?update_mask=expiry_time" | Select-Object -Expand Content
다음과 비슷한 JSON 응답이 표시됩니다.
응답
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID ",
"status": "DONE",
"user": "user@example.com",
"insertTime": "2024-02-15T00:10:22.078Z",
"operationType": "UPDATE_BACKUP",
"name": "OPERATION_ID ",
"targetId": "BACKUP_ID ",
"selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /operations/OPERATION_ID ",
"targetProject": "PROJECT_ID "
}
설명 업데이트
최종 백업의 설명을 업데이트하려면 이 예시를 사용합니다. 이 호출의 전체 파라미터 목록은 backups.updateBackup
페이지를 참조하세요.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
PROJECT_ID : 프로젝트 ID
BACKUP_ID : 백업 ID. 이 ID는 이전 호출 실행의 출력에서 가져옵니다.
DESCRIPTION : 최종 백업에 대한 업데이트된 설명입니다.
HTTP 메서드 및 URL:
PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID ?update_mask=description
JSON 요청 본문:
{
"backup": {
"description": DESCRIPTION ,
},
}
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
cURL(Linux, macOS, Cloud Shell)
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
curl -X PATCH \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ -d @request.json \ "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID ?update_mask=description"
PowerShell(Windows)
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
$cred = gcloud auth print-access-token $headers = @{ "Authorization" = "Bearer $cred" } Invoke-WebRequest ` -Method PATCH ` -Headers $headers ` -ContentType: "application/json; charset=utf-8" ` -InFile request.json ` -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID ?update_mask=description" | Select-Object -Expand Content
다음과 비슷한 JSON 응답이 표시됩니다.
응답
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID ",
"status": "DONE",
"user": "user@example.com",
"insertTime": "2024-02-15T00:10:22.078Z",
"operationType": "UPDATE_BACKUP",
"name": "OPERATION_ID ",
"targetId": "BACKUP_ID ",
"selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /operations/OPERATION_ID ",
"targetProject": "PROJECT_ID "
}
REST v1beta4 업데이트할 최종 백업의 backup-name
이 필요합니다.
backup-name
를 가져오려면 삭제된 인스턴스의 백업 나열 을 참고하세요.
최종 백업의 설명과 보관 설정을 업데이트할 수 있습니다. 보관 설정은 다음 방법 중 하나를 사용하여 업데이트할 수 있습니다.
최종 백업의 보관 일수 업데이트
최종 백업의 만료 시간 업데이트
보관 일수를 사용하여 보관 기간 업데이트
이 예시를 사용하여 보관 기간(일) 매개변수를 사용하여 최종 백업의 보관 설정을 업데이트합니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
PROJECT_ID : 프로젝트 ID
BACKUP_ID : 백업 ID. 이 ID는 이전 호출 실행의 출력에서 가져옵니다.
TTL_DAYS : 최종 백업의 보관 기간입니다(1~365일). 이를 TTL(수명) 이라고 합니다. 보관 기간은 현재 날짜 및 시간부터 시작되며 Cloud SQL에서 허용하는 최대 보관 기간은 1년(365일)입니다.
HTTP 메서드 및 URL:
PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID ?update_mask=ttl_days
JSON 요청 본문:
{
"backup": {
expiration: {
"ttl_days": TTL_DAYS ,
}
},
}
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
cURL(Linux, macOS, Cloud Shell)
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
curl -X PATCH \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ -d @request.json \ "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID ?update_mask=ttl_days"
PowerShell(Windows)
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
$cred = gcloud auth print-access-token $headers = @{ "Authorization" = "Bearer $cred" } Invoke-WebRequest ` -Method PATCH ` -Headers $headers ` -ContentType: "application/json; charset=utf-8" ` -InFile request.json ` -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID ?update_mask=ttl_days" | Select-Object -Expand Content
다음과 비슷한 JSON 응답이 표시됩니다.
응답
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID ",
"status": "DONE",
"user": "user@example.com",
"insertTime": "2024-02-15T00:10:22.078Z",
"operationType": "UPDATE_BACKUP",
"name": "OPERATION_ID ",
"targetId": "BACKUP_ID ",
"selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /operations/OPERATION_ID ",
"targetProject": "PROJECT_ID "
}
만료 시간을 사용하여 보관 기간 업데이트
만료 시간 매개변수를 사용하여 최종 백업의 보관 설정을 업데이트하려면 다음 예시를 사용하세요.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
PROJECT_ID : 프로젝트 ID
BACKUP_ID : 백업 ID. 이 ID는 이전 호출 실행의 출력에서 가져옵니다.
DATE_AND_TIME_STAMP : Cloud SQL에서 최종 백업을 자동으로 삭제한 날짜 및 시간 스탬프입니다.
HTTP 메서드 및 URL:
PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID ?update_mask=expiry_time
JSON 요청 본문:
{
"backup": {
expiration: {
"expiry_time": DATE_AND_TIME_STAMP ,
}
},
}
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
cURL(Linux, macOS, Cloud Shell)
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
curl -X PATCH \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ -d @request.json \ "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID ?update_mask=expiry_time"
PowerShell(Windows)
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
$cred = gcloud auth print-access-token $headers = @{ "Authorization" = "Bearer $cred" } Invoke-WebRequest ` -Method PATCH ` -Headers $headers ` -ContentType: "application/json; charset=utf-8" ` -InFile request.json ` -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID ?update_mask=expiry_time" | Select-Object -Expand Content
다음과 비슷한 JSON 응답이 표시됩니다.
응답
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID ",
"status": "DONE",
"user": "user@example.com",
"insertTime": "2024-02-15T00:10:22.078Z",
"operationType": "UPDATE_BACKUP",
"name": "OPERATION_ID ",
"targetId": "BACKUP_ID ",
"selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /operations/OPERATION_ID ",
"targetProject": "PROJECT_ID "
}
설명 업데이트
최종 백업의 설명을 업데이트하려면 이 예시를 사용합니다. 이 호출의 전체 파라미터 목록은 backups.updateBackup
페이지를 참조하세요.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
PROJECT_ID : 프로젝트 ID
BACKUP_ID : 백업 ID. 이 ID는 이전 호출 실행의 출력에서 가져옵니다.
DESCRIPTION : 최종 백업에 대한 업데이트된 설명입니다.
HTTP 메서드 및 URL:
PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID ?update_mask=description
JSON 요청 본문:
{
"backup": {
"description": DESCRIPTION ,
},
}
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
cURL(Linux, macOS, Cloud Shell)
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
curl -X PATCH \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ -d @request.json \ "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID ?update_mask=description"
PowerShell(Windows)
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
$cred = gcloud auth print-access-token $headers = @{ "Authorization" = "Bearer $cred" } Invoke-WebRequest ` -Method PATCH ` -Headers $headers ` -ContentType: "application/json; charset=utf-8" ` -InFile request.json ` -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID ?update_mask=description" | Select-Object -Expand Content
다음과 비슷한 JSON 응답이 표시됩니다.
응답
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID ",
"status": "DONE",
"user": "user@example.com",
"insertTime": "2024-02-15T00:10:22.078Z",
"operationType": "UPDATE_BACKUP",
"name": "OPERATION_ID ",
"targetId": "BACKUP_ID ",
"selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /operations/OPERATION_ID ",
"targetProject": "PROJECT_ID "
}
보관된 백업 업데이트
보관된 주문형 및 자동 백업의 설명을 업데이트할 수 있습니다.
백업을 업데이트하려면 다음을 수행하세요.
콘솔
Cloud de Confiance 콘솔에서 Cloud SQL 백업 페이지로 이동합니다.
Cloud SQL 백업으로 이동
백업을 보려는 삭제된 인스턴스의 이름을 클릭합니다.
모든 보관된 백업과 최종 백업의 목록 및 삭제된 인스턴스의 세부정보가 표시됩니다.
업데이트하려는 보관된 백업의 경우 작업 더보기 를 클릭한 후 설명 수정 을 선택합니다.
백업 설명 수정 창에서 백업 설명을 업데이트합니다.
업데이트 를 클릭합니다.
gcloud 보관된 백업 설명을 업데이트하려면 gcloud sql backups patch 명령어를 사용합니다.
gcloud sql backups patch BACKUP_NAME
--description=BACKUP_DESCRIPTION
다음을 바꿉니다.
BACKUP_NAME
: 보관된 백업 이름
BACKUP_DESCRIPTION
: 보관된 백업에 추가할 새 설명
REST v1 모든 보관된 백업 목록 가져오기
이 예시를 사용하여Cloud de Confiance 프로젝트와 연결된 모든 보관된 백업 목록을 가져옵니다. 이 호출의 전체 파라미터 목록은 backups.listBackups
페이지를 참조하세요.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
HTTP 메서드 및 URL:
GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
cURL(Linux, macOS, Cloud Shell)
다음 명령어를 실행합니다.
curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups"
PowerShell(Windows)
다음 명령어를 실행합니다.
$cred = gcloud auth print-access-token $headers = @{ "Authorization" = "Bearer $cred" } Invoke-WebRequest ` -Method GET ` -Headers $headers ` -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups" | Select-Object -Expand Content
다음과 비슷한 JSON 응답이 표시됩니다.
응답
{
"name": "projects/PROJECT_ID /backups/BACKUP_ID ",
"kind": "sql#backup",
"state": "SUCCESSFUL",
"backupInterval": {
"startTime": "2020-01-21T11:25:33.858Z",
"endTime": "2020-01-21T11:26:18.663Z",
}
"type": "FINAL",
"instance": "INSTANCE_ID ",
"selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID ",
"location": "us"
"description": "This is a final backup.",
"backupKind": "SNAPSHOT",
"dataDiskSizeGB": "10",
"expiryTime": "2020-01-30T11:26:18.663Z",
"backup_run": "projects/PROJECT_ID /instances/INSTANCE_ID /backupRuns/BACKUP_RUN_ID ",
"satisfies_pzs": false,
"satisfies_pzi": false
}
설명 업데이트
이 예시를 사용하여 보관된 백업 설명을 업데이트합니다. 이 호출의 전체 파라미터 목록은 backups.updateBackup
페이지를 참조하세요.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
PROJECT_ID : 프로젝트 ID
BACKUP_ID : 백업 ID. 이 ID는 이전 호출 실행의 출력에서 가져옵니다.
DESCRIPTION : 최종 백업에 대한 업데이트된 설명입니다.
HTTP 메서드 및 URL:
PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID ?update_mask=description
JSON 요청 본문:
{
"backup": {
"description": DESCRIPTION ,
},
}
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
cURL(Linux, macOS, Cloud Shell)
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
curl -X PATCH \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ -d @request.json \ "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID ?update_mask=description"
PowerShell(Windows)
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
$cred = gcloud auth print-access-token $headers = @{ "Authorization" = "Bearer $cred" } Invoke-WebRequest ` -Method PATCH ` -Headers $headers ` -ContentType: "application/json; charset=utf-8" ` -InFile request.json ` -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID ?update_mask=description" | Select-Object -Expand Content
다음과 비슷한 JSON 응답이 표시됩니다.
응답
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID ",
"status": "DONE",
"user": "user@example.com",
"insertTime": "2024-02-15T00:10:22.078Z",
"operationType": "UPDATE_BACKUP",
"name": "OPERATION_ID ",
"targetId": "BACKUP_ID ",
"selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /operations/OPERATION_ID ",
"targetProject": "PROJECT_ID "
}
REST v1beta4 모든 보관된 백업 목록 가져오기
이 예시를 사용하여Cloud de Confiance 프로젝트와 연결된 모든 보관된 백업 목록을 가져옵니다. 이 호출의 전체 파라미터 목록은 backups.listBackups
페이지를 참조하세요.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
HTTP 메서드 및 URL:
GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
cURL(Linux, macOS, Cloud Shell)
다음 명령어를 실행합니다.
curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups"
PowerShell(Windows)
다음 명령어를 실행합니다.
$cred = gcloud auth print-access-token $headers = @{ "Authorization" = "Bearer $cred" } Invoke-WebRequest ` -Method GET ` -Headers $headers ` -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups" | Select-Object -Expand Content
다음과 비슷한 JSON 응답이 표시됩니다.
응답
{
"name": "projects/PROJECT_ID /backups/BACKUP_ID ",
"kind": "sql#backup",
"state": "SUCCESSFUL",
"backupInterval": {
"startTime": "2020-01-21T11:25:33.858Z",
"endTime": "2020-01-21T11:26:18.663Z",
}
"type": "FINAL",
"instance": "INSTANCE_ID ",
"selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID ",
"location": "us"
"description": "This is a final backup.",
"backupKind": "SNAPSHOT",
"dataDiskSizeGB": "10",
"expiryTime": "2020-01-30T11:26:18.663Z",
"backup_run": "projects/PROJECT_ID /instances/INSTANCE_ID /backupRuns/BACKUP_RUN_ID ",
"satisfies_pzs": false,
"satisfies_pzi": false
}
설명 업데이트
이 예시를 사용하여 보관된 백업 설명을 업데이트합니다. 이 호출의 전체 파라미터 목록은 backups.updateBackup
페이지를 참조하세요.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
PROJECT_ID : 프로젝트 ID
BACKUP_ID : 백업 ID. 이 ID는 이전 호출 실행의 출력에서 가져옵니다.
DESCRIPTION : 최종 백업에 대한 업데이트된 설명입니다.
HTTP 메서드 및 URL:
PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID ?update_mask=description
JSON 요청 본문:
{
"backup": {
"description": DESCRIPTION ,
},
}
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
cURL(Linux, macOS, Cloud Shell)
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
curl -X PATCH \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ -d @request.json \ "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID ?update_mask=description"
PowerShell(Windows)
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
$cred = gcloud auth print-access-token $headers = @{ "Authorization" = "Bearer $cred" } Invoke-WebRequest ` -Method PATCH ` -Headers $headers ` -ContentType: "application/json; charset=utf-8" ` -InFile request.json ` -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID ?update_mask=description" | Select-Object -Expand Content
다음과 비슷한 JSON 응답이 표시됩니다.
응답
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID ",
"status": "DONE",
"user": "user@example.com",
"insertTime": "2024-02-15T00:10:22.078Z",
"operationType": "UPDATE_BACKUP",
"name": "OPERATION_ID ",
"targetId": "BACKUP_ID ",
"selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /operations/OPERATION_ID ",
"targetProject": "PROJECT_ID "
}
삭제된 인스턴스와 연결된 백업 삭제
삭제된 인스턴스의 최종 또는 보관된 주문형 및 자동 백업은 언제든지 삭제할 수 있습니다.
참고: 보관된 백업 또는 최종 백업을 수동으로 삭제하면 복구할 수 없습니다.
콘솔
Cloud de Confiance 콘솔에서 Cloud SQL 백업 페이지로 이동합니다.
Cloud SQL 백업으로 이동
백업을 보려는 삭제된 인스턴스의 이름을 클릭합니다.
모든 보관된 백업과 최종 백업의 목록 및 삭제된 인스턴스의 세부정보가 표시됩니다.
삭제하려는 백업의 경우 추가 작업 을 클릭한 후 삭제 를 선택합니다.
백업 삭제 창에 삭제된 인스턴스의 이름을 입력한 후 삭제 를 클릭합니다.
REST v1 최종 또는 보관된 백업을 삭제하려면 이 예시를 사용합니다. 이 호출의 전체 파라미터 목록은 backups.deleteBackup
페이지를 참조하세요.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
PROJECT_ID : 프로젝트 ID
BACKUP_ID : 백업 ID. 이 ID는 이전 호출 실행의 출력에서 가져옵니다.
HTTP 메서드 및 URL:
DELETE https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
cURL(Linux, macOS, Cloud Shell)
다음 명령어를 실행합니다.
curl -X DELETE \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID "
PowerShell(Windows)
다음 명령어를 실행합니다.
$cred = gcloud auth print-access-token $headers = @{ "Authorization" = "Bearer $cred" } Invoke-WebRequest ` -Method DELETE ` -Headers $headers ` -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID " | Select-Object -Expand Content
다음과 비슷한 JSON 응답이 표시됩니다.
응답
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID ",
"status": "PENDING",
"user": "user@example.com",
"insertTime": "2020-01-21T22:43:37.981Z",
"operationType": "DELETE_BACKUP",
"name": "OPERATION_ID ",
"targetId": "BACKUP_ID ",
"selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /operations/OPERATION_ID ",
"targetProject": "PROJECT_ID "
}
REST v1beta4 최종 또는 보관된 백업을 삭제하려면 이 예시를 사용합니다. 이 호출의 전체 파라미터 목록은 backups.deleteBackup
페이지를 참조하세요.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
PROJECT_ID : 프로젝트 ID
BACKUP_ID : 백업 ID. 이 ID는 이전 호출 실행의 출력에서 가져옵니다.
HTTP 메서드 및 URL:
DELETE https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
cURL(Linux, macOS, Cloud Shell)
다음 명령어를 실행합니다.
curl -X DELETE \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID "
PowerShell(Windows)
다음 명령어를 실행합니다.
$cred = gcloud auth print-access-token $headers = @{ "Authorization" = "Bearer $cred" } Invoke-WebRequest ` -Method DELETE ` -Headers $headers ` -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID " | Select-Object -Expand Content
다음과 비슷한 JSON 응답이 표시됩니다.
응답
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID ",
"status": "PENDING",
"user": "user@example.com",
"insertTime": "2020-01-21T22:43:37.981Z",
"operationType": "DELETE_BACKUP",
"name": "OPERATION_ID ",
"targetId": "BACKUP_ID ",
"selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /operations/OPERATION_ID ",
"targetProject": "PROJECT_ID "
}
다음 단계
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스 에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스 에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책 을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-10-19(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-10-19(UTC)"],[],[]]