Services - Get

서비스:

Service Fabric

API 버전:

2023-11-01-preview

Service Fabric 서비스 리소스를 받아.
서비스 Fabric 리소스를 서비스 Fabric 애플리케이션 리소스에서 생성하거나 생성 중인 서비스를 받아보세요.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceFabric/clusters/{clusterName}/applications/{applicationName}/services/{serviceName}?api-version=2023-11-01-preview

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
applicationName	path	True	string	애플리케이션 리소스의 이름입니다.
clusterName	path	True	string	클러스터 리소스의 이름입니다.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	리소스 그룹의 이름입니다. 이름은 대소문자를 구분하지 않습니다.
serviceName	path	True	string	{applicationName}~{serviceName} 형식으로 된 서비스 리소스의 이름입니다.
subscriptionId	path	True	string minLength: 1	대상 구독의 ID입니다.
api-version	query	True	string minLength: 1	이 작업에 사용할 API 버전입니다.

응답

Name	형식	Description
200 OK	ServiceResource	Azure 운영이 성공적으로 완료되었습니다.
Other Status Codes	ErrorModel	예기치 않은 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow.

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name	Description
user_impersonation	사용자 계정 가장

예제

Get a service

샘플 요청

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resRg/providers/Microsoft.ServiceFabric/clusters/myCluster/applications/myApp/services/myService?api-version=2023-11-01-preview

샘플 응답

상태 코드:

200

{
  "name": "myCluster",
  "type": "services",
  "etag": "W/\"636462502183671258\"",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/clusters/myCluster/applications/myApp/services/myService",
  "location": "eastus",
  "properties": {
    "defaultMoveCost": "Medium",
    "instanceCount": 5,
    "partitionDescription": {
      "partitionScheme": "Singleton"
    },
    "placementConstraints": "NodeType==frontend",
    "provisioningState": "Updating",
    "serviceKind": "Stateless",
    "serviceLoadMetrics": [
      {
        "name": "metric1",
        "weight": "Low"
      }
    ],
    "servicePackageActivationMode": "SharedProcess",
    "servicePlacementPolicies": [],
    "serviceTypeName": "myServiceType"
  },
  "tags": {}
}

정의

Name	Description
ArmServicePackageActivationMode	서비스 패키지의 활성화 모드
createdByType	리소스를 만든 ID의 형식입니다.
ErrorModel	오류의 구조.
ErrorModelError	오류 세부 정보입니다.
MoveCost	서비스의 이동 비용을 지정합니다.
NamedPartitionSchemeDescription	서비스의 명명된 파티션 구성표를 설명합니다.
PartitionScheme	서비스를 분할할 수 있는 방법을 열거합니다.
ServiceCorrelationDescription	서비스 간에 특정 상관 관계를 만듭니다.
ServiceCorrelationScheme	서비스 상관 관계 체계입니다.
ServiceKind	서비스 종류(상태 비지정 또는 상태 저장)입니다.
ServiceLoadMetricDescription	런타임 중에 서비스의 부하를 분산하는 메트릭을 지정합니다.
ServiceLoadMetricWeight	이 서비스에 대해 구성된 다른 메트릭을 기준으로 메트릭 가중치를 결정합니다. 런타임 동안 두 메트릭이 충돌하면 Cluster Resource Manager가 가중치가 높은 메트릭을 선호합니다.
ServiceResource	서비스 리소스입니다.
SingletonPartitionSchemeDescription	단일 분할 또는 분할되지 않은 서비스의 파티션 구성표에 대해 설명합니다.
StatefulServiceProperties	상태 저장 서비스 리소스의 속성입니다.
StatelessServiceProperties	상태 비지정 서비스 리소스의 속성입니다.
systemData	리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.
UniformInt64RangePartitionSchemeDescription	정수 범위가 여러 파티션에 균등하게 할당되는 분할 체계에 대해 설명합니다.

ArmServicePackageActivationMode

열거형

서비스 패키지의 활성화 모드

