1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
|
package files
import (
"context"
"fmt"
"net/http"
"strings"
"time"
"github.com/Azure/go-autorest/autorest"
"github.com/Azure/go-autorest/autorest/azure"
"github.com/Azure/go-autorest/autorest/validation"
"github.com/tombuildsstuff/giovanni/storage/internal/endpoints"
"github.com/tombuildsstuff/giovanni/storage/internal/metadata"
)
type CreateInput struct {
// This header specifies the maximum size for the file, up to 1 TiB.
ContentLength int64
// The MIME content type of the file
// If not specified, the default type is application/octet-stream.
ContentType *string
// Specifies which content encodings have been applied to the file.
// This value is returned to the client when the Get File operation is performed
// on the file resource and can be used to decode file content.
ContentEncoding *string
// Specifies the natural languages used by this resource.
ContentLanguage *string
// The File service stores this value but does not use or modify it.
CacheControl *string
// Sets the file's MD5 hash.
ContentMD5 *string
// Sets the file’s Content-Disposition header.
ContentDisposition *string
// The time at which this file was created at - if omitted, this'll be set to "now"
// This maps to the `x-ms-file-creation-time` field.
CreatedAt *time.Time
// The time at which this file was last modified - if omitted, this'll be set to "now"
// This maps to the `x-ms-file-last-write-time` field.
LastModified *time.Time
// MetaData is a mapping of key value pairs which should be assigned to this file
MetaData map[string]string
}
// Create creates a new file or replaces a file.
func (client Client) Create(ctx context.Context, accountName, shareName, path, fileName string, input CreateInput) (result autorest.Response, err error) {
if accountName == "" {
return result, validation.NewError("files.Client", "Create", "`accountName` cannot be an empty string.")
}
if shareName == "" {
return result, validation.NewError("files.Client", "Create", "`shareName` cannot be an empty string.")
}
if strings.ToLower(shareName) != shareName {
return result, validation.NewError("files.Client", "Create", "`shareName` must be a lower-cased string.")
}
if fileName == "" {
return result, validation.NewError("files.Client", "Create", "`fileName` cannot be an empty string.")
}
if err := metadata.Validate(input.MetaData); err != nil {
return result, validation.NewError("files.Client", "Create", "`input.MetaData` cannot be an empty string.")
}
req, err := client.CreatePreparer(ctx, accountName, shareName, path, fileName, input)
if err != nil {
err = autorest.NewErrorWithError(err, "files.Client", "Create", nil, "Failure preparing request")
return
}
resp, err := client.CreateSender(req)
if err != nil {
result = autorest.Response{Response: resp}
err = autorest.NewErrorWithError(err, "files.Client", "Create", resp, "Failure sending request")
return
}
result, err = client.CreateResponder(resp)
if err != nil {
err = autorest.NewErrorWithError(err, "files.Client", "Create", resp, "Failure responding to request")
return
}
return
}
// CreatePreparer prepares the Create request.
func (client Client) CreatePreparer(ctx context.Context, accountName, shareName, path, fileName string, input CreateInput) (*http.Request, error) {
if path != "" {
path = fmt.Sprintf("%s/", path)
}
pathParameters := map[string]interface{}{
"shareName": autorest.Encode("path", shareName),
"directory": autorest.Encode("path", path),
"fileName": autorest.Encode("path", fileName),
}
var coalesceDate = func(input *time.Time, defaultVal string) string {
if input == nil {
return defaultVal
}
return input.Format(time.RFC1123)
}
headers := map[string]interface{}{
"x-ms-version": APIVersion,
"x-ms-content-length": input.ContentLength,
"x-ms-type": "file",
"x-ms-file-permission": "inherit", // TODO: expose this in future
"x-ms-file-attributes": "None", // TODO: expose this in future
"x-ms-file-creation-time": coalesceDate(input.CreatedAt, "now"),
"x-ms-file-last-write-time": coalesceDate(input.LastModified, "now"),
}
if input.ContentDisposition != nil {
headers["x-ms-content-disposition"] = *input.ContentDisposition
}
if input.ContentEncoding != nil {
headers["x-ms-content-encoding"] = *input.ContentEncoding
}
if input.ContentMD5 != nil {
headers["x-ms-content-md5"] = *input.ContentMD5
}
if input.ContentType != nil {
headers["x-ms-content-type"] = *input.ContentType
}
headers = metadata.SetIntoHeaders(headers, input.MetaData)
preparer := autorest.CreatePreparer(
autorest.AsContentType("application/xml; charset=utf-8"),
autorest.AsPut(),
autorest.WithBaseURL(endpoints.GetFileEndpoint(client.BaseURI, accountName)),
autorest.WithPathParameters("/{shareName}/{directory}{fileName}", pathParameters),
autorest.WithHeaders(headers))
return preparer.Prepare((&http.Request{}).WithContext(ctx))
}
// CreateSender sends the Create request. The method will close the
// http.Response Body if it receives an error.
func (client Client) CreateSender(req *http.Request) (*http.Response, error) {
return autorest.SendWithSender(client, req,
azure.DoRetryWithRegistration(client.Client))
}
// CreateResponder handles the response to the Create request. The method always
// closes the http.Response Body.
func (client Client) CreateResponder(resp *http.Response) (result autorest.Response, err error) {
err = autorest.Respond(
resp,
client.ByInspecting(),
azure.WithErrorUnlessStatusCode(http.StatusCreated),
autorest.ByClosing())
result = autorest.Response{Response: resp}
return
}
|
