pulumi-consul 3.11.1__py3-none-any.whl → 3.11.3__py3-none-any.whl

pulumi_consul/config_entry_service_splitter.py

@@ -26,8 +26,8 @@ class ConfigEntryServiceSplitterArgs:
         :param pulumi.Input[Sequence[pulumi.Input['ConfigEntryServiceSplitterSplitArgs']]] splits: Defines how much traffic to send to sets of service instances during a traffic split.
         :param pulumi.Input[Mapping[str, pulumi.Input[str]]] meta: Specifies key-value pairs to add to the KV store.
         :param pulumi.Input[str] name: Specifies a name for the configuration entry.
-        :param pulumi.Input[str] namespace: Specifies the namespace to use in the FQDN when resolving the service.
-        :param pulumi.Input[str] partition: Specifies the admin partition to use in the FQDN when resolving the service.
+        :param pulumi.Input[str] namespace: Specifies the namespace to apply the configuration entry.
+        :param pulumi.Input[str] partition: Specifies the admin partition to apply the configuration entry.
         """
         pulumi.set(__self__, "splits", splits)
         if meta is not None:
@@ -79,7 +79,7 @@ class ConfigEntryServiceSplitterArgs:
     @pulumi.getter
     def namespace(self) -> Optional[pulumi.Input[str]]:
         """
-        Specifies the namespace to use in the FQDN when resolving the service.
+        Specifies the namespace to apply the configuration entry.
         """
         return pulumi.get(self, "namespace")
 
@@ -91,7 +91,7 @@ class ConfigEntryServiceSplitterArgs:
     @pulumi.getter
     def partition(self) -> Optional[pulumi.Input[str]]:
         """
-        Specifies the admin partition to use in the FQDN when resolving the service.
+        Specifies the admin partition to apply the configuration entry.
         """
         return pulumi.get(self, "partition")
 
@@ -112,8 +112,8 @@ class _ConfigEntryServiceSplitterState:
         Input properties used for looking up and filtering ConfigEntryServiceSplitter resources.
         :param pulumi.Input[Mapping[str, pulumi.Input[str]]] meta: Specifies key-value pairs to add to the KV store.
         :param pulumi.Input[str] name: Specifies a name for the configuration entry.
-        :param pulumi.Input[str] namespace: Specifies the namespace to use in the FQDN when resolving the service.
-        :param pulumi.Input[str] partition: Specifies the admin partition to use in the FQDN when resolving the service.
+        :param pulumi.Input[str] namespace: Specifies the namespace to apply the configuration entry.
+        :param pulumi.Input[str] partition: Specifies the admin partition to apply the configuration entry.
         :param pulumi.Input[Sequence[pulumi.Input['ConfigEntryServiceSplitterSplitArgs']]] splits: Defines how much traffic to send to sets of service instances during a traffic split.
         """
         if meta is not None:
@@ -155,7 +155,7 @@ class _ConfigEntryServiceSplitterState:
     @pulumi.getter
     def namespace(self) -> Optional[pulumi.Input[str]]:
         """
-        Specifies the namespace to use in the FQDN when resolving the service.
+        Specifies the namespace to apply the configuration entry.
         """
         return pulumi.get(self, "namespace")
 
@@ -167,7 +167,7 @@ class _ConfigEntryServiceSplitterState:
     @pulumi.getter
     def partition(self) -> Optional[pulumi.Input[str]]:
         """
-        Specifies the admin partition to use in the FQDN when resolving the service.
+        Specifies the admin partition to apply the configuration entry.
         """
         return pulumi.get(self, "partition")
 
