pulumi-oci 2.13.0__py3-none-any.whl → 2.13.0a1729059403__py3-none-any.whl

pulumi_oci/dns/record.py

@@ -326,12 +326,11 @@ class Record(pulumi.CustomResource):
 
         This resource provides the Record resource in Oracle Cloud Infrastructure DNS service.
 
-          Updates a collection of records in the specified zone.
-
-        You can update one record or all records for the specified zone depending on the changes provided in the
-        request body. You can also add or remove records using this function. When the zone name is provided as
-        a path parameter and `PRIVATE` is used for the scope query parameter then the viewId query parameter is
-        required.
+        Replaces records in the specified zone with the records specified in the
+        request body. If a specified record does not exist, it will be created.
+        If the record exists, then it will be updated to represent the record in
+        the body of the request. If a record in the zone does not exist in the
+        request body, the record will be removed from the zone.
 
         ## Example Usage
 
@@ -343,6 +342,7 @@ class Record(pulumi.CustomResource):
             zone_name_or_id=test_zone_name_or["id"],
             domain=record_items_domain,
             rtype=record_items_rtype,
+            compartment_id=compartment_id,
             rdata=record_items_rdata,
             ttl=record_items_ttl)
         ```
@@ -375,12 +375,11 @@ class Record(pulumi.CustomResource):
 
         This resource provides the Record resource in Oracle Cloud Infrastructure DNS service.
 
-          Updates a collection of records in the specified zone.
-
-        You can update one record or all records for the specified zone depending on the changes provided in the
-        request body. You can also add or remove records using this function. When the zone name is provided as
-        a path parameter and `PRIVATE` is used for the scope query parameter then the viewId query parameter is
-        required.
+        Replaces records in the specified zone with the records specified in the
+        request body. If a specified record does not exist, it will be created.
+        If the record exists, then it will be updated to represent the record in
+        the body of the request. If a record in the zone does not exist in the
+        request body, the record will be removed from the zone.
 
         ## Example Usage
 
@@ -392,6 +391,7 @@ class Record(pulumi.CustomResource):
             zone_name_or_id=test_zone_name_or["id"],
             domain=record_items_domain,
             rtype=record_items_rtype,
+            compartment_id=compartment_id,
             rdata=record_items_rdata,
             ttl=record_items_ttl)
         ```

pulumi_oci/dns/resolver.py

@@ -42,7 +42,7 @@ class ResolverArgs:
                
                **Example:** `{"Department": "Finance"}`
         :param pulumi.Input[Sequence[pulumi.Input['ResolverRuleArgs']]] rules: (Updatable) Rules for the resolver. Rules are evaluated in order.
-        :param pulumi.Input[str] scope: Specifies to operate only on resources that have a matching DNS scope. 
+        :param pulumi.Input[str] scope: If specified, must be `PRIVATE` when creating private name resolvers. 
                
                
                ** IMPORTANT **
@@ -156,7 +156,7 @@ class ResolverArgs:
     @pulumi.getter
     def scope(self) -> Optional[pulumi.Input[str]]:
         """
-        Specifies to operate only on resources that have a matching DNS scope. 
+        If specified, must be `PRIVATE` when creating private name resolvers. 
 
 
         ** IMPORTANT **
@@ -205,7 +205,7 @@ class _ResolverState:
         :param pulumi.Input[bool] is_protected: A Boolean flag indicating whether or not parts of the resource are unable to be explicitly managed.
         :param pulumi.Input[str] resolver_id: The OCID of the target resolver.
         :param pulumi.Input[Sequence[pulumi.Input['ResolverRuleArgs']]] rules: (Updatable) Rules for the resolver. Rules are evaluated in order.
-        :param pulumi.Input[str] scope: Specifies to operate only on resources that have a matching DNS scope. 
+        :param pulumi.Input[str] scope: If specified, must be `PRIVATE` when creating private name resolvers. 
                
                
                ** IMPORTANT **
@@ -388,7 +388,7 @@ class _ResolverState:
     @pulumi.getter
     def scope(self) -> Optional[pulumi.Input[str]]:
         """
