Storage Insights データセットを使用する

このページでは、Storage Insights データセットとデータセット構成を作成して管理する方法について説明します。Storage Insights データセットの詳細を確認する。

始める前に

データセットとデータセット構成の作成と管理を開始する前に、以降のサブセクションの手順に沿って操作します。

必要なロールを取得する

データセットの作成と管理に必要な権限を取得するには、ソース プロジェクトに対する次の IAM ロールの付与を管理者に依頼してください。

ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

これらの事前定義ロールには、データセットの作成と管理に必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。

必要な権限

データセットを作成、管理するには、次の権限が必要です。

  • データセット構成を作成します。 storageinsights.datasetConfigs.create
  • データセットの構成を表示します。
    • storageinsights.datasetConfigs.get
    • storageinsights.datasetConfigs.list
  • データセットの構成を管理する:
    • storageinsights.datasetConfigs.update
    • storageinsights.datasetConfigs.delete
  • BigQuery データセットへのリンク: storageinsights.datasetConfigs.linkDataset
  • BigQuery データセットとのリンクを解除する: storageinsights.datasetConfigs.unlinkDataset
  • BigQuery のリンクされたデータセットに対してクエリを実行する: bigquery.jobs.create or bigquery.jobs.*

カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。

Storage Insights API を有効にする

Console

storageinsights.googleapis.com API を有効にする

コマンドライン

現在のプロジェクトで Storage Insights API を有効にするには、次のコマンドを実行します。

gcloud services enable storageinsights.googleapis.com

Google Cloud プロジェクトでサービスを有効にする方法について詳しくは、サービスの有効化と無効化をご覧ください。

Storage Intelligence の構成

データセットで分析するプロジェクト、フォルダ、または組織でストレージ インテリジェンスが構成されていることを確認します。

データセット構成を作成する

データセット構成を作成してデータセットを生成する手順は次のとおりです。データセット構成の作成時に指定できるフィールドの詳細については、データセット構成プロパティをご覧ください。

Console

  1. Google Cloud コンソールで、Cloud Storage の [Storage Insights] ページに移動します。

    Storage Insights に移動

  2. [データセットを構成] をクリックします。

  3. [データセットに名前を付ける] セクションで、データセットの名前を入力します。必要に応じて、データセットの説明を入力します。

  4. [データセットのスコープを定義する] セクションで、次の操作を行います。

    • 次のオプションのいずれかを選択します。

      • 現在の組織内のすべてのプロジェクトのストレージ メタデータを取得するには、[組織を含める] を選択します。

      • 選択したフォルダ内のすべてのプロジェクトのストレージ メタデータを取得するには、[フォルダ（サブ組織/部門）を含める] を選択します。フォルダ ID を取得する方法については、フォルダとプロジェクトを表示または一覧表示するをご覧ください。フォルダを追加する手順は次のとおりです。

        1. [フォルダ 1] フィールドにフォルダ ID を入力します。
        2. 必要に応じて、複数のフォルダ ID を追加するには、[+ 別のフォルダを追加] をクリックします。

      • 選択したプロジェクトのストレージ メタデータを取得するには、[プロジェクト番号を指定してプロジェクトを含める] を選択します。プロジェクト番号を確認する方法については、プロジェクト名、番号、ID を確認するをご覧ください。プロジェクトを追加する手順は次のとおりです。

        1. [プロジェクト 1] フィールドにプロジェクト番号を入力します。
        2. 必要に応じて、複数のプロジェクト番号を追加するには、[+ 別のプロジェクトを追加] をクリックします。

      • プロジェクトまたはフォルダを一括で追加するには、[CSV ファイルを使用してプロジェクト /フォルダのリストをアップロードする] を選択します。CSV ファイルには、データセットに含めるプロジェクト番号またはフォルダ ID を含める必要があります。

    • 選択したリソースに今後作成されるバケットを自動的に含めるかどうかを指定します。

    • 必要に応じて、リージョンとバケットの接頭辞に基づいてバケットのフィルタを指定するには、[フィルタ（省略可）] セクションを開きます。フィルタはバケットに累積的に適用されます。

      特定のリージョンのバケットを追加または除外できます。たとえば、me-central1 リージョンと me-central2 リージョンのバケットを除外できます。接頭辞でバケットを追加または除外することもできます。たとえば、my-bucket で始まるバケットを除外する場合は、my-bucket* 接頭辞を入力します。

  5. [続行] をクリックします。

  6. [保持期間を選択する] セクションで、データセット内のデータの保持期間を選択します。

  7. [構成したデータセットを保存するロケーションの選択] セクションで、データセットとデータセット構成を保存するロケーションを選択します。

  8. [サービス アカウントのタイプを選択] セクションで、データセットのサービス エージェント タイプを選択します。このサービス エージェントは、データセット構成を作成するときに自動的に作成されます。次のいずれかのサービス エージェントを選択できます。

    • 構成スコープのサービス アカウント: このサービス エージェントは、特定のデータセット構成によって生成されたデータセットにのみアクセスして書き込むことができます。
    • プロジェクト スコープのサービス アカウント: このサービス エージェントは、プロジェクト内のすべてのデータセット構成から生成されたデータセットにアクセスして書き込むことができます。

    サービス エージェントを作成するときに、サービス エージェントに必要な権限を付与する必要があります。これらのサービス エージェントの詳細については、データセット構成プロパティをご覧ください。

  9. [構成] をクリックします。

