사용자 지정 리소스 공급자 만들기 및 사용

아티클
02/12/2024

사용자 지정 리소스 공급자는 Azure와 엔드포인트 간의 계약입니다. 사용자 지정 리소스 공급자를 사용하면 Azure에서 워크플로를 변경할 수 있습니다. 이 자습서에서는 사용자 지정 리소스 공급자를 만드는 프로세스를 살펴봅니다. Azure 사용자 지정 리소스 공급자가 생소한 경우에는 Azure 사용자 지정 리소스 공급자에 대한 개요를 참조하세요.

사용자 지정 리소스 공급자 만들기

참고 항목

이 자습서에서는 엔드포인트를 작성하는 방법을 보여주지 않습니다. RESTFUL 엔드포인트가 없으면 현재 자습서의 기반이 되는 RESTful 엔드포인트 작성에 대한 자습서를 참조하세요.

엔드포인트를 만든 후에는 공급자와 엔드포인트 간의 계약을 생성하는 사용자 지정 리소스 공급자를 만들 수 있습니다. 사용자 지정 리소스 공급자를 통해 엔드포인트 정의 목록을 지정할 수 있습니다.

{
  "name": "myEndpointDefinition",
  "routingType": "Proxy",
  "endpoint": "https://<yourapp>.azurewebsites.net/api/<funcname>?code=<functionkey>"
}

속성	필수	설명
이름	예	엔드포인트 정의의 이름입니다. Azure는 이 이름을 해당 API를 통해 /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomProviders /resourceProviders/{resourceProviderName}/{endpointDefinitionName} 아래에 노출합니다.
routingType	아니요	엔드포인트 계약 형식입니다. 값을 지정하지 않으면 기본값은 “Proxy”입니다.
endpoint	예	요청을 라우팅하는 엔드포인트입니다. 이 엔드포인트는 응답 및 요청의 부작용을 처리합니다.

엔드포인트의 값은 Azure 함수 앱의 트리거 URL입니다. <yourapp>, <funcname> 및 <functionkey> 자리 표시자는 생성한 함수 앱의 값으로 바꾸어야 합니다.

사용자 지정 작업 및 리소스 정의

사용자 지정 리소스 공급자는 actions 및 resourceTypes 속성에서 모델링된 엔드포인트 정의 목록을 포함합니다. actions 속성은 사용자 지정 리소스 공급자가 노출하는 사용자 지정 작업에 매핑되고 resourceTypes 속성은 사용자 지정 리소스입니다. 이 자습서에서 사용자 지정 리소스 공급자에는 myCustomAction이라는 actions 속성과 myCustomResources라는 resourceTypes 속성이 있습니다.

{
  "properties": {
    "actions": [
      {
        "name": "myCustomAction",
        "routingType": "Proxy",
        "endpoint": "https://<yourapp>.azurewebsites.net/api/<funcname>?code=<functionkey>"
      }
    ],
    "resourceTypes": [
      {
        "name": "myCustomResources",
        "routingType": "Proxy",
        "endpoint": "https://<yourapp>.azurewebsites.net/api/<funcname>?code=<functionkey>"
      }
    ]
  },
  "location": "eastus"
}

사용자 지정 리소스 공급자 배포

참고 항목

엔드포인트 값을 이전 자습서에서 만든 함수 앱의 트리거 URL로 바꾸어야 합니다.

이전 사용자 지정 리소스 공급자는 Azure Resource Manager 템플릿을 사용하여 배포할 수 있습니다.

{
    "$schema": "http://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "resources": [
        {
            "type": "Microsoft.CustomProviders/resourceProviders",
            "name": "myCustomProvider",
            "apiVersion": "2018-09-01-preview",
            "location": "eastus",
            "properties": {
                "actions": [
                    {
                        "name": "myCustomAction",
                        "routingType": "Proxy",
                        "endpoint": "https://<yourapp>.azurewebsites.net/api/<funcname>?code=<functionkey>"
                    }
                ],
                "resourceTypes": [
                    {
                        "name": "myCustomResources",
                        "routingType": "Proxy",
                        "endpoint": "https://<yourapp>.azurewebsites.net/api/<funcname>?code=<functionkey>"
                    }
                ]
            }
        }
    ]
}

사용자 지정 작업 및 리소스 사용

사용자 지정 리소스 공급자를 만든 후에는 새 Azure API를 사용할 수 있습니다. 다음 섹션에서는 사용자 지정 리소스 공급자를 호출하고 사용하는 방법을 설명합니다.

사용자 지정 작업

Azure CLI

참고 항목

{subscriptionId} 및 {resourceGroupName} 자리 표시자를 사용자 지정 리소스 공급자를 배포한 구독 및 리소스 그룹으로 바꾸어야 합니다.

az resource invoke-action --action myCustomAction \
                          --ids /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomProviders/resourceProviders/myCustomProvider \
                          --request-body
                            '{
                                "hello": "world"
                            }'

매개 변수	필수	설명
작업	예	사용자 지정 리소스 공급자에 정의된 작업의 이름입니다.
ids	예	사용자 지정 리소스 공급자의 리소스 ID입니다.
request-body	아니요	엔드포인트로 전송될 요청 본문입니다.