利用データをエクスポートできるようにする

アカウントで使用量データをエクスポートできるようにするには、課金アカウント管理サービスの管理者または編集者ロールが必要です。 詳しくは、IAM アクセス権限を参照してください。

使用データをエクスポートできるようにアカウントを有効にすると、COSバケットは1年前までのデータを収集することができます。 つまり、2024年6月であれば、2023年6月までの使用量しか見ることができないが、それ以前のデータは常に見ることができる。 つまり、2023年6月にこの機能を有効にし、現在が2024年6月であれば、2022年6月から2024年6月までの利用データを見ることができる。

アカウントで利用データをエクスポートできるようにするには、以下の手順を実行します：

1. IBM Cloud、コンソールから「 管理」 >「 課金と使用状況 」と進み、 「設定 」を選択します。
2. 「接続」 をクリックします。
3. Cloud Object Storage インスタンスとバケットを選択する。 これらを選択することで、どのバケツに利用レポートを保存するかを選択することになります。
   1. オプション：既存のインスタンスを選択したくない場合は、Select an instance>Create new をクリックします。
   2. オプション: バケツを選択するか、バケツのドロップダウンにある新しいバケツを作成するをクリックして、新しいバケツを作成することができます。 バケットの詳細については、IBM Cloud Object Storageを使い始める を参照してください。 バケットを作成したら
4. サービス間の認証については、Authorize をクリックします。 必要なアクセスについては、Object Writer と Content Reader を選択してください。 Review をクリックし、次に Assign をクリックする。
5. フォルダの詳細を確認したら、「接続」をクリックします。

アカウントをエンタープライズアカウントに変更した場合は、エンタープライズアカウントで使用状況データをエクスポートできるようにするために、再度以下の手順を実行する必要があります。 元のアカウントでこの機能を維持することもできるし、アカウントを共有利用から切断する ことで削除することもできる。

Terraformを使用して利用データをエクスポートできるようにする

Terraformを使用して使用状況データをエクスポートできるようにアカウントをアタッチする前に、以下を完了していることを確認してください：

• Terraform CLIをインストールし、IBM Cloudを設定します。Terraform用のProviderプラグインをインストールします。 詳しくは IBM Cloud®のTerraformを始める のチュートリアルを参照。 このプラグインは、以下のタスクを実行するために使用される IBM Cloud API を抽象化します。
• main.tfという名前の Terraform 構成ファイルを作成します。 このファイルでは、HashiCorpConfiguration Languageを使用してリソースを定義します。 詳しくは Terraformのドキュメントを参照。

アカウントが使用量データをエクスポートできるようにするには、2つのインスタンス間でポリシーを認可し、リソースインスタンスに「billing_report_snaptshot」をプロビジョニングする必要があります。 詳細については、ibm_billing_report_snapshot の terraform ドキュメントを参照してください。 以下の手順で、Terraformを使って認可ポリシーを作成し、リソースインスタンスに'billing_report_snaptshot をプロビジョニングします：

課金スナップショット設定を実行するには、それぞれのアカウントのAPIキーに対応する環境変数'IC_API_KEY を設定することで認証情報を提供する必要がある。 詳細については、IBM CloudProvider terraform ドキュメントを参照してください。

1. 以下の例では、2つの特定のインスタンス間で認可ポリシーを作成している。

   provider "ibm" {
   }
   resource "ibm_iam_authorization_policy" "policy" {
   source_service_name         = "billing"
   target_service_name         = "cloud-object-storage"
   target_resource_instance_id = var.cos_instance_id
   roles                       = ["Object Writer", "Content Reader"]
   }
   

2. 以下の例では、リソース・インスタンスに対して「billing_report_snaptshot 規定している。

      provider "ibm" {
   }
   resource "ibm_billing_report_snapshot" "billing_report_snapshot_instance" {
   interval = var.billing_report_snapshot_interval
   versioning = var.billing_report_snapshot_versioning
   report_types = var.billing_report_snapshot_report_types
   cos_reports_folder = var.billing_report_snapshot_cos_reports_folder
   cos_bucket = var.billing_report_snapshot_cos_bucket
   cos_location = var.billing_report_snapshot_cos_location
   depends_on = [ ibm_iam_authorization_policy.policy ]
   }
   

3. 設定ファイルのビルドが終わったら、Terraform CLIを初期化します。 詳しくは、作業ディレクトリの初期化を参照のこと。

   terraform init
   

4. main.tf ファイルからリソースを供給する。 詳しくは Terraformによるインフラのプロビジョニングを参照してください。

   1. terraform plan 実行してTerraformの実行計画を生成し、提案されたアクションをプレビューする。

      terraform plan
      

   2. terraform apply を実行し、プランで定義されたリソースを作成する。

      terraform apply
      

サービス間認証がすでに存在する場合、billing_report_snapshot_instanceの作成時に「depends_on 制約を削除することができます。

共有利用からアカウントを切断する

使用量データをエクスポートするようにアカウントを設定している場合、選択したバケットを切断することで、データのエクスポートを停止することができます。

接続を解除するには、以下の手順を使用する：

1. IBM Cloud、コンソールから「 管理」 >「 課金と使用状況 」と進み、 「設定 」を選択します。
2. 切断をクリックする。
3. バケツの名前を入力してください。
4. 切断をクリックする。