Azure Blob Storage Appendblob API

openapi: 3.2.0
info:
  title: Azure Blob Storage Appendblob API
  version: 2026-10-06
  x-ms-code-generation-settings:
    header: MIT
    strictSpecAdherence: false
  x-source: https://raw.githubusercontent.com/Azure/azure-rest-api-specs/main/specification/storage/data-plane/BlobStorage/stable/2026-10-06/blob.json
  x-conversion: Swagger 2.0 -> OpenAPI 3.0 via swagger2openapi; x-ms-paths merged into paths verbatim; server from documented account endpoint
servers:
- url: https://{accountName}.blob.core.windows.net
  description: 'Azure Blob Storage account endpoint (per docs: https://learn.microsoft.com/en-us/rest/api/storageservices/blob-service-rest-api)'
  variables:
    accountName:
      default: myaccount
      description: Storage account name
tags:
- name: appendblob
paths:
  /{containerName}/{blob}?comp=appendblock:
    parameters:
    - $ref: '#/components/parameters/ContainerName'
    - $ref: '#/components/parameters/Blob'
    - name: comp
      description: comp
      in: query
      required: true
      schema:
        type: string
        enum:
        - appendblock
    put:
      tags:
      - appendblob
      operationId: AppendBlob_AppendBlock
      description: The Append Block operation commits a new block of data to the end of an existing append blob. The Append Block operation is permitted only if the blob was created with x-ms-blob-type set to AppendBlob. Append Block is supported only on version 2015-02-21 version or later.
      parameters:
      - $ref: '#/components/parameters/Timeout'
      - $ref: '#/components/parameters/ContentLength'
      - $ref: '#/components/parameters/ContentMD5'
      - $ref: '#/components/parameters/ContentCrc64'
      - $ref: '#/components/parameters/LeaseIdOptional'
      - $ref: '#/components/parameters/BlobConditionMaxSize'
      - $ref: '#/components/parameters/BlobConditionAppendPos'
      - $ref: '#/components/parameters/EncryptionKey'
      - $ref: '#/components/parameters/EncryptionKeySha256'
      - $ref: '#/components/parameters/EncryptionAlgorithm'
      - $ref: '#/components/parameters/EncryptionScope'
      - $ref: '#/components/parameters/IfModifiedSince'
      - $ref: '#/components/parameters/IfUnmodifiedSince'
      - $ref: '#/components/parameters/IfMatch'
      - $ref: '#/components/parameters/IfNoneMatch'
      - $ref: '#/components/parameters/IfTags'
      - $ref: '#/components/parameters/ApiVersionParameter'
      - $ref: '#/components/parameters/ClientRequestId'
      - $ref: '#/components/parameters/StructuredBodyPut'
      - $ref: '#/components/parameters/StructuredContentLength'
      requestBody:
        $ref: '#/components/requestBodies/BlockBlob_UploadBody'
      responses:
        '201':
          description: The block was created.
          headers:
            ETag:
              description: The ETag contains a value that you can use to perform operations conditionally. If the request version is 2011-08-18 or newer, the ETag value will be in quotes.
              schema:
                type: string
            Last-Modified:
              description: Returns the date and time the container was last modified. Any operation that modifies the blob, including an update of the blob's metadata or properties, changes the last-modified time of the blob.
              schema:
                type: string
                format: date-time-rfc1123
            Content-MD5:
              description: If the blob has an MD5 hash and this operation is to read the full blob, this response header is returned so that the client can check for message content integrity.
              schema:
                type: string
                format: byte
            x-ms-content-crc64:
              description: This header is returned so that the client can check for message content integrity. The value of this header is computed by the Blob service; it is not necessarily the same value specified in the request headers.
              schema:
                type: string
                format: byte
            x-ms-client-request-id:
              x-ms-client-name: ClientRequestId
              description: If a client request id header is sent in the request, this header will be present in the response with the same value.
              schema:
                type: string
            x-ms-request-id:
              x-ms-client-name: RequestId
              description: This header uniquely identifies the request that was made and can be used for troubleshooting the request.
              schema:
                type: string
            x-ms-version:
              x-ms-client-name: Version
              description: Indicates the version of the Blob service used to execute the request. This header is returned for requests made against version 2009-09-19 and above.
              schema:
                type: string
            Date:
              description: UTC date/time value generated by the service that indicates the time at which the response was initiated
              schema:
                type: string
                format: date-time-rfc1123
            x-ms-blob-append-offset:
              x-ms-client-name: BlobAppendOffset
              description: This response header is returned only for append operations. It returns the offset at which the block was committed, in bytes.
              schema:
                type: string
            x-ms-blob-committed-block-count:
              x-ms-client-name: BlobCommittedBlockCount
              description: The number of committed blocks present in the blob. This header is returned only for append blobs.
              schema:
                type: integer
            x-ms-request-server-encrypted:
              x-ms-client-name: IsServerEncrypted
              description: The value of this header is set to true if the contents of the request are successfully encrypted using the specified algorithm, and false otherwise.
              schema:
                type: boolean
            x-ms-encryption-key-sha256:
              x-ms-client-name: EncryptionKeySha256
              description: The SHA-256 hash of the encryption key used to encrypt the block. This header is only returned when the block was encrypted with a customer-provided key.
              schema:
                type: string
            x-ms-encryption-scope:
              x-ms-client-name: EncryptionScope
              description: Returns the name of the encryption scope used to encrypt the blob contents and application metadata.  Note that the absence of this header implies use of the default account encryption scope.
              schema:
                type: string
            x-ms-structured-body:
              x-ms-client-name: StructuredBodyType
              description: Indicates the structured message body was accepted and mirrors back the message schema version and properties.
              schema:
                type: string
        default:
          description: Failure
          headers:
            x-ms-error-code:
              x-ms-client-name: ErrorCode
              schema:
                type: string
          content:
            application/xml:
              schema:
                $ref: '#/components/schemas/StorageError'
      summary: Append blob append block
      x-summary-source: derived
  /{containerName}/{blob}?comp=appendblock&fromUrl:
    parameters:
    - $ref: '#/components/parameters/ContainerName'
    - $ref: '#/components/parameters/Blob'
    - name: comp
      description: comp
      in: query
      required: true
      schema:
        type: string
        enum:
        - appendblock
    put:
      tags:
      - appendblob
      operationId: AppendBlob_AppendBlockFromUrl
      description: The Append Block operation commits a new block of data to the end of an existing append blob where the contents are read from a source url. The Append Block operation is permitted only if the blob was created with x-ms-blob-type set to AppendBlob. Append Block is supported only on version 2015-02-21 version or later.
      parameters:
      - $ref: '#/components/parameters/SourceUrl'
      - $ref: '#/components/parameters/SourceRange'
      - $ref: '#/components/parameters/SourceContentMD5'
      - $ref: '#/components/parameters/SourceContentCRC64'
      - $ref: '#/components/parameters/Timeout'
      - $ref: '#/components/parameters/ContentLength'
      - $ref: '#/components/parameters/ContentMD5'
      - $ref: '#/components/parameters/EncryptionKey'
      - $ref: '#/components/parameters/EncryptionKeySha256'
      - $ref: '#/components/parameters/EncryptionAlgorithm'
      - $ref: '#/components/parameters/EncryptionScope'
      - $ref: '#/components/parameters/LeaseIdOptional'
      - $ref: '#/components/parameters/BlobConditionMaxSize'
      - $ref: '#/components/parameters/BlobConditionAppendPos'
      - $ref: '#/components/parameters/IfModifiedSince'
      - $ref: '#/components/parameters/IfUnmodifiedSince'
      - $ref: '#/components/parameters/IfMatch'
      - $ref: '#/components/parameters/IfNoneMatch'
      - $ref: '#/components/parameters/IfTags'
      - $ref: '#/components/parameters/SourceIfModifiedSince'
      - $ref: '#/components/parameters/SourceIfUnmodifiedSince'
      - $ref: '#/components/parameters/SourceIfMatch'
      - $ref: '#/components/parameters/SourceIfNoneMatch'
      - $ref: '#/components/parameters/ApiVersionParameter'
      - $ref: '#/components/parameters/ClientRequestId'
      - $ref: '#/components/parameters/CopySourceAuthorization'
      - $ref: '#/components/parameters/FileRequestIntent'
      - $ref: '#/components/parameters/SourceEncryptionKey'
      - $ref: '#/components/parameters/SourceEncryptionKeySha256'
      - $ref: '#/components/parameters/SourceEncryptionAlgorithm'
      responses:
        '201':
          description: The block was created.
          headers:
            ETag:
              description: The ETag contains a value that you can use to perform operations conditionally. If the request version is 2011-08-18 or newer, the ETag value will be in quotes.
              schema:
                type: string
            Last-Modified:
              description: Returns the date and time the container was last modified. Any operation that modifies the blob, including an update of the blob's metadata or properties, changes the last-modified time of the blob.
              schema:
                type: string
                format: date-time-rfc1123
            Content-MD5:
              description: If the blob has an MD5 hash and this operation is to read the full blob, this response header is returned so that the client can check for message content integrity.
              schema:
                type: string
                format: byte
            x-ms-content-crc64:
              description: This header is returned so that the client can check for message content integrity. The value of this header is computed by the Blob service; it is not necessarily the same value specified in the request headers.
              schema:
                type: string
                format: byte
            x-ms-request-id:
              x-ms-client-name: RequestId
              description: This header uniquely identifies the request that was made and can be used for troubleshooting the request.
              schema:
                type: string
            x-ms-version:
              x-ms-client-name: Version
              description: Indicates the version of the Blob service used to execute the request. This header is returned for requests made against version 2009-09-19 and above.
              schema:
                type: string
            Date:
              description: UTC date/time value generated by the service that indicates the time at which the response was initiated
              schema:
                type: string
                format: date-time-rfc1123
            x-ms-blob-append-offset:
              x-ms-client-name: BlobAppendOffset
              description: This response header is returned only for append operations. It returns the offset at which the block was committed, in bytes.
              schema:
                type: string
            x-ms-blob-committed-block-count:
              x-ms-client-name: BlobCommittedBlockCount
              description: The number of committed blocks present in the blob. This header is returned only for append blobs.
              schema:
                type: integer
            x-ms-encryption-key-sha256:
              x-ms-client-name: EncryptionKeySha256
              description: The SHA-256 hash of the encryption key used to encrypt the block. This header is only returned when the block was encrypted with a customer-provided key.
              schema:
                type: string
            x-ms-encryption-scope:
              x-ms-client-name: EncryptionScope
              description: Returns the name of the encryption scope used to encrypt the blob contents and application metadata.  Note that the absence of this header implies use of the default account encryption scope.
              schema:
                type: string
            x-ms-request-server-encrypted:
              x-ms-client-name: IsServerEncrypted
              description: The value of this header is set to true if the contents of the request are successfully encrypted using the specified algorithm, and false otherwise.
              schema:
                type: boolean
        default:
          description: Failure
          headers:
            x-ms-error-code:
              x-ms-client-name: ErrorCode
              schema:
                type: string
            x-ms-copy-source-error-code:
              x-ms-client-name: CopySourceErrorCode
              schema:
                type: string
            x-ms-copy-source-status-code:
              x-ms-client-name: CopySourceStatusCode
              schema:
                type: integer
                format: int32
          content:
            application/xml:
              schema:
                $ref: '#/components/schemas/StorageError'
      summary: Append blob append block from url
      x-summary-source: derived
  /{containerName}/{blob}?comp=seal:
    parameters:
    - $ref: '#/components/parameters/ContainerName'
    - $ref: '#/components/parameters/Blob'
    - name: comp
      description: comp
      in: query
      required: true
      schema:
        type: string
        enum:
        - seal
    put:
      tags:
      - appendblob
      operationId: AppendBlob_Seal
      description: The Seal operation seals the Append Blob to make it read-only. Seal is supported only on version 2019-12-12 version or later.
      parameters:
      - $ref: '#/components/parameters/Timeout'
      - $ref: '#/components/parameters/ApiVersionParameter'
      - $ref: '#/components/parameters/ClientRequestId'
      - $ref: '#/components/parameters/LeaseIdOptional'
      - $ref: '#/components/parameters/IfModifiedSince'
      - $ref: '#/components/parameters/IfUnmodifiedSince'
      - $ref: '#/components/parameters/IfMatch'
      - $ref: '#/components/parameters/IfNoneMatch'
      - $ref: '#/components/parameters/BlobConditionAppendPos'
      responses:
        '200':
          description: The blob was sealed.
          headers:
            ETag:
              description: The ETag contains a value that you can use to perform operations conditionally. If the request version is 2011-08-18 or newer, the ETag value will be in quotes.
              schema:
                type: string
            Last-Modified:
              description: Returns the date and time the container was last modified. Any operation that modifies the blob, including an update of the blob's metadata or properties, changes the last-modified time of the blob.
              schema:
                type: string
                format: date-time-rfc1123
            x-ms-client-request-id:
              x-ms-client-name: ClientRequestId
              description: If a client request id header is sent in the request, this header will be present in the response with the same value.
              schema:
                type: string
            x-ms-request-id:
              x-ms-client-name: RequestId
              description: This header uniquely identifies the request that was made and can be used for troubleshooting the request.
              schema:
                type: string
            x-ms-version:
              x-ms-client-name: Version
              description: Indicates the version of the Blob service used to execute the request. This header is returned for requests made against version 2009-09-19 and above.
              schema:
                type: string
            Date:
              description: UTC date/time value generated by the service that indicates the time at which the response was initiated
              schema:
                type: string
                format: date-time-rfc1123
            x-ms-blob-sealed:
              x-ms-client-name: IsSealed
              description: If this blob has been sealed
              schema:
                type: boolean
        default:
          description: Failure
          headers:
            x-ms-error-code:
              x-ms-client-name: ErrorCode
              schema:
                type: string
          content:
            application/xml:
              schema:
                $ref: '#/components/schemas/StorageError'
      summary: Append blob seal
      x-summary-source: derived