コマンドライン

  1. データセット構成を作成するには、必要なフラグを指定して gcloud storage insights dataset-configs create コマンドを実行します。

    gcloud storage insights dataset-configs create DATASET_CONFG_ID \
  --source-projects=SOURCE_PROJECT_NUMBERS \
  --location=LOCATION \
  --retention-period-days=RETENTION_PERIOD_DAYS \
  --organization=ORGANIZATION_ID

    次のように置き換えます。

    • DATASET_CONFIG_ID は、データセット構成に付ける名前に置き換えます。名前はデータセット構成の識別子として使用され、変更可能です。名前には、英字、数字、アンダースコアを使用できます。最大 128 文字です。

    • SOURCE_PROJECT_NUMBERS は、データセットに含めるプロジェクトの番号に置き換えます。例: 464036093014。1 つまたは複数のプロジェクトを指定できます。プロジェクト番号を確認する方法については、プロジェクト名、番号、ID を確認するをご覧ください。

      --source-projects フラグの代わりに --source-projects-file=FILE_PATH フラグを使用することもできます。このフラグを使用すると、プロジェクト番号を含むファイルをアップロードして、一度に複数のプロジェクト番号を指定できます。ファイルは CSV 形式で、Cloud Storage にアップロードする必要があります。

    • LOCATION は、データセット構成とデータセットが保存されるロケーションに置き換えます。

    • RETENTION_PERIOD_DAYS は、データセット内のデータの保持期間に置き換えます。

    • ORGANIZATION_ID は、ソース プロジェクトが属する組織のリソース ID に置き換えます。指定したロケーション外のソース プロジェクトは、データセット構成から除外されます。組織 ID を確認する方法については、組織リソース ID の取得をご覧ください。

    必要に応じて、追加のフラグを使用してデータセットを詳細に構成できます。

    • --include-buckets=BUCKET_NAMES_OR_REGEX を使用して、名前または正規表現で特定のバケットを含めます。このフラグが使用されている場合、--exclude-buckets は使用できません。

    • --exclude-buckets=BUCKET_NAMES_OR_REGEX を使用すると、名前または正規表現で特定のバケットを除外できます。このフラグが使用されている場合、--include-buckets は使用できません。

    • --project=DESTINATION_PROJECT_ID を使用して、データセット構成と生成されたデータセットの保存に使用するプロジェクトを指定します。このフラグを使用しない場合、宛先プロジェクトがアクティブなプロジェクトになります。プロジェクト ID の詳細については、プロジェクトの作成と管理をご覧ください。

    • --auto-add-new-buckets を使用すると、今後ソース プロジェクトに追加されるバケットを自動的に含めることができます。

    • --skip-verification を使用すると、検証プロセスのチェックとエラー（必要な IAM 権限のチェックなど）をスキップできます。使用すると、一部またはすべてのバケットがデータセットから除外される可能性があります。

    • --identity=IDENTITY_TYPE を使用して、データセット構成とともに作成されるサービス エージェントのタイプを指定します。値は IDENTITY_TYPE_PER_CONFIG または IDENTITY_TYPE_PER_PROJECT です。指定しない場合は、デフォルトで IDENTITY_TYPE_PER_CONFIG になります。

    • --description=DESCRIPTION を使用して、データセット構成の説明を記述します。