값	Description
SharedProcess	애플리케이션 패키지 활성화 모드가 공유 프로세스를 사용한다는 것을 나타냅니다.
ExclusiveProcess	애플리케이션 패키지 활성화 모드가 독점 프로세스를 사용한다는 것을 나타냅니다.

createdByType

열거형

리소스를 만든 ID의 형식입니다.

값	Description
User
Application
ManagedIdentity
Key

ErrorModel

Object

오류의 구조.

Name	형식	Description
error	ErrorModelError	오류 세부 정보입니다.

ErrorModelError

Object

오류 세부 정보입니다.

Name	형식	Description
code	string	오류 코드입니다.
message	string	오류 메시지입니다.

MoveCost

열거형

서비스의 이동 비용을 지정합니다.

값	Description
Zero	이동 비용이 전혀 없습니다. 이 값은 0입니다.
Low	서비스 이동 비용을 낮음으로 지정합니다. 값은 1입니다.
Medium	서비스의 이동 비용을 Medium으로 지정합니다. 값은 2입니다.
High	서비스 이동 비용을 높음으로 명시합니다. 값은 3입니다.

NamedPartitionSchemeDescription

Object

서비스의 명명된 파티션 구성표를 설명합니다.

Name	형식	Description
count	integer (int32)	파티션 수입니다.
names	string[]	파티션 이름에 대해 'count' 매개 변수로 지정된 크기의 배열입니다.
partitionScheme	string: Named	서비스를 분할하는 방법을 지정합니다.

PartitionScheme

열거형

서비스를 분할할 수 있는 방법을 열거합니다.

값	Description
Invalid	파티션 종류가 유효하지 않음을 나타냅니다. 모든 Service Fabric 열거는 유효하지 않은 타입을 가지고 있습니다. 값은 0입니다.
Singleton	파티션이 문자열 이름에 기반함을 나타내며, SingletonPartitionSchemeDescription 객체입니다. 값은 1입니다.
UniformInt64Range	파티션이 Int64 키 범위에 기반함을 나타내며, UniformInt64RangePartitionSchemeDescription 객체입니다. 값은 2입니다.
Named	파티션이 문자열 이름을 기반으로 하며, NamedPartitionSchemeDescription 객체입니다. 값은 3입니다

ServiceCorrelationDescription

Object

서비스 간에 특정 상관 관계를 만듭니다.

Name	형식	Description
scheme	ServiceCorrelationScheme	이 서비스와 ServiceName을 통해 지정된 서비스 간의 관계를 설명하는 ServiceCorrelationScheme입니다.
serviceName	string	'fabric:' URI 방식이 포함된 서비스의 전체 명칭입니다.

ServiceCorrelationScheme

열거형

서비스 상관 관계 체계입니다.

값	Description
Invalid	유효하지 않은 상관관계 체계. 사용할 수 없습니다. 값은 0입니다.
Affinity	이 서비스가 다른 서비스와 친화관계가 있음을 나타냅니다. 하위 호환성을 위해 정렬 또는 비정렬 친화력 옵션을 선호하는 것을 고려하세요. 값은 1입니다.
AlignedAffinity	정렬된 친화성은 친화성 서비스의 파티션 기본 노드들이 동일한 노드에 함께 위치하도록 보장합니다. 기본값이며 선호도 구성표를 선택하는 것과 같습니다. 값은 2입니다.
NonAlignedAffinity	비동맹 친화도는 각 서비스의 모든 복제본이 동일한 노드에 배치되도록 보장합니다. 정렬된 선호도와 달리 특정 역할의 복제본이 배치되는 것을 보장하지는 않습니다. 값은 3입니다.

ServiceKind

열거형

서비스 종류(상태 비지정 또는 상태 저장)입니다.

