-
Notifications
You must be signed in to change notification settings - Fork 250
/
com.azure.storage.file.share.ShareFileClientBuilder.yml
419 lines (419 loc) · 61.7 KB
/
com.azure.storage.file.share.ShareFileClientBuilder.yml
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
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
### YamlMime:JavaType
uid: "com.azure.storage.file.share.ShareFileClientBuilder"
fullName: "com.azure.storage.file.share.ShareFileClientBuilder"
name: "ShareFileClientBuilder"
nameWithType: "ShareFileClientBuilder"
summary: "This class provides a fluent builder API to help aid the configuration and instantiation of the <xref uid=\"com.azure.storage.file.share.ShareFileClient\" data-throw-if-not-resolved=\"false\" data-raw-source=\"FileClients\"></xref>, <xref uid=\"com.azure.storage.file.share.ShareFileAsyncClient\" data-throw-if-not-resolved=\"false\" data-raw-source=\"FileAsyncClients\"></xref>, <xref uid=\"com.azure.storage.file.share.ShareDirectoryClient\" data-throw-if-not-resolved=\"false\" data-raw-source=\"DirectoryClients\"></xref>, and <xref uid=\"com.azure.storage.file.share.ShareDirectoryAsyncClient\" data-throw-if-not-resolved=\"false\" data-raw-source=\"DirectoryAsyncClients\"></xref>."
inheritances:
- "<xref href=\"java.lang.Object?displayProperty=fullName\" data-throw-if-not-resolved=\"False\" />"
inheritedClassMethods:
- classRef: "java.lang.<a href=\"https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html\">Object</a>"
methodsRef:
- "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#clone--\">clone</a>"
- "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#equals-java.lang.Object-\">equals</a>"
- "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#finalize--\">finalize</a>"
- "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#getClass--\">getClass</a>"
- "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#hashCode--\">hashCode</a>"
- "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#notify--\">notify</a>"
- "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#notifyAll--\">notifyAll</a>"
- "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#toString--\">toString</a>"
- "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#wait--\">wait</a>"
- "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#wait-long-\">wait</a>"
- "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#wait-long-int-\">wait</a>"
syntax: "public class **ShareFileClientBuilder**</br> implements <xref href=\"com.azure.core.client.traits.TokenCredentialTrait?alt=com.azure.core.client.traits.TokenCredentialTrait&text=TokenCredentialTrait\" data-throw-if-not-resolved=\"False\" /><<xref href=\"com.azure.storage.file.share.ShareFileClientBuilder?alt=com.azure.storage.file.share.ShareFileClientBuilder&text=ShareFileClientBuilder\" data-throw-if-not-resolved=\"False\" />>, <xref href=\"com.azure.core.client.traits.HttpTrait?alt=com.azure.core.client.traits.HttpTrait&text=HttpTrait\" data-throw-if-not-resolved=\"False\" /><<xref href=\"com.azure.storage.file.share.ShareFileClientBuilder?alt=com.azure.storage.file.share.ShareFileClientBuilder&text=ShareFileClientBuilder\" data-throw-if-not-resolved=\"False\" />>, <xref href=\"com.azure.core.client.traits.ConnectionStringTrait?alt=com.azure.core.client.traits.ConnectionStringTrait&text=ConnectionStringTrait\" data-throw-if-not-resolved=\"False\" /><<xref href=\"com.azure.storage.file.share.ShareFileClientBuilder?alt=com.azure.storage.file.share.ShareFileClientBuilder&text=ShareFileClientBuilder\" data-throw-if-not-resolved=\"False\" />>, <xref href=\"com.azure.core.client.traits.AzureNamedKeyCredentialTrait?alt=com.azure.core.client.traits.AzureNamedKeyCredentialTrait&text=AzureNamedKeyCredentialTrait\" data-throw-if-not-resolved=\"False\" /><<xref href=\"com.azure.storage.file.share.ShareFileClientBuilder?alt=com.azure.storage.file.share.ShareFileClientBuilder&text=ShareFileClientBuilder\" data-throw-if-not-resolved=\"False\" />>, <xref href=\"com.azure.core.client.traits.AzureSasCredentialTrait?alt=com.azure.core.client.traits.AzureSasCredentialTrait&text=AzureSasCredentialTrait\" data-throw-if-not-resolved=\"False\" /><<xref href=\"com.azure.storage.file.share.ShareFileClientBuilder?alt=com.azure.storage.file.share.ShareFileClientBuilder&text=ShareFileClientBuilder\" data-throw-if-not-resolved=\"False\" />>, <xref href=\"com.azure.core.client.traits.ConfigurationTrait?alt=com.azure.core.client.traits.ConfigurationTrait&text=ConfigurationTrait\" data-throw-if-not-resolved=\"False\" /><<xref href=\"com.azure.storage.file.share.ShareFileClientBuilder?alt=com.azure.storage.file.share.ShareFileClientBuilder&text=ShareFileClientBuilder\" data-throw-if-not-resolved=\"False\" />>, <xref href=\"com.azure.core.client.traits.EndpointTrait?alt=com.azure.core.client.traits.EndpointTrait&text=EndpointTrait\" data-throw-if-not-resolved=\"False\" /><<xref href=\"com.azure.storage.file.share.ShareFileClientBuilder?alt=com.azure.storage.file.share.ShareFileClientBuilder&text=ShareFileClientBuilder\" data-throw-if-not-resolved=\"False\" />>"
constructors:
- uid: "com.azure.storage.file.share.ShareFileClientBuilder.ShareFileClientBuilder()"
fullName: "com.azure.storage.file.share.ShareFileClientBuilder.ShareFileClientBuilder()"
name: "ShareFileClientBuilder()"
nameWithType: "ShareFileClientBuilder.ShareFileClientBuilder()"
summary: "Creates a builder instance that is able to configure and construct <xref uid=\"com.azure.storage.file.share.ShareFileClient\" data-throw-if-not-resolved=\"false\" data-raw-source=\"FileClients\"></xref> and <xref uid=\"com.azure.storage.file.share.ShareFileAsyncClient\" data-throw-if-not-resolved=\"false\" data-raw-source=\"FileAsyncClients\"></xref>."
syntax: "public ShareFileClientBuilder()"
desc: "Creates a builder instance that is able to configure and construct <xref uid=\"com.azure.storage.file.share.ShareFileClient\" data-throw-if-not-resolved=\"false\" data-raw-source=\"FileClients\"></xref> and <xref uid=\"com.azure.storage.file.share.ShareFileAsyncClient\" data-throw-if-not-resolved=\"false\" data-raw-source=\"FileAsyncClients\"></xref>."
methods:
- uid: "com.azure.storage.file.share.ShareFileClientBuilder.addPolicy(com.azure.core.http.policy.HttpPipelinePolicy)"
fullName: "com.azure.storage.file.share.ShareFileClientBuilder.addPolicy(HttpPipelinePolicy pipelinePolicy)"
name: "addPolicy(HttpPipelinePolicy pipelinePolicy)"
nameWithType: "ShareFileClientBuilder.addPolicy(HttpPipelinePolicy pipelinePolicy)"
summary: "Adds a <xref uid=\"com.azure.core.http.policy.HttpPipelinePolicy\" data-throw-if-not-resolved=\"false\" data-raw-source=\"pipeline policy\"></xref> to apply on each request sent."
parameters:
- description: "A <xref uid=\"com.azure.core.http.policy.HttpPipelinePolicy\" data-throw-if-not-resolved=\"false\" data-raw-source=\"pipeline policy\"></xref>."
name: "pipelinePolicy"
type: "<xref href=\"com.azure.core.http.policy.HttpPipelinePolicy?alt=com.azure.core.http.policy.HttpPipelinePolicy&text=HttpPipelinePolicy\" data-throw-if-not-resolved=\"False\" />"
syntax: "public ShareFileClientBuilder addPolicy(HttpPipelinePolicy pipelinePolicy)"
desc: "Adds a <xref uid=\"com.azure.core.http.policy.HttpPipelinePolicy\" data-throw-if-not-resolved=\"false\" data-raw-source=\"pipeline policy\"></xref> to apply on each request sent.\n\n**Note:** It is important to understand the precedence order of the HttpTrait APIs. In particular, if a <xref uid=\"com.azure.core.http.HttpPipeline\" data-throw-if-not-resolved=\"false\" data-raw-source=\"HttpPipeline\"></xref> is specified, this takes precedence over all other APIs in the trait, and they will be ignored. If no <xref uid=\"com.azure.core.http.HttpPipeline\" data-throw-if-not-resolved=\"false\" data-raw-source=\"HttpPipeline\"></xref> is specified, a HTTP pipeline will be constructed internally based on the settings provided to this trait. Additionally, there may be other APIs in types that implement this trait that are also ignored if an <xref uid=\"com.azure.core.http.HttpPipeline\" data-throw-if-not-resolved=\"false\" data-raw-source=\"HttpPipeline\"></xref> is specified, so please be sure to refer to the documentation of types that implement this trait to understand the full set of implications."
returns:
description: "the updated ShareFileClientBuilder object"
type: "<xref href=\"com.azure.storage.file.share.ShareFileClientBuilder?alt=com.azure.storage.file.share.ShareFileClientBuilder&text=ShareFileClientBuilder\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.storage.file.share.ShareFileClientBuilder.allowSourceTrailingDot(boolean)"
fullName: "com.azure.storage.file.share.ShareFileClientBuilder.allowSourceTrailingDot(boolean allowSourceTrailingDot)"
name: "allowSourceTrailingDot(boolean allowSourceTrailingDot)"
nameWithType: "ShareFileClientBuilder.allowSourceTrailingDot(boolean allowSourceTrailingDot)"
summary: "Set the trailing dot property to specify whether trailing dot will be trimmed or not from the source URI."
parameters:
- description: "the allowSourceTrailingDot value."
name: "allowSourceTrailingDot"
type: "<xref href=\"boolean?alt=boolean&text=boolean\" data-throw-if-not-resolved=\"False\" />"
syntax: "public ShareFileClientBuilder allowSourceTrailingDot(boolean allowSourceTrailingDot)"
desc: "Set the trailing dot property to specify whether trailing dot will be trimmed or not from the source URI. If set to true, trailing dot (.) will be allowed to suffix directory and file names. If false, the trailing dot will be trimmed. Supported by x-ms-version 2022-11-02 and above."
returns:
description: "the updated ShareFileClientBuilder object"
type: "<xref href=\"com.azure.storage.file.share.ShareFileClientBuilder?alt=com.azure.storage.file.share.ShareFileClientBuilder&text=ShareFileClientBuilder\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.storage.file.share.ShareFileClientBuilder.allowTrailingDot(boolean)"
fullName: "com.azure.storage.file.share.ShareFileClientBuilder.allowTrailingDot(boolean allowTrailingDot)"
name: "allowTrailingDot(boolean allowTrailingDot)"
nameWithType: "ShareFileClientBuilder.allowTrailingDot(boolean allowTrailingDot)"
summary: "Set the trailing dot property to specify whether trailing dot will be trimmed or not from the target URI."
parameters:
- description: "the allowTrailingDot value."
name: "allowTrailingDot"
type: "<xref href=\"boolean?alt=boolean&text=boolean\" data-throw-if-not-resolved=\"False\" />"
syntax: "public ShareFileClientBuilder allowTrailingDot(boolean allowTrailingDot)"
desc: "Set the trailing dot property to specify whether trailing dot will be trimmed or not from the target URI. If set to true, trailing dot (.) will be allowed to suffix directory and file names. If false, the trailing dot will be trimmed. Supported by x-ms-version 2022-11-02 and above."
returns:
description: "the updated ShareFileClientBuilder object"
type: "<xref href=\"com.azure.storage.file.share.ShareFileClientBuilder?alt=com.azure.storage.file.share.ShareFileClientBuilder&text=ShareFileClientBuilder\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.storage.file.share.ShareFileClientBuilder.audience(com.azure.storage.file.share.models.ShareAudience)"
fullName: "com.azure.storage.file.share.ShareFileClientBuilder.audience(ShareAudience audience)"
name: "audience(ShareAudience audience)"
nameWithType: "ShareFileClientBuilder.audience(ShareAudience audience)"
summary: "Sets the Audience to use for authentication with Azure Active Directory (AAD)."
parameters:
- description: "<xref uid=\"com.azure.storage.file.share.models.ShareAudience\" data-throw-if-not-resolved=\"false\" data-raw-source=\"ShareAudience\"></xref> to be used when requesting a token from Azure Active Directory (AAD)."
name: "audience"
type: "<xref href=\"com.azure.storage.file.share.models.ShareAudience?alt=com.azure.storage.file.share.models.ShareAudience&text=ShareAudience\" data-throw-if-not-resolved=\"False\" />"
syntax: "public ShareFileClientBuilder audience(ShareAudience audience)"
desc: "Sets the Audience to use for authentication with Azure Active Directory (AAD). The audience is not considered when using a shared key."
returns:
description: "the updated ShareFileClientBuilder object"
type: "<xref href=\"com.azure.storage.file.share.ShareFileClientBuilder?alt=com.azure.storage.file.share.ShareFileClientBuilder&text=ShareFileClientBuilder\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.storage.file.share.ShareFileClientBuilder.buildDirectoryAsyncClient()"
fullName: "com.azure.storage.file.share.ShareFileClientBuilder.buildDirectoryAsyncClient()"
name: "buildDirectoryAsyncClient()"
nameWithType: "ShareFileClientBuilder.buildDirectoryAsyncClient()"
summary: "Creates a <xref uid=\"com.azure.storage.file.share.ShareDirectoryAsyncClient\" data-throw-if-not-resolved=\"false\" data-raw-source=\"ShareDirectoryAsyncClient\"></xref> based on options set in the builder."
syntax: "public ShareDirectoryAsyncClient buildDirectoryAsyncClient()"
desc: "Creates a <xref uid=\"com.azure.storage.file.share.ShareDirectoryAsyncClient\" data-throw-if-not-resolved=\"false\" data-raw-source=\"ShareDirectoryAsyncClient\"></xref> based on options set in the builder. Every time `buildFileAsyncClient()` is called a new instance of <xref uid=\"com.azure.storage.file.share.ShareDirectoryAsyncClient\" data-throw-if-not-resolved=\"false\" data-raw-source=\"ShareDirectoryAsyncClient\"></xref> is created.\n\nIf <xref uid=\"com.azure.storage.file.share.ShareFileClientBuilder.pipeline(com.azure.core.http.HttpPipeline)\" data-throw-if-not-resolved=\"false\" data-raw-source=\"pipeline\"></xref> is set, then the `pipeline` and <xref uid=\"com.azure.storage.file.share.ShareFileClientBuilder.endpoint(java.lang.String)\" data-throw-if-not-resolved=\"false\" data-raw-source=\"endpoint\"></xref> are used to create the <xref uid=\"com.azure.storage.file.share.ShareDirectoryAsyncClient\" data-throw-if-not-resolved=\"false\" data-raw-source=\"client\"></xref>. All other builder settings are ignored."
returns:
description: "A ShareAsyncClient with the options set from the builder."
type: "<xref href=\"com.azure.storage.file.share.ShareDirectoryAsyncClient?alt=com.azure.storage.file.share.ShareDirectoryAsyncClient&text=ShareDirectoryAsyncClient\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.storage.file.share.ShareFileClientBuilder.buildDirectoryClient()"
fullName: "com.azure.storage.file.share.ShareFileClientBuilder.buildDirectoryClient()"
name: "buildDirectoryClient()"
nameWithType: "ShareFileClientBuilder.buildDirectoryClient()"
summary: "Creates a <xref uid=\"com.azure.storage.file.share.ShareDirectoryClient\" data-throw-if-not-resolved=\"false\" data-raw-source=\"ShareDirectoryClient\"></xref> based on options set in the builder."
syntax: "public ShareDirectoryClient buildDirectoryClient()"
desc: "Creates a <xref uid=\"com.azure.storage.file.share.ShareDirectoryClient\" data-throw-if-not-resolved=\"false\" data-raw-source=\"ShareDirectoryClient\"></xref> based on options set in the builder. Every time `buildDirectoryClient()` is called a new instance of <xref uid=\"com.azure.storage.file.share.ShareDirectoryClient\" data-throw-if-not-resolved=\"false\" data-raw-source=\"ShareDirectoryClient\"></xref> is created.\n\nIf <xref uid=\"com.azure.storage.file.share.ShareFileClientBuilder.pipeline(com.azure.core.http.HttpPipeline)\" data-throw-if-not-resolved=\"false\" data-raw-source=\"pipeline\"></xref> is set, then the `pipeline` and <xref uid=\"com.azure.storage.file.share.ShareFileClientBuilder.endpoint(java.lang.String)\" data-throw-if-not-resolved=\"false\" data-raw-source=\"endpoint\"></xref> are used to create the <xref uid=\"com.azure.storage.file.share.ShareDirectoryClient\" data-throw-if-not-resolved=\"false\" data-raw-source=\"client\"></xref>. All other builder settings are ignored."
returns:
description: "A ShareDirectoryClient with the options set from the builder."
type: "<xref href=\"com.azure.storage.file.share.ShareDirectoryClient?alt=com.azure.storage.file.share.ShareDirectoryClient&text=ShareDirectoryClient\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.storage.file.share.ShareFileClientBuilder.buildFileAsyncClient()"
fullName: "com.azure.storage.file.share.ShareFileClientBuilder.buildFileAsyncClient()"
name: "buildFileAsyncClient()"
nameWithType: "ShareFileClientBuilder.buildFileAsyncClient()"
summary: "Creates a <xref uid=\"com.azure.storage.file.share.ShareFileAsyncClient\" data-throw-if-not-resolved=\"false\" data-raw-source=\"ShareFileAsyncClient\"></xref> based on options set in the builder."
syntax: "public ShareFileAsyncClient buildFileAsyncClient()"
desc: "Creates a <xref uid=\"com.azure.storage.file.share.ShareFileAsyncClient\" data-throw-if-not-resolved=\"false\" data-raw-source=\"ShareFileAsyncClient\"></xref> based on options set in the builder. Every time `buildFileAsyncClient()` is called a new instance of <xref uid=\"com.azure.storage.file.share.ShareFileAsyncClient\" data-throw-if-not-resolved=\"false\" data-raw-source=\"ShareFileAsyncClient\"></xref> is created.\n\nIf <xref uid=\"com.azure.storage.file.share.ShareFileClientBuilder.pipeline(com.azure.core.http.HttpPipeline)\" data-throw-if-not-resolved=\"false\" data-raw-source=\"pipeline\"></xref> is set, then the `pipeline` and <xref uid=\"com.azure.storage.file.share.ShareFileClientBuilder.endpoint(java.lang.String)\" data-throw-if-not-resolved=\"false\" data-raw-source=\"endpoint\"></xref> are used to create the <xref uid=\"com.azure.storage.file.share.ShareFileAsyncClient\" data-throw-if-not-resolved=\"false\" data-raw-source=\"client\"></xref>. All other builder settings are ignored."
returns:
description: "A ShareAsyncClient with the options set from the builder."
type: "<xref href=\"com.azure.storage.file.share.ShareFileAsyncClient?alt=com.azure.storage.file.share.ShareFileAsyncClient&text=ShareFileAsyncClient\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.storage.file.share.ShareFileClientBuilder.buildFileClient()"
fullName: "com.azure.storage.file.share.ShareFileClientBuilder.buildFileClient()"
name: "buildFileClient()"
nameWithType: "ShareFileClientBuilder.buildFileClient()"
summary: "Creates a <xref uid=\"com.azure.storage.file.share.ShareFileClient\" data-throw-if-not-resolved=\"false\" data-raw-source=\"ShareFileClient\"></xref> based on options set in the builder."
syntax: "public ShareFileClient buildFileClient()"
desc: "Creates a <xref uid=\"com.azure.storage.file.share.ShareFileClient\" data-throw-if-not-resolved=\"false\" data-raw-source=\"ShareFileClient\"></xref> based on options set in the builder. Every time `buildFileClient()` is called a new instance of <xref uid=\"com.azure.storage.file.share.ShareFileClient\" data-throw-if-not-resolved=\"false\" data-raw-source=\"ShareFileClient\"></xref> is created.\n\nIf <xref uid=\"com.azure.storage.file.share.ShareFileClientBuilder.pipeline(com.azure.core.http.HttpPipeline)\" data-throw-if-not-resolved=\"false\" data-raw-source=\"pipeline\"></xref> is set, then the `pipeline` and <xref uid=\"com.azure.storage.file.share.ShareFileClientBuilder.endpoint(java.lang.String)\" data-throw-if-not-resolved=\"false\" data-raw-source=\"endpoint\"></xref> are used to create the <xref uid=\"com.azure.storage.file.share.ShareFileClient\" data-throw-if-not-resolved=\"false\" data-raw-source=\"client\"></xref>. All other builder settings are ignored."
returns:
description: "A ShareFileClient with the options set from the builder."
type: "<xref href=\"com.azure.storage.file.share.ShareFileClient?alt=com.azure.storage.file.share.ShareFileClient&text=ShareFileClient\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.storage.file.share.ShareFileClientBuilder.clientOptions(com.azure.core.util.ClientOptions)"
fullName: "com.azure.storage.file.share.ShareFileClientBuilder.clientOptions(ClientOptions clientOptions)"
name: "clientOptions(ClientOptions clientOptions)"
nameWithType: "ShareFileClientBuilder.clientOptions(ClientOptions clientOptions)"
summary: "Allows for setting common properties such as application ID, headers, proxy configuration, etc."
parameters:
- description: "A configured instance of <xref uid=\"\" data-throw-if-not-resolved=\"false\" data-raw-source=\"HttpClientOptions\"></xref>."
name: "clientOptions"
type: "<xref href=\"com.azure.core.util.ClientOptions?alt=com.azure.core.util.ClientOptions&text=ClientOptions\" data-throw-if-not-resolved=\"False\" />"
syntax: "public ShareFileClientBuilder clientOptions(ClientOptions clientOptions)"
desc: "Allows for setting common properties such as application ID, headers, proxy configuration, etc. Note that it is recommended that this method be called with an instance of the <xref uid=\"\" data-throw-if-not-resolved=\"false\" data-raw-source=\"HttpClientOptions\"></xref> class (a subclass of the <xref uid=\"com.azure.core.util.ClientOptions\" data-throw-if-not-resolved=\"false\" data-raw-source=\"ClientOptions\"></xref> base class). The HttpClientOptions subclass provides more configuration options suitable for HTTP clients, which is applicable for any class that implements this HttpTrait interface.\n\n**Note:** It is important to understand the precedence order of the HttpTrait APIs. In particular, if a <xref uid=\"com.azure.core.http.HttpPipeline\" data-throw-if-not-resolved=\"false\" data-raw-source=\"HttpPipeline\"></xref> is specified, this takes precedence over all other APIs in the trait, and they will be ignored. If no <xref uid=\"com.azure.core.http.HttpPipeline\" data-throw-if-not-resolved=\"false\" data-raw-source=\"HttpPipeline\"></xref> is specified, a HTTP pipeline will be constructed internally based on the settings provided to this trait. Additionally, there may be other APIs in types that implement this trait that are also ignored if an <xref uid=\"com.azure.core.http.HttpPipeline\" data-throw-if-not-resolved=\"false\" data-raw-source=\"HttpPipeline\"></xref> is specified, so please be sure to refer to the documentation of types that implement this trait to understand the full set of implications."
returns:
description: "the updated ShareFileClientBuilder object"
type: "<xref href=\"com.azure.storage.file.share.ShareFileClientBuilder?alt=com.azure.storage.file.share.ShareFileClientBuilder&text=ShareFileClientBuilder\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.storage.file.share.ShareFileClientBuilder.configuration(com.azure.core.util.Configuration)"
fullName: "com.azure.storage.file.share.ShareFileClientBuilder.configuration(Configuration configuration)"
name: "configuration(Configuration configuration)"
nameWithType: "ShareFileClientBuilder.configuration(Configuration configuration)"
summary: "Sets the configuration object used to retrieve environment configuration values during building of the client."
parameters:
- description: "Configuration store used to retrieve environment configurations."
name: "configuration"
type: "<xref href=\"com.azure.core.util.Configuration?alt=com.azure.core.util.Configuration&text=Configuration\" data-throw-if-not-resolved=\"False\" />"
syntax: "public ShareFileClientBuilder configuration(Configuration configuration)"
desc: "Sets the configuration object used to retrieve environment configuration values during building of the client."
returns:
description: "the updated ShareFileClientBuilder object"
type: "<xref href=\"com.azure.storage.file.share.ShareFileClientBuilder?alt=com.azure.storage.file.share.ShareFileClientBuilder&text=ShareFileClientBuilder\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.storage.file.share.ShareFileClientBuilder.connectionString(java.lang.String)"
fullName: "com.azure.storage.file.share.ShareFileClientBuilder.connectionString(String connectionString)"
name: "connectionString(String connectionString)"
nameWithType: "ShareFileClientBuilder.connectionString(String connectionString)"
summary: "Sets the connection string to connect to the service."
parameters:
- description: "Connection string of the storage account."
name: "connectionString"
type: "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/lang/String.html\">String</a>"
syntax: "public ShareFileClientBuilder connectionString(String connectionString)"
desc: "Sets the connection string to connect to the service."
returns:
description: "the updated ShareFileClientBuilder"
type: "<xref href=\"com.azure.storage.file.share.ShareFileClientBuilder?alt=com.azure.storage.file.share.ShareFileClientBuilder&text=ShareFileClientBuilder\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.storage.file.share.ShareFileClientBuilder.credential(com.azure.core.credential.AzureNamedKeyCredential)"
fullName: "com.azure.storage.file.share.ShareFileClientBuilder.credential(AzureNamedKeyCredential credential)"
name: "credential(AzureNamedKeyCredential credential)"
nameWithType: "ShareFileClientBuilder.credential(AzureNamedKeyCredential credential)"
summary: "Sets the <xref uid=\"com.azure.core.credential.AzureNamedKeyCredential\" data-throw-if-not-resolved=\"false\" data-raw-source=\"AzureNamedKeyCredential\"></xref> used to authorize requests sent to the service."
parameters:
- description: "<xref uid=\"com.azure.core.credential.AzureNamedKeyCredential\" data-throw-if-not-resolved=\"false\" data-raw-source=\"AzureNamedKeyCredential\"></xref>."
name: "credential"
type: "<xref href=\"com.azure.core.credential.AzureNamedKeyCredential?alt=com.azure.core.credential.AzureNamedKeyCredential&text=AzureNamedKeyCredential\" data-throw-if-not-resolved=\"False\" />"
syntax: "public ShareFileClientBuilder credential(AzureNamedKeyCredential credential)"
desc: "Sets the <xref uid=\"com.azure.core.credential.AzureNamedKeyCredential\" data-throw-if-not-resolved=\"false\" data-raw-source=\"AzureNamedKeyCredential\"></xref> used to authorize requests sent to the service."
returns:
description: "the updated ShareFileClientBuilder"
type: "<xref href=\"com.azure.storage.file.share.ShareFileClientBuilder?alt=com.azure.storage.file.share.ShareFileClientBuilder&text=ShareFileClientBuilder\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.storage.file.share.ShareFileClientBuilder.credential(com.azure.core.credential.AzureSasCredential)"
fullName: "com.azure.storage.file.share.ShareFileClientBuilder.credential(AzureSasCredential credential)"
name: "credential(AzureSasCredential credential)"
nameWithType: "ShareFileClientBuilder.credential(AzureSasCredential credential)"
summary: "Sets the <xref uid=\"com.azure.core.credential.AzureSasCredential\" data-throw-if-not-resolved=\"false\" data-raw-source=\"AzureSasCredential\"></xref> used to authorize requests sent to the service."
parameters:
- description: "<xref uid=\"com.azure.core.credential.AzureSasCredential\" data-throw-if-not-resolved=\"false\" data-raw-source=\"AzureSasCredential\"></xref> used to authorize requests sent to the service."
name: "credential"
type: "<xref href=\"com.azure.core.credential.AzureSasCredential?alt=com.azure.core.credential.AzureSasCredential&text=AzureSasCredential\" data-throw-if-not-resolved=\"False\" />"
syntax: "public ShareFileClientBuilder credential(AzureSasCredential credential)"
desc: "Sets the <xref uid=\"com.azure.core.credential.AzureSasCredential\" data-throw-if-not-resolved=\"false\" data-raw-source=\"AzureSasCredential\"></xref> used to authorize requests sent to the service."
returns:
description: "the updated ShareFileClientBuilder"
type: "<xref href=\"com.azure.storage.file.share.ShareFileClientBuilder?alt=com.azure.storage.file.share.ShareFileClientBuilder&text=ShareFileClientBuilder\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.storage.file.share.ShareFileClientBuilder.credential(com.azure.core.credential.TokenCredential)"
fullName: "com.azure.storage.file.share.ShareFileClientBuilder.credential(TokenCredential tokenCredential)"
name: "credential(TokenCredential tokenCredential)"
nameWithType: "ShareFileClientBuilder.credential(TokenCredential tokenCredential)"
summary: "Sets the <xref uid=\"com.azure.core.credential.TokenCredential\" data-throw-if-not-resolved=\"false\" data-raw-source=\"TokenCredential\"></xref> used to authorize requests sent to the service."
parameters:
- description: "<xref uid=\"com.azure.core.credential.TokenCredential\" data-throw-if-not-resolved=\"false\" data-raw-source=\"TokenCredential\"></xref> used to authorize requests sent to the service."
name: "tokenCredential"
type: "<xref href=\"com.azure.core.credential.TokenCredential?alt=com.azure.core.credential.TokenCredential&text=TokenCredential\" data-throw-if-not-resolved=\"False\" />"
syntax: "public ShareFileClientBuilder credential(TokenCredential tokenCredential)"
desc: "Sets the <xref uid=\"com.azure.core.credential.TokenCredential\" data-throw-if-not-resolved=\"false\" data-raw-source=\"TokenCredential\"></xref> used to authorize requests sent to the service. Refer to the Azure SDK for Java [identity and authentication][] documentation for more details on proper usage of the <xref uid=\"com.azure.core.credential.TokenCredential\" data-throw-if-not-resolved=\"false\" data-raw-source=\"TokenCredential\"></xref> type.\n\n\n[identity and authentication]: https://aka.ms/azsdk/java/docs/identity"
returns:
description: "the updated ShareFileClientBuilder"
type: "<xref href=\"com.azure.storage.file.share.ShareFileClientBuilder?alt=com.azure.storage.file.share.ShareFileClientBuilder&text=ShareFileClientBuilder\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.storage.file.share.ShareFileClientBuilder.credential(com.azure.storage.common.StorageSharedKeyCredential)"
fullName: "com.azure.storage.file.share.ShareFileClientBuilder.credential(StorageSharedKeyCredential credential)"
name: "credential(StorageSharedKeyCredential credential)"
nameWithType: "ShareFileClientBuilder.credential(StorageSharedKeyCredential credential)"
summary: "Sets the <xref uid=\"com.azure.storage.common.StorageSharedKeyCredential\" data-throw-if-not-resolved=\"false\" data-raw-source=\"StorageSharedKeyCredential\"></xref> used to authorize requests sent to the service."
parameters:
- description: "<xref uid=\"com.azure.storage.common.StorageSharedKeyCredential\" data-throw-if-not-resolved=\"false\" data-raw-source=\"StorageSharedKeyCredential\"></xref>."
name: "credential"
type: "<xref href=\"com.azure.storage.common.StorageSharedKeyCredential?alt=com.azure.storage.common.StorageSharedKeyCredential&text=StorageSharedKeyCredential\" data-throw-if-not-resolved=\"False\" />"
syntax: "public ShareFileClientBuilder credential(StorageSharedKeyCredential credential)"
desc: "Sets the <xref uid=\"com.azure.storage.common.StorageSharedKeyCredential\" data-throw-if-not-resolved=\"false\" data-raw-source=\"StorageSharedKeyCredential\"></xref> used to authorize requests sent to the service."
returns:
description: "the updated ShareFileClientBuilder"
type: "<xref href=\"com.azure.storage.file.share.ShareFileClientBuilder?alt=com.azure.storage.file.share.ShareFileClientBuilder&text=ShareFileClientBuilder\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.storage.file.share.ShareFileClientBuilder.endpoint(java.lang.String)"
fullName: "com.azure.storage.file.share.ShareFileClientBuilder.endpoint(String endpoint)"
name: "endpoint(String endpoint)"
nameWithType: "ShareFileClientBuilder.endpoint(String endpoint)"
summary: "Sets the endpoint for the Azure Storage File instance that the client will interact with."
parameters:
- description: "The URL of the Azure Storage File instance to send service requests to and receive responses\n from."
name: "endpoint"
type: "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/lang/String.html\">String</a>"
syntax: "public ShareFileClientBuilder endpoint(String endpoint)"
desc: "Sets the endpoint for the Azure Storage File instance that the client will interact with.\n\nThe first path segment, if the endpoint contains path segments, will be assumed to be the name of the share that the client will interact with. Rest of the path segments should be the path of the file. It mush end up with the file name if more segments exist.\n\nQuery parameters of the endpoint will be parsed in an attempt to generate a SAS token to authenticate requests sent to the service."
returns:
description: "the updated ShareFileClientBuilder object"
type: "<xref href=\"com.azure.storage.file.share.ShareFileClientBuilder?alt=com.azure.storage.file.share.ShareFileClientBuilder&text=ShareFileClientBuilder\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.storage.file.share.ShareFileClientBuilder.getDefaultHttpLogOptions()"
fullName: "com.azure.storage.file.share.ShareFileClientBuilder.getDefaultHttpLogOptions()"
name: "getDefaultHttpLogOptions()"
nameWithType: "ShareFileClientBuilder.getDefaultHttpLogOptions()"
summary: "Gets the default log options with Storage headers and query parameters."
modifiers:
- "static"
syntax: "public static HttpLogOptions getDefaultHttpLogOptions()"
desc: "Gets the default log options with Storage headers and query parameters."
returns:
description: "the default log options."
type: "<xref href=\"com.azure.core.http.policy.HttpLogOptions?alt=com.azure.core.http.policy.HttpLogOptions&text=HttpLogOptions\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.storage.file.share.ShareFileClientBuilder.httpClient(com.azure.core.http.HttpClient)"
fullName: "com.azure.storage.file.share.ShareFileClientBuilder.httpClient(HttpClient httpClient)"
name: "httpClient(HttpClient httpClient)"
nameWithType: "ShareFileClientBuilder.httpClient(HttpClient httpClient)"
summary: "Sets the <xref uid=\"com.azure.core.http.HttpClient\" data-throw-if-not-resolved=\"false\" data-raw-source=\"HttpClient\"></xref> to use for sending and receiving requests to and from the service."
parameters:
- description: "The <xref uid=\"com.azure.core.http.HttpClient\" data-throw-if-not-resolved=\"false\" data-raw-source=\"HttpClient\"></xref> to use for requests."
name: "httpClient"
type: "<xref href=\"com.azure.core.http.HttpClient?alt=com.azure.core.http.HttpClient&text=HttpClient\" data-throw-if-not-resolved=\"False\" />"
syntax: "public ShareFileClientBuilder httpClient(HttpClient httpClient)"
desc: "Sets the <xref uid=\"com.azure.core.http.HttpClient\" data-throw-if-not-resolved=\"false\" data-raw-source=\"HttpClient\"></xref> to use for sending and receiving requests to and from the service.\n\n**Note:** It is important to understand the precedence order of the HttpTrait APIs. In particular, if a <xref uid=\"com.azure.core.http.HttpPipeline\" data-throw-if-not-resolved=\"false\" data-raw-source=\"HttpPipeline\"></xref> is specified, this takes precedence over all other APIs in the trait, and they will be ignored. If no <xref uid=\"com.azure.core.http.HttpPipeline\" data-throw-if-not-resolved=\"false\" data-raw-source=\"HttpPipeline\"></xref> is specified, a HTTP pipeline will be constructed internally based on the settings provided to this trait. Additionally, there may be other APIs in types that implement this trait that are also ignored if an <xref uid=\"com.azure.core.http.HttpPipeline\" data-throw-if-not-resolved=\"false\" data-raw-source=\"HttpPipeline\"></xref> is specified, so please be sure to refer to the documentation of types that implement this trait to understand the full set of implications."
returns:
description: "the updated ShareFileClientBuilder object"
type: "<xref href=\"com.azure.storage.file.share.ShareFileClientBuilder?alt=com.azure.storage.file.share.ShareFileClientBuilder&text=ShareFileClientBuilder\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.storage.file.share.ShareFileClientBuilder.httpLogOptions(com.azure.core.http.policy.HttpLogOptions)"
fullName: "com.azure.storage.file.share.ShareFileClientBuilder.httpLogOptions(HttpLogOptions logOptions)"
name: "httpLogOptions(HttpLogOptions logOptions)"
nameWithType: "ShareFileClientBuilder.httpLogOptions(HttpLogOptions logOptions)"
summary: "Sets the <xref uid=\"com.azure.core.http.policy.HttpLogOptions\" data-throw-if-not-resolved=\"false\" data-raw-source=\"logging configuration\"></xref> to use when sending and receiving requests to and from the service."
parameters:
- description: "The <xref uid=\"com.azure.core.http.policy.HttpLogOptions\" data-throw-if-not-resolved=\"false\" data-raw-source=\"logging configuration\"></xref> to use when sending and receiving requests to\n and from the service."
name: "logOptions"
type: "<xref href=\"com.azure.core.http.policy.HttpLogOptions?alt=com.azure.core.http.policy.HttpLogOptions&text=HttpLogOptions\" data-throw-if-not-resolved=\"False\" />"
syntax: "public ShareFileClientBuilder httpLogOptions(HttpLogOptions logOptions)"
desc: "Sets the <xref uid=\"com.azure.core.http.policy.HttpLogOptions\" data-throw-if-not-resolved=\"false\" data-raw-source=\"logging configuration\"></xref> to use when sending and receiving requests to and from the service. If a `logLevel` is not provided, default value of <xref uid=\"\" data-throw-if-not-resolved=\"false\" data-raw-source=\"HttpLogDetailLevel#NONE\"></xref> is set.\n\n**Note:** It is important to understand the precedence order of the HttpTrait APIs. In particular, if a <xref uid=\"com.azure.core.http.HttpPipeline\" data-throw-if-not-resolved=\"false\" data-raw-source=\"HttpPipeline\"></xref> is specified, this takes precedence over all other APIs in the trait, and they will be ignored. If no <xref uid=\"com.azure.core.http.HttpPipeline\" data-throw-if-not-resolved=\"false\" data-raw-source=\"HttpPipeline\"></xref> is specified, a HTTP pipeline will be constructed internally based on the settings provided to this trait. Additionally, there may be other APIs in types that implement this trait that are also ignored if an <xref uid=\"com.azure.core.http.HttpPipeline\" data-throw-if-not-resolved=\"false\" data-raw-source=\"HttpPipeline\"></xref> is specified, so please be sure to refer to the documentation of types that implement this trait to understand the full set of implications."
returns:
description: "the updated ShareFileClientBuilder object"
type: "<xref href=\"com.azure.storage.file.share.ShareFileClientBuilder?alt=com.azure.storage.file.share.ShareFileClientBuilder&text=ShareFileClientBuilder\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.storage.file.share.ShareFileClientBuilder.pipeline(com.azure.core.http.HttpPipeline)"
fullName: "com.azure.storage.file.share.ShareFileClientBuilder.pipeline(HttpPipeline httpPipeline)"
name: "pipeline(HttpPipeline httpPipeline)"
nameWithType: "ShareFileClientBuilder.pipeline(HttpPipeline httpPipeline)"
summary: "Sets the <xref uid=\"com.azure.core.http.HttpPipeline\" data-throw-if-not-resolved=\"false\" data-raw-source=\"HttpPipeline\"></xref> to use for the service client."
parameters:
- description: "<xref uid=\"com.azure.core.http.HttpPipeline\" data-throw-if-not-resolved=\"false\" data-raw-source=\"HttpPipeline\"></xref> to use for sending service requests and receiving responses."
name: "httpPipeline"
type: "<xref href=\"com.azure.core.http.HttpPipeline?alt=com.azure.core.http.HttpPipeline&text=HttpPipeline\" data-throw-if-not-resolved=\"False\" />"
syntax: "public ShareFileClientBuilder pipeline(HttpPipeline httpPipeline)"
desc: "Sets the <xref uid=\"com.azure.core.http.HttpPipeline\" data-throw-if-not-resolved=\"false\" data-raw-source=\"HttpPipeline\"></xref> to use for the service client.\n\n**Note:** It is important to understand the precedence order of the HttpTrait APIs. In particular, if a <xref uid=\"com.azure.core.http.HttpPipeline\" data-throw-if-not-resolved=\"false\" data-raw-source=\"HttpPipeline\"></xref> is specified, this takes precedence over all other APIs in the trait, and they will be ignored. If no <xref uid=\"com.azure.core.http.HttpPipeline\" data-throw-if-not-resolved=\"false\" data-raw-source=\"HttpPipeline\"></xref> is specified, a HTTP pipeline will be constructed internally based on the settings provided to this trait. Additionally, there may be other APIs in types that implement this trait that are also ignored if an <xref uid=\"com.azure.core.http.HttpPipeline\" data-throw-if-not-resolved=\"false\" data-raw-source=\"HttpPipeline\"></xref> is specified, so please be sure to refer to the documentation of types that implement this trait to understand the full set of implications.\n\nThe <xref uid=\"com.azure.storage.file.share.ShareFileClientBuilder.endpoint(java.lang.String)\" data-throw-if-not-resolved=\"false\" data-raw-source=\"endpoint\"></xref> is not ignored when `pipeline` is set."
returns:
description: "the updated ShareFileClientBuilder object"
type: "<xref href=\"com.azure.storage.file.share.ShareFileClientBuilder?alt=com.azure.storage.file.share.ShareFileClientBuilder&text=ShareFileClientBuilder\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.storage.file.share.ShareFileClientBuilder.resourcePath(java.lang.String)"
fullName: "com.azure.storage.file.share.ShareFileClientBuilder.resourcePath(String resourcePath)"
name: "resourcePath(String resourcePath)"
nameWithType: "ShareFileClientBuilder.resourcePath(String resourcePath)"
summary: "Sets the file that the constructed clients will interact with"
parameters:
- description: "Path of the file (or directory)."
name: "resourcePath"
type: "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/lang/String.html\">String</a>"
syntax: "public ShareFileClientBuilder resourcePath(String resourcePath)"
desc: "Sets the file that the constructed clients will interact with"
returns:
description: "the updated ShareFileClientBuilder object"
type: "<xref href=\"com.azure.storage.file.share.ShareFileClientBuilder?alt=com.azure.storage.file.share.ShareFileClientBuilder&text=ShareFileClientBuilder\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.storage.file.share.ShareFileClientBuilder.retryOptions(com.azure.core.http.policy.RetryOptions)"
fullName: "com.azure.storage.file.share.ShareFileClientBuilder.retryOptions(RetryOptions retryOptions)"
name: "retryOptions(RetryOptions retryOptions)"
nameWithType: "ShareFileClientBuilder.retryOptions(RetryOptions retryOptions)"
summary: "Sets the <xref uid=\"com.azure.core.http.policy.RetryOptions\" data-throw-if-not-resolved=\"false\" data-raw-source=\"RetryOptions\"></xref> for all the requests made through the client."
parameters:
- description: "The <xref uid=\"com.azure.core.http.policy.RetryOptions\" data-throw-if-not-resolved=\"false\" data-raw-source=\"RetryOptions\"></xref> to use for all the requests made through the client."
name: "retryOptions"
type: "<xref href=\"com.azure.core.http.policy.RetryOptions?alt=com.azure.core.http.policy.RetryOptions&text=RetryOptions\" data-throw-if-not-resolved=\"False\" />"
syntax: "public ShareFileClientBuilder retryOptions(RetryOptions retryOptions)"
desc: "Sets the <xref uid=\"com.azure.core.http.policy.RetryOptions\" data-throw-if-not-resolved=\"false\" data-raw-source=\"RetryOptions\"></xref> for all the requests made through the client.\n\n**Note:** It is important to understand the precedence order of the HttpTrait APIs. In particular, if a <xref uid=\"com.azure.core.http.HttpPipeline\" data-throw-if-not-resolved=\"false\" data-raw-source=\"HttpPipeline\"></xref> is specified, this takes precedence over all other APIs in the trait, and they will be ignored. If no <xref uid=\"com.azure.core.http.HttpPipeline\" data-throw-if-not-resolved=\"false\" data-raw-source=\"HttpPipeline\"></xref> is specified, a HTTP pipeline will be constructed internally based on the settings provided to this trait. Additionally, there may be other APIs in types that implement this trait that are also ignored if an <xref uid=\"com.azure.core.http.HttpPipeline\" data-throw-if-not-resolved=\"false\" data-raw-source=\"HttpPipeline\"></xref> is specified, so please be sure to refer to the documentation of types that implement this trait to understand the full set of implications.\n\nSetting this is mutually exclusive with using <xref uid=\"com.azure.storage.file.share.ShareFileClientBuilder.retryOptions(com.azure.storage.common.policy.RequestRetryOptions)\" data-throw-if-not-resolved=\"false\" data-raw-source=\"#retryOptions(RequestRetryOptions)\"></xref>. Consider using <xref uid=\"com.azure.storage.file.share.ShareFileClientBuilder.retryOptions(com.azure.storage.common.policy.RequestRetryOptions)\" data-throw-if-not-resolved=\"false\" data-raw-source=\"#retryOptions(RequestRetryOptions)\"></xref> to also set storage specific options."
returns:
description: "the updated ShareFileClientBuilder object"
type: "<xref href=\"com.azure.storage.file.share.ShareFileClientBuilder?alt=com.azure.storage.file.share.ShareFileClientBuilder&text=ShareFileClientBuilder\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.storage.file.share.ShareFileClientBuilder.retryOptions(com.azure.storage.common.policy.RequestRetryOptions)"
fullName: "com.azure.storage.file.share.ShareFileClientBuilder.retryOptions(RequestRetryOptions retryOptions)"
name: "retryOptions(RequestRetryOptions retryOptions)"
nameWithType: "ShareFileClientBuilder.retryOptions(RequestRetryOptions retryOptions)"
summary: "Sets the request retry options for all the requests made through the client."
parameters:
- description: "<xref uid=\"com.azure.storage.common.policy.RequestRetryOptions\" data-throw-if-not-resolved=\"false\" data-raw-source=\"RequestRetryOptions\"></xref>."
name: "retryOptions"
type: "<xref href=\"com.azure.storage.common.policy.RequestRetryOptions?alt=com.azure.storage.common.policy.RequestRetryOptions&text=RequestRetryOptions\" data-throw-if-not-resolved=\"False\" />"
syntax: "public ShareFileClientBuilder retryOptions(RequestRetryOptions retryOptions)"
desc: "Sets the request retry options for all the requests made through the client. Setting this is mutually exclusive with using <xref uid=\"com.azure.storage.file.share.ShareFileClientBuilder.retryOptions(com.azure.core.http.policy.RetryOptions)\" data-throw-if-not-resolved=\"false\" data-raw-source=\"#retryOptions(RetryOptions)\"></xref>."
returns:
description: "the updated ShareFileClientBuilder object."
type: "<xref href=\"com.azure.storage.file.share.ShareFileClientBuilder?alt=com.azure.storage.file.share.ShareFileClientBuilder&text=ShareFileClientBuilder\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.storage.file.share.ShareFileClientBuilder.sasToken(java.lang.String)"
fullName: "com.azure.storage.file.share.ShareFileClientBuilder.sasToken(String sasToken)"
name: "sasToken(String sasToken)"
nameWithType: "ShareFileClientBuilder.sasToken(String sasToken)"
summary: "Sets the SAS token used to authorize requests sent to the service."
parameters:
- description: "The SAS token to use for authenticating requests. This string should only be the query parameters\n (with or without a leading '?') and not a full url."
name: "sasToken"
type: "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/lang/String.html\">String</a>"
syntax: "public ShareFileClientBuilder sasToken(String sasToken)"
desc: "Sets the SAS token used to authorize requests sent to the service."
returns:
description: "the updated ShareFileClientBuilder"
type: "<xref href=\"com.azure.storage.file.share.ShareFileClientBuilder?alt=com.azure.storage.file.share.ShareFileClientBuilder&text=ShareFileClientBuilder\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.storage.file.share.ShareFileClientBuilder.serviceVersion(com.azure.storage.file.share.ShareServiceVersion)"
fullName: "com.azure.storage.file.share.ShareFileClientBuilder.serviceVersion(ShareServiceVersion version)"
name: "serviceVersion(ShareServiceVersion version)"
nameWithType: "ShareFileClientBuilder.serviceVersion(ShareServiceVersion version)"
summary: "Sets the <xref uid=\"com.azure.storage.file.share.ShareServiceVersion\" data-throw-if-not-resolved=\"false\" data-raw-source=\"ShareServiceVersion\"></xref> that is used when making API requests."
parameters:
- description: "<xref uid=\"com.azure.storage.file.share.ShareServiceVersion\" data-throw-if-not-resolved=\"false\" data-raw-source=\"ShareServiceVersion\"></xref> of the service to be used when making requests."
name: "version"
type: "<xref href=\"com.azure.storage.file.share.ShareServiceVersion?alt=com.azure.storage.file.share.ShareServiceVersion&text=ShareServiceVersion\" data-throw-if-not-resolved=\"False\" />"
syntax: "public ShareFileClientBuilder serviceVersion(ShareServiceVersion version)"
desc: "Sets the <xref uid=\"com.azure.storage.file.share.ShareServiceVersion\" data-throw-if-not-resolved=\"false\" data-raw-source=\"ShareServiceVersion\"></xref> that is used when making API requests.\n\nIf a service version is not provided, the service version that will be used will be the latest known service version based on the version of the client library being used. If no service version is specified, updating to a newer version of the client library will have the result of potentially moving to a newer service version.\n\nTargeting a specific service version may also mean that the service will return an error for newer APIs."
returns:
description: "the updated ShareFileClientBuilder object"
type: "<xref href=\"com.azure.storage.file.share.ShareFileClientBuilder?alt=com.azure.storage.file.share.ShareFileClientBuilder&text=ShareFileClientBuilder\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.storage.file.share.ShareFileClientBuilder.shareName(java.lang.String)"
fullName: "com.azure.storage.file.share.ShareFileClientBuilder.shareName(String shareName)"
name: "shareName(String shareName)"
nameWithType: "ShareFileClientBuilder.shareName(String shareName)"
summary: "Sets the share that the constructed clients will interact with"
parameters:
- description: "Name of the share"
name: "shareName"
type: "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/lang/String.html\">String</a>"
syntax: "public ShareFileClientBuilder shareName(String shareName)"
desc: "Sets the share that the constructed clients will interact with"
returns:
description: "the updated ShareFileClientBuilder object"
type: "<xref href=\"com.azure.storage.file.share.ShareFileClientBuilder?alt=com.azure.storage.file.share.ShareFileClientBuilder&text=ShareFileClientBuilder\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.storage.file.share.ShareFileClientBuilder.shareTokenIntent(com.azure.storage.file.share.models.ShareTokenIntent)"
fullName: "com.azure.storage.file.share.ShareFileClientBuilder.shareTokenIntent(ShareTokenIntent shareTokenIntent)"
name: "shareTokenIntent(ShareTokenIntent shareTokenIntent)"
nameWithType: "ShareFileClientBuilder.shareTokenIntent(ShareTokenIntent shareTokenIntent)"
summary: "Sets the <xref uid=\"com.azure.storage.file.share.models.ShareTokenIntent\" data-throw-if-not-resolved=\"false\" data-raw-source=\"ShareTokenIntent\"></xref> that specifies whether there is intent for a file to be backed up."
parameters:
- description: "the <xref uid=\"com.azure.storage.file.share.models.ShareTokenIntent\" data-throw-if-not-resolved=\"false\" data-raw-source=\"ShareTokenIntent\"></xref> value."
name: "shareTokenIntent"
type: "<xref href=\"com.azure.storage.file.share.models.ShareTokenIntent?alt=com.azure.storage.file.share.models.ShareTokenIntent&text=ShareTokenIntent\" data-throw-if-not-resolved=\"False\" />"
syntax: "public ShareFileClientBuilder shareTokenIntent(ShareTokenIntent shareTokenIntent)"
desc: "Sets the <xref uid=\"com.azure.storage.file.share.models.ShareTokenIntent\" data-throw-if-not-resolved=\"false\" data-raw-source=\"ShareTokenIntent\"></xref> that specifies whether there is intent for a file to be backed up. This is currently required when using <xref uid=\"com.azure.core.credential.TokenCredential\" data-throw-if-not-resolved=\"false\" data-raw-source=\"TokenCredential\"></xref>, and ignored for other forms of authentication."
returns:
description: "the updated ShareFileClientBuilder object"
type: "<xref href=\"com.azure.storage.file.share.ShareFileClientBuilder?alt=com.azure.storage.file.share.ShareFileClientBuilder&text=ShareFileClientBuilder\" data-throw-if-not-resolved=\"False\" />"
- uid: "com.azure.storage.file.share.ShareFileClientBuilder.snapshot(java.lang.String)"
fullName: "com.azure.storage.file.share.ShareFileClientBuilder.snapshot(String snapshot)"
name: "snapshot(String snapshot)"
nameWithType: "ShareFileClientBuilder.snapshot(String snapshot)"
summary: "Sets the share<wbr>Snapshot that the constructed clients will interact with."
parameters:
- description: "Identifier of the shareSnapshot"
name: "snapshot"
type: "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/lang/String.html\">String</a>"
syntax: "public ShareFileClientBuilder snapshot(String snapshot)"
desc: "Sets the shareSnapshot that the constructed clients will interact with. This shareSnapshot must be linked to the share that has been specified in the builder."
returns:
description: "the updated ShareFileClientBuilder object"
type: "<xref href=\"com.azure.storage.file.share.ShareFileClientBuilder?alt=com.azure.storage.file.share.ShareFileClientBuilder&text=ShareFileClientBuilder\" data-throw-if-not-resolved=\"False\" />"
type: "class"
desc: "This class provides a fluent builder API to help aid the configuration and instantiation of the <xref uid=\"com.azure.storage.file.share.ShareFileClient\" data-throw-if-not-resolved=\"false\" data-raw-source=\"FileClients\"></xref>, <xref uid=\"com.azure.storage.file.share.ShareFileAsyncClient\" data-throw-if-not-resolved=\"false\" data-raw-source=\"FileAsyncClients\"></xref>, <xref uid=\"com.azure.storage.file.share.ShareDirectoryClient\" data-throw-if-not-resolved=\"false\" data-raw-source=\"DirectoryClients\"></xref>, and <xref uid=\"com.azure.storage.file.share.ShareDirectoryAsyncClient\" data-throw-if-not-resolved=\"false\" data-raw-source=\"DirectoryAsyncClients\"></xref>. Calling <xref uid=\"com.azure.storage.file.share.ShareFileClientBuilder.buildFileClient()\" data-throw-if-not-resolved=\"false\" data-raw-source=\"buildFileClient\"></xref>, <xref uid=\"com.azure.storage.file.share.ShareFileClientBuilder.buildFileAsyncClient()\" data-throw-if-not-resolved=\"false\" data-raw-source=\"buildFileAsyncClient\"></xref>, <xref uid=\"com.azure.storage.file.share.ShareFileClientBuilder.buildDirectoryClient()\" data-throw-if-not-resolved=\"false\" data-raw-source=\"buildDirectoryClient\"></xref>, or <xref uid=\"com.azure.storage.file.share.ShareFileClientBuilder.buildDirectoryAsyncClient()\" data-throw-if-not-resolved=\"false\" data-raw-source=\"buildDirectoryAsyncClient\"></xref> constructs an instance of <xref uid=\"com.azure.storage.file.share.ShareFileClient\" data-throw-if-not-resolved=\"false\" data-raw-source=\"ShareFileClient\"></xref>, <xref uid=\"com.azure.storage.file.share.ShareFileAsyncClient\" data-throw-if-not-resolved=\"false\" data-raw-source=\"ShareFileAsyncClient\"></xref>, <xref uid=\"com.azure.storage.file.share.ShareDirectoryClient\" data-throw-if-not-resolved=\"false\" data-raw-source=\"ShareDirectoryClient\"></xref>, or <xref uid=\"com.azure.storage.file.share.ShareDirectoryAsyncClient\" data-throw-if-not-resolved=\"false\" data-raw-source=\"ShareDirectoryAsyncClient\"></xref> respectively.\n\nThe client needs the endpoint of the Azure Storage File service, name of the share, and authorization credential. <xref uid=\"com.azure.storage.file.share.ShareFileClientBuilder.endpoint(java.lang.String)\" data-throw-if-not-resolved=\"false\" data-raw-source=\"endpoint\"></xref> gives the builder the endpoint and may give the builder the <xref uid=\"com.azure.storage.file.share.ShareFileClientBuilder.shareName(java.lang.String)\" data-throw-if-not-resolved=\"false\" data-raw-source=\"ShareFileClientBuilder#shareName(String)\"></xref>, <xref uid=\"com.azure.storage.file.share.ShareFileClientBuilder.resourcePath(java.lang.String)\" data-throw-if-not-resolved=\"false\" data-raw-source=\"ShareFileClientBuilder#resourcePath(String)\"></xref> and a <xref uid=\"com.azure.storage.file.share.ShareFileClientBuilder.sasToken(java.lang.String)\" data-throw-if-not-resolved=\"false\" data-raw-source=\"SAS token\"></xref> that authorizes the client.\n\n**Instantiating a synchronous File Client with SAS token**\n\n```java\nShareFileClient fileClient = new ShareFileClientBuilder()\n .endpoint(\"https://${accountName}.file.core.windows.net?${SASToken}\")\n .shareName(\"myshare\")\n .resourcePath(\"myfilepath\")\n .buildFileClient();\n```\n\n**Instantiating an Asynchronous File Client with SAS token**\n\n```java\nShareDirectoryClient shareDirectoryClient = new ShareFileClientBuilder()\n .endpoint(\"https://${accountName}.file.core.windows.net?${SASToken}\")\n .shareName(\"myshare\")\n .resourcePath(\"mydirectory\")\n .buildDirectoryClient();\n```\n\nIf the `endpoint` doesn't contain the query parameters to construct a SAS token it may be set using <xref uid=\"com.azure.storage.file.share.ShareFileClientBuilder.sasToken(java.lang.String)\" data-throw-if-not-resolved=\"false\" data-raw-source=\"sasToken\"></xref>.\n\n```java\nShareFileClient fileClient = new ShareFileClientBuilder()\n .endpoint(\"https://${accountName}.file.core.windows.net\")\n .sasToken(\"${SASTokenQueryParams}\")\n .shareName(\"myshare\")\n .resourcePath(\"myfilepath\")\n .buildFileClient();\n```\n\n```java\nShareFileAsyncClient shareFileAsyncClient = new ShareFileClientBuilder()\n .endpoint(\"https://{accountName}.file.core.windows.net\")\n .sasToken(\"${SASTokenQueryParams}\")\n .shareName(\"myshare\")\n .resourcePath(\"myfilepath\")\n .buildFileAsyncClient();\n```\n\nAnother way to authenticate the client is using a <xref uid=\"com.azure.storage.common.StorageSharedKeyCredential\" data-throw-if-not-resolved=\"false\" data-raw-source=\"StorageSharedKeyCredential\"></xref>. To create a StorageSharedKeyCredential a connection string from the Storage File service must be used. Set the StorageSharedKeyCredential with <xref uid=\"com.azure.storage.file.share.ShareFileClientBuilder.connectionString(java.lang.String)\" data-throw-if-not-resolved=\"false\" data-raw-source=\"connectionString\"></xref>. If the builder has both a SAS token and StorageSharedKeyCredential the StorageSharedKeyCredential will be preferred when authorizing requests sent to the service.\n\n**Instantiating a synchronous File Client with connection string.**\n\n```java\nString connectionString = \"DefaultEndpointsProtocol=https;AccountName={name};AccountKey={key}\"\n + \";EndpointSuffix={core.windows.net}\";\n ShareDirectoryClient shareDirectoryClient = new ShareFileClientBuilder()\n .connectionString(connectionString)\n .shareName(\"myshare\")\n .resourcePath(\"mydirectory\")\n .buildDirectoryClient();\n```\n\n**Instantiating an Asynchronous File Client with connection string.**\n\n```java\nString connectionString = \"DefaultEndpointsProtocol=https;AccountName={name};AccountKey={key};\"\n + \"EndpointSuffix={core.windows.net}\";\n ShareDirectoryAsyncClient shareDirectoryAsyncClient = new ShareFileClientBuilder()\n .connectionString(connectionString).shareName(\"myshare\").resourcePath(\"mydirectory\")\n .buildDirectoryAsyncClient();\n```"
implements:
- "<xref href=\"com.azure.core.client.traits.AzureNamedKeyCredentialTrait?alt=com.azure.core.client.traits.AzureNamedKeyCredentialTrait&text=AzureNamedKeyCredentialTrait\" data-throw-if-not-resolved=\"False\" /><<xref href=\"com.azure.storage.file.share.ShareFileClientBuilder?alt=com.azure.storage.file.share.ShareFileClientBuilder&text=ShareFileClientBuilder\" data-throw-if-not-resolved=\"False\" />>"
- "<xref href=\"com.azure.core.client.traits.AzureSasCredentialTrait?alt=com.azure.core.client.traits.AzureSasCredentialTrait&text=AzureSasCredentialTrait\" data-throw-if-not-resolved=\"False\" /><<xref href=\"com.azure.storage.file.share.ShareFileClientBuilder?alt=com.azure.storage.file.share.ShareFileClientBuilder&text=ShareFileClientBuilder\" data-throw-if-not-resolved=\"False\" />>"
- "<xref href=\"com.azure.core.client.traits.ConfigurationTrait?alt=com.azure.core.client.traits.ConfigurationTrait&text=ConfigurationTrait\" data-throw-if-not-resolved=\"False\" /><<xref href=\"com.azure.storage.file.share.ShareFileClientBuilder?alt=com.azure.storage.file.share.ShareFileClientBuilder&text=ShareFileClientBuilder\" data-throw-if-not-resolved=\"False\" />>"
- "<xref href=\"com.azure.core.client.traits.ConnectionStringTrait?alt=com.azure.core.client.traits.ConnectionStringTrait&text=ConnectionStringTrait\" data-throw-if-not-resolved=\"False\" /><<xref href=\"com.azure.storage.file.share.ShareFileClientBuilder?alt=com.azure.storage.file.share.ShareFileClientBuilder&text=ShareFileClientBuilder\" data-throw-if-not-resolved=\"False\" />>"
- "<xref href=\"com.azure.core.client.traits.EndpointTrait?alt=com.azure.core.client.traits.EndpointTrait&text=EndpointTrait\" data-throw-if-not-resolved=\"False\" /><<xref href=\"com.azure.storage.file.share.ShareFileClientBuilder?alt=com.azure.storage.file.share.ShareFileClientBuilder&text=ShareFileClientBuilder\" data-throw-if-not-resolved=\"False\" />>"
- "<xref href=\"com.azure.core.client.traits.HttpTrait?alt=com.azure.core.client.traits.HttpTrait&text=HttpTrait\" data-throw-if-not-resolved=\"False\" /><<xref href=\"com.azure.storage.file.share.ShareFileClientBuilder?alt=com.azure.storage.file.share.ShareFileClientBuilder&text=ShareFileClientBuilder\" data-throw-if-not-resolved=\"False\" />>"
- "<xref href=\"com.azure.core.client.traits.TokenCredentialTrait?alt=com.azure.core.client.traits.TokenCredentialTrait&text=TokenCredentialTrait\" data-throw-if-not-resolved=\"False\" /><<xref href=\"com.azure.storage.file.share.ShareFileClientBuilder?alt=com.azure.storage.file.share.ShareFileClientBuilder&text=ShareFileClientBuilder\" data-throw-if-not-resolved=\"False\" />>"
metadata: {}
package: "com.azure.storage.file.share"
artifact: com.azure:azure-storage-file-share:12.23.0