Apigee 조직 삭제

이 페이지는 Apigee에 적용되지만 Apigee Hybrid에는 적용되지 않습니다.

Apigee Edge 문서 보기

이 페이지에서는 Apigee가 자체적으로 정리하지 않는 네트워킹 리소스를 해제하는 데 필요한 후속 단계를 포함하여 Google Cloud 프로젝트에서 Apigee 조직을 완전히 삭제하는 방법을 설명합니다. 수행해야 하는 삭제 후 정리는 조직이 프로비저닝된 방식에 따라 다릅니다.

  • VPC 피어링이 사용 설정된 상태로 프로비저닝된 조직에는 VPC와 Apigee 테넌트 네트워크 간에 서비스 네트워킹 VPC 피어링 연결도 있습니다. 이 연결과 연결과 연결된 예약된 피어링 범위 및 VPC 네트워크는 조직을 삭제한 후에도 그대로 유지되며 더 이상 필요하지 않은 경우 별도로 삭제해야 합니다. 후속 조치: VPC 피어링으로 프로비저닝된 조직을 참조하세요.

  • VPC 피어링이 사용 중지된 상태로 프로비저닝된 조직은 서비스 네트워킹 연결 대신 Private Service Connect를 사용하므로 삭제할 프로듀서 피어링이 없습니다. 조직을 프로비저닝할 때 만든 북쪽 Private Service Connect 부하 분산기(전달 규칙, 대상 HTTPS 프록시, URL 맵, 백엔드 서비스, PSC 네트워크 엔드포인트 그룹, SSL 인증서, 예약된 IP 주소)를 삭제해야 합니다. 그렇지 않으면 전달 규칙 및 예약된 IP 주소에 요금이 계속 청구됩니다. 후속 조치: VPC 피어링 없이 프로비저닝된 조직을 참조하세요.

시작하기 전에에서는 조직이 속한 카테고리를 확인하는 방법을 보여줍니다.

시작하기 전에

필수 IAM 권한

  • Apigee 조직(일반적으로 APIGEE_PROJECT_ID): apigee.organizations.delete 이 권한은 roles/apigee.admin 역할에 포함되어 있으며, Apigee 역할 가이드에서는 조직을 만들거나 삭제하거나 업데이트할 수 있는 유일한 역할로 설명합니다.

  • 또한 조직이 VPC 피어링이 사용 설정된 상태로 프로비저닝되었고 후속 조치: VPC 피어링으로 프로비저닝된 조직에 설명된 대로 서비스 네트워킹 연결, VPC 피어링 범위 또는 VPC 네트워크를 삭제하려는 경우: 피어링된 VPC 네트워크를 소유한 프로젝트(네트워크 프로젝트, 공유 VPC 설정의 Apigee 프로젝트와 다를 수 있음), servicenetworking.services.deleteConnection, compute.globalAddresses.delete, compute.networks.delete.

종속 리소스 먼저 삭제

조직을 삭제하기 전에 Apigee에서 먼저 삭제해야 하는 리소스를 삭제합니다.

보존하려는 데이터 백업

나중에 필요할 수 있는 조직 범위 데이터 또는 리소스를 백업합니다. 보관 기간이 경과하면 조직에 저장된 데이터를 복구할 수 없습니다.

조직에서 VPC 피어링을 사용하는지 확인

조직을 삭제한 후 수행해야 하는 후속 삭제 작업은 VPC 피어링이 사용 설정된 상태로 조직이 프로비저닝되었는지 여부에 따라 달라집니다. 조직을 삭제하기 전에 organizations.get API를 사용하여 조직의 구성을 읽습니다. 

curl -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://apigee.googleapis.com/v1/organizations/ORGANIZATION"

이 페이지의 이 Apigee REST 호출과 다른 모든 Apigee REST 호출은 전역 apigee.googleapis.com 엔드포인트를 타겟팅합니다. 조직이 데이터 레지던시 리전에 있는 경우 모든 샘플에서 해당 리전 엔드포인트를 대체합니다.

