APIOps Toolkit for Azure APIM v7.0.0-alpha.1.0.4

Full Changelog: v7.0.0-alpha.1.0.3...v7.0.0-alpha.1.0.4

APIOps Toolkit for Azure APIM v7.0.0-alpha.1.0.3

Fixes #802

APIOps Toolkit for Azure APIM v7.0.0-alpha.1.0.2

Fix for #760

APIOps Toolkit for Azure APIM v7.0.0-alpha.1.0.1

What's new

Better ID references

Many APIM resources reference others through IDs. For example, here is a diagnostic that references a logger through the loggerId property:

{
 "properties": {
   ...
   "loggerId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/loggers/azuremonitor"
   ...
 }
}

If we publish this diagnostic as-is to another APIM instance, the publisher will fail. The logger reference is specific to APIM instance apimService1 in resource group rg1 and subscription 00000000-0000-0000-0000-000000000000. To work around this, we have to edit the JSON or override the publisher configuration to reference the new APIM instance.

As of v7, the extractor will use relative references where possible. In the above scenario, it will write loggerId: "/loggers/azuremonitor". This relative reference will work when publishing across instances.

Note

This change was manually implemented across resources. We're not aware of a way to ask the APIM REST API to return relative references. Some resources may have been missed. If you'd like to request that we add a missed resource, please raise an issue.

Nested configuration

We now support nested levels of configuration for the extractor and publisher. This allows the configuration of child resources (e.g. api operations, workspace api diagnostics, etc).

Sample extractor configuration

Only operations 1 and 2 will be extracted in api 1. All operations in api 2 will be extracted.

apis:
- api1:
    operations:
    - operation1
    - operation2
- api2
...

Sample publisher configuration

The display name of diagnostic 3 in api 2 in workspace 1 will be overriden with my display name.

workspaces:
- workspace1:
    apis:
    - api2:
        diagnostics:
        - diagnostic3:
            properties:
              displayName: my display name
...

Empty configuration in extractor

Previously, if we wanted to skip extracting all resources of a type, we had to put a random placeholder value (e.g. ignore). We now support the more intuitive [].

Before

apis: ignore # Workaround to skip extracting all APIs.

After

apis: [] # All APIs will be skipped.

Breaking changes

New section names in extractor configuration

We've made the section names in the extractor and publisher identical. This provides a more consistent experience and greatly simplifies code maintenance.

Before (extractor configuration)

apiNames:
- api1
- api2
productNames:
- product1
- product2

After (extractor configuration)

apis:
- api1
- api2
products:
- product1
- product2

APIOps Toolkit for Azure APIM v6.0.2

What's Changed

• Fix 'PessimisticConcurrencyConflict' next to 'Conflict' error codes by @LockTar in #799

Full Changelog: v6.0.1.10...v6.0.2

APIOps Toolkit for Azure APIM v6.0.1.10

What's Changed

• Add retry logic for 409 response with specific Conflict error code by @LockTar in #787

Full Changelog: v6.0.1.9...v6.0.1.10

APIOps Toolkit for Azure APIM v6.0.1.9

What's Changed

• Only Run Workflow on Push, not PR Close by @wagnerb3 in #783

Full Changelog: v6.0.1.8...v6.0.1.9

APIOps Toolkit for Azure APIM v6.0.1.8

What's Changed

• Bump nokogiri from 1.18.4 to 1.18.9 in /docs by @dependabot[bot] in #772
• Update apiops-2-2-tools-publisher.md - replace tokens #776 by @Chad-Dumas-MSFT in #781
• Added support for latest version of Azure Powershell by @sergiopadure in #782
• Pass GitHub SHA to publisher by @wagnerb3 in #780

New Contributors

• @Chad-Dumas-MSFT made their first contribution in #781
• @sergiopadure made their first contribution in #782
• @wagnerb3 made their first contribution in #780

Full Changelog: v6.0.1.7...v6.0.1.8

APIOps Toolkit for Azure APIM v6.0.1.7

What's Changed

• Feature/issue 599/add version to output by @zcarroll4 in #750

Full Changelog: v6.0.1.6...v6.0.1.7

APIOps Toolkit for Azure APIM v6.0.1.6

What's Changed

• Add GitHub least permissions for run extractor workflow by @LockTar in #745

New Contributors

• @LockTar made their first contribution in #745

Full Changelog: v6.0.1.5...v6.0.1.6