---
title: AzureのAPIをモックで試験する
tags: 
author: [Yukiko](https://image.docswell.com/user/yukiko_it)
site: [Docswell](https://www.docswell.com/)
thumbnail: https://bcdn.docswell.com/page/PJX3DQGD7X.jpg?width=480
description: AzureのAPIをモックで試験する by Yukiko
published: November 15, 26
canonical: https://image.docswell.com/s/yukiko_it/Z6NP9M-2026-11-15-104108
---
# Page. 1

![Page Image](https://bcdn.docswell.com/page/PJX3DQGD7X.jpg)

AzureのAPIをモックで試験する
原理原則｜模倣サーバー × API連携試験 × Azure
うさうさ研修工房｜Udemy講座・DXエンジニア向け実務講座


# Page. 2

![Page Image](https://bcdn.docswell.com/page/3JKYX94D7D.jpg)

この講座のゴール（6つ）
STEP1
講師の整理
1. 本物のAPIに頼らず試験する理由を説明できる
2. モック試験の原理原則を5つ言える
3. Azureが示す再試行の考え方（公式）を試験に落とせる
4. 模倣サーバーを動かし、成功と失敗を再現できる
5. モックが本物とずれていないか、確かめる仕組みを持てる
6. モックで言えること・言えないことを、人が説明できる
講師の設計。到達の目安であり、資格や規格ではありません
2


# Page. 3

![Page Image](https://bcdn.docswell.com/page/LE395WLPE5.jpg)

全体の地図：8つのSTEP
講師の整理
難度9
難度6
難度5
難度4
STEP7
試験の試験
難度3
STEP5
難度2
難度1
STEP2
STEP1
原理原則5つ
STEP4
失敗を再現して試
STEP3
模倣サーバーを作
験
Azureの一時的エ
る
ラー
難度3
STEP6
Azure上に置く
STEP8
運用へ持ち帰る
なぜモックか
難度は講師の設計（山場はSTEP7）。分数は目安
3


# Page. 4

![Page Image](https://bcdn.docswell.com/page/8EDGDKN3EG.jpg)

本物のAPIに頼ると困る3つ
STEP1
講師の整理
いつも同じとは限らない
失敗を狙って起こせない
費用・制限・秘密が絡む
混雑、障害、通信の揺れ。
429や503を、試験のため
呼ぶたびに課金や上限があ
同じ入力でも、結果が変わ
に本物から出してもらうこ
る。本物のキーを試験に持
ることがある。
とはできない。
ち込むのも危うい。
講師の整理。共有リソースへのアクセスがスロットリングされうる点は公式（transient-faults）
4


# Page. 5

![Page Image](https://bcdn.docswell.com/page/V7P3XK5PJ8.jpg)

本物とモックの役割分担
STEP1
講師の整理
確かめたいこと
モックで確かめる
本物で確かめる
自分のコードの分岐（429・503・
401）
◎ 決定的に再現
× 狙えない
再試行の回数・待ち時間
◎ 件数と待ちを記録
△ 時間がかかる
応答の読み取り（項目の有無）
○ 契約に沿った応答で
◎ 本物の形
認証・権限・リージョンの設定
× 再現できない
◎ 本物で確認
本物の性能・上限・料金
× 分からない
◎ 本物で確認
設計案。割合や頻度の数値は設けません
5


# Page. 6

![Page Image](https://bcdn.docswell.com/page/2JV4LVPV7Q.jpg)

モック試験の原理原則 5つ
STEP2
講師の整理
1. 原則1 境界で試す：外部との接点を、自分のコードの外側に置く
2. 原則2 契約から作る：モックは、API仕様（契約）に沿って作る
3. 原則3 失敗も再現する：成功だけでなく、429・5xx・401・遅延・壊れた応答
4. 原則4 決定的にする：同じ入力は同じ結果。待ちは記録、乱数は固定
5. 原則5 ずれを見張る：モックと本物がずれていないか、確かめ続ける
講師の整理（公式・規格ではありません）。出典は各原則の次の表で示します
6


# Page. 7

![Page Image](https://bcdn.docswell.com/page/5EG1XLP1JL.jpg)

原則と、この講座の試験の対応
STEP2
講師の整理
原則
この講座での形
試験
1 境界で試す
呼ぶ側を client.py に閉じ込める
AC-01
2 契約から作る
公式の応答項目で契約を書く
AC-08
3 失敗も再現
401・429・503・400・壊れた本文・遅延
AC-02〜07
4 決定的にする
待ちは記録のみ。受信記録で件数確認
AC-03・04
5 ずれを見張る
契約試験＋実APIは別枠（未実施を明示）
AC-08・09
AC番号は講座の模倣サーバー試験（azure-mock-kit）。公式の根拠は STEP3・6 で確認
7


# Page. 8

![Page Image](https://bcdn.docswell.com/page/4JQD8Y2N7P.jpg)

演習1：自分の連携先を点検
STEP2
動画を止めて取り組む（目安 10分）
講師の整理
原則
自分の連携先で確認
記入例
1 境界
呼ぶ処理は1か所か
3か所に散らばる→集約
2 契約
応答の項目を書き出したか
未→公式から書く
3 失敗
再現できる失敗は何種類か
成功のみ→429を追加
4 決定的
待ち・乱数で試験が遅い／揺れるか
実際に待つ→注入
5 ずれ
モックと本物の照合をしているか
していない→AC-08
右列は記入例（架空の連携先）。自分の連携先で埋める
8


# Page. 9

![Page Image](https://bcdn.docswell.com/page/K74Z2WL3E1.jpg)

再試行する／しないエラー（公式）
STEP3
公式
論点
公式の記述（要約）
再試行の候補
HTTP 429（Too Many Requests）と 5xx サーバーエラー
再試行しない
400・401・403・404 などの多くの 4xx。成功し得ない操作
Retry-After
ヘッダーがあれば従い、指定時間以上待つ。サーバーの指示はクラ
イアントのバックオフ計算より優先
注意
503 などは、サービスが失敗していて、その後の試行にも応答しない
可能性がある
公式：learn.microsoft.com（2026-11-15 確認）／architecture/best-practices/transient-faults。表現は要約
9


# Page. 10

![Page Image](https://bcdn.docswell.com/page/LJ1RMYLZJG.jpg)

待ち方と、攻撃的すぎる再試行（公式）
STEP3
公式
論点
公式の記述（要約）
指数バックオフ
再試行ごとに間隔を延ばす（例：2秒、4秒、8秒）。ジッター（小さなラン
ダム遅延）を加える
即時再試行
1回まで。失敗したらバックオフへ
タイムアウト
再試行の前に、すべての発信呼び出しへ設定する
回数
無限の再試行は禁止。有限回数、またはサーキットブレーカー
多層の再試行
層ごとに再試行すると回数が掛け算になる（例：各層3回なら計9回）
公式：learn.microsoft.com（2026-11-15 確認）／同上。数値の例は公式の例示で、推奨値ではありません
10


# Page. 11

![Page Image](https://bcdn.docswell.com/page/GJW13GV6E2.jpg)

高速文字起こしAPIの形（公式）
STEP3
公式
呼び方
応答の主な項目
429のとき
POST・multipart/form-
durationMilliseconds、
公式の例は、最大5回、2・
data。audio と definition
combinedPhrases（text）、
4・8・16・32秒の指数
（JSON）。キーは Ocp-
phrases（offset・
バックオフ。この講座の数
Apim-Subscription-Key
duration・text・locale・
値は別設計（講師の整理）
ヘッダー（公式）
confidence）（公式）
公式：learn.microsoft.com（2026-11-15 確認）／ai-services/speech-service/fast-transcription-create。ページ題名はプレビュー表記。提供状況は使う前に確認
11


# Page. 12

![Page Image](https://bcdn.docswell.com/page/4EZPVL4RJ3.jpg)

模倣サーバーの核（抜粋）
STEP4
実行確認済み
# 受けた1回ごとの流れ
1. 受信を記録する（キー・形式）
2. 予約された並びから次のステータスを取る
（空なら 200）
3. キーが違えば 401
4. 429 / 503 なら Retry-After を付けて返す
5. 200 ならダミーの応答を返す
# 本物のAzureには
# 一切つながらない
# 制御用の口（試験が使う）
POST /__mock/sequence
{&quot;statuses&quot;:[429,200],
&quot;retry_after&quot;:5}
→ 次は429（5秒待て）、その次は200
GET /__mock/requests
→ 何回・どんな形で来たか
# キーは固定のダミー文字列
# 秘密は使わない
azure-mock-kit/app/mock_server.py（要約）。標準ライブラリのみ・ダミー応答のみ。Azureには接続しません
12


# Page. 13

![Page Image](https://bcdn.docswell.com/page/Y76M5W31EV.jpg)

模倣サーバーが再現できる状況
STEP4
実行確認済み
状況
予約の仕方
確かめること
成功
並びなし（既定は200）
応答を読める・形式を守った送信
認証エラー 401
キーを間違える
再試行しない
混雑 429
[429, 200] ＋ retry_after
指示以上に待つ
障害 503
[503, 503, …]
回数で諦める
壊れた応答
本文を上書き
落ちずに契約違反として扱う
遅延
delay を指定
タイムアウトして再試行
azure-mock-kit の試験で確認。本物のAzureが同じ順で返す保証はありません
13


# Page. 14

![Page Image](https://bcdn.docswell.com/page/G75ZYMLLJ4.jpg)

演習2：起動して試験を1回流す
受講資料
STEP4
動画を止めて取り組む（目安 10分）
1. フォルダ azure-mock-kit に移動する
2. python3 -m unittest discover -s tests -t . -v を実行する
3. 9件のうち、8件が ok、1件が skipped になることを確認する
4. skipped の理由（実APIは未実施）を読み、自分の言葉で説明する
5. tests/test_api_integration.py を開き、AC-03 の中身を読む
コマンドは Mac／Linux で確認。Windows は未確認。資料 azure-mock-kit の README を参照
14


# Page. 15

![Page Image](https://bcdn.docswell.com/page/9J2RG9L37R.jpg)

API連携試験 AC-01〜09
STEP5
実行確認済み
AC
確かめること
結果
01
成功：応答を読める・キーとmultipartとapi-versionを送る
合格
02
401：再試行しない（受信1回）
合格
03
429→200：Retry-Afterの5秒を待つ
合格
04
503が続く：3回で諦める（待ち1・2秒）
合格
05
400：再試行しない
合格
06
壊れた本文・項目欠落：契約違反
合格
07
遅延：タイムアウトして再試行→諦める
合格
08
モックの応答が契約に沿う／契約が緩んでいない
合格
09
実API：スモーク
未実施
azure-mock-kit/tests（実行：8件合格・1件スキップ）。AC番号は講座の設計
15


# Page. 16

![Page Image](https://bcdn.docswell.com/page/DEYDV4Q8EM.jpg)

AC-03：429のあと200（読む）
STEP5
実行確認済み
# 呼ぶ側（client.py の要点）
wait = max(backoff(tries) + jitter(),
retry_after or 0)
sleep(wait)
# Retry-After があれば、
# バックオフ以上に待つ（公式）
# 401・400 は再試行しない（公式）
# 試験（AC-03）
self.seq([429, 200], retry_after=5)
r = self.call()
assert 受信は2回
assert 待ちの記録 == [5.0]
# バックオフは1秒。
# Retry-After の5秒が優先される
# → sleep を記録に差し替えるので
# 試験は一瞬で終わる
azure-mock-kit の client.py と tests（要約）。待ちは注意：試験では実際には待たず記録する
16


# Page. 17

![Page Image](https://bcdn.docswell.com/page/VJN6MYK9J8.jpg)

試験を決定的にする3つの工夫
STEP5
講師の整理
待ちを注入する
ポート0で起動
受信記録で確かめる
sleep を引数にして、試験
OSに空いている番号を選
戻り値だけでなく、何回・
では記録するだけにする。
ばせる。他の試験と衝突し
どんな形で来たかを、サー
速く、揺れない。
ない。
バー側から確かめる。
講師の整理（原則4）。実際の効果は環境による
17


# Page. 18

![Page Image](https://bcdn.docswell.com/page/YE9LNPV373.jpg)

演習3：403 の試験を足す
受講資料
STEP5
動画を止めて取り組む（目安 10分）
1. AC-02 を手本に、403 のとき再試行しない試験を書く（AC-10）
2. mock_server に、403 を返す予約ができるか確認する（statuses に 403）
3. 最初は、クライアントが403をどう扱うか、予想を1行で書く
4. 試験を流し、予想と結果を比べる
5. 合格したら、client.py の再試行対象から 403 を外していることを、自分の言葉で説明する
403 は公式で再試行しない例（多くの4xx）に含まれる。AC番号は自分で付ける（例 AC-10）
18


# Page. 19

![Page Image](https://bcdn.docswell.com/page/GE8XKDPLJD.jpg)

Azure上にモックを置く3つの道
STEP6
公式
道
公式の記述（要約）
向く場面
API Management の バックエンド無しで、ポリシーが定義した応答を
モック応答
返す。応答は example 優先、無ければ schema
から生成、無ければ内容なし。全階層で利用可
設計先行・並行開発
Azure Functions
（HTTP）
Python v2 は @app.route で定義。ローカルは
func start で実行できる
動きを自由に書く
自前のコンテナ
（講師の整理）模倣サーバーを入れて動かす。動
作は未確認
ローカルと同じ物を
共有
公式：learn.microsoft.com（2026-11-15 確認）／api-management/mock-api-responses・mock-response-policy／azure-functions。3行目は講師の整理で動作未確認
19


# Page. 20

![Page Image](https://bcdn.docswell.com/page/LEL8ZM1Q7R.jpg)

APIMとFunctionsの書き方
STEP6
公式
&lt;!-- API Management（inbound） --&gt;
&lt;mock-response
status-code=&quot;200&quot;
content-type=&quot;application/json&quot; /&gt;
# 公式：属性にポリシー式は使えない
# 公式：example → schema の順で応答を選ぶ
# Azure Functions（Python v2）
app = func.FunctionApp(
http_auth_level=func.AuthLevel.ANONYMOUS)
@app.route(route=&quot;transcribe&quot;, methods=[&quot;POST&quot;])
def transcribe(req: func.HttpRequest):
... # 429・503 も返せる
APIM：mock-response-policy／Functions：functions-reference-python（2026-11-15 確認）。Azure上での実行は未確認（Functionsの直接呼び出しはローカルで実行確認済
み）
20


# Page. 21

![Page Image](https://bcdn.docswell.com/page/4JM6VY5KEW.jpg)

Azureに置くときの注意（公式）
STEP6
公式
費用と後片付け
上書きと共有
認証と秘密
Functions の作成手順には
既存の関数アプリへのデプ
ANONYMOUS のモックを
少額の費用がかかると記載。
ロイは内容を上書き。共有
公開すると誰でも呼べる
不要ならリソースグループ
のAzureリソースは過負荷
（講師の整理）。ダミー専
を削除（公式）
にしない（公式）
用にし、秘密を入れない
公式：learn.microsoft.com（2026-11-15 確認）／azure-functions/create-first-function-vs-code-python、architecture/best-practices/transient-faults。3枚目は講師の整理
21


# Page. 22

![Page Image](https://bcdn.docswell.com/page/PJRP2936E9.jpg)

山場：試験の試験（変異で壊す）
STEP7
実行確認済み
わざと壊す
期待
実際
Retry-After を無視する
AC-03 が不合格
不合格（検出）
401 も再試行する
AC-02 が不合格
エラー（検出）
契約の必須項目を緩める
AC-08 が不合格
最初は全件合格（見逃し）
モックの応答から項目を欠く
AC-08 が不合格
AC-01・03・08 が失敗（検出）
azure-mock-kit で実行。1行目の変異を入れて試験が不合格になれば、試験は効いている
22


# Page. 23

![Page Image](https://bcdn.docswell.com/page/PEX3DQ4DJX.jpg)

見逃しから学ぶこと ★
STEP7
実行確認済み
原因
直し方
学び
契約の試験が、別の理由で
必須項目を1つずつ欠かし、
緑は安心の根拠にならない。
も不合格になる書き方だっ
その項目名のエラーが出る
壊して不合格になるまで、
た。1項目が緩んでも気づ
かを確かめる。
試験を信じない。
けなかった。
azure-mock-kit の変異3。直した試験：必須項目を1つずつ欠いて、契約が検出するか確かめる
23


# Page. 24

![Page Image](https://bcdn.docswell.com/page/3EKYX9ZDJD.jpg)

演習4：自分の変異を1つ入れる
受講資料
STEP7
動画を止めて取り組む（目安 15分）
1. client.py のコピーを取る
2. 変異を1つ選ぶ（例：最大回数の比較を1つずらす／待ち時間を0にする）
3. 試験を流し、どの試験が不合格になるか予想→結果を比べる
4. すり抜けた場合は、どの試験が足りないかを書き、試験を足す
5. コピーから元に戻し、全件が元の結果に戻ることを確認する
変異は1回に1つ。終わったら必ず元に戻す（コピーを取ってから）
24


# Page. 25

![Page Image](https://bcdn.docswell.com/page/L7395WDP75.jpg)

モックで言えること・言えないこと
STEP8
講師の整理
言えること
言えないこと
自分のコードが、想定した失敗に、想定どお
り動く
本物のAzureが、同じ失敗を、同じ形で返す
応答の項目が、契約と食い違えば気づける
契約（公式の記述）が、今も変わっていない
再試行の回数と待ちが、設計どおり
本物の上限・料金・性能・リージョン差
試験が、わざと壊したときに不合格になる
認証・権限の設定が、本物で通る
講師の整理。実APIの確認は別枠（AC-09）。本講座では未実施
25


# Page. 26

![Page Image](https://bcdn.docswell.com/page/87DGDKP37G.jpg)

運用へ持ち帰る5つ
STEP8
講師の整理
1. 契約を公式から書き、更新日を残す（使う前に公式を開く）
2. 実APIのスモーク試験を別枠で持ち、未実施を合格と混ぜない
3. 変異の試験を、試験を足したときに1回やる
4. モックを置いたAzureのリソースは、期限と持ち主を決めて片付ける
5. 最後は人が責任をもつ：合否と承認は人。AIや機械は、材料を作る
設計案。頻度・数値は各現場で決める（本講座では数値を設けません）
26


# Page. 27

![Page Image](https://bcdn.docswell.com/page/VJP3XKNPE8.jpg)

まとめ：確認したこと／未確認のこと
講師の整理
1. 確認：Azureの一時的エラーの考え方（429・5xx・Retry-After・バックオフ・タイムアウ
ト・多層再試行）、APIMのモック応答、高速文字起こしAPIの形
2. 実行確認：模倣サーバーと試験9件（8合格・1スキップ）、変異4件、Functionsの直接呼び
出し（ローカル）
3. 未確認：Azure上での実行（APIM・Functions・コンテナ）、実API、料金、Windows、各社
の運用規程
4. 次の一手：自分の連携先で、演習1の点検表を1枚埋める
公式は 2026-11-15 に確認。収録・受講の前に、公式ページを開いて更新してください
27


# Page. 28

![Page Image](https://bcdn.docswell.com/page/2EV4LVKVJQ.jpg)

この資料の使い方
受講資料
1. 動画を見ながら、 のところで止めて手を動かす
2. 公式のラベルと、講師の整理のラベルを区別して読む
3. 未確認と書かれたことは、自分で確かめるまで事実にしない
4. 秘密・本番データ・お客様の情報は使わない（ダミーだけ）
5. 試験の結果は、合格・不合格・未実施の3つに分けて残す
受講生用の追加ページ（講師用のスライド番号は動きません）
28


# Page. 29

![Page Image](https://bcdn.docswell.com/page/57G1XLQ1EL.jpg)

考えてみよう5問と答えの目安
受講資料
問い
答えの目安
401 を再試行しないのはなぜ？
成功し得ないから。キーが違うまま待っても直ら
ない
Retry-After があるとき、何を優先？
サーバーの指示を優先し、指定時間以上待つ
スキップは合格か？
合格ではない。未実施として見せる
全件合格でも安心できない理由は？
試験が効いていないかもしれない。壊して確かめ
る
モックで言えないことは？
本物の返し方・契約の現在・上限・料金・認証設
定
答えは目安。自分の現場の事情で変わる
29


# Page. 30

![Page Image](https://bcdn.docswell.com/page/4EQD8YKNJP.jpg)

用語集
受講資料
用語
この講座での意味
モック（模倣サーバー）
本物の代わりに、ダミー応答を返すもの
契約
応答に最低限あるべき項目の取り決め
Retry-After
「この秒数待って」という、サーバーからの指示
バックオフ
再試行の間隔を延ばしていく待ち方
変異
コードをわざと壊して、試験が検出するか見ること
講座内の用法。厳密な定義は公式を参照
30


# Page. 31

![Page Image](https://bcdn.docswell.com/page/KJ4Z2WP371.jpg)

次にやること
受講資料
1. 演習1の点検表を、自分の連携先で埋める
2. 連携先の応答項目を、公式から書き出す
3. 試験表に『未実施』の欄を作る
4. 変異を1つ入れて、試験が検出するか確かめる
宿題の目安。数値は設けません
31