응답에서 disableVpcPeering 필드를 찾습니다.

  • 응답에 "disableVpcPeering": true가 포함되어 있으면 조직이 VPC 피어링 없이 프로비저닝된 것입니다. 조직을 삭제한 후 후속 조치: VPC 피어링 없이 프로비저닝된 조직을 따릅니다.

  • 필드가 false이거나 없는 경우 조직이 VPC 피어링으로 프로비저닝된 것입니다. 동일한 응답에서 다음 두 가지 추가 값을 기록합니다. 정리 중에 필요합니다.

    • Apigee와 피어링된 VPC 네트워크를 식별하는 authorizedNetwork 필드 다음 두 가지 형식 중 하나로 표시됩니다.
      • 네트워크 프로젝트와 네트워크 이름을 모두 인코딩하는 전체 리소스 경로 projects/NETWORK_PROJECT_ID/global/networks/NETWORK_NAME입니다. 이 양식은 네트워크가 Apigee 조직과 다른 프로젝트에 있는 경우에 사용됩니다. 가장 일반적으로 네트워크가 호스트 프로젝트에 있는 공유 VPC 설정에서 사용됩니다.
      • 네트워크 이름만(예: apigee-network). 이름만 있는 경우 네트워크는 Apigee 조직과 동일한 Google Cloud 프로젝트에 있습니다. 정리 단계에서 해당 프로젝트(APIGEE_PROJECT_ID)를 NETWORK_PROJECT_ID로 처리합니다.
      authorizedNetwork는 VPC 피어링 조직에만 설정됩니다.
    • VPC 피어링 범위에 대해 원래 예약한 전역 주소의 이름입니다(예: apigee-range). 조직을 처음 프로비저닝할 때 이 주소를 예약했습니다.

    조직을 삭제한 후 후속 조치: VPC 피어링으로 프로비저닝된 조직을 따릅니다.

Apigee 조직 삭제

organizations.delete API를 호출하여 조직을 삭제합니다. 이 호출은 장기 실행 작업을 반환하고 평가 조직의 경우 즉시 삭제를 수행합니다. 유료 조직(구독 또는 사용한 만큼만 지불)의 경우 보관 기간에 따라 소프트 삭제를 수행합니다. 

curl -X DELETE \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://apigee.googleapis.com/v1/organizations/ORGANIZATION"

유료 조직에 최소(24시간) 보관 기간을 사용하려면 retention 쿼리 매개변수를 추가합니다. 

curl -X DELETE \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://apigee.googleapis.com/v1/organizations/ORGANIZATION?retention=MINIMUM"

응답에는 장기 실행 작업이 포함됩니다. organizations.operations.get으로 폴링할 수 있습니다.

후속 조치: VPC 피어링 없이 프로비저닝된 조직

조직의 disableVpcPeering 필드가 true인 경우 조직을 삭제해도 서비스 네트워킹 리소스가 해제되지 않습니다. VPC 피어링 없이 프로비저닝된 조직에는 서비스 네트워킹 연결이 없으며 삭제할 프로듀서 피어링이 없기 때문입니다.

조직을 프로비저닝할 때 자체 프로젝트에서 만든 북쪽 방향 Private Service Connect 부하 분산기를 삭제해야 합니다. 이러한 리소스는 Apigee의 소유가 아니며 organizations.delete에서 출시하지 않습니다. 종속 항목 역순으로 삭제합니다.

  1. 전달 규칙
  2. 대상 HTTPS 프록시
  3. URL 맵
  4. 백엔드 서비스
  5. PSC 네트워크 엔드포인트 그룹
  6. SSL 인증서
  7. 예약된 IP 주소

노스바운드 정리가 완료되면 보관 기간 및 재프로비저닝으로 진행합니다.

후속 조치: VPC 피어링으로 프로비저닝된 조직

Apigee 조직을 삭제해도 조직이 프로비저닝될 때 설정한 서비스 네트워킹 VPC 피어링 연결이 해제되지 않습니다. 연결은 예약된 피어링 범위 및 피어링 전용 VPC 네트워크와 함께 VPC 네트워크에 유지됩니다. 이러한 리소스가 더 이상 필요하지 않으면 표준 비공개 서비스 액세스 구성 및 서비스 네트워킹 절차에 따라 삭제를 완료합니다. 이 섹션의 나머지 부분에서는 Apigee 해제와 관련된 값과 경고만 제공합니다.

필요한 값 수집

