CloudFilesProviderCopyObject Method |
Copies 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 CopyObject(
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 CopyObject (
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 CopyObject(
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 CopyObject :
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 CopyObject :
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
The source object name. Example image_name.jpeg - destinationContainer
- Type: SystemString
The destination container name. - destinationObjectName
- Type: SystemString
The destination object name. 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 created 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
IObjectStorageProviderCopyObject(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. |
Version Information .NET Framework
Supported in: 4.5
openstack.net
Supported in: 1.6, 1.5, 1.4, 1.3.6
See Also