IObjectStorageProviderMoveObject Method |
Moves an object to a new location within the Object Storage provider.
Namespace: net.openstack.Core.ProvidersAssembly: openstacknet (in openstacknet.dll) Version: 1.7.7+Branch.master.Sha.25d803f397c8693c2c13777ef6675f796f520f2c
Syntax void MoveObject(
string sourceContainer,
string sourceObjectName,
string destinationContainer,
string destinationObjectName,
string destinationContentType = null,
Dictionary<string, string> headers = null,
string region = null,
bool useInternalUrl = false,
CloudIdentity identity = null
)
Sub MoveObject (
sourceContainer As String,
sourceObjectName As String,
destinationContainer As String,
destinationObjectName As String,
Optional destinationContentType As String = Nothing,
Optional headers As Dictionary(Of String, String) = Nothing,
Optional region As String = Nothing,
Optional useInternalUrl As Boolean = false,
Optional identity As CloudIdentity = Nothing
)
void MoveObject(
String^ sourceContainer,
String^ sourceObjectName,
String^ destinationContainer,
String^ destinationObjectName,
String^ destinationContentType = nullptr,
Dictionary<String^, String^>^ headers = nullptr,
String^ region = nullptr,
bool useInternalUrl = false,
CloudIdentity^ identity = nullptr
)
abstract MoveObject :
sourceContainer : string *
sourceObjectName : string *
destinationContainer : string *
destinationObjectName : string *
?destinationContentType : string *
?headers : Dictionary<string, string> *
?region : string *
?useInternalUrl : bool *
?identity : CloudIdentity
(* Defaults:
let _destinationContentType = defaultArg destinationContentType null
let _headers = defaultArg headers null
let _region = defaultArg region null
let _useInternalUrl = defaultArg useInternalUrl false
let _identity = defaultArg identity null
*)
-> unit
Parameters
- sourceContainer
- Type: SystemString
The source container name. - sourceObjectName
- Type: SystemString
Name of the source object.Remarks Example image_name.jpeg
- destinationContainer
- Type: SystemString
The destination container name. - destinationObjectName
- Type: SystemString
Name of the destination object.Remarks Example image_name.jpeg
- destinationContentType (Optional)
- Type: SystemString
The content type of the destination object. If the value is or empty, the content type of the created object is unspecified. - headers (Optional)
- Type: System.Collections.GenericDictionaryString, String
A collection of custom HTTP headers to associate with the object (see GetObjectHeaders(String, String, String, Boolean, CloudIdentity)). - region (Optional)
- Type: SystemString
The region in which to execute this action. If not specified, the user's default region will be used. - useInternalUrl (Optional)
- Type: SystemBoolean
to use the endpoint's InternalURL; otherwise to use the endpoint's PublicURL. - identity (Optional)
- Type: net.openstack.Core.DomainCloudIdentity
The cloud identity to use for this request. If not specified, the default identity for the current provider instance will be used.
Exceptions Exception | Condition |
---|
ArgumentNullException |
If sourceContainer is .
-or- If sourceObjectName is . -or- If destinationContainer is . -or- If destinationObjectName is . |
ArgumentException |
If sourceContainer is empty.
-or- If sourceObjectName is empty. -or- If destinationContainer is empty. -or- If destinationObjectName is empty. -or- If headers contains two equivalent keys when compared using OrdinalIgnoreCase. |
ContainerNameException |
If sourceContainer is not a valid container name.
-or- If destinationContainer is not a valid container name. |
ObjectNameException |
If sourceObjectName is not a valid object name.
-or- If destinationObjectName is not a valid object name. |
NotSupportedException |
If the provider does not support the given identity type.
-or- The specified region is not supported. -or- useInternalUrl is and the provider does not support internal URLs. |
InvalidOperationException |
If identity is and no default identity is available for the provider.
-or- If region is and no default region is available for the provider. |
ResponseException | If the REST API request failed. |
Remarks
The original object is removed only if the move is completed successfully.
Notes to Implementers |
---|
If your specific provider does not provide a "Move Object" API function, this
method may be implemented by performing a CopyObject(String, String, String, String, String, DictionaryString, String, String, Boolean, CloudIdentity) operation,
followed by a DeleteObject(String, String, DictionaryString, String, Boolean, String, Boolean, CloudIdentity) operation if the copy completed
successfully.
|
Version Information .NET Framework
Supported in: 4.5
openstack.net
Supported in: 1.6, 1.5, 1.4, 1.3.6
See Also