오퍼링 및 지역별 가용성 확인

이 예시를 통해 오퍼링과 사용 가능한 지역을 식별하는 방법을 확인할 수 있습니다. 이를 위해 GC에 API를 호출하여 모든 오퍼링을 나열하고, 결과를 필터링하여 원하는 오퍼링을 식별한 다음, API 호출을 통해 오퍼링을 사용할 수 있는 지역을 가져옵니다. 특정 요금제를 사용할 수 있는 지역을 식별하는 것이지 모든 지역에서 서비스를 사용할 수 있는지를 식별하는 것은 아닙니다.

모든 서비스를 나열하려면 다음 명령을 사용하십시오

curl --request GET
--url `https://globalcatalog.cloud.ibm.com/api/v1?q=kind:service`
--header `accept: application/json`

응답에서 Power Systems Virtual Server 그룹의 서비스 ID인 ' abd259f0-9990-11e8-acc8-b9f54a8f1661'을 확인할 수 있습니다.

따라서 다음 명령을 실행하여 Power Systems Virtual Server 그룹의 요금제 ID를 가져올 수 있습니다.

curl -X 'GET'
--url 'https://globalcatalog.cloud.ibm.com/api/v1/abd259f0-9990-11e8-acc8-b9f54a8f1661/plan?_offset=0&_limit=50'
-H 'accept: application/json'

다음은 방금 실행한 명령에 대한 응답 예시입니다. 리소스 배열에는 서비스의 모든 요금제가 나열됩니다. 배열의 각 항목은 플랜입니다. 계획 객체에서 중요한 필드는 ' id 필드입니다. 다음 응답에서 ' f165dd34-3a40-423b-9d95-e90a23f724dd '이 ID임을 확인할 수 있습니다.

{
  "offset": 0,
  "limit": 50,
  "count": 2,
  "resource_count": 2,
  "first": "https://globalcatalog.cloud.ibm.com/api/v1/abd259f0-9990-11e8-acc8-b9f54a8f1661/plan?languages=en-US%2Cen%3Bq%3D0.9",
  "resources": [
    {
      "_id": "f165dd34-3a40-423b-9d95-e90a23f724dd",
      "_rev": "5-3709538cdcff35d2917d56c3cafb1fac",
      "active": true,
      "catalog_crn": "crn:v1:bluemix:public:globalcatalog::::plan:f165dd34-3a40-423b-9d95-e90a23f724dd",
      "children_url": "https://globalcatalog.cloud.ibm.com/api/v1/f165dd34-3a40-423b-9d95-e90a23f724dd/%2A",
      "complete": true,
      "created": "2019-06-14T22:52:18.378Z",
      "disabled": false,
      "geo_tags": [
        "che01",
        "dal10",
        "dal12",
        "eu-de-1",
        "eu-de-2",
        "lon04",
        "lon06",
        "mad02",
        "mad04",
        "mon01",
        "osa21",
        "sao01",
        "sao04",
        "syd04",
        "syd05",
        "tok04",
        "tor01",
        "wdc06",
        "wdc07",
        "us-east",
        "us-south"
      ],
      "id": "f165dd34-3a40-423b-9d95-e90a23f724dd",
      "images": {
        "feature_image": "https://cache.globalcatalog.cloud.ibm.com/api/v1/abd259f0-9990-11e8-acc8-b9f54a8f1661/artifacts/cache/66c89a2644c2ac54745d6ab9ecf4da8e-public/IBM_Power_CloudCatalog%202.svg",
        "image": "https://cache.globalcatalog.cloud.ibm.com/api/v1/abd259f0-9990-11e8-acc8-b9f54a8f1661/artifacts/cache/66c89a2644c2ac54745d6ab9ecf4da8e-public/IBM_Power_CloudCatalog%202.svg",
        "medium_image": "https://cache.globalcatalog.cloud.ibm.com/api/v1/abd259f0-9990-11e8-acc8-b9f54a8f1661/artifacts/cache/66c89a2644c2ac54745d6ab9ecf4da8e-public/IBM_Power_CloudCatalog%202.svg",
        "small_image": "https://cache.globalcatalog.cloud.ibm.com/api/v1/abd259f0-9990-11e8-acc8-b9f54a8f1661/artifacts/cache/66c89a2644c2ac54745d6ab9ecf4da8e-public/IBM_Power_CloudCatalog%202.svg"
      },
      "kind": "plan",
      "metadata": {
        "compliance": [
          "minisd"
        ],
        "original_name": "power-virtual-server-project",
        "other": {
          "pricing_schema_url": "https://power-iaas.cloud.ibm.com/cost-estimator"
        },
        "plan": {
          "allow_internal_users": true,
          "async_provisioning_supported": true,
          "async_unprovisioning_supported": true,
          "bindable": false,
          "reservable": false,
          "service_check_enabled": false,
          "single_scope_instance": "",
          "test_check_interval": 0
        },
        "pricing": {
          "metrics": null,
          "origin": "pricing_catalog",
          "starting_price": {},
          "type": "Paid",
          "url": "https://globalcatalog.cloud.ibm.com/api/v1/f165dd34-3a40-423b-9d95-e90a23f724dd/pricing"
        },
        "rc_compatible": true,
        "service": {
          "async_provisioning_supported": true,
          "async_unprovisioning_supported": true,
          "bindable": false,
          "custom_create_page_hybrid_enabled": false,
          "extension": null,
          "iam_compatible": true,
          "parameters": [],
          "plan_updateable": true,
          "rc_provisionable": true,
          "service_check_enabled": false,
          "service_key_supported": false,
          "state": "",
          "test_check_interval": 0,
          "type": "",
          "unique_api_key": false,
          "user_defined_service": null
        },
        "ui": {
          "strings": {
            "en": {
              "bullets": [
                {
                  "description": "Enables provisioning of Power Virtual Server LPARs in the chosen region."
                }
              ]
            }
          }
        }
      },
      "name": "power-virtual-server-group",
      "overview_ui": {
        "en": {
          "description": "A Power Systems Virtual Server group for the specified IBM Cloud region.",
          "display_name": "Power Systems Virtual Server Group",
          "long_description": "A Power Systems Virtual Server group for the specified IBM Cloud region."
        }
      },
      "parent_id": "abd259f0-9990-11e8-acc8-b9f54a8f1661",
      "parent_url": "https://globalcatalog.cloud.ibm.com/api/v1/abd259f0-9990-11e8-acc8-b9f54a8f1661",
      "pricing_tags": [
        "allow_internal_users",
        "paid",
        "paid_only"
      ],
      "provider": {
        "email": "pil@us.ibm.com",
        "name": "IBM"
      },
      "tags": [
        "apidocs_enabled",
        "beryllium",
        "freesia",
        "ibm_created",
        "rc_compatible"
      ],
      "updated": "2024-03-15T13:14:09.574263813-04:00",
      "url": "https://globalcatalog.cloud.ibm.com/api/v1/f165dd34-3a40-423b-9d95-e90a23f724dd?languages=en-US%2Cen%3Bq%3D0.9",
      "visibility": {
        "restrictions": "public"
      }
    },
    {
      "_id": "1112d6a9-71d6-4968-956b-eb3edbf0225b",
      "_rev": "22-c4780dfb7c2ca400029754649383507e",
      "active": true,
      "catalog_crn": "crn:v1:bluemix:public:globalcatalog::::plan:1112d6a9-71d6-4968-956b-eb3edbf0225b",
      "children_url": "https://globalcatalog.cloud.ibm.com/api/v1/1112d6a9-71d6-4968-956b-eb3edbf0225b/%2A",
      "complete": true,
      "created": "2024-02-14T11:00:24.476151306-05:00",
      "disabled": false,
      "geo_tags": [
        "satcon_dal",
        "satcon_fra",
        "satcon_mad",
        "satcon_osa",
        "satcon_sao",
        "satcon_syd",
        "satcon_tok",
        "satcon_tor",
        "satcon_wdc"
      ],
      "id": "1112d6a9-71d6-4968-956b-eb3edbf0225b",
      "images": {
        "feature_image": "https://cache.globalcatalog.cloud.ibm.com/api/v1/abd259f0-9990-11e8-acc8-b9f54a8f1661/artifacts/cache/66c89a2644c2ac54745d6ab9ecf4da8e-public/IBM_Power_CloudCatalog%202.svg",
        "image": "https://cache.globalcatalog.cloud.ibm.com/api/v1/abd259f0-9990-11e8-acc8-b9f54a8f1661/artifacts/cache/66c89a2644c2ac54745d6ab9ecf4da8e-public/IBM_Power_CloudCatalog%202.svg",
        "medium_image": "https://cache.globalcatalog.cloud.ibm.com/api/v1/abd259f0-9990-11e8-acc8-b9f54a8f1661/artifacts/cache/66c89a2644c2ac54745d6ab9ecf4da8e-public/IBM_Power_CloudCatalog%202.svg",
        "small_image": "https://cache.globalcatalog.cloud.ibm.com/api/v1/abd259f0-9990-11e8-acc8-b9f54a8f1661/artifacts/cache/66c89a2644c2ac54745d6ab9ecf4da8e-public/IBM_Power_CloudCatalog%202.svg"
      },
      "kind": "plan",
      "metadata": {
        "compliance": [
          "minisd"
        ],
        "original_name": "power-virtual-server-private-group",
        "plan": {
          "allow_internal_users": true,
          "async_provisioning_supported": false,
          "async_unprovisioning_supported": false,
          "bindable": false,
          "reservable": false,
          "service_check_enabled": false,
          "single_scope_instance": "",
          "test_check_interval": 0
        },
        "pricing": {
          "metrics": null,
          "origin": "pricing_catalog",
          "starting_price": {},
          "type": "free",
          "url": "https://globalcatalog.cloud.ibm.com/api/v1/1112d6a9-71d6-4968-956b-eb3edbf0225b/pricing"
        },
        "rc_compatible": true,
        "service": {
          "async_provisioning_supported": false,
          "async_unprovisioning_supported": false,
          "bindable": false,
          "custom_create_page_hybrid_enabled": false,
          "extension": null,
          "iam_compatible": true,
          "parameters": [],
          "plan_updateable": false,
          "rc_provisionable": true,
          "service_check_enabled": false,
          "service_key_supported": false,
          "state": "",
          "test_check_interval": 0,
          "type": "",
          "unique_api_key": false,
          "user_defined_service": null
        },
        "sla": {
          "dr": {
            "dr": true
          }
        },
        "ui": {
          "strings": {
            "en": {
              "bullets": [
                {
                  "description": "Enables use of Power Virtual Server Private Cloud resources in the chosen satellite location."
                }
              ]
            }
          }
        }
      },
      "name": "power-virtual-server-private-group",
      "overview_ui": {
        "en": {
          "description": "A Power Systems Virtual Server Private Cloud group for the specified IBM Cloud Satellite location.",
          "display_name": "Power Virtual Server Private Cloud Group",
          "long_description": "A Power Systems Virtual Server Private Cloud group for the specified IBM Cloud Satellite location."
        }
      },
      "parent_id": "abd259f0-9990-11e8-acc8-b9f54a8f1661",
      "parent_url": "https://globalcatalog.cloud.ibm.com/api/v1/abd259f0-9990-11e8-acc8-b9f54a8f1661",
      "pricing_tags": [
        "free",
        "allow_internal_users"
      ],
      "provider": {
        "email": "pil@us.ibm.com",
        "name": "IBM"
      },
      "tags": [
        "rc_compatible",
        "apidocs_enabled",
        "compute",
        "virtualservers",
        "ibm_created",
        "satellite_enabled"
      ],
      "updated": "2024-06-20T10:12:47.969618989-04:00",
      "url": "https://globalcatalog.cloud.ibm.com/api/v1/1112d6a9-71d6-4968-956b-eb3edbf0225b?languages=en-US%2Cen%3Bq%3D0.9",
      "visibility": {
        "restrictions": "public"
      }
    }
  ]
}

