Azure Functions로 REST API 만들기

GET https://hoge.com/api/address/23      <-- 愛知県のデータを取得
GET https://hoge.com/api/address/23/106  <-- 愛知県/名古屋市中区のデータを取得

POST https://hoge.com/api/address/23/112 <-- 愛知県/名古屋市南区のデータを追加
PUT  https://hoge.com/api/address/23/113 <-- 愛知県/名古屋市守山区のデータを更新

DELETE https://hoge.com/api/address/13   <-- 東京都のデータを削除

Azure Functions 프록시 사용

프록시를 사용해 보자.

실제로 REST API 같은 쓰기를, 프록시를 사용해 실현해 보겠습니다.

돈! !

Functions Apps에 프록시라는 그룹이 있으므로 새 프록시를 만듭니다. 이름 "Proxy01"은 임의의 이름으로, 이것은 외부에 공개되는 URL 에는 영향을 주지 않습니다.

변수 사용

루트 템플릿에서, {table} 이나 {*path} 라고 붙이고 있는 것이 변수로, 명칭은 임의입니다.

{table}/{*path}로 정의하면 호출 된 URL의 경로 요소가 변수에 저장됩니다.

예를 들면 다음과 같습니다.

https://hoge.com/rest/address/23  ---> table='address', path='23'
https://hoge.com/rest/address/23/201  ---> table='address', path='23/201'

라는 느낌으로 변수에 URL 경로가 저장됩니다. 정의로 *path 라고 하면(자), 「거기까지의 패스 캐릭터 라인 모두」가 포함됩니다 ( 23/201 와 같이).

그리고 이 변수를 다른 위치에서 사용할 수 있습니다. 여기에서는 요청 재정의 항목에서 쿼리 매개 변수로 사용됩니다.

예를 들어, table : {table} 라는 정의는, 루트 템플릿으로 정의한 {table} 변수를 쿼리 파라미터의 table 에 매핑 한다고 하는 의미입니다.

{request.method}는 내장 변수로 URL 호출 요청 메소드(예: GET/POST/PUT)를 나타냅니다.

그리고, 이 프록시의 투과처, 실제의 호출처가 백엔드 URL로 지정된 URL로, 통상은 다른 Http Trigger Function이 된다고 생각합니다(이 UI만 보면, Azure Functions에 한정하지 않고 임의 URL을 지정할 수있는 것 같습니다).

즉,
https://hoge.com/rest/address/23/201

URL이지만 다른 URL
https://huga.com/MyHttpTrigger?table=address&path=23/201

로 변환할 수 있다고 볼 수 있습니다.

Azure Functions의 Http Trigger는 다음과 같이 쿼리 문자열에서 table, method, path 수 있습니다.

MyHttpTrigger의 index.js

module.exports = function (context, req) {
    const table = req.query.table || '';
    const method = req.query.method || '';
    const path = req.query.path || '';

    context.res = {
        headers: {
            'Content-Type': 'application/json'
        },
        body: `table=${table}, method=${method}, path=${path}`
    };
    context.done();
};