def METHOD_NAME(parent_id: Optional[pulumi.Input[str]] = None,
                       opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetFoldersResult]:
    """
    Retrieve information about a set of folders based on a parent ID. See the
    [REST API](https://cloud.google.com/resource-manager/reference/rest/v3/folders/list)
    for more details.
    ## Example Usage
    ### Searching For Folders At The Root Of An Org
    ```python
    import pulumi
    import pulumi_gcp as gcp
    my_org_folders = gcp.organizations.get_folders(parent_id=f"organizations/{var['organization_id']}")
    first_folder = gcp.organizations.get_folder(folder=my_org_folders.folders[0].name)
    ```
    :param str parent_id: A string parent as defined in the [REST API](https://cloud.google.com/resource-manager/reference/rest/v3/folders/list#query-parameters).
    """
    ...