Skip to content

Commit 323c2f5

Browse files
authored
Merge pull request #204320 from dlepow/schema
[APIM] Schema cross-reference
2 parents 7c8e660 + f6f2a48 commit 323c2f5

File tree

1 file changed

+7
-4
lines changed

1 file changed

+7
-4
lines changed

articles/api-management/validation-policies.md

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -159,7 +159,7 @@ To add a schema to your API Management instance using the Azure portal:
159159
1. In the [portal](https://portal.azure.com), navigate to your API Management instance.
160160
1. In the **APIs** section of the left-hand menu, select **Schemas** > **+ Add**.
161161
1. In the **Create schema** window, do the following:
162-
1. Enter a **Name** for the schema.
162+
1. Enter a **Name** (Id) for the schema.
163163
1. In **Schema type**, select **JSON** or **XML**.
164164
1. Enter a **Description**.
165165
1. In **Create method**, do one of the following:
@@ -172,11 +172,14 @@ To add a schema to your API Management instance using the Azure portal:
172172

173173
:::image type="content" source="media/validation-policies/add-schema.png" alt-text="Create schema":::
174174

175-
After the schema is created, it appears in the list on the **Schemas** page. Select a schema to view its properties or to edit in a schema editor.
175+
API Management adds the schema resource at the relative URI `/schemas/<schemaId>`, and the schema appears in the list on the **Schemas** page. Select a schema to view its properties or to edit in a schema editor.
176176

177177
> [!NOTE]
178-
> * A schema may cross-reference another schema that is added to the API Management instance.
179-
> * Open-source tools to resolve WSDL and XSD schema references and to batch-import generated schemas to API Management are available on [GitHub](https://github.com/Azure-Samples/api-management-schema-import).
178+
> A schema may cross-reference another schema that is added to the API Management instance. For example, include an XML schema added to API Management by using an element similar to:<br/><br/>`<xs:include schemaLocation="/schemas/myschema" />`
179+
180+
181+
> [!TIP]
182+
> Open-source tools to resolve WSDL and XSD schema references and to batch-import generated schemas to API Management are available on [GitHub](https://github.com/Azure-Samples/api-management-schema-import).
180183
181184
### Usage
182185

0 commit comments

Comments
 (0)