-        Specifies to operate only on resources that have a matching DNS scope. 
+        If specified, must be `PRIVATE` when creating private name resolvers. 
 
 
         ** IMPORTANT **
@@ -492,7 +492,7 @@ class Resolver(pulumi.CustomResource):
                **Example:** `{"Department": "Finance"}`
         :param pulumi.Input[str] resolver_id: The OCID of the target resolver.
         :param pulumi.Input[Sequence[pulumi.Input[Union['ResolverRuleArgs', 'ResolverRuleArgsDict']]]] rules: (Updatable) Rules for the resolver. Rules are evaluated in order.
-        :param pulumi.Input[str] scope: Specifies to operate only on resources that have a matching DNS scope. 
+        :param pulumi.Input[str] scope: If specified, must be `PRIVATE` when creating private name resolvers. 
                
                
                ** IMPORTANT **
@@ -618,7 +618,7 @@ class Resolver(pulumi.CustomResource):
         :param pulumi.Input[bool] is_protected: A Boolean flag indicating whether or not parts of the resource are unable to be explicitly managed.
         :param pulumi.Input[str] resolver_id: The OCID of the target resolver.
         :param pulumi.Input[Sequence[pulumi.Input[Union['ResolverRuleArgs', 'ResolverRuleArgsDict']]]] rules: (Updatable) Rules for the resolver. Rules are evaluated in order.
-        :param pulumi.Input[str] scope: Specifies to operate only on resources that have a matching DNS scope. 
+        :param pulumi.Input[str] scope: If specified, must be `PRIVATE` when creating private name resolvers. 
                
                
                ** IMPORTANT **
@@ -746,7 +746,7 @@ class Resolver(pulumi.CustomResource):
     @pulumi.getter
     def scope(self) -> pulumi.Output[Optional[str]]:
         """
-        Specifies to operate only on resources that have a matching DNS scope. 
+        If specified, must be `PRIVATE` when creating private name resolvers. 
 
 
         ** IMPORTANT **

pulumi_oci/dns/resolver_endpoint.py

@@ -463,7 +463,7 @@ class ResolverEndpoint(pulumi.CustomResource):
         """
         This resource provides the Resolver Endpoint resource in Oracle Cloud Infrastructure DNS service.
 
-        Creates a new resolver endpoint in the same compartment as the resolver.
+        Creates a new resolver endpoint. Requires a `PRIVATE` scope query parameter.
 
         ## Example Usage
 
@@ -523,7 +523,7 @@ class ResolverEndpoint(pulumi.CustomResource):
         """
         This resource provides the Resolver Endpoint resource in Oracle Cloud Infrastructure DNS service.
 
-        Creates a new resolver endpoint in the same compartment as the resolver.
+        Creates a new resolver endpoint. Requires a `PRIVATE` scope query parameter.
 
         ## Example Usage
 

pulumi_oci/dns/rrset.py

@@ -37,13 +37,12 @@ class RrsetArgs:
                
                ** IMPORTANT **
                Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
-        :param pulumi.Input[str] compartment_id: (Updatable) The OCID of the compartment the zone belongs to.
-               
-               This parameter is deprecated and should be omitted.
+        :param pulumi.Input[str] compartment_id: (Updatable) The OCID of the compartment the resource belongs to.
         :param pulumi.Input[Sequence[pulumi.Input['RrsetItemArgs']]] items: (Updatable) 
-               **NOTE** Omitting `items` at time of create will delete any existing records in the RRSet
-        :param pulumi.Input[str] scope: Specifies to operate only on resources that have a matching DNS scope.
-        :param pulumi.Input[str] view_id: The OCID of the view the zone is associated with. Required when accessing a private zone by name.
+               **NOTE** Omitting `items` at time of create, will delete any existing records in the RRSet
+        :param pulumi.Input[str] scope: Specifies to operate only on resources that have a matching DNS scope. 
+               This value will be null for zones in the global DNS and `PRIVATE` when creating private Rrsets.
+        :param pulumi.Input[str] view_id: The OCID of the view the resource is associated with.
         """
         pulumi.set(__self__, "domain", domain)
         pulumi.set(__self__, "rtype", rtype)
