새 네트워크 아키텍처로 인스턴스 업그레이드

gcloud

gcloud CLI 설치 및 시작에 대한 자세한 내용은 gcloud CLI 설치를 참조하세요. Cloud Shell 시작 방법에 대한 자세한 내용은 Cloud Shell 사용을 참조하세요.

단일 인스턴스의 네트워크 아키텍처를 확인하려면 다음 명령어를 실행합니다.

   gcloud sql instances describe INSTANCE_NAME
   

인스턴스에 이전 네트워크 아키텍처가 사용되는 경우 다음과 유사한 응답이 표시됩니다.

   name: INSTANCE_NAME
   project: PROJECT_ID
   ...
   sql_network_architecture: OLD_NETWORK_ARCHITECTURE
  

인스턴스에 새 네트워크 아키텍처가 사용되는 경우 다음과 유사한 응답이 표시됩니다.

   name: INSTANCE_NAME
   project: PROJECT_ID
   ...
   sql_network_architecture: NEW_NETWORK_ARCHITECTURE
  

sql_network_architecture 매개변수는 인스턴스에 이전 네트워크 아키텍처 (OLD_NETWORK_ARCHITECTURE)가 사용되는지 또는 새 네트워크 아키텍처 (NEW_NETWORK_ARCHITECTURE)가 사용되는지를 나타냅니다.

REST v1

인스턴스의 네트워크 아키텍처를 확인하려면 Cloud SQL Admin API의 instances.get 메서드를 사용합니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

• PROJECT_ID: 프로젝트 ID입니다.
• INSTANCE_NAME: 인스턴스 이름입니다.
• NETWORK_ARCHITECTURE_TYPE: 네트워크 아키텍처 유형은 다음과 같이 정의됩니다.
  • OLD_NETWORK_ARCHITECTURE: 인스턴스에서 이전 네트워크 아키텍처를 사용합니다.
  • NEW_NETWORK_ARCHITECTURE: 인스턴스에서 새 네트워크 아키텍처를 사용합니다.

HTTP 메서드 및 URL:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

JSON 요청 본문:

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

curl -X GET \
     -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/instances/INSTANCE_NAME"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "kind": sql#instance
  "name": INSTANCE_NAME
  "project": PROJECT_ID
  "sqlNetworkArchitecture": enum (SqlNetworkArchitecture)
  ...
}

REST v1beta4

인스턴스의 네트워크 아키텍처를 확인하려면 Cloud SQL Admin API의 instances.get 메서드를 사용합니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

• PROJECT_ID: 프로젝트 ID입니다.
• INSTANCE_NAME: 인스턴스 이름입니다.
• NETWORK_ARCHITECTURE_TYPE: 네트워크 아키텍처 유형은 다음과 같이 정의됩니다.
  • OLD_NETWORK_ARCHITECTURE: 인스턴스에서 이전 네트워크 아키텍처를 사용합니다.
  • NEW_NETWORK_ARCHITECTURE: 인스턴스에서 새 네트워크 아키텍처를 사용합니다.

HTTP 메서드 및 URL:

GET https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

JSON 요청 본문:

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "kind": sql#instance
  "name": INSTANCE_NAME
  "project": PROJECT_ID
  "sqlNetworkArchitecture": enum (SqlNetworkArchitecture)
  ...
}

gcloud

프로젝트에 있는 여러 인스턴스의 네트워크 아키텍처를 확인하려면 다음 명령어를 실행합니다.

gcloud sql instances list --show-sql-network-architecture

결과는 다음과 유사합니다.

NAME        DATABASE_VERSION LOCATION   ...     SQL_NETWORK_ARCHITECTURE
instance_1  POSTGRES_13      asia-northeast1-b  OLD_NETWORK_ARCHITECTURE
instance_2  MYSQL_5_7        europe-west1-d     NEW_NETWORK_ARCHITECTURE
...

REST v1

프로젝트에 있는 여러 인스턴스의 네트워크 아키텍처를 확인하려면 instance.list 메서드를 사용합니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

• PROJECT_ID: 프로젝트 ID입니다.
• NETWORK_ARCHITECTURE_TYPE: 네트워크 아키텍처 유형은 다음과 같습니다.
  • OLD_NETWORK_ARCHITECTURE: 인스턴스에서 이전 네트워크 아키텍처를 사용합니다.
  • NEW_NETWORK_ARCHITECTURE: 인스턴스에서 새 네트워크 아키텍처를 사용합니다.

HTTP 메서드 및 URL:

LIST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances

JSON 요청 본문:

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

curl -X LIST \
     -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/instances"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method LIST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "kind": sql#instance
  "name": INSTANCE_NAME
  "project": PROJECT_ID
  "sqlNetworkArchitecture": enum (SqlNetworkArchitecture)
  ...
}

