オブジェクトストレージ(sakuracloud_bucket_object)

さくらのクラウド オブジェクトストレージ上のオブジェクトを扱うためのリソースです。

[Note]
さくらのクラウドではAPIによるバケットの生成がサポートされていません。
このため、当リソースを利用する場合、あらかじめコントロールパネルからバケットを作成しておく必要があります。

• このリソースはimport非対応です。

---

設定例

resource "sakuracloud_bucket_object" "foobar" {
  #アクセスキー(環境変数SACLOUD_OJS_ACCESS_KEY_ID、またはAWS_ACCESS_KEY_IDでも指定可能)  
  #access_key = ""

  #シークレットキー(環境変数SACLOUD_OJS_SECRET_ACCESS_KEY、またはAWS_SECRET_ACCESS_KEYでも指定可能)
  #secret_key = ""

  #バケット名
  bucket = "your-bucket-name"

  #キー
  key = "your/object/key.txt"

  #ボディ:
  #文字列で指定する場合
  content = "content"

  #ファイルを指定する場合
  #source = "path/your/object/file"

  #ETag: オブジェクトストレージ上でオブジェクトが変更されたことを検知したい場合に指定
  #etag = md5(file("path/your/object/file"))
}

パラメーター

パラメーター	必須	名称	初期値	設定値	補足
access_key	◯	アクセスキー	-	文字列	環境変数SACLOUD_OJS_ACCESS_KEY_ID、またはAWS_ACCESS_KEY_IDでも指定可能
secret_key	◯	シークレットキー	-	文字列	環境変数SACLOUD_OJS_SECRET_ACCESS_KEY、またはAWS_SECRET_ACCESS_KEYでも指定可能
bucket	◯	バケット名	-	文字列	-
key	◯	オブジェクトキー	-	文字列	-
content	△	ボディ(文字列)	-	文字列	オブジェクトの内容を文字列で指定する場合に利用する。sourceとの併用は不可
source	△	ボディ(ファイル)	-	文字列	オブジェクトの内容をファイルで指定する場合に利用する。contentとの併用は不可
etag	-	ETag	-	文字列	オブジェクトの内容のMD5ハッシュ、オブジェクトストレージ上でオブジェクトが変更されたことを検知したい場合に指定する

属性

属性名	名称	補足
id	オブジェクトキー	keyと同じ値
content_type	コンテントタイプ
size	サイズ(byte)
last_modified	更新日時
http_url	バーチャルホスト型URL(HTTP)
https_url	バーチャルホスト型URL(HTTPS)
http_path_url	パス型URL(HTTP)
https_path_url	パス型URL(HTTPS)
http_cache_url	キャッシュ配信URL(HTTP)
https_cache_url	キャッシュ配信URL(HTTPS)

属性(データリソースでのみ利用可能)

以下の属性はデータリソースでのみ利用可能です。

属性名	名称	補足
body	ボディ	コンテントタイプがtext/*またはapplication/jsonの場合のみ利用可能です

データリソースの利用例

data "sakuracloud_bucket_object" "foobar" {
  #アクセスキー(環境変数SACLOUD_OJS_ACCESS_KEY_ID、またはAWS_ACCESS_KEY_IDでも指定可能)  
  #access_key = ""
  #シークレットキー(環境変数SACLOUD_OJS_SECRET_ACCESS_KEY、またはAWS_SECRET_ACCESS_KEYでも指定可能)
  #secret_key = ""

  #バケット名
  bucket = "your-bucket-name"
  #キー
  key = "your/object/key.txt"
}