Skip to content

Commit

Permalink
See open-metadata/OpenMetadata@24b668a from refs/heads/main
Browse files Browse the repository at this point in the history
  • Loading branch information
open-metadata committed Dec 28, 2024
1 parent 747e368 commit a1e3063
Show file tree
Hide file tree
Showing 4 changed files with 33 additions and 6 deletions.
13 changes: 13 additions & 0 deletions content/partials/v1.6/connectors/yaml/api/source-config-def.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
#### Source Configuration - Source Config

{% codeInfo srNumber=100 %}

The `sourceConfig` is defined [here](https://github.com/open-metadata/OpenMetadata/blob/main/openmetadata-spec/src/main/resources/json/schema/metadataIngestion/apiServiceMetadataPipeline.json):

**markDeletedApiCollections**: To flag API collections as soft-deleted if they are not present anymore in the source system.

**overrideMetadata**: Set the Override Metadata toggle to control whether to override the metadata if it already exists.

**apiCollectionFilterPattern**: Note that the filter supports regex as include or exclude.

{% /codeInfo %}
14 changes: 14 additions & 0 deletions content/partials/v1.6/connectors/yaml/api/source-config.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
```yaml {% srNumber=100 %}
sourceConfig:
config:
type: ApiMetadata
markDeletedApiCollections: true
overrideMetadata: false
# apiCollectionFilterPattern:
# includes:
# - apiCollection1
# - apiCollection2
# excludes:
# - apiCollection3
# - apiCollection4
```
6 changes: 3 additions & 3 deletions content/v1.6.x/connectors/api/rest/yaml.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,7 @@ This is a sample config for OpenAPI:

{% codeInfo srNumber=1 %}

**OpenAPI Schema URL**:
**OpenAPI Schema URL**:
An OpenAPI schema URL typically refers to the URL where the OpenAPI Specification (OAS) document of a web service is hosted. The document defines the service's API, including available endpoints, request/response formats, authentication methods, etc. It is usually in JSON format. for e.g. `https://petstore3.swagger.io/api/v3/openapi.json`

**Token**: An authentication token to connect to an OpenAPI schema URL. It is only required if the API schema is protected or secured.
Expand All @@ -63,15 +63,15 @@ source:
serviceName: openapi_rest
serviceConnection:
config:
type: REST
type: ApiMetadata
```
```yaml {% srNumber=1 %}
openAPISchemaURL: https://docs.open-metadata.org/swagger.json

```


{% partial file="/v1.6/connectors/yaml/database/source-config.md" /%}
{% partial file="/v1.6/connectors/yaml/api/source-config.md" /%}

{% partial file="/v1.6/connectors/yaml/ingestion-sink.md" /%}

Expand Down
6 changes: 3 additions & 3 deletions content/v1.7.x-SNAPSHOT/connectors/api/rest/yaml.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,7 @@ This is a sample config for OpenAPI:

{% codeInfo srNumber=1 %}

**OpenAPI Schema URL**:
**OpenAPI Schema URL**:
An OpenAPI schema URL typically refers to the URL where the OpenAPI Specification (OAS) document of a web service is hosted. The document defines the service's API, including available endpoints, request/response formats, authentication methods, etc. It is usually in JSON format. for e.g. `https://petstore3.swagger.io/api/v3/openapi.json`

**Token**: An authentication token to connect to an OpenAPI schema URL. It is only required if the API schema is protected or secured.
Expand All @@ -63,15 +63,15 @@ source:
serviceName: openapi_rest
serviceConnection:
config:
type: REST
type: ApiMetadata
```
```yaml {% srNumber=1 %}
openAPISchemaURL: https://docs.open-metadata.org/swagger.json

```


{% partial file="/v1.7/connectors/yaml/database/source-config.md" /%}
{% partial file="/v1.7/connectors/yaml/api/source-config.md" /%}

{% partial file="/v1.7/connectors/yaml/ingestion-sink.md" /%}

Expand Down

0 comments on commit a1e3063

Please sign in to comment.