REST API

JSON API

  1. gcloud CLI のインストールと初期化を行います。これにより、Authorization ヘッダーのアクセス トークンを生成できます。

  2. 次の情報が含まれる JSON ファイルを作成します。

    {
  "organization_number": "ORGANIZATION_ID",
  "source_projects": {
    "project_numbers": ["PROJECT_NUMBERS", ...]
  },
  "retention_period_days": "RETENTION_PERIOD_DAYS",
  "identity": {
    "type": "IDENTITY_TYPE"
  }
}

    次のように置き換えます。

    • ORGANIZATION_ID は、ソース プロジェクトが属する 組織のリソース ID に置き換えます。組織 ID を確認する方法については、組織リソース ID の取得をご覧ください。

    • PROJECT_NUMBERS は、データセットに含めるプロジェクトの番号に置き換えます。1 つまたは複数のプロジェクトを指定できます。プロジェクトは文字列のリストとして指定する必要があります。

    • RETENTION_PERIOD_DAYS は、データセット スナップショットでキャプチャするデータの日数に置き換えます。例: 90

    • IDENTITY_TYPE は、データセット構成とともに作成されるサービス アカウントのタイプに置き換えます。値は IDENTITY_TYPE_PER_CONFIG か IDENTITY_TYPE_PER_PROJECT です。

  3. データセット構成を作成するには、cURL を使用して、Create DatasetConfig リクエストで JSON API を呼び出します。

    curl -X POST --data-binary @JSON_FILE_NAME \
"https://storageinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasetConfigs?datasetConfigId=DATASET_CONFIG_ID" \
  --header "Authorization: Bearer ACCESS_TOKEN" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json"

    次のように置き換えます。

    • JSON_FILE_NAME は、前の手順で作成した JSON ファイルのパスに置き換えます。または、リクエスト本文で DatasetConfig のインスタンスを渡すこともできます。

    • PROJECT_ID は、データセット構成とデータセットが属するプロジェクトの ID に置き換えます。

    • LOCATION は、データセットとデータセット構成が配置されるロケーションに置き換えます。例: us-central1

    • DATASET_CONFIG_ID は、データセット構成に付ける名前に置き換えます。名前はデータセット構成の ID として使用され、不変ではありません。名前には英字、数字、アンダースコアを使用して最大 128 文字を使用できます。名前の先頭は文字にする必要があります。

    • ACCESS_TOKEN は、Google Cloud CLI のインストールと初期化時に生成したアクセス トークンに置き換えます。

error_attributes_view に記録されたスナップショット処理エラーのトラブルシューティングについては、Storage Insights データセットのエラーをご覧ください。

サービス エージェントに必要な権限を付与する

Google Cloud は、データセット構成を作成するときに、構成スコープまたはプロジェクト スコープのサービス エージェントを作成します。サービス エージェントは命名形式 service-PROJECT_NUMBER@gcp-sa-storageinsights.iam.gserviceaccount.com に従います。この名前は、[Google 提供のロール付与を含みます] チェックボックスが選択されているときに、Google Cloud コンソールの [IAM] ページに表示されます。JSON API を使用して DatasetConfig リソースを表示することで、サービス エージェントの名前を確認することもできます。

Storage Insights でデータセットを生成して書き込むようにするには、ソース プロジェクトを含む組織で、サービス エージェントに Storage Insights Collector Service ロール（roles/storage.insightsCollectorService）を付与するよう管理者に依頼してください。このロールは、データを取得するデータセット構成ごとに作成される、構成スコープのサービス エージェントごとに付与する必要があります。プロジェクト スコープのサービス エージェントを使用している場合、サービス エージェントがプロジェクト内のすべてのデータセット構成のデータセットを読み書きできるようにするには、このロールを 1 回だけ付与する必要があります。

