append_blob

Creates, updates, deletes, gets or lists an append_blob resource.

Overview

Name	append_blob
Type	Resource
Id	azure.storage_blob.append_blob

Fields

The following fields are returned by SELECT queries:

SELECT not supported for this resource, use SHOW METHODS to view available operations for the resource.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
create	insert	Content-Length, x-ms-version, account	timeout, x-ms-blob-content-type, x-ms-blob-content-encoding, x-ms-blob-content-language, x-ms-blob-content-md5, x-ms-blob-cache-control, x-ms-meta, x-ms-lease-id, x-ms-blob-content-disposition, x-ms-encryption-key, x-ms-encryption-key-sha256, x-ms-encryption-algorithm, x-ms-encryption-scope, If-Modified-Since, If-Unmodified-Since, If-Match, If-None-Match, x-ms-if-tags, x-ms-client-request-id, x-ms-tags, x-ms-immutability-policy-until-date, x-ms-immutability-policy-mode, x-ms-legal-hold	The Create Append Blob operation creates a new append blob.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
Content-Length	integer	The length of the request. Required.
account	string	Storage account name. (default: )
x-ms-version	string
If-Match	string
If-Modified-Since	string
If-None-Match	string
If-Unmodified-Since	string
timeout	integer	The timeout parameter is expressed in seconds. For more information, see
x-ms-blob-cache-control	string
x-ms-blob-content-disposition	string
x-ms-blob-content-encoding	string
x-ms-blob-content-language	string
x-ms-blob-content-md5	string (byte)
x-ms-blob-content-type	string
x-ms-client-request-id	string	Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the analytics logs when storage analytics logging is enabled. Default value is None.
x-ms-encryption-algorithm	string
x-ms-encryption-key	string
x-ms-encryption-key-sha256	string
x-ms-encryption-scope	string
x-ms-if-tags	string
x-ms-immutability-policy-mode	string	Specifies the immutability policy mode to set on the blob. Known values are: "Mutable", "Unlocked", and "Locked". Default value is None.
x-ms-immutability-policy-until-date	string	Specifies the date time when the blobs immutability policy is set to expire. Default value is None.
x-ms-lease-id	string
x-ms-legal-hold	boolean	Specified if a legal hold should be set on the blob. Default value is None.
x-ms-meta	object	Optional. Specifies a user-defined name-value pair associated with the blob. If no name-value pairs are specified, the operation will copy the metadata from the source blob or file to the destination blob. If one or more name-value pairs are specified, the destination blob is created with the specified metadata, and metadata is not copied from the source blob or file. Note that beginning with version 2009-09-19, metadata names must adhere to the naming rules for C# identifiers. See Naming and Referencing Containers, Blobs, and Metadata for more information. Default value is None.
x-ms-tags	string	Optional. Used to set blob tags in various blob operations. Default value is None.

INSERT examples

create

The Create Append Blob operation creates a new append blob.

INSERT INTO azure.storage_blob.append_blob (
blobCacheControl,
blobContentType,
blobContentMD5,
blobContentEncoding,
blobContentLanguage,
blobContentDisposition,
Content-Length,
x-ms-version,
account,
timeout,
x-ms-blob-content-type,
x-ms-blob-content-encoding,
x-ms-blob-content-language,
x-ms-blob-content-md5,
x-ms-blob-cache-control,
x-ms-meta,
x-ms-lease-id,
x-ms-blob-content-disposition,
x-ms-encryption-key,
x-ms-encryption-key-sha256,
x-ms-encryption-algorithm,
x-ms-encryption-scope,
If-Modified-Since,
If-Unmodified-Since,
If-Match,
If-None-Match,
x-ms-if-tags,
x-ms-client-request-id,
x-ms-tags,
x-ms-immutability-policy-until-date,
x-ms-immutability-policy-mode,
x-ms-legal-hold
)
SELECT 
'{{ blobCacheControl }}',
'{{ blobContentType }}',
'{{ blobContentMD5 }}',
'{{ blobContentEncoding }}',
'{{ blobContentLanguage }}',
'{{ blobContentDisposition }}',
'{{ Content-Length }}',
'{{ x-ms-version }}',
'{{ account }}',
'{{ timeout }}',
'{{ x-ms-blob-content-type }}',
'{{ x-ms-blob-content-encoding }}',
'{{ x-ms-blob-content-language }}',
'{{ x-ms-blob-content-md5 }}',
'{{ x-ms-blob-cache-control }}',
'{{ x-ms-meta }}',
'{{ x-ms-lease-id }}',
'{{ x-ms-blob-content-disposition }}',
'{{ x-ms-encryption-key }}',
'{{ x-ms-encryption-key-sha256 }}',
'{{ x-ms-encryption-algorithm }}',
'{{ x-ms-encryption-scope }}',
'{{ If-Modified-Since }}',
'{{ If-Unmodified-Since }}',
'{{ If-Match }}',
'{{ If-None-Match }}',
'{{ x-ms-if-tags }}',
'{{ x-ms-client-request-id }}',
'{{ x-ms-tags }}',
'{{ x-ms-immutability-policy-until-date }}',
'{{ x-ms-immutability-policy-mode }}',
'{{ x-ms-legal-hold }}'
;

Manifest

