1. Packages
  2. Azure Native
  3. API Docs
  4. storage
  5. Blob
This is the latest version of Azure Native. Use the Azure Native v1 docs if using the v1 version of this package.
Azure Native v2.9.0 published on Wednesday, Sep 27, 2023 by Pulumi

azure-native.storage.Blob

Explore with Pulumi AI

azure-native logo
This is the latest version of Azure Native. Use the Azure Native v1 docs if using the v1 version of this package.
Azure Native v2.9.0 published on Wednesday, Sep 27, 2023 by Pulumi

    Manages a Blob within a Storage Container.

    Import

    An existing resource can be imported using its type token, name, and identifier, e.g.

    $ pulumi import azure-native:storage:Blob myresource1 /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/blobServices/default/containers/{containerName}/blobs/{blobName} 
    

    Create Blob Resource

    new Blob(name: string, args: BlobArgs, opts?: CustomResourceOptions);
    @overload
    def Blob(resource_name: str,
             opts: Optional[ResourceOptions] = None,
             access_tier: Optional[BlobAccessTier] = None,
             account_name: Optional[str] = None,
             blob_name: Optional[str] = None,
             container_name: Optional[str] = None,
             content_md5: Optional[str] = None,
             content_type: Optional[str] = None,
             metadata: Optional[Mapping[str, str]] = None,
             resource_group_name: Optional[str] = None,
             source: Optional[Union[pulumi.Asset, pulumi.Archive]] = None,
             type: Optional[BlobType] = None)
    @overload
    def Blob(resource_name: str,
             args: BlobArgs,
             opts: Optional[ResourceOptions] = None)
    func NewBlob(ctx *Context, name string, args BlobArgs, opts ...ResourceOption) (*Blob, error)
    public Blob(string name, BlobArgs args, CustomResourceOptions? opts = null)
    public Blob(String name, BlobArgs args)
    public Blob(String name, BlobArgs args, CustomResourceOptions options)
    
    type: azure-native:storage:Blob
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    
    name string
    The unique name of the resource.
    args BlobArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args BlobArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args BlobArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args BlobArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args BlobArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Blob Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    The Blob resource accepts the following input properties:

    AccountName string

    Specifies the storage account in which to create the storage container.

    ContainerName string

    The name of the storage container in which this blob should be created.

    ResourceGroupName string

    The name of the resource group within the user's subscription.

    AccessTier Pulumi.AzureNative.Storage.BlobAccessTier

    The access tier of the storage blob.

    BlobName string

    The name of the storage blob. Must be unique within the storage container the blob is located.

    ContentMd5 string

    The MD5 sum of the blob contents. Cannot be defined if blob type is Append.

    ContentType string

    The content type of the storage blob. Defaults to application/octet-stream.

    Metadata Dictionary<string, string>

    A map of custom blob metadata.

    Source AssetOrArchive

    An asset to copy to the blob contents. This field cannot be specified for Append blobs.

    Type Pulumi.AzureNative.Storage.BlobType

    The type of the storage blob to be created. Defaults to 'Block'.

    AccountName string

    Specifies the storage account in which to create the storage container.

    ContainerName string

    The name of the storage container in which this blob should be created.

    ResourceGroupName string

    The name of the resource group within the user's subscription.

    AccessTier BlobAccessTier

    The access tier of the storage blob.

    BlobName string

    The name of the storage blob. Must be unique within the storage container the blob is located.

    ContentMd5 string

    The MD5 sum of the blob contents. Cannot be defined if blob type is Append.

    ContentType string

    The content type of the storage blob. Defaults to application/octet-stream.

    Metadata map[string]string

    A map of custom blob metadata.

    Source pulumi.AssetOrArchive

    An asset to copy to the blob contents. This field cannot be specified for Append blobs.

    Type BlobType

    The type of the storage blob to be created. Defaults to 'Block'.

    accountName String

    Specifies the storage account in which to create the storage container.

    containerName String

    The name of the storage container in which this blob should be created.

    resourceGroupName String

    The name of the resource group within the user's subscription.

    accessTier BlobAccessTier

    The access tier of the storage blob.

    blobName String

    The name of the storage blob. Must be unique within the storage container the blob is located.

    contentMd5 String

    The MD5 sum of the blob contents. Cannot be defined if blob type is Append.

    contentType String

    The content type of the storage blob. Defaults to application/octet-stream.

    metadata Map<String,String>

    A map of custom blob metadata.

    source AssetOrArchive

    An asset to copy to the blob contents. This field cannot be specified for Append blobs.

    type BlobType

    The type of the storage blob to be created. Defaults to 'Block'.

    accountName string

    Specifies the storage account in which to create the storage container.

    containerName string

    The name of the storage container in which this blob should be created.

    resourceGroupName string

    The name of the resource group within the user's subscription.

    accessTier BlobAccessTier

    The access tier of the storage blob.

    blobName string

    The name of the storage blob. Must be unique within the storage container the blob is located.

    contentMd5 string

    The MD5 sum of the blob contents. Cannot be defined if blob type is Append.

    contentType string

    The content type of the storage blob. Defaults to application/octet-stream.

    metadata {[key: string]: string}

    A map of custom blob metadata.

    source pulumi.asset.Asset | pulumi.asset.Archive

    An asset to copy to the blob contents. This field cannot be specified for Append blobs.

    type BlobType

    The type of the storage blob to be created. Defaults to 'Block'.

    account_name str

    Specifies the storage account in which to create the storage container.

    container_name str

    The name of the storage container in which this blob should be created.

    resource_group_name str

    The name of the resource group within the user's subscription.

    access_tier BlobAccessTier

    The access tier of the storage blob.

    blob_name str

    The name of the storage blob. Must be unique within the storage container the blob is located.

    content_md5 str

    The MD5 sum of the blob contents. Cannot be defined if blob type is Append.

    content_type str

    The content type of the storage blob. Defaults to application/octet-stream.

    metadata Mapping[str, str]

    A map of custom blob metadata.

    source Union[pulumi.Asset, pulumi.Archive]

    An asset to copy to the blob contents. This field cannot be specified for Append blobs.

    type BlobType

    The type of the storage blob to be created. Defaults to 'Block'.

    accountName String

    Specifies the storage account in which to create the storage container.

    containerName String

    The name of the storage container in which this blob should be created.

    resourceGroupName String

    The name of the resource group within the user's subscription.

    accessTier "Hot" | "Cool" | "Archive"

    The access tier of the storage blob.

    blobName String

    The name of the storage blob. Must be unique within the storage container the blob is located.

    contentMd5 String

    The MD5 sum of the blob contents. Cannot be defined if blob type is Append.

    contentType String

    The content type of the storage blob. Defaults to application/octet-stream.

    metadata Map<String>

    A map of custom blob metadata.

    source Asset

    An asset to copy to the blob contents. This field cannot be specified for Append blobs.

    type "Block" | "Append"

    The type of the storage blob to be created. Defaults to 'Block'.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the Blob resource produces the following output properties:

    Id string

    The provider-assigned unique ID for this managed resource.

    Name string

    The name of the storage blob.

    Url string

    The URL of the blob.

    Id string

    The provider-assigned unique ID for this managed resource.

    Name string

    The name of the storage blob.

    Url string

    The URL of the blob.

    id String

    The provider-assigned unique ID for this managed resource.

    name String

    The name of the storage blob.

    url String

    The URL of the blob.

    id string

    The provider-assigned unique ID for this managed resource.

    name string

    The name of the storage blob.

    url string

    The URL of the blob.

    id str

    The provider-assigned unique ID for this managed resource.

    name str

    The name of the storage blob.

    url str

    The URL of the blob.

    id String

    The provider-assigned unique ID for this managed resource.

    name String

    The name of the storage blob.

    url String

    The URL of the blob.

    Supporting Types

    BlobAccessTier, BlobAccessTierArgs

    Hot
    Hot

    Optimized for storing data that is accessed frequently.

    Cool
    Cool

    Optimized for storing data that is infrequently accessed and stored for at least 30 days.

    Archive
    Archive

    Optimized for storing data that is rarely accessed and stored for at least 180 days with flexible latency requirements, on the order of hours.

    BlobAccessTierHot
    Hot

    Optimized for storing data that is accessed frequently.

    BlobAccessTierCool
    Cool

    Optimized for storing data that is infrequently accessed and stored for at least 30 days.

    BlobAccessTierArchive
    Archive

    Optimized for storing data that is rarely accessed and stored for at least 180 days with flexible latency requirements, on the order of hours.

    Hot
    Hot

    Optimized for storing data that is accessed frequently.

    Cool
    Cool

    Optimized for storing data that is infrequently accessed and stored for at least 30 days.

    Archive
    Archive

    Optimized for storing data that is rarely accessed and stored for at least 180 days with flexible latency requirements, on the order of hours.

    Hot
    Hot

    Optimized for storing data that is accessed frequently.

    Cool
    Cool

    Optimized for storing data that is infrequently accessed and stored for at least 30 days.

    Archive
    Archive

    Optimized for storing data that is rarely accessed and stored for at least 180 days with flexible latency requirements, on the order of hours.

    HOT
    Hot

    Optimized for storing data that is accessed frequently.

    COOL
    Cool

    Optimized for storing data that is infrequently accessed and stored for at least 30 days.

    ARCHIVE
    Archive

    Optimized for storing data that is rarely accessed and stored for at least 180 days with flexible latency requirements, on the order of hours.

    "Hot"
    Hot

    Optimized for storing data that is accessed frequently.

    "Cool"
    Cool

    Optimized for storing data that is infrequently accessed and stored for at least 30 days.

    "Archive"
    Archive

    Optimized for storing data that is rarely accessed and stored for at least 180 days with flexible latency requirements, on the order of hours.

    BlobType, BlobTypeArgs

    Block
    Block

    Block blobs store text and binary data. Block blobs are made up of blocks of data that can be managed individually.

    Append
    Append

    Append blobs are made up of blocks like block blobs, but are optimized for append operations.

    BlobTypeBlock
    Block

    Block blobs store text and binary data. Block blobs are made up of blocks of data that can be managed individually.

    BlobTypeAppend
    Append

    Append blobs are made up of blocks like block blobs, but are optimized for append operations.

    Block
    Block

    Block blobs store text and binary data. Block blobs are made up of blocks of data that can be managed individually.

    Append
    Append

    Append blobs are made up of blocks like block blobs, but are optimized for append operations.

    Block
    Block

    Block blobs store text and binary data. Block blobs are made up of blocks of data that can be managed individually.

    Append
    Append

    Append blobs are made up of blocks like block blobs, but are optimized for append operations.

    BLOCK
    Block

    Block blobs store text and binary data. Block blobs are made up of blocks of data that can be managed individually.

    APPEND
    Append

    Append blobs are made up of blocks like block blobs, but are optimized for append operations.

    "Block"
    Block

    Block blobs store text and binary data. Block blobs are made up of blocks of data that can be managed individually.

    "Append"
    Append

    Append blobs are made up of blocks like block blobs, but are optimized for append operations.

    Package Details

    Repository
    Azure Native pulumi/pulumi-azure-native
    License
    Apache-2.0
    azure-native logo
    This is the latest version of Azure Native. Use the Azure Native v1 docs if using the v1 version of this package.
    Azure Native v2.9.0 published on Wednesday, Sep 27, 2023 by Pulumi