プロジェクトにロールを付与する手順については、アクセスを管理するをご覧ください。

データセットを BigQuery にリンクする手順は次のとおりです。

  1. Google Cloud コンソールで、Cloud Storage の [Storage Insights] ページに移動します。

    Storage Insights に移動

  2. リンクするデータセットを生成するデータセット構成の名前をクリックします。

  3. [BigQuery のリンクされたデータセット] セクションで、[データセットをリンク] をクリックしてデータセットをリンクします。

  1. データセットを BigQuery にリンクするには、gcloud storage insights dataset-configs create-link コマンドを実行します。

    gcloud storage insights dataset-configs create-link DATASET_CONFIG_ID --location=LOCATION

    次のように置き換えます。

    • DATASET_CONFIG_ID は、リンクするデータセットを生成するデータセット構成の名前に置き換えます。

    • LOCATION は、データセットのロケーションに置き換えます。例: us-central1

    DATASET_CONFIG_NAME と LOCATION を指定する代わりに、完全なデータセット構成パスを指定することもできます。次に例を示します。

    gcloud storage insights dataset-configs create-link projects/DESTINATION_PROJECT_ID/locations/LOCATION/datasetConfigs/DATASET_CONFIG_ID_

    次のように置き換えます。

    • DESTINATION_PROJECT_ID は、データセット構成を含むプロジェクトの ID に置き換えます。プロジェクト ID の詳細については、プロジェクトの作成と管理をご覧ください。

    • DATASET_CONFIG_ID は、リンクするデータセットを生成するデータセット構成の名前に置き換えます。

    • LOCATION は、データセットとデータセット構成のロケーションに置き換えます。例: us-central1

  1. gcloud CLI のインストールと初期化を行います。これにより、Authorization ヘッダーのアクセス トークンを生成できます。

  2. 次の情報が含まれる JSON ファイルを作成します。

    {
  "name": "DATASET_NAME"
}

    次のように置き換えます。

    • DATASET_NAME は、リンクするデータセットの名前に置き換えます。例: my_project.my_dataset276daa7e_2991_4f4f_b9d4_e354b48426a2

  3. cURL を使用して、linkDataset DatasetConfig リクエストで JSON API を呼び出します。

    curl --request POST --data-binary @JSON_FILE_NAME \
"https://storageinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasetConfigsDATASET_CONFIG_ID:linkDataset?" \
  --header "Authorization: Bearer ACCESS_TOKEN" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \

    次のように置き換えます。

    • JSON_FILE_NAME は、前の手順で作成した JSON ファイルのパスに置き換えます。

    • PROJECT_ID は、データセット構成が属するプロジェクトの ID に置き換えます。

    • LOCATION は、データセットとデータセット構成が存在するロケーションに置き換えます。例: us-central1

    • DATASET_CONFIG_ID は、リンクするデータセットを生成するデータセット構成の名前に置き換えます。

    • ACCESS_TOKEN は、Google Cloud CLI のインストールと初期化時に生成したアクセス トークンに置き換えます。

リンクされたデータセットを表示してクエリを実行する

リンクされたデータセットを表示してクエリを実行する手順は次のとおりです。

  1. Google Cloud コンソールで、Cloud Storage の [Storage Insights] ページに移動します。

    Storage Insights に移動

    プロジェクトに作成されたデータセット構成のリストが表示されます。

  2. 表示するデータセット構成の BigQuery リンク済みデータセットをクリックします。

    BigQuery リンク済みデータセットが Google Cloud コンソールに表示されます。メタデータのデータセット スキーマについては、メタデータのデータセット スキーマをご覧ください。

  3. 他の BigQuery テーブルに対してクエリを実行するのと同じ方法で、リンクされたデータセット内のテーブルとビューに対してクエリを実行できます。

