このページでは、公共インターネット上ですべての人が閲覧できるオブジェクトの作成方法を示します。公開されたデータへのアクセス方法については、一般公開データへのアクセスをご覧ください。
オブジェクトが公開されて共有されると、そのオブジェクトが公開されている限り、そのオブジェクトの URI を知っているすべてのユーザーがオブジェクトにアクセスできます。
必要なロール
オブジェクトを一般公開するために必要な権限を取得するには、公開するデータを含むバケットに対する次のロールを付与するよう管理者に依頼してください。
バケット内のすべてのオブジェクトを一般公開する: ストレージ管理者(
roles/storage.admin
)個々のオブジェクトを一般公開する: Storage オブジェクト管理者(
roles/storage.objectAdmin
)- Google Cloud コンソールの使用を予定している場合は、Storage オブジェクト管理者ロールではなく、ストレージ管理者(
roles/storage.admin
)ロールが必要です。
- Google Cloud コンソールの使用を予定している場合は、Storage オブジェクト管理者ロールではなく、ストレージ管理者(
これらのロールには、オブジェクトを公開するために必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。
必要な権限
storage.buckets.get
storage.buckets.getIamPolicy
storage.buckets.setIamPolicy
storage.buckets.update
storage.objects.get
storage.objects.getIamPolicy
storage.objects.setIamPolicy
storage.objects.update
次の権限は、Google Cloud コンソールを使用してこのページのタスクを実行する場合にのみ必要です。
storage.buckets.list
storage.objects.list
これらの権限は、他の事前定義ロールやカスタムロールを使用して取得することもできます。
バケットに対してロールを付与する手順については、バケットで IAM を使用するをご覧ください。
バケット内のすべてのオブジェクトを公開する
公共のインターネット上のすべてのユーザーがバケット内のすべてのオブジェクトを閲覧できるようにするには、プリンシパル allUsers
に Storage オブジェクト閲覧者(roles/storage.objectViewer
)のロールを付与します。
コンソール
- Google Cloud コンソールで、Cloud Storage の [バケット] ページに移動します。
バケットのリストで、公開するバケットの名前をクリックします。
ページ上部にある [権限] タブを選択します。
[権限] セクションで、[
アクセスを許可] ボタンをクリックします。[アクセスを許可] ダイアログが表示されます。
[新しいプリンシパル] フィールドに「
allUsers
」と入力します。[ロールを選択] プルダウンで、フィルタ ボックスに「
Storage Object Viewer
」と入力し、フィルタされた結果から [Storage オブジェクト閲覧者] を選択します。[保存] をクリックします。
[一般公開アクセスを許可] をクリックします。
公開アクセスが付与されると、各オブジェクトの [公開アクセス] 列に [URL をコピー] が表示されます。このボタンをクリックすると、オブジェクトの公開 URL を取得できます。
失敗した Cloud Storage オペレーションの詳細なエラー情報を Google Cloud コンソールで確認する方法については、トラブルシューティングをご覧ください。
コマンドライン
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
開発環境で、
buckets add-iam-policy-binding
コマンドを実行します。gcloud storage buckets add-iam-policy-binding gs://BUCKET_NAME --member=allUsers --role=roles/storage.objectViewer
ここで、
BUCKET_NAME
は、オブジェクトを公開するバケットの名前です。例:my-bucket
クライアント ライブラリ
C++
詳細については、Cloud Storage C++ API のリファレンス ドキュメントをご覧ください。
Cloud Storage に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、クライアント ライブラリの認証情報を設定するをご覧ください。
C#
詳細については、Cloud Storage C# API のリファレンス ドキュメントをご覧ください。
Cloud Storage に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、クライアント ライブラリの認証情報を設定するをご覧ください。
Go
詳細については、Cloud Storage Go API のリファレンス ドキュメントをご覧ください。
Cloud Storage に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、クライアント ライブラリの認証情報を設定するをご覧ください。
Java
詳細については、Cloud Storage Java API のリファレンス ドキュメントをご覧ください。
Cloud Storage に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、クライアント ライブラリの認証情報を設定するをご覧ください。
Node.js
詳細については、Cloud Storage Node.js API のリファレンス ドキュメントをご覧ください。
Cloud Storage に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、クライアント ライブラリの認証情報を設定するをご覧ください。
PHP
詳細については、Cloud Storage PHP API のリファレンス ドキュメントをご覧ください。
Cloud Storage に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、クライアント ライブラリの認証情報を設定するをご覧ください。
Python
詳細については、Cloud Storage Python API のリファレンス ドキュメントをご覧ください。
Cloud Storage に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、クライアント ライブラリの認証情報を設定するをご覧ください。
Ruby
詳細については、Cloud Storage Ruby API のリファレンス ドキュメントをご覧ください。
Cloud Storage に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、クライアント ライブラリの認証情報を設定するをご覧ください。
Terraform
バケット内のすべてのオブジェクトを公開するには、Terraform リソースを使用します。
REST API
JSON API
gcloud CLI のインストールと初期化を行います。これにより、
Authorization
ヘッダーのアクセス トークンを生成できます。次の情報が含まれる JSON ファイルを作成します。
{ "bindings":[ { "role": "roles/storage.objectViewer", "members":["allUsers"] } ] }
cURL
を使用して、PUT
Bucket リクエストで JSON API を呼び出します。curl -X PUT --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/iam"
ここで
JSON_FILE_NAME
は、手順 2 で作成したファイルのパスです。BUCKET_NAME
は、オブジェクトを公開するバケットの名前です。例:my-bucket
XML API
XML API では、バケット内のすべてのオブジェクトを公開して読み取り可能にすることはできません。Google Cloud コンソールまたは gcloud storage
を使用します。
バケットの一部を一般公開する
マネージド フォルダを使用して、名前接頭辞がマネージド フォルダの名前と一致するオブジェクトへのアクセスを制御します。たとえば、my-folder
という名前のマネージド フォルダを使用して、my-folder/cats.jpg
と my-folder/dogs.jpg
という名前のオブジェクトへのアクセスを制御できます。
このようなオブジェクトを一般公開するには、まずマネージド フォルダを作成し、allUsers
にストレージ オブジェクト閲覧者(roles/storage.objectViewer
)のロールを付与する IAM ポリシーをフォルダに設定します。
コンソール
- Google Cloud コンソールで、Cloud Storage の [バケット] ページに移動します。
公開するオブジェクトを含むバケットの名前をクリックします。
次の手順でフォルダを作成します。
[フォルダを作成] ボタンをクリックします。
フォルダの名前を入力します。フォルダがマネージド フォルダに変換されると、この名前で始まるオブジェクトには、フォルダに設定された IAM ロールが適用されます。
[作成] をクリックします。
次の手順で、フォルダをマネージド フォルダに変換します。
バケットのコンテンツを表示するペインで、作成したフォルダの名前を見つけ、その他のオプション アイコン
をクリックします。[アクセス権を編集] をクリックします。
表示されたウィンドウで [有効にする] をクリックします。
次の手順で、
allUsers
にストレージ オブジェクト閲覧者(roles/storage.objectViewer
)ロールを付与する IAM ポリシーをフォルダに追加します。マネージド フォルダの [権限] ペインがまだ開いていない場合は、マネージド フォルダのその他のオプション アイコン
をクリックし、[アクセス権の編集] をクリックします。[権限] ペインで、
[プリンシパルを追加] ボタンをクリックします。[新しいプリンシパル] フィールドに「
allUsers
」と入力します。[ロールを選択] プルダウンで、フィルタ ボックスに「
Storage Object Viewer
」と入力し、フィルタ処理された結果から [Storage オブジェクト閲覧者] を選択します。[保存] をクリックします。
[一般公開アクセスを許可] をクリックします。
公開アクセスが付与されると、各オブジェクトの [公開アクセス] 列に [URL をコピー] が表示されます。このボタンをクリックすると、オブジェクトの公開 URL を取得できます。
失敗した Cloud Storage オペレーションの詳細なエラー情報を Google Cloud コンソールで確認する方法については、トラブルシューティングをご覧ください。
コマンドライン
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
開発環境で、
gcloud storage managed-folders create
コマンドを使用してマネージド フォルダを作成します。gcloud storage managed-folders create gs://BUCKET_NAME/MANAGED_FOLDER_NAME/
ここで
BUCKET_NAME
は、マネージド フォルダを作成するバケットの名前です。例:my-bucket
MANAGED_FOLDER_NAME
は、作成するマネージド フォルダの名前です。例:my-managed-folder
開発環境で、
gcloud storage managed-folders add-iam-policy-binding
コマンドを使用して、マネージド フォルダの IAM ポリシーにallUsers
を追加します。gcloud storage managed-folders add-iam-policy-binding gs://BUCKET_NAME/MANAGED_FOLDER_NAME --member=allUsers --role=roles/storage.objectViewer
ここで
BUCKET_NAME
は、IAM ポリシーを追加するマネージド フォルダを含むバケットの名前です。例:my-bucket
MANAGED_FOLDER_NAME
は、一般公開を追加するマネージド フォルダの名前です。例:my-managed-folder
REST API
JSON API
gcloud CLI のインストールと初期化を行います。これにより、
Authorization
ヘッダーのアクセス トークンを生成できます。次の情報が含まれる JSON ファイルを作成します。
{ "name": "MANAGED_FOLDER_NAME" }
ここで、
MANAGED_FOLDER_NAME
は、作成するマネージド フォルダの名前です。例:my-managed-folder
cURL
を使用して、Insert ManagedFolder
リクエストで JSON API を呼び出します。curl -X POST --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/managedFolders"
ここで
JSON_FILE_NAME
は、前の手順で作成したファイルのパスです。BUCKET_NAME
は、マネージド フォルダを作成するバケットの名前です。例:my-bucket
次の情報が含まれる JSON ファイルを作成します。
{ "bindings":[ { "role": "roles/storage.objectViewer", "members":["allUsers"] } ] }
cURL
を使用してsetIamPolicy
ManagedFolder リクエストで JSON API を呼び出します。curl -X PUT --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/managedFolders/MANAGED_FOLDER_NAME/iam"
ここで
JSON_FILE_NAME
は、前の手順で作成したファイルのパスです。BUCKET_NAME
は、IAM ポリシーを追加するマネージド フォルダを含むバケットの名前です。例:my-bucket
MANAGED_FOLDER_NAME
は、IAM ポリシーを追加するマネージド フォルダの名前です。例:my-managed-folder
XML API
XML API は、マネージド フォルダの操作をサポートしていません。Google Cloud コンソールなどの別のツールを使用するか、Set Object ACL
リクエストを使用して個々のオブジェクトに ACL を設定します。以下は、オブジェクトに allUsers
アクセス権を付与する ACL ファイルの例です。
<AccessControlList> <Entries> <Entry> <Scope type="AllUsers"/> <Permission>READ</Permission> </Entry> </Entries> </AccessControlList>
次のステップ
- 公開されたデータにアクセスする。
- バケットとオブジェクトのアクセス制御オプションの詳細を確認する。