외부 IPv4 주소를 다른 프로젝트로 이동

고정 외부 IPv4 주소는 Google Cloud 프로젝트와 연결되며 해당 프로젝트 내에서만 사용할 수 있습니다. 그러나 한 프로젝트에서 다른 프로젝트로 고정 외부 IPv4 주소를 이동할 수 있습니다.

IAM 역할 및 권한

리전 IP 주소를 이동하려면 다음 권한이 있어야 합니다.

소스 프로젝트의 compute.addresses.delete
대상 프로젝트의 compute.addresses.create

전역 IP 주소를 이동하려면 다음 권한이 있어야 합니다.

소스 프로젝트의 compute.globalAddresses.delete
대상 프로젝트의 compute.globalAddresses.create

이러한 권한이 포함된 역할의 예:

Compute 관리자(roles/compute.admin)
Compute 네트워크 관리자(roles/compute.networkAdmin)
Compute 공개 IP 관리자(roles/compute.publicIpAdmin)

시작하기 전에

IP 주소를 이동할 프로젝트가 있는지 확인합니다. 그렇지 않으면 프로젝트를 생성합니다.
대상 프로젝트에서 Compute Engine API를 사용 설정합니다.
이동하는 IP 주소의 해당 할당량에 대해 대상 프로젝트에 사용 가능한 용량이 충분한지 확인합니다.
- 리전 외부 IP 주소의 경우 고정 IP 주소 할당량을 확인합니다.
- 전역 외부 IP 주소의 경우 전역 고정 IP 주소 할당량을 확인합니다.
- 모든 IP 주소의 주소 이동 요청 할당량을 확인합니다.
이동하려는 IP 주소에 다음 속성이 있는지 확인합니다.
- 액세스 유형은 외부입니다.
- IP 버전은 IPv4입니다.
- IP 주소가 임시 주소가 아닌 예약(고정)되어 있습니다.
  
  IP 주소를 예약하려면 새 고정 외부 IP 주소 예약을 참조하세요.
- IP 주소가 VM 인스턴스 또는 전달 규칙과 같은 리소스에서 사용되지 않습니다.
  
  IP 주소를 할당 해제하려면 고정 외부 IP 주소 할당 해제를 참조하세요.
- IP 주소가 Cloud 지원팀에서 연속 IP 주소 범위의 일부로 예약되지 않았습니다. 자세한 내용은 외부 IPv4 주소 이동 실패를 참조하세요.

제한사항

IP 주소를 할당 해제하는 경우 이동하기 전에 잠시 기다려야 합니다.
- 전역 IP 주소의 경우 10분 동안 기다립니다.
- 리전 IP 주소의 경우 20분 정도 기다립니다.
리전 IP 주소의 리전을 변경할 수 없습니다.
전역 IP 주소를 리전 IP 주소로 변환하거나 리전 IP 주소를 전역 IP 주소로 변환할 수 없습니다.

할당량

분당 이동할 수 있는 주소 수에는 한도가 있습니다. 자세한 내용은 VPC 문서의 다음 프로젝트별 할당량을 참조하세요.

외부 IPv4 주소를 다른 프로젝트로 이동

리전 또는 전역 외부 IPv4 주소를 한 프로젝트에서 다른 프로젝트로 이동할 수 있습니다. IP 주소를 이동하면 기본적으로 IP 주소 리소스에 동일한 이름과 설명이 할당됩니다. 하지만 새 이름이나 설명을 할당할 수 있습니다. 외부 IPv4 주소가 새 프로젝트로 이동한 후에는 해당 프로젝트의 운영 가능 리소스에 할당할 수 있습니다.

콘솔

Google Cloud 콘솔에서 IP 주소로 이동합니다.

IP 주소로 이동
이동하려는 IP 주소의 작업 더보기 메뉴()에서 다른 프로젝트로 이동을 선택합니다.
프로젝트 선택을 클릭한 다음 IP 주소를 이동할 프로젝트를 선택합니다.
선택사항: IP 주소의 새 이름을 입력합니다.
선택사항: IP 주소의 새 설명을 입력합니다.
이동을 클릭합니다.

gcloud

명령어 옵션은 리전 또는 전역 IP 주소를 이동하는지와 주소 이름 또는 설명을 유지하거나 바꾸는지 여부에 따라 달라집니다. 다음 예시에서는 이러한 조합 중 일부를 설명합니다.

리전 외부 IPv4 주소를 다른 프로젝트로 이동합니다.

gcloud compute addresses move ADDRESS_NAME \
    --target-project=TARGET_PROJECT \
    --region=REGION