# Description fields are for documentation purposes
- name: append_blob
props:
  - name: Content-Length
    value: {{ Content-Length }}
    description: Required parameter for the append_blob resource.
  - name: x-ms-version
    value: "{{ x-ms-version }}"
    description: Required parameter for the append_blob resource.
  - name: account
    value: "{{ account }}"
    description: Required parameter for the append_blob resource.
  - name: blobCacheControl
    value: "{{ blobCacheControl }}"
    description: |
      Optional. Sets the blob's cache control. If specified, this property is stored with the blob and returned with a read request.
  - name: blobContentType
    value: "{{ blobContentType }}"
    description: |
      Optional. Sets the blob's content type. If specified, this property is stored with the blob and returned with a read request.
  - name: blobContentMD5
    value: "{{ blobContentMD5 }}"
    description: |
      Optional. An MD5 hash of the blob content. Note that this hash is not validated, as the hashes for the individual blocks were validated when each was uploaded.
  - name: blobContentEncoding
    value: "{{ blobContentEncoding }}"
    description: |
      Optional. Sets the blob's content encoding. If specified, this property is stored with the blob and returned with a read request.
  - name: blobContentLanguage
    value: "{{ blobContentLanguage }}"
    description: |
      Optional. Set the blob's content language. If specified, this property is stored with the blob and returned with a read request.
  - name: blobContentDisposition
    value: "{{ blobContentDisposition }}"
    description: |
      Optional. Sets the blob's Content-Disposition header.
  - name: timeout
    value: {{ timeout }}
    description: The timeout parameter is expressed in seconds. For more information, see
    description: The timeout parameter is expressed in seconds. For more information, see
  - name: x-ms-blob-content-type
    value: "{{ x-ms-blob-content-type }}"
  - name: x-ms-blob-content-encoding
    value: "{{ x-ms-blob-content-encoding }}"
  - name: x-ms-blob-content-language
    value: "{{ x-ms-blob-content-language }}"
  - name: x-ms-blob-content-md5
    value: "{{ x-ms-blob-content-md5 }}"
  - name: x-ms-blob-cache-control
    value: "{{ x-ms-blob-cache-control }}"
  - name: x-ms-meta
    value: "{{ x-ms-meta }}"
    description: Optional. Specifies a user-defined name-value pair associated with the blob. If no name-value pairs are specified, the operation will copy the metadata from the source blob or file to the destination blob. If one or more name-value pairs are specified, the destination blob is created with the specified metadata, and metadata is not copied from the source blob or file. Note that beginning with version 2009-09-19, metadata names must adhere to the naming rules for C# identifiers. See Naming and Referencing Containers, Blobs, and Metadata for more information. Default value is None.
    description: Optional. Specifies a user-defined name-value pair associated with the blob. If no name-value pairs are specified, the operation will copy the metadata from the source blob or file to the destination blob. If one or more name-value pairs are specified, the destination blob is created with the specified metadata, and metadata is not copied from the source blob or file. Note that beginning with version 2009-09-19, metadata names must adhere to the naming rules for C# identifiers. See Naming and Referencing Containers, Blobs, and Metadata for more information. Default value is None.
  - name: x-ms-lease-id
    value: "{{ x-ms-lease-id }}"
  - name: x-ms-blob-content-disposition
    value: "{{ x-ms-blob-content-disposition }}"
  - name: x-ms-encryption-key
    value: "{{ x-ms-encryption-key }}"
  - name: x-ms-encryption-key-sha256
    value: "{{ x-ms-encryption-key-sha256 }}"
  - name: x-ms-encryption-algorithm
    value: "{{ x-ms-encryption-algorithm }}"
  - name: x-ms-encryption-scope
    value: "{{ x-ms-encryption-scope }}"
  - name: If-Modified-Since
    value: "{{ If-Modified-Since }}"
  - name: If-Unmodified-Since
    value: "{{ If-Unmodified-Since }}"
  - name: If-Match
    value: "{{ If-Match }}"
  - name: If-None-Match
    value: "{{ If-None-Match }}"
  - name: x-ms-if-tags
    value: "{{ x-ms-if-tags }}"
  - name: x-ms-client-request-id
    value: "{{ x-ms-client-request-id }}"
    description: Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the analytics logs when storage analytics logging is enabled. Default value is None.
    description: Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the analytics logs when storage analytics logging is enabled. Default value is None.
  - name: x-ms-tags
    value: "{{ x-ms-tags }}"
    description: Optional. Used to set blob tags in various blob operations. Default value is None.
    description: Optional. Used to set blob tags in various blob operations. Default value is None.
  - name: x-ms-immutability-policy-until-date
    value: "{{ x-ms-immutability-policy-until-date }}"
    description: Specifies the date time when the blobs immutability policy is set to expire. Default value is None.
    description: Specifies the date time when the blobs immutability policy is set to expire. Default value is None.
  - name: x-ms-immutability-policy-mode
    value: "{{ x-ms-immutability-policy-mode }}"
    description: Specifies the immutability policy mode to set on the blob. Known values are: "Mutable", "Unlocked", and "Locked". Default value is None.
    description: Specifies the immutability policy mode to set on the blob. Known values are: "Mutable", "Unlocked", and "Locked". Default value is None.
  - name: x-ms-legal-hold
    value: {{ x-ms-legal-hold }}
    description: Specified if a legal hold should be set on the blob. Default value is None.
    description: Specified if a legal hold should be set on the blob. Default value is None.