ai_gateway_model_provider_services

Creates, updates, deletes, gets or lists an ai_gateway_model_provider_services resource.

Overview

Name	ai_gateway_model_provider_services
Type	Resource
Id	databricks_workspace.catalog.ai_gateway_model_provider_services

Fields

The following fields are returned by SELECT queries:

list

Name	Datatype	Description
name	string	Resource name of the provider service. Format: ``model-provider-services/{catalog}.{schema}.{model_provider_service}``. Each ``{...}`` component is capped at 255 characters individually. Server-derived on Create from ``parent`` + ``model_provider_service_id``; required and immutable on Update/Get/Delete.
metastore_id	string	Metastore hosting the provider service.
browse_only	boolean	Whether the caller sees only metadata available through the BROWSE privilege.
comment	string	User-provided description.
▶config	object	Behavioral configuration: provider connection, model catalog, and passthrough policy. See ``ModelProviderServiceConfig`` for the per-field contract. Required on CreateModelProviderService; on Update it is required only when ``config`` (or a ``config.*`` subpath) appears in ``update_mask``.
create_time	string (date-time)	When the provider service was created.
created_by	string	Creator identity.
effective_owner	string	The resolved owner of the model provider service. Falls back to the caller's identity when ``owner`` is not explicitly set on creation.
etag	string	Optimistic concurrency control token. Server-generated from the entity's state and returned on every read. To use it as an if-match precondition on a mutation, echo the last-read value back via the dedicated ``etag`` field on the Update / Delete request; the server rejects the mutation if the stored etag differs.
owner	string	The owner of the model provider service. Write-only; read owner via effective_owner.
update_time	string (date-time)	When the provider service was last modified.
updated_by	string	Identity of the last updater.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list	select	deployment_name	include_browse, page_size, page_token, parent, view	Lists the model provider services in a Unity Catalog schema. Provide parent as
create	insert	parent, model_provider_service_id, deployment_name, model_provider_service		Creates a model provider service in a Unity Catalog schema. A model provider service is a governed

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
deployment_name	string	The Databricks Workspace Deployment Name (default: dbc-abcd0123-a1bc)
model_provider_service_id	string	Leaf identifier for the provider service (the unqualified name within the parent schema, e.g. "openai_prod").
parent	string	Resource name of the parent schema. Format: schemas/{catalog}.{schema}. Each {...} component is capped at 255 characters individually.
include_browse	boolean	Whether to include provider services for which the principal can only access selective metadata.
page_size	integer	Maximum number of provider services to return. Defaults to 100 when unset or 0; the maximum is 1000. Use next_page_token to retrieve additional pages.
page_token	string	Opaque pagination token from a previous request.
parent	string	Resource name of the parent schema to list within, as schemas/{catalog}.{schema}. Each {...} component is capped at 255 characters individually.
view	string	View selector controlling which fields are populated per row.

SELECT examples

list

Lists the model provider services in a Unity Catalog schema. Provide parent as

SELECT
name,
metastore_id,
browse_only,
comment,
config,
create_time,
created_by,
effective_owner,
etag,
owner,
update_time,
updated_by
FROM databricks_workspace.catalog.ai_gateway_model_provider_services
WHERE deployment_name = '{{ deployment_name }}' -- required
AND include_browse = '{{ include_browse }}'
AND page_size = '{{ page_size }}'
AND page_token = '{{ page_token }}'
AND parent = '{{ parent }}'
AND view = '{{ view }}'
;

INSERT examples

create

Creates a model provider service in a Unity Catalog schema. A model provider service is a governed

INSERT INTO databricks_workspace.catalog.ai_gateway_model_provider_services (
model_provider_service,
parent,
model_provider_service_id,
deployment_name
)
SELECT 
'{{ model_provider_service }}' /* required */,
'{{ parent }}',
'{{ model_provider_service_id }}',
'{{ deployment_name }}'
RETURNING
name,
metastore_id,
browse_only,
comment,
config,
create_time,
created_by,
effective_owner,
etag,
owner,
update_time,
updated_by
;

