/
put_object_request_response.go
280 lines (231 loc) · 14 KB
/
put_object_request_response.go
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
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
// Copyright (c) 2016, 2018, 2024, Oracle and/or its affiliates. All rights reserved.
// This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
// Code generated. DO NOT EDIT.
package objectstorage
import (
"fmt"
"github.com/oracle/oci-go-sdk/v65/common"
"io"
"net/http"
"strings"
)
// PutObjectRequest wrapper for the PutObject operation
//
// # See also
//
// Click https://docs.cloud.oracle.com/en-us/iaas/tools/go-sdk-examples/latest/objectstorage/PutObject.go.html to see an example of how to use PutObjectRequest.
type PutObjectRequest struct {
// The Object Storage namespace used for the request.
NamespaceName *string `mandatory:"true" contributesTo:"path" name:"namespaceName"`
// The name of the bucket. Avoid entering confidential information.
// Example: `my-new-bucket1`
BucketName *string `mandatory:"true" contributesTo:"path" name:"bucketName"`
// The name of the object. Avoid entering confidential information.
// Example: `test/object1.log`
ObjectName *string `mandatory:"true" contributesTo:"path" name:"objectName"`
// The content length of the body.
ContentLength *int64 `mandatory:"false" contributesTo:"header" name:"Content-Length"`
// The object to upload to the object store.
PutObjectBody io.ReadCloser `mandatory:"true" contributesTo:"body" encoding:"binary"`
// The entity tag (ETag) to match with the ETag of an existing resource. If the specified ETag matches the ETag of
// the existing resource, GET and HEAD requests will return the resource and PUT and POST requests will upload
// the resource.
IfMatch *string `mandatory:"false" contributesTo:"header" name:"if-match"`
// The entity tag (ETag) to avoid matching. The only valid value is '*', which indicates that the request should
// fail if the resource already exists.
IfNoneMatch *string `mandatory:"false" contributesTo:"header" name:"if-none-match"`
// The client request ID for tracing.
OpcClientRequestId *string `mandatory:"false" contributesTo:"header" name:"opc-client-request-id"`
// A value of `100-continue` requests preliminary verification of the request method, path, and headers before the request body is sent.
// If no error results from such verification, the server will send a 100 (Continue) interim response to indicate readiness for the request body.
// The only allowed value for this parameter is "100-Continue" (case-insensitive).
Expect *string `mandatory:"false" contributesTo:"header" name:"Expect"`
// The optional base-64 header that defines the encoded MD5 hash of the body. If the optional Content-MD5 header is present, Object
// Storage performs an integrity check on the body of the HTTP request by computing the MD5 hash for the body and comparing it to the
// MD5 hash supplied in the header. If the two hashes do not match, the object is rejected and an HTTP-400 Unmatched Content MD5 error
// is returned with the message:
// "The computed MD5 of the request body (ACTUAL_MD5) does not match the Content-MD5 header (HEADER_MD5)"
ContentMD5 *string `mandatory:"false" contributesTo:"header" name:"Content-MD5"`
// The optional Content-Type header that defines the standard MIME type format of the object. Content type defaults to
// 'application/octet-stream' if not specified in the PutObject call. Specifying values for this header has no effect
// on Object Storage behavior. Programs that read the object determine what to do based on the value provided. For example,
// you could use this header to identify and perform special operations on text only objects.
ContentType *string `mandatory:"false" contributesTo:"header" name:"Content-Type"`
// The optional Content-Language header that defines the content language of the object to upload. Specifying
// values for this header has no effect on Object Storage behavior. Programs that read the object determine what
// to do based on the value provided. For example, you could use this header to identify and differentiate objects
// based on a particular language.
ContentLanguage *string `mandatory:"false" contributesTo:"header" name:"Content-Language"`
// The optional Content-Encoding header that defines the content encodings that were applied to the object to
// upload. Specifying values for this header has no effect on Object Storage behavior. Programs that read the
// object determine what to do based on the value provided. For example, you could use this header to determine
// what decoding mechanisms need to be applied to obtain the media-type specified by the Content-Type header of
// the object.
ContentEncoding *string `mandatory:"false" contributesTo:"header" name:"Content-Encoding"`
// The optional Content-Disposition header that defines presentational information for the object to be
// returned in GetObject and HeadObject responses. Specifying values for this header has no effect on Object
// Storage behavior. Programs that read the object determine what to do based on the value provided.
// For example, you could use this header to let users download objects with custom filenames in a browser.
ContentDisposition *string `mandatory:"false" contributesTo:"header" name:"Content-Disposition"`
// The optional Cache-Control header that defines the caching behavior value to be returned in GetObject and
// HeadObject responses. Specifying values for this header has no effect on Object Storage behavior. Programs
// that read the object determine what to do based on the value provided.
// For example, you could use this header to identify objects that require caching restrictions.
CacheControl *string `mandatory:"false" contributesTo:"header" name:"Cache-Control"`
// The optional header that specifies "AES256" as the encryption algorithm. For more information, see
// Using Your Own Keys for Server-Side Encryption (https://docs.cloud.oracle.com/Content/Object/Tasks/usingyourencryptionkeys.htm).
OpcSseCustomerAlgorithm *string `mandatory:"false" contributesTo:"header" name:"opc-sse-customer-algorithm"`
// The optional header that specifies the base64-encoded 256-bit encryption key to use to encrypt or
// decrypt the data. For more information, see
// Using Your Own Keys for Server-Side Encryption (https://docs.cloud.oracle.com/Content/Object/Tasks/usingyourencryptionkeys.htm).
OpcSseCustomerKey *string `mandatory:"false" contributesTo:"header" name:"opc-sse-customer-key"`
// The optional header that specifies the base64-encoded SHA256 hash of the encryption key. This
// value is used to check the integrity of the encryption key. For more information, see
// Using Your Own Keys for Server-Side Encryption (https://docs.cloud.oracle.com/Content/Object/Tasks/usingyourencryptionkeys.htm).
OpcSseCustomerKeySha256 *string `mandatory:"false" contributesTo:"header" name:"opc-sse-customer-key-sha256"`
// The OCID (https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm) of a master encryption key used to call the Key
// Management service to generate a data encryption key or to encrypt or decrypt a data encryption key.
OpcSseKmsKeyId *string `mandatory:"false" contributesTo:"header" name:"opc-sse-kms-key-id"`
// The storage tier that the object should be stored in. If not specified, the object will be stored in
// the same storage tier as the bucket.
StorageTier PutObjectStorageTierEnum `mandatory:"false" contributesTo:"header" name:"storage-tier"`
// Optional user-defined metadata key and value.
OpcMeta map[string]string `mandatory:"false" contributesTo:"header-collection" prefix:"opc-meta-"`
// Metadata about the request. This information will not be transmitted to the service, but
// represents information that the SDK will consume to drive retry behavior.
RequestMetadata common.RequestMetadata
}
func (request PutObjectRequest) String() string {
return common.PointerString(request)
}
// HTTPRequest implements the OCIRequest interface
func (request PutObjectRequest) HTTPRequest(method, path string, binaryRequestBody *common.OCIReadSeekCloser, extraHeaders map[string]string) (http.Request, error) {
httpRequest, err := common.MakeDefaultHTTPRequestWithTaggedStructAndExtraHeaders(method, path, request, extraHeaders)
if err == nil && binaryRequestBody.Seekable() {
common.UpdateRequestBinaryBody(&httpRequest, binaryRequestBody)
}
return httpRequest, err
}
// BinaryRequestBody implements the OCIRequest interface
func (request PutObjectRequest) BinaryRequestBody() (*common.OCIReadSeekCloser, bool) {
rsc := common.NewOCIReadSeekCloser(request.PutObjectBody)
if rsc.Seekable() {
return rsc, true
}
return nil, true
}
// ReplaceMandatoryParamInPath replaces the mandatory parameter in the path with the value provided.
// Not all services are supporting this feature and this method will be a no-op for those services.
func (request PutObjectRequest) ReplaceMandatoryParamInPath(client *common.BaseClient, mandatoryParamMap map[string][]common.TemplateParamForPerRealmEndpoint) {
if mandatoryParamMap["namespaceName"] != nil {
templateParam := mandatoryParamMap["namespaceName"]
for _, template := range templateParam {
replacementParam := *request.NamespaceName
if template.EndsWithDot {
replacementParam = replacementParam + "."
}
client.Host = strings.Replace(client.Host, template.Template, replacementParam, -1)
}
}
if mandatoryParamMap["bucketName"] != nil {
templateParam := mandatoryParamMap["bucketName"]
for _, template := range templateParam {
replacementParam := *request.BucketName
if template.EndsWithDot {
replacementParam = replacementParam + "."
}
client.Host = strings.Replace(client.Host, template.Template, replacementParam, -1)
}
}
if mandatoryParamMap["objectName"] != nil {
templateParam := mandatoryParamMap["objectName"]
for _, template := range templateParam {
replacementParam := *request.ObjectName
if template.EndsWithDot {
replacementParam = replacementParam + "."
}
client.Host = strings.Replace(client.Host, template.Template, replacementParam, -1)
}
}
}
// RetryPolicy implements the OCIRetryableRequest interface. This retrieves the specified retry policy.
func (request PutObjectRequest) RetryPolicy() *common.RetryPolicy {
return request.RequestMetadata.RetryPolicy
}
// ValidateEnumValue returns an error when providing an unsupported enum value
// This function is being called during constructing API request process
// Not recommended for calling this function directly
func (request PutObjectRequest) ValidateEnumValue() (bool, error) {
errMessage := []string{}
if _, ok := GetMappingPutObjectStorageTierEnum(string(request.StorageTier)); !ok && request.StorageTier != "" {
errMessage = append(errMessage, fmt.Sprintf("unsupported enum value for StorageTier: %s. Supported values are: %s.", request.StorageTier, strings.Join(GetPutObjectStorageTierEnumStringValues(), ",")))
}
if len(errMessage) > 0 {
return true, fmt.Errorf(strings.Join(errMessage, "\n"))
}
return false, nil
}
// PutObjectResponse wrapper for the PutObject operation
type PutObjectResponse struct {
// The underlying http response
RawResponse *http.Response
// Echoes back the value passed in the opc-client-request-id header, for use by clients when debugging.
OpcClientRequestId *string `presentIn:"header" name:"opc-client-request-id"`
// Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular
// request, provide this request ID.
OpcRequestId *string `presentIn:"header" name:"opc-request-id"`
// The base-64 encoded MD5 hash of the request body as computed by the server.
OpcContentMd5 *string `presentIn:"header" name:"opc-content-md5"`
// The entity tag (ETag) for the object.
ETag *string `presentIn:"header" name:"etag"`
// The time the object was modified, as described in RFC 2616 (https://tools.ietf.org/html/rfc2616#section-14.29).
LastModified *common.SDKTime `presentIn:"header" name:"last-modified"`
// VersionId of the newly created object
VersionId *string `presentIn:"header" name:"version-id"`
}
func (response PutObjectResponse) String() string {
return common.PointerString(response)
}
// HTTPResponse implements the OCIResponse interface
func (response PutObjectResponse) HTTPResponse() *http.Response {
return response.RawResponse
}
// PutObjectStorageTierEnum Enum with underlying type: string
type PutObjectStorageTierEnum string
// Set of constants representing the allowable values for PutObjectStorageTierEnum
const (
PutObjectStorageTierStandard PutObjectStorageTierEnum = "Standard"
PutObjectStorageTierInfrequentaccess PutObjectStorageTierEnum = "InfrequentAccess"
PutObjectStorageTierArchive PutObjectStorageTierEnum = "Archive"
)
var mappingPutObjectStorageTierEnum = map[string]PutObjectStorageTierEnum{
"Standard": PutObjectStorageTierStandard,
"InfrequentAccess": PutObjectStorageTierInfrequentaccess,
"Archive": PutObjectStorageTierArchive,
}
var mappingPutObjectStorageTierEnumLowerCase = map[string]PutObjectStorageTierEnum{
"standard": PutObjectStorageTierStandard,
"infrequentaccess": PutObjectStorageTierInfrequentaccess,
"archive": PutObjectStorageTierArchive,
}
// GetPutObjectStorageTierEnumValues Enumerates the set of values for PutObjectStorageTierEnum
func GetPutObjectStorageTierEnumValues() []PutObjectStorageTierEnum {
values := make([]PutObjectStorageTierEnum, 0)
for _, v := range mappingPutObjectStorageTierEnum {
values = append(values, v)
}
return values
}
// GetPutObjectStorageTierEnumStringValues Enumerates the set of values in String for PutObjectStorageTierEnum
func GetPutObjectStorageTierEnumStringValues() []string {
return []string{
"Standard",
"InfrequentAccess",
"Archive",
}
}
// GetMappingPutObjectStorageTierEnum performs case Insensitive comparison on enum value and return the desired enum
func GetMappingPutObjectStorageTierEnum(val string) (PutObjectStorageTierEnum, bool) {
enum, ok := mappingPutObjectStorageTierEnumLowerCase[strings.ToLower(val)]
return enum, ok
}