@@ -101,9 +100,7 @@ class RrsetArgs:
     @pulumi.getter(name="compartmentId")
     def compartment_id(self) -> Optional[pulumi.Input[str]]:
         """
-        (Updatable) The OCID of the compartment the zone belongs to.
-
-        This parameter is deprecated and should be omitted.
+        (Updatable) The OCID of the compartment the resource belongs to.
         """
         return pulumi.get(self, "compartment_id")
 
@@ -116,7 +113,7 @@ class RrsetArgs:
     def items(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['RrsetItemArgs']]]]:
         """
         (Updatable) 
-        **NOTE** Omitting `items` at time of create will delete any existing records in the RRSet
+        **NOTE** Omitting `items` at time of create, will delete any existing records in the RRSet
         """
         return pulumi.get(self, "items")
 
@@ -128,7 +125,8 @@ class RrsetArgs:
     @pulumi.getter
     def scope(self) -> Optional[pulumi.Input[str]]:
         """
-        Specifies to operate only on resources that have a matching DNS scope.
+        Specifies to operate only on resources that have a matching DNS scope. 
+        This value will be null for zones in the global DNS and `PRIVATE` when creating private Rrsets.
         """
         return pulumi.get(self, "scope")
 
@@ -140,7 +138,7 @@ class RrsetArgs:
     @pulumi.getter(name="viewId")
     def view_id(self) -> Optional[pulumi.Input[str]]:
         """
-        The OCID of the view the zone is associated with. Required when accessing a private zone by name.
+        The OCID of the view the resource is associated with.
         """
         return pulumi.get(self, "view_id")
 
@@ -161,15 +159,14 @@ class _RrsetState:
                  zone_name_or_id: Optional[pulumi.Input[str]] = None):
         """
         Input properties used for looking up and filtering Rrset resources.
-        :param pulumi.Input[str] compartment_id: (Updatable) The OCID of the compartment the zone belongs to.
-               
-               This parameter is deprecated and should be omitted.
+        :param pulumi.Input[str] compartment_id: (Updatable) The OCID of the compartment the resource belongs to.
         :param pulumi.Input[str] domain: The target fully-qualified domain name (FQDN) within the target zone.
         :param pulumi.Input[Sequence[pulumi.Input['RrsetItemArgs']]] items: (Updatable) 
-               **NOTE** Omitting `items` at time of create will delete any existing records in the RRSet
+               **NOTE** Omitting `items` at time of create, will delete any existing records in the RRSet
         :param pulumi.Input[str] rtype: The type of the target RRSet within the target zone.
-        :param pulumi.Input[str] scope: Specifies to operate only on resources that have a matching DNS scope.
-        :param pulumi.Input[str] view_id: The OCID of the view the zone is associated with. Required when accessing a private zone by name.
+        :param pulumi.Input[str] scope: Specifies to operate only on resources that have a matching DNS scope. 
+               This value will be null for zones in the global DNS and `PRIVATE` when creating private Rrsets.
+        :param pulumi.Input[str] view_id: The OCID of the view the resource is associated with.
         :param pulumi.Input[str] zone_name_or_id: The name or OCID of the target zone.
                
                
@@ -195,9 +192,7 @@ class _RrsetState:
     @pulumi.getter(name="compartmentId")
     def compartment_id(self) -> Optional[pulumi.Input[str]]:
         """
-        (Updatable) The OCID of the compartment the zone belongs to.
-
-        This parameter is deprecated and should be omitted.
+        (Updatable) The OCID of the compartment the resource belongs to.
         """
         return pulumi.get(self, "compartment_id")
 
@@ -222,7 +217,7 @@ class _RrsetState:
     def items(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['RrsetItemArgs']]]]:
         """
         (Updatable) 