리전 외부 IPv4 주소를 다른 프로젝트로 이동하고 새 프로젝트에 새 이름과 설명을 할당합니다.

gcloud compute addresses move ADDRESS_NAME \
    --target-project=TARGET_PROJECT \
    --new-name=NEW_NAME \
    --description=NEW_DESCRIPTION \
    --region=REGION

전역 외부 IPv4 주소를 다른 프로젝트로 이동합니다.

gcloud compute addresses move ADDRESS_NAME \
    --target-project=TARGET_PROJECT \
    --global

다음을 바꿉니다.

ADDRESS_NAME: 이동하려는 IP 주소 리소스의 이름입니다.
TARGET_PROJECT: IP 주소를 이동할 프로젝트의 이름 또는 ID입니다.
REGION: IP 주소의 리전입니다.
NEW_NAME: 새 프로젝트의 IP 주소 리소스의 새 이름입니다.
NEW_DESCRIPTION: 새 프로젝트의 IP 주소 리소스의 새 이름입니다. 생략하면 기존 설명(있는 경우)이 리소스에 사용됩니다.

자세한 내용은 gcloud compute addresses move 참조 문서를 확인하세요.

API

요청 세부정보는 리전 또는 전역 IP 주소를 이동하는지와 주소 이름 또는 설명을 유지하거나 바꾸는지 여부에 따라 달라집니다. 다음 예시에서는 이러한 조합 중 일부를 설명합니다.

리전 외부 IPv4 주소를 다른 프로젝트로 이동합니다.

POST https://www.googleapis.com/compute/v1/projects/SOURCE_PROJECT/regions/REGION/addresses/ADDRESS_NAME/move
{
  "destination_address": "projects/TARGET_PROJECT/global/addresses/ADDRESS_NAME",
}

리전 외부 IPv4 주소를 다른 프로젝트로 이동하고 새 프로젝트에 새 이름과 설명을 할당합니다.

POST https://www.googleapis.com/compute/v1/projects/SOURCE_PROJECT/regions/REGION/addresses/ADDRESS_NAME/move
{
  "destination_address": "projects/TARGET_PROJECT/global/addresses/NEW_NAME",
  "description": "NEW_DESCRIPTION",
}

전역 외부 IPv4 주소를 다른 프로젝트로 이동합니다.

POST https://www.googleapis.com/compute/v1/projects/SOURCE_PROJECT/global/addresses/ADDRESS_NAME/move
{
  "destination_address": "projects/TARGET_PROJECT/global/addresses/ADDRESS_NAME",
}

다음을 바꿉니다.

ADDRESS_NAME: 이동하려는 IP 주소 리소스의 이름입니다.
SOURCE_PROJECT: IP 주소를 이동할 프로젝트의 이름 또는 ID입니다.
TARGET_PROJECT: IP 주소를 이동할 프로젝트의 이름 또는 ID입니다.
REGION: IP 주소의 리전입니다.
NEW_NAME: 새 프로젝트의 IP 주소 리소스의 새 이름입니다.
NEW_DESCRIPTION: 새 프로젝트의 IP 주소 리소스의 새 이름입니다. 생략하면 기존 설명(있는 경우)이 리소스에 사용됩니다.

문제 해결

외부 IPv4 주소 이동 실패

외부 IPv4 주소를 이동하려고 하면 다음 오류 메시지가 표시될 수 있습니다.

Invalid resource usage: 'Cannot move address that belongs to a reserved address range. Address range must be disassembled first.'

이 메시지가 표시되면 IP 주소가 Cloud 지원에서 연속 IP 주소 범위의 일부로 예약되었음을 의미합니다. 이 유형의 IP 주소를 이동하려면 Cloud 지원에 문의하세요. Cloud 지원은 전체 IP 주소 범위를 다른 프로젝트로 이동할 수 있습니다. 범위의 일부만 이동하는 것은 지원되지 않습니다.

IP 주소가 Cloud 지원에서 예약한 범위의 일부인지 확인하려면 다음을 수행하세요.

고정 외부 IP 주소를 나열한 후 확인할 IP 주소를 찾습니다.
IP 주소의 이름을 확인합니다. IP 주소가 Cloud 지원에 의해 예약된 경우 해당 이름은 문자열 뒤에 하이픈으로 구분된 4바이트의 IP 주소로 구성됩니다. 예를 들어 IP 주소가 198.51.100.2이고 Cloud 지원에서 예약한 경우 이름은 STRING-198-51-100-2 형식입니다. 동일한 범위의 일부로 예약된 다른 IP 주소는 동일한 문자열과 IP 주소를 차례로 공유합니다.