Manifest

# Description fields are for documentation purposes
- name: ai_gateway_model_provider_services
props:
  - name: parent
    value: "{{ parent }}"
    description: Required parameter for the ai_gateway_model_provider_services resource.
  - name: model_provider_service_id
    value: "{{ model_provider_service_id }}"
    description: Required parameter for the ai_gateway_model_provider_services resource.
  - name: deployment_name
    value: "{{ deployment_name }}"
    description: Required parameter for the ai_gateway_model_provider_services resource.
  - name: model_provider_service
    description: |
      The model provider service to create. The server populates ``name`` from ``parent`` + ``model_provider_service_id``; clients should leave it unset.
    value:
      browse_only: {{ browse_only }}
      comment: "{{ comment }}"
      config:
        allow_all_targets: {{ allow_all_targets }}
        amazon_bedrock:
          direct:
            aws_access_key:
              access_key_id: "{{ access_key_id }}"
              secret_access_key: "{{ secret_access_key }}"
            aws_access_key_id: "{{ aws_access_key_id }}"
            aws_secret_access_key:
              plaintext: "{{ plaintext }}"
            region: "{{ region }}"
            service_credential:
              name: "{{ name }}"
        anthropic:
          direct:
            api_key:
              plaintext: "{{ plaintext }}"
          relayed:
            plan_type: "{{ plan_type }}"
        azure_openai:
          direct:
            api_key:
              plaintext: "{{ plaintext }}"
            base_url: "{{ base_url }}"
            client_id: "{{ client_id }}"
            client_secret:
              plaintext: "{{ plaintext }}"
            entra_service_principal:
              client_id: "{{ client_id }}"
              client_secret: "{{ client_secret }}"
              tenant_id: "{{ tenant_id }}"
            service_credential:
              name: "{{ name }}"
            tenant_id: "{{ tenant_id }}"
        custom:
          direct:
            api_key:
              plaintext: "{{ plaintext }}"
            base_url: "{{ base_url }}"
        forward_headers: {{ forward_headers }}
        forward_query_parameters: {{ forward_query_parameters }}
        forward_unmanaged_paths: {{ forward_unmanaged_paths }}
        gemini_enterprise:
          direct:
            api_key:
              plaintext: "{{ plaintext }}"
            project_id: "{{ project_id }}"
            region: "{{ region }}"
        inference_table:
          parent: "{{ parent }}"
          disabled: {{ disabled }}
          is_deleted: {{ is_deleted }}
          table: "{{ table }}"
          table_name_prefix: "{{ table_name_prefix }}"
        microsoft_foundry:
          direct:
            api_key:
              plaintext: "{{ plaintext }}"
            base_url: "{{ base_url }}"
            client_id: "{{ client_id }}"
            client_secret:
              plaintext: "{{ plaintext }}"
            entra_service_principal:
              client_id: "{{ client_id }}"
              client_secret: "{{ client_secret }}"
              tenant_id: "{{ tenant_id }}"
            service_credential:
              name: "{{ name }}"
            tenant_id: "{{ tenant_id }}"
        openai:
          direct:
            api_key:
              plaintext: "{{ plaintext }}"
            base_url: "{{ base_url }}"
            organization: "{{ organization }}"
        provider_type: "{{ provider_type }}"
        rate_limits:
          - key: "{{ key }}"
            renewal_period: "{{ renewal_period }}"
            principal: "{{ principal }}"
            request_tag_key: "{{ request_tag_key }}"
            request_tag_value: "{{ request_tag_value }}"
            requests: {{ requests }}
            tokens: {{ tokens }}
        targets:
          - model: "{{ model }}"
            native_api_types: "{{ native_api_types }}"
      create_time: "{{ create_time }}"
      created_by: "{{ created_by }}"
      effective_owner: "{{ effective_owner }}"
      etag: "{{ etag }}"
      metastore_id: "{{ metastore_id }}"
      name: "{{ name }}"
      owner: "{{ owner }}"
      update_time: "{{ update_time }}"
      updated_by: "{{ updated_by }}"