データセット構成の BigQuery データセットへの公開を停止するには、データセットのリンクを解除します。データセットのリンクを解除する手順は次のとおりです。

  1. Google Cloud コンソールで、Cloud Storage の [Storage Insights] ページに移動します。

    Storage Insights に移動

  2. リンクを解除するデータセットを生成するデータセット構成の名前をクリックします。

  3. [BigQuery のリンクされたデータセット] セクションで、[データセットのリンクを解除] をクリックしてデータセットのリンクを解除します。

  1. データセットのリンクを解除するには、gcloud storage insights dataset-configs delete-link コマンドを実行します。

    gcloud storage insights dataset-configs delete-link DATASET_CONFIG_ID --location=LOCATION

    次のように置き換えます。

    • DATASET_CONFIG_ID は、リンクを解除するデータセットを生成するデータセット構成の名前に置き換えます。

    • LOCATION は、データセットとデータセット構成のロケーションに置き換えます。例: us-central1

    DATASET_CONFIG_NAME と LOCATION を指定する代わりに、完全なデータセット構成パスを指定することもできます。次に例を示します。

    gcloud storage insights dataset-configs delete-link projects/DESTINATION_PROJECT_ID/locations/LOCATION/datasetConfigs/DATASET_CONFIG_ID

    次のように置き換えます。

    • DESTINATION_PROJECT_ID は、データセット構成を含むプロジェクトの ID に置き換えます。プロジェクト ID の詳細については、プロジェクトの作成と管理をご覧ください。

    • DATASET_CONFIG_ID は、リンクを解除するデータセットを生成するデータセット構成の名前に置き換えます。

    • LOCATION は、データセットとデータセット構成のロケーションに置き換えます。例: us-central1

  1. gcloud CLI のインストールと初期化を行います。これにより、Authorization ヘッダーのアクセス トークンを生成できます。

  2. 次の情報が含まれる JSON ファイルを作成します。

    {
  "name": "DATASET_NAME"
}

    次のように置き換えます。

    • DATASET_NAME は、リンクを解除するデータセットの名前に置き換えます。例: my_project.my_dataset276daa7e_2991_4f4f_b9d4_e354b48426a2

  3. cURL を使用して、unlinkDataset DatasetConfig リクエストで JSON API を呼び出します。

    curl --request POST --data-binary @JSON_FILE_NAME \
"https://storageinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasetConfigsDATASET_CONFIG_ID:unlinkDataset?" \
  --header "Authorization: Bearer ACCESS_TOKEN" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \

    次のように置き換えます。

    • JSON_FILE_NAME は、前の手順で作成した JSON ファイルのパスに置き換えます。

    • PROJECT_ID は、データセット構成が属するプロジェクトの ID に置き換えます。

    • LOCATION は、データセットとデータセット構成のロケーションに置き換えます。例: us-central1

    • DATASET_CONFIG_ID は、リンクを解除するデータセットを生成するデータセット構成の名前に置き換えます。

    • ACCESS_TOKEN は、Google Cloud CLI のインストールと初期化時に生成したアクセス トークンに置き換えます。

データセットの構成を表示する

データセット構成を表示する手順は次のとおりです。

Console

  1. Google Cloud コンソールで、Cloud Storage の [Storage Insights] ページに移動します。

    Storage Insights に移動

  2. 表示するデータセット構成の名前をクリックします。

    データセット構成の詳細が表示されます。

コマンドライン

  1. データセット構成を記述するには、gcloud storage insights dataset-configs describe コマンドを実行します。

    gcloud storage insights dataset-configs describe DATASET_CONFG_ID \
  --location=LOCATION

    次のように置き換えます。

    • DATASET_CONFIG_ID は、データセット構成の名前に置き換えます。

    • LOCATION は、データセットとデータセット構成のロケーションに置き換えます。

    DATASET_CONFIG_NAME と LOCATION を指定する代わりに、完全なデータセット構成パスを指定することもできます。次に例を示します。

    gcloud storage insights dataset-configs describe projects/DESTINATION_PROJECT_ID/locations/LOCATION/datasetConfigs/DATASET_CONFIG_ID

    次のように置き換えます。

    • DESTINATION_PROJECT_ID は、データセット構成を含むプロジェクトの ID に置き換えます。プロジェクト ID の詳細については、プロジェクトの作成と管理をご覧ください。

    • DATASET_CONFIG_ID は、表示するデータセットを生成するデータセット構成の名前に置き換えます。

    • LOCATION は、データセットとデータセット構成のロケーションに置き換えます。例: us-central1

