Added 'DNS Account Settings' implementation - part one
This commit is contained in:
@@ -0,0 +1,90 @@
|
|||||||
|
using System.Threading;
|
||||||
|
using System.Threading.Tasks;
|
||||||
|
using AMWD.Net.Api.Cloudflare.Dns.Internals;
|
||||||
|
|
||||||
|
namespace AMWD.Net.Api.Cloudflare.Dns
|
||||||
|
{
|
||||||
|
/// <summary>
|
||||||
|
/// Extensions for <see href="https://developers.cloudflare.com/api/resources/dns/subresources/settings/subresources/account/">DNS Account Settings</see>.
|
||||||
|
/// </summary>
|
||||||
|
public static class DnsAccountSettingsExtensions
|
||||||
|
{
|
||||||
|
/// <summary>
|
||||||
|
/// Update DNS settings for a zone default of an account.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="client">The <see cref="ICloudflareClient"/> instance.</param>
|
||||||
|
/// <param name="request">The request.</param>
|
||||||
|
/// <param name="cancellationToken">A cancellation token used to propagate notification that this operation should be canceled.</param>
|
||||||
|
public static Task<CloudflareResponse<DnsAccountSettings>> UpdateDnsAccountSettings(this ICloudflareClient client, UpdateDnsAccountSettingsRequest request, CancellationToken cancellationToken = default)
|
||||||
|
{
|
||||||
|
request.AccountId.ValidateCloudflareId();
|
||||||
|
|
||||||
|
var req = new InternalUpdateDnsAccountSettingsRequest();
|
||||||
|
|
||||||
|
if (request.ZoneDefaults != null)
|
||||||
|
{
|
||||||
|
req.ZoneDefaults = new InternalDnsAccountZoneDefaults();
|
||||||
|
|
||||||
|
if (request.ZoneDefaults.ZoneMode.HasValue && !Enum.IsDefined(typeof(DnsZoneMode), request.ZoneDefaults.ZoneMode))
|
||||||
|
throw new ArgumentOutOfRangeException($"{nameof(request.ZoneDefaults)}.{nameof(request.ZoneDefaults.ZoneMode)}", request.ZoneDefaults.ZoneMode, "Value must be one of the ZoneMode enum values.");
|
||||||
|
|
||||||
|
if (request.ZoneDefaults.Nameservers != null && !Enum.IsDefined(typeof(DnsAccountNameserversType), request.ZoneDefaults.Nameservers.Type))
|
||||||
|
throw new ArgumentOutOfRangeException($"{nameof(request.ZoneDefaults)}.{nameof(request.ZoneDefaults.Nameservers)}.{nameof(request.ZoneDefaults.Nameservers.Type)}", request.ZoneDefaults.Nameservers.Type, "Value must be one of the NameserverType enum values.");
|
||||||
|
|
||||||
|
if (request.ZoneDefaults.NameserverTtl.HasValue && (request.ZoneDefaults.NameserverTtl < 30 || 86400 < request.ZoneDefaults.NameserverTtl))
|
||||||
|
throw new ArgumentOutOfRangeException($"{nameof(request.ZoneDefaults)}.{nameof(request.ZoneDefaults.NameserverTtl)}", request.ZoneDefaults.NameserverTtl, "Value must be between 30 and 86400.");
|
||||||
|
|
||||||
|
if (request.ZoneDefaults.SOA != null)
|
||||||
|
{
|
||||||
|
string paramNameBase = $"{nameof(request.ZoneDefaults)}.{nameof(request.ZoneDefaults.SOA)}";
|
||||||
|
|
||||||
|
if (request.ZoneDefaults.SOA.Expire < 86400 || 2419200 < request.ZoneDefaults.SOA.Expire)
|
||||||
|
throw new ArgumentOutOfRangeException($"{paramNameBase}.{nameof(request.ZoneDefaults.SOA.Expire)}", request.ZoneDefaults.SOA.Expire, "Value must be between 86400 and 2419200.");
|
||||||
|
|
||||||
|
if (request.ZoneDefaults.SOA.MinimumTtl < 60 || 86400 < request.ZoneDefaults.SOA.MinimumTtl)
|
||||||
|
throw new ArgumentOutOfRangeException($"{paramNameBase}.{nameof(request.ZoneDefaults.SOA.MinimumTtl)}", request.ZoneDefaults.SOA.MinimumTtl, "Value must be between 60 and 86400.");
|
||||||
|
|
||||||
|
if (string.IsNullOrWhiteSpace(request.ZoneDefaults.SOA.PrimaryNameserver))
|
||||||
|
throw new ArgumentNullException($"{paramNameBase}.{nameof(request.ZoneDefaults.SOA.PrimaryNameserver)}");
|
||||||
|
|
||||||
|
if (request.ZoneDefaults.SOA.Refresh < 600 || 86400 < request.ZoneDefaults.SOA.Refresh)
|
||||||
|
throw new ArgumentOutOfRangeException($"{paramNameBase}.{nameof(request.ZoneDefaults.SOA.Refresh)}", request.ZoneDefaults.SOA.Refresh, "Value must be between 600 and 86400.");
|
||||||
|
|
||||||
|
if (request.ZoneDefaults.SOA.Retry < 600 || 86400 < request.ZoneDefaults.SOA.Retry)
|
||||||
|
throw new ArgumentOutOfRangeException($"{paramNameBase}.{nameof(request.ZoneDefaults.SOA.Retry)}", request.ZoneDefaults.SOA.Retry, "Value must be between 600 and 86400.");
|
||||||
|
|
||||||
|
if (request.ZoneDefaults.SOA.TimeToLive < 300 || 86400 < request.ZoneDefaults.SOA.TimeToLive)
|
||||||
|
throw new ArgumentOutOfRangeException($"{paramNameBase}.{nameof(request.ZoneDefaults.SOA.TimeToLive)}", request.ZoneDefaults.SOA.TimeToLive, "Value must be between 300 and 86400.");
|
||||||
|
|
||||||
|
if (string.IsNullOrWhiteSpace(request.ZoneDefaults.SOA.ZoneAdministrator))
|
||||||
|
throw new ArgumentNullException($"{paramNameBase}.{nameof(request.ZoneDefaults.SOA.ZoneAdministrator)}");
|
||||||
|
}
|
||||||
|
|
||||||
|
req.ZoneDefaults.FlattenAllCnames = request.ZoneDefaults.FlattenAllCnames;
|
||||||
|
req.ZoneDefaults.FoundationDns = request.ZoneDefaults.FoundationDns;
|
||||||
|
req.ZoneDefaults.InternalDns = request.ZoneDefaults.InternalDns;
|
||||||
|
req.ZoneDefaults.MultiProvider = request.ZoneDefaults.MultiProvider;
|
||||||
|
req.ZoneDefaults.Nameservers = request.ZoneDefaults.Nameservers;
|
||||||
|
req.ZoneDefaults.NameserverTtl = request.ZoneDefaults.NameserverTtl;
|
||||||
|
req.ZoneDefaults.SecondaryOverrides = request.ZoneDefaults.SecondaryOverrides;
|
||||||
|
req.ZoneDefaults.SOA = request.ZoneDefaults.SOA;
|
||||||
|
req.ZoneDefaults.ZoneMode = request.ZoneDefaults.ZoneMode;
|
||||||
|
}
|
||||||
|
|
||||||
|
return client.PatchAsync<DnsAccountSettings, InternalUpdateDnsAccountSettingsRequest>($"/accounts/{request.AccountId}/dns_settings", req, cancellationToken);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Show DNS settings for a zone default of an account.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="client">The <see cref="ICloudflareClient"/> instance.</param>
|
||||||
|
/// <param name="accountId">The account identifier.</param>
|
||||||
|
/// <param name="cancellationToken">A cancellation token used to propagate notification that this operation should be canceled.</param>
|
||||||
|
public static Task<CloudflareResponse<DnsAccountSettings>> ShowDnsAccountSettings(this ICloudflareClient client, string accountId, CancellationToken cancellationToken = default)
|
||||||
|
{
|
||||||
|
accountId.ValidateCloudflareId();
|
||||||
|
|
||||||
|
return client.GetAsync<DnsAccountSettings>($"/accounts/{accountId}/dns_settings", null, cancellationToken);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,32 @@
|
|||||||
|
namespace AMWD.Net.Api.Cloudflare.Dns.Internals
|
||||||
|
{
|
||||||
|
internal class InternalDnsAccountZoneDefaults
|
||||||
|
{
|
||||||
|
[JsonProperty("flatten_all_cnames")]
|
||||||
|
public bool? FlattenAllCnames { get; set; }
|
||||||
|
|
||||||
|
[JsonProperty("foundation_dns")]
|
||||||
|
public bool? FoundationDns { get; set; }
|
||||||
|
|
||||||
|
[JsonProperty("internal_dns")]
|
||||||
|
public DnsAccountInternalDns? InternalDns { get; set; }
|
||||||
|
|
||||||
|
[JsonProperty("multi_provider")]
|
||||||
|
public bool? MultiProvider { get; set; }
|
||||||
|
|
||||||
|
[JsonProperty("nameservers")]
|
||||||
|
public DnsAccountNameservers? Nameservers { get; set; }
|
||||||
|
|
||||||
|
[JsonProperty("ns_ttl")]
|
||||||
|
public int? NameserverTtl { get; set; }
|
||||||
|
|
||||||
|
[JsonProperty("secondary_overrides")]
|
||||||
|
public bool? SecondaryOverrides { get; set; }
|
||||||
|
|
||||||
|
[JsonProperty("soa")]
|
||||||
|
public DnsZoneSoa? SOA { get; set; }
|
||||||
|
|
||||||
|
[JsonProperty("zone_mode")]
|
||||||
|
public DnsZoneMode? ZoneMode { get; set; }
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
namespace AMWD.Net.Api.Cloudflare.Dns.Internals
|
||||||
|
{
|
||||||
|
internal class InternalUpdateDnsAccountSettingsRequest
|
||||||
|
{
|
||||||
|
[JsonProperty("zone_defaults")]
|
||||||
|
public InternalDnsAccountZoneDefaults? ZoneDefaults { get; set; }
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,14 @@
|
|||||||
|
namespace AMWD.Net.Api.Cloudflare.Dns
|
||||||
|
{
|
||||||
|
/// <summary>
|
||||||
|
/// Settings for this internal zone.
|
||||||
|
/// </summary>
|
||||||
|
public class DnsAccountInternalDns
|
||||||
|
{
|
||||||
|
/// <summary>
|
||||||
|
/// The ID of the zone to fallback to.
|
||||||
|
/// </summary>
|
||||||
|
[JsonProperty("reference_zone_id")]
|
||||||
|
public string? ReferenceZoneId { get; set; }
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,58 @@
|
|||||||
|
using System.Runtime.Serialization;
|
||||||
|
using Newtonsoft.Json.Converters;
|
||||||
|
|
||||||
|
namespace AMWD.Net.Api.Cloudflare.Dns
|
||||||
|
{
|
||||||
|
/// <summary>
|
||||||
|
/// Settings determining the nameservers through which the zone should be available.
|
||||||
|
/// </summary>
|
||||||
|
public class DnsAccountNameservers
|
||||||
|
{
|
||||||
|
/// <summary>
|
||||||
|
/// Initializes a new instance of the <see cref="DnsAccountNameservers"/> class.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="type">Nameserver type.</param>
|
||||||
|
public DnsAccountNameservers(DnsAccountNameserversType type)
|
||||||
|
{
|
||||||
|
Type = type;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Nameserver type.
|
||||||
|
/// </summary>
|
||||||
|
[JsonProperty("type")]
|
||||||
|
public DnsAccountNameserversType Type { get; set; }
|
||||||
|
}
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// The type of a DNS zone nameserver.
|
||||||
|
/// <see href="https://github.com/cloudflare/cloudflare-typescript/blob/v4.4.1/src/resources/dns/settings/account/account.ts#L137">Source</see>
|
||||||
|
/// </summary>
|
||||||
|
[JsonConverter(typeof(StringEnumConverter))]
|
||||||
|
public enum DnsAccountNameserversType
|
||||||
|
{
|
||||||
|
/// <summary>
|
||||||
|
/// The Cloudflare standard nameservers.
|
||||||
|
/// </summary>
|
||||||
|
[EnumMember(Value = "cloudflare.standard")]
|
||||||
|
Standard = 1,
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// The zone specific nameservers.
|
||||||
|
/// </summary>
|
||||||
|
[EnumMember(Value = "cloudflare.standard.random")]
|
||||||
|
Random = 2,
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// The account specific nameservers.
|
||||||
|
/// </summary>
|
||||||
|
[EnumMember(Value = "custom.account")]
|
||||||
|
Account = 3,
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// The tenant specific nameservers.
|
||||||
|
/// </summary>
|
||||||
|
[EnumMember(Value = "custom.tenant")]
|
||||||
|
Tenant = 4,
|
||||||
|
}
|
||||||
|
}
|
||||||
14
src/Extensions/Cloudflare.Dns/Models/DnsAccountSettings.cs
Normal file
14
src/Extensions/Cloudflare.Dns/Models/DnsAccountSettings.cs
Normal file
@@ -0,0 +1,14 @@
|
|||||||
|
namespace AMWD.Net.Api.Cloudflare.Dns
|
||||||
|
{
|
||||||
|
/// <summary>
|
||||||
|
/// Settings for a Cloudflare DNS zone on account level.
|
||||||
|
/// </summary>
|
||||||
|
public class DnsAccountSettings
|
||||||
|
{
|
||||||
|
/// <summary>
|
||||||
|
/// Settings zone defaults.
|
||||||
|
/// </summary>
|
||||||
|
[JsonProperty("zone_defaults")]
|
||||||
|
public DnsAccountZoneDefaults? ZoneDefaults { get; set; }
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,66 @@
|
|||||||
|
namespace AMWD.Net.Api.Cloudflare.Dns
|
||||||
|
{
|
||||||
|
/// <summary>
|
||||||
|
/// Settings zone defaults.
|
||||||
|
/// </summary>
|
||||||
|
public class DnsAccountZoneDefaults
|
||||||
|
{
|
||||||
|
/// <summary>
|
||||||
|
/// Whether to flatten all CNAME records in the zone. Note that, due to DNS
|
||||||
|
/// limitations, a CNAME record at the zone apex will always be flattened.
|
||||||
|
/// </summary>
|
||||||
|
[JsonProperty("flatten_all_cnames")]
|
||||||
|
public bool? FlattenAllCnames { get; set; }
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Whether to enable Foundation DNS Advanced Nameservers on the zone.
|
||||||
|
/// </summary>
|
||||||
|
[JsonProperty("foundation_dns")]
|
||||||
|
public bool? FoundationDns { get; set; }
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Settings for this internal zone.
|
||||||
|
/// </summary>
|
||||||
|
[JsonProperty("internal_dns")]
|
||||||
|
public DnsAccountInternalDns? InternalDns { get; set; }
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Whether to enable multi-provider DNS, which causes Cloudflare to activate the
|
||||||
|
/// zone even when non-Cloudflare NS records exist, and to respect NS records at the
|
||||||
|
/// zone apex during outbound zone transfers.
|
||||||
|
/// </summary>
|
||||||
|
[JsonProperty("multi_provider")]
|
||||||
|
public bool? MultiProvider { get; set; }
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Settings determining the nameservers through which the zone should be available.
|
||||||
|
/// </summary>
|
||||||
|
[JsonProperty("nameservers")]
|
||||||
|
public DnsAccountNameservers? Nameservers { get; set; }
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// The time to live (TTL) of the zone's nameserver (NS) records.
|
||||||
|
/// </summary>
|
||||||
|
[JsonProperty("ns_ttl")]
|
||||||
|
public int? NameserverTtl { get; set; }
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Allows a Secondary DNS zone to use (proxied) override records and CNAME
|
||||||
|
/// flattening at the zone apex.
|
||||||
|
/// </summary>
|
||||||
|
[JsonProperty("secondary_overrides")]
|
||||||
|
public bool? SecondaryOverrides { get; set; }
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Components of the zone's SOA record.
|
||||||
|
/// </summary>
|
||||||
|
[JsonProperty("soa")]
|
||||||
|
public DnsZoneSoa? SOA { get; set; }
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// Whether the zone mode is a regular or CDN/DNS only zone.
|
||||||
|
/// </summary>
|
||||||
|
[JsonProperty("zone_mode")]
|
||||||
|
public DnsZoneMode? ZoneMode { get; set; }
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -29,6 +29,12 @@ This package contains the feature set of the _DNS_ section of the Cloudflare API
|
|||||||
|
|
||||||
#### [Settings]
|
#### [Settings]
|
||||||
|
|
||||||
|
##### [Account]
|
||||||
|
|
||||||
|
- [Update DNS Settings](https://developers.cloudflare.com/api/resources/dns/subresources/settings/subresources/account/methods/edit/)
|
||||||
|
- [Show DNS Settings](https://developers.cloudflare.com/api/resources/dns/subresources/settings/subresources/account/methods/get/)
|
||||||
|
|
||||||
|
|
||||||
##### [Zone]
|
##### [Zone]
|
||||||
|
|
||||||
- [Update DNS Settings](https://developers.cloudflare.com/api/resources/dns/subresources/settings/subresources/zone/methods/edit/)
|
- [Update DNS Settings](https://developers.cloudflare.com/api/resources/dns/subresources/settings/subresources/zone/methods/edit/)
|
||||||
@@ -49,4 +55,5 @@ Published under MIT License (see [choose a license])
|
|||||||
[Records]: https://developers.cloudflare.com/api/resources/dns/subresources/records/
|
[Records]: https://developers.cloudflare.com/api/resources/dns/subresources/records/
|
||||||
|
|
||||||
[Settings]: https://developers.cloudflare.com/api/resources/dns/subresources/settings/
|
[Settings]: https://developers.cloudflare.com/api/resources/dns/subresources/settings/
|
||||||
|
[Account]: https://developers.cloudflare.com/api/resources/dns/subresources/settings/subresources/account/
|
||||||
[Zone]: https://developers.cloudflare.com/api/resources/dns/subresources/settings/subresources/zone/
|
[Zone]: https://developers.cloudflare.com/api/resources/dns/subresources/settings/subresources/zone/
|
||||||
|
|||||||
@@ -0,0 +1,27 @@
|
|||||||
|
namespace AMWD.Net.Api.Cloudflare.Dns
|
||||||
|
{
|
||||||
|
/// <summary>
|
||||||
|
/// Represents a request to update DNS zone defaults on account level.
|
||||||
|
/// </summary>
|
||||||
|
public class UpdateDnsAccountSettingsRequest
|
||||||
|
{
|
||||||
|
/// <summary>
|
||||||
|
/// Initializes a new instance of the <see cref="UpdateDnsAccountSettingsRequest"/> class.
|
||||||
|
/// </summary>
|
||||||
|
/// <param name="accountId">The account identifier.</param>
|
||||||
|
public UpdateDnsAccountSettingsRequest(string accountId)
|
||||||
|
{
|
||||||
|
AccountId = accountId;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// The zone identifier.
|
||||||
|
/// </summary>
|
||||||
|
public string AccountId { get; set; }
|
||||||
|
|
||||||
|
/// <summary>
|
||||||
|
/// The DNS zone defaults.
|
||||||
|
/// </summary>
|
||||||
|
public DnsAccountZoneDefaults? ZoneDefaults { get; set; }
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,101 @@
|
|||||||
|
using System.Linq;
|
||||||
|
using System.Threading;
|
||||||
|
using System.Threading.Tasks;
|
||||||
|
using AMWD.Net.Api.Cloudflare;
|
||||||
|
using AMWD.Net.Api.Cloudflare.Dns;
|
||||||
|
using Moq;
|
||||||
|
|
||||||
|
namespace Cloudflare.Dns.Tests.DnsAccountSettingsExtensions
|
||||||
|
{
|
||||||
|
[TestClass]
|
||||||
|
public class ShowDnsAccountSettingsTest
|
||||||
|
{
|
||||||
|
private const string AccountId = "023e105f4ecef8ad9ca31a8372d0c353";
|
||||||
|
private const string ZoneId = "023e105f4ecef8ad9ca31a8372d0c354";
|
||||||
|
|
||||||
|
private Mock<ICloudflareClient> _clientMock;
|
||||||
|
private CloudflareResponse<DnsAccountSettings> _response;
|
||||||
|
private List<(string RequestPath, IQueryParameterFilter QueryFilter)> _callbacks;
|
||||||
|
|
||||||
|
[TestInitialize]
|
||||||
|
public void Initialize()
|
||||||
|
{
|
||||||
|
_callbacks = [];
|
||||||
|
|
||||||
|
_response = new CloudflareResponse<DnsAccountSettings>
|
||||||
|
{
|
||||||
|
Success = true,
|
||||||
|
Messages = [
|
||||||
|
new ResponseInfo(1000, "Message 1")
|
||||||
|
],
|
||||||
|
Errors = [
|
||||||
|
new ResponseInfo(1000, "Error 1")
|
||||||
|
],
|
||||||
|
Result = new DnsAccountSettings
|
||||||
|
{
|
||||||
|
ZoneDefaults = new DnsAccountZoneDefaults
|
||||||
|
{
|
||||||
|
FlattenAllCnames = true,
|
||||||
|
FoundationDns = false,
|
||||||
|
InternalDns = new DnsAccountInternalDns
|
||||||
|
{
|
||||||
|
ReferenceZoneId = ZoneId
|
||||||
|
},
|
||||||
|
MultiProvider = false,
|
||||||
|
Nameservers = new DnsAccountNameservers(
|
||||||
|
type: DnsAccountNameserversType.Random
|
||||||
|
),
|
||||||
|
NameserverTtl = 86400,
|
||||||
|
SecondaryOverrides = false,
|
||||||
|
SOA = new DnsZoneSoa(
|
||||||
|
expire: 604800,
|
||||||
|
minttl: 1800,
|
||||||
|
mname: "bob.ns.example.com",
|
||||||
|
refresh: 10000,
|
||||||
|
retry: 2400,
|
||||||
|
rname: "admin.example.com",
|
||||||
|
ttl: 3600
|
||||||
|
),
|
||||||
|
ZoneMode = DnsZoneMode.DnsOnly
|
||||||
|
}
|
||||||
|
}
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
[TestMethod]
|
||||||
|
public async Task ShouldGetDnsSettings()
|
||||||
|
{
|
||||||
|
// Arrange
|
||||||
|
var client = GetClient();
|
||||||
|
|
||||||
|
// Act
|
||||||
|
var response = await client.ShowDnsAccountSettings(AccountId);
|
||||||
|
|
||||||
|
// Assert
|
||||||
|
Assert.IsNotNull(response);
|
||||||
|
Assert.IsTrue(response.Success);
|
||||||
|
Assert.AreEqual(_response.Result, response.Result);
|
||||||
|
|
||||||
|
Assert.AreEqual(1, _callbacks.Count);
|
||||||
|
|
||||||
|
var callback = _callbacks.First();
|
||||||
|
Assert.AreEqual($"/accounts/{AccountId}/dns_settings", callback.RequestPath);
|
||||||
|
|
||||||
|
Assert.IsNull(callback.QueryFilter);
|
||||||
|
|
||||||
|
_clientMock?.Verify(m => m.GetAsync<DnsAccountSettings>($"/accounts/{AccountId}/dns_settings", null, It.IsAny<CancellationToken>()), Times.Once);
|
||||||
|
_clientMock?.VerifyNoOtherCalls();
|
||||||
|
}
|
||||||
|
|
||||||
|
private ICloudflareClient GetClient()
|
||||||
|
{
|
||||||
|
_clientMock = new Mock<ICloudflareClient>();
|
||||||
|
_clientMock
|
||||||
|
.Setup(m => m.GetAsync<DnsAccountSettings>(It.IsAny<string>(), It.IsAny<IQueryParameterFilter>(), It.IsAny<CancellationToken>()))
|
||||||
|
.Callback<string, IQueryParameterFilter, CancellationToken>((requestPath, queryFilter, _) => _callbacks.Add((requestPath, queryFilter)))
|
||||||
|
.ReturnsAsync(() => _response);
|
||||||
|
|
||||||
|
return _clientMock.Object;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,373 @@
|
|||||||
|
using System.Linq;
|
||||||
|
using System.Threading;
|
||||||
|
using System.Threading.Tasks;
|
||||||
|
using AMWD.Net.Api.Cloudflare;
|
||||||
|
using AMWD.Net.Api.Cloudflare.Dns;
|
||||||
|
using AMWD.Net.Api.Cloudflare.Dns.Internals;
|
||||||
|
using Moq;
|
||||||
|
|
||||||
|
namespace Cloudflare.Dns.Tests.DnsAccountSettingsExtensions
|
||||||
|
{
|
||||||
|
[TestClass]
|
||||||
|
public class UpdateDnsAccountSettingsTest
|
||||||
|
{
|
||||||
|
private const string AccountId = "023e105f4ecef8ad9ca31a8372d0c353";
|
||||||
|
private const string ZoneId = "023e105f4ecef8ad9ca31a8372d0c354";
|
||||||
|
|
||||||
|
private Mock<ICloudflareClient> _clientMock;
|
||||||
|
private CloudflareResponse<DnsAccountSettings> _response;
|
||||||
|
private List<(string RequestPath, InternalUpdateDnsAccountSettingsRequest Request)> _callbacks;
|
||||||
|
private UpdateDnsAccountSettingsRequest _request;
|
||||||
|
|
||||||
|
[TestInitialize]
|
||||||
|
public void Initialize()
|
||||||
|
{
|
||||||
|
_callbacks = [];
|
||||||
|
|
||||||
|
_response = new CloudflareResponse<DnsAccountSettings>
|
||||||
|
{
|
||||||
|
Success = true,
|
||||||
|
Messages = [
|
||||||
|
new ResponseInfo(1000, "Message 1")
|
||||||
|
],
|
||||||
|
Errors = [
|
||||||
|
new ResponseInfo(1000, "Error 1")
|
||||||
|
],
|
||||||
|
Result = new DnsAccountSettings
|
||||||
|
{
|
||||||
|
ZoneDefaults = new DnsAccountZoneDefaults
|
||||||
|
{
|
||||||
|
FlattenAllCnames = true,
|
||||||
|
FoundationDns = false,
|
||||||
|
InternalDns = new DnsAccountInternalDns
|
||||||
|
{
|
||||||
|
ReferenceZoneId = ZoneId
|
||||||
|
},
|
||||||
|
MultiProvider = false,
|
||||||
|
Nameservers = new DnsAccountNameservers(
|
||||||
|
type: DnsAccountNameserversType.Standard
|
||||||
|
),
|
||||||
|
NameserverTtl = 86400,
|
||||||
|
SecondaryOverrides = false,
|
||||||
|
SOA = new DnsZoneSoa(
|
||||||
|
expire: 604800,
|
||||||
|
minttl: 1800,
|
||||||
|
mname: "bob.ns.example.com",
|
||||||
|
refresh: 10000,
|
||||||
|
retry: 2400,
|
||||||
|
rname: "admin.example.com",
|
||||||
|
ttl: 3600
|
||||||
|
),
|
||||||
|
ZoneMode = DnsZoneMode.DnsOnly
|
||||||
|
}
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
_request = new UpdateDnsAccountSettingsRequest(AccountId)
|
||||||
|
{
|
||||||
|
ZoneDefaults = new DnsAccountZoneDefaults
|
||||||
|
{
|
||||||
|
FlattenAllCnames = true,
|
||||||
|
FoundationDns = false,
|
||||||
|
InternalDns = new DnsAccountInternalDns
|
||||||
|
{
|
||||||
|
ReferenceZoneId = ZoneId
|
||||||
|
},
|
||||||
|
MultiProvider = false,
|
||||||
|
Nameservers = new DnsAccountNameservers(
|
||||||
|
type: DnsAccountNameserversType.Random
|
||||||
|
),
|
||||||
|
NameserverTtl = 86400,
|
||||||
|
SecondaryOverrides = false,
|
||||||
|
SOA = new DnsZoneSoa(
|
||||||
|
expire: 604800,
|
||||||
|
minttl: 1800,
|
||||||
|
mname: "ns1.example.org",
|
||||||
|
refresh: 28800,
|
||||||
|
retry: 3600,
|
||||||
|
rname: "admin.example.org",
|
||||||
|
ttl: 43200
|
||||||
|
),
|
||||||
|
ZoneMode = DnsZoneMode.Standard
|
||||||
|
}
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
[TestMethod]
|
||||||
|
public async Task ShouldUpdateDnsSettingsFull()
|
||||||
|
{
|
||||||
|
// Arrange
|
||||||
|
var client = GetClient();
|
||||||
|
|
||||||
|
// Act
|
||||||
|
var response = await client.UpdateDnsAccountSettings(_request);
|
||||||
|
|
||||||
|
// Assert
|
||||||
|
Assert.IsNotNull(response);
|
||||||
|
Assert.IsTrue(response.Success);
|
||||||
|
Assert.AreEqual(_response.Result, response.Result);
|
||||||
|
|
||||||
|
Assert.AreEqual(1, _callbacks.Count);
|
||||||
|
|
||||||
|
var callback = _callbacks.First();
|
||||||
|
Assert.AreEqual($"/accounts/{AccountId}/dns_settings", callback.RequestPath);
|
||||||
|
|
||||||
|
Assert.IsNotNull(callback.Request);
|
||||||
|
Assert.IsTrue(callback.Request.ZoneDefaults.FlattenAllCnames);
|
||||||
|
Assert.IsFalse(callback.Request.ZoneDefaults.FoundationDns);
|
||||||
|
Assert.IsNotNull(callback.Request.ZoneDefaults.InternalDns);
|
||||||
|
Assert.AreEqual(ZoneId, callback.Request.ZoneDefaults.InternalDns.ReferenceZoneId);
|
||||||
|
Assert.IsFalse(callback.Request.ZoneDefaults.MultiProvider);
|
||||||
|
Assert.IsNotNull(callback.Request.ZoneDefaults.Nameservers);
|
||||||
|
Assert.AreEqual(DnsAccountNameserversType.Random, callback.Request.ZoneDefaults.Nameservers.Type);
|
||||||
|
Assert.AreEqual(86400, callback.Request.ZoneDefaults.NameserverTtl);
|
||||||
|
Assert.IsFalse(callback.Request.ZoneDefaults.SecondaryOverrides);
|
||||||
|
Assert.IsNotNull(callback.Request.ZoneDefaults.SOA);
|
||||||
|
Assert.AreEqual(604800, callback.Request.ZoneDefaults.SOA.Expire);
|
||||||
|
Assert.AreEqual(1800, callback.Request.ZoneDefaults.SOA.MinimumTtl);
|
||||||
|
Assert.AreEqual("ns1.example.org", callback.Request.ZoneDefaults.SOA.PrimaryNameserver);
|
||||||
|
Assert.AreEqual(28800, callback.Request.ZoneDefaults.SOA.Refresh);
|
||||||
|
Assert.AreEqual(3600, callback.Request.ZoneDefaults.SOA.Retry);
|
||||||
|
Assert.AreEqual(43200, callback.Request.ZoneDefaults.SOA.TimeToLive);
|
||||||
|
Assert.AreEqual("admin.example.org", callback.Request.ZoneDefaults.SOA.ZoneAdministrator);
|
||||||
|
Assert.AreEqual(DnsZoneMode.Standard, callback.Request.ZoneDefaults.ZoneMode);
|
||||||
|
|
||||||
|
_clientMock.Verify(m => m.PatchAsync<DnsAccountSettings, InternalUpdateDnsAccountSettingsRequest>($"/accounts/{AccountId}/dns_settings", It.IsAny<InternalUpdateDnsAccountSettingsRequest>(), It.IsAny<CancellationToken>()), Times.Once);
|
||||||
|
_clientMock.VerifyNoOtherCalls();
|
||||||
|
}
|
||||||
|
|
||||||
|
[TestMethod]
|
||||||
|
public async Task ShouldUpdateDnsSettingsNone()
|
||||||
|
{
|
||||||
|
// Arrange
|
||||||
|
var request = new UpdateDnsAccountSettingsRequest(AccountId);
|
||||||
|
var client = GetClient();
|
||||||
|
|
||||||
|
// Act
|
||||||
|
var response = await client.UpdateDnsAccountSettings(request);
|
||||||
|
|
||||||
|
// Assert
|
||||||
|
Assert.IsNotNull(response);
|
||||||
|
Assert.IsTrue(response.Success);
|
||||||
|
Assert.AreEqual(_response.Result, response.Result);
|
||||||
|
|
||||||
|
Assert.AreEqual(1, _callbacks.Count);
|
||||||
|
|
||||||
|
var callback = _callbacks.First();
|
||||||
|
Assert.AreEqual($"/accounts/{AccountId}/dns_settings", callback.RequestPath);
|
||||||
|
|
||||||
|
Assert.IsNotNull(callback.Request);
|
||||||
|
Assert.IsNull(callback.Request.ZoneDefaults);
|
||||||
|
|
||||||
|
_clientMock.Verify(m => m.PatchAsync<DnsAccountSettings, InternalUpdateDnsAccountSettingsRequest>($"/accounts/{AccountId}/dns_settings", It.IsAny<InternalUpdateDnsAccountSettingsRequest>(), It.IsAny<CancellationToken>()), Times.Once);
|
||||||
|
_clientMock.VerifyNoOtherCalls();
|
||||||
|
}
|
||||||
|
|
||||||
|
[TestMethod]
|
||||||
|
public async Task ShouldUpdateDnsSettingsNoneDefaults()
|
||||||
|
{
|
||||||
|
// Arrange
|
||||||
|
var request = new UpdateDnsAccountSettingsRequest(AccountId)
|
||||||
|
{
|
||||||
|
ZoneDefaults = new DnsAccountZoneDefaults()
|
||||||
|
};
|
||||||
|
var client = GetClient();
|
||||||
|
|
||||||
|
// Act
|
||||||
|
var response = await client.UpdateDnsAccountSettings(request);
|
||||||
|
|
||||||
|
// Assert
|
||||||
|
Assert.IsNotNull(response);
|
||||||
|
Assert.IsTrue(response.Success);
|
||||||
|
Assert.AreEqual(_response.Result, response.Result);
|
||||||
|
|
||||||
|
Assert.AreEqual(1, _callbacks.Count);
|
||||||
|
|
||||||
|
var callback = _callbacks.First();
|
||||||
|
Assert.AreEqual($"/accounts/{AccountId}/dns_settings", callback.RequestPath);
|
||||||
|
|
||||||
|
Assert.IsNotNull(callback.Request);
|
||||||
|
Assert.IsNotNull(callback.Request.ZoneDefaults);
|
||||||
|
Assert.IsNull(callback.Request.ZoneDefaults.FlattenAllCnames);
|
||||||
|
Assert.IsNull(callback.Request.ZoneDefaults.FoundationDns);
|
||||||
|
Assert.IsNull(callback.Request.ZoneDefaults.MultiProvider);
|
||||||
|
Assert.IsNull(callback.Request.ZoneDefaults.Nameservers);
|
||||||
|
Assert.IsNull(callback.Request.ZoneDefaults.NameserverTtl);
|
||||||
|
Assert.IsNull(callback.Request.ZoneDefaults.SecondaryOverrides);
|
||||||
|
Assert.IsNull(callback.Request.ZoneDefaults.SOA);
|
||||||
|
Assert.IsNull(callback.Request.ZoneDefaults.ZoneMode);
|
||||||
|
|
||||||
|
_clientMock.Verify(m => m.PatchAsync<DnsAccountSettings, InternalUpdateDnsAccountSettingsRequest>($"/accounts/{AccountId}/dns_settings", It.IsAny<InternalUpdateDnsAccountSettingsRequest>(), It.IsAny<CancellationToken>()), Times.Once);
|
||||||
|
_clientMock.VerifyNoOtherCalls();
|
||||||
|
}
|
||||||
|
|
||||||
|
[TestMethod]
|
||||||
|
[ExpectedException(typeof(ArgumentOutOfRangeException))]
|
||||||
|
public async Task ShouldThrowArgumentOutOfRangeExceptionForInvalidMode()
|
||||||
|
{
|
||||||
|
// Arrange
|
||||||
|
_request.ZoneDefaults.ZoneMode = 0;
|
||||||
|
var client = GetClient();
|
||||||
|
|
||||||
|
// Act
|
||||||
|
await client.UpdateDnsAccountSettings(_request);
|
||||||
|
|
||||||
|
// Assert - ArgumentOutOfRangeException
|
||||||
|
}
|
||||||
|
|
||||||
|
[TestMethod]
|
||||||
|
[ExpectedException(typeof(ArgumentOutOfRangeException))]
|
||||||
|
public async Task ShouldThrowArgumentOutOfRangeExceptionForInvalidNameserverType()
|
||||||
|
{
|
||||||
|
// Arrange
|
||||||
|
_request.ZoneDefaults.Nameservers.Type = 0;
|
||||||
|
var client = GetClient();
|
||||||
|
|
||||||
|
// Act
|
||||||
|
await client.UpdateDnsAccountSettings(_request);
|
||||||
|
|
||||||
|
// Assert - ArgumentOutOfRangeException
|
||||||
|
}
|
||||||
|
|
||||||
|
[DataTestMethod]
|
||||||
|
[DataRow(29)]
|
||||||
|
[DataRow(86401)]
|
||||||
|
[ExpectedException(typeof(ArgumentOutOfRangeException))]
|
||||||
|
public async Task ShouldThrowArgumentOutOfRangeExceptionForInvalidNameserverTtl(int ttl)
|
||||||
|
{
|
||||||
|
// Arrange
|
||||||
|
_request.ZoneDefaults.NameserverTtl = ttl;
|
||||||
|
var client = GetClient();
|
||||||
|
|
||||||
|
// Act
|
||||||
|
await client.UpdateDnsAccountSettings(_request);
|
||||||
|
|
||||||
|
// Assert - ArgumentOutOfRangeException
|
||||||
|
}
|
||||||
|
|
||||||
|
[DataTestMethod]
|
||||||
|
[DataRow(86399)]
|
||||||
|
[DataRow(2419201)]
|
||||||
|
[ExpectedException(typeof(ArgumentOutOfRangeException))]
|
||||||
|
public async Task ShouldThrowArgumentOutOfRangeExceptionForInvalidSoaExpire(int ttl)
|
||||||
|
{
|
||||||
|
// Arrange
|
||||||
|
_request.ZoneDefaults.SOA.Expire = ttl;
|
||||||
|
var client = GetClient();
|
||||||
|
|
||||||
|
// Act
|
||||||
|
await client.UpdateDnsAccountSettings(_request);
|
||||||
|
|
||||||
|
// Assert - ArgumentOutOfRangeException
|
||||||
|
}
|
||||||
|
|
||||||
|
[DataTestMethod]
|
||||||
|
[DataRow(59)]
|
||||||
|
[DataRow(86401)]
|
||||||
|
[ExpectedException(typeof(ArgumentOutOfRangeException))]
|
||||||
|
public async Task ShouldThrowArgumentOutOfRangeExceptionForInvalidSoaMinimumTtl(int ttl)
|
||||||
|
{
|
||||||
|
// Arrange
|
||||||
|
_request.ZoneDefaults.SOA.MinimumTtl = ttl;
|
||||||
|
var client = GetClient();
|
||||||
|
|
||||||
|
// Act
|
||||||
|
await client.UpdateDnsAccountSettings(_request);
|
||||||
|
|
||||||
|
// Assert - ArgumentOutOfRangeException
|
||||||
|
}
|
||||||
|
|
||||||
|
[DataTestMethod]
|
||||||
|
[DataRow(null)]
|
||||||
|
[DataRow("")]
|
||||||
|
[DataRow(" ")]
|
||||||
|
[ExpectedException(typeof(ArgumentNullException))]
|
||||||
|
public async Task ShouldThrowArgumentNullExceptionForMissingSoaNameserver(string nameserver)
|
||||||
|
{
|
||||||
|
// Arrange
|
||||||
|
_request.ZoneDefaults.SOA.PrimaryNameserver = nameserver;
|
||||||
|
var client = GetClient();
|
||||||
|
|
||||||
|
// Act
|
||||||
|
await client.UpdateDnsAccountSettings(_request);
|
||||||
|
|
||||||
|
// Assert - ArgumentNullException
|
||||||
|
}
|
||||||
|
|
||||||
|
[DataTestMethod]
|
||||||
|
[DataRow(599)]
|
||||||
|
[DataRow(86401)]
|
||||||
|
[ExpectedException(typeof(ArgumentOutOfRangeException))]
|
||||||
|
public async Task ShouldThrowArgumentOutOfRangeExceptionForInvalidSoaRefresh(int ttl)
|
||||||
|
{
|
||||||
|
// Arrange
|
||||||
|
_request.ZoneDefaults.SOA.Refresh = ttl;
|
||||||
|
var client = GetClient();
|
||||||
|
|
||||||
|
// Act
|
||||||
|
await client.UpdateDnsAccountSettings(_request);
|
||||||
|
|
||||||
|
// Assert - ArgumentOutOfRangeException
|
||||||
|
}
|
||||||
|
|
||||||
|
[DataTestMethod]
|
||||||
|
[DataRow(599)]
|
||||||
|
[DataRow(86401)]
|
||||||
|
[ExpectedException(typeof(ArgumentOutOfRangeException))]
|
||||||
|
public async Task ShouldThrowArgumentOutOfRangeExceptionForInvalidSoaRetry(int ttl)
|
||||||
|
{
|
||||||
|
// Arrange
|
||||||
|
_request.ZoneDefaults.SOA.Retry = ttl;
|
||||||
|
var client = GetClient();
|
||||||
|
|
||||||
|
// Act
|
||||||
|
await client.UpdateDnsAccountSettings(_request);
|
||||||
|
|
||||||
|
// Assert - ArgumentOutOfRangeException
|
||||||
|
}
|
||||||
|
|
||||||
|
[DataTestMethod]
|
||||||
|
[DataRow(299)]
|
||||||
|
[DataRow(86401)]
|
||||||
|
[ExpectedException(typeof(ArgumentOutOfRangeException))]
|
||||||
|
public async Task ShouldThrowArgumentOutOfRangeExceptionForInvalidSoaTtl(int ttl)
|
||||||
|
{
|
||||||
|
// Arrange
|
||||||
|
_request.ZoneDefaults.SOA.TimeToLive = ttl;
|
||||||
|
var client = GetClient();
|
||||||
|
|
||||||
|
// Act
|
||||||
|
await client.UpdateDnsAccountSettings(_request);
|
||||||
|
|
||||||
|
// Assert - ArgumentOutOfRangeException
|
||||||
|
}
|
||||||
|
|
||||||
|
[DataTestMethod]
|
||||||
|
[DataRow(null)]
|
||||||
|
[DataRow("")]
|
||||||
|
[DataRow(" ")]
|
||||||
|
[ExpectedException(typeof(ArgumentNullException))]
|
||||||
|
public async Task ShouldThrowArgumentNullExceptionForMissingSoaAdministrator(string admin)
|
||||||
|
{
|
||||||
|
// Arrange
|
||||||
|
_request.ZoneDefaults.SOA.ZoneAdministrator = admin;
|
||||||
|
var client = GetClient();
|
||||||
|
|
||||||
|
// Act
|
||||||
|
await client.UpdateDnsAccountSettings(_request);
|
||||||
|
|
||||||
|
// Assert - ArgumentNullException
|
||||||
|
}
|
||||||
|
|
||||||
|
private ICloudflareClient GetClient()
|
||||||
|
{
|
||||||
|
_clientMock = new Mock<ICloudflareClient>();
|
||||||
|
_clientMock
|
||||||
|
.Setup(m => m.PatchAsync<DnsAccountSettings, InternalUpdateDnsAccountSettingsRequest>(It.IsAny<string>(), It.IsAny<InternalUpdateDnsAccountSettingsRequest>(), It.IsAny<CancellationToken>()))
|
||||||
|
.Callback<string, InternalUpdateDnsAccountSettingsRequest, CancellationToken>((requestPath, request, _) => _callbacks.Add((requestPath, request)))
|
||||||
|
.ReturnsAsync(() => _response);
|
||||||
|
|
||||||
|
return _clientMock.Object;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
Reference in New Issue
Block a user