Click or drag to resize
IObjectStorageProviderUpdateObjectMetadata Method
Sets the object metadata, replacing any existing metadata values.

Namespace: net.openstack.Core.Providers
Assembly: openstacknet (in openstacknet.dll) Version: 1.7.7+Branch.master.Sha.25d803f397c8693c2c13777ef6675f796f520f2c
Syntax
void UpdateObjectMetadata(
	string container,
	string objectName,
	Dictionary<string, string> metadata,
	string region = null,
	bool useInternalUrl = false,
	CloudIdentity identity = null
)

Parameters

container
Type: SystemString
The container name.
objectName
Type: SystemString
The object name.
metadata
Type: System.Collections.GenericDictionaryString, String
The complete metadata to associate with the object.
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
ExceptionCondition
ArgumentNullException If container is .

-or-

If objectName is .

-or-

If metadata is .

ArgumentException If container is empty.

-or-

If objectName is empty.

-or-

If metadata contains two equivalent keys when compared using OrdinalIgnoreCase.

ContainerNameExceptionIf container is not a valid container name.
ObjectNameExceptionIf objectName 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.

ResponseExceptionIf the REST API request failed.
Remarks
Caution note Caution
This method replaces all existing metadata for the object with the values found in metadata. To add or change existing metadata values without affecting all metadata for the object, first call GetObjectMetaData(String, String, String, Boolean, CloudIdentity), modify the returned Dictionary<string, string>, then call UpdateObjectMetadata(String, String, DictionaryString, String, String, Boolean, CloudIdentity) with the modified metadata dictionary.
Version Information

.NET Framework

Supported in: 4.5

openstack.net

Supported in: 1.6, 1.5, 1.4, 1.3.6
See Also