components:
  parameters:
    EncryptionKeySha256:
      name: x-ms-encryption-key-sha256
      x-ms-client-name: encryptionKeySha256
      in: header
      required: false
      x-ms-parameter-location: method
      x-ms-parameter-grouping:
        name: cpk-info
      description: The SHA-256 hash of the provided encryption key. Must be provided if the x-ms-encryption-key header is provided.
      schema:
        type: string
    BlobConditionAppendPos:
      name: x-ms-blob-condition-appendpos
      x-ms-client-name: appendPosition
      in: header
      required: false
      x-ms-parameter-location: method
      x-ms-parameter-grouping:
        name: append-position-access-conditions
      description: Optional conditional header, used only for the Append Block operation. A number indicating the byte offset to compare. Append Block will succeed only if the append position is equal to this number. If it is not, the request will fail with the AppendPositionConditionNotMet error (HTTP status code 412 - Precondition Failed).
      schema:
        type: integer
        format: int64
    Blob:
      name: blob
      in: path
      required: true
      x-ms-parameter-location: method
      description: The blob name.
      schema:
        type: string
        minLength: 1
        maxLength: 1024
        pattern: ^[a-zA-Z0-9]+(?:/[a-zA-Z0-9]+)*(?:\.[a-zA-Z0-9]+){0,1}$
    SourceEncryptionKey:
      name: x-ms-source-encryption-key
      x-ms-client-name: sourceEncryptionKey
      in: header
      required: false
      x-ms-parameter-location: method
      x-ms-parameter-grouping:
        name: source-cpk-info
      description: Optional. Specifies the source encryption key to use to encrypt the source data provided in the request.
      schema:
        type: string
    SourceRange:
      name: x-ms-source-range
      x-ms-client-name: sourceRange
      in: header
      required: false
      x-ms-parameter-location: method
      description: Bytes of source data in the specified range.
      schema:
        type: string
    ClientRequestId:
      name: x-ms-client-request-id
      x-ms-client-name: requestId
      in: header
      required: false
      x-ms-parameter-location: method
      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.
      schema:
        type: string
    ContentCrc64:
      name: x-ms-content-crc64
      x-ms-client-name: transactionalContentCrc64
      in: header
      required: false
      x-ms-parameter-location: method
      description: Specify the transactional crc64 for the body, to be validated by the service.
      schema:
        type: string
        format: byte
    ContentMD5:
      name: Content-MD5
      x-ms-client-name: transactionalContentMD5
      in: header
      required: false
      x-ms-parameter-location: method
      description: Specify the transactional md5 for the body, to be validated by the service.
      schema:
        type: string
        format: byte
    SourceIfMatch:
      name: x-ms-source-if-match
      x-ms-client-name: sourceIfMatch
      in: header
      required: false
      x-ms-parameter-location: method
      x-ms-parameter-grouping:
        name: source-modified-access-conditions
      description: Specify an ETag value to operate only on blobs with a matching value.
      schema:
        type: string
    BlobConditionMaxSize:
      name: x-ms-blob-condition-maxsize
      x-ms-client-name: maxSize
      in: header
      required: false
      x-ms-parameter-location: method
      x-ms-parameter-grouping:
        name: append-position-access-conditions
      description: Optional conditional header. The max length in bytes permitted for the append blob. If the Append Block operation would cause the blob to exceed that limit or if the blob size is already greater than the value specified in this header, the request will fail with MaxBlobSizeConditionNotMet error (HTTP status code 412 - Precondition Failed).
      schema:
        type: integer
        format: int64
    SourceIfUnmodifiedSince:
      name: x-ms-source-if-unmodified-since
      x-ms-client-name: sourceIfUnmodifiedSince
      in: header
      required: false
      x-ms-parameter-location: method
      x-ms-parameter-grouping:
        name: source-modified-access-conditions
      description: Specify this header value to operate only on a blob if it has not been modified since the specified date/time.
      schema:
        type: string
        format: date-time-rfc1123
    IfNoneMatch:
      name: If-None-Match
      x-ms-client-name: ifNoneMatch
      in: header
      required: false
      x-ms-parameter-location: method
      x-ms-parameter-grouping:
        name: modified-access-conditions
      description: Specify an ETag value to operate only on blobs without a matching value.
      schema:
        type: string
    SourceEncryptionKeySha256:
      name: x-ms-source-encryption-key-sha256
      x-ms-client-name: sourceEncryptionKeySha256
      in: header
      required: false
      x-ms-parameter-location: method
      x-ms-parameter-grouping:
        name: source-cpk-info
      description: The SHA-256 hash of the provided source encryption key. Must be provided if the x-ms-source-encryption-key header is provided.
      schema:
        type: string
    ContentLength:
      name: Content-Length
      in: header
      required: true
      x-ms-parameter-location: method
      description: The length of the request.
      schema:
        type: integer
        format: int64
    StructuredContentLength:
      name: x-ms-structured-content-length
      x-ms-client-name: StructuredContentLength
      in: header
      required: false
      x-ms-parameter-location: method
      description: Required if the request body is a structured message. Specifies the length of the blob/file content inside the message body. Will always be smaller than Content-Length.
      schema:
        type: integer
        format: int64
    IfModifiedSince:
      name: If-Modified-Since
      x-ms-client-name: ifModifiedSince
      in: header
      required: false
      x-ms-parameter-location: method
      x-ms-parameter-grouping:
        name: modified-access-conditions
      description: Specify this header value to operate only on a blob if it has been modified since the specified date/time.
      schema:
        type: string
        format: date-time-rfc1123
    EncryptionKey:
      name: x-ms-encryption-key
      x-ms-client-name: encryptionKey
      in: header
      required: false
      x-ms-parameter-location: method
      x-ms-parameter-grouping:
        name: cpk-info
      description: Optional. Specifies the encryption key to use to encrypt the data provided in the request. If not specified, encryption is performed with the root account encryption key.  For more information, see Encryption at Rest for Azure Storage Services.
      schema:
        type: string
    FileRequestIntent:
      name: x-ms-file-request-intent
      x-ms-client-name: fileRequestIntent
      in: header
      description: Valid value is backup
      required: false
      x-ms-parameter-location: method
      x-ms-enum:
        name: FileShareTokenIntent
        modelAsString: true
      schema:
        type: string
        enum:
        - backup
    SourceEncryptionAlgorithm:
      name: x-ms-source-encryption-algorithm
      x-ms-client-name: sourceEncryptionAlgorithm
      in: header
      required: false
      x-ms-enum:
        name: EncryptionAlgorithmType
        modelAsString: false
      x-ms-parameter-location: method
      x-ms-parameter-grouping:
        name: source-cpk-info
      description: The algorithm used to produce the source encryption key hash. Currently, the only accepted value is "AES256". Must be provided if the x-ms-source-encryption-key is provided.
      schema:
        type: string
        enum:
        - AES256
    IfTags:
      name: x-ms-if-tags
      x-ms-client-name: ifTags
      in: header
      required: false
      x-ms-parameter-location: method
      x-ms-parameter-grouping:
        name: modified-access-conditions
      description: Specify a SQL where clause on blob tags to operate only on blobs with a matching value.
      schema:
        type: string
    EncryptionAlgorithm:
      name: x-ms-encryption-algorithm
      x-ms-client-name: encryptionAlgorithm
      in: header
      required: false
      x-ms-enum:
        name: EncryptionAlgorithmType
        modelAsString: false
      x-ms-parameter-location: method
      x-ms-parameter-grouping:
        name: cpk-info
      description: The algorithm used to produce the encryption key hash. Currently, the only accepted value is "AES256". Must be provided if the x-ms-encryption-key header is provided.
      schema:
        type: string
        enum:
        - AES256
    EncryptionScope:
      name: x-ms-encryption-scope
      x-ms-client-name: encryptionScope
      in: header
      required: false
      x-ms-parameter-location: method
      x-ms-parameter-grouping:
        name: cpk-scope-info
      description: Optional. Version 2019-07-07 and later.  Specifies the name of the encryption scope to use to encrypt the data provided in the request. If not specified, encryption is performed with the default account encryption scope.  For more information, see Encryption at Rest for Azure Storage Services.
      schema:
        type: string
    SourceContentMD5:
      name: x-ms-source-content-md5
      x-ms-client-name: sourceContentMD5
      in: header
      required: false
      x-ms-parameter-location: method
      description: Specify the md5 calculated for the range of bytes that must be read from the copy source.
      schema:
        type: string
        format: byte
    IfMatch:
      name: If-Match
      x-ms-client-name: ifMatch
      in: header
      required: false
      x-ms-parameter-location: method
      x-ms-parameter-grouping:
        name: modified-access-conditions
      description: Specify an ETag value to operate only on blobs with a matching value.
      schema:
        type: string
    CopySourceAuthorization:
      name: x-ms-copy-source-authorization
      x-ms-client-name: copySourceAuthorization
      in: header
      required: false
      x-ms-parameter-location: method
      description: Only Bearer type is supported. Credentials should be a valid OAuth access token to copy source.
      schema:
        type: string
    SourceIfNoneMatch:
      name: x-ms-source-if-none-match
      x-ms-client-name: sourceIfNoneMatch
      in: header
      required: false
      x-ms-parameter-location: method
      x-ms-parameter-grouping:
        name: source-modified-access-conditions
      description: Specify an ETag value to operate only on blobs without a matching value.
      schema:
        type: string
    IfUnmodifiedSince:
      name: If-Unmodified-Since
      x-ms-client-name: ifUnmodifiedSince
      in: header
      required: false
      x-ms-parameter-location: method
      x-ms-parameter-grouping:
        name: modified-access-conditions
      description: Specify this header value to operate only on a blob if it has not been modified since the specified date/time.
      schema:
        type: string
        format: date-time-rfc1123
    SourceIfModifiedSince:
      name: x-ms-source-if-modified-since
      x-ms-client-name: sourceIfModifiedSince
      in: header
      required: false
      x-ms-parameter-location: method
      x-ms-parameter-grouping:
        name: source-modified-access-conditions
      description: Specify this header value to operate only on a blob if it has been modified since the specified date/time.
      schema:
        type: string
        format: date-time-rfc1123
    SourceContentCRC64:
      name: x-ms-source-content-crc64
      x-ms-client-name: sourceContentcrc64
      in: header
      required: false
      x-ms-parameter-location: method
      description: Specify the crc64 calculated for the range of bytes that must be read from the copy source.
      schema:
        type: string
        format: byte
    SourceUrl:
      name: x-ms-copy-source
      x-ms-client-name: sourceUrl
      in: header
      required: true
      x-ms-parameter-location: method
      description: Specify a URL to the copy source.
      schema:
        type: string
    ContainerName:
      name: containerName
      in: path
      required: true
      x-ms-parameter-location: method
      description: The container name.
      schema:
        type: string
    Timeout:
      name: timeout
      in: query
      required: false
      x-ms-parameter-location: method
      description: The timeout parameter is expressed in seconds. For more information, see <a href="https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations">Setting Timeouts for Blob Service Operations.</a>
      schema:
        type: integer
        minimum: 0
    StructuredBodyPut:
      name: x-ms-structured-body
      x-ms-client-name: StructuredBodyType
      in: header
      required: false
      x-ms-parameter-location: method
      description: Required if the request body is a structured message. Specifies the message schema version and properties.
      schema:
        type: string
    LeaseIdOptional:
      name: x-ms-lease-id
      x-ms-client-name: leaseId
      in: header
      required: false
      x-ms-parameter-location: method
      x-ms-parameter-grouping:
        name: lease-access-conditions
      description: If specified, the operation only succeeds if the resource's lease is active and matches this ID.
      schema:
        type: string
    ApiVersionParameter:
      name: x-ms-version
      x-ms-parameter-location: client
      x-ms-client-name: version
      in: header
      required: true
      description: Specifies the version of the operation to use for this request.
      schema:
        type: string
  requestBodies:
    BlockBlob_UploadBody:
      content:
        application/octet-stream:
          schema:
            type: object
            format: file
      description: Initial data
      required: true
      x-ms-parameter-location: method
  schemas:
    StorageError:
      type: object
      properties:
        Message:
          type: string
        CopySourceStatusCode:
          type: integer
          format: int32
        CopySourceErrorCode:
          type: string
        CopySourceErrorMessage:
          type: string