이름으로 서비스 유형 정보 가져오기

아티클
07/19/2023

Service Fabric 클러스터에서 프로비전된 애플리케이션 유형에서 지원하는 특정 서비스 유형에 대한 정보를 가져옵니다.

Service Fabric 클러스터에서 프로비전된 애플리케이션 유형에서 지원하는 특정 서비스 유형에 대한 정보를 가져옵니다. 제공된 애플리케이션 유형이 존재해야 합니다. 그렇지 않으면 404 상태가 반환됩니다. 클러스터에서 지정된 서비스 유형을 찾을 수 없는 경우 204 응답이 반환됩니다.

요청

메서드	요청 URI
GET	`/ApplicationTypes/{applicationTypeName}/$/GetServiceTypes/{serviceTypeName}?api-version=6.0&ApplicationTypeVersion={ApplicationTypeVersion}&timeout={timeout}`

매개 변수

속성	형식	필수	위치
`applicationTypeName`	문자열	예	경로
`serviceTypeName`	문자열	예	경로
`api-version`	문자열	예	쿼리
`ApplicationTypeVersion`	문자열	예	쿼리
`timeout`	정수(int64)	아니요	쿼리

`applicationTypeName`

형식: 문자열
필수: 예

애플리케이션 유형의 이름입니다.

`serviceTypeName`

형식: 문자열
필수: 예

Service Fabric 서비스 유형의 이름을 지정합니다.

`api-version`

형식: 문자열
필수: 예
기본: 6.0

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`

형식: 문자열
필수: 예

애플리케이션 유형의 버전입니다.

`timeout`

형식: 정수(int64)
필수: 아니요
기본: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1

작업을 수행하기 위한 서버 제한 시간(초)입니다. 이 시간 제한은 요청된 작업이 완료될 때까지 클라이언트가 기다릴 시간을 지정합니다. 이 매개 변수의 기본값은 60초입니다.

응답

HTTP 상태 코드	설명	응답 스키마
200(확인)	프로비전된 애플리케이션 유형에서 지원하는 특정 서비스 유형입니다.	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 응답

본문

응답 본문은 비어 있습니다.

Share via