다음 정리 단계에서는 연결된 서비스 네트워킹 및 VPC 가이드의 절차에 연결하기 위해 동일한 소수의 값을 재사용합니다. 각 값을 한 번 결정한 후 연결된 명령어를 그대로 복사할 수 있도록 셸 변수로 설정합니다.

  • NETWORK_PROJECT_ID — 피어링된 VPC 네트워크를 소유하는 프로젝트입니다. 이는 Apigee 서비스 프로젝트와 항상 동일하지는 않습니다. 공유 VPC 설정에서 네트워크는 호스트 프로젝트에 있습니다. 조직에서 VPC 피어링을 사용하는지 확인에서 기록한 authorizedNetwork 값에서 파생합니다.

    • authorizedNetwork가 전체 리소스 경로 projects/NETWORK_PROJECT_ID/global/networks/NETWORK_NAME인 경우 해당 경로에서 NETWORK_PROJECT_ID를 가져옵니다.
    • authorizedNetwork가 네트워크 이름(예: apigee-network)인 경우 네트워크는 Apigee 조직과 동일한 프로젝트에 있습니다. Apigee 프로젝트(APIGEE_PROJECT_ID)를 사용합니다.

  • NETWORK_NAME — VPC 네트워크 이름(예: apigee-network). authorizedNetwork의 전체 경로에서 가져오거나 authorizedNetwork가 이름인 경우 기본 값을 사용합니다.

  • APIGEE_RANGE_NAME — 조직이 프로비저닝될 때 VPC 피어링 범위에 할당된 전역 주소의 이름입니다(예: apigee-range). gcloud services vpc-peerings list에서 반환된 reservedPeeringRanges 목록에서 피어링에 연결된 예약된 범위를 확인할 수 있습니다.

  • NETWORK_PROJECT_ID의 숫자 프로젝트 번호인 NETWORK_PROJECT_NUMBER 서비스 네트워킹 REST API에는 consumerNetwork 필드에 프로젝트 번호(프로젝트 ID 아님)가 필요합니다.

    gcloud projects describe NETWORK_PROJECT_ID \
  --format="value(projectNumber)"

연결된 절차에서 네트워크, 네트워크 프로젝트 또는 소비자 네트워크를 요청할 때마다 이러한 값을 대체합니다.

Apigee 해제에 적용되는 경고

정리 완료

필요한 값 수집의 변수를 대체하여 연결된 절차를 따릅니다.

  • 서비스 네트워킹 연결을 삭제합니다. 비공개 연결 삭제를 따릅니다. Apigee 조직 삭제에서 Apigee 조직을 이미 삭제했으므로 서비스 인스턴스를 삭제하는 가이드의 기본 요건이 평가 조직에 대해 충족되며, 즉시 삭제됩니다. 유료 조직의 경우 삭제는 소프트 삭제이며 보관 기간이 경과한 후에만 연결 삭제가 성공합니다. 보관 기간 및 재프로비저닝을 참조하거나 ?retention=MINIMUM로 조직을 삭제하여 기간을 24시간으로 단축하세요. 절차에서 네트워크 및 네트워크 프로젝트를 요청하면 NETWORK_NAME 및 NETWORK_PROJECT_ID를 사용합니다. 기본 services.connections.deleteConnection REST 호출에서 consumerNetwork를 요청하면 projects/NETWORK_PROJECT_NUMBER/global/networks/NETWORK_NAME를 사용합니다.

  • (선택사항) 예약된 피어링 범위를 해제합니다. APIGEE_RANGE_NAME 및 NETWORK_PROJECT_ID를 사용하여 할당된 IP 주소 범위 삭제를 따릅니다. 예약된 범위는 Apigee 조직 및 서비스 네트워킹 연결이 삭제된 후에도 유지되는 고객 소유 리소스입니다. 그대로 두어도 Google Cloud 서비스가 중단되지 않습니다.

  • (선택사항) VPC 네트워크를 삭제합니다. 이 네트워크의 관리형 인스턴스 그룹 또는 내부 부하 분산기를 통해 북쪽 방향 트래픽을 라우팅한 경우 해당 리소스를 먼저 삭제하세요. 그렇지 않으면 전달 규칙, 대상 프록시, URL 맵, 백엔드 서비스, 관리형 인스턴스 그룹, 인스턴스 템플릿, 상태 점검, 방화벽 규칙, 예약된 주소와 같은 종속 리소스 오류로 인해 네트워크 삭제가 실패합니다. 그런 다음 NETWORK_NAME 및 NETWORK_PROJECT_ID를 사용하여 VPC 네트워크 가이드의 네트워크 삭제를 따릅니다.

보관 기간 및 재프로비저닝

organizations.delete 참조에 설명된 대로 다음을 수행합니다.

  • Apigee는 평가 조직을 즉시 삭제합니다.
  • Apigee는 기본 7일 보관 기간으로 유료 조직(구독 또는 사용한 만큼만 지불)을 소프트 삭제합니다. 보관 기간 동안 Apigee에 지원 티켓을 제출하여 조직을 복원할 수 있습니다. 삭제 요청 시 ?retention=MINIMUM를 전달하면 기간이 24시간으로 단축됩니다.
  • 보관 기간 동안 동일한 Google Cloud 프로젝트에서 Apigee 조직을 다시 만들 수 없습니다.

다음 단계

Apigee 참조:

서비스 네트워킹 및 비공개 서비스 액세스 참조: