1. 導入：なぜプラン確認が重要なのか
DevOpsやプロジェクトマネジメントの現場において、Backlogのプラン確認は「権限管理」や「API連携」の設計を行う上で非常に重要です。新プラン（組織ベース）とクラシックプランでは、ユーザー管理の仕組みやAPIの認証仕様が異なる場合があります。特に、社内外のメンバーを招待する際や、外部ツールとの連携を自動化する際、どちらのプランであるかを把握していないと、想定した設定が行えず工数が無駄になることがあります。今回は、一目でプランを判別する方法と、自動化ツール開発のヒントを解説します。
2. 基礎知識：新プランとクラシックプランの仕組み
Backlogには現在、主に「新プラン（組織管理機能付き）」と「クラシックプラン」の2種類が存在します。
新プランは、組織単位でのユーザー管理や、より柔軟なセキュリティ設定が可能なモダンなプランです。一方、クラシックプランは、プロジェクト単位での管理が中心となる従来のプランです。システム開発の現場では、組織単位で権限を一元管理できる新プランへの移行が推奨されています。
3. 実装/解決策：判別手順と自動化の視点
最も確実な確認方法は、Backlog画面上部のグローバルバーを確認することです。
新プランの場合：自分のユーザーアイコンの右側に「組織名」が表示されます。
クラシックプランの場合：ユーザーアイコンの右側に組織名は表示されません。
もし、多数のスペースを管理しているインフラ担当者の場合、画面を目視するだけでなく、API経由で情報を取得したいと考えるでしょう。Backlog APIを利用して、組織情報が取得できるかどうかでプランを判定するスクリプトを以下に示します。
4. サンプルプログラム：APIによるプラン判別（Python）
以下のコードは、Backlog APIを利用して組織情報を取得し、プランを判別するサンプルです。
import requests
スペース名とAPIキーを設定
space_id = "your_space_id"
api_key = "your_api_key"
url = f"https://{space_id}.backlog.com/api/v2/organizations?apiKey={api_key}"
def check_backlog_plan():
try:
# 組織一覧取得APIを叩く
response = requests.get(url)
# ステータスコードが200なら組織管理機能がある「新プラン」と判定
if response.status_code == 200:
print("判定結果: 新プランです。組織管理機能が利用可能です。")
else:
print("判定結果: クラシックプラン、もしくはAPI権限が不足しています。")
except Exception as e:
print(f"エラーが発生しました: {e}")
if __name__ == "__main__":
check_backlog_plan()
5. 応用・注意点：現場で役立つ補足
注意点1：APIの権限
上記スクリプトは「組織管理者」権限を持つユーザーのAPIキーを使用する必要があります。権限がない場合、クラシックプランでなくてもエラーになる可能性があるため注意してください。
注意点2：移行の判断基準
もし現在クラシックプランを利用中で、ユーザー数の増加やセキュリティ要件の厳格化が課題となっている場合は、公式の「クラシックプランからの移行ガイド」を参照し、新プランへの移行を検討してください。APIを利用した自動化スクリプトを運用している場合は、APIの仕様変更（組織ベースの認証等）に備えて、早めに新プランへ移行しておくことが将来的なメンテナンスコストの削減に繋がります。
コメント