특정 지역에 유효한 요금제 결정하기

다음 예에서는 특정 지역의 유효한 요금제를 찾는 방법을 살펴봅니다. 이를 위해 API 호출을 수행하여 특정 지역의 오퍼링에 대해 유효한 요금제 목록을 검색한 다음 API 응답을 해석하여 사용 가능한 요금제를 파악합니다. 자세한 내용은 API 설명서를 참조하세요: 요금제에 대한 가격 책정 배포를 확인하세요.

curl --request GET
--url 'https://globalcatalog.cloud.ibm.com/api/v1/{id}/pricing/deployment'
--header 'accept: application/json'

이 예에서는 이전 단계에서 찾은 요금제 ID를 ' ID 자리에 입력합니다.

curl --request GET
--url 'https://globalcatalog.cloud.ibm.com/api/v1/f165dd34-3a40-423b-9d95-e90a23f724dd/pricing/deployment'
--header 'accept: application/json'

다음은 첫 번째 메트릭만 나열하는 응답 예시입니다:

{
   "offset":0,
   "limit":50,
   "count":5,
   "resource_count":5,
   "resources":[
      {
         "deployment_id":"f165dd34-3a40-423b-9d95-e90a23f724dd:eu-de-114101",
         "deployment_location":"eu-de-1",
         "deployment_region":"eu-de-1",
         "origin":"pricing_catalog",
         "type":"Paid",
         "i18n":{

         },
         "starting_price":{

         },
         "effective_from":"2024-11-01T00:00:00Z",
         "effective_until":"9999-09-30T00:00:00Z",
         "metrics":[
            {
               "part_ref":"",
               "metric_id":"ibm-i-rds",
               "tier_model":"Linear Tier",
               "resource_display_name":"APPLICATION_INSTANCES",
               "charge_unit_display_name":"IBM i RDS License/user-hour",
               "charge_unit_name":"IBMIRDS_APPLICATION_INSTANCES",
               "charge_unit":"Application Instance",
               "charge_unit_quantity":1,
               "amounts":[
                  {
                     "country":"USA",
                     "currency":"USD",
                     "prices":[
                        {
                           "quantity_tier":1,
                           "price":0.1808
                        }
                     ]
                  },
                  {
                     "country":"USD",
                     "currency":"USD",
                     "prices":[
                        {
                           "quantity_tier":1,
                           "price":0.1808
                        }
                     ]
                  },
                  {
                     "country":"CAN",
                     "currency":"CAD",
                     "prices":[
                        {
                           "quantity_tier":1,
                           "price":0.24962151999999999
                        }
                     ]
                  },
                  {
                     "country":"AUS",
                     "currency":"AUD",
                     "prices":[
                        {
                           "quantity_tier":1,
                           "price":0.2696696184
                        }
                     ]
                  },
                  {
                     "country":"ISA",
                     "currency":"USD",
                     "prices":[
                        {
                           "quantity_tier":1,
                           "price":0.1808
                        }
                     ]
                  },
               "usage_cap_qty":0,
               "display_cap":0,
               "effective_from":"2024-11-01T00:00:00Z",
               "effective_until":"9999-12-31T00:00:00Z",
               "additional_properties":{
                  "included_quantities":{
                     "account":0,
                     "instance":0
                  }
               }
            },

응답의 리소스 개체는 플랜을 사용할 수 있는 배포 또는 위치의 목록입니다. 이 경우 이 요금제는 전 세계에서 사용할 수 있습니다. ' us-south, ' us-east' 등과 같이 배포가 특정 지역에 국한된 다른 상황도 있습니다.

요금제를 전 세계에 배포하는 경우 다음 API를 사용하여 특정 지역의 요금제를 조회할 수 있습니다:

curl --request GET
--url 'https://globalcatalog.cloud.ibm.com/api/v1/{id}:global/pricing?deployment_region={ region_id}'
--header 'accept: application/json'

이전 단계에서 찾은 요금제 ID를 사용합니다:

curl --request GET
--url 'https://globalcatalog.cloud.ibm.com/api/v1/f165dd34-3a40-423b-9d95-e90a23f724dd:global/pricing?deployment_region={ region_id}'
--header 'accept: application/json'

전 세계에 배포되며 지역별 요금제가 적용되는 요금제의 예로는 Cloud Object Storage 표준 요금제가 있습니다. 요금제 ID는 ' 744bfc56-d12c-4866-88d5-dac9139e0e5d'입니다. 이 요금제에는 ' eu-de'에 대한 특정 지역이 있습니다. 이 ' region_id '은 이전 응답의 ' deployment_locations ' 배열에 있는 ' deployment_region ' 값 중 하나와 일치해야 합니다.

' deployment_regions 재정의 변수를 사용하지 않는 글로벌 요금제를 사용하는 글로벌 요금제도 있습니다.

다음은 ' eu-de ' deployment_region'로 API 엔드포인트를 사용하는 예제입니다.

https://globalcatalog.cloud.ibm.com/api/v1/744bfc56-d12c-4866-88d5-dac9139e0e5d:global/pricing?deployment_region=eu-de

다음은 응답 예입니다:

{
  "deployment_id": "744bfc56-d12c-4866-88d5-dac9139e0e5d:global",
  "deployment_location": "global",
  "deployment_region": "eu-de",
  "origin": "pricing_catalog",
  "type": "paygo",
  "url": "https://globalcatalog.cloud.ibm.com/api/v1/744bfc56-d12c-4866-88d5-dac9139e0e5d:global/pricing?deployment_region=eu-de",
  "i18n": {},
  "starting_price": {},
  "effective_from": "2024-09-01T00:00:00Z",
  "effective_until": "9999-12-31T00:00:00Z",
  "metrics": [
    {
      "part_ref": "",
      "metric_id": "COSVLTBCALL",
      "tier_model": "Granular Tier",
      "resource_display_name": "Vault Class B calls",
      "charge_unit_display_name": "API_CALLS",
      "charge_unit_name": "VAULT_CLASS_B_CALLS",
      "charge_unit": "API_CALLS",
      "charge_unit_quantity": 10000,
      "amounts": [
        {
          "country": "USA",
          "currency": "USD",
          "prices": [
            {
              "quantity_tier": 1,
              "price": 0.01045
            }
          ]
        }
      ],
      "usage_cap_qty": 0,
      "display_cap": 0,
      "effective_from": "2024-09-01T00:00:00Z",
      "effective_until": "9999-12-31T00:00:00Z",
      "additional_properties": {}
    }
  ]
}

플랜 배포가 글로벌이 아닌 경우 다음 API를 사용하여 특정 배포 위치에 대한 가격을 조회할 수 있습니다:

curl --request GET
--url 'https://globalcatalog.cloud.ibm.com/api/v1/{id}/pricing'
--header 'accept: application/json'

이전 단계에서 사용한 플랜 ID를 사용하십시오

curl --request GET
--url 'https://globalcatalog.cloud.ibm.com/api/v1/f165dd34-3a40-423b-9d95-e90a23f724dd/pricing'
--header 'accept: application/json'

' {id} '은 배포의 ' deployment_id '의 ID입니다. 앞서 설명한 API를 사용하여 배포 위치 및 관련 ' deployment_id '를 찾을 수 있습니다.

플랜 ID: ' databases-for-postgresql-standard'을 사용하여 이 시나리오를 설명해 보겠습니다. 서비스의 요금제 ' Databases for PostgreSQL, 서비스 ID: ' databases-for-postgresql' .

이 플랜의 배포 위치 중 하나는 ' au-syd '에서 사용할 수 있으며 이 위치의 ' deployment_id '는 ' databases-for-postgresql-standard:au-syd'입니다.

API 호출은 다음과 같습니다: https://globalcatalog.cloud.ibm.com/api/v1/databases-for-postgresql-standard:au-syd.

다음은 API 호출에 대한 응답입니다:

{
  "deployment_id": "databases-for-postgresql-standard:au-syd",
  "deployment_location": "au-syd",
  "deployment_region": "au-syd",
  "origin": "pricing_catalog",
  "type": "paygo",
  "url": "https://globalcatalog.cloud.ibm.com/api/v1/databases-for-postgresql-standard:au-syd/pricing",
  "i18n": {},
  "starting_price": {},
  "effective_from": "2024-09-01T00:00:00Z",
  "effective_until": "9999-12-31T00:00:00Z",
  "metrics": [
    {
      "part_ref": "",
      "metric_id": "databases-for-postgresql-cpu",
      "tier_model": "Linear Tier",
      "resource_display_name": "Databases for PostgreSQL CPU",
      "charge_unit_display_name": "CPU",
      "charge_unit_name": "VIRTUAL_PROCESSOR_CORES",
      "charge_unit": "Virtual Processor Core-Hour",
      "charge_unit_quantity": 1,
      "amounts": [
        {
          "country": "USA",
          "currency": "USD",
          "prices": [
            {
              "quantity_tier": 1,
              "price": 32.342
            }
          ]
        }
      ],
      "usage_cap_qty": 0,
      "display_cap": 0,
      "effective_from": "2024-09-01T00:00:00Z",
      "effective_until": "9999-12-31T00:00:00Z"
    }
  ]
}

특정 플랜 또는 지역에 대해 유효한 지표 식별하기

다음 정보는 특정 요금제 및 지역에 대한 유효한 지표를 식별하는 데 도움이 되는 정보입니다. 메트릭은 가격 책정을 위해 사용량을 결정하는 리소스 또는 작업의 사양입니다. API 호출을 통해 지정된 지역의 특정 플랜에 대해 유효한 메트릭을 나열한 다음 응답을 구문 분석하여 메트릭에 대한 세부 정보를 얻습니다.

다음 예는 Power Systems Virtual Server 그룹 서비스에 대한 API 호출을 보여줍니다. 앞서 확인했듯이 ID는 ' f165dd34-3a40-423b-9d95-e90a23f724dd' 입니다.

curl --request GET
--url 'https://globalcatalog.cloud.ibm.com/api/v1/f165dd34-3a40-423b-9d95-e90a23f724dd/pricing/deployment'
--header 'accept: application/json'

다음은 응답 예시입니다:

{
  "offset": 0,
  "limit": 1,
  "count": 21,
  "resource_count": 1,
  "resources": [
    {
      "deployment_id": "f165dd34-3a40-423b-9d95-e90a23f724dd:che0142579",
      "deployment_location": "che01",
      "deployment_region": "che01",
      "origin": "pricing_catalog",
      "type": "Paid",
      "i18n": {},
      "starting_price": {},
      "effective_from": "2024-07-01T00:00:00Z",
      "effective_until": "9999-09-30T00:00:00Z",
      "metrics": [
        {
          "part_ref": "",
          "metric_id": "tier3-storage",
          "tier_model": "Linear Tier",
          "resource_display_name": "HDD Storage Gigabyte-Hours",
          "charge_unit_display_name": "HDD Storage Gigabyte-Hour",
          "charge_unit_name": "TIER_THREE_STORAGE_GIGABYTE_HOURS",
          "charge_unit": "HDD Storage Gigabyte-Hour",
          "charge_unit_quantity": 1,
          "amounts": [
            {
              "country": "USA",
              "currency": "USD",
              "prices": [
                {
                  "quantity_tier": 1,
                  "price": 0.000171798
                }
              ]
            }
          ],
          "usage_cap_qty": 0,
          "display_cap": 0,
          "effective_from": "2024-07-01T00:00:00Z",
          "effective_until": "9999-12-31T00:00:00Z"
        }
      ]
    }
  ]
}

배포를 위한 리소스 배열을 검사합니다. 각 배포에는 요금제를 사용할 수 있는 특정 위치 또는 지역을 나타내는 ' deployment_location ' 필드가 있습니다.

다음 표에는 응답 본문 필드와 해당 설명이 나와 있습니다. 자세한 내용은 글로벌 카탈로그 API 문서를 참조하세요.