값	Description
Invalid	서비스 종류가 유효하지 않음을 나타냅니다. 모든 Service Fabric 열거는 유효하지 않은 타입을 가지고 있습니다. 값은 0입니다.
Stateless	서비스 Fabric을 사용하지 않아 주를 매우 유용하거나 신뢰할 수 있게 만듭니다. 값은 1입니다.
Stateful	서비스 Fabric을 사용하여 주 또는 그 일부를 매우 유용하고 신뢰할 수 있게 만듭니다. 값은 2입니다.

ServiceLoadMetricDescription

Object

런타임 중에 서비스의 부하를 분산하는 메트릭을 지정합니다.

Name	형식	Description
defaultLoad	integer (int32)	상태 비지정 서비스에만 사용됩니다. 이 서비스가 이 메트릭에 대해 만드는 기본 로드 양(숫자)입니다.
name	string	메트릭의 이름입니다. 서비스가 런타임 중에 부하를 보고하도록 선택하는 경우 부하 메트릭 이름은 이름에 지정된 이름과 정확히 일치해야 합니다. 메트릭 이름은 대/소문자를 구분합니다.
primaryDefaultLoad	integer (int32)	상태 저장 서비스에만 사용됩니다. 이 서비스가 주 복제본일 때 이 메트릭에 대해 만드는 기본 로드 양(숫자)입니다.
secondaryDefaultLoad	integer (int32)	상태 저장 서비스에만 사용됩니다. 보조 복제본인 경우 이 서비스가 이 메트릭에 대해 만드는 기본 로드 양(숫자)입니다.
weight	ServiceLoadMetricWeight	이 서비스에 대해 구성된 다른 메트릭과 비교하여 서비스 부하 메트릭 상대적 가중치를 숫자로 표시합니다.

ServiceLoadMetricWeight

열거형

이 서비스에 대해 구성된 다른 메트릭을 기준으로 메트릭 가중치를 결정합니다. 런타임 동안 두 메트릭이 충돌하면 Cluster Resource Manager가 가중치가 높은 메트릭을 선호합니다.

값	Description
Zero	이 지표에 대한 자원 균형 설정을 비활성화합니다. 이 값은 0입니다.
Low	서비스 부하의 메트릭 중량을 Low로 지정합니다. 값은 1입니다.
Medium	서비스 부하의 미터 중량을 중간으로 지정합니다. 값은 2입니다.
High	서비스 부하의 미터 중량을 높음으로 지정합니다. 값은 3입니다.

ServiceResource

Object

서비스 리소스입니다.

Name	형식	Description
etag	string	Azure resource etag.
id	string	리소스에 대한 정규화된 리소스 ID입니다. 예 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	새 API에서는 더 이상 사용되지 않으며 리소스 위치는 부모 리소스에 따라 달라집니다.
name	string	리소스의 이름
properties	ServiceResourceProperties: StatefulServiceProperties StatelessServiceProperties	서비스 리소스 속성입니다.
systemData	systemData	Azure Resource Manager 메타데이터에 createdBy 및 modifiedBy 정보가 포함되어 있습니다.
tags	object	Azure 리소스 태그.
type	string	리소스의 형식입니다. 예를 들어, "Microsoft. 컴퓨트/가상 머신" 또는 "Microsoft." 저장소/저장소 계정"

SingletonPartitionSchemeDescription

Object

단일 분할 또는 분할되지 않은 서비스의 파티션 구성표에 대해 설명합니다.

Name	형식	Description
partitionScheme	string: Singleton	서비스를 분할하는 방법을 지정합니다.

StatefulServiceProperties

Object

상태 저장 서비스 리소스의 속성입니다.

