通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

自定义资源缓存参考

本文将介绍实现缓存自定义资源的终结点的要求。 如果不熟悉 Azure 自定义资源提供程序，请参阅 有关自定义资源提供程序的概述。

定义缓存资源终结点

可以通过指定 routingType “代理，缓存”来创建代理资源。

自定义资源提供程序示例：

{
  "properties": {
    "resourceTypes": [
      {
        "name": "myCustomResources",
        "routingType": "Proxy, Cache",
        "endpoint": "https://{endpointURL}/"
      }
    ]
  },
  "location": "eastus",
  "type": "Microsoft.CustomProviders/resourceProviders",
  "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}",
  "name": "{resourceProviderName}"
}

构建代理资源端点

实现“代理，缓存”资源终结点的终结点必须处理 Azure 中新 API 的请求和响应。 在这种情况下，resourceType 将为 PUT 资源，GET 资源 和 DELETE 资源 生成新的 Azure 资源 API，以对单个资源执行 CRUD 操作，并利用 GET 检索所有现有资源。

注释

Azure API 会生成请求方法 PUT、GET 和 DELETE，但是缓存终结点只需处理 PUT 和 DELETE。 建议终结点也实现 GET。

创建自定义资源

Azure API 传入请求：

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/myCustomResources/{myCustomResourceName}?api-version=2018-09-01-preview
Authorization: Bearer eyJ0e...
Content-Type: application/json

{
    "properties": {
        "myProperty1": "myPropertyValue1",
        "myProperty2": {
            "myProperty3" : "myPropertyValue3"
        }
    }
}

然后，此请求将以以下形式转发到终结点：

PUT https://{endpointURL}/?api-version=2018-09-01-preview
Content-Type: application/json
X-MS-CustomProviders-RequestPath: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/myCustomResources/{myCustomResourceName}

{
    "properties": {
        "myProperty1": "myPropertyValue1",
        "myProperty2": {
            "myProperty3" : "myPropertyValue3"
        }
    }
}

然后，终结点的响应将转发回客户。 响应应返回：

  • 有效的 JSON 对象文档。 所有数组和字符串都应嵌套在顶部对象下。
  • 标头 Content-Type 应设置为“application/json;charset=utf-8”。
  • 自定义资源提供程序会覆盖请求的 name、type 和 id 字段。
  • 自定义资源提供程序将仅返回缓存终结点的对象下的 properties 字段。

终结点响应：

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
    "properties": {
        "myProperty1": "myPropertyValue1",
        "myProperty2": {
            "myProperty3" : "myPropertyValue3"
        }
    }
}

自定义资源提供程序会自动为自定义资源生成 name、id 和 type 字段。

Azure 自定义资源提供程序响应：

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
    "name": "{myCustomResourceName}",
    "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/myCustomResources/{myCustomResourceName}",
    "type": "Microsoft.CustomProviders/resourceProviders/myCustomResources",
    "properties": {
        "myProperty1": "myPropertyValue1",
        "myProperty2": {
            "myProperty3" : "myPropertyValue3"
        }
    }
}

删除自定义资源

Azure API 传入请求：

Delete https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/myCustomResources/{myCustomResourceName}?api-version=2018-09-01-preview
Authorization: Bearer eyJ0e...
Content-Type: application/json

然后，此请求将以以下形式转发到终结点：

Delete https://{endpointURL}/?api-version=2018-09-01-preview
Content-Type: application/json
X-MS-CustomProviders-RequestPath: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/myCustomResources/{myCustomResourceName}

然后，终结点的响应将转发回客户。 响应应返回：

  • 有效的 JSON 对象文档。 所有数组和字符串都应嵌套在顶部对象下。
  • 标头 Content-Type 应设置为“application/json;charset=utf-8”。
  • 仅当返回 200 级响应时，Azure 自定义资源提供程序才会从其缓存中删除该项。 即使资源不存在，终结点也应返回 204。

终结点响应：

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

Azure 自定义资源提供程序响应：

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

检索自定义资源

Azure API 传入请求：

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/myCustomResources/{myCustomResourceName}?api-version=2018-09-01-preview
Authorization: Bearer eyJ0e...
Content-Type: application/json

请求 不会 转发到终结点。

Azure 自定义资源提供程序响应：

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
    "name": "{myCustomResourceName}",
    "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/myCustomResources/{myCustomResourceName}",
    "type": "Microsoft.CustomProviders/resourceProviders/myCustomResources",
    "properties": {
        "myProperty1": "myPropertyValue1",
        "myProperty2": {
            "myProperty3" : "myPropertyValue3"
        }
    }
}

枚举所有自定义资源

Azure API 传入请求：

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/myCustomResources?api-version=2018-09-01-preview
Authorization: Bearer eyJ0e...
Content-Type: application/json

请求 不会 转发到终结点。

Azure 自定义资源提供程序响应：

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
    "value" : [
        {
            "name": "{myCustomResourceName}",
            "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/myCustomResources/{myCustomResourceName}",
            "type": "Microsoft.CustomProviders/resourceProviders/myCustomResources",
            "properties": {
                "myProperty1": "myPropertyValue1",
                "myProperty2": {
                    "myProperty3" : "myPropertyValue3"
                }
            }
        }
    ]
}

后续步骤

  • Last updated on