Class PrivateRecordSet


  • public class PrivateRecordSet
    extends com.pulumi.resources.CustomResource
    Describes a DNS record set (a collection of DNS records with the same name and type) in a Private DNS zone. Azure REST API version: 2020-06-01. Prior API version in Azure Native 1.x: 2020-06-01. ## Example Usage ### PUT Private DNS Zone A Record Set ```java package generated_program; import com.pulumi.Context; import com.pulumi.Pulumi; import com.pulumi.core.Output; import com.pulumi.azurenative.network.PrivateRecordSet; import com.pulumi.azurenative.network.PrivateRecordSetArgs; import java.util.List; import java.util.ArrayList; import java.util.Map; import java.io.File; import java.nio.file.Files; import java.nio.file.Paths; public class App { public static void main(String[] args) { Pulumi.run(App::stack); } public static void stack(Context ctx) { var privateRecordSet = new PrivateRecordSet("privateRecordSet", PrivateRecordSetArgs.builder() .aRecords(Map.of("ipv4Address", "1.2.3.4")) .metadata(Map.of("key1", "value1")) .privateZoneName("privatezone1.com") .recordType("A") .relativeRecordSetName("recordA") .resourceGroupName("resourceGroup1") .ttl(3600) .build()); } } ``` ### PUT Private DNS Zone AAAA Record Set ```java package generated_program; import com.pulumi.Context; import com.pulumi.Pulumi; import com.pulumi.core.Output; import com.pulumi.azurenative.network.PrivateRecordSet; import com.pulumi.azurenative.network.PrivateRecordSetArgs; import java.util.List; import java.util.ArrayList; import java.util.Map; import java.io.File; import java.nio.file.Files; import java.nio.file.Paths; public class App { public static void main(String[] args) { Pulumi.run(App::stack); } public static void stack(Context ctx) { var privateRecordSet = new PrivateRecordSet("privateRecordSet", PrivateRecordSetArgs.builder() .aaaaRecords(Map.of("ipv6Address", "::1")) .metadata(Map.of("key1", "value1")) .privateZoneName("privatezone1.com") .recordType("AAAA") .relativeRecordSetName("recordAAAA") .resourceGroupName("resourceGroup1") .ttl(3600) .build()); } } ``` ### PUT Private DNS Zone CNAME Record Set ```java package generated_program; import com.pulumi.Context; import com.pulumi.Pulumi; import com.pulumi.core.Output; import com.pulumi.azurenative.network.PrivateRecordSet; import com.pulumi.azurenative.network.PrivateRecordSetArgs; import java.util.List; import java.util.ArrayList; import java.util.Map; import java.io.File; import java.nio.file.Files; import java.nio.file.Paths; public class App { public static void main(String[] args) { Pulumi.run(App::stack); } public static void stack(Context ctx) { var privateRecordSet = new PrivateRecordSet("privateRecordSet", PrivateRecordSetArgs.builder() .cnameRecord(Map.of("cname", "contoso.com")) .metadata(Map.of("key1", "value1")) .privateZoneName("privatezone1.com") .recordType("CNAME") .relativeRecordSetName("recordCNAME") .resourceGroupName("resourceGroup1") .ttl(3600) .build()); } } ``` ### PUT Private DNS Zone MX Record Set ```java package generated_program; import com.pulumi.Context; import com.pulumi.Pulumi; import com.pulumi.core.Output; import com.pulumi.azurenative.network.PrivateRecordSet; import com.pulumi.azurenative.network.PrivateRecordSetArgs; import java.util.List; import java.util.ArrayList; import java.util.Map; import java.io.File; import java.nio.file.Files; import java.nio.file.Paths; public class App { public static void main(String[] args) { Pulumi.run(App::stack); } public static void stack(Context ctx) { var privateRecordSet = new PrivateRecordSet("privateRecordSet", PrivateRecordSetArgs.builder() .metadata(Map.of("key1", "value1")) .mxRecords(Map.ofEntries( Map.entry("exchange", "mail.privatezone1.com"), Map.entry("preference", 0) )) .privateZoneName("privatezone1.com") .recordType("MX") .relativeRecordSetName("recordMX") .resourceGroupName("resourceGroup1") .ttl(3600) .build()); } } ``` ### PUT Private DNS Zone PTR Record Set ```java package generated_program; import com.pulumi.Context; import com.pulumi.Pulumi; import com.pulumi.core.Output; import com.pulumi.azurenative.network.PrivateRecordSet; import com.pulumi.azurenative.network.PrivateRecordSetArgs; import java.util.List; import java.util.ArrayList; import java.util.Map; import java.io.File; import java.nio.file.Files; import java.nio.file.Paths; public class App { public static void main(String[] args) { Pulumi.run(App::stack); } public static void stack(Context ctx) { var privateRecordSet = new PrivateRecordSet("privateRecordSet", PrivateRecordSetArgs.builder() .metadata(Map.of("key1", "value1")) .privateZoneName("0.0.127.in-addr.arpa") .ptrRecords(Map.of("ptrdname", "localhost")) .recordType("PTR") .relativeRecordSetName("1") .resourceGroupName("resourceGroup1") .ttl(3600) .build()); } } ``` ### PUT Private DNS Zone SOA Record Set ```java package generated_program; import com.pulumi.Context; import com.pulumi.Pulumi; import com.pulumi.core.Output; import com.pulumi.azurenative.network.PrivateRecordSet; import com.pulumi.azurenative.network.PrivateRecordSetArgs; import java.util.List; import java.util.ArrayList; import java.util.Map; import java.io.File; import java.nio.file.Files; import java.nio.file.Paths; public class App { public static void main(String[] args) { Pulumi.run(App::stack); } public static void stack(Context ctx) { var privateRecordSet = new PrivateRecordSet("privateRecordSet", PrivateRecordSetArgs.builder() .metadata(Map.of("key1", "value1")) .privateZoneName("privatezone1.com") .recordType("SOA") .relativeRecordSetName("@") .resourceGroupName("resourceGroup1") .soaRecord(Map.ofEntries( Map.entry("email", "azureprivatedns-hostmaster.microsoft.com"), Map.entry("expireTime", 2419200), Map.entry("host", "azureprivatedns.net"), Map.entry("minimumTtl", 300), Map.entry("refreshTime", 3600), Map.entry("retryTime", 300), Map.entry("serialNumber", 1) )) .ttl(3600) .build()); } } ``` ### PUT Private DNS Zone SRV Record Set ```java package generated_program; import com.pulumi.Context; import com.pulumi.Pulumi; import com.pulumi.core.Output; import com.pulumi.azurenative.network.PrivateRecordSet; import com.pulumi.azurenative.network.PrivateRecordSetArgs; import java.util.List; import java.util.ArrayList; import java.util.Map; import java.io.File; import java.nio.file.Files; import java.nio.file.Paths; public class App { public static void main(String[] args) { Pulumi.run(App::stack); } public static void stack(Context ctx) { var privateRecordSet = new PrivateRecordSet("privateRecordSet", PrivateRecordSetArgs.builder() .metadata(Map.of("key1", "value1")) .privateZoneName("privatezone1.com") .recordType("SRV") .relativeRecordSetName("recordSRV") .resourceGroupName("resourceGroup1") .srvRecords(Map.ofEntries( Map.entry("port", 80), Map.entry("priority", 0), Map.entry("target", "contoso.com"), Map.entry("weight", 10) )) .ttl(3600) .build()); } } ``` ### PUT Private DNS Zone TXT Record Set ```java package generated_program; import com.pulumi.Context; import com.pulumi.Pulumi; import com.pulumi.core.Output; import com.pulumi.azurenative.network.PrivateRecordSet; import com.pulumi.azurenative.network.PrivateRecordSetArgs; import java.util.List; import java.util.ArrayList; import java.util.Map; import java.io.File; import java.nio.file.Files; import java.nio.file.Paths; public class App { public static void main(String[] args) { Pulumi.run(App::stack); } public static void stack(Context ctx) { var privateRecordSet = new PrivateRecordSet("privateRecordSet", PrivateRecordSetArgs.builder() .metadata(Map.of("key1", "value1")) .privateZoneName("privatezone1.com") .recordType("TXT") .relativeRecordSetName("recordTXT") .resourceGroupName("resourceGroup1") .ttl(3600) .txtRecords(Map.of("value", "string1", "string2")) .build()); } } ``` ## Import An existing resource can be imported using its type token, name, and identifier, e.g. ```sh $ pulumi import azure-native:network:PrivateRecordSet recordtxt /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/privateDnsZones/{privateZoneName}/{recordType}/{relativeRecordSetName} ```
    • Nested Class Summary

      • Nested classes/interfaces inherited from class com.pulumi.resources.CustomResource

        com.pulumi.resources.CustomResource.CustomResourceInternal
      • Nested classes/interfaces inherited from class com.pulumi.resources.Resource

        com.pulumi.resources.Resource.LazyField<T extends java.lang.Object>, com.pulumi.resources.Resource.LazyFields, com.pulumi.resources.Resource.ResourceInternal
    • Field Summary

      • Fields inherited from class com.pulumi.resources.Resource

        childResources, remote
    • Method Summary

      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      com.pulumi.core.Output<java.util.Optional<java.util.List<AaaaRecordResponse>>> aaaaRecords()  
      com.pulumi.core.Output<java.util.Optional<java.util.List<ARecordResponse>>> aRecords()  
      com.pulumi.core.Output<java.util.Optional<CnameRecordResponse>> cnameRecord()  
      com.pulumi.core.Output<java.util.Optional<java.lang.String>> etag()  
      com.pulumi.core.Output<java.lang.String> fqdn()  
      static PrivateRecordSet get​(java.lang.String name, com.pulumi.core.Output<java.lang.String> id, com.pulumi.resources.CustomResourceOptions options)
      Get an existing Host resource's state with the given name, ID, and optional extra properties used to qualify the lookup.
      com.pulumi.core.Output<java.lang.Boolean> isAutoRegistered()  
      com.pulumi.core.Output<java.util.Optional<java.util.Map<java.lang.String,​java.lang.String>>> metadata()  
      com.pulumi.core.Output<java.util.Optional<java.util.List<MxRecordResponse>>> mxRecords()  
      com.pulumi.core.Output<java.lang.String> name()  
      com.pulumi.core.Output<java.util.Optional<java.util.List<PtrRecordResponse>>> ptrRecords()  
      com.pulumi.core.Output<java.util.Optional<SoaRecordResponse>> soaRecord()  
      com.pulumi.core.Output<java.util.Optional<java.util.List<SrvRecordResponse>>> srvRecords()  
      com.pulumi.core.Output<java.util.Optional<java.lang.Double>> ttl()  
      com.pulumi.core.Output<java.util.Optional<java.util.List<TxtRecordResponse>>> txtRecords()  
      com.pulumi.core.Output<java.lang.String> type()  
      • Methods inherited from class com.pulumi.resources.CustomResource

        getId, id, idFuture
      • Methods inherited from class com.pulumi.resources.Resource

        getChildResources, getResourceName, getResourceType, getUrn, pulumiChildResources, pulumiResourceName, pulumiResourceType, urn
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Constructor Detail

      • PrivateRecordSet

        public PrivateRecordSet​(java.lang.String name)
        Parameters:
        name - The _unique_ name of the resulting resource.
      • PrivateRecordSet

        public PrivateRecordSet​(java.lang.String name,
                                PrivateRecordSetArgs args)
        Parameters:
        name - The _unique_ name of the resulting resource.
        args - The arguments to use to populate this resource's properties.
      • PrivateRecordSet

        public PrivateRecordSet​(java.lang.String name,
                                PrivateRecordSetArgs args,
                                @Nullable
                                com.pulumi.resources.CustomResourceOptions options)
        Parameters:
        name - The _unique_ name of the resulting resource.
        args - The arguments to use to populate this resource's properties.
        options - A bag of options that control this resource's behavior.
    • Method Detail

      • aRecords

        public com.pulumi.core.Output<java.util.Optional<java.util.List<ARecordResponse>>> aRecords()
        Returns:
        The list of A records in the record set.
      • aaaaRecords

        public com.pulumi.core.Output<java.util.Optional<java.util.List<AaaaRecordResponse>>> aaaaRecords()
        Returns:
        The list of AAAA records in the record set.
      • cnameRecord

        public com.pulumi.core.Output<java.util.Optional<CnameRecordResponse>> cnameRecord()
        Returns:
        The CNAME record in the record set.
      • etag

        public com.pulumi.core.Output<java.util.Optional<java.lang.String>> etag()
        Returns:
        The ETag of the record set.
      • fqdn

        public com.pulumi.core.Output<java.lang.String> fqdn()
        Returns:
        Fully qualified domain name of the record set.
      • isAutoRegistered

        public com.pulumi.core.Output<java.lang.Boolean> isAutoRegistered()
        Returns:
        Is the record set auto-registered in the Private DNS zone through a virtual network link?
      • metadata

        public com.pulumi.core.Output<java.util.Optional<java.util.Map<java.lang.String,​java.lang.String>>> metadata()
        Returns:
        The metadata attached to the record set.
      • mxRecords

        public com.pulumi.core.Output<java.util.Optional<java.util.List<MxRecordResponse>>> mxRecords()
        Returns:
        The list of MX records in the record set.
      • name

        public com.pulumi.core.Output<java.lang.String> name()
        Returns:
        The name of the resource
      • ptrRecords

        public com.pulumi.core.Output<java.util.Optional<java.util.List<PtrRecordResponse>>> ptrRecords()
        Returns:
        The list of PTR records in the record set.
      • soaRecord

        public com.pulumi.core.Output<java.util.Optional<SoaRecordResponse>> soaRecord()
        Returns:
        The SOA record in the record set.
      • srvRecords

        public com.pulumi.core.Output<java.util.Optional<java.util.List<SrvRecordResponse>>> srvRecords()
        Returns:
        The list of SRV records in the record set.
      • ttl

        public com.pulumi.core.Output<java.util.Optional<java.lang.Double>> ttl()
        Returns:
        The TTL (time-to-live) of the records in the record set.
      • txtRecords

        public com.pulumi.core.Output<java.util.Optional<java.util.List<TxtRecordResponse>>> txtRecords()
        Returns:
        The list of TXT records in the record set.
      • type

        public com.pulumi.core.Output<java.lang.String> type()
        Returns:
        The type of the resource. Example - 'Microsoft.Network/privateDnsZones'.
      • get

        public static PrivateRecordSet get​(java.lang.String name,
                                           com.pulumi.core.Output<java.lang.String> id,
                                           @Nullable
                                           com.pulumi.resources.CustomResourceOptions options)
        Get an existing Host resource's state with the given name, ID, and optional extra properties used to qualify the lookup.
        Parameters:
        name - The _unique_ name of the resulting resource.
        id - The _unique_ provider ID of the resource to lookup.
        options - Optional settings to control the behavior of the CustomResource.