Apis - Get
識別子で指定された API の詳細を取得します。
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}?api-version=2021-08-01
URI パラメーター
名前 | / | 必須 | 型 | 説明 |
---|---|---|---|---|
api
|
path | True |
string |
API リビジョン識別子。 現在のAPI Management サービス インスタンスで一意である必要があります。 現在以外のリビジョンには があります。rev=n はサフィックスで、n はリビジョン番号です。 正規表現パターン: |
resource
|
path | True |
string |
リソース グループの名前。 |
service
|
path | True |
string |
API Management サービスの名前。 正規表現パターン: |
subscription
|
path | True |
string |
Microsoft Azure サブスクリプションを一意に識別するサブスクリプション資格情報。 サブスクリプション ID は、全ての修理依頼についてURI の一部を生じさせます。 |
api-version
|
query | True |
string |
クライアント要求で使用される API のバージョン。 |
応答
名前 | 型 | 説明 |
---|---|---|
200 OK |
応答本文には、指定された API エンティティが含まれます。 ヘッダー ETag: string |
|
Other Status Codes |
操作に失敗した理由を説明するエラー応答。 |
セキュリティ
azure_auth
Azure Active Directory OAuth2 フロー。
型:
oauth2
フロー:
implicit
Authorization URL (承認 URL):
https://login.microsoftonline.com/common/oauth2/authorize
スコープ
名前 | 説明 |
---|---|
user_impersonation | ユーザー アカウントの借用 |
例
Api |
Api |
ApiManagementGetApiContract
要求のサンプル
応答のサンプル
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/57d1f7558aa04f15146d9d8a",
"type": "Microsoft.ApiManagement/service/apis",
"name": "57d1f7558aa04f15146d9d8a",
"properties": {
"displayName": "Service",
"apiRevision": "1",
"serviceUrl": "https://api.plexonline.com/DataSource/Service.asmx",
"path": "schulte",
"protocols": [
"https"
],
"subscriptionKeyParameterNames": {
"header": "Ocp-Apim-Subscription-Key",
"query": "subscription-key"
},
"type": "soap",
"isCurrent": true,
"isOnline": true
}
}
ApiManagementGetApiRevisionContract
要求のサンプル
応答のサンプル
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/echo-api;rev=3",
"type": "Microsoft.ApiManagement/service/apis",
"name": "echo-api;rev=3",
"properties": {
"displayName": "Service",
"apiRevision": "3",
"serviceUrl": "https://api.plexonline.com/DataSource/Service.asmx",
"path": "schulte",
"protocols": [
"https"
],
"subscriptionKeyParameterNames": {
"header": "Ocp-Apim-Subscription-Key",
"query": "subscription-key"
},
"apiRevisionDescription": "fixed bug in contract"
}
}
定義
名前 | 説明 |
---|---|
Api |
API の連絡先情報 |
Api |
API の詳細。 |
Api |
API ライセンス情報 |
Api |
API の種類。 |
Api |
API バージョン セットには、関連する一連の API バージョンの一般的な構成が含まれています |
Authentication |
API 認証の設定。 |
bearer |
サーバーにトークンを送信する方法。 |
Error |
エラー フィールド コントラクト。 |
Error |
エラー応答。 |
OAuth2Authentication |
API OAuth2 認証設定の詳細。 |
Open |
API OAuth2 認証設定の詳細。 |
Protocol |
この API の操作を呼び出すことができるプロトコルを記述します。 |
Subscription |
サブスクリプション キー パラメーター名の詳細。 |
ApiContactInformation
API の連絡先情報
名前 | 型 | 説明 |
---|---|---|
string |
連絡先/organizationのメール アドレス。 電子メール アドレスの形式にする必要があります |
|
name |
string |
連絡先/organizationの識別名 |
url |
string |
連絡先情報を指す URL。 URL の形式にする必要があります |
ApiContract
API の詳細。
名前 | 型 | 説明 |
---|---|---|
id |
string |
リソースの完全修飾リソース ID。 例 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
リソースの名前 |
properties.apiRevision |
string |
API のリビジョンについて説明します。 値が指定されていない場合は、既定のリビジョン 1 が作成されます |
properties.apiRevisionDescription |
string |
API リビジョンの説明。 |
properties.apiVersion |
string |
API がバージョン管理されている場合に API のバージョン識別子を示します |
properties.apiVersionDescription |
string |
API バージョンの説明。 |
properties.apiVersionSet |
バージョン セットの詳細 |
|
properties.apiVersionSetId |
string |
関連する ApiVersionSet のリソース識別子。 |
properties.authenticationSettings |
この API に含まれる認証設定のコレクション。 |
|
properties.contact |
API の連絡先情報。 |
|
properties.description |
string |
API の説明。 HTML 書式設定タグを含めることができます。 |
properties.displayName |
string |
API 名。 長さは 1 ~ 300 文字にする必要があります。 |
properties.isCurrent |
boolean |
API リビジョンが現在の API リビジョンであるかどうかを示します。 |
properties.isOnline |
boolean |
API リビジョンにゲートウェイ経由でアクセスできるかどうかを示します。 |
properties.license |
API のライセンス情報。 |
|
properties.path |
string |
API Management サービス インスタンス内のこの API とそのすべてのリソース パスを一意に識別する相対 URL。 この API のパブリック URL を作成するために、サービス インスタンスの作成時に指定された API エンドポイントのベース URL に追加されます。 |
properties.protocols |
Protocol[] |
この API の操作を呼び出すことができるプロトコルを記述します。 |
properties.serviceUrl |
string |
この API を実装するバックエンド サービスの絶対 URL。 2,000 文字を超えることはできません。 |
properties.sourceApiId |
string |
ソース API の API 識別子。 |
properties.subscriptionKeyParameterNames |
API を使用できるようにするプロトコル。 |
|
properties.subscriptionRequired |
boolean |
API にアクセスするために API サブスクリプションと Product サブスクリプションのどちらを必要とするかを指定します。 |
properties.termsOfServiceUrl |
string |
API の利用規約への URL。 URL の形式にする必要があります。 |
properties.type |
API の種類。 |
|
type |
string |
リソースの型。 例: "Microsoft.Compute/virtualMachines" または "Microsoft.Storage/storageAccounts" |
ApiLicenseInformation
API ライセンス情報
名前 | 型 | 説明 |
---|---|---|
name |
string |
API に使用されるライセンス名 |
url |
string |
API に使用されるライセンスの URL。 URL の形式にする必要があります |
ApiType
API の種類。
名前 | 型 | 説明 |
---|---|---|
graphql |
string |
|
http |
string |
|
soap |
string |
|
websocket |
string |
ApiVersionSetContractDetails
API バージョン セットには、関連する一連の API バージョンの一般的な構成が含まれています
名前 | 型 | 説明 |
---|---|---|
description |
string |
API バージョン セットの説明。 |
id |
string |
既存の API バージョン セットの識別子。 新しいバージョン セットを作成するには、この値を省略します。 |
name |
string |
API バージョン セットの表示名。 |
versionHeaderName |
string |
versioningScheme が に |
versionQueryName |
string |
versioningScheme が に |
versioningScheme |
enum:
|
HTTP 要求内の API バージョン識別子の場所を決定する値。 |
AuthenticationSettingsContract
API 認証の設定。
名前 | 型 | 説明 |
---|---|---|
oAuth2 |
OAuth2 認証設定 |
|
openid |
OpenID Connect 認証設定 |
bearerTokenSendingMethods
サーバーにトークンを送信する方法。
名前 | 型 | 説明 |
---|---|---|
authorizationHeader |
string |
アクセス トークンは、Bearer スキーマを使用して Authorization ヘッダーで送信されます |
query |
string |
アクセス トークンはクエリ パラメーターとして送信されます。 |
ErrorFieldContract
エラー フィールド コントラクト。
名前 | 型 | 説明 |
---|---|---|
code |
string |
プロパティ レベルのエラー コード。 |
message |
string |
プロパティ レベルエラーの人間が判読できる表現。 |
target |
string |
プロパティ名。 |
ErrorResponse
エラー応答。
名前 | 型 | 説明 |
---|---|---|
error.code |
string |
サービスによって定義されたエラー コード。 このコードは、応答に指定された HTTP エラー コードのサブステータスとして機能します。 |
error.details |
検証エラーが発生した場合に要求で送信される無効なフィールドの一覧。 |
|
error.message |
string |
人が判読できるエラーの表現。 |
OAuth2AuthenticationSettingsContract
API OAuth2 認証設定の詳細。
名前 | 型 | 説明 |
---|---|---|
authorizationServerId |
string |
OAuth 承認サーバーの識別子。 |
scope |
string |
操作スコープ。 |
OpenIdAuthenticationSettingsContract
API OAuth2 認証設定の詳細。
名前 | 型 | 説明 |
---|---|---|
bearerTokenSendingMethods |
サーバーにトークンを送信する方法。 |
|
openidProviderId |
string |
OAuth 承認サーバーの識別子。 |
Protocol
この API の操作を呼び出すことができるプロトコルを記述します。
名前 | 型 | 説明 |
---|---|---|
http |
string |
|
https |
string |
|
ws |
string |
|
wss |
string |
SubscriptionKeyParameterNamesContract
サブスクリプション キー パラメーター名の詳細。
名前 | 型 | 説明 |
---|---|---|
header |
string |
サブスクリプション キーヘッダー名。 |
query |
string |
サブスクリプション キークエリ文字列パラメーター名。 |