pulumi-oci 2.16.0a1731393786__py3-none-any.whl → 2.17.0__py3-none-any.whl

pulumi_oci/generativeai/get_agent_data_source.py

@@ -0,0 +1,286 @@
+# coding=utf-8
+# *** WARNING: this file was generated by the Pulumi Terraform Bridge (tfgen) Tool. ***
+# *** Do not edit by hand unless you're certain you know what you are doing! ***
+
+import copy
+import warnings
+import sys
+import pulumi
+import pulumi.runtime
+from typing import Any, Mapping, Optional, Sequence, Union, overload
+if sys.version_info >= (3, 11):
+    from typing import NotRequired, TypedDict, TypeAlias
+else:
+    from typing_extensions import NotRequired, TypedDict, TypeAlias
+from .. import _utilities
+from . import outputs
+
+__all__ = [
+    'GetAgentDataSourceResult',
+    'AwaitableGetAgentDataSourceResult',
+    'get_agent_data_source',
+    'get_agent_data_source_output',
+]
+
+@pulumi.output_type
+class GetAgentDataSourceResult:
+    """
+    A collection of values returned by getAgentDataSource.
+    """
+    def __init__(__self__, compartment_id=None, data_source_configs=None, data_source_id=None, defined_tags=None, description=None, display_name=None, freeform_tags=None, id=None, knowledge_base_id=None, lifecycle_details=None, state=None, system_tags=None, time_created=None, time_updated=None):
+        if compartment_id and not isinstance(compartment_id, str):
+            raise TypeError("Expected argument 'compartment_id' to be a str")
+        pulumi.set(__self__, "compartment_id", compartment_id)
+        if data_source_configs and not isinstance(data_source_configs, list):
+            raise TypeError("Expected argument 'data_source_configs' to be a list")
+        pulumi.set(__self__, "data_source_configs", data_source_configs)
+        if data_source_id and not isinstance(data_source_id, str):
+            raise TypeError("Expected argument 'data_source_id' to be a str")
+        pulumi.set(__self__, "data_source_id", data_source_id)
+        if defined_tags and not isinstance(defined_tags, dict):
+            raise TypeError("Expected argument 'defined_tags' to be a dict")
+        pulumi.set(__self__, "defined_tags", defined_tags)
+        if description and not isinstance(description, str):
+            raise TypeError("Expected argument 'description' to be a str")
+        pulumi.set(__self__, "description", description)
+        if display_name and not isinstance(display_name, str):
+            raise TypeError("Expected argument 'display_name' to be a str")
+        pulumi.set(__self__, "display_name", display_name)
+        if freeform_tags and not isinstance(freeform_tags, dict):
+            raise TypeError("Expected argument 'freeform_tags' to be a dict")
+        pulumi.set(__self__, "freeform_tags", freeform_tags)
+        if id and not isinstance(id, str):
+            raise TypeError("Expected argument 'id' to be a str")
+        pulumi.set(__self__, "id", id)
+        if knowledge_base_id and not isinstance(knowledge_base_id, str):
+            raise TypeError("Expected argument 'knowledge_base_id' to be a str")
+        pulumi.set(__self__, "knowledge_base_id", knowledge_base_id)
+        if lifecycle_details and not isinstance(lifecycle_details, str):
+            raise TypeError("Expected argument 'lifecycle_details' to be a str")
+        pulumi.set(__self__, "lifecycle_details", lifecycle_details)
+        if state and not isinstance(state, str):
+            raise TypeError("Expected argument 'state' to be a str")
+        pulumi.set(__self__, "state", state)
+        if system_tags and not isinstance(system_tags, dict):
+            raise TypeError("Expected argument 'system_tags' to be a dict")
+        pulumi.set(__self__, "system_tags", system_tags)
+        if time_created and not isinstance(time_created, str):
+            raise TypeError("Expected argument 'time_created' to be a str")
+        pulumi.set(__self__, "time_created", time_created)
+        if time_updated and not isinstance(time_updated, str):
+            raise TypeError("Expected argument 'time_updated' to be a str")
+        pulumi.set(__self__, "time_updated", time_updated)
+
+    @property
+    @pulumi.getter(name="compartmentId")
+    def compartment_id(self) -> str:
+        """
+        The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the compartment.
+        """
+        return pulumi.get(self, "compartment_id")
+
+    @property
+    @pulumi.getter(name="dataSourceConfigs")
+    def data_source_configs(self) -> Sequence['outputs.GetAgentDataSourceDataSourceConfigResult']:
+        """
+        **DataSourceConfig**
+        """
+        return pulumi.get(self, "data_source_configs")
+
+    @property
+    @pulumi.getter(name="dataSourceId")
+    def data_source_id(self) -> str:
+        return pulumi.get(self, "data_source_id")
+
+    @property
+    @pulumi.getter(name="definedTags")
+    def defined_tags(self) -> Mapping[str, str]:
+        """
+        Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see [Resource Tags](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/resourcetags.htm).  Example: `{"Operations.CostCenter": "42"}`
+        """
+        return pulumi.get(self, "defined_tags")
+
+    @property
+    @pulumi.getter
+    def description(self) -> str:
+        """
+        A description of the data source.
+        """
+        return pulumi.get(self, "description")
+
+    @property
+    @pulumi.getter(name="displayName")
+    def display_name(self) -> str:
+        """
+        A user-friendly name. Does not have to be unique, and it's changeable.
+        """
+        return pulumi.get(self, "display_name")
+
+    @property
+    @pulumi.getter(name="freeformTags")
+    def freeform_tags(self) -> Mapping[str, str]:
+        """
+        Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see [Resource Tags](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/resourcetags.htm).  Example: `{"Department": "Finance"}`
+        """
+        return pulumi.get(self, "freeform_tags")
+
+    @property
+    @pulumi.getter
+    def id(self) -> str:
+        """
+        The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the data source.
+        """
+        return pulumi.get(self, "id")
+
+    @property
+    @pulumi.getter(name="knowledgeBaseId")
+    def knowledge_base_id(self) -> str:
+        """
+        The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the parent KnowledgeBase.
+        """
+        return pulumi.get(self, "knowledge_base_id")
+
+    @property
+    @pulumi.getter(name="lifecycleDetails")
+    def lifecycle_details(self) -> str:
+        """
+        A message that describes the current state of the data source in more detail. For example, can be used to provide actionable information for a resource in the Failed state.
+        """
+        return pulumi.get(self, "lifecycle_details")
+
+    @property
+    @pulumi.getter
+    def state(self) -> str:
+        """
+        The current state of the data source.
+        """
+        return pulumi.get(self, "state")
+
+    @property
+    @pulumi.getter(name="systemTags")
+    def system_tags(self) -> Mapping[str, str]:
+        """
+        System tags for this resource. Each key is predefined and scoped to a namespace.  Example: `{"orcl-cloud.free-tier-retained": "true"}`
+        """
+        return pulumi.get(self, "system_tags")
+
+    @property
+    @pulumi.getter(name="timeCreated")
+    def time_created(self) -> str:
+        """
+        The date and time the data source was created, in the format defined by [RFC 3339](https://tools.ietf.org/html/rfc3339).  Example: `2016-08-25T21:10:29.600Z`
+        """
+        return pulumi.get(self, "time_created")
+
+    @property
+    @pulumi.getter(name="timeUpdated")
+    def time_updated(self) -> str:
+        """
+        The date and time the data source was updated, in the format defined by [RFC 3339](https://tools.ietf.org/html/rfc3339).  Example: `2016-08-25T21:10:29.600Z`
+        """
+        return pulumi.get(self, "time_updated")
+
+
+class AwaitableGetAgentDataSourceResult(GetAgentDataSourceResult):
+    # pylint: disable=using-constant-test
+    def __await__(self):
+        if False:
+            yield self
+        return GetAgentDataSourceResult(
+            compartment_id=self.compartment_id,
+            data_source_configs=self.data_source_configs,
+            data_source_id=self.data_source_id,
+            defined_tags=self.defined_tags,
+            description=self.description,
+            display_name=self.display_name,
+            freeform_tags=self.freeform_tags,
+            id=self.id,
+            knowledge_base_id=self.knowledge_base_id,
+            lifecycle_details=self.lifecycle_details,
+            state=self.state,
+            system_tags=self.system_tags,
+            time_created=self.time_created,
+            time_updated=self.time_updated)
+
+
+def get_agent_data_source(data_source_id: Optional[str] = None,
+                          opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetAgentDataSourceResult:
+    """
+    This data source provides details about a specific Data Source resource in Oracle Cloud Infrastructure Generative Ai Agent service.
+
+    **GetDataSource**
+
+    Gets information about a data source.
+
+    ## Example Usage
+
+    ```python
+    import pulumi
+    import pulumi_oci as oci
+
+    test_data_source = oci.GenerativeAi.get_agent_data_source(data_source_id=test_data_source_oci_generative_ai_agent_data_source["id"])
+    ```
+
+
+    :param str data_source_id: The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the data source.
+    """
+    __args__ = dict()
+    __args__['dataSourceId'] = data_source_id
+    opts = pulumi.InvokeOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke('oci:GenerativeAi/getAgentDataSource:getAgentDataSource', __args__, opts=opts, typ=GetAgentDataSourceResult).value
+
+    return AwaitableGetAgentDataSourceResult(
+        compartment_id=pulumi.get(__ret__, 'compartment_id'),
+        data_source_configs=pulumi.get(__ret__, 'data_source_configs'),
+        data_source_id=pulumi.get(__ret__, 'data_source_id'),
+        defined_tags=pulumi.get(__ret__, 'defined_tags'),
+        description=pulumi.get(__ret__, 'description'),
+        display_name=pulumi.get(__ret__, 'display_name'),
+        freeform_tags=pulumi.get(__ret__, 'freeform_tags'),
+        id=pulumi.get(__ret__, 'id'),
+        knowledge_base_id=pulumi.get(__ret__, 'knowledge_base_id'),
+        lifecycle_details=pulumi.get(__ret__, 'lifecycle_details'),
+        state=pulumi.get(__ret__, 'state'),
+        system_tags=pulumi.get(__ret__, 'system_tags'),
+        time_created=pulumi.get(__ret__, 'time_created'),
+        time_updated=pulumi.get(__ret__, 'time_updated'))
+def get_agent_data_source_output(data_source_id: Optional[pulumi.Input[str]] = None,
+                                 opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetAgentDataSourceResult]:
+    """
+    This data source provides details about a specific Data Source resource in Oracle Cloud Infrastructure Generative Ai Agent service.
+
+    **GetDataSource**
+
+    Gets information about a data source.
+
+    ## Example Usage
+
+    ```python
+    import pulumi
+    import pulumi_oci as oci
+
+    test_data_source = oci.GenerativeAi.get_agent_data_source(data_source_id=test_data_source_oci_generative_ai_agent_data_source["id"])
+    ```
+
+
+    :param str data_source_id: The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the data source.
+    """
+    __args__ = dict()
+    __args__['dataSourceId'] = data_source_id
+    opts = pulumi.InvokeOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke_output('oci:GenerativeAi/getAgentDataSource:getAgentDataSource', __args__, opts=opts, typ=GetAgentDataSourceResult)
+    return __ret__.apply(lambda __response__: GetAgentDataSourceResult(
+        compartment_id=pulumi.get(__response__, 'compartment_id'),
+        data_source_configs=pulumi.get(__response__, 'data_source_configs'),
+        data_source_id=pulumi.get(__response__, 'data_source_id'),
+        defined_tags=pulumi.get(__response__, 'defined_tags'),
+        description=pulumi.get(__response__, 'description'),
+        display_name=pulumi.get(__response__, 'display_name'),
+        freeform_tags=pulumi.get(__response__, 'freeform_tags'),
+        id=pulumi.get(__response__, 'id'),
+        knowledge_base_id=pulumi.get(__response__, 'knowledge_base_id'),
+        lifecycle_details=pulumi.get(__response__, 'lifecycle_details'),
+        state=pulumi.get(__response__, 'state'),
+        system_tags=pulumi.get(__response__, 'system_tags'),
+        time_created=pulumi.get(__response__, 'time_created'),
+        time_updated=pulumi.get(__response__, 'time_updated')))

pulumi_oci/generativeai/get_agent_data_sources.py

@@ -0,0 +1,217 @@
+# coding=utf-8
+# *** WARNING: this file was generated by the Pulumi Terraform Bridge (tfgen) Tool. ***
+# *** Do not edit by hand unless you're certain you know what you are doing! ***
+
+import copy
+import warnings
+import sys
+import pulumi
+import pulumi.runtime
+from typing import Any, Mapping, Optional, Sequence, Union, overload
+if sys.version_info >= (3, 11):
+    from typing import NotRequired, TypedDict, TypeAlias
+else:
+    from typing_extensions import NotRequired, TypedDict, TypeAlias
+from .. import _utilities
+from . import outputs
+from ._inputs import *
+
+__all__ = [
+    'GetAgentDataSourcesResult',
+    'AwaitableGetAgentDataSourcesResult',
+    'get_agent_data_sources',
+    'get_agent_data_sources_output',
+]
+
+@pulumi.output_type
+class GetAgentDataSourcesResult:
+    """
+    A collection of values returned by getAgentDataSources.
+    """
+    def __init__(__self__, compartment_id=None, data_source_collections=None, display_name=None, filters=None, id=None, knowledge_base_id=None, state=None):
+        if compartment_id and not isinstance(compartment_id, str):
+            raise TypeError("Expected argument 'compartment_id' to be a str")
+        pulumi.set(__self__, "compartment_id", compartment_id)
+        if data_source_collections and not isinstance(data_source_collections, list):
+            raise TypeError("Expected argument 'data_source_collections' to be a list")
+        pulumi.set(__self__, "data_source_collections", data_source_collections)
+        if display_name and not isinstance(display_name, str):
+            raise TypeError("Expected argument 'display_name' to be a str")
+        pulumi.set(__self__, "display_name", display_name)
+        if filters and not isinstance(filters, list):
+            raise TypeError("Expected argument 'filters' to be a list")
+        pulumi.set(__self__, "filters", filters)
+        if id and not isinstance(id, str):
+            raise TypeError("Expected argument 'id' to be a str")
+        pulumi.set(__self__, "id", id)
+        if knowledge_base_id and not isinstance(knowledge_base_id, str):
+            raise TypeError("Expected argument 'knowledge_base_id' to be a str")
+        pulumi.set(__self__, "knowledge_base_id", knowledge_base_id)
+        if state and not isinstance(state, str):
+            raise TypeError("Expected argument 'state' to be a str")
+        pulumi.set(__self__, "state", state)
+
+    @property
+    @pulumi.getter(name="compartmentId")
+    def compartment_id(self) -> Optional[str]:
+        """
+        The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the compartment.
+        """
+        return pulumi.get(self, "compartment_id")
+
+    @property
+    @pulumi.getter(name="dataSourceCollections")
+    def data_source_collections(self) -> Sequence['outputs.GetAgentDataSourcesDataSourceCollectionResult']:
+        """
+        The list of data_source_collection.
+        """
+        return pulumi.get(self, "data_source_collections")
+
+    @property
+    @pulumi.getter(name="displayName")
+    def display_name(self) -> Optional[str]:
+        """
+        A user-friendly name. Does not have to be unique, and it's changeable.
+        """
+        return pulumi.get(self, "display_name")
+
+    @property
+    @pulumi.getter
+    def filters(self) -> Optional[Sequence['outputs.GetAgentDataSourcesFilterResult']]:
+        return pulumi.get(self, "filters")
+
+    @property
+    @pulumi.getter
+    def id(self) -> str:
+        """
+        The provider-assigned unique ID for this managed resource.
+        """
+        return pulumi.get(self, "id")
+
+    @property
+    @pulumi.getter(name="knowledgeBaseId")
+    def knowledge_base_id(self) -> Optional[str]:
+        """
+        The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the parent KnowledgeBase.
+        """
+        return pulumi.get(self, "knowledge_base_id")
+
+    @property
+    @pulumi.getter
+    def state(self) -> Optional[str]:
+        """
+        The current state of the data source.
+        """
+        return pulumi.get(self, "state")
+
+
+class AwaitableGetAgentDataSourcesResult(GetAgentDataSourcesResult):
+    # pylint: disable=using-constant-test
+    def __await__(self):
+        if False:
+            yield self
+        return GetAgentDataSourcesResult(
+            compartment_id=self.compartment_id,
+            data_source_collections=self.data_source_collections,
+            display_name=self.display_name,
+            filters=self.filters,
+            id=self.id,
+            knowledge_base_id=self.knowledge_base_id,
+            state=self.state)
+
+
+def get_agent_data_sources(compartment_id: Optional[str] = None,
+                           display_name: Optional[str] = None,
+                           filters: Optional[Sequence[Union['GetAgentDataSourcesFilterArgs', 'GetAgentDataSourcesFilterArgsDict']]] = None,
+                           knowledge_base_id: Optional[str] = None,
+                           state: Optional[str] = None,
+                           opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetAgentDataSourcesResult:
+    """
+    This data source provides the list of Data Sources in Oracle Cloud Infrastructure Generative Ai Agent service.
+
+    **ListDataSources**
+
+    Gets a list of data sources.
+
+    ## Example Usage
+
+    ```python
+    import pulumi
+    import pulumi_oci as oci
+
+    test_data_sources = oci.GenerativeAi.get_agent_data_sources(compartment_id=compartment_id,
+        display_name=data_source_display_name,
+        knowledge_base_id=test_knowledge_base["id"],
+        state=data_source_state)
+    ```
+
+
+    :param str compartment_id: The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the compartment in which to list resources.
+    :param str display_name: A filter to return only resources that match the given display name exactly.
+    :param str knowledge_base_id: The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the knowledge base.
+    :param str state: A filter to return only resources that match the given lifecycle state. The state value is case-insensitive.
+    """
+    __args__ = dict()
+    __args__['compartmentId'] = compartment_id
+    __args__['displayName'] = display_name
+    __args__['filters'] = filters
+    __args__['knowledgeBaseId'] = knowledge_base_id
+    __args__['state'] = state
+    opts = pulumi.InvokeOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke('oci:GenerativeAi/getAgentDataSources:getAgentDataSources', __args__, opts=opts, typ=GetAgentDataSourcesResult).value
+
+    return AwaitableGetAgentDataSourcesResult(
+        compartment_id=pulumi.get(__ret__, 'compartment_id'),
+        data_source_collections=pulumi.get(__ret__, 'data_source_collections'),
+        display_name=pulumi.get(__ret__, 'display_name'),
+        filters=pulumi.get(__ret__, 'filters'),
+        id=pulumi.get(__ret__, 'id'),
+        knowledge_base_id=pulumi.get(__ret__, 'knowledge_base_id'),
+        state=pulumi.get(__ret__, 'state'))
+def get_agent_data_sources_output(compartment_id: Optional[pulumi.Input[Optional[str]]] = None,
+                                  display_name: Optional[pulumi.Input[Optional[str]]] = None,
+                                  filters: Optional[pulumi.Input[Optional[Sequence[Union['GetAgentDataSourcesFilterArgs', 'GetAgentDataSourcesFilterArgsDict']]]]] = None,
+                                  knowledge_base_id: Optional[pulumi.Input[Optional[str]]] = None,
+                                  state: Optional[pulumi.Input[Optional[str]]] = None,
+                                  opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetAgentDataSourcesResult]:
+    """
+    This data source provides the list of Data Sources in Oracle Cloud Infrastructure Generative Ai Agent service.
+
+    **ListDataSources**
+
+    Gets a list of data sources.
+
+    ## Example Usage
+
+    ```python
+    import pulumi
+    import pulumi_oci as oci
+
+    test_data_sources = oci.GenerativeAi.get_agent_data_sources(compartment_id=compartment_id,
+        display_name=data_source_display_name,
+        knowledge_base_id=test_knowledge_base["id"],
+        state=data_source_state)
+    ```
+
+
+    :param str compartment_id: The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the compartment in which to list resources.
+    :param str display_name: A filter to return only resources that match the given display name exactly.
+    :param str knowledge_base_id: The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the knowledge base.
+    :param str state: A filter to return only resources that match the given lifecycle state. The state value is case-insensitive.
+    """
+    __args__ = dict()
+    __args__['compartmentId'] = compartment_id
+    __args__['displayName'] = display_name
+    __args__['filters'] = filters
+    __args__['knowledgeBaseId'] = knowledge_base_id
+    __args__['state'] = state
+    opts = pulumi.InvokeOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke_output('oci:GenerativeAi/getAgentDataSources:getAgentDataSources', __args__, opts=opts, typ=GetAgentDataSourcesResult)
+    return __ret__.apply(lambda __response__: GetAgentDataSourcesResult(
+        compartment_id=pulumi.get(__response__, 'compartment_id'),
+        data_source_collections=pulumi.get(__response__, 'data_source_collections'),
+        display_name=pulumi.get(__response__, 'display_name'),
+        filters=pulumi.get(__response__, 'filters'),
+        id=pulumi.get(__response__, 'id'),
+        knowledge_base_id=pulumi.get(__response__, 'knowledge_base_id'),
+        state=pulumi.get(__response__, 'state')))