terraform/website/source/docs/providers/azurerm/r/storage_blob.html.markdown

2.8 KiB

layout page_title sidebar_current description
azurerm Azure Resource Manager: azurerm_storage_blob docs-azurerm-resource-storage-blob Create a Azure Storage Blob.

azurerm_storage_blob

Create an Azure Storage Blob.

Example Usage

resource "azurerm_resource_group" "test" {
  name     = "acctestrg-%d"
  location = "westus"
}

resource "azurerm_storage_account" "test" {
  name                = "acctestacc%s"
  resource_group_name = "${azurerm_resource_group.test.name}"
  location            = "westus"
  account_type        = "Standard_LRS"
}

resource "azurerm_storage_container" "test" {
  name                  = "vhds"
  resource_group_name   = "${azurerm_resource_group.test.name}"
  storage_account_name  = "${azurerm_storage_account.test.name}"
  container_access_type = "private"
}

resource "azurerm_storage_blob" "testsb" {
  name = "sample.vhd"

  resource_group_name    = "${azurerm_resource_group.test.name}"
  storage_account_name   = "${azurerm_storage_account.test.name}"
  storage_container_name = "${azurerm_storage_container.test.name}"

  type = "page"
  size = 5120
}

Argument Reference

The following arguments are supported:

  • name - (Required) The name of the storage blob. Must be unique within the storage container the blob is located.

  • resource_group_name - (Required) The name of the resource group in which to create the storage container. Changing this forces a new resource to be created.

  • storage_account_name - (Required) Specifies the storage account in which to create the storage container. Changing this forces a new resource to be created.

  • storage_container_name - (Required) The name of the storage container in which this blob should be created.

  • type - (Optional) The type of the storage blob to be created. One of either block or page. When not copying from an existing blob, this becomes required.

  • size - (Optional) Used only for page blobs to specify the size in bytes of the blob to be created. Must be a multiple of 512. Defaults to 0.

  • source - (Optional) An absolute path to a file on the local system. Cannot be defined if source_uri is defined.

  • source_uri - (Optional) The URI of an existing blob, or a file in the Azure File service, to use as the source contents for the blob to be created. Changing this forces a new resource to be created. Cannot be defined if source is defined.

  • parallelism - (Optional) The number of workers per CPU core to run for concurrent uploads. Defaults to 8.

  • attempts - (Optional) The number of attempts to make per page or block when uploading. Defaults to 1.

Attributes Reference

The following attributes are exported in addition to the arguments listed above:

  • id - The storage blob Resource ID.
  • url - The URL of the blob