Pin EventGrid sample files URL to specific commit SHA

[Copilot]

Azure/azure-rest-api-specs#38236 removed EventGrid sample files from main branch, breaking the extension's ability to fetch sample events for EventGrid function triggers.

Changes

• Pin GitHub API URL to commit 752dade436619ed28bd03ca2e77cfa5acf6222dd where sample files still exist
• Add documentation referencing upstream issues

// Before
const sampleFilesUrl =
    'https://api.github.com/repos/Azure/azure-rest-api-specs/contents/specification/eventgrid/data-plane/' +
    '{eventSource}' +
    '/stable/2018-01-01/examples/cloud-events-schema/';

// After
const sampleFilesUrl =
    'https://api.github.com/repos/Azure/azure-rest-api-specs/contents/specification/eventgrid/data-plane/' +
    '{eventSource}' +
    '/stable/2018-01-01/examples/cloud-events-schema?ref=752dade436619ed28bd03ca2e77cfa5acf6222dd';

Restores functionality for all supported EventGrid sources (Microsoft.Storage, Microsoft.EventHub, Microsoft.ServiceBus, etc.).

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• https://api.github.com/repos/Azure/azure-rest-api-specs/contents/specification/eventgrid/data-plane/Microsoft.Storage/stable/2018-01-01/examples/cloud-events-schema
  • Triggering command: curl -s -I REDACTED (http block)
  • Triggering command: curl -s REDACTED (http block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Update EventGrid sample file URL to use specific commit SHA after Azure/azure-rest-api-specs#38235</issue_title>
<issue_description>## Background
Recent changes in the Azure/azure-rest-api-specs repository (see issue #38235 and PR #38236) removed almost all EventGrid sample directories and example files from main. As a result, the following URL used in EventGridTypeStep.ts now fails:

const sampleFilesUrl =
    'https://api.github.com/repos/Azure/azure-rest-api-specs/contents/specification/eventgrid/data-plane/' +
    '{eventSource}' +
    '/stable/2018-01-01/examples/cloud-events-schema/';

Proposal

Use a specific SHA reference when fetching EventGrid sample files from the GitHub API. This will ensure the extension continues to provide sample events for all supported sources, even though the files are no longer present in the main branch.

Suggested approach:

• Modify the code in EventGridTypeStep.ts to construct the sample files URL with a ?ref=752dade436619ed28bd03ca2e77cfa5acf6222dd query parameter. Example:

  const sampleFilesUrl =
      'https://api.github.com/repos/Azure/azure-rest-api-specs/contents/specification/eventgrid/data-plane/' +
      '{eventSource}' +
      '/stable/2018-01-01/examples/cloud-events-schema?ref=752dade436619ed28bd03ca2e77cfa5acf6222dd';
  

  https://api.github.com/repos/Azure/azure-rest-api-specs/contents/specification/eventgrid/data-plane/Microsoft.Storage/stable/2018-01-01/examples/cloud-events-schema?ref=752dade436619ed28bd03ca2e77cfa5acf6222dd
• Document this workaround in the code, referencing the upstream issue and PR.

References

• Upstream issue: Delete obsolete manual system event swaggers Azure/azure-rest-api-specs#38235
• Upstream PR: Delete obsolete manual system event swaggers from EventGrid data-plane Azure/azure-rest-api-specs#38236
• Commit that removed the files: Azure/azure-rest-api-specs@4c5f20e

Impact

• This workaround will allow the extension to continue functioning for EventGrid event sources despite the upstream file deletion.
• Future changes in azure-rest-api-specs may require further updates.

---

Labels: bug, eventgrid
</issue_description>

Comments on the Issue (you are @copilot in this section)

• Fixes Update EventGrid sample file URL to use specific commit SHA after Azure/azure-rest-api-specs#38235 #4759

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

[bwateratmsft]

Converting old PR to draft.