Name	형식	Description
correlationScheme	ServiceCorrelationDescription[]	서비스와 다른 서비스의 상관 관계를 설명하는 목록입니다.
defaultMoveCost	MoveCost	서비스의 이동 비용을 지정합니다.
hasPersistedState	boolean	로컬 디스크에 상태를 저장하는 영구 서비스인지 여부를 나타내는 플래그입니다. 이 속성이면 이 속성의 값이 true이고, 그렇지 않으면 false입니다.
minReplicaSetSize	integer (int32) minimum: 1	최소 복제본 집합 크기(숫자)입니다.
partitionDescription	PartitionSchemeDescription: NamedPartitionSchemeDescription SingletonPartitionSchemeDescription UniformInt64RangePartitionSchemeDescription	서비스가 분할되는 방법을 설명합니다.
placementConstraints	string	문자열로서의 배치 제약 조건입니다. 배치 제약 조건은 노드 속성에 대한 부울 식이며 서비스 요구 사항에 따라 서비스를 특정 노드로 제한할 수 있습니다. 예를 들어 NodeType이 파란색인 노드에 서비스를 배치하려면 "NodeColor == blue)"를 지정합니다.
provisioningState	string	응답에만 표시되는 현재 배포 또는 프로비전 상태입니다.
quorumLossWaitDuration	string (date-time)	파티션이 ISO 8601 형식(hh:mm:ss.s)으로 표현되는 쿼럼 손실 상태에 있을 수 있는 최대 기간입니다.
replicaRestartWaitDuration	string (date-time)	복제본이 다운된 시점과 새 복제본을 만든 시점 사이의 기간이며 ISO 8601 형식(hh:mm:ss.s)으로 표시됩니다.
serviceDnsName	string	서비스에 사용되는 Dns 이름입니다. 이 이름을 지정하면 DNS 이름을 사용하여 애플리케이션 계층 프로토콜(예: HTTP)에 대한 서비스 엔드포인트의 IP 주소를 반환할 수 있습니다. serviceDnsName을 업데이트할 때 이전 이름을 일시적으로 확인할 수 있습니다. 그러나 새 이름을 사용합니다. serviceDnsName을 제거할 때 제거된 이름을 일시적으로 확인할 수 있습니다. 수정할 수 없는 이름에 의존하지 마세요.
serviceKind	string: Stateful	서비스 종류(상태 비지정 또는 상태 저장)입니다.
serviceLoadMetrics	ServiceLoadMetricDescription[]	서비스 로드 메트릭은 ServiceLoadMetricDescription 개체의 배열로 제공됩니다.
servicePackageActivationMode	ArmServicePackageActivationMode	서비스 패키지의 활성화 모드
servicePlacementPolicies	ServicePlacementPolicyDescription[]	서비스와 다른 서비스의 상관 관계를 설명하는 목록입니다.
serviceTypeName	string	서비스 유형의 이름입니다.
standByReplicaKeepDuration	string (date-time)	ISO 8601 형식(hh:mm:ss.s)으로 표시되어 제거되기 전에 대기 복제본을 유지 관리해야 하는 기간에 대한 정의입니다.
targetReplicaSetSize	integer (int32) minimum: 1	대상 복제본 집합 크기는 숫자로 설정됩니다.

StatelessServiceProperties

Object

상태 비지정 서비스 리소스의 속성입니다.

