diff --git a/src/Documentation/AdditionalReferenceDocumentation.shfbproj b/src/Documentation/AdditionalReferenceDocumentation.shfbproj new file mode 100644 index 000000000..d8d1f7cd9 --- /dev/null +++ b/src/Documentation/AdditionalReferenceDocumentation.shfbproj @@ -0,0 +1,56 @@ + + + + + Debug + AnyCPU + 2.0 + 1d084ab3-e5db-4a72-9daf-e51d225d5fcf + 1.9.9.0 + + AdditionalReferenceDocumentation + AdditionalReferenceDocumentation + AdditionalReferenceDocumentation + + .NET Framework 4.0 + .\Help\ + AdditionalReferenceDocumentation + en-US + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/src/Documentation/Documentation.v3.5.shfbproj b/src/Documentation/Documentation.v3.5.shfbproj index 07a74c3ba..133c426ab 100644 --- a/src/Documentation/Documentation.v3.5.shfbproj +++ b/src/Documentation/Documentation.v3.5.shfbproj @@ -58,12 +58,12 @@ - + - + {@HelpFormatOutputPaths} @@ -72,7 +72,7 @@ - + {@TokenFiles} @@ -95,6 +95,13 @@ + + + + + + + diff --git a/src/Documentation/Documentation.v4.0.shfbproj b/src/Documentation/Documentation.v4.0.shfbproj index dd04fcb39..ffd959f3f 100644 --- a/src/Documentation/Documentation.v4.0.shfbproj +++ b/src/Documentation/Documentation.v4.0.shfbproj @@ -58,12 +58,12 @@ - + - + {@HelpFormatOutputPaths} @@ -72,9 +72,10 @@ - + {@TokenFiles} - + + VisualStudio11 @@ -99,6 +100,13 @@ + + + + + + + diff --git a/src/corelib/Core/Collections/NamespaceDoc.cs b/src/corelib/Core/Collections/NamespaceDoc.cs new file mode 100644 index 000000000..0f7adbb79 --- /dev/null +++ b/src/corelib/Core/Collections/NamespaceDoc.cs @@ -0,0 +1,13 @@ +namespace net.openstack.Core.Collections +{ + using System.Runtime.CompilerServices; + + /// + /// The namespace contains interfaces and + /// classes that extend the collections support provided by the base class library. + /// + [CompilerGenerated] + internal class NamespaceDoc + { + } +} diff --git a/src/corelib/Core/Collections/ReadOnlyDictionary`2.cs b/src/corelib/Core/Collections/ReadOnlyDictionary`2.cs index 8d6eee391..90cebc773 100644 --- a/src/corelib/Core/Collections/ReadOnlyDictionary`2.cs +++ b/src/corelib/Core/Collections/ReadOnlyDictionary`2.cs @@ -171,6 +171,7 @@ ICollection IDictionary.Values } } + /// bool ICollection>.IsReadOnly { get @@ -179,6 +180,7 @@ bool ICollection>.IsReadOnly } } + /// bool IDictionary.IsFixedSize { get @@ -187,6 +189,7 @@ bool IDictionary.IsFixedSize } } + /// bool IDictionary.IsReadOnly { get @@ -195,6 +198,7 @@ bool IDictionary.IsReadOnly } } + /// bool ICollection.IsSynchronized { get @@ -203,6 +207,7 @@ bool ICollection.IsSynchronized } } + /// object ICollection.SyncRoot { get @@ -239,6 +244,7 @@ public bool ContainsKey(TKey key) return _dictionary.ContainsKey(key); } + /// bool IDictionary.Contains(object key) { if (key == null) @@ -286,56 +292,67 @@ public bool TryGetValue(TKey key, out TValue value) return _dictionary.TryGetValue(key, out value); } + /// void IDictionary.Add(TKey key, TValue value) { throw new NotSupportedException(); } + /// void IDictionary.Add(object key, object value) { throw new NotSupportedException(); } + /// bool IDictionary.Remove(TKey key) { throw new NotSupportedException(); } + /// void IDictionary.Remove(object key) { throw new NotSupportedException(); } + /// void ICollection>.Add(KeyValuePair item) { throw new NotSupportedException(); } + /// void ICollection>.Clear() { throw new NotSupportedException(); } + /// bool ICollection>.Contains(KeyValuePair item) { throw new NotImplementedException(); } + /// void ICollection>.CopyTo(KeyValuePair[] array, int arrayIndex) { throw new NotImplementedException(); } + /// bool ICollection>.Remove(KeyValuePair item) { throw new NotSupportedException(); } + /// void IDictionary.Clear() { throw new NotSupportedException(); } + /// void ICollection.CopyTo(Array array, int index) { throw new NotImplementedException(); @@ -379,6 +396,7 @@ public int Count } } + /// bool ICollection.IsReadOnly { get @@ -387,6 +405,7 @@ bool ICollection.IsReadOnly } } + /// bool ICollection.IsSynchronized { get @@ -395,6 +414,7 @@ bool ICollection.IsSynchronized } } + /// object ICollection.SyncRoot { get @@ -422,6 +442,7 @@ public void CopyTo(TKey[] array, int arrayIndex) _keys.CopyTo(array, arrayIndex); } + /// void ICollection.CopyTo(Array array, int index) { throw new NotImplementedException(); @@ -442,21 +463,25 @@ IEnumerator IEnumerable.GetEnumerator() return GetEnumerator(); } - bool ICollection.Contains(TKey value) + /// + bool ICollection.Contains(TKey item) { - return _keys.Contains(value); + return _keys.Contains(item); } - void ICollection.Add(TKey value) + /// + void ICollection.Add(TKey item) { throw new NotSupportedException(); } - bool ICollection.Remove(TKey value) + /// + bool ICollection.Remove(TKey item) { throw new NotSupportedException(); } + /// void ICollection.Clear() { throw new NotSupportedException(); @@ -501,6 +526,7 @@ public int Count } } + /// bool ICollection.IsReadOnly { get @@ -509,6 +535,7 @@ bool ICollection.IsReadOnly } } + /// bool ICollection.IsSynchronized { get @@ -517,6 +544,7 @@ bool ICollection.IsSynchronized } } + /// object ICollection.SyncRoot { get @@ -544,6 +572,7 @@ public void CopyTo(TValue[] array, int arrayIndex) _values.CopyTo(array, arrayIndex); } + /// void ICollection.CopyTo(Array array, int index) { throw new NotImplementedException(); @@ -564,21 +593,25 @@ IEnumerator IEnumerable.GetEnumerator() return GetEnumerator(); } - bool ICollection.Contains(TValue value) + /// + bool ICollection.Contains(TValue item) { - return _values.Contains(value); + return _values.Contains(item); } - void ICollection.Add(TValue value) + /// + void ICollection.Add(TValue item) { throw new NotSupportedException(); } - bool ICollection.Remove(TValue value) + /// + bool ICollection.Remove(TValue item) { throw new NotSupportedException(); } + /// void ICollection.Clear() { throw new NotSupportedException(); diff --git a/src/corelib/Core/Domain/AuthenticationType.cs b/src/corelib/Core/Domain/AuthenticationType.cs index c406b6df2..1932254c9 100644 --- a/src/corelib/Core/Domain/AuthenticationType.cs +++ b/src/corelib/Core/Domain/AuthenticationType.cs @@ -30,6 +30,7 @@ private AuthenticationType(string name) : base(name) /// Gets the instance with the specified name. /// /// The name. + /// The unique instance with the specified name. /// If is . /// If is empty. public static AuthenticationType FromName(string name) diff --git a/src/corelib/Core/Domain/ContainerCDN.cs b/src/corelib/Core/Domain/ContainerCDN.cs index fbafe8bc6..a378706f9 100644 --- a/src/corelib/Core/Domain/ContainerCDN.cs +++ b/src/corelib/Core/Domain/ContainerCDN.cs @@ -42,7 +42,7 @@ public class ContainerCDN /// /// if the container is CDN-Enabled; otherwise, . /// - /// + /// /// /// CDN-Enable a Container (Rackspace Cloud Files Developer Guide - API v1) [JsonProperty("cdn_enabled")] diff --git a/src/corelib/Core/Domain/Converters/IPAddressDetailsConverter.cs b/src/corelib/Core/Domain/Converters/IPAddressDetailsConverter.cs index d739000b3..f326b5b66 100644 --- a/src/corelib/Core/Domain/Converters/IPAddressDetailsConverter.cs +++ b/src/corelib/Core/Domain/Converters/IPAddressDetailsConverter.cs @@ -72,7 +72,7 @@ public override bool CanConvert(Type objectType) /// /// [JsonObject(MemberSerialization.OptIn)] - private class AddressDetails + protected class AddressDetails { /// /// Gets the network address. This is an IPv4 address if is "4", @@ -102,7 +102,7 @@ public string Version /// This constructor is used for JSON deserialization. /// [JsonConstructor] - private AddressDetails() + protected AddressDetails() { } diff --git a/src/corelib/Core/Domain/DiskConfiguration.cs b/src/corelib/Core/Domain/DiskConfiguration.cs index b22b226d3..528a437cb 100644 --- a/src/corelib/Core/Domain/DiskConfiguration.cs +++ b/src/corelib/Core/Domain/DiskConfiguration.cs @@ -36,6 +36,7 @@ private DiskConfiguration(string name) /// Gets the instance with the specified name. /// /// The name. + /// The unique instance with the specified name. /// If is . /// If is empty. public static DiskConfiguration FromName(string name) diff --git a/src/corelib/Core/Domain/ImageState.cs b/src/corelib/Core/Domain/ImageState.cs index d22df6302..78e19cddb 100644 --- a/src/corelib/Core/Domain/ImageState.cs +++ b/src/corelib/Core/Domain/ImageState.cs @@ -37,6 +37,7 @@ private ImageState(string name) /// Gets the instance with the specified name. /// /// The name. + /// The unique instance with the specified name. /// If is . /// If is empty. public static ImageState FromName(string name) diff --git a/src/corelib/Core/Domain/ImageType.cs b/src/corelib/Core/Domain/ImageType.cs index ef2ad21df..90be5ac74 100644 --- a/src/corelib/Core/Domain/ImageType.cs +++ b/src/corelib/Core/Domain/ImageType.cs @@ -33,6 +33,7 @@ private ImageType(string name) /// Gets the instance with the specified name. /// /// The name. + /// The unique instance with the specified name. /// If is . /// If is empty. public static ImageType FromName(string name) diff --git a/src/corelib/Core/Domain/PowerState.cs b/src/corelib/Core/Domain/PowerState.cs index 2446b3526..844196b2f 100644 --- a/src/corelib/Core/Domain/PowerState.cs +++ b/src/corelib/Core/Domain/PowerState.cs @@ -43,6 +43,7 @@ private PowerState(string name) /// Gets the instance with the specified name. /// /// The name. + /// The unique instance with the specified name. /// If is . /// If is empty. public static PowerState FromName(string name) diff --git a/src/corelib/Core/Domain/Queues/Claim.cs b/src/corelib/Core/Domain/Queues/Claim.cs index 7bccaf47d..aa647b380 100644 --- a/src/corelib/Core/Domain/Queues/Claim.cs +++ b/src/corelib/Core/Domain/Queues/Claim.cs @@ -254,6 +254,7 @@ public void Dispose() /// claimed by this claim. To prevent other subscribers from re-claiming the messages, make /// sure to delete the messages before calling . /// + /// The that the task will observe. /// A object representing the asynchronous operation. public Task DisposeAsync(CancellationToken cancellationToken) { diff --git a/src/corelib/Core/Domain/RebootType.cs b/src/corelib/Core/Domain/RebootType.cs index 361f059e6..91d5acecd 100644 --- a/src/corelib/Core/Domain/RebootType.cs +++ b/src/corelib/Core/Domain/RebootType.cs @@ -33,6 +33,7 @@ private RebootType(string name) /// Gets the instance with the specified name. /// /// The name. + /// The unique instance with the specified name. /// If is . /// If is empty. public static RebootType FromName(string name) diff --git a/src/corelib/Core/Domain/ServerBase.cs b/src/corelib/Core/Domain/ServerBase.cs index e42b39170..f15fb535e 100644 --- a/src/corelib/Core/Domain/ServerBase.cs +++ b/src/corelib/Core/Domain/ServerBase.cs @@ -372,7 +372,7 @@ public bool RevertResize() /// /// /// This operation is completed asynchronously. To wait for the server to enter rescue mode, - /// call with the state . + /// call with the state . /// /// /// The provider may limit the duration of rescue mode, after which the rescue image is destroyed @@ -392,7 +392,7 @@ public string Rescue() /// /// /// This operation is completed asynchronously. To wait for the server to exit rescue mode, - /// call . + /// call . /// /// /// The provider may limit the duration of rescue mode, after which the rescue image is destroyed diff --git a/src/corelib/Core/Domain/ServerState.cs b/src/corelib/Core/Domain/ServerState.cs index c10003f65..bac655313 100644 --- a/src/corelib/Core/Domain/ServerState.cs +++ b/src/corelib/Core/Domain/ServerState.cs @@ -49,6 +49,7 @@ private ServerState(string name) /// Gets the instance with the specified name. /// /// The name. + /// The unique instance with the specified name. /// If is . /// If is empty. public static ServerState FromName(string name) diff --git a/src/corelib/Core/Domain/SnapshotState.cs b/src/corelib/Core/Domain/SnapshotState.cs index cfcfdfb3c..2c1243529 100644 --- a/src/corelib/Core/Domain/SnapshotState.cs +++ b/src/corelib/Core/Domain/SnapshotState.cs @@ -36,6 +36,7 @@ private SnapshotState(string name) /// Gets the instance with the specified name. /// /// The name. + /// The unique instance with the specified name. /// If is . /// If is empty. public static SnapshotState FromName(string name) diff --git a/src/corelib/Core/Domain/TaskState.cs b/src/corelib/Core/Domain/TaskState.cs index 7f1f14e9c..5cb52dd72 100644 --- a/src/corelib/Core/Domain/TaskState.cs +++ b/src/corelib/Core/Domain/TaskState.cs @@ -71,6 +71,7 @@ private TaskState(string name) /// Gets the instance with the specified name. /// /// The name. + /// The unique instance with the specified name. /// If is . /// If is empty. public static TaskState FromName(string name) diff --git a/src/corelib/Core/Domain/VirtualMachineState.cs b/src/corelib/Core/Domain/VirtualMachineState.cs index 1e7a6f3f0..6098644e4 100644 --- a/src/corelib/Core/Domain/VirtualMachineState.cs +++ b/src/corelib/Core/Domain/VirtualMachineState.cs @@ -49,6 +49,7 @@ private VirtualMachineState(string name) /// Gets the instance with the specified name. /// /// The name. + /// The unique instance with the specified name. /// If is . /// If is empty. public static VirtualMachineState FromName(string name) diff --git a/src/corelib/Core/Domain/VolumeState.cs b/src/corelib/Core/Domain/VolumeState.cs index 386cf84c1..6ed16bbbb 100644 --- a/src/corelib/Core/Domain/VolumeState.cs +++ b/src/corelib/Core/Domain/VolumeState.cs @@ -38,6 +38,7 @@ private VolumeState(string name) /// Gets the instance with the specified name. /// /// The name. + /// The unique instance with the specified name. /// If is . /// If is empty. public static VolumeState FromName(string name) diff --git a/src/corelib/Core/Exceptions/ImageEnteredErrorStateException.cs b/src/corelib/Core/Exceptions/ImageEnteredErrorStateException.cs index f4d98aaf7..6048e001c 100644 --- a/src/corelib/Core/Exceptions/ImageEnteredErrorStateException.cs +++ b/src/corelib/Core/Exceptions/ImageEnteredErrorStateException.cs @@ -6,7 +6,7 @@ namespace net.openstack.Core.Exceptions { /// /// The exception that is thrown when the server enters an error state during a - /// call to . + /// call to . /// /// [Serializable] diff --git a/src/corelib/Core/Exceptions/ServerEnteredErrorStateException.cs b/src/corelib/Core/Exceptions/ServerEnteredErrorStateException.cs index 00034a26a..50c4bc3f9 100644 --- a/src/corelib/Core/Exceptions/ServerEnteredErrorStateException.cs +++ b/src/corelib/Core/Exceptions/ServerEnteredErrorStateException.cs @@ -6,7 +6,7 @@ namespace net.openstack.Core.Exceptions { /// /// The exception that is thrown when the server enters an error state during a - /// call to . + /// call to . /// /// [Serializable] diff --git a/src/corelib/Core/HttpStatusCodeParser.cs b/src/corelib/Core/HttpStatusCodeParser.cs index b568c47ed..d943d29b3 100644 --- a/src/corelib/Core/HttpStatusCodeParser.cs +++ b/src/corelib/Core/HttpStatusCodeParser.cs @@ -78,18 +78,18 @@ public static HttpStatusCodeParser Default } /// - public virtual bool TryParse(string value, out Status result) + public virtual bool TryParse(string value, out Status status) { if (value == null) { - result = null; + status = null; return false; } var match = _expression.Match(value); if (!match.Success) { - result = null; + status = null; return false; } @@ -98,7 +98,7 @@ public virtual bool TryParse(string value, out Status result) if (string.IsNullOrEmpty(description)) description = statusCode.ToString(); - result = new Status((int)statusCode, description); + status = new Status((int)statusCode, description); return true; } } diff --git a/src/corelib/Core/Providers/IComputeProvider.cs b/src/corelib/Core/Providers/IComputeProvider.cs index b3fc6c8dc..d9d23fd12 100644 --- a/src/corelib/Core/Providers/IComputeProvider.cs +++ b/src/corelib/Core/Providers/IComputeProvider.cs @@ -530,7 +530,7 @@ public interface IComputeProvider /// /// /// This operation is completed asynchronously. To wait for the server to enter rescue mode, - /// call with the state . + /// call with the state . /// /// /// The provider may limit the duration of rescue mode, after which the rescue image is destroyed @@ -563,7 +563,7 @@ public interface IComputeProvider /// /// /// This operation is completed asynchronously. To wait for the server to exit rescue mode, - /// call . + /// call . /// /// /// The provider may limit the duration of rescue mode, after which the rescue image is destroyed diff --git a/src/corelib/Core/Providers/IQueueingService.cs b/src/corelib/Core/Providers/IQueueingService.cs index 0fa12b1bf..1c2b9c574 100644 --- a/src/corelib/Core/Providers/IQueueingService.cs +++ b/src/corelib/Core/Providers/IQueueingService.cs @@ -341,6 +341,7 @@ Task GetQueueMetadataAsync(QueueName queueName, CancellationToken cancella /// /// Posts messages to a queue. /// + /// The class modeling the JSON representation of the messages to post in the queue. /// The queue name. /// The messages to post. /// The that the task will observe. @@ -360,6 +361,7 @@ Task GetQueueMetadataAsync(QueueName queueName, CancellationToken cancella /// /// Posts messages to a queue. /// + /// The class modeling the JSON representation of the messages to post in the queue. /// The queue name. /// The that the task will observe. /// The messages to post. diff --git a/src/corelib/Core/Synchronous/DnsServiceExtensions.cs b/src/corelib/Core/Synchronous/DnsServiceExtensions.cs index f410943b2..e6a20363f 100644 --- a/src/corelib/Core/Synchronous/DnsServiceExtensions.cs +++ b/src/corelib/Core/Synchronous/DnsServiceExtensions.cs @@ -145,6 +145,7 @@ public static DnsJob GetJobStatus(this IDnsService service, DnsJob job, bool sho /// /// Gets information about an asynchronous task with a strongly-typed result being executed by the DNS service. /// + /// The class modeling the JSON result of the asynchronous operation. /// The DNS service instance. /// The to query. /// to include detailed information about the job; otherwise, . diff --git a/src/corelib/Core/Synchronous/MonitoringServiceExtensions.cs b/src/corelib/Core/Synchronous/MonitoringServiceExtensions.cs index 5f6020027..74d6a36c7 100644 --- a/src/corelib/Core/Synchronous/MonitoringServiceExtensions.cs +++ b/src/corelib/Core/Synchronous/MonitoringServiceExtensions.cs @@ -2454,7 +2454,7 @@ public static HostInformation> GetLoginInfo /// Gets a collection of monitoring agent check targets. /// /// The monitoring service instance. - /// + /// The entity ID. This is obtained from Entity.Id. /// The agent check type ID. This is obtained from CheckType.Id, or from the predefined values in . /// A marker identifying the next page of results. This parameter is used for pagination, and is obtained from . If the value is , the list starts at the beginning. /// The maximum number of items to include in a single page of results. This parameter is used for pagination. If the value is , a provider-specific default value is used. diff --git a/src/corelib/Core/Synchronous/QueueingServiceExtensions.cs b/src/corelib/Core/Synchronous/QueueingServiceExtensions.cs index 30b716677..57cd18358 100644 --- a/src/corelib/Core/Synchronous/QueueingServiceExtensions.cs +++ b/src/corelib/Core/Synchronous/QueueingServiceExtensions.cs @@ -521,6 +521,7 @@ public static void PostMessages(this IQueueingService queueingService, QueueName /// /// Posts messages to a queue. /// + /// The class modeling the JSON representation of the messages to post in the queue. /// The queueing service instance. /// The queue name. /// The messages to post. @@ -557,6 +558,7 @@ public static void PostMessages(this IQueueingService queueingService, QueueN /// /// Posts messages to a queue. /// + /// The class modeling the JSON representation of the messages to post in the queue. /// The queueing service instance. /// The queue name. /// The messages to post. diff --git a/src/corelib/Core/Synchronous/ReadOnlyCollectionPageSynchronousExtensions.cs b/src/corelib/Core/Synchronous/ReadOnlyCollectionPageSynchronousExtensions.cs index d4580308c..218ce657a 100644 --- a/src/corelib/Core/Synchronous/ReadOnlyCollectionPageSynchronousExtensions.cs +++ b/src/corelib/Core/Synchronous/ReadOnlyCollectionPageSynchronousExtensions.cs @@ -52,6 +52,7 @@ public static ReadOnlyCollection GetAllPages(this ReadOnlyCollectionPage /// Gets the next page in the paginated collection. /// + /// The type of elements in the collection. /// A page of a paginated collection. /// A collection containing the next page of results. /// If is . diff --git a/src/corelib/Providers/Rackspace/CloudDnsProvider.cs b/src/corelib/Providers/Rackspace/CloudDnsProvider.cs index 05a0db98b..1c35f6df9 100644 --- a/src/corelib/Providers/Rackspace/CloudDnsProvider.cs +++ b/src/corelib/Providers/Rackspace/CloudDnsProvider.cs @@ -205,7 +205,7 @@ public Task GetJobStatusAsync(DnsJob job, bool showDetails, Cancellation } /// - public Task> GetJobStatusAsync(DnsJob job, bool showDetails, CancellationToken cancellationToken) + public Task> GetJobStatusAsync(DnsJob job, bool showDetails, CancellationToken cancellationToken) { if (job == null) throw new ArgumentNullException("job"); @@ -223,14 +223,14 @@ public Task> GetJobStatusAsync(DnsJob job, boo Func, Task> requestResource = GetResponseAsyncFunc(cancellationToken); - Func, DnsJob> resultSelector = + Func, DnsJob> resultSelector = task => { JObject result = task.Result; if (result == null) return null; - return result.ToObject>(); + return result.ToObject>(); }; return AuthenticateServiceAsync(cancellationToken) diff --git a/src/corelib/Providers/Rackspace/CloudFilesProvider.cs b/src/corelib/Providers/Rackspace/CloudFilesProvider.cs index 078e18ecf..6ef583377 100644 --- a/src/corelib/Providers/Rackspace/CloudFilesProvider.cs +++ b/src/corelib/Providers/Rackspace/CloudFilesProvider.cs @@ -423,7 +423,7 @@ public ContainerCDN GetContainerCDNHeader(string container, string region = null } /// - public IEnumerable ListCDNContainers(int? limit = null, string marker = null, string markerEnd = null, bool cdnEnabled = false, string region = null, CloudIdentity identity = null) + public IEnumerable ListCDNContainers(int? limit = null, string markerId = null, string markerEnd = null, bool cdnEnabled = false, string region = null, CloudIdentity identity = null) { if (limit < 0) throw new ArgumentOutOfRangeException("limit"); @@ -440,8 +440,8 @@ public IEnumerable ListCDNContainers(int? limit = null, string mar if (limit != null) queryStringParameter.Add("limit", limit.ToString()); - if (!string.IsNullOrEmpty(marker)) - queryStringParameter.Add("marker", marker); + if (!string.IsNullOrEmpty(markerId)) + queryStringParameter.Add("marker", markerId); if (!string.IsNullOrEmpty(markerEnd)) queryStringParameter.Add("end_marker", markerEnd); @@ -557,17 +557,17 @@ public void UpdateContainerMetadata(string container, Dictionary } /// - public void DeleteContainerMetadata(string container, IEnumerable metadata, string region = null, bool useInternalUrl = false, CloudIdentity identity = null) + public void DeleteContainerMetadata(string container, IEnumerable keys, string region = null, bool useInternalUrl = false, CloudIdentity identity = null) { if (container == null) throw new ArgumentNullException("container"); - if (metadata == null) - throw new ArgumentNullException("metadata"); + if (keys == null) + throw new ArgumentNullException("keys"); if (string.IsNullOrEmpty(container)) throw new ArgumentException("container cannot be empty"); CheckIdentity(identity); - Dictionary headers = metadata.ToDictionary(i => i, i => default(string), StringComparer.OrdinalIgnoreCase); + Dictionary headers = keys.ToDictionary(i => i, i => default(string), StringComparer.OrdinalIgnoreCase); UpdateContainerMetadata(container, headers, region, useInternalUrl, identity); } @@ -2220,16 +2220,16 @@ public long LargeFileBatchThreshold /// /// This value is used as the key for storing metadata information in the dictionary - /// returned by . + /// returned by . /// - /// + /// public const string ProcessedHeadersMetadataKey = "metadata"; /// /// This value is used as the key for storing non-metadata header information in the - /// dictionary returned by . + /// dictionary returned by . /// - /// + /// public const string ProcessedHeadersHeaderKey = "headers"; #endregion diff --git a/src/corelib/Providers/Rackspace/CloudIdentityProvider.cs b/src/corelib/Providers/Rackspace/CloudIdentityProvider.cs index e1c678618..a4059377e 100644 --- a/src/corelib/Providers/Rackspace/CloudIdentityProvider.cs +++ b/src/corelib/Providers/Rackspace/CloudIdentityProvider.cs @@ -595,15 +595,15 @@ public virtual IEnumerable GetUsersByEmail(string email, CloudIdentity ide } /// - public virtual User GetUser(string userId, CloudIdentity identity) + public virtual User GetUser(string id, CloudIdentity identity) { - if (userId == null) - throw new ArgumentNullException("userId"); - if (string.IsNullOrEmpty(userId)) - throw new ArgumentException("userId cannot be empty"); + if (id == null) + throw new ArgumentNullException("id"); + if (string.IsNullOrEmpty(id)) + throw new ArgumentException("id cannot be empty"); CheckIdentity(identity); - var urlPath = string.Format("v2.0/users/{0}", userId); + var urlPath = string.Format("v2.0/users/{0}", id); var response = ExecuteRESTRequest(identity, new Uri(UrlBase, urlPath), HttpMethod.GET); @@ -611,24 +611,24 @@ public virtual User GetUser(string userId, CloudIdentity identity) } /// - public virtual NewUser AddUser(NewUser newUser, CloudIdentity identity) + public virtual NewUser AddUser(NewUser user, CloudIdentity identity) { - if (newUser == null) - throw new ArgumentNullException("newUser"); - if (string.IsNullOrEmpty(newUser.Username)) - throw new ArgumentException("newUser.Username cannot be null or empty"); - if (newUser.Id != null) - throw new InvalidOperationException("newUser.Id must be null"); + if (user == null) + throw new ArgumentNullException("user"); + if (string.IsNullOrEmpty(user.Username)) + throw new ArgumentException("user.Username cannot be null or empty"); + if (user.Id != null) + throw new InvalidOperationException("user.Id must be null"); CheckIdentity(identity); - var response = ExecuteRESTRequest(identity, new Uri(UrlBase, "/v2.0/users"), HttpMethod.POST, new AddUserRequest(newUser)); + var response = ExecuteRESTRequest(identity, new Uri(UrlBase, "/v2.0/users"), HttpMethod.POST, new AddUserRequest(user)); if (response == null || response.Data == null) return null; // If the user specifies a password, then the password will not be in the response, so we need to fill it in on the return object. if (string.IsNullOrEmpty(response.Data.NewUser.Password)) - response.Data.NewUser.Password = newUser.Password; + response.Data.NewUser.Password = user.Password; return response.Data.NewUser; } diff --git a/src/corelib/Providers/Rackspace/IDnsService.cs b/src/corelib/Providers/Rackspace/IDnsService.cs index 49a0a9b9d..905fdb5c3 100644 --- a/src/corelib/Providers/Rackspace/IDnsService.cs +++ b/src/corelib/Providers/Rackspace/IDnsService.cs @@ -471,7 +471,7 @@ public interface IDnsService /// Removes one or more domain records from the DNS service. /// /// The domain ID. This is obtained from DnsDomain.Id. - /// A collection of IDs for the records to remove. These are obtained from DnsRecord.Id. + /// A collection of IDs for the records to remove. These are obtained from DnsRecord.Id. /// Specifies when the representing the asynchronous server operation should be considered complete. /// The that the task will observe. /// An optional callback object to receive progress notifications, if is . If this is , no progress notifications are sent. @@ -491,16 +491,16 @@ public interface IDnsService /// /// If is . /// -or- - /// If is . + /// If is . /// /// - /// If contains any values. + /// If contains any values. /// -or- /// If is not a valid . /// /// If the REST request does not return successfully. /// Remove Records (Rackspace Cloud DNS Developer Guide - API v1.0) - Task RemoveRecordsAsync(DomainId domainId, IEnumerable recordId, AsyncCompletionOption completionOption, CancellationToken cancellationToken, IProgress progress); + Task RemoveRecordsAsync(DomainId domainId, IEnumerable recordIds, AsyncCompletionOption completionOption, CancellationToken cancellationToken, IProgress progress); #endregion diff --git a/src/corelib/Providers/Rackspace/IMonitoringService.cs b/src/corelib/Providers/Rackspace/IMonitoringService.cs index 24120619d..f51abb20c 100644 --- a/src/corelib/Providers/Rackspace/IMonitoringService.cs +++ b/src/corelib/Providers/Rackspace/IMonitoringService.cs @@ -1405,7 +1405,7 @@ public interface IMonitoringService /// /// Gets a collection of monitoring agent check targets. /// - /// + /// The entity ID. This is obtained from Entity.Id. /// The agent check type ID. This is obtained from CheckType.Id, or from the predefined values in . /// A marker identifying the next page of results. This parameter is used for pagination, and is obtained from . If the value is , the list starts at the beginning. /// The maximum number of items to include in a single page of results. This parameter is used for pagination. If the value is , a provider-specific default value is used. diff --git a/src/corelib/Providers/Rackspace/Objects/ArchiveFormat.cs b/src/corelib/Providers/Rackspace/Objects/ArchiveFormat.cs index 1b0f19611..183f1930c 100644 --- a/src/corelib/Providers/Rackspace/Objects/ArchiveFormat.cs +++ b/src/corelib/Providers/Rackspace/Objects/ArchiveFormat.cs @@ -38,6 +38,7 @@ private ArchiveFormat(string name) /// Gets the instance with the specified name. /// /// The name. + /// The unique instance with the specified name. /// If is . /// If is empty. public static ArchiveFormat FromName(string name) diff --git a/src/corelib/Providers/Rackspace/Objects/AutoScale/LaunchType.cs b/src/corelib/Providers/Rackspace/Objects/AutoScale/LaunchType.cs index 98c7daf60..104c862b8 100644 --- a/src/corelib/Providers/Rackspace/Objects/AutoScale/LaunchType.cs +++ b/src/corelib/Providers/Rackspace/Objects/AutoScale/LaunchType.cs @@ -6,6 +6,7 @@ using Newtonsoft.Json; /// + /// Represents an Auto Scale launch type. /// /// /// This class functions as a strongly-typed enumeration of known launch types, @@ -34,6 +35,7 @@ private LaunchType(string name) /// Gets the instance with the specified name. /// /// The name. + /// The unique instance with the specified name. /// If is . /// If is empty. public static LaunchType FromName(string name) diff --git a/src/corelib/Providers/Rackspace/Objects/AutoScale/NamespaceDoc.cs b/src/corelib/Providers/Rackspace/Objects/AutoScale/NamespaceDoc.cs new file mode 100644 index 000000000..cb35c0b4d --- /dev/null +++ b/src/corelib/Providers/Rackspace/Objects/AutoScale/NamespaceDoc.cs @@ -0,0 +1,14 @@ +namespace net.openstack.Providers.Rackspace.Objects.AutoScale +{ + using System.Runtime.CompilerServices; + + /// + /// The namespace defines + /// the object model for communicating with Rackspace's Cloud Auto Scale service over REST APIs. + /// + /// + [CompilerGenerated] + internal class NamespaceDoc + { + } +} diff --git a/src/corelib/Providers/Rackspace/Objects/AutoScale/PolicyType.cs b/src/corelib/Providers/Rackspace/Objects/AutoScale/PolicyType.cs index 08b865ef9..4e78dda90 100644 --- a/src/corelib/Providers/Rackspace/Objects/AutoScale/PolicyType.cs +++ b/src/corelib/Providers/Rackspace/Objects/AutoScale/PolicyType.cs @@ -6,6 +6,7 @@ using Newtonsoft.Json; /// + /// Represents an Auto Scale policy type. /// /// /// This class functions as a strongly-typed enumeration of known policy types, @@ -36,6 +37,7 @@ private PolicyType(string name) /// Gets the instance with the specified name. /// /// The name. + /// The unique instance with the specified name. /// If is . /// If is empty. public static PolicyType FromName(string name) diff --git a/src/corelib/Providers/Rackspace/Objects/AutoScale/ServerLaunchArguments.cs b/src/corelib/Providers/Rackspace/Objects/AutoScale/ServerLaunchArguments.cs index a57b89398..34230ec51 100644 --- a/src/corelib/Providers/Rackspace/Objects/AutoScale/ServerLaunchArguments.cs +++ b/src/corelib/Providers/Rackspace/Objects/AutoScale/ServerLaunchArguments.cs @@ -40,7 +40,7 @@ protected ServerLaunchArguments() /// Initializes a new instance of the class /// with the specified server argument. /// - /// + /// A object containing the detailed arguments for launching a server. public ServerLaunchArguments(ServerArgument server) : this(server, null) { diff --git a/src/corelib/Providers/Rackspace/Objects/Databases/BackupStatus.cs b/src/corelib/Providers/Rackspace/Objects/Databases/BackupStatus.cs index 92b54dc85..ee4c98f95 100644 --- a/src/corelib/Providers/Rackspace/Objects/Databases/BackupStatus.cs +++ b/src/corelib/Providers/Rackspace/Objects/Databases/BackupStatus.cs @@ -36,6 +36,7 @@ private BackupStatus(string name) /// Gets the instance with the specified name. /// /// The name. + /// The unique instance with the specified name. /// If is . /// If is empty. public static BackupStatus FromName(string name) diff --git a/src/corelib/Providers/Rackspace/Objects/Databases/DatabaseInstanceConfiguration.cs b/src/corelib/Providers/Rackspace/Objects/Databases/DatabaseInstanceConfiguration.cs index 19a25f5c4..743e4df5c 100644 --- a/src/corelib/Providers/Rackspace/Objects/Databases/DatabaseInstanceConfiguration.cs +++ b/src/corelib/Providers/Rackspace/Objects/Databases/DatabaseInstanceConfiguration.cs @@ -49,9 +49,15 @@ protected DatabaseInstanceConfiguration() /// Initializes a new instance of the class /// with the specified values. /// - /// - /// - /// + /// A object describing the flavor of the database instance. + /// A object containing additional information about + /// the database instance storage volume. + /// The name of the database instance, or if the database instance is not named. + /// + /// If is . + /// -or- + /// If is . + /// public DatabaseInstanceConfiguration(FlavorRef flavorRef, DatabaseVolumeConfiguration volumeConfiguration, string name) : this(flavorRef, volumeConfiguration, name, null) { @@ -61,10 +67,16 @@ public DatabaseInstanceConfiguration(FlavorRef flavorRef, DatabaseVolumeConfigur /// Initializes a new instance of the class /// with a restore point for restoring a database instance from a backup. /// - /// - /// - /// - /// + /// A object describing the flavor of the database instance. + /// A object containing additional information about + /// the database instance storage volume. + /// The name of the database instance, or if the database instance is not named. + /// A object describing the backup from which this database instance was restored, or null if the restore point is not available. + /// + /// If is . + /// -or- + /// If is . + /// public DatabaseInstanceConfiguration(FlavorRef flavorRef, DatabaseVolumeConfiguration volumeConfiguration, string name, RestorePoint restorePoint) { if (flavorRef == null) diff --git a/src/corelib/Providers/Rackspace/Objects/Databases/DatabaseInstanceStatus.cs b/src/corelib/Providers/Rackspace/Objects/Databases/DatabaseInstanceStatus.cs index fd1498e88..1ce337629 100644 --- a/src/corelib/Providers/Rackspace/Objects/Databases/DatabaseInstanceStatus.cs +++ b/src/corelib/Providers/Rackspace/Objects/Databases/DatabaseInstanceStatus.cs @@ -42,6 +42,7 @@ private DatabaseInstanceStatus(string name) /// Gets the instance with the specified name. /// /// The name. + /// The unique instance with the specified name. /// If is . /// If is empty. public static DatabaseInstanceStatus FromName(string name) diff --git a/src/corelib/Providers/Rackspace/Objects/Dns/DnsJobStatus.cs b/src/corelib/Providers/Rackspace/Objects/Dns/DnsJobStatus.cs index 92c7202ff..52bb078af 100644 --- a/src/corelib/Providers/Rackspace/Objects/Dns/DnsJobStatus.cs +++ b/src/corelib/Providers/Rackspace/Objects/Dns/DnsJobStatus.cs @@ -38,6 +38,7 @@ private DnsJobStatus(string name) /// Gets the instance with the specified name. /// /// The name. + /// The unique instance with the specified name. /// If is . /// If is empty. public static DnsJobStatus FromName(string name) diff --git a/src/corelib/Providers/Rackspace/Objects/Dns/DnsRateLimitUnit.cs b/src/corelib/Providers/Rackspace/Objects/Dns/DnsRateLimitUnit.cs index 4629246c3..a0b5797c8 100644 --- a/src/corelib/Providers/Rackspace/Objects/Dns/DnsRateLimitUnit.cs +++ b/src/corelib/Providers/Rackspace/Objects/Dns/DnsRateLimitUnit.cs @@ -35,6 +35,7 @@ private DnsRateLimitUnit(string name) /// Gets the instance with the specified name. /// /// The name. + /// The unique instance with the specified name. /// If is . /// If is empty. public static DnsRateLimitUnit FromName(string name) diff --git a/src/corelib/Providers/Rackspace/Objects/Dns/DnsRecordType.cs b/src/corelib/Providers/Rackspace/Objects/Dns/DnsRecordType.cs index 144441953..8d927adf0 100644 --- a/src/corelib/Providers/Rackspace/Objects/Dns/DnsRecordType.cs +++ b/src/corelib/Providers/Rackspace/Objects/Dns/DnsRecordType.cs @@ -42,6 +42,7 @@ private DnsRecordType(string name) /// Gets the instance with the specified name. /// /// The name. + /// The unique instance with the specified name. /// If is . /// If is empty. public static DnsRecordType FromName(string name) diff --git a/src/corelib/Providers/Rackspace/Objects/Dns/LimitType.cs b/src/corelib/Providers/Rackspace/Objects/Dns/LimitType.cs index 6132b4e25..d34060e39 100644 --- a/src/corelib/Providers/Rackspace/Objects/Dns/LimitType.cs +++ b/src/corelib/Providers/Rackspace/Objects/Dns/LimitType.cs @@ -39,6 +39,7 @@ private LimitType(string name) /// Gets the instance with the specified name. /// /// The name. + /// The unique instance with the specified name. /// If is . /// If is empty. public static LimitType FromName(string name) diff --git a/src/corelib/Providers/Rackspace/Objects/Dns/SerializedDomainFormat.cs b/src/corelib/Providers/Rackspace/Objects/Dns/SerializedDomainFormat.cs index 91e9e4827..2bd25cb18 100644 --- a/src/corelib/Providers/Rackspace/Objects/Dns/SerializedDomainFormat.cs +++ b/src/corelib/Providers/Rackspace/Objects/Dns/SerializedDomainFormat.cs @@ -34,6 +34,7 @@ private SerializedDomainFormat(string name) /// Gets the instance with the specified name. /// /// The name. + /// The unique instance with the specified name. /// If is . /// If is empty. public static SerializedDomainFormat FromName(string name) diff --git a/src/corelib/Providers/Rackspace/Objects/LoadBalancers/AccessType.cs b/src/corelib/Providers/Rackspace/Objects/LoadBalancers/AccessType.cs index 3e63a4dc1..8b45859ea 100644 --- a/src/corelib/Providers/Rackspace/Objects/LoadBalancers/AccessType.cs +++ b/src/corelib/Providers/Rackspace/Objects/LoadBalancers/AccessType.cs @@ -36,6 +36,7 @@ private AccessType(string name) /// Gets the instance with the specified name. /// /// The name. + /// The unique instance with the specified name. /// If is . /// If is empty. public static AccessType FromName(string name) diff --git a/src/corelib/Providers/Rackspace/Objects/LoadBalancers/HealthMonitorType.cs b/src/corelib/Providers/Rackspace/Objects/LoadBalancers/HealthMonitorType.cs index 92dc2c815..637adbfbc 100644 --- a/src/corelib/Providers/Rackspace/Objects/LoadBalancers/HealthMonitorType.cs +++ b/src/corelib/Providers/Rackspace/Objects/LoadBalancers/HealthMonitorType.cs @@ -37,6 +37,7 @@ private HealthMonitorType(string name) /// Gets the instance with the specified name. /// /// The name. + /// The unique instance with the specified name. /// If is . /// If is empty. public static HealthMonitorType FromName(string name) diff --git a/src/corelib/Providers/Rackspace/Objects/LoadBalancers/LoadBalancerStatus.cs b/src/corelib/Providers/Rackspace/Objects/LoadBalancers/LoadBalancerStatus.cs index dc9a2a856..d70b01e7b 100644 --- a/src/corelib/Providers/Rackspace/Objects/LoadBalancers/LoadBalancerStatus.cs +++ b/src/corelib/Providers/Rackspace/Objects/LoadBalancers/LoadBalancerStatus.cs @@ -42,6 +42,7 @@ private LoadBalancerStatus(string name) /// Gets the instance with the specified name. /// /// The name. + /// The unique instance with the specified name. /// If is . /// If is empty. public static LoadBalancerStatus FromName(string name) diff --git a/src/corelib/Providers/Rackspace/Objects/LoadBalancers/LoadBalancerVirtualAddress.cs b/src/corelib/Providers/Rackspace/Objects/LoadBalancers/LoadBalancerVirtualAddress.cs index 99432bb0d..f976199de 100644 --- a/src/corelib/Providers/Rackspace/Objects/LoadBalancers/LoadBalancerVirtualAddress.cs +++ b/src/corelib/Providers/Rackspace/Objects/LoadBalancers/LoadBalancerVirtualAddress.cs @@ -68,8 +68,9 @@ public LoadBalancerVirtualAddress(LoadBalancerVirtualAddressType type) /// with the specified virtual address type and family. /// /// The virtual address type. - /// + /// The address family for this virtual address, or to not specify the address family. /// If is . + /// If is not or . public LoadBalancerVirtualAddress(LoadBalancerVirtualAddressType type, AddressFamily? version) { if (type == null) diff --git a/src/corelib/Providers/Rackspace/Objects/LoadBalancers/LoadBalancerVirtualAddressType.cs b/src/corelib/Providers/Rackspace/Objects/LoadBalancers/LoadBalancerVirtualAddressType.cs index c367d71cd..8043a55ad 100644 --- a/src/corelib/Providers/Rackspace/Objects/LoadBalancers/LoadBalancerVirtualAddressType.cs +++ b/src/corelib/Providers/Rackspace/Objects/LoadBalancers/LoadBalancerVirtualAddressType.cs @@ -48,6 +48,7 @@ private LoadBalancerVirtualAddressType(string name) /// Gets the instance with the specified name. /// /// The name. + /// The unique instance with the specified name. /// If is . /// If is empty. public static LoadBalancerVirtualAddressType FromName(string name) diff --git a/src/corelib/Providers/Rackspace/Objects/LoadBalancers/LoadBalancingAlgorithm.cs b/src/corelib/Providers/Rackspace/Objects/LoadBalancers/LoadBalancingAlgorithm.cs index 848aec0b1..38be92644 100644 --- a/src/corelib/Providers/Rackspace/Objects/LoadBalancers/LoadBalancingAlgorithm.cs +++ b/src/corelib/Providers/Rackspace/Objects/LoadBalancers/LoadBalancingAlgorithm.cs @@ -41,6 +41,7 @@ private LoadBalancingAlgorithm(string name) /// Gets the instance with the specified name. /// /// The name. + /// The unique instance with the specified name. /// If is . /// If is empty. public static LoadBalancingAlgorithm FromName(string name) diff --git a/src/corelib/Providers/Rackspace/Objects/LoadBalancers/NodeCondition.cs b/src/corelib/Providers/Rackspace/Objects/LoadBalancers/NodeCondition.cs index b59e1a4d1..3d659c818 100644 --- a/src/corelib/Providers/Rackspace/Objects/LoadBalancers/NodeCondition.cs +++ b/src/corelib/Providers/Rackspace/Objects/LoadBalancers/NodeCondition.cs @@ -39,6 +39,7 @@ private NodeCondition(string name) /// Gets the instance with the specified name. /// /// The name. + /// The unique instance with the specified name. /// If is . /// If is empty. public static NodeCondition FromName(string name) diff --git a/src/corelib/Providers/Rackspace/Objects/LoadBalancers/NodeServiceEventCategory.cs b/src/corelib/Providers/Rackspace/Objects/LoadBalancers/NodeServiceEventCategory.cs index 1ef868193..c464611c5 100644 --- a/src/corelib/Providers/Rackspace/Objects/LoadBalancers/NodeServiceEventCategory.cs +++ b/src/corelib/Providers/Rackspace/Objects/LoadBalancers/NodeServiceEventCategory.cs @@ -35,6 +35,7 @@ private NodeServiceEventCategory(string name) /// Gets the instance with the specified name. /// /// The name. + /// The unique instance with the specified name. /// If is . /// If is empty. public static NodeServiceEventCategory FromName(string name) diff --git a/src/corelib/Providers/Rackspace/Objects/LoadBalancers/NodeServiceEventSeverity.cs b/src/corelib/Providers/Rackspace/Objects/LoadBalancers/NodeServiceEventSeverity.cs index c002cc940..ed37a36a4 100644 --- a/src/corelib/Providers/Rackspace/Objects/LoadBalancers/NodeServiceEventSeverity.cs +++ b/src/corelib/Providers/Rackspace/Objects/LoadBalancers/NodeServiceEventSeverity.cs @@ -35,6 +35,7 @@ private NodeServiceEventSeverity(string name) /// Gets the instance with the specified name. /// /// The name. + /// The unique instance with the specified name. /// If is . /// If is empty. public static NodeServiceEventSeverity FromName(string name) diff --git a/src/corelib/Providers/Rackspace/Objects/LoadBalancers/NodeServiceEventType.cs b/src/corelib/Providers/Rackspace/Objects/LoadBalancers/NodeServiceEventType.cs index 0646460ad..bfc4ff0ef 100644 --- a/src/corelib/Providers/Rackspace/Objects/LoadBalancers/NodeServiceEventType.cs +++ b/src/corelib/Providers/Rackspace/Objects/LoadBalancers/NodeServiceEventType.cs @@ -35,6 +35,7 @@ private NodeServiceEventType(string name) /// Gets the instance with the specified name. /// /// The name. + /// The unique instance with the specified name. /// If is . /// If is empty. public static NodeServiceEventType FromName(string name) diff --git a/src/corelib/Providers/Rackspace/Objects/LoadBalancers/NodeStatus.cs b/src/corelib/Providers/Rackspace/Objects/LoadBalancers/NodeStatus.cs index 0972692c1..04332b008 100644 --- a/src/corelib/Providers/Rackspace/Objects/LoadBalancers/NodeStatus.cs +++ b/src/corelib/Providers/Rackspace/Objects/LoadBalancers/NodeStatus.cs @@ -35,6 +35,7 @@ private NodeStatus(string name) /// Gets the instance with the specified name. /// /// The name. + /// The unique instance with the specified name. /// If is . /// If is empty. public static NodeStatus FromName(string name) diff --git a/src/corelib/Providers/Rackspace/Objects/LoadBalancers/NodeType.cs b/src/corelib/Providers/Rackspace/Objects/LoadBalancers/NodeType.cs index a19053739..4d143297f 100644 --- a/src/corelib/Providers/Rackspace/Objects/LoadBalancers/NodeType.cs +++ b/src/corelib/Providers/Rackspace/Objects/LoadBalancers/NodeType.cs @@ -36,6 +36,7 @@ private NodeType(string name) /// Gets the instance with the specified name. /// /// The name. + /// The unique instance with the specified name. /// If is . /// If is empty. public static NodeType FromName(string name) diff --git a/src/corelib/Providers/Rackspace/Objects/LoadBalancers/SessionPersistenceType.cs b/src/corelib/Providers/Rackspace/Objects/LoadBalancers/SessionPersistenceType.cs index 0d4193c6e..772a17dc8 100644 --- a/src/corelib/Providers/Rackspace/Objects/LoadBalancers/SessionPersistenceType.cs +++ b/src/corelib/Providers/Rackspace/Objects/LoadBalancers/SessionPersistenceType.cs @@ -35,6 +35,7 @@ private SessionPersistenceType(string name) /// Gets the instance with the specified name. /// /// The name. + /// The unique instance with the specified name. /// If is . /// If is empty. public static SessionPersistenceType FromName(string name) diff --git a/src/corelib/Providers/Rackspace/Objects/Monitoring/AlarmState.cs b/src/corelib/Providers/Rackspace/Objects/Monitoring/AlarmState.cs index b9893cac6..dac3257a3 100644 --- a/src/corelib/Providers/Rackspace/Objects/Monitoring/AlarmState.cs +++ b/src/corelib/Providers/Rackspace/Objects/Monitoring/AlarmState.cs @@ -36,6 +36,7 @@ private AlarmState(string name) /// Gets the instance with the specified name. /// /// The name. + /// The unique instance with the specified name. /// If is . /// If is empty. public static AlarmState FromName(string name) diff --git a/src/corelib/Providers/Rackspace/Objects/Monitoring/CheckMetricType.cs b/src/corelib/Providers/Rackspace/Objects/Monitoring/CheckMetricType.cs index 00006164e..72bd99a21 100644 --- a/src/corelib/Providers/Rackspace/Objects/Monitoring/CheckMetricType.cs +++ b/src/corelib/Providers/Rackspace/Objects/Monitoring/CheckMetricType.cs @@ -36,6 +36,7 @@ private CheckMetricType(string name) /// Gets the instance with the specified name. /// /// The name. + /// The unique instance with the specified name. /// If is . /// If is empty. public static CheckMetricType FromName(string name) diff --git a/src/corelib/Providers/Rackspace/Objects/Monitoring/CheckTypeType.cs b/src/corelib/Providers/Rackspace/Objects/Monitoring/CheckTypeType.cs index 8679fff42..fbf3e3023 100644 --- a/src/corelib/Providers/Rackspace/Objects/Monitoring/CheckTypeType.cs +++ b/src/corelib/Providers/Rackspace/Objects/Monitoring/CheckTypeType.cs @@ -35,6 +35,7 @@ private CheckTypeType(string name) /// Gets the instance with the specified name. /// /// The name. + /// The unique instance with the specified name. /// If is . /// If is empty. public static CheckTypeType FromName(string name) diff --git a/src/corelib/Providers/Rackspace/Objects/Monitoring/DataPointGranularity.cs b/src/corelib/Providers/Rackspace/Objects/Monitoring/DataPointGranularity.cs index de2946e5d..139d05933 100644 --- a/src/corelib/Providers/Rackspace/Objects/Monitoring/DataPointGranularity.cs +++ b/src/corelib/Providers/Rackspace/Objects/Monitoring/DataPointGranularity.cs @@ -39,6 +39,7 @@ private DataPointGranularity(string name) /// Gets the instance with the specified name. /// /// The name. + /// The unique instance with the specified name. /// If is . /// If is empty. public static DataPointGranularity FromName(string name) diff --git a/src/corelib/Providers/Rackspace/Objects/Monitoring/DataPointStatistic.cs b/src/corelib/Providers/Rackspace/Objects/Monitoring/DataPointStatistic.cs index 4465b6397..23749a48a 100644 --- a/src/corelib/Providers/Rackspace/Objects/Monitoring/DataPointStatistic.cs +++ b/src/corelib/Providers/Rackspace/Objects/Monitoring/DataPointStatistic.cs @@ -38,6 +38,7 @@ private DataPointStatistic(string name) /// Gets the instance with the specified name. /// /// The name. + /// The unique instance with the specified name. /// If is . /// If is empty. public static DataPointStatistic FromName(string name) diff --git a/src/corelib/Providers/Rackspace/Objects/Monitoring/EntityOverview.cs b/src/corelib/Providers/Rackspace/Objects/Monitoring/EntityOverview.cs index c953a6643..f3ff147ce 100644 --- a/src/corelib/Providers/Rackspace/Objects/Monitoring/EntityOverview.cs +++ b/src/corelib/Providers/Rackspace/Objects/Monitoring/EntityOverview.cs @@ -6,7 +6,7 @@ /// /// This class models the JSON representation of a monitoring entity overview. /// - /// + /// /// /// [JsonObject(MemberSerialization.OptIn)] diff --git a/src/corelib/Providers/Rackspace/Objects/Monitoring/HostInformationType.cs b/src/corelib/Providers/Rackspace/Objects/Monitoring/HostInformationType.cs index 1765decae..88cc75f08 100644 --- a/src/corelib/Providers/Rackspace/Objects/Monitoring/HostInformationType.cs +++ b/src/corelib/Providers/Rackspace/Objects/Monitoring/HostInformationType.cs @@ -41,6 +41,7 @@ private HostInformationType(string name) /// Gets the instance with the specified name. /// /// The name. + /// The unique instance with the specified name. /// If is . /// If is empty. public static HostInformationType FromName(string name) diff --git a/src/corelib/Providers/Rackspace/Objects/Monitoring/TargetResolverType.cs b/src/corelib/Providers/Rackspace/Objects/Monitoring/TargetResolverType.cs index e754422d7..5aeafa294 100644 --- a/src/corelib/Providers/Rackspace/Objects/Monitoring/TargetResolverType.cs +++ b/src/corelib/Providers/Rackspace/Objects/Monitoring/TargetResolverType.cs @@ -35,6 +35,7 @@ private TargetResolverType(string name) /// Gets the instance with the specified name. /// /// The name. + /// The unique instance with the specified name. /// If is . /// If is empty. public static TargetResolverType FromName(string name) diff --git a/src/corelib/Providers/Rackspace/Objects/Request/PasswordCredential.cs b/src/corelib/Providers/Rackspace/Objects/Request/PasswordCredential.cs index 752df19e6..fe99be65f 100644 --- a/src/corelib/Providers/Rackspace/Objects/Request/PasswordCredential.cs +++ b/src/corelib/Providers/Rackspace/Objects/Request/PasswordCredential.cs @@ -7,8 +7,6 @@ /// /// This models the JSON representation of password credentials. /// - /// - /// /// Update User Credentials (OpenStack Identity Service API v2.0 Reference) /// [JsonObject(MemberSerialization.OptIn)] diff --git a/src/corelib/Providers/Rackspace/ProviderBase`1.cs b/src/corelib/Providers/Rackspace/ProviderBase`1.cs index 079f49a17..11d29d18f 100644 --- a/src/corelib/Providers/Rackspace/ProviderBase`1.cs +++ b/src/corelib/Providers/Rackspace/ProviderBase`1.cs @@ -24,6 +24,7 @@ namespace net.openstack.Providers.Rackspace /// /// Adds common functionality for all Rackspace Providers. /// + /// The service provider interface this object implements. /// public abstract class ProviderBase where TProvider : class @@ -187,7 +188,7 @@ protected virtual IBackoffPolicy DefaultBackoffPolicy /// If the request fails due to an authorization failure, i.e. the is , /// the request is attempted a second time. /// - /// This method calls , which results in a if the request fails. + /// This method calls , which results in a if the request fails. /// /// This method uses to handle the underlying REST request(s). /// @@ -246,7 +247,7 @@ protected Response ExecuteRESTRequest(CloudIdentity identity, Uri absolute /// If the request fails due to an authorization failure, i.e. the is , /// the request is attempted a second time. /// - /// This method calls , which results in a if the request fails. + /// This method calls , which results in a if the request fails. /// /// This method uses to handle the underlying REST request(s). /// @@ -305,7 +306,7 @@ protected Response ExecuteRESTRequest(CloudIdentity identity, Uri absoluteUri, H /// If the request fails due to an authorization failure, i.e. the is , /// the request is attempted a second time. /// - /// This method calls , which results in a if the request fails. + /// This method calls , which results in a if the request fails. /// /// This method uses to handle the underlying REST request(s). /// @@ -368,7 +369,7 @@ protected Response ExecuteRESTRequest(CloudIdentity identity, Uri absoluteUri, H /// If the request fails due to an authorization failure, i.e. the is , /// the request is attempted a second time. /// - /// This method calls , which results in a if the request fails. + /// This method calls , which results in a if the request fails. /// /// The type used for representing the response to the REST call. /// The cloud identity to use for this request. If not specified, the default identity for the current provider instance will be used. @@ -461,7 +462,7 @@ private T ExecuteRESTRequest(CloudIdentity identity, Uri absoluteUri, HttpMet /// /// This method uses an HTTP request timeout of 4 hours. /// - /// This method calls , which results in a if the request fails. + /// This method calls , which results in a if the request fails. /// /// The cloud identity to use for this request. If not specified, the default identity for the current provider instance will be used. /// The absolute URI for the request. @@ -766,8 +767,20 @@ protected virtual string GetInternalServiceEndpoint(CloudIdentity identity, stri return endpoint.InternalURL; } + /// + /// Validate the response to an HTTP request. + /// + /// + /// The validation is performed by calling . + /// + /// The response to the HTTP request. + /// If is . + /// If indicates the REST API call failed. internal void CheckResponse(Response response) { + if (response == null) + throw new ArgumentNullException("response"); + ResponseCodeValidator.Validate(response); } @@ -919,6 +932,7 @@ protected Func>, HttpWebRequest> PrepareRequestAs /// to create and prepare the resulting , and then asynchronously obtains /// the request stream for the request and writes the specified in JSON notation. /// + /// The type modeling the body of the request. /// The to use for the request. /// The for the target URI. /// A collection of parameters for binding the URI template in a call to . @@ -961,9 +975,9 @@ protected Func>, Task> PrepareReq /// and /// properties are updated to reflect the JSON content. /// - /// The object modeling the body of the request. + /// The type modeling the body of the request. /// The object for the request. - /// + /// The object modeling the body of the request. /// The encoded content to send with the . /// If is . /// diff --git a/src/corelib/corelib.v3.5.csproj b/src/corelib/corelib.v3.5.csproj index 04add640c..bf1dd458a 100644 --- a/src/corelib/corelib.v3.5.csproj +++ b/src/corelib/corelib.v3.5.csproj @@ -69,6 +69,7 @@ + @@ -241,6 +242,7 @@ + diff --git a/src/corelib/corelib.v4.0.csproj b/src/corelib/corelib.v4.0.csproj index aa9bd31ab..a7f8a367e 100644 --- a/src/corelib/corelib.v4.0.csproj +++ b/src/corelib/corelib.v4.0.csproj @@ -64,6 +64,7 @@ + @@ -231,6 +232,7 @@ + diff --git a/src/openstack.net.sln b/src/openstack.net.sln index 397ce9c4a..7a6c30bfb 100644 --- a/src/openstack.net.sln +++ b/src/openstack.net.sln @@ -40,6 +40,8 @@ Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "CPPCodeSamples", "Samples\C EndProject Project("{F2A71F9B-5D33-465A-A702-920D77279786}") = "FSharpCodeSamples", "Samples\FSharpCodeSamples\FSharpCodeSamples.fsproj", "{6F852167-4873-4541-A4FF-F4D9E396927B}" EndProject +Project("{7CF6DF6D-3B04-46F8-A40B-537D21BCA0B4}") = "AdditionalReferenceDocumentation", "Documentation\AdditionalReferenceDocumentation.shfbproj", "{1D084AB3-E5DB-4A72-9DAF-E51D225D5FCF}" +EndProject Global GlobalSection(TestCaseManagementSettings) = postSolution CategoryFile = openstack.net.vsmdi @@ -187,6 +189,14 @@ Global {6F852167-4873-4541-A4FF-F4D9E396927B}.Release|Mixed Platforms.Build.0 = Release|Any CPU {6F852167-4873-4541-A4FF-F4D9E396927B}.Release|Win32.ActiveCfg = Release|Any CPU {6F852167-4873-4541-A4FF-F4D9E396927B}.Release|x86.ActiveCfg = Release|Any CPU + {1D084AB3-E5DB-4A72-9DAF-E51D225D5FCF}.Debug|Any CPU.ActiveCfg = Debug|Any CPU + {1D084AB3-E5DB-4A72-9DAF-E51D225D5FCF}.Debug|Mixed Platforms.ActiveCfg = Debug|Any CPU + {1D084AB3-E5DB-4A72-9DAF-E51D225D5FCF}.Debug|Win32.ActiveCfg = Debug|Any CPU + {1D084AB3-E5DB-4A72-9DAF-E51D225D5FCF}.Debug|x86.ActiveCfg = Debug|Any CPU + {1D084AB3-E5DB-4A72-9DAF-E51D225D5FCF}.Release|Any CPU.ActiveCfg = Release|Any CPU + {1D084AB3-E5DB-4A72-9DAF-E51D225D5FCF}.Release|Mixed Platforms.ActiveCfg = Release|Any CPU + {1D084AB3-E5DB-4A72-9DAF-E51D225D5FCF}.Release|Win32.ActiveCfg = Release|Any CPU + {1D084AB3-E5DB-4A72-9DAF-E51D225D5FCF}.Release|x86.ActiveCfg = Release|Any CPU EndGlobalSection GlobalSection(SolutionProperties) = preSolution HideSolutionNode = FALSE