REST v1beta4

프로젝트에 있는 여러 인스턴스의 네트워크 아키텍처를 확인하려면 instance.list 메서드를 사용합니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

• PROJECT_ID: 프로젝트 ID입니다.
• NETWORK_ARCHITECTURE_TYPE: 네트워크 아키텍처 유형은 다음과 같이 정의됩니다.
  • OLD_NETWORK_ARCHITECTURE: 인스턴스에서 이전 네트워크 아키텍처를 사용합니다.
  • NEW_NETWORK_ARCHITECTURE: 인스턴스에서 새 네트워크 아키텍처를 사용합니다.

HTTP 메서드 및 URL:

LIST https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances

JSON 요청 본문:

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

curl -X LIST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method LIST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "kind": sql#instance
  "name": INSTANCE_NAME
  "project": PROJECT_ID
  "sqlNetworkArchitecture": enum (SqlNetworkArchitecture)
  ...
}

gcloud

인스턴스의 네트워크 아키텍처를 업그레이드하려면 다음 명령어를 실행합니다.

gcloud sql instances patch INSTANCE_NAME --upgrade-sql-network-architecture

업그레이드 작업은 몇 분 정도 걸립니다.

업그레이드하는 동안 장기 실행 작업이 시작되고 작업 토큰이 반환됩니다.

operation_id

REST v1

인스턴스의 네트워크 아키텍처를 업그레이드하려면 Cloud SQL Admin API의 instance.update 또는 instance.patch 메서드를 사용합니다.

Cloud SQL 네트워크 아키텍처를 업그레이드하는 경우 요청에 인스턴스에 대한 추가 업데이트가 허용되지 않습니다. 요청 본문에는 sqlNetworkArchitecture가 NEW_NETWORK_ARCHITECTURE로 설정된 DatabaseInstance 객체의 인스턴스가 포함됩니다.

업그레이드하는 동안 장기 실행 작업이 시작되고 작업 토큰이 반환됩니다.

operation_id

요청 데이터를 사용하기 전에 다음을 바꿉니다.

• PROJECT_ID: 프로젝트 ID입니다.
• INSTANCE_NAME: 인스턴스 이름입니다.
• NETWORK_ARCHITECTURE_TYPE: 네트워크 아키텍처 유형은 다음과 같이 정의됩니다.
  • OLD_NETWORK_ARCHITECTURE: 인스턴스에서 이전 네트워크 아키텍처를 사용합니다.
  • NEW_NETWORK_ARCHITECTURE: 인스턴스에서 새 네트워크 아키텍처를 사용합니다.

HTTP 메서드 및 URL:

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

JSON 요청 본문:

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

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/instances/INSTANCE_NAME"

$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/instances/INSTANCE_NAME" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "kind": sql#instance,
  "targetLink": string,
  "status": enum (SqlOperationStatus),
  "name": string,
  "insertTime": string,
  "startTime": string,
  "endTime": string
  ...
}

인스턴스 업그레이드가 실패하면 업그레이드 작업을 다시 시도하세요.

REST v1beta4

인스턴스의 네트워크 아키텍처를 업그레이드하려면 Cloud SQL Admin API의 instance.update method 또는 instance.patch method를 사용합니다.

Cloud SQL 네트워크 아키텍처를 업그레이드하는 경우 요청에 인스턴스에 대한 추가 업데이트가 허용되지 않습니다. 요청 본문에는 sqlNetworkArchitecture가 NEW_NETWORK_ARCHITECTURE로 설정된 DatabaseInstance 객체의 인스턴스가 포함됩니다.

업그레이드하는 동안 장기 실행 작업이 시작되고 다음 작업 토큰이 반환됩니다.

operation_id

요청 데이터를 사용하기 전에 다음을 바꿉니다.

• PROJECT_ID: 프로젝트 ID입니다.
• INSTANCE_NAME: 인스턴스 이름입니다.
• NETWORK_ARCHITECTURE_TYPE: 네트워크 아키텍처 유형은 다음과 같이 정의됩니다.
  • OLD_NETWORK_ARCHITECTURE: 인스턴스에서 이전 네트워크 아키텍처를 사용합니다.
  • NEW_NETWORK_ARCHITECTURE: 인스턴스에서 새 네트워크 아키텍처를 사용합니다.

HTTP 메서드 및 URL:

PATCH https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

JSON 요청 본문:

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

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/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

$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/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "kind": sql#instance,
  "targetLink": string,
  "status": enum (SqlOperationStatus),
  "name": string,
  "insertTime": string,
  "startTime": string,
  "endTime": string
  ...
}

어떤 이유로든 인스턴스 업그레이드가 실패하면 업그레이드 작업을 다시 시도할 수 있습니다.