Name	형식	Description
correlationScheme	ServiceCorrelationDescription[]	서비스와 다른 서비스의 상관 관계를 설명하는 목록입니다.
defaultMoveCost	MoveCost	서비스의 이동 비용을 지정합니다.
instanceCloseDelayDuration	string	인스턴스를 닫기 전에 지연이 시작되기 전에 상태 비주류 인스턴스에서 보급된 엔드포인트가 제거되도록 RequestDrain 기능에 대한 지연 기간입니다. 이 지연 덕분에 인스턴스가 실제로 다운되기 전에 기존 요청이 원활하게 소모될 수 있습니다(https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-application-upgrade-advanced#avoid-connection-drops-during-stateless-service-planned-downtime-preview). ISO 8601 형식(hh:mm:ss.s)으로 표시됩니다.
instanceCount	integer (int32) minimum: -1	인스턴스 수입니다.
minInstanceCount	integer (int32)	MinInstanceCount는 업그레이드 또는 비활성화 노드와 같은 작업 중에 EnsureAvailability 안전성 검사를 충족해야 하는 최소 인스턴스 수입니다. 사용되는 실제 수는 max(MinInstanceCount, ceil( MinInstancePercentage/100.0 * InstanceCount) )입니다. InstanceCount가 -1로 설정된 경우 MinInstanceCount 계산 중 -1 먼저 서비스의 배치 제약 조건에 따라 인스턴스를 배치할 수 있는 노드 수로 변환됩니다.
minInstancePercentage	string (byte)	MinInstancePercentage는 업그레이드 또는 비활성화 노드와 같은 작업 중에 EnsureAvailability 안전성 검사를 충족해야 하는 InstanceCount의 최소 비율입니다. 사용되는 실제 수는 max(MinInstanceCount, ceil( MinInstancePercentage/100.0 * InstanceCount) )입니다. MinInstancePercentage 계산 중에 InstanceCount가 -1로 설정된 경우 -1 먼저 서비스의 배치 제약 조건에 따라 인스턴스를 배치할 수 있는 노드 수로 변환됩니다.
partitionDescription	PartitionSchemeDescription: NamedPartitionSchemeDescription SingletonPartitionSchemeDescription UniformInt64RangePartitionSchemeDescription	서비스가 분할되는 방법을 설명합니다.
placementConstraints	string	문자열로서의 배치 제약 조건입니다. 배치 제약 조건은 노드 속성에 대한 부울 식이며 서비스 요구 사항에 따라 서비스를 특정 노드로 제한할 수 있습니다. 예를 들어 NodeType이 파란색인 노드에 서비스를 배치하려면 "NodeColor == blue)"를 지정합니다.
provisioningState	string	응답에만 표시되는 현재 배포 또는 프로비전 상태입니다.
serviceDnsName	string	서비스에 사용되는 Dns 이름입니다. 이 이름을 지정하면 DNS 이름을 사용하여 애플리케이션 계층 프로토콜(예: HTTP)에 대한 서비스 엔드포인트의 IP 주소를 반환할 수 있습니다. serviceDnsName을 업데이트할 때 이전 이름을 일시적으로 확인할 수 있습니다. 그러나 새 이름을 사용합니다. serviceDnsName을 제거할 때 제거된 이름을 일시적으로 확인할 수 있습니다. 수정할 수 없는 이름에 의존하지 마세요.
serviceKind	string: Stateless	서비스 종류(상태 비지정 또는 상태 저장)입니다.
serviceLoadMetrics	ServiceLoadMetricDescription[]	서비스 로드 메트릭은 ServiceLoadMetricDescription 개체의 배열로 제공됩니다.
servicePackageActivationMode	ArmServicePackageActivationMode	서비스 패키지의 활성화 모드
servicePlacementPolicies	ServicePlacementPolicyDescription[]	서비스와 다른 서비스의 상관 관계를 설명하는 목록입니다.
serviceTypeName	string	서비스 유형의 이름입니다.

systemData

Object

리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

Name	형식	Description
createdAt	string (date-time)	리소스 만들기의 타임스탬프(UTC)입니다.
createdBy	string	리소스를 만든 ID입니다.
createdByType	createdByType	리소스를 만든 ID의 형식입니다.
lastModifiedAt	string (date-time)	리소스 마지막 수정의 타임스탬프(UTC)
lastModifiedBy	string	리소스를 마지막으로 수정한 ID입니다.
lastModifiedByType	createdByType	리소스를 마지막으로 수정한 ID의 형식입니다.

UniformInt64RangePartitionSchemeDescription

Object

정수 범위가 여러 파티션에 균등하게 할당되는 분할 체계에 대해 설명합니다.

Name	형식	Description
count	integer (int32)	파티션 수입니다.
highKey	string	파티션 키 범위의 상한을 나타내는 문자열로, 파티션 '카운트'에 나눠야 합니다.
lowKey	string	파티션 키 범위의 하한을 나타내는 문자열은 파티션 'count' 사이에 나눠야 합니다
partitionScheme	string: UniformInt64Range	서비스를 분할하는 방법을 지정합니다.