-        **NOTE** Omitting `items` at time of create will delete any existing records in the RRSet
+        **NOTE** Omitting `items` at time of create, will delete any existing records in the RRSet
         """
         return pulumi.get(self, "items")
 
@@ -246,7 +241,8 @@ class _RrsetState:
     @pulumi.getter
     def scope(self) -> Optional[pulumi.Input[str]]:
         """
-        Specifies to operate only on resources that have a matching DNS scope.
+        Specifies to operate only on resources that have a matching DNS scope. 
+        This value will be null for zones in the global DNS and `PRIVATE` when creating private Rrsets.
         """
         return pulumi.get(self, "scope")
 
@@ -258,7 +254,7 @@ class _RrsetState:
     @pulumi.getter(name="viewId")
     def view_id(self) -> Optional[pulumi.Input[str]]:
         """
-        The OCID of the view the zone is associated with. Required when accessing a private zone by name.
+        The OCID of the view the resource is associated with.
         """
         return pulumi.get(self, "view_id")
 
@@ -299,10 +295,8 @@ class Rrset(pulumi.CustomResource):
         """
         This resource provides the Rrset resource in Oracle Cloud Infrastructure DNS service.
 
-          Updates records in the specified RRSet.
-
-        When the zone name is provided as a path parameter and `PRIVATE` is used for the scope query
-        parameter then the viewId query parameter is required.
+        Replaces records in the specified RRSet. When the zone name is provided as a path parameter
+        and the zone has a scope of `PRIVATE` then the viewId query parameter is required.
 
         ## Example Usage
 
@@ -314,6 +308,7 @@ class Rrset(pulumi.CustomResource):
             domain=rrset_domain,
             rtype=rrset_rtype,
             zone_name_or_id=test_zone["id"],
