CloudFilesProviderMoveObject Method |
Moves an object to a new location within the Object Storage provider.
Namespace: net.openstack.Providers.RackspaceAssembly: openstacknet (in openstacknet.dll) Version: 1.7.7+Branch.master.Sha.25d803f397c8693c2c13777ef6675f796f520f2c
Syntax public 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
)
Public 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
)
public:
virtual 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
) sealed
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
override 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.
Implements
IObjectStorageProviderMoveObject(String, String, String, String, String, DictionaryString, String, String, Boolean, CloudIdentity)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