OneDrive¶
Creates a Carbon data connector configured for Microsoft OneDrive. It delegates all behavior to the shared Carbon data-connector base, setting the integration to OneDrive so documents and files from a connected OneDrive account can be ingested and used downstream.
Usage¶
Use this node when you need to connect a OneDrive account as a data source for document ingestion and retrieval within a Salt workflow. Place it early in your pipeline to establish the data connection; subsequent nodes can consume the resulting data handle or dataset to search, retrieve, or process files.
Inputs¶
| Field | Required | Type | Description | Example |
|---|---|---|---|---|
| Not specified | False | Not specified | Inputs are defined by the shared Carbon data connector base. This node only specifies that the target integration is OneDrive. | Not specified |
Outputs¶
| Field | Type | Description | Example |
|---|---|---|---|
| Not specified | Not specified | Outputs are defined by the shared Carbon data connector base. Typically this is a data handle or dataset reference representing the connected OneDrive source. | Not specified |
Important Notes¶
- Integration Target: This node strictly targets the OneDrive integration; it cannot be repurposed for other sources.
- Authentication Required: A valid OneDrive authorization (and any required organizational consent) must be completed for access.
- Permissions Matter: The connector will only access files the authenticated user or service principal is permitted to read.
- Ingestion Timing: Initial syncs and indexing may take time depending on data volume and organizational policies.
- Service Dependency: Functionality depends on the Carbon data service and its configuration in your environment.
Troubleshooting¶
- Authentication fails: Re-run the OneDrive authorization flow and ensure the correct tenant and account are used. Verify any required admin consent has been granted.
- No files returned: Confirm the authenticated account has read access to the intended folders/files and that the data has finished syncing/indexing.
- Rate limits or throttling: OneDrive API limits can apply. Retry later or reduce the frequency/volume of requests.
- Permissions errors: Check OneDrive/Entra ID (Azure AD) app permissions and scopes granted to the integration, and ensure the user/service principal has appropriate access.
- Service unavailable: Verify the Carbon service is reachable and healthy in your environment; check network and service status.