名前でサービスの種類情報を取得する

  • [アーティクル]

Service Fabric クラスター内のプロビジョニングされたアプリケーションの種類でサポートされている特定のサービスの種類に関する情報を取得します。

Service Fabric クラスター内のプロビジョニングされたアプリケーションの種類でサポートされている特定のサービスの種類に関する情報を取得します。 指定されたアプリケーションの種類が存在する必要があります。 そうしないと、404 状態が返されます。 指定したサービスの種類がクラスターで見つからない場合は、204 応答が返されます。

Request

Method 要求 URI
GET /ApplicationTypes/{applicationTypeName}/$/GetServiceTypes/{serviceTypeName}?api-version=6.0&ApplicationTypeVersion={ApplicationTypeVersion}&timeout={timeout}

パラメーター

名前 Type 必須 場所
applicationTypeName string はい パス
serviceTypeName string はい パス
api-version string はい クエリ
ApplicationTypeVersion string はい クエリ
timeout integer (int64) いいえ クエリ

applicationTypeName

型: string
必須: はい

アプリケーションの種類名。

serviceTypeName

型: string
必須: はい

Service Fabric サービスの種類の名前を指定します。

api-version

型: string
必須: はい
既定値:

API のバージョン。 このパラメーターは必須であり、その値は '6.0' である必要があります。

Service Fabric REST API のバージョンは、API が導入または変更されたランタイム バージョンに基づいています。 Service Fabric ランタイムでは、複数のバージョンの API がサポートされています。 これは、サポートされている API の最新バージョンです。 より低い API バージョンが渡された場合、返される応答は、この仕様に記載されている応答とは異なる場合があります。

さらに、ランタイムは、現在のバージョンのランタイムまで、サポートされている最新バージョンより高いバージョンを受け入れます。 したがって、最新の API バージョンが 6.0 ですが、ランタイムが 6.1 の場合、クライアントの記述を容易にするために、ランタイムはその API のバージョン 6.1 を受け入れます。 ただし、API の動作は、文書化されている 6.0 バージョンに従います。

ApplicationTypeVersion

型: string
必須: はい

アプリケーションの種類のバージョン。

timeout

型: integer (int64)
必須: いいえ
既定値:
InclusiveMaximum: 4294967295
InclusiveMinimum: 1

操作を実行するためのサーバー タイムアウト (秒単位)。 このタイムアウトは、要求した操作が完了するまでクライアントが待機できる期間を指定します。 このパラメーターの既定値は 60 秒です。

応答

HTTP 状態コード 説明 応答スキーマ
200 (OK) プロビジョニングされたアプリケーションの種類でサポートされる特定のサービスの種類。
 ServiceTypeInfo
204 (NoContent) 指定したサービスの種類がクラスターで見つからない場合は、204 応答が返されます。
その他すべての状態コード 詳細なエラー応答。
 FabricError

使用例

すべてのノードに関する情報を取得します。

この例では、特定のサービスの種類に関する情報を取得する方法を示します。 指定したサービスの種類がクラスターで見つからない場合は、204 応答が返されます。

要求

GET http://localhost:19080/ApplicationTypes/Application2Type/$/GetServiceTypes/Actor1ActorServiceType?api-version=6.0&ApplicationTypeVersion=1.0.0

200 応答

本文
{
  "ServiceTypeDescription": {
    "IsStateful": true,
    "ServiceTypeName": "Actor1ActorServiceType",
    "PlacementConstraints": "",
    "HasPersistedState": true,
    "Kind": "Stateful",
    "Extensions": [
      {
        "Key": "__GeneratedServiceType__",
        "Value": "<GeneratedNames xmlns=\"http://schemas.microsoft.com/2015/03/fabact-no-schema\">\r\n            <DefaultService Name=\"Actor1ActorService\" />\r\n            <ReplicatorEndpoint Name=\"Actor1ActorServiceReplicatorEndpoint\" />\r\n            <ReplicatorConfigSection Name=\"Actor1ActorServiceReplicatorConfig\" />\r\n            <ReplicatorSecurityConfigSection Name=\"Actor1ActorServiceReplicatorSecurityConfig\" />\r\n            <StoreConfigSection Name=\"Actor1ActorServiceLocalStoreConfig\" />\r\n            <ServiceEndpointV2 Name=\"Actor1ActorServiceEndpointV2\" />\r\n          </GeneratedNames>"
      }
    ],
    "LoadMetrics": [],
    "ServicePlacementPolicies": []
  },
  "ServiceManifestVersion": "1.0.0",
  "ServiceManifestName": "Actor1Pkg",
  "IsServiceGroup": false
}

204 応答

本文

応答本文は空です。