azure-storage 0.13.0.preview → 0.14.0.preview
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/lib/azure/storage.rb +14 -13
- data/lib/azure/storage/autoload.rb +31 -31
- data/lib/azure/storage/blob/append.rb +43 -41
- data/lib/azure/storage/blob/blob.rb +150 -147
- data/lib/azure/storage/blob/blob_service.rb +186 -184
- data/lib/azure/storage/blob/block.rb +56 -56
- data/lib/azure/storage/blob/container.rb +93 -92
- data/lib/azure/storage/blob/page.rb +187 -104
- data/lib/azure/storage/blob/serialization.rb +32 -18
- data/lib/azure/storage/client.rb +18 -17
- data/lib/azure/storage/client_options.rb +192 -193
- data/lib/azure/storage/client_options_error.rb +5 -5
- data/lib/azure/storage/configurable.rb +39 -39
- data/lib/azure/storage/core.rb +6 -4
- data/lib/azure/storage/core/auth/shared_access_signature.rb +5 -3
- data/lib/azure/storage/core/auth/shared_access_signature_generator.rb +34 -33
- data/lib/azure/storage/core/auth/shared_access_signature_signer.rb +5 -5
- data/lib/azure/storage/core/auth/shared_key.rb +17 -15
- data/lib/azure/storage/core/autoload.rb +15 -13
- data/lib/azure/storage/core/error.rb +3 -1
- data/lib/azure/storage/core/filter/exponential_retry_filter.rb +13 -11
- data/lib/azure/storage/core/filter/linear_retry_filter.rb +10 -8
- data/lib/azure/storage/core/filter/retry_filter.rb +30 -29
- data/lib/azure/storage/core/http_client.rb +18 -16
- data/lib/azure/storage/core/sr.rb +50 -48
- data/lib/azure/storage/core/utility.rb +19 -17
- data/lib/azure/storage/default.rb +371 -361
- data/lib/azure/storage/file/directory.rb +36 -31
- data/lib/azure/storage/file/file.rb +103 -100
- data/lib/azure/storage/file/file_service.rb +42 -40
- data/lib/azure/storage/file/serialization.rb +9 -6
- data/lib/azure/storage/file/share.rb +48 -46
- data/lib/azure/storage/queue/message.rb +3 -1
- data/lib/azure/storage/queue/queue.rb +3 -2
- data/lib/azure/storage/queue/queue_service.rb +152 -151
- data/lib/azure/storage/queue/serialization.rb +7 -5
- data/lib/azure/storage/service/access_policy.rb +3 -1
- data/lib/azure/storage/service/cors.rb +4 -2
- data/lib/azure/storage/service/cors_rule.rb +3 -1
- data/lib/azure/storage/service/enumeration_results.rb +3 -1
- data/lib/azure/storage/service/logging.rb +5 -3
- data/lib/azure/storage/service/metrics.rb +5 -3
- data/lib/azure/storage/service/retention_policy.rb +3 -1
- data/lib/azure/storage/service/serialization.rb +31 -30
- data/lib/azure/storage/service/signed_identifier.rb +5 -4
- data/lib/azure/storage/service/storage_service.rb +33 -32
- data/lib/azure/storage/service/storage_service_properties.rb +6 -4
- data/lib/azure/storage/table/auth/shared_key.rb +9 -8
- data/lib/azure/storage/table/batch.rb +55 -55
- data/lib/azure/storage/table/batch_response.rb +17 -17
- data/lib/azure/storage/table/edmtype.rb +9 -7
- data/lib/azure/storage/table/entity.rb +4 -3
- data/lib/azure/storage/table/guid.rb +3 -1
- data/lib/azure/storage/table/query.rb +17 -19
- data/lib/azure/storage/table/serialization.rb +14 -12
- data/lib/azure/storage/table/table_service.rb +79 -80
- data/lib/azure/storage/version.rb +7 -5
- metadata +2 -2
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA1:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: 9d928e46742461de06b7ea74aba3adfd35076eb6
|
|
4
|
+
data.tar.gz: 7c60c44b62b9a09f9bf9ff2f113a16182619e335
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 5cf469aea716d07951b603167cce71a3bf51dfd5142d5431998c68e047bd1b651a7bb6c5b22c5de6ac57b1e0a7c41cafbf2fa823a1043685a02222e30c3b8bf7
|
|
7
|
+
data.tar.gz: 7d529320af4adc9026c9714f8a4f7276524b77c98909046d75753c986ce8054b24e91b0ff8892a01ebe669321728d684e0bbc4e285bd6cd0cd8520d83b61f3bf
|
data/lib/azure/storage.rb
CHANGED
|
@@ -1,3 +1,5 @@
|
|
|
1
|
+
# frozen_string_literal: true
|
|
2
|
+
|
|
1
3
|
#-------------------------------------------------------------------------
|
|
2
4
|
# # Copyright (c) Microsoft and contributors. All rights reserved.
|
|
3
5
|
#
|
|
@@ -22,22 +24,22 @@
|
|
|
22
24
|
# THE SOFTWARE.
|
|
23
25
|
#--------------------------------------------------------------------------
|
|
24
26
|
|
|
25
|
-
require
|
|
26
|
-
require
|
|
27
|
-
require
|
|
28
|
-
require
|
|
29
|
-
require
|
|
30
|
-
require
|
|
31
|
-
require
|
|
27
|
+
require "rubygems"
|
|
28
|
+
require "nokogiri"
|
|
29
|
+
require "base64"
|
|
30
|
+
require "openssl"
|
|
31
|
+
require "uri"
|
|
32
|
+
require "faraday"
|
|
33
|
+
require "faraday_middleware"
|
|
32
34
|
|
|
33
|
-
require
|
|
35
|
+
require "azure/storage/autoload"
|
|
34
36
|
|
|
35
37
|
module Azure
|
|
36
38
|
module Storage
|
|
37
39
|
class << self
|
|
38
40
|
include Azure::Storage::Configurable
|
|
39
41
|
|
|
40
|
-
def client(options={})
|
|
42
|
+
def client(options = {})
|
|
41
43
|
@client = Azure::Storage::Client.new(options) unless defined?(@client) && @client.same_options?(options)
|
|
42
44
|
@client
|
|
43
45
|
end
|
|
@@ -45,10 +47,9 @@ module Azure
|
|
|
45
47
|
private
|
|
46
48
|
|
|
47
49
|
def method_missing(method_name, *args, &block)
|
|
48
|
-
return
|
|
49
|
-
|
|
50
|
+
return client.send(method_name, *args, &block) if Azure::Storage::Client.method_defined?(method_name)
|
|
51
|
+
super
|
|
50
52
|
end
|
|
51
|
-
|
|
52
53
|
end
|
|
53
54
|
end
|
|
54
|
-
end
|
|
55
|
+
end
|
|
@@ -1,3 +1,5 @@
|
|
|
1
|
+
# frozen_string_literal: true
|
|
2
|
+
|
|
1
3
|
#-------------------------------------------------------------------------
|
|
2
4
|
# # Copyright (c) Microsoft and contributors. All rights reserved.
|
|
3
5
|
#
|
|
@@ -22,56 +24,54 @@
|
|
|
22
24
|
# THE SOFTWARE.
|
|
23
25
|
#--------------------------------------------------------------------------
|
|
24
26
|
|
|
25
|
-
require
|
|
27
|
+
require "azure/storage/core/autoload"
|
|
26
28
|
|
|
27
29
|
module Azure
|
|
28
|
-
|
|
29
|
-
autoload :Storage, 'azure/storage/core'
|
|
30
|
+
autoload :Storage, "azure/storage/core"
|
|
30
31
|
|
|
31
32
|
module Storage
|
|
32
|
-
autoload :Default,
|
|
33
|
-
autoload :Configurable,
|
|
34
|
-
autoload :Client,
|
|
35
|
-
autoload :ClientOptions,
|
|
36
|
-
|
|
33
|
+
autoload :Default, "azure/storage/default"
|
|
34
|
+
autoload :Configurable, "azure/storage/configurable"
|
|
35
|
+
autoload :Client, "azure/storage/client"
|
|
36
|
+
autoload :ClientOptions, "azure/storage/client_options"
|
|
37
|
+
|
|
37
38
|
module Auth
|
|
38
|
-
autoload :SharedAccessSignature,
|
|
39
|
+
autoload :SharedAccessSignature, "azure/storage/core/auth/shared_access_signature"
|
|
39
40
|
end
|
|
40
41
|
|
|
41
42
|
module Service
|
|
42
|
-
autoload :Serialization,
|
|
43
|
-
autoload :StorageService,
|
|
43
|
+
autoload :Serialization, "azure/storage/service/serialization"
|
|
44
|
+
autoload :StorageService, "azure/storage/service/storage_service"
|
|
44
45
|
end
|
|
45
46
|
|
|
46
47
|
module Blob
|
|
47
|
-
autoload :Blob,
|
|
48
|
-
autoload :Block,
|
|
49
|
-
autoload :Page,
|
|
50
|
-
autoload :Append,
|
|
51
|
-
autoload :Container,
|
|
52
|
-
autoload :Serialization,
|
|
53
|
-
autoload :BlobService,
|
|
48
|
+
autoload :Blob, "azure/storage/blob/blob"
|
|
49
|
+
autoload :Block, "azure/storage/blob/block"
|
|
50
|
+
autoload :Page, "azure/storage/blob/page"
|
|
51
|
+
autoload :Append, "azure/storage/blob/append"
|
|
52
|
+
autoload :Container, "azure/storage/blob/container"
|
|
53
|
+
autoload :Serialization, "azure/storage/blob/serialization"
|
|
54
|
+
autoload :BlobService, "azure/storage/blob/blob_service"
|
|
54
55
|
end
|
|
55
56
|
|
|
56
57
|
module Queue
|
|
57
|
-
autoload :QueueService,
|
|
58
|
-
autoload :Message,
|
|
59
|
-
autoload :Queue,
|
|
58
|
+
autoload :QueueService, "azure/storage/queue/queue_service"
|
|
59
|
+
autoload :Message, "azure/storage/queue/message"
|
|
60
|
+
autoload :Queue, "azure/storage/queue/queue"
|
|
60
61
|
end
|
|
61
62
|
|
|
62
63
|
module Table
|
|
63
|
-
autoload :TableService,
|
|
64
|
-
autoload :Batch,
|
|
65
|
-
autoload :Query,
|
|
64
|
+
autoload :TableService, "azure/storage/table/table_service"
|
|
65
|
+
autoload :Batch, "azure/storage/table/batch"
|
|
66
|
+
autoload :Query, "azure/storage/table/query"
|
|
66
67
|
end
|
|
67
68
|
|
|
68
69
|
module File
|
|
69
|
-
autoload :FileService,
|
|
70
|
-
autoload :Share,
|
|
71
|
-
autoload :Directory,
|
|
72
|
-
autoload :File,
|
|
73
|
-
autoload :Serialization,
|
|
70
|
+
autoload :FileService, "azure/storage/file/file_service"
|
|
71
|
+
autoload :Share, "azure/storage/file/share"
|
|
72
|
+
autoload :Directory, "azure/storage/file/directory"
|
|
73
|
+
autoload :File, "azure/storage/file/file"
|
|
74
|
+
autoload :Serialization, "azure/storage/file/serialization"
|
|
74
75
|
end
|
|
75
|
-
|
|
76
76
|
end
|
|
77
|
-
end
|
|
77
|
+
end
|
|
@@ -1,3 +1,5 @@
|
|
|
1
|
+
# frozen_string_literal: true
|
|
2
|
+
|
|
1
3
|
#-------------------------------------------------------------------------
|
|
2
4
|
# # Copyright (c) Microsoft and contributors. All rights reserved.
|
|
3
5
|
#
|
|
@@ -35,58 +37,58 @@ module Azure::Storage
|
|
|
35
37
|
# ==== Options
|
|
36
38
|
#
|
|
37
39
|
# Accepted key/value pairs in options parameter are:
|
|
38
|
-
# * +:transactional_md5+ - String. An MD5 hash of the blob content. This hash is used to verify the integrity of the blob during transport.
|
|
39
|
-
# When this header is specified, the storage service checks the hash that has arrived with the one that was sent.
|
|
40
|
+
# * +:transactional_md5+ - String. An MD5 hash of the blob content. This hash is used to verify the integrity of the blob during transport.
|
|
41
|
+
# When this header is specified, the storage service checks the hash that has arrived with the one that was sent.
|
|
40
42
|
# If the two hashes do not match, the operation will fail with error code 400 (Bad Request).
|
|
41
43
|
# * +:content_type+ - String. Content type for the blob. Will be saved with blob.
|
|
42
44
|
# * +:content_encoding+ - String. Content encoding for the blob. Will be saved with blob.
|
|
43
45
|
# * +:content_language+ - String. Content language for the blob. Will be saved with blob.
|
|
44
46
|
# * +:content_md5+ - String. Content MD5 for the blob. Will be saved with blob.
|
|
45
47
|
# * +:cache_control+ - String. Cache control for the blob. Will be saved with blob.
|
|
46
|
-
# * +:content_disposition+ - String. Conveys additional information about how to process the response payload,
|
|
48
|
+
# * +:content_disposition+ - String. Conveys additional information about how to process the response payload,
|
|
47
49
|
# and also can be used to attach additional metadata
|
|
48
50
|
# * +:metadata+ - Hash. Custom metadata values to store with the blob.
|
|
49
51
|
# * +:timeout+ - Integer. A timeout in seconds.
|
|
50
|
-
# * +:request_id+ - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded
|
|
52
|
+
# * +:request_id+ - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded
|
|
51
53
|
# in the analytics logs when storage analytics logging is enabled.
|
|
52
|
-
# * +:if_modified_since+ - String. A DateTime value. Specify this conditional header to create a new blob
|
|
53
|
-
# only if the blob has been modified since the specified date/time. If the blob has not been modified,
|
|
54
|
+
# * +:if_modified_since+ - String. A DateTime value. Specify this conditional header to create a new blob
|
|
55
|
+
# only if the blob has been modified since the specified date/time. If the blob has not been modified,
|
|
54
56
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
55
|
-
# * +:if_unmodified_since+ - String. A DateTime value. Specify this conditional header to create a new blob
|
|
56
|
-
# only if the blob has not been modified since the specified date/time. If the blob has been modified,
|
|
57
|
+
# * +:if_unmodified_since+ - String. A DateTime value. Specify this conditional header to create a new blob
|
|
58
|
+
# only if the blob has not been modified since the specified date/time. If the blob has been modified,
|
|
57
59
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
58
|
-
# * +:if_match+ - String. An ETag value. Specify an ETag value for this conditional header to create a new blob
|
|
59
|
-
# only if the blob's ETag value matches the value specified. If the values do not match,
|
|
60
|
+
# * +:if_match+ - String. An ETag value. Specify an ETag value for this conditional header to create a new blob
|
|
61
|
+
# only if the blob's ETag value matches the value specified. If the values do not match,
|
|
60
62
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
61
|
-
# * +:if_none_match+ - String. An ETag value. Specify an ETag value for this conditional header to create a new blob
|
|
62
|
-
# only if the blob's ETag value does not match the value specified. If the values are identical,
|
|
63
|
+
# * +:if_none_match+ - String. An ETag value. Specify an ETag value for this conditional header to create a new blob
|
|
64
|
+
# only if the blob's ETag value does not match the value specified. If the values are identical,
|
|
63
65
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
64
66
|
#
|
|
65
67
|
# See http://msdn.microsoft.com/en-us/library/azure/dd179451.aspx
|
|
66
68
|
#
|
|
67
69
|
# Returns a Blob
|
|
68
|
-
def create_append_blob(container, blob, options={})
|
|
69
|
-
query = {
|
|
70
|
-
StorageService.with_query query,
|
|
70
|
+
def create_append_blob(container, blob, options = {})
|
|
71
|
+
query = {}
|
|
72
|
+
StorageService.with_query query, "timeout", options[:timeout].to_s if options[:timeout]
|
|
71
73
|
|
|
72
74
|
uri = blob_uri(container, blob, query)
|
|
73
75
|
|
|
74
76
|
headers = StorageService.common_headers
|
|
75
77
|
|
|
76
78
|
# set x-ms-blob-type to AppendBlob
|
|
77
|
-
StorageService.with_header headers,
|
|
79
|
+
StorageService.with_header headers, "x-ms-blob-type", "AppendBlob"
|
|
78
80
|
|
|
79
81
|
# ensure content-length is 0
|
|
80
|
-
StorageService.with_header headers,
|
|
82
|
+
StorageService.with_header headers, "Content-Length", 0.to_s
|
|
81
83
|
|
|
82
84
|
# set the rest of the optional headers
|
|
83
|
-
StorageService.with_header headers,
|
|
84
|
-
StorageService.with_header headers,
|
|
85
|
-
StorageService.with_header headers,
|
|
86
|
-
StorageService.with_header headers,
|
|
87
|
-
StorageService.with_header headers,
|
|
88
|
-
StorageService.with_header headers,
|
|
89
|
-
StorageService.with_header headers,
|
|
85
|
+
StorageService.with_header headers, "Content-MD5", options[:transactional_md5]
|
|
86
|
+
StorageService.with_header headers, "x-ms-blob-content-type", options[:content_type]
|
|
87
|
+
StorageService.with_header headers, "x-ms-blob-content-encoding", options[:content_encoding]
|
|
88
|
+
StorageService.with_header headers, "x-ms-blob-content-language", options[:content_language]
|
|
89
|
+
StorageService.with_header headers, "x-ms-blob-content-md5", options[:content_md5]
|
|
90
|
+
StorageService.with_header headers, "x-ms-blob-cache-control", options[:cache_control]
|
|
91
|
+
StorageService.with_header headers, "x-ms-blob-content-disposition", options[:content_disposition]
|
|
90
92
|
|
|
91
93
|
StorageService.add_metadata_to_headers options[:metadata], headers
|
|
92
94
|
add_blob_conditional_headers options, headers
|
|
@@ -100,7 +102,7 @@ module Azure::Storage
|
|
|
100
102
|
|
|
101
103
|
result
|
|
102
104
|
end
|
|
103
|
-
|
|
105
|
+
|
|
104
106
|
# Public: Commits a new block of data to the end of an existing append blob.
|
|
105
107
|
# This operation is permitted only on blobs created with the create_append_blob API.
|
|
106
108
|
#
|
|
@@ -119,34 +121,34 @@ module Azure::Storage
|
|
|
119
121
|
# * +:max_size+ - Integer. The max length in bytes permitted for the append blob
|
|
120
122
|
# * +:append_position+ - Integer. A number indicating the byte offset to compare. It will succeed only if the append position is equal to this number
|
|
121
123
|
# * +:timeout+ - Integer. A timeout in seconds.
|
|
122
|
-
# * +:request_id+ - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded
|
|
124
|
+
# * +:request_id+ - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded
|
|
123
125
|
# in the analytics logs when storage analytics logging is enabled.
|
|
124
|
-
# * +:if_modified_since+ - String. A DateTime value. Specify this conditional header to append a block only if
|
|
125
|
-
# the blob has been modified since the specified date/time. If the blob has not been modified,
|
|
126
|
+
# * +:if_modified_since+ - String. A DateTime value. Specify this conditional header to append a block only if
|
|
127
|
+
# the blob has been modified since the specified date/time. If the blob has not been modified,
|
|
126
128
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
127
|
-
# * +:if_unmodified_since+ - String. A DateTime value. Specify this conditional header to append a block only if
|
|
128
|
-
# the blob has not been modified since the specified date/time. If the blob has been modified,
|
|
129
|
+
# * +:if_unmodified_since+ - String. A DateTime value. Specify this conditional header to append a block only if
|
|
130
|
+
# the blob has not been modified since the specified date/time. If the blob has been modified,
|
|
129
131
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
130
|
-
# * +:if_match+ - String. An ETag value. Specify an ETag value for this conditional header to append a block only if
|
|
131
|
-
# the blob's ETag value matches the value specified. If the values do not match,
|
|
132
|
+
# * +:if_match+ - String. An ETag value. Specify an ETag value for this conditional header to append a block only if
|
|
133
|
+
# the blob's ETag value matches the value specified. If the values do not match,
|
|
132
134
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
133
|
-
# * +:if_none_match+ - String. An ETag value. Specify an ETag value for this conditional header to append a block only if
|
|
134
|
-
# the blob's ETag value does not match the value specified. If the values are identical,
|
|
135
|
+
# * +:if_none_match+ - String. An ETag value. Specify an ETag value for this conditional header to append a block only if
|
|
136
|
+
# the blob's ETag value does not match the value specified. If the values are identical,
|
|
135
137
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
136
138
|
#
|
|
137
139
|
# See http://msdn.microsoft.com/en-us/library/azure/mt427365.aspx
|
|
138
140
|
#
|
|
139
141
|
# Returns a Blob
|
|
140
|
-
def append_blob_block(container, blob, content, options={})
|
|
141
|
-
query = {
|
|
142
|
-
StorageService.with_query query,
|
|
142
|
+
def append_blob_block(container, blob, content, options = {})
|
|
143
|
+
query = { "comp" => "appendblock" }
|
|
144
|
+
StorageService.with_query query, "timeout", options[:timeout].to_s if options[:timeout]
|
|
143
145
|
|
|
144
146
|
uri = blob_uri(container, blob, query)
|
|
145
147
|
|
|
146
148
|
headers = StorageService.common_headers
|
|
147
|
-
StorageService.with_header headers,
|
|
148
|
-
StorageService.with_header headers,
|
|
149
|
-
|
|
149
|
+
StorageService.with_header headers, "Content-MD5", options[:content_md5]
|
|
150
|
+
StorageService.with_header headers, "x-ms-lease-id", options[:lease_id]
|
|
151
|
+
|
|
150
152
|
add_blob_conditional_headers options, headers
|
|
151
153
|
|
|
152
154
|
response = call(:put, uri, content, headers, options)
|
|
@@ -156,4 +158,4 @@ module Azure::Storage
|
|
|
156
158
|
result
|
|
157
159
|
end
|
|
158
160
|
end
|
|
159
|
-
end
|
|
161
|
+
end
|
|
@@ -1,3 +1,5 @@
|
|
|
1
|
+
# frozen_string_literal: true
|
|
2
|
+
|
|
1
3
|
#-------------------------------------------------------------------------
|
|
2
4
|
# # Copyright (c) Microsoft and contributors. All rights reserved.
|
|
3
5
|
#
|
|
@@ -24,7 +26,7 @@
|
|
|
24
26
|
module Azure::Storage
|
|
25
27
|
module Blob
|
|
26
28
|
include Azure::Storage::Service
|
|
27
|
-
|
|
29
|
+
|
|
28
30
|
class Blob
|
|
29
31
|
def initialize
|
|
30
32
|
@properties = {}
|
|
@@ -36,8 +38,9 @@ module Azure::Storage
|
|
|
36
38
|
attr_accessor :snapshot
|
|
37
39
|
attr_accessor :properties
|
|
38
40
|
attr_accessor :metadata
|
|
41
|
+
attr_accessor :encrypted
|
|
39
42
|
end
|
|
40
|
-
|
|
43
|
+
|
|
41
44
|
# Public: Reads or downloads a blob from the system, including its metadata and properties.
|
|
42
45
|
#
|
|
43
46
|
# ==== Attributes
|
|
@@ -56,44 +59,45 @@ module Azure::Storage
|
|
|
56
59
|
# * +:get_content_md5+ - Boolean. Return the MD5 hash for the range. This option only valid if
|
|
57
60
|
# start_range and end_range are specified. (optional)
|
|
58
61
|
# * +:timeout+ - Integer. A timeout in seconds.
|
|
59
|
-
# * +:request_id+ - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded
|
|
62
|
+
# * +:request_id+ - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded
|
|
60
63
|
# in the analytics logs when storage analytics logging is enabled.
|
|
61
|
-
# * +:if_modified_since+ - String. A DateTime value. Specify this conditional header to get the blob
|
|
62
|
-
# only if the blob has been modified since the specified date/time. If the blob has not been modified,
|
|
64
|
+
# * +:if_modified_since+ - String. A DateTime value. Specify this conditional header to get the blob
|
|
65
|
+
# only if the blob has been modified since the specified date/time. If the blob has not been modified,
|
|
63
66
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
64
|
-
# * +:if_unmodified_since+ - String. A DateTime value. Specify this conditional header to get the blob
|
|
65
|
-
# only if the blob has not been modified since the specified date/time. If the blob has been modified,
|
|
67
|
+
# * +:if_unmodified_since+ - String. A DateTime value. Specify this conditional header to get the blob
|
|
68
|
+
# only if the blob has not been modified since the specified date/time. If the blob has been modified,
|
|
66
69
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
67
|
-
# * +:if_match+ - String. An ETag value. Specify an ETag value for this conditional header to get the blob
|
|
68
|
-
# only if the blob's ETag value matches the value specified. If the values do not match,
|
|
70
|
+
# * +:if_match+ - String. An ETag value. Specify an ETag value for this conditional header to get the blob
|
|
71
|
+
# only if the blob's ETag value matches the value specified. If the values do not match,
|
|
69
72
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
70
|
-
# * +:if_none_match+ - String. An ETag value. Specify an ETag value for this conditional header to get the blob
|
|
71
|
-
# only if the blob's ETag value does not match the value specified. If the values are identical,
|
|
73
|
+
# * +:if_none_match+ - String. An ETag value. Specify an ETag value for this conditional header to get the blob
|
|
74
|
+
# only if the blob's ETag value does not match the value specified. If the values are identical,
|
|
72
75
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
73
76
|
#
|
|
74
77
|
# See http://msdn.microsoft.com/en-us/library/azure/dd179440.aspx
|
|
75
78
|
#
|
|
76
79
|
# Returns a blob and the blob body
|
|
77
|
-
def get_blob(container, blob, options={})
|
|
78
|
-
query = {
|
|
79
|
-
StorageService.with_query query,
|
|
80
|
-
StorageService.with_query query,
|
|
80
|
+
def get_blob(container, blob, options = {})
|
|
81
|
+
query = {}
|
|
82
|
+
StorageService.with_query query, "snapshot", options[:snapshot]
|
|
83
|
+
StorageService.with_query query, "timeout", options[:timeout].to_s if options[:timeout]
|
|
81
84
|
uri = blob_uri(container, blob, query)
|
|
82
85
|
|
|
83
86
|
headers = StorageService.common_headers
|
|
84
|
-
options[:start_range] = 0 if options[:end_range]
|
|
87
|
+
options[:start_range] = 0 if options[:end_range] && (not options[:start_range])
|
|
85
88
|
if options[:start_range]
|
|
86
|
-
StorageService.with_header headers,
|
|
87
|
-
StorageService.with_header headers,
|
|
89
|
+
StorageService.with_header headers, "x-ms-range", "bytes=#{options[:start_range]}-#{options[:end_range]}"
|
|
90
|
+
StorageService.with_header headers, "x-ms-range-get-content-md5", "true" if options[:get_content_md5]
|
|
88
91
|
end
|
|
89
92
|
add_blob_conditional_headers options, headers
|
|
90
93
|
|
|
91
94
|
response = call(:get, uri, nil, headers, options)
|
|
92
95
|
result = Serialization.blob_from_headers(response.headers)
|
|
93
96
|
result.name = blob unless result.name
|
|
97
|
+
|
|
94
98
|
return result, response.body
|
|
95
99
|
end
|
|
96
|
-
|
|
100
|
+
|
|
97
101
|
# Public: Returns all properties and metadata on the blob.
|
|
98
102
|
#
|
|
99
103
|
# ==== Attributes
|
|
@@ -108,34 +112,34 @@ module Azure::Storage
|
|
|
108
112
|
# * +:snapshot+ - String. An opaque DateTime value that specifies the blob snapshot to
|
|
109
113
|
# retrieve information from.
|
|
110
114
|
# * +:timeout+ - Integer. A timeout in seconds.
|
|
111
|
-
# * +:request_id+ - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded
|
|
115
|
+
# * +:request_id+ - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded
|
|
112
116
|
# in the analytics logs when storage analytics logging is enabled.
|
|
113
117
|
# * +:if_modified_since+ - String. A DateTime value. Specify this conditional header to get the blob properties
|
|
114
|
-
# only if the blob has been modified since the specified date/time. If the blob has not been modified,
|
|
118
|
+
# only if the blob has been modified since the specified date/time. If the blob has not been modified,
|
|
115
119
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
116
120
|
# * +:if_unmodified_since+ - String. A DateTime value. Specify this conditional header to get the blob properties
|
|
117
|
-
# only if the blob has not been modified since the specified date/time. If the blob has been modified,
|
|
121
|
+
# only if the blob has not been modified since the specified date/time. If the blob has been modified,
|
|
118
122
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
119
123
|
# * +:if_match+ - String. An ETag value. Specify an ETag value for this conditional header to get the blob properties
|
|
120
|
-
# only if the blob's ETag value matches the value specified. If the values do not match,
|
|
124
|
+
# only if the blob's ETag value matches the value specified. If the values do not match,
|
|
121
125
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
122
126
|
# * +:if_none_match+ - String. An ETag value. Specify an ETag value for this conditional header to get the blob properties
|
|
123
|
-
# only if the blob's ETag value does not match the value specified. If the values are identical,
|
|
127
|
+
# only if the blob's ETag value does not match the value specified. If the values are identical,
|
|
124
128
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
125
129
|
#
|
|
126
130
|
# See http://msdn.microsoft.com/en-us/library/azure/dd179394.aspx
|
|
127
131
|
#
|
|
128
132
|
# Returns the blob properties with a Blob instance
|
|
129
|
-
def get_blob_properties(container, blob, options={})
|
|
130
|
-
query = {
|
|
131
|
-
StorageService.with_query query,
|
|
132
|
-
StorageService.with_query query,
|
|
133
|
+
def get_blob_properties(container, blob, options = {})
|
|
134
|
+
query = {}
|
|
135
|
+
StorageService.with_query query, "snapshot", options[:snapshot]
|
|
136
|
+
StorageService.with_query query, "timeout", options[:timeout].to_s if options[:timeout]
|
|
133
137
|
|
|
134
138
|
headers = StorageService.common_headers
|
|
135
139
|
unless options.empty?
|
|
136
140
|
add_blob_conditional_headers options, headers
|
|
137
141
|
end
|
|
138
|
-
|
|
142
|
+
|
|
139
143
|
uri = blob_uri(container, blob, query)
|
|
140
144
|
|
|
141
145
|
response = call(:head, uri, nil, headers, options)
|
|
@@ -147,7 +151,7 @@ module Azure::Storage
|
|
|
147
151
|
|
|
148
152
|
result
|
|
149
153
|
end
|
|
150
|
-
|
|
154
|
+
|
|
151
155
|
# Public: Sets system properties defined for a blob.
|
|
152
156
|
#
|
|
153
157
|
# ==== Attributes
|
|
@@ -164,7 +168,7 @@ module Azure::Storage
|
|
|
164
168
|
# * +:content_language+ - String. Content language for the blob. Will be saved with blob.
|
|
165
169
|
# * +:content_md5+ - String. Content MD5 for the blob. Will be saved with blob.
|
|
166
170
|
# * +:cache_control+ - String. Cache control for the blob. Will be saved with blob.
|
|
167
|
-
# * +:content_disposition+ - String. Conveys additional information about how to process the response payload,
|
|
171
|
+
# * +:content_disposition+ - String. Conveys additional information about how to process the response payload,
|
|
168
172
|
# and also can be used to attach additional metadata
|
|
169
173
|
# * +:content_length+ - Integer. Resizes a page blob to the specified size. If the specified
|
|
170
174
|
# value is less than the current size of the blob, then all pages above
|
|
@@ -199,19 +203,19 @@ module Azure::Storage
|
|
|
199
203
|
# To set the sequence number to a value of your choosing, this property must be specified
|
|
200
204
|
# together with :sequence_number_action
|
|
201
205
|
# * +:timeout+ - Integer. A timeout in seconds.
|
|
202
|
-
# * +:request_id+ - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded
|
|
206
|
+
# * +:request_id+ - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded
|
|
203
207
|
# in the analytics logs when storage analytics logging is enabled.
|
|
204
208
|
# * +:if_modified_since+ - String. A DateTime value. Specify this conditional header to set the blob properties
|
|
205
|
-
# only if the blob has been modified since the specified date/time. If the blob has not been modified,
|
|
209
|
+
# only if the blob has been modified since the specified date/time. If the blob has not been modified,
|
|
206
210
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
207
211
|
# * +:if_unmodified_since+ - String. A DateTime value. Specify this conditional header to set the blob properties
|
|
208
|
-
# only if the blob has not been modified since the specified date/time. If the blob has been modified,
|
|
212
|
+
# only if the blob has not been modified since the specified date/time. If the blob has been modified,
|
|
209
213
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
210
214
|
# * +:if_match+ - String. An ETag value. Specify an ETag value for this conditional header to set the blob properties
|
|
211
|
-
# only if the blob's ETag value matches the value specified. If the values do not match,
|
|
215
|
+
# only if the blob's ETag value matches the value specified. If the values do not match,
|
|
212
216
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
213
217
|
# * +:if_none_match+ - String. An ETag value. Specify an ETag value for this conditional header to set the blob properties
|
|
214
|
-
# only if the blob's ETag value does not match the value specified. If the values are identical,
|
|
218
|
+
# only if the blob's ETag value does not match the value specified. If the values are identical,
|
|
215
219
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
216
220
|
#
|
|
217
221
|
# Remarks:
|
|
@@ -242,37 +246,37 @@ module Azure::Storage
|
|
|
242
246
|
# See http://msdn.microsoft.com/en-us/library/azure/ee691966.aspx
|
|
243
247
|
#
|
|
244
248
|
# Returns nil on success.
|
|
245
|
-
def set_blob_properties(container, blob, options={})
|
|
246
|
-
query = {
|
|
247
|
-
StorageService.with_query query,
|
|
249
|
+
def set_blob_properties(container, blob, options = {})
|
|
250
|
+
query = { "comp" => "properties" }
|
|
251
|
+
StorageService.with_query query, "timeout", options[:timeout].to_s if options[:timeout]
|
|
248
252
|
uri = blob_uri(container, blob, query)
|
|
249
253
|
|
|
250
254
|
headers = StorageService.common_headers
|
|
251
255
|
|
|
252
256
|
unless options.empty?
|
|
253
|
-
StorageService.with_header headers,
|
|
254
|
-
StorageService.with_header headers,
|
|
255
|
-
StorageService.with_header headers,
|
|
256
|
-
StorageService.with_header headers,
|
|
257
|
-
StorageService.with_header headers,
|
|
258
|
-
StorageService.with_header headers,
|
|
259
|
-
StorageService.with_header headers,
|
|
260
|
-
|
|
257
|
+
StorageService.with_header headers, "x-ms-blob-content-type", options[:content_type]
|
|
258
|
+
StorageService.with_header headers, "x-ms-blob-content-encoding", options[:content_encoding]
|
|
259
|
+
StorageService.with_header headers, "x-ms-blob-content-language", options[:content_language]
|
|
260
|
+
StorageService.with_header headers, "x-ms-blob-content-md5", options[:content_md5]
|
|
261
|
+
StorageService.with_header headers, "x-ms-blob-cache-control", options[:cache_control]
|
|
262
|
+
StorageService.with_header headers, "x-ms-blob-content-length", options[:content_length].to_s if options[:content_length]
|
|
263
|
+
StorageService.with_header headers, "x-ms-blob-content-disposition", options[:content_disposition]
|
|
264
|
+
|
|
261
265
|
if options[:sequence_number_action]
|
|
262
|
-
StorageService.with_header headers,
|
|
263
|
-
|
|
266
|
+
StorageService.with_header headers, "x-ms-blob-sequence-number-action", options[:sequence_number_action].to_s
|
|
267
|
+
|
|
264
268
|
if options[:sequence_number_action] != :increment
|
|
265
|
-
StorageService.with_header headers,
|
|
269
|
+
StorageService.with_header headers, "x-ms-blob-sequence-number", options[:sequence_number].to_s if options[:sequence_number]
|
|
266
270
|
end
|
|
267
271
|
end
|
|
268
|
-
|
|
272
|
+
|
|
269
273
|
add_blob_conditional_headers options, headers
|
|
270
274
|
end
|
|
271
275
|
|
|
272
276
|
call(:put, uri, nil, headers, options)
|
|
273
277
|
nil
|
|
274
278
|
end
|
|
275
|
-
|
|
279
|
+
|
|
276
280
|
# Public: Returns metadata on the blob.
|
|
277
281
|
#
|
|
278
282
|
# ==== Attributes
|
|
@@ -287,28 +291,28 @@ module Azure::Storage
|
|
|
287
291
|
# * +:snapshot+ - String. An opaque DateTime value that specifies the blob snapshot to
|
|
288
292
|
# retrieve information from.
|
|
289
293
|
# * +:timeout+ - Integer. A timeout in seconds.
|
|
290
|
-
# * +:request_id+ - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded
|
|
294
|
+
# * +:request_id+ - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded
|
|
291
295
|
# in the analytics logs when storage analytics logging is enabled.
|
|
292
296
|
# * +:if_modified_since+ - String. A DateTime value. Specify this conditional header to get the blob metadata
|
|
293
|
-
# only if the blob has been modified since the specified date/time. If the blob has not been modified,
|
|
297
|
+
# only if the blob has been modified since the specified date/time. If the blob has not been modified,
|
|
294
298
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
295
299
|
# * +:if_unmodified_since+ - String. A DateTime value. Specify this conditional header to get the blob metadata
|
|
296
|
-
# only if the blob has not been modified since the specified date/time. If the blob has been modified,
|
|
300
|
+
# only if the blob has not been modified since the specified date/time. If the blob has been modified,
|
|
297
301
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
298
302
|
# * +:if_match+ - String. An ETag value. Specify an ETag value for this conditional header to get the blob metadata
|
|
299
|
-
# only if the blob's ETag value matches the value specified. If the values do not match,
|
|
303
|
+
# only if the blob's ETag value matches the value specified. If the values do not match,
|
|
300
304
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
301
305
|
# * +:if_none_match+ - String. An ETag value. Specify an ETag value for this conditional header to get the blob metadata
|
|
302
|
-
# only if the blob's ETag value does not match the value specified. If the values are identical,
|
|
306
|
+
# only if the blob's ETag value does not match the value specified. If the values are identical,
|
|
303
307
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
304
308
|
#
|
|
305
309
|
# See http://msdn.microsoft.com/en-us/library/azure/dd179350.aspx
|
|
306
310
|
#
|
|
307
311
|
# Returns a Blob
|
|
308
|
-
def get_blob_metadata(container, blob, options={})
|
|
309
|
-
query = {
|
|
310
|
-
StorageService.with_query query,
|
|
311
|
-
StorageService.with_query query,
|
|
312
|
+
def get_blob_metadata(container, blob, options = {})
|
|
313
|
+
query = { "comp" => "metadata" }
|
|
314
|
+
StorageService.with_query query, "snapshot", options[:snapshot]
|
|
315
|
+
StorageService.with_query query, "timeout", options[:timeout].to_s if options[:timeout]
|
|
312
316
|
|
|
313
317
|
headers = StorageService.common_headers
|
|
314
318
|
unless options.empty?
|
|
@@ -324,7 +328,7 @@ module Azure::Storage
|
|
|
324
328
|
|
|
325
329
|
result
|
|
326
330
|
end
|
|
327
|
-
|
|
331
|
+
|
|
328
332
|
# Public: Sets metadata headers on the blob.
|
|
329
333
|
#
|
|
330
334
|
# ==== Attributes
|
|
@@ -338,28 +342,28 @@ module Azure::Storage
|
|
|
338
342
|
#
|
|
339
343
|
# Accepted key/value pairs in options parameter are:
|
|
340
344
|
# * +:timeout+ - Integer. A timeout in seconds.
|
|
341
|
-
# * +:request_id+ - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded
|
|
345
|
+
# * +:request_id+ - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded
|
|
342
346
|
# in the analytics logs when storage analytics logging is enabled.
|
|
343
347
|
# * +:if_modified_since+ - String. A DateTime value. Specify this conditional header to set the blob metadata
|
|
344
|
-
# only if the blob has been modified since the specified date/time. If the blob has not been modified,
|
|
348
|
+
# only if the blob has been modified since the specified date/time. If the blob has not been modified,
|
|
345
349
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
346
350
|
# * +:if_unmodified_since+ - String. A DateTime value. Specify this conditional header to set the blob metadata
|
|
347
|
-
# only if the blob has not been modified since the specified date/time. If the blob has been modified,
|
|
351
|
+
# only if the blob has not been modified since the specified date/time. If the blob has been modified,
|
|
348
352
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
349
353
|
# * +:if_match+ - String. An ETag value. Specify an ETag value for this conditional header to set the blob metadata
|
|
350
|
-
# only if the blob's ETag value matches the value specified. If the values do not match,
|
|
354
|
+
# only if the blob's ETag value matches the value specified. If the values do not match,
|
|
351
355
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
352
356
|
# * +:if_none_match+ - String. An ETag value. Specify an ETag value for this conditional header to set the blob metadata
|
|
353
|
-
# only if the blob's ETag value does not match the value specified. If the values are identical,
|
|
357
|
+
# only if the blob's ETag value does not match the value specified. If the values are identical,
|
|
354
358
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
355
359
|
#
|
|
356
360
|
# See http://msdn.microsoft.com/en-us/library/azure/dd179414.aspx
|
|
357
361
|
#
|
|
358
362
|
# Returns nil on success.
|
|
359
|
-
def set_blob_metadata(container, blob, metadata, options={})
|
|
360
|
-
query = {
|
|
361
|
-
StorageService.with_query query,
|
|
362
|
-
|
|
363
|
+
def set_blob_metadata(container, blob, metadata, options = {})
|
|
364
|
+
query = { "comp" => "metadata" }
|
|
365
|
+
StorageService.with_query query, "timeout", options[:timeout].to_s if options[:timeout]
|
|
366
|
+
|
|
363
367
|
uri = blob_uri(container, blob, query)
|
|
364
368
|
|
|
365
369
|
headers = StorageService.common_headers
|
|
@@ -371,7 +375,7 @@ module Azure::Storage
|
|
|
371
375
|
call(:put, uri, nil, headers, options)
|
|
372
376
|
nil
|
|
373
377
|
end
|
|
374
|
-
|
|
378
|
+
|
|
375
379
|
# Public: Establishes an exclusive write lock on a blob. The lock duration can be 15 to 60 seconds, or can be infinite.
|
|
376
380
|
# To write to a locked blob, a client must provide a lease ID.
|
|
377
381
|
#
|
|
@@ -389,19 +393,19 @@ module Azure::Storage
|
|
|
389
393
|
# * +:proposed_lease_id+ - String. Proposed lease ID, in a GUID string format. The Blob service returns 400 (Invalid request)
|
|
390
394
|
# if the proposed lease ID is not in the correct format. (optional)
|
|
391
395
|
# * +:timeout+ - Integer. A timeout in seconds.
|
|
392
|
-
# * +:request_id+ - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded
|
|
396
|
+
# * +:request_id+ - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded
|
|
393
397
|
# in the analytics logs when storage analytics logging is enabled.
|
|
394
398
|
# * +:if_modified_since+ - String. A DateTime value. Specify this conditional header to acquire the lease
|
|
395
|
-
# only if the blob has been modified since the specified date/time. If the blob has not been modified,
|
|
399
|
+
# only if the blob has been modified since the specified date/time. If the blob has not been modified,
|
|
396
400
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
397
401
|
# * +:if_unmodified_since+ - String. A DateTime value. Specify this conditional header to acquire the lease
|
|
398
|
-
# only if the blob has not been modified since the specified date/time. If the blob has been modified,
|
|
402
|
+
# only if the blob has not been modified since the specified date/time. If the blob has been modified,
|
|
399
403
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
400
404
|
# * +:if_match+ - String. An ETag value. Specify an ETag value for this conditional header to acquire the lease
|
|
401
|
-
# only if the blob's ETag value matches the value specified. If the values do not match,
|
|
405
|
+
# only if the blob's ETag value matches the value specified. If the values do not match,
|
|
402
406
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
403
407
|
# * +:if_none_match+ - String. An ETag value. Specify an ETag value for this conditional header to acquire the lease
|
|
404
|
-
# only if the blob's ETag value does not match the value specified. If the values are identical,
|
|
408
|
+
# only if the blob's ETag value does not match the value specified. If the values are identical,
|
|
405
409
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
406
410
|
#
|
|
407
411
|
# See http://msdn.microsoft.com/en-us/library/azure/ee691972.aspx
|
|
@@ -409,7 +413,7 @@ module Azure::Storage
|
|
|
409
413
|
# Returns a String of the new unique lease id. While the lease is active, you must include the lease ID with any request
|
|
410
414
|
# to write to the blob, or to renew, change, or release the lease.
|
|
411
415
|
#
|
|
412
|
-
def acquire_blob_lease(container, blob, options={})
|
|
416
|
+
def acquire_blob_lease(container, blob, options = {})
|
|
413
417
|
acquire_lease container, blob, options
|
|
414
418
|
end
|
|
415
419
|
|
|
@@ -429,27 +433,27 @@ module Azure::Storage
|
|
|
429
433
|
#
|
|
430
434
|
# Accepted key/value pairs in options parameter are:
|
|
431
435
|
# * +:timeout+ - Integer. A timeout in seconds.
|
|
432
|
-
# * +:request_id+ - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded
|
|
436
|
+
# * +:request_id+ - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded
|
|
433
437
|
# in the analytics logs when storage analytics logging is enabled.
|
|
434
438
|
# * +:if_modified_since+ - String. A DateTime value. Specify this conditional header to renew the lease
|
|
435
|
-
# only if the blob has been modified since the specified date/time. If the blob has not been modified,
|
|
439
|
+
# only if the blob has been modified since the specified date/time. If the blob has not been modified,
|
|
436
440
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
437
441
|
# * +:if_unmodified_since+ - String. A DateTime value. Specify this conditional header to renew the lease
|
|
438
|
-
# only if the blob has not been modified since the specified date/time. If the blob has been modified,
|
|
442
|
+
# only if the blob has not been modified since the specified date/time. If the blob has been modified,
|
|
439
443
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
440
444
|
# * +:if_match+ - String. An ETag value. Specify an ETag value for this conditional header to renew the lease
|
|
441
|
-
# only if the blob's ETag value matches the value specified. If the values do not match,
|
|
445
|
+
# only if the blob's ETag value matches the value specified. If the values do not match,
|
|
442
446
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
443
447
|
# * +:if_none_match+ - String. An ETag value. Specify an ETag value for this conditional header to renew the lease
|
|
444
|
-
# only if the blob's ETag value does not match the value specified. If the values are identical,
|
|
448
|
+
# only if the blob's ETag value does not match the value specified. If the values are identical,
|
|
445
449
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
446
450
|
# See http://msdn.microsoft.com/en-us/library/azure/ee691972.aspx
|
|
447
451
|
#
|
|
448
452
|
# Returns the renewed lease id
|
|
449
|
-
def renew_blob_lease(container, blob, lease, options={})
|
|
453
|
+
def renew_blob_lease(container, blob, lease, options = {})
|
|
450
454
|
renew_lease container, blob, lease, options
|
|
451
455
|
end
|
|
452
|
-
|
|
456
|
+
|
|
453
457
|
# Public: Change the lease ID.
|
|
454
458
|
#
|
|
455
459
|
# ==== Attributes
|
|
@@ -465,24 +469,24 @@ module Azure::Storage
|
|
|
465
469
|
#
|
|
466
470
|
# Accepted key/value pairs in options parameter are:
|
|
467
471
|
# * +:timeout+ - Integer. A timeout in seconds.
|
|
468
|
-
# * +:request_id+ - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded
|
|
472
|
+
# * +:request_id+ - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded
|
|
469
473
|
# in the analytics logs when storage analytics logging is enabled.
|
|
470
474
|
# * +:if_modified_since+ - String. A DateTime value. Specify this conditional header to change the lease
|
|
471
|
-
# only if the blob has been modified since the specified date/time. If the blob has not been modified,
|
|
475
|
+
# only if the blob has been modified since the specified date/time. If the blob has not been modified,
|
|
472
476
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
473
477
|
# * +:if_unmodified_since+ - String. A DateTime value. Specify this conditional header to change the lease
|
|
474
|
-
# only if the blob has not been modified since the specified date/time. If the blob has been modified,
|
|
478
|
+
# only if the blob has not been modified since the specified date/time. If the blob has been modified,
|
|
475
479
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
476
480
|
# * +:if_match+ - String. An ETag value. Specify an ETag value for this conditional header to change the lease
|
|
477
|
-
# only if the blob's ETag value matches the value specified. If the values do not match,
|
|
481
|
+
# only if the blob's ETag value matches the value specified. If the values do not match,
|
|
478
482
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
479
483
|
# * +:if_none_match+ - String. An ETag value. Specify an ETag value for this conditional header to change the lease
|
|
480
|
-
# only if the blob's ETag value does not match the value specified. If the values are identical,
|
|
484
|
+
# only if the blob's ETag value does not match the value specified. If the values are identical,
|
|
481
485
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
482
486
|
# See http://msdn.microsoft.com/en-us/library/azure/ee691972.aspx
|
|
483
487
|
#
|
|
484
488
|
# Returns the changed lease id
|
|
485
|
-
def change_blob_lease(container, blob, lease, proposed_lease, options={})
|
|
489
|
+
def change_blob_lease(container, blob, lease, proposed_lease, options = {})
|
|
486
490
|
change_lease container, blob, lease, proposed_lease, options
|
|
487
491
|
end
|
|
488
492
|
|
|
@@ -501,24 +505,24 @@ module Azure::Storage
|
|
|
501
505
|
#
|
|
502
506
|
# Accepted key/value pairs in options parameter are:
|
|
503
507
|
# * +:timeout+ - Integer. A timeout in seconds.
|
|
504
|
-
# * +:request_id+ - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded
|
|
508
|
+
# * +:request_id+ - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded
|
|
505
509
|
# in the analytics logs when storage analytics logging is enabled.
|
|
506
510
|
# * +:if_modified_since+ - String. A DateTime value. Specify this conditional header to release the lease
|
|
507
|
-
# only if the blob has been modified since the specified date/time. If the blob has not been modified,
|
|
511
|
+
# only if the blob has been modified since the specified date/time. If the blob has not been modified,
|
|
508
512
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
509
513
|
# * +:if_unmodified_since+ - String. A DateTime value. Specify this conditional header to release the lease
|
|
510
|
-
# only if the blob has not been modified since the specified date/time. If the blob has been modified,
|
|
514
|
+
# only if the blob has not been modified since the specified date/time. If the blob has been modified,
|
|
511
515
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
512
516
|
# * +:if_match+ - String. An ETag value. Specify an ETag value for this conditional header to release the lease
|
|
513
|
-
# only if the blob's ETag value matches the value specified. If the values do not match,
|
|
517
|
+
# only if the blob's ETag value matches the value specified. If the values do not match,
|
|
514
518
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
515
519
|
# * +:if_none_match+ - String. An ETag value. Specify an ETag value for this conditional header to release the lease
|
|
516
|
-
# only if the blob's ETag value does not match the value specified. If the values are identical,
|
|
520
|
+
# only if the blob's ETag value does not match the value specified. If the values are identical,
|
|
517
521
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
518
522
|
# See http://msdn.microsoft.com/en-us/library/azure/ee691972.aspx
|
|
519
523
|
#
|
|
520
524
|
# Returns nil on success
|
|
521
|
-
def release_blob_lease(container, blob, lease, options={})
|
|
525
|
+
def release_blob_lease(container, blob, lease, options = {})
|
|
522
526
|
release_lease container, blob, lease, options
|
|
523
527
|
end
|
|
524
528
|
|
|
@@ -549,29 +553,29 @@ module Azure::Storage
|
|
|
549
553
|
# If this option is not used, a fixed-duration lease breaks after the remaining lease
|
|
550
554
|
# period elapses, and an infinite lease breaks immediately.
|
|
551
555
|
# * +:timeout+ - Integer. A timeout in seconds.
|
|
552
|
-
# * +:request_id+ - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded
|
|
556
|
+
# * +:request_id+ - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded
|
|
553
557
|
# in the analytics logs when storage analytics logging is enabled.
|
|
554
558
|
# * +:if_modified_since+ - String. A DateTime value. Specify this conditional header to break the lease
|
|
555
|
-
# only if the blob has been modified since the specified date/time. If the blob has not been modified,
|
|
559
|
+
# only if the blob has been modified since the specified date/time. If the blob has not been modified,
|
|
556
560
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
557
561
|
# * +:if_unmodified_since+ - String. A DateTime value. Specify this conditional header to break the lease
|
|
558
|
-
# only if the blob has not been modified since the specified date/time. If the blob has been modified,
|
|
562
|
+
# only if the blob has not been modified since the specified date/time. If the blob has been modified,
|
|
559
563
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
560
564
|
# * +:if_match+ - String. An ETag value. Specify an ETag value for this conditional header to break the lease
|
|
561
|
-
# only if the blob's ETag value matches the value specified. If the values do not match,
|
|
565
|
+
# only if the blob's ETag value matches the value specified. If the values do not match,
|
|
562
566
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
563
567
|
# * +:if_none_match+ - String. An ETag value. Specify an ETag value for this conditional header to break the lease
|
|
564
|
-
# only if the blob's ETag value does not match the value specified. If the values are identical,
|
|
568
|
+
# only if the blob's ETag value does not match the value specified. If the values are identical,
|
|
565
569
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
566
570
|
# See http://msdn.microsoft.com/en-us/library/azure/ee691972.aspx
|
|
567
571
|
#
|
|
568
572
|
# Returns an Integer of the remaining lease time. This value is the approximate time remaining in the lease
|
|
569
573
|
# period, in seconds. This header is returned only for a successful request to break the lease. If the break
|
|
570
574
|
# is immediate, 0 is returned.
|
|
571
|
-
def break_blob_lease(container, blob, options={})
|
|
575
|
+
def break_blob_lease(container, blob, options = {})
|
|
572
576
|
break_lease container, blob, options
|
|
573
577
|
end
|
|
574
|
-
|
|
578
|
+
|
|
575
579
|
# Public: Creates a snapshot of a blob.
|
|
576
580
|
#
|
|
577
581
|
# ==== Attributes
|
|
@@ -585,27 +589,27 @@ module Azure::Storage
|
|
|
585
589
|
# Accepted key/value pairs in options parameter are:
|
|
586
590
|
# * +:metadata+ - Hash. Custom metadata values to store with the blob snapshot.
|
|
587
591
|
# * +:timeout+ - Integer. A timeout in seconds.
|
|
588
|
-
# * +:request_id+ - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded
|
|
592
|
+
# * +:request_id+ - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded
|
|
589
593
|
# in the analytics logs when storage analytics logging is enabled.
|
|
590
594
|
# * +:if_modified_since+ - String. A DateTime value. Specify this conditional header to create the blob snapshot
|
|
591
|
-
# only if the blob has been modified since the specified date/time. If the blob has not been modified,
|
|
595
|
+
# only if the blob has been modified since the specified date/time. If the blob has not been modified,
|
|
592
596
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
593
597
|
# * +:if_unmodified_since+ - String. A DateTime value. Specify this conditional header to create the blob snapshot
|
|
594
|
-
# only if the blob has not been modified since the specified date/time. If the blob has been modified,
|
|
598
|
+
# only if the blob has not been modified since the specified date/time. If the blob has been modified,
|
|
595
599
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
596
600
|
# * +:if_match+ - String. An ETag value. Specify an ETag value for this conditional header to create the blob snapshot
|
|
597
|
-
# only if the blob's ETag value matches the value specified. If the values do not match,
|
|
601
|
+
# only if the blob's ETag value matches the value specified. If the values do not match,
|
|
598
602
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
599
603
|
# * +:if_none_match+ - String. An ETag value. Specify an ETag value for this conditional header to create the blob snapshot
|
|
600
|
-
# only if the blob's ETag value does not match the value specified. If the values are identical,
|
|
604
|
+
# only if the blob's ETag value does not match the value specified. If the values are identical,
|
|
601
605
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
602
606
|
#
|
|
603
607
|
# See http://msdn.microsoft.com/en-us/library/azure/ee691971.aspx
|
|
604
608
|
#
|
|
605
609
|
# Returns the snapshot DateTime value
|
|
606
|
-
def create_blob_snapshot(container, blob, options={})
|
|
607
|
-
query = {
|
|
608
|
-
StorageService.with_query query,
|
|
610
|
+
def create_blob_snapshot(container, blob, options = {})
|
|
611
|
+
query = { "comp" => "snapshot" }
|
|
612
|
+
StorageService.with_query query, "timeout", options[:timeout].to_s if options[:timeout]
|
|
609
613
|
|
|
610
614
|
uri = blob_uri(container, blob, query)
|
|
611
615
|
|
|
@@ -617,9 +621,9 @@ module Azure::Storage
|
|
|
617
621
|
|
|
618
622
|
response = call(:put, uri, nil, headers, options)
|
|
619
623
|
|
|
620
|
-
response.headers[
|
|
624
|
+
response.headers["x-ms-snapshot"]
|
|
621
625
|
end
|
|
622
|
-
|
|
626
|
+
|
|
623
627
|
# Public: Copies a source blob or file to a destination blob.
|
|
624
628
|
#
|
|
625
629
|
# ==== Attributes
|
|
@@ -662,7 +666,7 @@ module Azure::Storage
|
|
|
662
666
|
# blob's ETag value does not match the value specified. If the values are
|
|
663
667
|
# identical, the Blob service returns status code 412 (Precondition Failed).
|
|
664
668
|
# * +:timeout+ - Integer. A timeout in seconds.
|
|
665
|
-
# * +:request_id+ - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded
|
|
669
|
+
# * +:request_id+ - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded
|
|
666
670
|
# in the analytics logs when storage analytics logging is enabled.
|
|
667
671
|
#
|
|
668
672
|
# See http://msdn.microsoft.com/en-us/library/azure/dd894037.aspx
|
|
@@ -675,13 +679,13 @@ module Azure::Storage
|
|
|
675
679
|
# "success" - The copy completed successfully.
|
|
676
680
|
# "pending" - The copy is in progress.
|
|
677
681
|
#
|
|
678
|
-
def copy_blob_from_uri(destination_container, destination_blob, source_uri, options={})
|
|
679
|
-
query = {
|
|
680
|
-
StorageService.with_query query,
|
|
682
|
+
def copy_blob_from_uri(destination_container, destination_blob, source_uri, options = {})
|
|
683
|
+
query = {}
|
|
684
|
+
StorageService.with_query query, "timeout", options[:timeout].to_s if options[:timeout]
|
|
681
685
|
|
|
682
686
|
uri = blob_uri(destination_container, destination_blob, query)
|
|
683
687
|
headers = StorageService.common_headers
|
|
684
|
-
StorageService.with_header headers,
|
|
688
|
+
StorageService.with_header headers, "x-ms-copy-source", source_uri
|
|
685
689
|
|
|
686
690
|
unless options.empty?
|
|
687
691
|
add_blob_conditional_headers options, headers
|
|
@@ -689,9 +693,9 @@ module Azure::Storage
|
|
|
689
693
|
end
|
|
690
694
|
|
|
691
695
|
response = call(:put, uri, nil, headers, options)
|
|
692
|
-
return response.headers[
|
|
696
|
+
return response.headers["x-ms-copy-id"], response.headers["x-ms-copy-status"]
|
|
693
697
|
end
|
|
694
|
-
|
|
698
|
+
|
|
695
699
|
# Public: Copies a source blob to a destination blob within the same storage account.
|
|
696
700
|
#
|
|
697
701
|
# ==== Attributes
|
|
@@ -735,7 +739,7 @@ module Azure::Storage
|
|
|
735
739
|
# blob's ETag value does not match the value specified. If the values are
|
|
736
740
|
# identical, the Blob service returns status code 412 (Precondition Failed).
|
|
737
741
|
# * +:timeout+ - Integer. A timeout in seconds.
|
|
738
|
-
# * +:request_id+ - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded
|
|
742
|
+
# * +:request_id+ - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded
|
|
739
743
|
# in the analytics logs when storage analytics logging is enabled.
|
|
740
744
|
#
|
|
741
745
|
# See http://msdn.microsoft.com/en-us/library/azure/dd894037.aspx
|
|
@@ -748,13 +752,13 @@ module Azure::Storage
|
|
|
748
752
|
# "success" - The copy completed successfully.
|
|
749
753
|
# "pending" - The copy is in progress.
|
|
750
754
|
#
|
|
751
|
-
def copy_blob(destination_container, destination_blob, source_container, source_blob, options={})
|
|
752
|
-
source_blob_uri = blob_uri(source_container, source_blob, options[:source_snapshot] ? {
|
|
755
|
+
def copy_blob(destination_container, destination_blob, source_container, source_blob, options = {})
|
|
756
|
+
source_blob_uri = blob_uri(source_container, source_blob, options[:source_snapshot] ? { "snapshot" => options[:source_snapshot] } : {}).to_s
|
|
753
757
|
|
|
754
758
|
return copy_blob_from_uri(destination_container, destination_blob, source_blob_uri, options)
|
|
755
759
|
end
|
|
756
|
-
|
|
757
|
-
# Public: Aborts a pending Copy Blob operation and leaves a destination blob with zero length and full metadata.
|
|
760
|
+
|
|
761
|
+
# Public: Aborts a pending Copy Blob operation and leaves a destination blob with zero length and full metadata.
|
|
758
762
|
#
|
|
759
763
|
# ==== Attributes
|
|
760
764
|
#
|
|
@@ -768,29 +772,29 @@ module Azure::Storage
|
|
|
768
772
|
# Accepted key/value pairs in options parameter are:
|
|
769
773
|
# * +:lease_id+ - String. The lease id if the destination blob has an active infinite lease
|
|
770
774
|
# * +:timeout+ - Integer. A timeout in seconds.
|
|
771
|
-
# * +:request_id+ - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded
|
|
775
|
+
# * +:request_id+ - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded
|
|
772
776
|
# in the analytics logs when storage analytics logging is enabled.
|
|
773
777
|
#
|
|
774
778
|
# See https://msdn.microsoft.com/en-us/library/azure/jj159098.aspx
|
|
775
779
|
#
|
|
776
780
|
# Returns nil on success
|
|
777
|
-
def abort_copy_blob(container, blob, copy_id, options={})
|
|
778
|
-
query = {
|
|
779
|
-
StorageService.with_query query,
|
|
780
|
-
StorageService.with_query query,
|
|
781
|
+
def abort_copy_blob(container, blob, copy_id, options = {})
|
|
782
|
+
query = { "comp" => "copy" }
|
|
783
|
+
StorageService.with_query query, "timeout", options[:timeout].to_s if options[:timeout]
|
|
784
|
+
StorageService.with_query query, "copyid", copy_id
|
|
781
785
|
|
|
782
786
|
uri = blob_uri(container, blob, query);
|
|
783
787
|
headers = StorageService.common_headers
|
|
784
|
-
StorageService.with_header headers,
|
|
785
|
-
|
|
788
|
+
StorageService.with_header headers, "x-ms-copy-action", "abort";
|
|
789
|
+
|
|
786
790
|
unless options.empty?
|
|
787
|
-
StorageService.with_header headers,
|
|
791
|
+
StorageService.with_header headers, "x-ms-lease-id", options[:lease_id]
|
|
788
792
|
end
|
|
789
793
|
|
|
790
794
|
call(:put, uri, nil, headers, options)
|
|
791
795
|
nil
|
|
792
796
|
end
|
|
793
|
-
|
|
797
|
+
|
|
794
798
|
# Public: Deletes a blob or blob snapshot.
|
|
795
799
|
#
|
|
796
800
|
# ==== Attributes
|
|
@@ -812,40 +816,39 @@ module Azure::Storage
|
|
|
812
816
|
# * +:only+ - Deletes only the snapshots for the blob, but leaves the blob
|
|
813
817
|
# * +:include+ - Deletes the blob and all of the snapshots for the blob
|
|
814
818
|
# * +:timeout+ - Integer. A timeout in seconds.
|
|
815
|
-
# * +:request_id+ - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded
|
|
819
|
+
# * +:request_id+ - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded
|
|
816
820
|
# in the analytics logs when storage analytics logging is enabled.
|
|
817
821
|
# * +:if_modified_since+ - String. A DateTime value. Specify this conditional header to create the blob snapshot
|
|
818
|
-
# only if the blob has been modified since the specified date/time. If the blob has not been modified,
|
|
822
|
+
# only if the blob has been modified since the specified date/time. If the blob has not been modified,
|
|
819
823
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
820
824
|
# * +:if_unmodified_since+ - String. A DateTime value. Specify this conditional header to create the blob snapshot
|
|
821
|
-
# only if the blob has not been modified since the specified date/time. If the blob has been modified,
|
|
825
|
+
# only if the blob has not been modified since the specified date/time. If the blob has been modified,
|
|
822
826
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
823
827
|
# * +:if_match+ - String. An ETag value. Specify an ETag value for this conditional header to create the blob snapshot
|
|
824
|
-
# only if the blob's ETag value matches the value specified. If the values do not match,
|
|
828
|
+
# only if the blob's ETag value matches the value specified. If the values do not match,
|
|
825
829
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
826
830
|
# * +:if_none_match+ - String. An ETag value. Specify an ETag value for this conditional header to create the blob snapshot
|
|
827
|
-
# only if the blob's ETag value does not match the value specified. If the values are identical,
|
|
831
|
+
# only if the blob's ETag value does not match the value specified. If the values are identical,
|
|
828
832
|
# the Blob service returns status code 412 (Precondition Failed).
|
|
829
833
|
#
|
|
830
834
|
# See http://msdn.microsoft.com/en-us/library/azure/dd179440.aspx
|
|
831
835
|
#
|
|
832
836
|
# Returns nil on success
|
|
833
|
-
def delete_blob(container, blob, options={})
|
|
834
|
-
query = {
|
|
835
|
-
StorageService.with_query query,
|
|
836
|
-
StorageService.with_query query,
|
|
837
|
+
def delete_blob(container, blob, options = {})
|
|
838
|
+
query = {}
|
|
839
|
+
StorageService.with_query query, "snapshot", options[:snapshot]
|
|
840
|
+
StorageService.with_query query, "timeout", options[:timeout].to_s if options[:timeout]
|
|
837
841
|
|
|
838
842
|
uri = blob_uri(container, blob, query)
|
|
839
843
|
|
|
840
844
|
options[:delete_snapshots] = :include unless options[:delete_snapshots]
|
|
841
845
|
|
|
842
846
|
headers = StorageService.common_headers
|
|
843
|
-
StorageService.with_header headers,
|
|
847
|
+
StorageService.with_header headers, "x-ms-delete-snapshots", options[:delete_snapshots].to_s if options[:delete_snapshots] && options[:snapshot] == nil
|
|
844
848
|
add_blob_conditional_headers options, headers
|
|
845
849
|
|
|
846
850
|
call(:delete, uri, nil, headers, options)
|
|
847
851
|
nil
|
|
848
852
|
end
|
|
849
|
-
|
|
850
853
|
end
|
|
851
|
-
end
|
|
854
|
+
end
|