REST API

JSON API

  1. gcloud CLI のインストールと初期化を行います。これにより、Authorization ヘッダーのアクセス トークンを生成できます。

  2. cURL を使用して、Get DatasetConfig リクエストで JSON API を呼び出します。

    curl -X GET \
"https://storageinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasetConfigs/DATASET_CONFIG_ID" \
  --header "Authorization: Bearer ACCESS_TOKEN" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \

    次のように置き換えます。

    • PROJECT_ID は、データセット構成が属するプロジェクトの ID に置き換えます。

    • LOCATION は、データセットとデータセット構成のロケーションに置き換えます。例: us-central1

    • DATASET_CONFIG_ID は、データセット構成の名前に置き換えます。

    • ACCESS_TOKEN は、Google Cloud CLI のインストールと初期化時に生成したアクセス トークンに置き換えます。

データセット構成を一覧表示する

プロジェクト内のデータセット構成を一覧表示するには、次の操作を行います。

Console

  1. Google Cloud コンソールで、Cloud Storage の [Storage Insights] ページに移動します。

    Storage Insights に移動

    データセット構成のリストが表示されます。

コマンドライン

  1. プロジェクト内のデータセット構成を一覧表示するには、gcloud storage insights dataset-configs list コマンドを実行します。

    gcloud storage insights dataset-configs list --location=LOCATION

    次のように置き換えます。

    • LOCATION は、データセットとデータセット構成のロケーションに置き換えます。例: us-central1

    次のオプションのフラグを使用して、リスティング呼び出しの動作を指定できます。

    • --page-size を使用して、ページごとに返される結果の最大数を指定します。

    • --filter=FILTER を使用して結果をフィルタします。--filter フラグの使用方法の詳細については、gcloud topic filters を実行してドキュメントをご覧ください。

    • --sort-by=SORT_BY_VALUE を使用して、並べ替えるリソース フィールド キー名のカンマ区切りのリストを指定します。例: --sort-by=DATASET_CONFIG_NAME

REST API

JSON API

  1. gcloud CLI のインストールと初期化を行います。これにより、Authorization ヘッダーのアクセス トークンを生成できます。

  2. cURL を使用して、Get DatasetConfig リクエストで JSON API を呼び出します。

    curl -X GET \
"https://storageinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasetConfigs" \
  --header "Authorization: Bearer ACCESS_TOKEN" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \

    次のように置き換えます。

    • PROJECT_ID は、データセット構成が属するプロジェクトの ID に置き換えます。

    • LOCATION は、データセットとデータセット構成のロケーションに置き換えます。例: us-central1

    • ACCESS_TOKEN は、Google Cloud CLI のインストールと初期化時に生成したアクセス トークンに置き換えます。

データセットの構成を更新する

データセットの構成を更新する手順は次のとおりです。

Console

  1. Google Cloud コンソールで、Cloud Storage の [Storage Insights] ページに移動します。

    Storage Insights に移動

  2. 更新するデータセット構成の名前をクリックします。

  3. 表示された [データセットの構成] タブで、[編集] をクリックしてフィールドを更新します。

コマンドライン

  1. データセット構成を更新するには、gcloud storage insights dataset-configs update コマンドを実行します。

    gcloud storage insights dataset-configs update DATASET_CONFG_ID \
  --location=LOCATION

    次のように置き換えます。

    • DATASET_CONFIG_ID は、データセット構成の名前に置き換えます。

    • LOCATION は、データセットとデータセット構成のロケーションに置き換えます。

    次のフラグを使用して、データセット構成のプロパティを更新します。

    • --skip-verification を使用すると、検証プロセスのチェックとエラー（必要な IAM 権限のチェックなど）をスキップできます。使用すると、一部またはすべてのバケットがデータセットから除外される可能性があります。

    • --retention-period-days=DAYS を使用して、データセット スナップショットでキャプチャする移動日数を指定します。例: 90

    • --description=DESCRIPTION を使用して、データセット構成の説明を記述します。

REST API

