集成Salesforce的AppExchange应用：如何在Azure Event Grid/API中获取Blob元数据？

核心结论 #

Azure Event Grid的Blob事件（BlobCreated/BlobUpdated）默认不包含Blob元数据，也没有直接配置项可以将元数据纳入通知内容。所有元数据的获取都需要在收到事件通知后，主动调用Azure Blob Storage API拉取。

场景1：上传带元数据的文件至Azure Blob #

问题解答 #

• Event Grid的BlobCreated通知不会包含元数据，无法通过配置实现直接携带。

解决方案 #

收到BlobCreated事件后，从Salesforce Apex REST解析器发起HTTP请求，调用Azure Blob Storage的Get Blob Properties接口获取元数据，再同步到Salesforce记录中。

Apex示例代码（简化版）

public class AzureBlobMetadataFetcher {
    public static Map<String, String> getBlobMetadata(String blobUrl, String sasToken) {
        Map<String, String> metadataMap = new Map<String, String>();
        
        Http http = new Http();
        HttpRequest request = new HttpRequest();
        request.setEndpoint(blobUrl + '?comp=metadata&' + sasToken);
        request.setMethod('GET');
        
        HttpResponse response = http.send(request);
        if (response.getStatusCode() == 200) {
            // 解析响应头中的元数据（Azure将元数据以x-ms-meta-*开头返回）
            Map<String, String> headers = response.getHeaders();
            for (String key : headers.keySet()) {
                if (key.startsWith('x-ms-meta-')) {
                    String metadataKey = key.substring(10); // 去掉前缀x-ms-meta-
                    metadataMap.put(metadataKey, headers.get(key));
                }
            }
        }
        return metadataMap;
    }
}

场景2：现有文件添加/更新元数据 #

问题解答 #

• 元数据的添加/更新操作会触发Event Grid的BlobUpdated事件，但通知中同样不会包含元数据的变更详情。

解决方案 #

1. 监听BlobUpdated事件，收到通知后调用上述Get Blob Properties接口拉取最新元数据。
2. 如需跟踪元数据的变更差异：
   • 可以在Salesforce端维护该Blob元数据的历史版本，拉取新元数据后与本地记录对比，识别变更项。
   • 或在Azure端配置Blob的更改Feed（Change Feed），记录元数据变更历史，后续从Salesforce调用API读取更改Feed获取差异（需额外配置Azure存储的更改Feed功能）。

针对需求的逐一答复 #

1. 是否可通过配置将元数据纳入Event Grid通知？
   不行，Azure Event Grid的Blob事件结构是固定的，没有配置选项可以添加自定义元数据字段到通知内容中。

2. 收到事件通知后用何种API获取元数据？
   使用Azure Blob Storage的Get Blob Properties REST API，通过Blob的完整URL（带SAS token或Azure AD认证）发起GET请求，元数据会以响应头的形式返回（前缀为x-ms-meta-）。

3. 现有文件元数据添加/变更的可行方案？

   • 依赖BlobUpdated事件触发通知，之后调用Get Blob Properties获取最新元数据。
   • 若需要变更差异，可在Salesforce端维护元数据快照做对比，或启用Azure Blob的更改Feed功能来追踪历史变更。

内容的提问来源于stack exchange，提问作者Chirag Mehta