このページの一部またはすべての情報は、S3NS の Trusted Cloud に適用されない場合があります。

gcloud ツールを使用してオブジェクトストレージを検出する

このページでは、gcloud コマンドラインツールを使用して Cloud Storage で基本的なタスクを実行する方法について説明します。

Cloud Storage で発生する費用は、使用するリソースによって異なります。このクイックスタートでは、ほとんどの場合、費用が $0.01 USD 未満の Cloud Storage リソースを使用します。

始める前に

Install the Google Cloud CLI.
フェデレーション ID を使用するように gcloud CLI を構成します。

詳細については、フェデレーション ID を使用して gcloud CLI にログインするをご覧ください。
gcloud CLI を初期化するには、次のコマンドを実行します。
```
gcloud init
```
Create or select a Trusted Cloud project.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.
- Create a Trusted Cloud project:
```
gcloud projects create PROJECT_ID
```
  Replace PROJECT_ID with a name for the Trusted Cloud project you are creating.
- Select the Trusted Cloud project that you created:
```
gcloud config set project PROJECT_ID
```
  Replace PROJECT_ID with your Trusted Cloud project name.
Verify that billing is enabled for your Trusted Cloud project.
Grant roles to your user account. Run the following command once for each of the following IAM roles: roles/storage.admin
```
gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE
```
Replace the following:
- PROJECT_ID: your project ID.
- USER_IDENTIFIER: the identifier for your user account. For examples, see Represent workforce pool users in IAM policies.
- ROLE: the IAM role that you grant to your user account.

バケットの作成

バケットは、Cloud Storage でデータを格納する基本的なコンテナです。

バケットを作成するには:

ターミナルウィンドウを開きます。
gcloud storage buckets create コマンドと一意の名前を使用して、バケットを作成します。
```
gcloud storage buckets create gs://my-awesome-bucket/ --uniform-bucket-level-access --location=LOCATION_NAME
```
これは、「my-awesome-bucket」という名前のバケットを使用します。独自のグローバルに固有なバケット名を選択する必要があります。
バケットの命名要件をご覧ください。
- バケット名に使用できるのは、英小文字、数字、ダッシュ（-）、アンダースコア（_）のみです。スペースは使用できません。
- バケット名の先頭と末尾は、数字または文字にする必要があります。
- バケット名の長さは 3～63 文字にする必要があります。ドットを使用している名前には最大 222 文字を使用できますが、ドットで区切られている各要素は 63 文字以下である必要があります。
- バケット名はドット区切りの十進表記の IP アドレス（例: 192.168.5.4）として表すことはできません。
- バケット名の先頭に接頭辞「goog」は使用できません。
- バケット名に「google」や「google」と類似する表記（「g00gle」など）を含めることはできません。
注意: バケットの名前空間はグローバルであり一般公開されるため、バケット名に機密情報を含めないでください。
成功した場合、次の内容が返されます。
```
Creating gs://my-awesome-bucket/...
```

これで、データを保存できるバケットが作成されました。

Creating gs://my-awesome-bucket/...
ServiceException: 409 Bucket my-awesome-bucket already exists.

異なるバケット名でもう一度お試しください。

バケットにオブジェクトをアップロードする

バケットにアップロードする子猫の画像。

上の画像を右クリックして、デスクトップなど、パソコン内に保存します。

注: Compute Engine インスタンスを使用している場合は、次のコマンドを使用してイメージをダウンロードします。 wget https://cloud.google.com/storage/images/kitten.png

gcloud storage cp コマンドを使用して、画像を保存した場所から作成したバケットにコピーします。

gcloud storage cp Desktop/kitten.png gs://my-awesome-bucket

問題なければ、次の内容が返されます。

Copying file://Desktop/kitten.png [Content-Type=image/png]...
Uploading   gs://my-awesome-bucket/kitten.png:       0 B/164.3 KiB
Uploading   gs://my-awesome-bucket/kitten.png:       164.3 KiB/164.3 KiB

これで、オブジェクトをバケットに保存できました。

バケットからのオブジェクトのダウンロード

gcloud storage cp コマンドを使用して、バケットに保存した画像をパソコンのデスクトップなどの場所にダウンロードします。
```
gcloud storage cp gs://my-awesome-bucket/kitten.png Desktop/kitten2.png
```
問題なければ、次の内容が返されます。
```
Copying gs://my-awesome-bucket/kitten.png...
Downloading file://Desktop/kitten2.png:               0 B/164.3 KiB
Downloading file://Desktop/kitten2.png:               164.3 KiB/164.3 KiB
```
これで、バケットからオブジェクトをダウンロードできました。

バケット内のフォルダへのオブジェクトのコピー

