Blame vendor/github.com/Azure/azure-storage-blob-go/azblob/url_page_blob.go

Packit Service 4d2de5
package azblob
Packit Service 4d2de5
Packit Service 4d2de5
import (
Packit Service 4d2de5
	"context"
Packit Service 4d2de5
	"fmt"
Packit Service 4d2de5
	"io"
Packit Service 4d2de5
	"net/url"
Packit Service 4d2de5
	"strconv"
Packit Service 4d2de5
Packit Service 4d2de5
	"github.com/Azure/azure-pipeline-go/pipeline"
Packit Service 4d2de5
)
Packit Service 4d2de5
Packit Service 4d2de5
const (
Packit Service 4d2de5
	// PageBlobPageBytes indicates the number of bytes in a page (512).
Packit Service 4d2de5
	PageBlobPageBytes = 512
Packit Service 4d2de5
Packit Service 4d2de5
	// PageBlobMaxPutPagesBytes indicates the maximum number of bytes that can be sent in a call to PutPage.
Packit Service 4d2de5
	PageBlobMaxUploadPagesBytes = 4 * 1024 * 1024 // 4MB
Packit Service 4d2de5
)
Packit Service 4d2de5
Packit Service 4d2de5
// PageBlobURL defines a set of operations applicable to page blobs.
Packit Service 4d2de5
type PageBlobURL struct {
Packit Service 4d2de5
	BlobURL
Packit Service 4d2de5
	pbClient pageBlobClient
Packit Service 4d2de5
}
Packit Service 4d2de5
Packit Service 4d2de5
// NewPageBlobURL creates a PageBlobURL object using the specified URL and request policy pipeline.
Packit Service 4d2de5
func NewPageBlobURL(url url.URL, p pipeline.Pipeline) PageBlobURL {
Packit Service 4d2de5
	blobClient := newBlobClient(url, p)
Packit Service 4d2de5
	pbClient := newPageBlobClient(url, p)
Packit Service 4d2de5
	return PageBlobURL{BlobURL: BlobURL{blobClient: blobClient}, pbClient: pbClient}
Packit Service 4d2de5
}
Packit Service 4d2de5
Packit Service 4d2de5
// WithPipeline creates a new PageBlobURL object identical to the source but with the specific request policy pipeline.
Packit Service 4d2de5
func (pb PageBlobURL) WithPipeline(p pipeline.Pipeline) PageBlobURL {
Packit Service 4d2de5
	return NewPageBlobURL(pb.blobClient.URL(), p)
Packit Service 4d2de5
}
Packit Service 4d2de5
Packit Service 4d2de5
// WithSnapshot creates a new PageBlobURL object identical to the source but with the specified snapshot timestamp.
Packit Service 4d2de5
// Pass "" to remove the snapshot returning a URL to the base blob.
Packit Service 4d2de5
func (pb PageBlobURL) WithSnapshot(snapshot string) PageBlobURL {
Packit Service 4d2de5
	p := NewBlobURLParts(pb.URL())
Packit Service 4d2de5
	p.Snapshot = snapshot
Packit Service 4d2de5
	return NewPageBlobURL(p.URL(), pb.blobClient.Pipeline())
Packit Service 4d2de5
}
Packit Service 4d2de5
Packit Service 4d2de5
// Create creates a page blob of the specified length. Call PutPage to upload data data to a page blob.
Packit Service 4d2de5
// For more information, see https://docs.microsoft.com/rest/api/storageservices/put-blob.
Packit Service 4d2de5
func (pb PageBlobURL) Create(ctx context.Context, size int64, sequenceNumber int64, h BlobHTTPHeaders, metadata Metadata, ac BlobAccessConditions) (*PageBlobCreateResponse, error) {
Packit Service 4d2de5
	ifModifiedSince, ifUnmodifiedSince, ifMatchETag, ifNoneMatchETag := ac.ModifiedAccessConditions.pointers()
Packit Service 4d2de5
	return pb.pbClient.Create(ctx, 0, size, nil,
Packit Service 4d2de5
		&h.ContentType, &h.ContentEncoding, &h.ContentLanguage, h.ContentMD5, &h.CacheControl,
Packit Service 4d2de5
		metadata, ac.LeaseAccessConditions.pointers(),
Packit Service 4d2de5
		&h.ContentDisposition, ifModifiedSince, ifUnmodifiedSince, ifMatchETag, ifNoneMatchETag, &sequenceNumber, nil)
Packit Service 4d2de5
}
Packit Service 4d2de5
Packit Service 4d2de5
// UploadPages writes 1 or more pages to the page blob. The start offset and the stream size must be a multiple of 512 bytes.
Packit Service 4d2de5
// This method panics if the stream is not at position 0.
Packit Service 4d2de5
// Note that the http client closes the body stream after the request is sent to the service.
Packit Service 4d2de5
// For more information, see https://docs.microsoft.com/rest/api/storageservices/put-page.
Packit Service 4d2de5
func (pb PageBlobURL) UploadPages(ctx context.Context, offset int64, body io.ReadSeeker, ac PageBlobAccessConditions, transactionalMD5 []byte) (*PageBlobUploadPagesResponse, error) {
Packit Service 4d2de5
	count, err := validateSeekableStreamAt0AndGetCount(body)
Packit Service 4d2de5
	if err != nil {
Packit Service 4d2de5
		return nil, err
Packit Service 4d2de5
	}
Packit Service 4d2de5
	ifModifiedSince, ifUnmodifiedSince, ifMatchETag, ifNoneMatchETag := ac.ModifiedAccessConditions.pointers()
Packit Service 4d2de5
	ifSequenceNumberLessThanOrEqual, ifSequenceNumberLessThan, ifSequenceNumberEqual := ac.SequenceNumberAccessConditions.pointers()
Packit Service 4d2de5
	return pb.pbClient.UploadPages(ctx, body, count, transactionalMD5, nil,
Packit Service 4d2de5
		PageRange{Start: offset, End: offset + count - 1}.pointers(),
Packit Service 4d2de5
		ac.LeaseAccessConditions.pointers(),
Packit Service 4d2de5
		ifSequenceNumberLessThanOrEqual, ifSequenceNumberLessThan, ifSequenceNumberEqual,
Packit Service 4d2de5
		ifModifiedSince, ifUnmodifiedSince, ifMatchETag, ifNoneMatchETag, nil)
Packit Service 4d2de5
}
Packit Service 4d2de5
Packit Service 4d2de5
// UploadPagesFromURL copies 1 or more pages from a source URL to the page blob.
Packit Service 4d2de5
// The sourceOffset specifies the start offset of source data to copy from.
Packit Service 4d2de5
// The destOffset specifies the start offset of data in page blob will be written to.
Packit Service 4d2de5
// The count must be a multiple of 512 bytes.
Packit Service 4d2de5
// For more information, see https://docs.microsoft.com/rest/api/storageservices/put-page-from-url.
Packit Service 4d2de5
func (pb PageBlobURL) UploadPagesFromURL(ctx context.Context, sourceURL url.URL, sourceOffset int64, destOffset int64, count int64, transactionalMD5 []byte, destinationAccessConditions PageBlobAccessConditions, sourceAccessConditions ModifiedAccessConditions) (*PageBlobUploadPagesFromURLResponse, error) {
Packit Service 4d2de5
	ifModifiedSince, ifUnmodifiedSince, ifMatchETag, ifNoneMatchETag := destinationAccessConditions.ModifiedAccessConditions.pointers()
Packit Service 4d2de5
	sourceIfModifiedSince, sourceIfUnmodifiedSince, sourceIfMatchETag, sourceIfNoneMatchETag := sourceAccessConditions.pointers()
Packit Service 4d2de5
	ifSequenceNumberLessThanOrEqual, ifSequenceNumberLessThan, ifSequenceNumberEqual := destinationAccessConditions.SequenceNumberAccessConditions.pointers()
Packit Service 4d2de5
	return pb.pbClient.UploadPagesFromURL(ctx, sourceURL.String(), *PageRange{Start: sourceOffset, End: sourceOffset + count - 1}.pointers(), 0,
Packit Service 4d2de5
		*PageRange{Start: destOffset, End: destOffset + count - 1}.pointers(), transactionalMD5, nil, destinationAccessConditions.LeaseAccessConditions.pointers(),
Packit Service 4d2de5
		ifSequenceNumberLessThanOrEqual, ifSequenceNumberLessThan, ifSequenceNumberEqual,
Packit Service 4d2de5
		ifModifiedSince, ifUnmodifiedSince, ifMatchETag, ifNoneMatchETag, sourceIfModifiedSince, sourceIfUnmodifiedSince, sourceIfMatchETag, sourceIfNoneMatchETag, nil)
Packit Service 4d2de5
}
Packit Service 4d2de5
Packit Service 4d2de5
// ClearPages frees the specified pages from the page blob.
Packit Service 4d2de5
// For more information, see https://docs.microsoft.com/rest/api/storageservices/put-page.
Packit Service 4d2de5
func (pb PageBlobURL) ClearPages(ctx context.Context, offset int64, count int64, ac PageBlobAccessConditions) (*PageBlobClearPagesResponse, error) {
Packit Service 4d2de5
	ifModifiedSince, ifUnmodifiedSince, ifMatchETag, ifNoneMatchETag := ac.ModifiedAccessConditions.pointers()
Packit Service 4d2de5
	ifSequenceNumberLessThanOrEqual, ifSequenceNumberLessThan, ifSequenceNumberEqual := ac.SequenceNumberAccessConditions.pointers()
Packit Service 4d2de5
	return pb.pbClient.ClearPages(ctx, 0, nil,
Packit Service 4d2de5
		PageRange{Start: offset, End: offset + count - 1}.pointers(),
Packit Service 4d2de5
		ac.LeaseAccessConditions.pointers(),
Packit Service 4d2de5
		ifSequenceNumberLessThanOrEqual, ifSequenceNumberLessThan,
Packit Service 4d2de5
		ifSequenceNumberEqual, ifModifiedSince, ifUnmodifiedSince, ifMatchETag, ifNoneMatchETag, nil)
Packit Service 4d2de5
}
Packit Service 4d2de5
Packit Service 4d2de5
// GetPageRanges returns the list of valid page ranges for a page blob or snapshot of a page blob.
Packit Service 4d2de5
// For more information, see https://docs.microsoft.com/rest/api/storageservices/get-page-ranges.
Packit Service 4d2de5
func (pb PageBlobURL) GetPageRanges(ctx context.Context, offset int64, count int64, ac BlobAccessConditions) (*PageList, error) {
Packit Service 4d2de5
	ifModifiedSince, ifUnmodifiedSince, ifMatchETag, ifNoneMatchETag := ac.ModifiedAccessConditions.pointers()
Packit Service 4d2de5
	return pb.pbClient.GetPageRanges(ctx, nil, nil,
Packit Service 4d2de5
		httpRange{offset: offset, count: count}.pointers(),
Packit Service 4d2de5
		ac.LeaseAccessConditions.pointers(),
Packit Service 4d2de5
		ifModifiedSince, ifUnmodifiedSince, ifMatchETag, ifNoneMatchETag, nil)
Packit Service 4d2de5
}
Packit Service 4d2de5
Packit Service 4d2de5
// GetPageRangesDiff gets the collection of page ranges that differ between a specified snapshot and this page blob.
Packit Service 4d2de5
// For more information, see https://docs.microsoft.com/rest/api/storageservices/get-page-ranges.
Packit Service 4d2de5
func (pb PageBlobURL) GetPageRangesDiff(ctx context.Context, offset int64, count int64, prevSnapshot string, ac BlobAccessConditions) (*PageList, error) {
Packit Service 4d2de5
	ifModifiedSince, ifUnmodifiedSince, ifMatchETag, ifNoneMatchETag := ac.ModifiedAccessConditions.pointers()
Packit Service 4d2de5
	return pb.pbClient.GetPageRangesDiff(ctx, nil, nil, &prevSnapshot,
Packit Service 4d2de5
		httpRange{offset: offset, count: count}.pointers(),
Packit Service 4d2de5
		ac.LeaseAccessConditions.pointers(),
Packit Service 4d2de5
		ifModifiedSince, ifUnmodifiedSince, ifMatchETag, ifNoneMatchETag,
Packit Service 4d2de5
		nil)
Packit Service 4d2de5
}
Packit Service 4d2de5
Packit Service 4d2de5
// Resize resizes the page blob to the specified size (which must be a multiple of 512).
Packit Service 4d2de5
// For more information, see https://docs.microsoft.com/rest/api/storageservices/set-blob-properties.
Packit Service 4d2de5
func (pb PageBlobURL) Resize(ctx context.Context, size int64, ac BlobAccessConditions) (*PageBlobResizeResponse, error) {
Packit Service 4d2de5
	ifModifiedSince, ifUnmodifiedSince, ifMatchETag, ifNoneMatchETag := ac.ModifiedAccessConditions.pointers()
Packit Service 4d2de5
	return pb.pbClient.Resize(ctx, size, nil, ac.LeaseAccessConditions.pointers(),
Packit Service 4d2de5
		ifModifiedSince, ifUnmodifiedSince, ifMatchETag, ifNoneMatchETag, nil)
Packit Service 4d2de5
}
Packit Service 4d2de5
Packit Service 4d2de5
// SetSequenceNumber sets the page blob's sequence number.
Packit Service 4d2de5
func (pb PageBlobURL) UpdateSequenceNumber(ctx context.Context, action SequenceNumberActionType, sequenceNumber int64,
Packit Service 4d2de5
	ac BlobAccessConditions) (*PageBlobUpdateSequenceNumberResponse, error) {
Packit Service 4d2de5
	sn := &sequenceNumber
Packit Service 4d2de5
	if action == SequenceNumberActionIncrement {
Packit Service 4d2de5
		sn = nil
Packit Service 4d2de5
	}
Packit Service 4d2de5
	ifModifiedSince, ifUnmodifiedSince, ifMatch, ifNoneMatch := ac.ModifiedAccessConditions.pointers()
Packit Service 4d2de5
	return pb.pbClient.UpdateSequenceNumber(ctx, action, nil,
Packit Service 4d2de5
		ac.LeaseAccessConditions.pointers(), ifModifiedSince, ifUnmodifiedSince, ifMatch, ifNoneMatch,
Packit Service 4d2de5
		sn, nil)
Packit Service 4d2de5
}
Packit Service 4d2de5
Packit Service 4d2de5
// StartIncrementalCopy begins an operation to start an incremental copy from one page blob's snapshot to this page blob.
Packit Service 4d2de5
// The snapshot is copied such that only the differential changes between the previously copied snapshot are transferred to the destination.
Packit Service 4d2de5
// The copied snapshots are complete copies of the original snapshot and can be read or copied from as usual.
Packit Service 4d2de5
// For more information, see https://docs.microsoft.com/rest/api/storageservices/incremental-copy-blob and
Packit Service 4d2de5
// https://docs.microsoft.com/en-us/azure/virtual-machines/windows/incremental-snapshots.
Packit Service 4d2de5
func (pb PageBlobURL) StartCopyIncremental(ctx context.Context, source url.URL, snapshot string, ac BlobAccessConditions) (*PageBlobCopyIncrementalResponse, error) {
Packit Service 4d2de5
	ifModifiedSince, ifUnmodifiedSince, ifMatchETag, ifNoneMatchETag := ac.ModifiedAccessConditions.pointers()
Packit Service 4d2de5
	qp := source.Query()
Packit Service 4d2de5
	qp.Set("snapshot", snapshot)
Packit Service 4d2de5
	source.RawQuery = qp.Encode()
Packit Service 4d2de5
	return pb.pbClient.CopyIncremental(ctx, source.String(), nil,
Packit Service 4d2de5
		ifModifiedSince, ifUnmodifiedSince, ifMatchETag, ifNoneMatchETag, nil)
Packit Service 4d2de5
}
Packit Service 4d2de5
Packit Service 4d2de5
func (pr PageRange) pointers() *string {
Packit Service 4d2de5
	endOffset := strconv.FormatInt(int64(pr.End), 10)
Packit Service 4d2de5
	asString := fmt.Sprintf("bytes=%v-%s", pr.Start, endOffset)
Packit Service 4d2de5
	return &asString
Packit Service 4d2de5
}
Packit Service 4d2de5
Packit Service 4d2de5
type PageBlobAccessConditions struct {
Packit Service 4d2de5
	ModifiedAccessConditions
Packit Service 4d2de5
	LeaseAccessConditions
Packit Service 4d2de5
	SequenceNumberAccessConditions
Packit Service 4d2de5
}
Packit Service 4d2de5
Packit Service 4d2de5
// SequenceNumberAccessConditions identifies page blob-specific access conditions which you optionally set.
Packit Service 4d2de5
type SequenceNumberAccessConditions struct {
Packit Service 4d2de5
	// IfSequenceNumberLessThan ensures that the page blob operation succeeds
Packit Service 4d2de5
	// only if the blob's sequence number is less than a value.
Packit Service 4d2de5
	// IfSequenceNumberLessThan=0 means no 'IfSequenceNumberLessThan' header specified.
Packit Service 4d2de5
	// IfSequenceNumberLessThan>0 means 'IfSequenceNumberLessThan' header specified with its value
Packit Service 4d2de5
	// IfSequenceNumberLessThan==-1 means 'IfSequenceNumberLessThan' header specified with a value of 0
Packit Service 4d2de5
	IfSequenceNumberLessThan int64
Packit Service 4d2de5
Packit Service 4d2de5
	// IfSequenceNumberLessThanOrEqual ensures that the page blob operation succeeds
Packit Service 4d2de5
	// only if the blob's sequence number is less than or equal to a value.
Packit Service 4d2de5
	// IfSequenceNumberLessThanOrEqual=0 means no 'IfSequenceNumberLessThanOrEqual' header specified.
Packit Service 4d2de5
	// IfSequenceNumberLessThanOrEqual>0 means 'IfSequenceNumberLessThanOrEqual' header specified with its value
Packit Service 4d2de5
	// IfSequenceNumberLessThanOrEqual=-1 means 'IfSequenceNumberLessThanOrEqual' header specified with a value of 0
Packit Service 4d2de5
	IfSequenceNumberLessThanOrEqual int64
Packit Service 4d2de5
Packit Service 4d2de5
	// IfSequenceNumberEqual ensures that the page blob operation succeeds
Packit Service 4d2de5
	// only if the blob's sequence number is equal to a value.
Packit Service 4d2de5
	// IfSequenceNumberEqual=0 means no 'IfSequenceNumberEqual' header specified.
Packit Service 4d2de5
	// IfSequenceNumberEqual>0 means 'IfSequenceNumberEqual' header specified with its value
Packit Service 4d2de5
	// IfSequenceNumberEqual=-1 means 'IfSequenceNumberEqual' header specified with a value of 0
Packit Service 4d2de5
	IfSequenceNumberEqual int64
Packit Service 4d2de5
}
Packit Service 4d2de5
Packit Service 4d2de5
// pointers is for internal infrastructure. It returns the fields as pointers.
Packit Service 4d2de5
func (ac SequenceNumberAccessConditions) pointers() (snltoe *int64, snlt *int64, sne *int64) {
Packit Service 4d2de5
	var zero int64 // Defaults to 0
Packit Service 4d2de5
	switch ac.IfSequenceNumberLessThan {
Packit Service 4d2de5
	case -1:
Packit Service 4d2de5
		snlt = &zero
Packit Service 4d2de5
	case 0:
Packit Service 4d2de5
		snlt = nil
Packit Service 4d2de5
	default:
Packit Service 4d2de5
		snlt = &ac.IfSequenceNumberLessThan
Packit Service 4d2de5
	}
Packit Service 4d2de5
Packit Service 4d2de5
	switch ac.IfSequenceNumberLessThanOrEqual {
Packit Service 4d2de5
	case -1:
Packit Service 4d2de5
		snltoe = &zero
Packit Service 4d2de5
	case 0:
Packit Service 4d2de5
		snltoe = nil
Packit Service 4d2de5
	default:
Packit Service 4d2de5
		snltoe = &ac.IfSequenceNumberLessThanOrEqual
Packit Service 4d2de5
	}
Packit Service 4d2de5
	switch ac.IfSequenceNumberEqual {
Packit Service 4d2de5
	case -1:
Packit Service 4d2de5
		sne = &zero
Packit Service 4d2de5
	case 0:
Packit Service 4d2de5
		sne = nil
Packit Service 4d2de5
	default:
Packit Service 4d2de5
		sne = &ac.IfSequenceNumberEqual
Packit Service 4d2de5
	}
Packit Service 4d2de5
	return
Packit Service 4d2de5
}