Target tables for storing API Service Graph Connector for Apigee Edge data
Summarize
Summary of Target tables for storing API Service Graph Connector for Apigee Edge data
This content describes the tables used by the API Service Graph Connector for Apigee Edge in ServiceNow, which store data collected from Apigee Edge applications. After setting up the connection, the integration periodically pulls data and populates multiple Configuration Management Database (CMDB) and non-CMDB tables. These tables represent various API components and their relationships, enabling comprehensive visibility and management of Apigee Edge API infrastructure within ServiceNow.
Show less
Target Tables and Their Purpose
- Apigee API Gateway [cmdbciapigeeapigateway]: Stores gateway information including ID, name, and operational status. It has relationships providing Managed APIs, API Consumers, API Consumer Subscriptions, and API Product Bundles.
- Managed API [cmdbcimanagedapi]: Contains details such as ID, name, description, base URL, version, environment, lifecycle stage, and operational status. It is related to API Frontends, API Backends, API Deployments, and DNS Aliases.
- API Deployment [apideployment]: Records the deployed API and its name.
- DNS Alias [cmdbcidnsalias]: Holds DNS alias information, including name and operational status.
- API Backend [cmdbciapibackend]: Captures backend API data such as name, URL, type, internet facing flag, and operational status.
- API Frontend [cmdbciapifrontend]: Stores frontend API attributes like name, API version, host, method, path, URL, protocol, description, internet facing flag, and operational status. It is linked to API Backends through endpoint relationships.
- API Product Bundle [cmdbciapiproductbundle]: Contains product bundle details including ID, name, description, creation and last modified dates, discovered access and approval types, and operational status. It relates to Managed APIs, API Consumer Subscriptions, and Key Value entries.
- Key Value [cmdbkeyvalue]: Stores key-value pairs related to configuration items along with tags.
- API Consumer Subscription [cmdbciapiconsumersubscription]: Stores subscription data such as ID, name, API consumer reference, creation and modification dates, and discovered state; it references Key Value entries.
- API [cmdbciapi]: Contains correlation IDs for APIs.
- API Consumer Access [apiconsumeraccess]: Captures access method, state, validity, and references to API, API Consumer, API Product Bundle, and API Consumer Subscription.
- API Consumer [apiconsumer]: Stores consumer details including ID, username, email, associated API Gateway, registration date, and discovered state.
Relationships and Data Model
The connector establishes specific relationships among these tables to model the API ecosystem in Apigee Edge accurately. Examples include:
- Apigee API Gateway provides Managed APIs, API Consumers, and Product Bundles.
- Managed APIs use API Frontends and Backends and reference deployments and DNS aliases.
- API Frontends use API Backends as endpoints.
- API Product Bundles contain Managed APIs and are used by API Consumer Subscriptions.
- Subscriptions and Consumers reference key-value configurations, enabling detailed tracking of access and usage.
Practical Implications for ServiceNow Customers
By understanding these tables and their populated attributes, ServiceNow customers can effectively monitor and manage their Apigee Edge API infrastructure. The structured data and relationships facilitate impact analysis, operational status tracking, and integration with ServiceNow’s CMDB and IT workflows. This enables improved API lifecycle management, consumer access control, and overall visibility into API gateways, products, and consumers.
When you complete setting up the connection, you can configure the integration to periodically pull data from an Apigee Edge application. The data is saved in tables that extend from the Configuration item [cmdb_ci] classes and other non-CMDB tables.
Apigee API Gateway [cmdb_ci_apigee_api_gateway]
| Attribute label | Attribute name |
|---|---|
| ID | id |
| Name | name |
| Operational status | operational_status |
| Parent class | Relationship type | Child class |
|---|---|---|
| Apigee API Gateway [cmdb_ci_apigee_api_gateway] | Provides::Provided by | Managed API [cmdb_ci_managed_api] |
| Apigee API Gateway [cmdb_ci_apigee_api_gateway] | Reference | API Consumer [api_consumer] |
| Apigee API Gateway [cmdb_ci_apigee_api_gateway] | Provides::Provided by | API Consumer Subscription [cmdb_ci_api_consumer_subscription] |
| Apigee API Gateway [cmdb_ci_apigee_api_gateway] | Provides::Provided by | API Product Bundle [cmdb_ci_api_product_bundle] |
Managed API [cmdb_ci_managed_api]
| Attribute label | Attribute name |
|---|---|
| ID | id |
| Name | name |
| Description | short_description |
| Base URL | base_url |
| Version | version |
| Type | type |
| Environment | environment |
| Model ID | model_id |
| Correlation ID | correlation_id |
| Life Cycle Stage | life_cycle_stage |
| Life Cycle Stage Status | life_cycle_stage_status |
| Operational status | operational_status |
| Parent class | Relationship type | Child class |
|---|---|---|
| Managed API [cmdb_ci_managed_api] | Uses::Used by | API Frontend [cmdb_ci_api_frontend] |
| Managed API [cmdb_ci_managed_api] | Uses::Used by | API Backend [cmdb_ci_api_backend] |
| Managed API [cmdb_ci_managed_api] | Reference | API Deployment [api_deployment] |
| Managed API [cmdb_ci_managed_api] | Uses::Used by | DNS Alias [cmdb_ci_dns_alias] |
API Deployment [api_deployment]
| Attribute label | Attribute name |
|---|---|
| API | api |
| Name | name |
DNS Alias [cmdb_ci_dns_alias]
| Attribute label | Attribute name |
|---|---|
| Name | name |
| Operational status | operational_status |
API Backend [cmdb_ci_api_backend]
| Attribute label | Attribute name |
|---|---|
| Name | name |
| URL | url |
| Type | type |
| Internet facing | internet_facing |
| Operational status | operational_status |
API Frontend [cmdb_ci_api_frontend]
| Attribute label | Attribute name |
|---|---|
| Name | name |
| API Version | api_version |
| Host | host |
| Method | method |
| Path | path |
| URL | url |
| Protocol | protocol |
| Description | short_description |
| Internet facing | internet_facing |
| Operational status | operational_status |
| Parent class | Relationship type | Child class |
|---|---|---|
| API Frontend [cmdb_ci_api_frontend] | Use End Point To::Use End Point From | API Backend [cmdb_ci_api_backend] |
API Product Bundle [cmdb_ci_api_product_bundle]
| Attribute label | Attribute name |
|---|---|
| ID | id |
| Name | name |
| Description | short_description |
| Creation Date | creation_date |
| Last Modified Date | last_modified_date |
| Discovered Access Type | discovered_access_type |
| Discovered Approval Type | discovered_approval_type |
| Operational status | operational_status |
| Parent class | Relationship type | Child class |
|---|---|---|
| API Product Bundle [cmdb_ci_api_product_bundle] | Contains::Contained by | Managed API [cmdb_ci_managed_api] |
| API Product Bundle [cmdb_ci_api_product_bundle] | Used by::Uses | API Consumer Subscription [cmdb_ci_api_consumer_subscription] |
| API Product Bundle [cmdb_ci_api_product_bundle] | Reference | Key Value [cmdb_key_value] |
Key Value [cmdb_key_value]
| Attribute label | Attribute name |
|---|---|
| Configuration item | configuration_item |
| Key | key |
| Value | value |
| Tag | tag |
API Consumer Subscription [cmdb_ci_api_consumer_subscription]
| Attribute label | Attribute name |
|---|---|
| ID | id |
| Name | name |
| API Consumer | api_consumer |
| Creation Date | creation_date |
| Last Modified Date | last_modified_date |
| Discovered State | discovered_state |
| Parent class | Relationship type | Child class |
|---|---|---|
| API Consumer Subscription [cmdb_ci_api_consumer_subscription] | Reference | Key Value [cmdb_key_value] |
API [cmdb_ci_api]
| Attribute label | Attribute name |
|---|---|
| Correlation ID | source_native_key |
API Consumer Access [api_consumer_access]
| Attribute label | Attribute name |
|---|---|
| Auth Method | access_type |
| State | state |
| Valid to | valid_to |
| API | api |
| API Consumer | api_consumer |
| API Product Bundle | api_product_bundle |
| API Consumer Subscription | api_consumer_subscription |
API Consumer [api_consumer]
| Attribute label | Attribute name |
|---|---|
| ID | id |
| Username | username |
| API Gateway | api_gateway |
| Registration Date | registration_date |
| Discovered State | discovered_state |