Put 속성
Service Fabric 속성을 만들거나 업데이트합니다.
지정된 이름에서 지정된 Service Fabric 속성을 만들거나 업데이트합니다.
요청
메서드 | 요청 URI |
---|---|
PUT | /Names/{nameId}/$/GetProperty?api-version=6.0&timeout={timeout} |
매개 변수
속성 | 형식 | 필수 | 위치 |
---|---|---|---|
nameId |
문자열 | 예 | 경로 |
api-version |
문자열 | 예 | 쿼리 |
timeout |
정수(int64) | 아니요 | 쿼리 |
PropertyDescription |
PropertyDescription | yes | 본문 |
nameId
형식: 문자열
필수: 예
‘fabric:’ URI 체계가 없는 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 버전에 따라 다릅니다.
timeout
형식: 정수(int64)
필수: 아니요
기본: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1
작업을 수행하기 위한 서버 제한 시간(초)입니다. 이 시간 제한은 요청된 작업이 완료될 때까지 클라이언트가 기다릴 시간을 지정합니다. 이 매개 변수의 기본값은 60초입니다.
PropertyDescription
형식: PropertyDescription
필수: 예
만들 Service Fabric 속성에 대해 설명합니다.
응답
HTTP 상태 코드 | 설명 | 응답 스키마 |
---|---|---|
200(확인) | 성공적인 응답은 속성이 만들어지거나 업데이트되었음을 의미합니다. |
|
다른 모든 상태 코드 | 자세한 오류 응답입니다. |
FabricError |
예제
Put 속성
이 예제에서는 지정된 이름으로 Service Fabric 속성을 만들거나 업데이트하는 방법을 보여 줍니다.
요청
PUT http://localhost:19080/Names/samples/apps/CalculatorApp/$/GetProperty?api-version=6.0
본문
{
"PropertyName": "AppData",
"Value": {
"Kind": "Binary",
"Data": [
"0",
"1",
"2",
"3",
"4",
"5"
]
}
}
200 응답
본문
응답 본문은 비어 있습니다.
사용자 지정 속성 배치
이 예제에서는 사용자 지정 형식으로 지정된 이름으로 Service Fabric 속성을 만들거나 업데이트하는 방법을 보여 줍니다.
요청
PUT http://localhost:19080/Names/samples/apps/CalculatorApp/$/GetProperty?api-version=6.0
본문
{
"PropertyName": "AppData",
"Value": {
"Kind": "String",
"Data": "1+2=3"
},
"CustomTypeId": "EquationType"
}
200 응답
본문
응답 본문은 비어 있습니다.