Azure REST API を使ってみよう

Article
11/13/2018

いつも大変お世話になります。Microsoft Azure サポートチームです。

Azure REST API について以下をご案内させていただきます。
ご参考になりましたら幸いです。

本記事の目的

本記事では、簡単に Azure REST API を使用する方法をご案内いたします。

Azure REST API を使用することで、Azure の様々な情報を参照・更新することができます。
本来、何かしらのプログラムから Azure REST API を呼び出し、お客様独自のシステムを構築するために用意されているものとなります。

例えば・・・

Azure VM の操作に特化した社内用 Web サイトを作りたい
自社ビジネスに合った使用状況・課金管理のツールを作りたい

このような時に、.NET や Java、その他様々なフレームワークを使用して Azure REST API の呼び出し、その結果の加工などを同フレームワークを使用して行っていただき、上記のような仕組みを独自に実装してもらうものとなります。

開発環境の用意や要件定義を伴うこと、また、呼び出し方法やデータの加工などはご利用いただくフレームワークにより様々なため、なかなか Azure REST API 自体の使用方法やどのような結果が得られるものかなどについてイメージをしにくい側面があります。

本記事では、まずは簡単に Azure REST API をご利用いただきそのイメージを掴んでいただくための簡易な方法をご案内することを目的としています。
上記のようなお客様独自のシステムを構築する際に採用をしていただける現実的な方法ではないものとなりますが、「ちょっと Azure REST API の動作を試したい」「Azure REST API の呼び出し方を事前に勉強しておきたい」などの時にお役に立てば幸いです。

!! 注意事項 !!
Azure REST API について全てをご案内するものではありません。
是非、「関連する弊社公開情報」も併せてご参照いただけたら幸いです。

Azure REST API とは

Azure REST API とは、Azure の各サービスごとに用意されている REST API です。
その総称を Azure REST API と呼んでいます。

例えば、お客様社内で以下のようなアプリケーションの構築をご検討いただいているとします。

自社ビジネスに合った Azure の使用状況・課金管理のツール

一例ではありますが、このアプリケーションを構成するものには以下のようなものが考えられます。
(あくまで一例です)

画面
データベース
このアプリケーション自体の権限管理ロジック
各業務ロジック
Azure データの制御ロジック
その他

一般的にこの中の「Azure データの制御ロジック」内で、適切な Azure REST API の呼び出しを行っていただくものとなります。
つまり、Azure REST API のみで何かを実現できるものではなく、お客様にご検討をいただいている独自の仕組みの中の一部としてご利用をご検討いただくものが Azure REST API になります。

全 Azure REST API は以下の弊社公開情報からご確認をいただけます。

Azure REST API Reference
/en-us/rest/api/azure/

このページの画面左に、全ての Azure REST API がツリー形式で表示されます。

例えば、Azure の課金に関する API である、「Consumption」を見てみましょう。
画面左から「Consumption」を展開します。
すると、更にその配下に様々な API (Aggregated Cost、Balances、Budgets など) が存在していることが確認できます。
その中の「Usage Details」を展開すると、更に細かいオペレーション (List、List By Billing Account など) が確認できます。

Azure REST API はこのように体系的に管理されています。

この中からお客様が検討されている独自のシステムを実現するための Azure REST API を見つけていただきます。
それぞれの API やオペレーションについて、各ページに詳細をご案内していますので併せてご参照いただければと思います。

事前の準備

Azure REST API を簡単にご利用いただくための事前準備についてご案内します。

この後に「Try It」「PowerShell」を使用した 2 つの方法をご案内しますが、その前の事前準備になります。
どちらの方法を使用するにしても、事前にこの準備をしておいてください。

以下の手順で、Azure REST API を実行するアカウントを作っておきましょう。

以下の弊社公開情報に沿って、組織アカウントを 1 つ作成する
方法: Azure Active Directory を使用してユーザーを追加または削除する
/ja-jp/azure/active-directory/fundamentals/add-users-azure-active-directory ※ 「新しいユーザーを追加するには」の手順に沿って作成してください。
※ 作成するアカウントは初期ドメインの「xxx@xxx.onmicrosoft.com」で結構です。
以下の弊社公開情報に沿って、上記 1. で作成したアカウントを所有者に設定する
Azure サブスクリプション管理者を追加または変更する
/ja-jp/azure/billing/billing-add-change-azure-subscription-administrator ※ 「Azure portal でサブスクリプションの RBAC 所有者を追加する」の手順に沿って設定をしてください。

以上で事前準備は終了です。
このアカウントを使用して、Azure REST API を試すことになります。

