この記事では、メタデータに関する背景情報と、それを Azure API Center の API ガバナンスに使用する方法について説明します。 API Center 内の API やその他のエンティティを整理してフィルター処理するために、メタデータを定義して整理します。 メタデータには "組み込み" と "カスタム" があり、メタデータ スキーマを作成して、API、環境、デプロイ全体で一貫性を確保することができます。
組み込みメタデータ
API センターで API、環境、デプロイを作成または更新する場合は、API の種類 (REST、WSD など) のような特定の組み込みメタデータ プロパティを設定します。
次の表には、Azure API Center エンティティに提供される組み込みメタデータを一覧表示しています。 詳細については、「API Center REST API リファレンス」を参照してください。 テーブルには、リソース識別子、表示タイトル、説明などの標準の Azure プロパティは含まれません。 すべてのプロパティが必要なわけではありません。
API（アプリケーションプログラミングインターフェース）
| メタデータ | Description | 値の例 |
|---|---|---|
| kind | API の種類 (タイプ) | REST、SOAP、GraphQL |
| ライフサイクル ステージ | API 開発ライフサイクルのステージ | 設計、開発 |
| ライセンス | API のライセンス情報 | SPDX 識別子、ライセンス テキストへのリンク |
| 外部ドキュメント | API の外部ドキュメントのサイト | ドキュメントを参照する URL |
| 連絡先情報 | API の連絡先 | メール アドレス、名前、URL |
| サービス使用条件 | API のサービス使用条件 | サービス使用条件を参照する URL |
Environments
| メタデータ | Description | 値の例 |
|---|---|---|
| kind | 環境の種類 (タイプ) | 運用、ステージング、開発 |
| サーバー | 環境のサーバー情報 | 環境サーバーを指す種類と URL |
| サーバーの種類 | 環境サーバーの種類 | API Management サーバー、Kubernetes サーバー、Apigee サーバー |
| オンボーディング | 環境のオンボード情報 | 環境の開発者ポータルを指す手順と URL |
デプロイメント
| メタデータ | Description | 値の例 |
|---|---|---|
| サーバー | デプロイのサーバー情報 | デプロイ サーバーを参照する URL |
| 状態 | デプロイの状態 | アクティブ、非アクティブ |
カスタム メタデータ
Azure portal、Azure API センター REST API、または Azure CLI を使用してカスタム メタデータを定義し、API Center 内のAPI、環境、デプロイの整理とフィルター処理をサポートします。 Azure API Center は、次の種類のカスタム メタデータをサポートしています。
| タイプ | Description | 名前の例 |
|---|---|---|
| ブーリアン | ｔrue または false | IsInternal |
| 数値 | 数値 | YearOfCreation |
| 文字列 | テキスト値 | GitHubRepository |
| アレイ | 値の一覧 | タグ |
| 組み込みの選択 | 選択肢の組み込みリスト | Department |
| オブジェクト | 複数の型で構成される複合オブジェクト | APIApprover |
Important
定義したメタデータのタイトル (名前) に、機密性の高い、機密性の高い、または個人情報を含めないでください。 これらのタイトルは、サービスの機能を向上させるために Microsoft によって使用される監視ログに表示されます。 ただし、その他のメタデータの詳細と値は、保護された顧客データです。
エンティティへのメタデータの割り当て
カスタム メタデータ プロパティは、API Center の API、環境、またはデプロイに割り当てることができます。 たとえば、API に Department というメタデータを定義して割り当てると、API が登録されるときや新しい API バージョンが追加されるときに、その API を担当する部署を指定できます。
エンティティに割り当てられている場合、メタデータは省略可能または必須です。 たとえば、API に対してのみ部署メタデータを設定することを要求し、環境に対しては YearOfCreation をオプションのメタデータとして許可します。
注
- API Center では、いつでもカスタム メタデータを定義し、API やその他のエンティティに適用できます。
- カスタム メタデータを定義した後、そのエンティティへの割り当てを変更できます (たとえば、API に対して必須から省略可能へなど)。
- メタデータの値を変更することはできますが、API、環境、デプロイに現在設定されているカスタム メタデータの種類を削除または変更することはできません。 最初にカスタム メタデータをエンティティから割り当て解除してから、削除または変更を行うことはできます。
ガバナンスにメタデータを使用する
組み込みメタデータとカスタム メタデータを使用して、API Center 内の API、環境、デプロイを整理します。 例えば次が挙げられます。
API、環境、デプロイに特定のメタデータを設定することを要求することで、組織にガバナンス標準を適用します。
API Center の API をメタデータの値で検索し、フィルター処理します。 Azure portal の API ページで直接フィルター処理するか、Azure API Center REST API または Azure CLI を使用して、特定のメタデータの値に基づいて API にクエリを実行できます。
