사용한 만큼만 지불 환경 유형 업데이트

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

Apigee의 사용한 만큼만 지불 요금제 속성은 Apigee 인스턴스에 연결하는 환경 유형을 일부 기반으로 합니다. 언제든지 사용한 만큼만 지불 조직에 기본, 중급 또는 고급 환경을 추가하여 기능 및 용량 요구사항에 따라 가격 책정 체계를 조정할 수 있습니다. 이 주제에서는 기존 환경의 유형을 업그레이드 또는 다운그레이드하여 기능을 추가하거나 삭제하고 Apigee 사용한 만큼만 지불 결제 및 리소스 사용량을 관리할 수 있습니다.

필수 역할 및 권한

사용한 만큼만 지불 환경 유형을 업데이트하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.

Apigee 조직 관리자(apigee.organization.admin)
Apigee 환경 관리자(apigee.environment.admin)

역할 부여에 대한 자세한 내용은 액세스 관리를 참조하세요.

커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.

API를 사용하여 환경 유형 업데이트

기존 사용한 만큼만 지불 환경의 유형을 업데이트하려면 다음 명령어를 사용합니다.

curl "https://apigee.googleapis.com/v1/organizations/ORG_NAME/environments/ENV_NAME?updateMask=type" \
  -H "Authorization: Bearer $token" \
  -X PATCH \
  -H 'Content-Type: application/json' \
  -d '{"type":"ENV_TYPE"}'

각 항목의 의미는 다음과 같습니다.

ORG_NAME은 Apigee 사용한 만큼만 지불 조직의 이름입니다.
ENV_NAME은 업데이트할 Apigee 환경의 이름입니다.
ENV_TYPE은 업데이트된 환경 유형입니다. 옵션은 BASE, INTERMEDIATE 또는 COMPREHENSIVE입니다.

예를 들어 test-env라는 기본 환경을 고급으로 업그레이드하려면 다음 명령어를 사용합니다.

curl "https://apigee.googleapis.com/v1/organizations/my-org/environments/test-env?updateMask=type" \
  -H "Authorization: Bearer $token" \
  -X PATCH \
  -H 'Content-Type: application/json' \
  -d '{"type":"COMPREHENSIVE"}'

작업이 완료되면 다음 명령어를 사용하여 환경 유형 변경사항을 확인합니다.

curl "https://apigee.googleapis.com/v1/organizations/ORG_NAME/environments/ENV_NAME" -H "Authorization: Bearer $token"

이 명령어는 선택한 환경 유형을 포함하는 환경 리소스 객체를 반환합니다.

오류 참조

환경 유형을 업그레이드하거나 다운그레이드할 때 기존 환경에 새로 선택한 환경 유형과 호환되지 않는 리소스가 포함된 경우 작업이 실패합니다. 환경 유형별로 사용 가능한 기능 및 제한사항에 대한 자세한 내용은 환경 유형 비교를 참조하세요.

작업이 실패하면 다음과 같은 형식의 오류가 표시됩니다.

  {
    "error": {
      "code": "FAILED_PRECONDITION",
      "message": "environment type update invalid: ...<detailed message here >... :failed precondition",
      "status": "FAILED_PRECONDITION"
      }
  }

다음 표에는 문제를 해결하고 환경 유형을 업그레이드 또는 다운그레이드하기 위해 수행할 수 있는 잠재적인 단계와 가능한 오류 메시지가 요약되어 있습니다.

실패 조건	오류 메시지	해결 단계
조직당 최대 환경 수 초과	`cannot transfer active environments to INTERMEDIATE, will exceed limit` `cannot transfer active environments to BASE, will exceed limit`	조직에서 하나 이상의 환경을 삭제합니다.
환경에 배포된 확장 가능한 프록시	`existing environment has an extensible API`	환경에서 확장 가능한 프록시 배포를 취소합니다.
환경에 배포된 공유 흐름	`existing environment has a shared flow`	환경에서 공유 흐름 배포를 취소합니다.
리전별 환경당 최대 프록시 배포 단위 수	`pdu count, 50, cannot exceed 20` `pdu count, 425, cannot exceed 50`	공유 흐름 또는 프록시를 환경에서 배포 취소하거나 삭제합니다.
환경에서 사용 설정된 부가기능	`Existing environment has an addon enabled`	환경에서 부가기능을 사용 중지합니다.
환경에서 사용 설정된 멀티 리전 지원	`instance attachment count, 2, cannot exceed 1 for BASE environment` `instance attachment count, 2, cannot exceed 1 for INTERMEDIATE environment`	환경의 두 번째 인스턴스 연결을 삭제합니다.