「Try It」を使用する方法

「Try It」を使用して、Azure REST API を簡単に試す方法をご案内します。

ここでは、[Consumption] - [Usage Details] API の [List] オペレーションで手順をご案内します。
上記「事前の準備」を済ませてから、以下の手順を実施してください。

ブラウザをすべて閉じる
意図しないアカウントでサインインしてしまうことを避けるために、必ずすべてのブラウザを閉じて下さい。
InPrivate ブラウザを起動する
同様に、意図しないアカウントでサインインしてしまうことを避けるために、必ず InPrivate ブラウザで実施してください。
以下の URL にアクセスをする
Usage Details - List
/en-us/rest/api/consumption/usagedetails/list
「Tri It」をクリックする
「Sign in」をクリックする
「事前の準備」で作成をしたアカウントでサインインをする
「Run」をクリックする
この API が実行されて、結果が表示されることを確認する

以上で「Try It」を使用した Azure REST API の呼び出しは終了です。
上記 7. の画面からも分かる通り、「Try It」でも様々なパラメーターを設定して Azure REST API を呼び出せます。
是非、色々お試しいただければと思います。

「PowerShell」を使用する方法

次に「PowerShell」を使用して、Azure REST API を簡単に試す方法をご案内します。
上記「Try It」でも様々お試しいただけますが、よりプログラミングからの使用をイメージしやすい方法となります。

同様に、[Consumption] - [Usage Details] API の [List] オペレーションで手順をご案内します。
上記「事前の準備」を済ませてから、以下の手順を実施してください。

以下の弊社公開情報に沿って、PowerShell のモジュールをインストールする

Azure PowerShell 最新版のインストール手順
https://blogs.technet.microsoft.com/jpaztech/2017/05/02/azure-powershell-3-8-0-install/

※ 「リソースマネージャーデプロイモデルの Azure PowerShell」をインストールします。
PowerShell を管理者として起動する
以下のコマンドを実行する
```
 Login-AzureRmAccount -Subscription "＜サブスクリプション ID＞"
```
サブスクリプション ID は、以下の弊社公開情報の手順でご確認いただけます。

サブスクリプション ID とデプロイ ID を確認する方法について
https://blogs.msdn.microsoft.com/dsazurejp/2013/12/06/id-id/

※ 「■ サブスクリプション ID の確認方法」の項目をご参照ください。

例)
```
 Login-AzureRmAccount -Subscription "8124xxxx-e3xx-4dxx-9fxx-9533e462xxxx"
```
認証画面が表示されるので、「事前の準備」で作成をしたアカウントでサインインをする
以下のコマンドを実行して、SubscriptionID、TenantID、AccountID を取得する
```
 $subscriptionid = (Get-AzureRmContext).Subscription.Id
$tenantid = (Get-AzureRmContext).Tenant.Id
$accountid = (Get-AzureRmContext).Account.Id
```
※ ここで取得した各値は後で使用します。
以下のコマンドを実行して Token を取得する
```
 $token = (Get-AzureRmContext).TokenCache.ReadItems() | where {($_.TenantId -eq $tenantid) -and ($_.DisplayableId -eq $accountid)}
```
※ ここで取得した Token を使用して、Azure REST API を呼びます。

※ つまり、上記 3. - 4. の PowerShell からのサインインの際に発行された Token を流用して Azure REST API を使用します。
以下のコマンドを実行して、Azure REST API を呼び出すための URL を作成する
```
 $url = "https://management.azure.com/subscriptions/" + $subscriptionId + "/providers/Microsoft.Consumption/usageDetails?api-version=2018-10-01"
```
※ この URL の詳細は、以下弊社公開情報をご参照ください。

Usage Details - List
/en-us/rest/api/consumption/usagedetails/list

以下のコマンドを実行して、Azure REST API を呼び出すためのその他の情報を作成する

 $method = "GET"
$headers = @{"Authorization" = "Bearer " + $token[0].AccessToken}
$contenttype = "application/json"

以下のコマンドを実行して、Azure REST API を呼び出し、その結果を取得する

 $responce = Invoke-WebRequest -Uri $url -Method $method -Headers $headers -ContentType $contenttype

以下のコマンドを実行して、Azure REST API の結果を表示する
```
 ConvertFrom-Json $responce | ConvertTo-Json
```

以上で「PowerShell」を使用した Azure REST API の呼び出しは終了です。
上記 7. で作成している URL に様々なパラメーターを設定して Azure REST API を呼び出せます。
是非、色々お試しいただければと思います。

Partager via