- [Resource: DeltaSharingCatalog](https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/deltasharing.v1.projects.catalogs#DeltaSharingCatalog)
  - [JSON representation](https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/deltasharing.v1.projects.catalogs#DeltaSharingCatalog.SCHEMA_REPRESENTATION)
- [SapConfig](https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/deltasharing.v1.projects.catalogs#SapConfig)
  - [JSON representation](https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/deltasharing.v1.projects.catalogs#SapConfig.SCHEMA_REPRESENTATION)
- [SapBdcEnrollmentConfig](https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/deltasharing.v1.projects.catalogs#SapBdcEnrollmentConfig)
  - [JSON representation](https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/deltasharing.v1.projects.catalogs#SapBdcEnrollmentConfig.SCHEMA_REPRESENTATION)
- [RefreshOptions](https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/deltasharing.v1.projects.catalogs#RefreshOptions)
  - [JSON representation](https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/deltasharing.v1.projects.catalogs#RefreshOptions.SCHEMA_REPRESENTATION)
- [RefreshSchedule](https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/deltasharing.v1.projects.catalogs#RefreshSchedule)
  - [JSON representation](https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/deltasharing.v1.projects.catalogs#RefreshSchedule.SCHEMA_REPRESENTATION)
- [RefreshStatus](https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/deltasharing.v1.projects.catalogs#RefreshStatus)
  - [JSON representation](https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/deltasharing.v1.projects.catalogs#RefreshStatus.SCHEMA_REPRESENTATION)
- [FederatedCatalogOptions](https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/deltasharing.v1.projects.catalogs#FederatedCatalogOptions)
  - [JSON representation](https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/deltasharing.v1.projects.catalogs#FederatedCatalogOptions.SCHEMA_REPRESENTATION)
- [Methods](https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/deltasharing.v1.projects.catalogs#METHODS_SUMMARY)

## Resource: DeltaSharingCatalog

Represents a DeltaSharing catalog.

| JSON representation |
|---|
| ``` { "name": string, "location": string, "createTime": string, "updateTime": string, "serviceAccount": string, "refreshOptions": { object (`https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/deltasharing.v1.projects.catalogs#RefreshOptions`) }, "refreshStatus": { object (`https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/deltasharing.v1.projects.catalogs#RefreshStatus`) }, "federatedCatalogOptions": { object (`https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/deltasharing.v1.projects.catalogs#FederatedCatalogOptions`) }, // Union field `config` can be only one of the following: "sapConfig": { object (`https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/deltasharing.v1.projects.catalogs#SapConfig`) } // End of list of possible types for union field `config`. } ``` |

| Fields ||
|---|---|
| `name` | `string` Identifier. The resource name. Format: projects/{project}/catalogs/{catalog} |
| `location` | `string` Required. Immutable. The user-provided Google Cloud location of the catalog. This field is immutable. |
| `createTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. The creation time of the catalog. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `updateTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. The last modification time of the catalog. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `serviceAccount` | `string` Output only. The service account used for SAP enrollment and is created as a side effect of creating the Delta Sharing catalog resource. |
| `refreshOptions` | ``object (`https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/deltasharing.v1.projects.catalogs#RefreshOptions`)`` Optional. Configures options for refreshing a Delta Sharing catalog. |
| `refreshStatus` | ``object (`https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/deltasharing.v1.projects.catalogs#RefreshStatus`)`` Output only. The status of the background catalog refresh. |
| `federatedCatalogOptions` | ``object (`https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/deltasharing.v1.projects.catalogs#FederatedCatalogOptions`)`` Optional. Configuration options for federated catalogs. |
| Union field `config`. Config for the Catalog. Exactly one field must be set, which determines the type of Catalog. `config` can be only one of the following: ||
| `sapConfig` | ``object (`https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/deltasharing.v1.projects.catalogs#SapConfig`)`` Optional. Config for a catalog that connects to SAP Business Data Cloud (BDC). |

## SapConfig

Configuration for SAP Business Data Cloud (BDC).

| JSON representation |
|---|
| ``` { "sapBdcEnrollmentConfig": { object (`https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/deltasharing.v1.projects.catalogs#SapBdcEnrollmentConfig`) }, "sapRegion": string } ``` |

| Fields ||
|---|---|
| `sapBdcEnrollmentConfig` | ``object (`https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/deltasharing.v1.projects.catalogs#SapBdcEnrollmentConfig`)`` Optional. To create a catalog resource that connects to SAP BDC,this 3 step processle ClouGoogle Cloud et `SapConfig` to empty. This creates a catalog resource with a GCP Service Account: `serviceAccount`. 2. On your SAP BDC instance, using this `serviceAccount`, follow the enrollment process and create a BDC Connector. You will receive `connectorEndpoint` and `invitationCode` from SAP. 3. With these additional fields provided by SAP, update the BigLake catalog resource created earlier with the `SapBdcEnrollmentConfig`. Once the `SapBdcEnrollmentConfig` is set, it is immutable. |
| `sapRegion` | `string` Optional. Immutable. The Google Cloud region to use for SAP BDC APIs. When the catalog's metadata is stored in a multi-region (e.g., 'us') but the physical SAP BDC instance resides in a single region (e.g., 'us-central1'), this field must be explicitly set to point to that single region. If not set, the location provided during catalog creation will be used by default. |

## SapBdcEnrollmentConfig

Contains the enrollment configuration received from SAP.

| JSON representation |
|---|
| ``` { "connectorEndpoint": string, "invitationCode": string, "invitationUrl": string, "federatedIdentityIssuer": string } ``` |

| Fields ||
|---|---|
| `connectorEndpoint` | `string` Optional. The unique SAP BDC Connector Endpoint. |
| `invitationCode` | `string` Optional. An invitation code from SAP. |
| `invitationUrl` | `string` Optional. The combined invitation URL containing both endpoint and code. |
| `federatedIdentityIssuer` | `string` Output only. Lakehouse supports sharing Data Products with SAP BDC. When sharing is enabled, SAP BDC will access the underlying resources through a federated identity. This field indicates the issuer of the federated identity. More concretely, the identity pool and provider should be created as follows: $ gcloud iam workload-identity-pools create sap-bdc-pool \\ --location="global" \\ --display-name="SAP BDC Pool" $ gcloud iam workload-identity-pools providers create-oidc sap-bdc-provider \\ --location="global" \\ --workload-identity-pool="sap-bdc-pool" \\ --issuer-uri="" And then, the pool should can be added to the IAM policy of the shared resources so that SAP BDC can access them: $ gcloud projects add-iam-policy-binding PROJECT_ID \\ --role="roles/biglake.viewer" \\ --member="principal://iam.googleapis.com/projects/{PROJECT_NUMBER}/locations/global/workloadIdentityPools/sap-bdc-pool/subject/{TENANT_UUID}" ... where the TENANT_UUID can be found in the SAP BDC instance. |

## RefreshOptions

Configures options for refreshing a Delta Sharing catalog.

| JSON representation |
|---|
| ``` { "refreshSchedule": { object (`https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/deltasharing.v1.projects.catalogs#RefreshSchedule`) } } ``` |

| Fields ||
|---|---|
| `refreshSchedule` | ``object (`https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/deltasharing.v1.projects.catalogs#RefreshSchedule`)`` Optional. Defines if and when metadata refresh should be scheduled. |

## RefreshSchedule

Defines if and when metadata refresh should be scheduled.

| JSON representation |
|---|
| ``` { "refreshInterval": string } ``` |

| Fields ||
|---|---|
| `refreshInterval` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#duration` format)`` Optional. The interval for refreshing metadata from the remote catalog. If not set, but refresh is desired, a system default will be used. A duration in seconds with up to nine fractional digits, ending with '`s`'. Example: `"3.5s"`. |

## RefreshStatus

Remote catalog background refresh status.

| JSON representation |
|---|
| ``` { "startTime": string, "endTime": string, "status": { object (`https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/Status`) } } ``` |

| Fields ||
|---|---|
| `startTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. When the catalog refresh has started, including in-progress refreshes. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `endTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. When the catalog refresh has ended, unset for in-progress refreshes. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `status` | ``object (`https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/Status`)`` Output only. The status of the last background refresh operation, unset for in-progress refreshes. |

## FederatedCatalogOptions

Configuration options for federated catalog.

| JSON representation |
|---|
| ``` { "serviceDirectoryName": string } ``` |

| Fields ||
|---|---|
| `serviceDirectoryName` | `string` Optional. The service directory resource name for routing traffic over a private network connection through Cross-Cloud Interconnect, in the format `projects/{projectId}/locations/{locationId}/namespaces/{namespace_id}/services/{serviceId}`. |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/deltasharing.v1.projects.catalogs/create` | Creates a new DeltaSharing catalog. |
| ### `https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/deltasharing.v1.projects.catalogs/delete` | Deletes an existing DeltaSharing catalog specified by the resource name. |
| ### `https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/deltasharing.v1.projects.catalogs/get` | Gets the catalog specified by the resource name. |
| ### `https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/deltasharing.v1.projects.catalogs/list` | List all DeltaSharing catalogs in a specified project. |
| ### `https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/deltasharing.v1.projects.catalogs/patch` | Updates an existing DeltaSharing catalog. |