@@ -200,8 +200,6 @@ class ConfigEntryServiceSplitter(pulumi.CustomResource):
                  splits: Optional[pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['ConfigEntryServiceSplitterSplitArgs']]]]] = None,
                  __props__=None):
         """
-        The `ConfigEntryServiceSplitter` resource configures a [service splitter](https://developer.hashicorp.com/consul/docs/connect/config-entries/service-splitter) that will redirect a percentage of incoming traffic requests for a service to one or more specific service instances.
-
         ## Example Usage
 
         ```python
@@ -210,6 +208,7 @@ class ConfigEntryServiceSplitter(pulumi.CustomResource):
         import pulumi_consul as consul
 
         web = consul.ConfigEntry("web",
+            name="web",
             kind="service-defaults",
             config_json=json.dumps({
                 "Protocol": "http",
@@ -217,7 +216,8 @@ class ConfigEntryServiceSplitter(pulumi.CustomResource):
                 "MeshGateway": {},
                 "TransparentProxy": {},
             }))
-        service_resolver = consul.ConfigEntryServiceResolver("serviceResolver",
+        service_resolver = consul.ConfigEntryServiceResolver("service_resolver",
+            name="service-resolver",
             default_subset="v1",
             subsets=[
                 consul.ConfigEntryServiceResolverSubsetArgs(
@@ -230,6 +230,7 @@ class ConfigEntryServiceSplitter(pulumi.CustomResource):
                 ),
             ])
         foo = consul.ConfigEntryServiceSplitter("foo",
+            name=service_resolver.name,
             meta={
                 "key": "value",
             },
@@ -275,15 +276,15 @@ class ConfigEntryServiceSplitter(pulumi.CustomResource):
         ## Import
 
         ```sh
-         $ pulumi import consul:index/configEntryServiceSplitter:ConfigEntryServiceSplitter foo web
+        $ pulumi import consul:index/configEntryServiceSplitter:ConfigEntryServiceSplitter foo web
         ```
 
         :param str resource_name: The name of the resource.
         :param pulumi.ResourceOptions opts: Options for the resource.
         :param pulumi.Input[Mapping[str, pulumi.Input[str]]] meta: Specifies key-value pairs to add to the KV store.
         :param pulumi.Input[str] name: Specifies a name for the configuration entry.
-        :param pulumi.Input[str] namespace: Specifies the namespace to use in the FQDN when resolving the service.
-        :param pulumi.Input[str] partition: Specifies the admin partition to use in the FQDN when resolving the service.
+        :param pulumi.Input[str] namespace: Specifies the namespace to apply the configuration entry.
+        :param pulumi.Input[str] partition: Specifies the admin partition to apply the configuration entry.
         :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['ConfigEntryServiceSplitterSplitArgs']]]] splits: Defines how much traffic to send to sets of service instances during a traffic split.
         """
         ...
@@ -293,8 +294,6 @@ class ConfigEntryServiceSplitter(pulumi.CustomResource):
                  args: ConfigEntryServiceSplitterArgs,
                  opts: Optional[pulumi.ResourceOptions] = None):
         """
-        The `ConfigEntryServiceSplitter` resource configures a [service splitter](https://developer.hashicorp.com/consul/docs/connect/config-entries/service-splitter) that will redirect a percentage of incoming traffic requests for a service to one or more specific service instances.
-
         ## Example Usage
 
         ```python
@@ -303,6 +302,7 @@ class ConfigEntryServiceSplitter(pulumi.CustomResource):
         import pulumi_consul as consul
 
         web = consul.ConfigEntry("web",
+            name="web",
             kind="service-defaults",
             config_json=json.dumps({
                 "Protocol": "http",
@@ -310,7 +310,8 @@ class ConfigEntryServiceSplitter(pulumi.CustomResource):
                 "MeshGateway": {},
                 "TransparentProxy": {},
             }))
-        service_resolver = consul.ConfigEntryServiceResolver("serviceResolver",
+        service_resolver = consul.ConfigEntryServiceResolver("service_resolver",
+            name="service-resolver",
             default_subset="v1",
             subsets=[
                 consul.ConfigEntryServiceResolverSubsetArgs(
@@ -323,6 +324,7 @@ class ConfigEntryServiceSplitter(pulumi.CustomResource):
                 ),
             ])
         foo = consul.ConfigEntryServiceSplitter("foo",
+            name=service_resolver.name,
             meta={
                 "key": "value",
             },
@@ -368,7 +370,7 @@ class ConfigEntryServiceSplitter(pulumi.CustomResource):
         ## Import
 
         ```sh
-         $ pulumi import consul:index/configEntryServiceSplitter:ConfigEntryServiceSplitter foo web
+        $ pulumi import consul:index/configEntryServiceSplitter:ConfigEntryServiceSplitter foo web
         ```
 
         :param str resource_name: The name of the resource.
@@ -431,8 +433,8 @@ class ConfigEntryServiceSplitter(pulumi.CustomResource):
         :param pulumi.ResourceOptions opts: Options for the resource.
         :param pulumi.Input[Mapping[str, pulumi.Input[str]]] meta: Specifies key-value pairs to add to the KV store.
         :param pulumi.Input[str] name: Specifies a name for the configuration entry.
-        :param pulumi.Input[str] namespace: Specifies the namespace to use in the FQDN when resolving the service.
-        :param pulumi.Input[str] partition: Specifies the admin partition to use in the FQDN when resolving the service.
+        :param pulumi.Input[str] namespace: Specifies the namespace to apply the configuration entry.
+        :param pulumi.Input[str] partition: Specifies the admin partition to apply the configuration entry.
         :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['ConfigEntryServiceSplitterSplitArgs']]]] splits: Defines how much traffic to send to sets of service instances during a traffic split.
         """
         opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
