인스턴스 삭제 후 백업 보관을 선택했거나 인스턴스를 삭제하기 전에 최종 백업을 수행한 경우 인스턴스가 삭제된 후 백업을 관리할 수 있습니다. 보관된 백업에는 인스턴스가 사용 중일 때 생성된 자동 백업 및 주문형 백업이 포함됩니다. 인스턴스를 삭제하면 이러한 백업은 인스턴스와 독립적으로 프로젝트 수준에 저장됩니다. 백업 작동 방식과 보관되는 백업에 대한 자세한 내용은 Cloud SQL 백업 개요를 참고하세요.
인스턴스가 삭제된 후 이러한 백업을 사용하여 인스턴스를 복원할 수 있습니다.
시작하기 전에
Google Cloud 프로젝트에서 보관된 백업을 관리하려면 다음 권한이 필요합니다.
| 작업 | 필수 권한 |
|---|---|
| 백업 표시 | cloudsql.backupRuns.list |
| 백업 설명 | cloudsql.backupRuns.get |
| 백업 업데이트 | cloudsql.backupRuns.update |
| 백업 삭제 | cloudsql.backupRuns.delete |
| 작업 | 명령어 | 필수 권한 |
|---|---|---|
| 백업 표시 | 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 |
| 작업 | 메서드 | 필수 권한 |
|---|---|---|
| 백업 표시 | backups.listBackup |
cloudsql.backupRuns.list |
| 백업 설명 | backups.getBackup |
cloudsql.backupRuns.get |
| 백업 업데이트 | backups.updateBackup |
cloudsql.backupRuns.update |
| 백업 삭제 | backups.deleteBackup |
cloudsql.backupRuns.delete |
삭제된 인스턴스의 모든 백업 나열
Google Cloud 콘솔 프로젝트의 삭제된 인스턴스에 대해 보관된 모든 백업과 최종 백업의 목록을 볼 수 있습니다. 백업에는 백업 이름, 백업에 속한 인스턴스, 백업 유형, 인스턴스 삭제 시간과 같은 세부정보가 포함됩니다. 삭제된 인스턴스의 이름은 삭제 후 재사용될 수 있으므로 instance deletion time 필드를 사용하여 특정 백업이 속한 인스턴스를 구분하는 것이 좋습니다. 실시간 인스턴스의 경우 이 필드는 비어 있습니다.
Google Cloud 콘솔에서 Cloud SQL 백업 페이지로 이동합니다.
인스턴스의 백업 옵션(표준 등급 또는 고급 등급)을 선택합니다.
필터, 인스턴스 상태를 차례로 클릭하고 삭제된 인스턴스를 선택합니다.
이 페이지에는Google Cloud 콘솔 프로젝트에서 삭제된 모든 인스턴스가 나열됩니다.
백업을 보려는 삭제된 인스턴스의 이름을 클릭합니다.
이 페이지에는 삭제된 인스턴스의 모든 보관된 자동 및 주문형 백업과 최종 백업(있는 경우)이 나열됩니다.
Google Cloud 프로젝트와 연결된 모든 백업 목록을 가져오려면 gcloud sql backups list 명령어를 사용합니다.
gcloud sql backups list --project=PROJECT_ID 다음을 바꿉니다.
PROJECT_ID: Google Cloud 프로젝트의 ID입니다.
특정 보관된 백업에 대한 세부정보를 보려면 gcloud sql backups describe 명령어를 사용합니다.
gcloud sql backups describeBACKUP_NAME --project=PROJECT_ID 다음을 바꿉니다.
BACKUP_NAME: 보관된 백업 이름입니다.PROJECT_ID: Google Cloud 프로젝트의 ID입니다.
모든 백업 목록 가져오기
이 예시를 사용하여 Google Cloud 프로젝트와 연결된 모든 보관된 백업과 최종 백업의 목록을 가져옵니다. 이 호출의 전체 파라미터 목록은 backups.listBackups 페이지를 참조하세요.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- PROJECT_ID: 프로젝트 ID
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
}
모든 보관된 백업 목록 가져오기
이 예시를 사용하여Google Cloud 프로젝트와 연결된 모든 보관된 백업과 최종 백업의 목록을 가져옵니다. 이 호출의 전체 파라미터 목록은 backups.listBackups 페이지를 참조하세요.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- PROJECT_ID: 프로젝트 ID
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
}
인스턴스 삭제 후 보관된 백업 또는 최종 백업 업데이트
인스턴스를 삭제한 후에는 프로젝트 수준에 저장된 해당 인스턴스와 연결된 보관된 백업 또는 최종 백업의 설정을 업데이트할 수 있습니다. 백업 유형에 따라 업데이트할 수 있는 세부정보가 다를 수 있습니다.
인스턴스를 삭제하기 전에 수행한 최종 백업의 설명과 보관 설정을 업데이트할 수 있습니다. 하지만 인스턴스 삭제 후 보관되는 주문형 또는 자동 백업의 경우 이러한 백업의 설명만 업데이트할 수 있습니다. 보관된 백업의 경우 인스턴스가 사용 중일 때 백업의 보관 설정에 따라 보관 설정이 지정됩니다. 자세한 내용은 인스턴스 삭제 후 백업 보관을 참조하세요.
최종 백업 업데이트
인스턴스를 삭제하기 전에 생성된 최종 백업의 보관 설정과 설명을 업데이트할 수 있습니다. 백업을 업데이트하려면 다음을 수행하세요.
Google Cloud 콘솔에서 Cloud SQL 백업 페이지로 이동합니다.
백업을 보려는 삭제된 인스턴스의 이름을 클릭합니다.
모든 보관된 백업과 최종 백업의 목록 및 삭제된 인스턴스의 세부정보가 표시됩니다.
업데이트하려는 최종 백업의 경우 추가 작업
을 클릭한 후 다음 단계를 따르세요.최종 백업의 설명을 수정하려면 설명 수정을 클릭합니다.
이 백업 설명 필드에 설명을 입력한 다음 업데이트를 클릭합니다.
최종 백업의 보관 기간을 수정하려면 보관 기간 수정을 클릭합니다.
백업 보관 기한 필드에서 날짜를 선택합니다. 보관 기간은 인스턴스 삭제 후 1~365일입니다. 백업 보관 기한을 선택한 후 업데이트를 클릭합니다.
업데이트할 최종 백업의 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일입니다.
업데이트할 최종 백업의 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 "
}
업데이트할 최종 백업의 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 "
}
보관된 백업 업데이트
보관된 주문형 및 자동 백업의 설명을 업데이트할 수 있습니다. 백업을 업데이트하려면 다음을 수행하세요.
Google Cloud 콘솔에서 Cloud SQL 백업 페이지로 이동합니다.
백업을 보려는 삭제된 인스턴스의 이름을 클릭합니다.
모든 보관된 백업과 최종 백업의 목록 및 삭제된 인스턴스의 세부정보가 표시됩니다.
업데이트하려는 보관된 백업의 경우 작업 더보기
를 클릭한 후 설명 수정을 선택합니다.백업 설명 수정 창에서 백업 설명을 업데이트합니다.
업데이트를 클릭합니다.
보관된 백업 설명을 업데이트하려면 gcloud sql backups patch 명령어를 사용합니다.
gcloud sql backups patch BACKUP_NAME
--description=BACKUP_DESCRIPTION
다음을 바꿉니다.
BACKUP_NAME: 보관된 백업 이름BACKUP_DESCRIPTION: 보관된 백업에 추가할 새 설명
모든 보관된 백업 목록 가져오기
이 예시를 사용하여Google Cloud 프로젝트와 연결된 모든 보관된 백업 목록을 가져옵니다. 이 호출의 전체 파라미터 목록은 backups.listBackups 페이지를 참조하세요.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- PROJECT_ID: 프로젝트 ID
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 "
}
모든 보관된 백업 목록 가져오기
이 예시를 사용하여Google Cloud 프로젝트와 연결된 모든 보관된 백업 목록을 가져옵니다. 이 호출의 전체 파라미터 목록은 backups.listBackups 페이지를 참조하세요.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- PROJECT_ID: 프로젝트 ID
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 "
}
삭제된 인스턴스와 연결된 백업 삭제
삭제된 인스턴스의 최종 또는 보관된 주문형 및 자동 백업은 언제든지 삭제할 수 있습니다.
Google Cloud 콘솔에서 Cloud SQL 백업 페이지로 이동합니다.
백업을 보려는 삭제된 인스턴스의 이름을 클릭합니다.
모든 보관된 백업과 최종 백업의 목록 및 삭제된 인스턴스의 세부정보가 표시됩니다.
삭제하려는 백업의 경우 추가 작업
을 클릭한 후 삭제를 선택합니다.백업 삭제 창에 삭제된 인스턴스의 이름을 입력한 후 삭제를 클릭합니다.
보관된 백업을 삭제하려면 gcloud sql backups delete 명령어를 사용합니다.
gcloud sql backups delete BACKUP_NAME
다음을 바꿉니다.
BACKUP_NAME: 보관된 백업 이름
최종 또는 보관된 백업을 삭제하려면 이 예시를 사용합니다. 이 호출의 전체 파라미터 목록은 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 "
}
최종 또는 보관된 백업을 삭제하려면 이 예시를 사용합니다. 이 호출의 전체 파라미터 목록은 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 "
}