gcloud storage cp コマンドを使用してフォルダを作成し、画像をそこにコピーします。
```
gcloud storage cp gs://my-awesome-bucket/kitten.png gs://my-awesome-bucket/just-a-folder/kitten3.png
```
注: ローカルファイルシステムに比べて Cloud Storage のフォルダには制限がありますが、同じオペレーションの多くがサポートされています。
成功した場合、次の内容が返されます。
```
Copying gs://my-awesome-bucket/kitten.png [Content-Type=image/png]...
Copying     ...my-awesome-bucket/just-a-folder/kitten3.png: 164.3 KiB/164.3 KiB
```
これで、バケット内の新しいフォルダに画像がコピーされました。

バケットまたはフォルダの内容を一覧表示する

gcloud storage ls コマンドを使用して、トップレベルのバケットの内容を一覧表示します。
```
gcloud storage ls gs://my-awesome-bucket
```
問題なければ、次のようなメッセージが返されます。
```
gs://my-awesome-bucket/kitten.png
gs://my-awesome-bucket/just-a-folder/
```
これで、トップレベルのバケットの内容を表示できました。

オブジェクトの詳細を表示する

gcloud storage ls コマンドに --long フラグを指定して、画像の 1 つに関するいくつかの詳細を取得します。
```
gcloud storage ls gs://my-awesome-bucket/kitten.png --long
```
問題なければ、次のようなメッセージが返されます。
```
2638  2016-02-26T23:05:14Z  gs://my-awesome-bucket/kitten.png
TOTAL: 1 objects, 168243.2 bytes (164.3 KiB)
```
これで、画像のサイズと作成日に関する情報が取得されました。

オブジェクトを一般公開にする

gcloud storage buckets add-iam-policy-binding コマンドを使用して、バケットに保存されているイメージの読み取り権限をすべてのユーザーに付与します。
```
gcloud storage buckets add-iam-policy-binding gs://my-awesome-bucket --member=allUsers --role=roles/storage.objectViewer
```
レスポンスに次のものが含まれている場合、コマンドは成功です。
```
bindings:
  - members:
    - allUsers
    role: roles/storage.objectViewer
```
これで、誰でも画像を取得できるようになりました。
このアクセス権を削除するには、次のコマンドを使用します。
```
gcloud storage buckets remove-iam-policy-binding gs://my-awesome-bucket --member=allUsers --role=roles/storage.objectViewer
```
エラーが返されなければ、コマンドは成功です。

バケット内の画像への公開アクセス権が削除されました。

バケットにアクセス権を付与する

gcloud storage buckets add-iam-policy-binding コマンドを使用して、特定のメールアドレスにバケットへのオブジェクトを追加する権限を付与します。
```
gcloud storage buckets add-iam-policy-binding gs://my-awesome-bucket --member=user:example-service-account@example-project.s3ns-system.iam.gserviceaccount.com --role=roles/storage.objectCreator
```
レスポンスに次のものが含まれている場合、コマンドは成功です。
```
bindings:
  - members:
    - user:example-service-account@example-project.s3ns-system.iam.gserviceaccount.com
    role: roles/storage.objectCreator
```
これで、他のユーザーがバケットにアイテムを追加できるようになりました。
上で付与した閲覧権限を削除するには、次のコマンドを使用します。
```
gcloud storage buckets remove-iam-policy-binding gs://my-awesome-bucket --member=user:example-service-account@example-project.s3ns-system.iam.gserviceaccount.com --role=roles/storage.objectCreator
```
エラーが返されなければ、コマンドは成功です。

このバケットへのユーザーのアクセス権を削除しました。

オブジェクトを削除する

画像のいずれかを削除するには、gcloud storage rm コマンドを使用します。
```
gcloud storage rm gs://my-awesome-bucket/kitten.png
```
問題なければ、次の内容が返されます。
```
Removing gs://my-awesome-bucket/kitten.png...
```
画像のコピーは Cloud Storage に保存されなくなりました（ただし、フォルダ just-a-folder/ に作成したコピーはまだ存在します）。

クリーンアップ

このページで使用したリソースについて、 Trusted Cloud アカウントに課金されないようにするには、リソースを含む Trusted Cloud プロジェクトを削除します。

ターミナルウィンドウを開きます（まだ開いていない場合）。
gcloud storage rm コマンドで --recursive フラグを指定して、バケットとその中のすべてのものを削除します。
```
gcloud storage rm gs://my-awesome-bucket --recursive
```
問題なければ、次のようなメッセージが返されます。
```
Removing gs://my-awesome-bucket/just-a-folder/cloud-storage.logo.png#1456530077282000...
Removing gs://my-awesome-bucket/...
```
バケットとその内容が削除されました。

次のステップ

Trusted Cloud コンソールで Cloud Storage クイックスタートを始める。
Cloud Storage プロダクトの概要を確認する。

バケットの作成（buckets create）、コピー（cp）、リスト（ls）、アクセス権の追加（buckets add-iam-policy-binding）、削除（rm）など、Google Cloud CLI コマンドのリファレンスページを確認する。