@@ -466,7 +468,7 @@ class ConfigEntryServiceSplitter(pulumi.CustomResource):
     @pulumi.getter
     def namespace(self) -> pulumi.Output[Optional[str]]:
         """
-        Specifies the namespace to use in the FQDN when resolving the service.
+        Specifies the namespace to apply the configuration entry.
         """
         return pulumi.get(self, "namespace")
 
@@ -474,7 +476,7 @@ class ConfigEntryServiceSplitter(pulumi.CustomResource):
     @pulumi.getter
     def partition(self) -> pulumi.Output[Optional[str]]:
         """
-        Specifies the admin partition to use in the FQDN when resolving the service.
+        Specifies the admin partition to apply the configuration entry.
         """
         return pulumi.get(self, "partition")
 

pulumi_consul/get_acl_role.py

@@ -159,6 +159,7 @@ def get_acl_role(name: Optional[str] = None,
     ```
 
 
+    :param str name: The name of the ACL Role.
     :param str namespace: The namespace to lookup the role.
     :param str partition: The partition to lookup the role.
     """
@@ -200,6 +201,7 @@ def get_acl_role_output(name: Optional[pulumi.Input[str]] = None,
     ```
 
 
+    :param str name: The name of the ACL Role.
     :param str namespace: The namespace to lookup the role.
     :param str partition: The partition to lookup the role.
     """

pulumi_consul/get_acl_token_secret_id.py

@@ -113,12 +113,13 @@ def get_acl_token_secret_id(accessor_id: Optional[str] = None,
     import pulumi
     import pulumi_consul as consul
 
-    test_acl_policy = consul.AclPolicy("testAclPolicy",
+    test = consul.AclPolicy("test",
+        name="test",
         rules="node \\"\\" { policy = \\"read\\" }",
         datacenters=["dc1"])
-    test_acl_token = consul.AclToken("testAclToken",
+    test_acl_token = consul.AclToken("test",
         description="test",
-        policies=[test_acl_policy.name],
+        policies=[test.name],
         local=True)
     read = consul.get_acl_token_secret_id_output(accessor_id=test_acl_token.id,
         pgp_key="keybase:my_username")
@@ -161,12 +162,13 @@ def get_acl_token_secret_id_output(accessor_id: Optional[pulumi.Input[str]] = No
     import pulumi
     import pulumi_consul as consul
 
-    test_acl_policy = consul.AclPolicy("testAclPolicy",
+    test = consul.AclPolicy("test",
+        name="test",
         rules="node \\"\\" { policy = \\"read\\" }",
         datacenters=["dc1"])
-    test_acl_token = consul.AclToken("testAclToken",
+    test_acl_token = consul.AclToken("test",
         description="test",
-        policies=[test_acl_policy.name],
+        policies=[test.name],
         local=True)
     read = consul.get_acl_token_secret_id_output(accessor_id=test_acl_token.id,
         pgp_key="keybase:my_username")

pulumi_consul/get_catalog_service.py

@@ -132,13 +132,26 @@ def get_catalog_service(datacenter: Optional[str] = None,
     This data source is different from the `get_services` (plural) data
     source, which provides a summary of the current Consul services.
 
+    ## Example Usage
+
+    ```python
+    import pulumi
+    import pulumi_consul as consul
+    import pulumi_example as example
+    import pulumi_std as std
+
+    read_consul_dc1 = consul.get_service(name="consul",
+        datacenter="dc1")
+    # Set the description to a whitespace delimited list of the node names
+    app = example.index.Resource("app", description=std.join(separator= ,
+        input=nodes).result)
+    ```
+
 
     :param str datacenter: The Consul datacenter to query.  Defaults to the
            same value found in `query_options` parameter specified below, or if that is
            empty, the `datacenter` value found in the Consul agent that this provider is
            configured to talk to.
-    :param str filter: A filter expression to refine the query, see https://www.consul.io/api-docs/features/filtering
-           and https://www.consul.io/api-docs/catalog#filtering-1.
     :param str name: The service name to select.
     :param Sequence[pulumi.InputType['GetCatalogServiceQueryOptionArgs']] query_options: See below.
     :param str tag: A single tag that can be used to filter the list of nodes
@@ -181,13 +194,26 @@ def get_catalog_service_output(datacenter: Optional[pulumi.Input[Optional[str]]]
     This data source is different from the `get_services` (plural) data
     source, which provides a summary of the current Consul services.
 
+    ## Example Usage
+
+    ```python
+    import pulumi
+    import pulumi_consul as consul
+    import pulumi_example as example
+    import pulumi_std as std
+
+    read_consul_dc1 = consul.get_service(name="consul",
+        datacenter="dc1")
+    # Set the description to a whitespace delimited list of the node names
+    app = example.index.Resource("app", description=std.join(separator= ,
+        input=nodes).result)
+    ```
+
 
     :param str datacenter: The Consul datacenter to query.  Defaults to the
            same value found in `query_options` parameter specified below, or if that is
            empty, the `datacenter` value found in the Consul agent that this provider is
            configured to talk to.
-    :param str filter: A filter expression to refine the query, see https://www.consul.io/api-docs/features/filtering
-           and https://www.consul.io/api-docs/catalog#filtering-1.
     :param str name: The service name to select.
     :param Sequence[pulumi.InputType['GetCatalogServiceQueryOptionArgs']] query_options: See below.
     :param str tag: A single tag that can be used to filter the list of nodes

pulumi_consul/get_catalog_services.py

@@ -113,6 +113,22 @@ def get_catalog_services(query_options: Optional[Sequence[pulumi.InputType['GetC
     This data source is different from the `Service` (singular) data
     source, which provides a detailed response about a specific Consul service.
 
+    ## Example Usage
+
+    ```python
+    import pulumi
+    import pulumi_consul as consul
+    import pulumi_example as example
+    import pulumi_std as std
+
+    read_dc1 = consul.get_services(query_options=[consul.GetServicesQueryOptionArgs(
+        datacenter="dc1",
+    )])
+    # Set the description to a whitespace delimited list of the services
+    app = example.index.Resource("app", description=std.join(separator= ,
+        input=names).result)
+    ```
+
 
     :param Sequence[pulumi.InputType['GetCatalogServicesQueryOptionArgs']] query_options: See below.
     """
@@ -143,6 +159,22 @@ def get_catalog_services_output(query_options: Optional[pulumi.Input[Optional[Se
     This data source is different from the `Service` (singular) data
     source, which provides a detailed response about a specific Consul service.
 
+    ## Example Usage
+
+    ```python
+    import pulumi
+    import pulumi_consul as consul
+    import pulumi_example as example
+    import pulumi_std as std
+
+    read_dc1 = consul.get_services(query_options=[consul.GetServicesQueryOptionArgs(
+        datacenter="dc1",
+    )])
+    # Set the description to a whitespace delimited list of the services
+    app = example.index.Resource("app", description=std.join(separator= ,
+        input=names).result)
+    ```
+
 
     :param Sequence[pulumi.InputType['GetCatalogServicesQueryOptionArgs']] query_options: See below.
     """

pulumi_consul/get_key_prefix.py

@@ -150,16 +150,16 @@ def get_key_prefix(datacenter: Optional[str] = None,
     import pulumi_aws as aws
     import pulumi_consul as consul
 
-    app_key_prefix = consul.get_key_prefix(datacenter="nyc1",
+    app = consul.get_key_prefix(datacenter="nyc1",
+        token="abcd",
         path_prefix="myapp/config/",
         subkey_collection=[consul.GetKeyPrefixSubkeyCollectionArgs(
-            default="ami-1234",
             name="ami",
             path="app/launch_ami",
-        )],
-        token="abcd")
+            default="ami-1234",
+        )])
     # Start our instance with the dynamic ami value
-    app_instance = aws.ec2.Instance("appInstance", ami=app_key_prefix.var["ami"])
+    app_instance = aws.index.Instance("app", ami=app.var.ami)
     ```
 
     ```python
@@ -167,11 +167,11 @@ def get_key_prefix(datacenter: Optional[str] = None,
     import pulumi_aws as aws
     import pulumi_consul as consul
 
-    web_key_prefix = consul.get_key_prefix(datacenter="nyc1",
-        path_prefix="myapp/config/",
-        token="efgh")
+    web = consul.get_key_prefix(datacenter="nyc1",
+        token="efgh",
+        path_prefix="myapp/config/")
     # Start our instance with the dynamic ami value
-    web_instance = aws.ec2.Instance("webInstance", ami=web_key_prefix.subkeys["app/launch_ami"])
+    web_instance = aws.index.Instance("web", ami=web.subkeys.app_launch_ami)
     ```
 
 
@@ -225,16 +225,16 @@ def get_key_prefix_output(datacenter: Optional[pulumi.Input[Optional[str]]] = No
     import pulumi_aws as aws
     import pulumi_consul as consul
 
-    app_key_prefix = consul.get_key_prefix(datacenter="nyc1",
+    app = consul.get_key_prefix(datacenter="nyc1",
+        token="abcd",
         path_prefix="myapp/config/",
         subkey_collection=[consul.GetKeyPrefixSubkeyCollectionArgs(
-            default="ami-1234",
             name="ami",
             path="app/launch_ami",
-        )],
-        token="abcd")
+            default="ami-1234",
+        )])
     # Start our instance with the dynamic ami value
-    app_instance = aws.ec2.Instance("appInstance", ami=app_key_prefix.var["ami"])
+    app_instance = aws.index.Instance("app", ami=app.var.ami)
     ```
 
     ```python
@@ -242,11 +242,11 @@ def get_key_prefix_output(datacenter: Optional[pulumi.Input[Optional[str]]] = No
     import pulumi_aws as aws
     import pulumi_consul as consul
 
-    web_key_prefix = consul.get_key_prefix(datacenter="nyc1",
-        path_prefix="myapp/config/",
-        token="efgh")
+    web = consul.get_key_prefix(datacenter="nyc1",
+        token="efgh",
+        path_prefix="myapp/config/")
     # Start our instance with the dynamic ami value
-    web_instance = aws.ec2.Instance("webInstance", ami=web_key_prefix.subkeys["app/launch_ami"])
+    web_instance = aws.index.Instance("web", ami=web.subkeys.app_launch_ami)
     ```
 
 

pulumi_consul/get_keys.py

@@ -152,15 +152,14 @@ def get_keys(datacenter: Optional[str] = None,
     import pulumi_aws as aws
     import pulumi_consul as consul
 
-    app_keys = consul.get_keys(datacenter="nyc1",
+    app = consul.get_keys(datacenter="nyc1",
         keys=[consul.GetKeysKeyArgs(
             name="ami",
             path="service/app/launch_ami",
             default="ami-1234",
         )])
     # Start our instance with the dynamic ami value
-    app_instance = aws.ec2.Instance("appInstance", ami=app_keys.var["ami"])
-    # ...
+    app_instance = aws.index.Instance("app", ami=app.var.ami)
     ```
 
 
@@ -210,15 +209,14 @@ def get_keys_output(datacenter: Optional[pulumi.Input[Optional[str]]] = None,
     import pulumi_aws as aws
     import pulumi_consul as consul
 
-    app_keys = consul.get_keys(datacenter="nyc1",
+    app = consul.get_keys(datacenter="nyc1",
         keys=[consul.GetKeysKeyArgs(
             name="ami",
             path="service/app/launch_ami",
             default="ami-1234",
         )])
     # Start our instance with the dynamic ami value
-    app_instance = aws.ec2.Instance("appInstance", ami=app_keys.var["ami"])
-    # ...
+    app_instance = aws.index.Instance("app", ami=app.var.ami)
     ```
 
 

pulumi_consul/get_network_area_members.py

@@ -111,12 +111,12 @@ def get_network_area_members(datacenter: Optional[str] = None,
     import pulumi
     import pulumi_consul as consul
 
-    dc2_network_area = consul.NetworkArea("dc2NetworkArea",
+    dc2_network_area = consul.NetworkArea("dc2",
         peer_datacenter="dc2",
         retry_joins=["1.2.3.4"],
         use_tls=True)
-    dc2_network_area_members = consul.get_network_area_members_output(uuid=dc2_network_area.id)
-    pulumi.export("members", dc2_network_area_members.members)
+    dc2 = consul.get_network_area_members_output(uuid=dc2_network_area.id)
+    pulumi.export("members", dc2.members)
     ```
 
 
@@ -158,12 +158,12 @@ def get_network_area_members_output(datacenter: Optional[pulumi.Input[Optional[s
     import pulumi
     import pulumi_consul as consul
 
-    dc2_network_area = consul.NetworkArea("dc2NetworkArea",
+    dc2_network_area = consul.NetworkArea("dc2",
         peer_datacenter="dc2",
         retry_joins=["1.2.3.4"],
         use_tls=True)
-    dc2_network_area_members = consul.get_network_area_members_output(uuid=dc2_network_area.id)
-    pulumi.export("members", dc2_network_area_members.members)
+    dc2 = consul.get_network_area_members_output(uuid=dc2_network_area.id)
+    pulumi.export("members", dc2.members)
     ```
 
 

pulumi_consul/get_network_segments.py

@@ -97,8 +97,8 @@ def get_network_segments(datacenter: Optional[str] = None,
     import pulumi
     import pulumi_consul as consul
 
-    segments_network_segments = consul.get_network_segments()
-    pulumi.export("segments", segments_network_segments.segments)
+    segments = consul.get_network_segments()
+    pulumi.export("segments", segments.segments)
     ```
 
 
@@ -136,8 +136,8 @@ def get_network_segments_output(datacenter: Optional[pulumi.Input[Optional[str]]
     import pulumi
     import pulumi_consul as consul
 
-    segments_network_segments = consul.get_network_segments()
-    pulumi.export("segments", segments_network_segments.segments)
+    segments = consul.get_network_segments()
+    pulumi.export("segments", segments.segments)
     ```
 
 

pulumi_consul/get_service.py

@@ -130,13 +130,26 @@ def get_service(datacenter: Optional[str] = None,
     This data source is different from the `get_services` (plural) data
     source, which provides a summary of the current Consul services.
 
+    ## Example Usage
+
+    ```python
+    import pulumi
+    import pulumi_consul as consul
+    import pulumi_example as example
+    import pulumi_std as std
+
+    read_consul_dc1 = consul.get_service(name="consul",
+        datacenter="dc1")
+    # Set the description to a whitespace delimited list of the node names
+    app = example.index.Resource("app", description=std.join(separator= ,
+        input=nodes).result)
+    ```
+
 
     :param str datacenter: The Consul datacenter to query.  Defaults to the
            same value found in `query_options` parameter specified below, or if that is
            empty, the `datacenter` value found in the Consul agent that this provider is
            configured to talk to.
-    :param str filter: A filter expression to refine the query, see https://www.consul.io/api-docs/features/filtering
-           and https://www.consul.io/api-docs/catalog#filtering-1.
     :param str name: The service name to select.
     :param Sequence[pulumi.InputType['GetServiceQueryOptionArgs']] query_options: See below.
     :param str tag: A single tag that can be used to filter the list of nodes
@@ -178,13 +191,26 @@ def get_service_output(datacenter: Optional[pulumi.Input[Optional[str]]] = None,
     This data source is different from the `get_services` (plural) data
     source, which provides a summary of the current Consul services.
 
+    ## Example Usage
+
+    ```python
+    import pulumi
+    import pulumi_consul as consul
+    import pulumi_example as example
+    import pulumi_std as std
+
+    read_consul_dc1 = consul.get_service(name="consul",
+        datacenter="dc1")
+    # Set the description to a whitespace delimited list of the node names
+    app = example.index.Resource("app", description=std.join(separator= ,
+        input=nodes).result)
+    ```
+
 
     :param str datacenter: The Consul datacenter to query.  Defaults to the
            same value found in `query_options` parameter specified below, or if that is
            empty, the `datacenter` value found in the Consul agent that this provider is
            configured to talk to.
-    :param str filter: A filter expression to refine the query, see https://www.consul.io/api-docs/features/filtering
-           and https://www.consul.io/api-docs/catalog#filtering-1.
     :param str name: The service name to select.
     :param Sequence[pulumi.InputType['GetServiceQueryOptionArgs']] query_options: See below.
     :param str tag: A single tag that can be used to filter the list of nodes

pulumi_consul/get_services.py

@@ -111,6 +111,22 @@ def get_services(query_options: Optional[Sequence[pulumi.InputType['GetServicesQ
     This data source is different from the `Service` (singular) data
     source, which provides a detailed response about a specific Consul service.
 
+    ## Example Usage
+
+    ```python
+    import pulumi
+    import pulumi_consul as consul
+    import pulumi_example as example
+    import pulumi_std as std
+
+    read_dc1 = consul.get_services(query_options=[consul.GetServicesQueryOptionArgs(
+        datacenter="dc1",
+    )])
+    # Set the description to a whitespace delimited list of the services
+    app = example.index.Resource("app", description=std.join(separator= ,
+        input=names).result)
+    ```
+
 
     :param Sequence[pulumi.InputType['GetServicesQueryOptionArgs']] query_options: See below.
     """
@@ -140,6 +156,22 @@ def get_services_output(query_options: Optional[pulumi.Input[Optional[Sequence[p
     This data source is different from the `Service` (singular) data
     source, which provides a detailed response about a specific Consul service.
 
+    ## Example Usage
+
+    ```python
+    import pulumi
+    import pulumi_consul as consul
+    import pulumi_example as example
+    import pulumi_std as std
+
+    read_dc1 = consul.get_services(query_options=[consul.GetServicesQueryOptionArgs(
+        datacenter="dc1",
+    )])
+    # Set the description to a whitespace delimited list of the services
+    app = example.index.Resource("app", description=std.join(separator= ,
+        input=names).result)
+    ```
+
 
     :param Sequence[pulumi.InputType['GetServicesQueryOptionArgs']] query_options: See below.
     """