JSON API

  1. gcloud CLI のインストールと初期化を行います。これにより、Authorization ヘッダーのアクセス トークンを生成できます。

  2. 次のオプション情報を含む JSON ファイルを作成します。

    {
  "organization_number": "ORGANIZATION_ID",
  "source_projects": {
    "project_numbers": "PROJECT_NUMBERS"
  },
  "retention_period_days": RETENTION_PERIOD"
}

    次のように置き換えます。

    • ORGANIZATION_ID は、ソース プロジェクトが属する 組織のリソース ID に置き換えます。

    • PROJECT_NUMBERS は、データセットに含めるプロジェクト番号に置き換えます。1 つまたは複数のプロジェクトを指定できます。プロジェクトはリスト形式で指定する必要があります。

    • RETENTION_PERIOD は、データセット スナップショットでキャプチャする移動日数に置き換えます。例: 90

  3. データセット構成を更新するには、cURL を使用して、Patch DatasetConfig リクエストで JSON API を呼び出します。

    curl -X PATCH --data-binary @JSON_FILE_NAME \
"https://storageinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasetConfigs/DATASET_CONFIG_ID?updateMask=RETENTION_PERIOD" \
  --header "Authorization: Bearer ACCESS_TOKEN" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \

    次のように置き換えます。

    • JSON_FILE_NAME は、前の手順で作成した JSON ファイルのパスに置き換えます。

    • PROJECT_ID は、データセット構成が属するプロジェクトの ID に置き換えます。

    • LOCATION は、データセットとデータセット構成のロケーションに置き換えます。例: us-central1

    • DATASET_CONFIG_ID は、更新するデータセット構成の名前に置き換えます。

    • RETENTION_PERIOD は、データセット スナップショットでキャプチャする移動日数に置き換えます。例: 90

    • ACCESS_TOKEN は、Google Cloud CLI のインストールと初期化時に生成したアクセス トークンに置き換えます。

データセットの構成を削除する

データセット構成を削除する手順は次のとおりです。

Console

  1. Google Cloud コンソールで、Cloud Storage の [Storage Insights] ページに移動します。

    Storage Insights に移動

  2. 削除するデータセット構成の名前をクリックします。

  3. [削除] をクリックします。

コマンドライン

  1. データセット構成を削除するには、gcloud storage insights dataset-configs delete コマンドを実行します。

    gcloud storage insights dataset-configs delete DATASET_CONFG_ID \
  --location=LOCATION

    次のように置き換えます。

    • DATASET_CONFIG_ID は、削除するデータセット構成の名前に置き換えます。

    • LOCATION は、データセットとデータセット構成のロケーションに置き換えます。例: us-central1

    次のフラグを使用して、データセット構成のプロパティを更新します。

    • --auto-delete-link を使用して、削除するデータセット構成から生成されたデータセットのリンクを解除します。データセットを生成するデータセット構成を削除する前に、データセットのリンクを解除する必要があります。

    • --retention-period-days=DAYS を使用して、データセット スナップショットでキャプチャするデータの日数を指定します。例: 90

    DATASET_CONFIG_NAME と LOCATION を指定する代わりに、完全なデータセット構成パスを指定することもできます。次に例を示します。

    gcloud storage insights dataset-configs describe projects/DESTINATION_PROJECT_ID/locations/LOCATION/datasetConfigs/DATASET_CONFIG_ID

REST API

JSON API

  1. gcloud CLI のインストールと初期化を行います。これにより、Authorization ヘッダーのアクセス トークンを生成できます。

  2. cURL を使用して、Delete DatasetConfig リクエストで JSON API を呼び出します。

    curl -X DELETE \
"https://storageinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasetConfigs/DATASET_CONFIG_ID" \
  --header "Authorization: Bearer ACCESS_TOKEN" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \

    次のように置き換えます。

    • PROJECT_ID は、データセット構成が属するプロジェクトの ID に置き換えます。

    • LOCATION は、データセットとデータセット構成のロケーションに置き換えます。例: us-central1

    • DATASET_CONFIG_ID は、削除するデータセット構成の名前に置き換えます。

    • ACCESS_TOKEN は、Google Cloud CLI のインストールと初期化時に生成したアクセス トークンに置き換えます。

次のステップ