Apigee 수익 창출 사용 설정

이 페이지는 Apigee 및 Apigee Hybrid에 적용됩니다.

Apigee Edge 문서 보기

Apigee 수익 창출을 사용하려면 먼저 조직에서 구매하고 사용 설정해야 합니다.

Apigee 수익 창출 구매

구독 기반 조직의 Apigee 수익 창출을 구매하려면 다음 안내를 따르세요.

  1. Apigee 수익 창출이 Apigee 구독에 포함되었는지 확인합니다. Apigee 사용 권한을 참조하세요.
  2. 필요한 경우 Apigee 영업팀에 문의하여 Apigee 수익 창출을 구매합니다.

조직에서 Apigee 수익 창출 사용 설정

기존 조직에서 Apigee 수익 창출을 사용 설정하려면 요청 본문에 부가기능 구성을 전달하여 다음 API에 POST 요청을 수행합니다.

https://apigee.googleapis.com/v1/organizations/$ORG:setAddons

예를 들면 다음과 같습니다. 

curl "https://apigee.googleapis.com/v1/organizations/$ORG:setAddons" \
  -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-type: application/json" \
  -d '{
    "addonsConfig": {
      "monetizationConfig": {
          "enabled": "true"
      }
      <Include existing add-on configuration>
    }
  }'

$TOKEN를 OAuth 2.0 액세스 토큰 가져오기에 설명된 대로 OAuth 2.0 액세스 토큰으로 설정합니다. 이 예시에서 사용된 curl 옵션에 대한 자세한 내용은 curl 사용을 참조하세요. 사용된 환경 변수에 대한 설명은 Apigee API 요청에 대한 환경 변수 설정을 참조하세요.

다음은 작업이 진행 중임을 나타내는 응답 예시를 제공합니다. 

{
  "name": "organizations/$ORG/operations/1ae3ed56-b38f-4cc1-ba33-e7d89557075d",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.apigee.v1.OperationMetadata",
    "operationType": "UPDATE",
    "targetResourceName": "organizations/$ORG",
    "state": "IN_PROGRESS"
  }
}

자세한 내용은 조직 부가기능 API 구성을 참조하세요.

조직 프로필을 확인하여 수익 창출이 사용 설정되었는지 확인합니다. 예를 들면 다음과 같습니다. 

curl "https://apigee.googleapis.com/v1/organizations/$ORG" \
  -X GET \
  -H "Authorization: Bearer $TOKEN"

다음은 수익 창출이 사용 설정된 응답 예시를 제공합니다. 

{
    "name": $ORG,
    ...
    "addonsConfig": {
    "monetizationConfig": {
      "enabled": true
    }
  }
}

조직에서 Apigee 수익 창출 사용 중지

조직에서 Apigee 수익 창출을 사용 중지하려면 요청 본문에 부가기능 구성을 전달하여 다음 API에 POST 요청을 수행합니다.

https://apigee.googleapis.com/v1/organizations/$ORG:setAddons

예를 들면 다음과 같습니다. 

curl "https://apigee.googleapis.com/v1/organizations/$ORG:setAddons" \
  -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-type: application/json" \
  -d '{
    "addonsConfig": {
      "monetizationConfig": {
          "enabled": "false"
      }
     <Include existing add-on configuration>
    }
  }'

다음은 작업이 진행 중임을 나타내는 응답 예시를 제공합니다. 

{
  "name": "organizations/$ORG/operations/06274ffb-8940-41da-836d-781cba190437",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.apigee.v1.OperationMetadata",
    "operationType": "UPDATE",
    "targetResourceName": "organizations/$ORG",
    "state": "IN_PROGRESS"
  }
}

자세한 내용은 조직 부가기능 API 구성을 참조하세요.

조직 프로필을 확인하여 수익 창출이 사용 중지되었는지 확인합니다. 예를 들면 다음과 같습니다. 

curl "https://apigee.googleapis.com/v1/organizations/$ORG" \
  -X GET \
  -H "Authorization: Bearer $TOKEN"

다음은 수익 창출이 사용 설정된 응답 예시를 제공합니다. 

{
    "name": $ORG,
    ...
    "addonsConfig": {
    "monetizationConfig": {
      "enabled": false
    }
  }
}

Apigee 수익 창출 사용 설정 문제 해결

Apigee 수익 창출을 구매하지 않았고 이를 사용 설정하려는 경우 다음 오류가 반환됩니다.

{
  "error": {
    "code": 400,
    "message": "failed to validate addons config: [Apigee Monetization] addon(s) are not entitled to the subscription",
    "status": "FAILED_PRECONDITION"
  }
}