+            compartment_id=compartment_id,
             items=[{
                 "domain": rrset_items_domain,
                 "rdata": rrset_items_rdata,
@@ -340,15 +335,14 @@ class Rrset(pulumi.CustomResource):
 
         :param str resource_name: The name of the resource.
         :param pulumi.ResourceOptions opts: Options for the resource.
-        :param pulumi.Input[str] compartment_id: (Updatable) The OCID of the compartment the zone belongs to.
-               
-               This parameter is deprecated and should be omitted.
+        :param pulumi.Input[str] compartment_id: (Updatable) The OCID of the compartment the resource belongs to.
         :param pulumi.Input[str] domain: The target fully-qualified domain name (FQDN) within the target zone.
         :param pulumi.Input[Sequence[pulumi.Input[Union['RrsetItemArgs', 'RrsetItemArgsDict']]]] items: (Updatable) 
-               **NOTE** Omitting `items` at time of create will delete any existing records in the RRSet
+               **NOTE** Omitting `items` at time of create, will delete any existing records in the RRSet
         :param pulumi.Input[str] rtype: The type of the target RRSet within the target zone.
-        :param pulumi.Input[str] scope: Specifies to operate only on resources that have a matching DNS scope.
-        :param pulumi.Input[str] view_id: The OCID of the view the zone is associated with. Required when accessing a private zone by name.
+        :param pulumi.Input[str] scope: Specifies to operate only on resources that have a matching DNS scope. 
+               This value will be null for zones in the global DNS and `PRIVATE` when creating private Rrsets.
+        :param pulumi.Input[str] view_id: The OCID of the view the resource is associated with.
         :param pulumi.Input[str] zone_name_or_id: The name or OCID of the target zone.
                
                
@@ -364,10 +358,8 @@ class Rrset(pulumi.CustomResource):
         """
         This resource provides the Rrset resource in Oracle Cloud Infrastructure DNS service.
 
-          Updates records in the specified RRSet.
-
-        When the zone name is provided as a path parameter and `PRIVATE` is used for the scope query
-        parameter then the viewId query parameter is required.
+        Replaces records in the specified RRSet. When the zone name is provided as a path parameter
+        and the zone has a scope of `PRIVATE` then the viewId query parameter is required.
 
         ## Example Usage
 
@@ -379,6 +371,7 @@ class Rrset(pulumi.CustomResource):
             domain=rrset_domain,
             rtype=rrset_rtype,
             zone_name_or_id=test_zone["id"],
+            compartment_id=compartment_id,
             items=[{
                 "domain": rrset_items_domain,
                 "rdata": rrset_items_rdata,
@@ -471,15 +464,14 @@ class Rrset(pulumi.CustomResource):
         :param str resource_name: The unique name of the resulting resource.
         :param pulumi.Input[str] id: The unique provider ID of the resource to lookup.
         :param pulumi.ResourceOptions opts: Options for the resource.
-        :param pulumi.Input[str] compartment_id: (Updatable) The OCID of the compartment the zone belongs to.
-               
-               This parameter is deprecated and should be omitted.
+        :param pulumi.Input[str] compartment_id: (Updatable) The OCID of the compartment the resource belongs to.
         :param pulumi.Input[str] domain: The target fully-qualified domain name (FQDN) within the target zone.
         :param pulumi.Input[Sequence[pulumi.Input[Union['RrsetItemArgs', 'RrsetItemArgsDict']]]] items: (Updatable) 
-               **NOTE** Omitting `items` at time of create will delete any existing records in the RRSet
+               **NOTE** Omitting `items` at time of create, will delete any existing records in the RRSet
         :param pulumi.Input[str] rtype: The type of the target RRSet within the target zone.
-        :param pulumi.Input[str] scope: Specifies to operate only on resources that have a matching DNS scope.
-        :param pulumi.Input[str] view_id: The OCID of the view the zone is associated with. Required when accessing a private zone by name.
+        :param pulumi.Input[str] scope: Specifies to operate only on resources that have a matching DNS scope. 
+               This value will be null for zones in the global DNS and `PRIVATE` when creating private Rrsets.
+        :param pulumi.Input[str] view_id: The OCID of the view the resource is associated with.
         :param pulumi.Input[str] zone_name_or_id: The name or OCID of the target zone.
                
                
@@ -503,9 +495,7 @@ class Rrset(pulumi.CustomResource):
     @pulumi.getter(name="compartmentId")
     def compartment_id(self) -> pulumi.Output[str]:
         """
-        (Updatable) The OCID of the compartment the zone belongs to.
-
-        This parameter is deprecated and should be omitted.
+        (Updatable) The OCID of the compartment the resource belongs to.
         """
         return pulumi.get(self, "compartment_id")
 
@@ -522,7 +512,7 @@ class Rrset(pulumi.CustomResource):
     def items(self) -> pulumi.Output[Sequence['outputs.RrsetItem']]:
         """
         (Updatable) 
-        **NOTE** Omitting `items` at time of create will delete any existing records in the RRSet
+        **NOTE** Omitting `items` at time of create, will delete any existing records in the RRSet
         """
         return pulumi.get(self, "items")
 
@@ -538,7 +528,8 @@ class Rrset(pulumi.CustomResource):
     @pulumi.getter
     def scope(self) -> pulumi.Output[Optional[str]]:
         """
-        Specifies to operate only on resources that have a matching DNS scope.
+        Specifies to operate only on resources that have a matching DNS scope. 
+        This value will be null for zones in the global DNS and `PRIVATE` when creating private Rrsets.
         """
         return pulumi.get(self, "scope")
 
@@ -546,7 +537,7 @@ class Rrset(pulumi.CustomResource):
     @pulumi.getter(name="viewId")
     def view_id(self) -> pulumi.Output[Optional[str]]:
         """
-        The OCID of the view the zone is associated with. Required when accessing a private zone by name.
+        The OCID of the view the resource is associated with.
         """
         return pulumi.get(self, "view_id")