Service Configuration - Update

참조

서비스:: Cognitive Services - Personalizer

API 버전:: v1.1-preview.1

서비스 구성을 업데이트합니다.
Personalizer 서비스 구성을 업데이트합니다.

PUT {Endpoint}/personalizer/v1.1-preview.1/configurations/service

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
Endpoint	path	True	string	지원되는 Cognitive Services 엔드포인트.

요청 본문

Name	필수	형식	Description
defaultReward	True	number	지정된 대기 시간 내에 보상을 받지 못한 경우 주어진 보상입니다.
explorationPercentage	True	number	탐색을 사용할 순위 응답의 백분율입니다.
logRetentionDays	True	integer	기록 로그를 유지 관리할 일 수입니다. -1은 로그가 삭제되지 않을 것임을 의미합니다.
modelExportFrequency	True	string	Personalizer는 지정된 기간마다 자동으로 온라인 순위에 대해 가장 업데이트된 학습된 모델을 사용하기 시작합니다. 예를 들어 PT5M(5분)입니다. 시간 형식에 대한 자세한 내용은 http://en.wikipedia.org/wiki/ISO_8601#Durations
rewardAggregation	True	string	rewardWaitTime이 완료되기 전에 여러 보상 점수를 받은 경우 보상을 처리하는 데 사용되는 함수입니다.
rewardWaitTime	True	string	요청이 기본 보상으로 표시될 때까지 대기한 시간 범위이며 5초에서 2일 사이여야 합니다. 예를 들어 PT5M(5분)입니다. 시간 형식에 대한 자세한 내용은 http://en.wikipedia.org/wiki/ISO_8601#Durations
autoOptimizationFrequency		string	자동 최적화 빈도입니다. IsAutoOptimizationEnabled가 true인 경우에만 관련이 있습니다. 예를 들어 PT5M(5분)입니다. 시간 형식에 대한 자세한 내용은 \r\nhttp://en.wikipedia.org/wiki/ISO_8601#Durations
autoOptimizationStartDate		string	첫 번째 자동 최적화 평가를 수행해야 하는 날짜입니다. IsAutoOptimizationEnabled가 true인 경우에만 관련이 있습니다.
isAutoOptimizationEnabled		boolean	Personalizer가 오프라인 평가를 주기적으로 실행하여 학습 설정을 자동으로 최적화할지 여부를 나타내는 플래그입니다.
lastConfigurationEditDate		string	모델 학습 구성이 마지막으로 업데이트된 시간
learningMode		LearningMode	Personalizer 학습 모드
logMirrorEnabled		boolean	플래그는 로그 미러링을 사용할 수 있는지 여부를 나타냅니다.
logMirrorSasUri		string	로그 미러링을 위한 Azure Storage 계정 컨테이너 SAS URI입니다.

응답

Name	형식	Description
200 OK	ServiceConfiguration	Success
Other Status Codes	ErrorResponse	학습 모드를 Online에서 실습생 모드로 변경하는 경우 defaultReward, rewardWaitTime 및 rewardAggregation을 업데이트할 수 없으며 그 반대의 경우도 마찬가지입니다. 모드를 변경한 다음 추가 API 호출을 사용하여 추가 설정을 변경합니다.

예제

Successful ServiceConfiguration_Update request

샘플 요청

HTTP

PUT {Endpoint}/personalizer/v1.1-preview.1/configurations/service

{
  "rewardWaitTime": "PT10M",
  "defaultReward": 0,
  "rewardAggregation": "earliest",
  "explorationPercentage": 0.2,
  "modelExportFrequency": "PT5M",
  "logMirrorEnabled": true,
  "logMirrorSasUri": "https://testblob.blob.core.windows.net/container?se=2020-08-13T00%3A00Z&sp=rwl&spr=https&sv=2018-11-09&sr=c&sig=signature",
  "logRetentionDays": 7,
  "lastConfigurationEditDate": "0001-01-01T00:00:00Z",
  "learningMode": "Online",
  "isAutoOptimizationEnabled": true,
  "autoOptimizationFrequency": "P7D",
  "autoOptimizationStartDate": "2019-01-19T00:00:00Z"
}

샘플 응답

상태 코드:: 200

{
  "rewardWaitTime": "PT10M",
  "defaultReward": 0,
  "rewardAggregation": "earliest",
  "explorationPercentage": 0.2,
  "modelExportFrequency": "PT5M",
  "logMirrorEnabled": true,
  "logMirrorSasUri": "https://testblob.blob.core.windows.net/container?se=2020-08-13T00%3A00Z&sp=rwl&spr=https&sv=2018-11-09&sr=c&sig=signature",
  "logRetentionDays": 7,
  "lastConfigurationEditDate": "0001-01-01T00:00:00Z",
  "learningMode": "Online",
  "isAutoOptimizationEnabled": true,
  "autoOptimizationFrequency": "P7D",
  "autoOptimizationStartDate": "2019-01-19T00:00:00Z"
}

정의

Name	Description
ErrorResponse	클라이언트에 오류를 반환하는 데 사용됩니다.
InternalError	오류에 대한 부모 개체보다 더 구체적인 정보를 포함하는 개체입니다.
LearningMode	Personalizer 학습 모드
PersonalizerError	Error 개체.
PersonalizerErrorCode	Personalizer에서 반환된 오류 코드
ServiceConfiguration	서비스의 구성입니다.

ErrorResponse

클라이언트에 오류를 반환하는 데 사용됩니다.

Name	형식	Description
error	PersonalizerError	Error 개체.

InternalError

오류에 대한 부모 개체보다 더 구체적인 정보를 포함하는 개체입니다.

Name	형식	Description
code	string	자세한 오류 코드입니다.
innererror	InternalError	오류에 대한 부모 개체보다 더 구체적인 정보를 포함하는 개체입니다.

LearningMode

Personalizer 학습 모드

Name	형식	Description
Apprentice	string
LoggingOnly	string
Online	string

PersonalizerError

Error 개체.

Name	형식	Description
code	PersonalizerErrorCode	Personalizer에서 반환된 오류 코드
details	PersonalizerError[]	이 보고된 오류로 이어진 특정 오류에 대한 세부 정보 배열입니다.
innerError	InternalError	오류에 대한 부모 개체보다 더 구체적인 정보를 포함하는 개체입니다.
message	string	서비스에서 보고한 오류를 설명하는 메시지입니다.
target	string	오류 원본 요소입니다.

PersonalizerErrorCode

Personalizer에서 반환된 오류 코드

Name	형식	Description
ApprenticeModeNeverTurnedOn	string	견습생 모드는 켜지지 않았습니다.
BadRequest	string	서버에서 요청을 이해할 수 없습니다.
DuplicateCustomPolicyNames	string	사용자 지정 정책 이름은 고유해야 합니다.
EvaluationModelNotFound	string	평가에서 모델을 찾을 수 없습니다.
EvaluationNotFound	string	오프라인 평가를 찾을 수 없습니다.
FrontEndNotFound	string	프런트 엔드를 찾을 수 없습니다.
InternalServerError	string	서버에서 일반 오류가 발생했습니다.
InvalidContainer	string	SAS Uri는 쓰기 권한이 있는 컨테이너의 Uri여야 합니다.
InvalidEvaluationContract	string	평가 계약이 잘못되었습니다.
InvalidEventIdToActivate	string	이벤트 요청 활성화가 잘못되었습니다.
InvalidExportLogsRequest	string	잘못된 요청입니다.
InvalidLearningModeServiceConfiguration	string	학습 모드를 Online에서 실습생 모드로 변경하는 경우 defaultReward, rewardWaitTime 및 rewardAggregation을 업데이트할 수 없으며 그 반대의 경우도 마찬가지입니다. 모드를 변경한 다음 추가 API 호출을 사용하여 추가 설정을 변경합니다.
InvalidModelMetadata	string	모델 메타데이터가 잘못되었습니다.
InvalidMultiSlotApiAccess	string	다중 슬롯 기능은 현재 사용하지 않도록 설정되어 있습니다. 다중 슬롯 Personalizer 설명서에 따라 다중 슬롯 기능을 사용하도록 루프 설정을 업데이트하세요.
InvalidPolicyConfiguration	string	잘못된 정책 구성입니다.
InvalidPolicyContract	string	정책 계약이 잘못되었습니다.
InvalidRankRequest	string	잘못된 요청입니다.
InvalidRewardRequest	string	잘못된 보상 요청입니다.
InvalidRewardWaitTime	string	보상 대기 시간은 5초에서 2일 사이여야 합니다.
InvalidServiceConfiguration	string	서비스 구성이 잘못되었습니다.
LearningSettingsNotFound	string	평가에서 학습 설정을 찾을 수 없습니다.
LogsPropertiesNotFound	string	로그 속성을 찾을 수 없습니다.
LogsSizeExceedAllowedLimit	string	로그의 총 크기가 허용 한도를 초과합니다.
MissingAppId	string	헤더에 AppId가 없습니다.
ModelFileAccessDenied	string	고객 관리형 키에 사용되는 키 자격 증명 모음 키에 액세스할 수 없습니다.
ModelMetadataUpdateFailed	string	모델 메타데이터 업데이트에 실패했습니다.
ModelPublishFailed	string	모델 게시에 실패했습니다.
ModelRankingError	string	모델을 사용하여 작업의 순위를 지정하는 동안 오류가 발생했습니다. 학습 설정이 유효한지 확인하세요.
ModelResetFailed	string	모델 재설정에 실패했습니다.
NoLogsExistInDateRange	string	날짜 범위에 로그가 없습니다.
OperationNotAllowed	string	이 작업은 현재 허용되지 않습니다.
ProblemTypeIncompatibleWithAutoOptimization	string	자동 최적화는 다중 슬롯 개인 설정과 호환되지 않습니다.
RankNullResponse	string	순위 호출은 null 응답을 반환했습니다.
ResourceNotFound	string	요청된 리소스가 서버에 없습니다.
UpdateConfigurationFailed	string	구성을 업데이트하지 못했습니다.

ServiceConfiguration

서비스의 구성입니다.

Name	형식	Description
autoOptimizationFrequency	string	자동 최적화 빈도입니다. IsAutoOptimizationEnabled가 true인 경우에만 관련이 있습니다. 예를 들어 PT5M(5분)입니다. 시간 형식에 대한 자세한 내용은 \r\nhttp://en.wikipedia.org/wiki/ISO_8601#Durations
autoOptimizationStartDate	string	첫 번째 자동 최적화 평가를 수행해야 하는 날짜입니다. IsAutoOptimizationEnabled가 true인 경우에만 관련이 있습니다.
defaultReward	number	지정된 대기 시간 내에 보상을 받지 못한 경우 주어진 보상입니다.
explorationPercentage	number	탐색을 사용할 순위 응답의 백분율입니다.
isAutoOptimizationEnabled	boolean	Personalizer가 오프라인 평가를 주기적으로 실행하여 학습 설정을 자동으로 최적화할지 여부를 나타내는 플래그입니다.
lastConfigurationEditDate	string	모델 학습 구성이 마지막으로 업데이트된 시간
learningMode	LearningMode	Personalizer 학습 모드
logMirrorEnabled	boolean	플래그는 로그 미러링을 사용할 수 있는지 여부를 나타냅니다.
logMirrorSasUri	string	로그 미러링을 위한 Azure Storage 계정 컨테이너 SAS URI입니다.
logRetentionDays	integer	기록 로그를 유지 관리할 일 수입니다. -1은 로그가 삭제되지 않을 것임을 의미합니다.
modelExportFrequency	string	Personalizer는 지정된 기간마다 자동으로 온라인 순위에 대해 가장 업데이트된 학습된 모델을 사용하기 시작합니다. 예를 들어 PT5M(5분)입니다. 시간 형식에 대한 자세한 내용은 http://en.wikipedia.org/wiki/ISO_8601#Durations
rewardAggregation	string	rewardWaitTime이 완료되기 전에 여러 보상 점수를 받은 경우 보상을 처리하는 데 사용되는 함수입니다.
rewardWaitTime	string	요청이 기본 보상으로 표시될 때까지 대기한 시간 범위이며 5초에서 2일 사이여야 합니다. 예를 들어 PT5M(5분)입니다. 시간 형식에 대한 자세한 내용은 http://en.wikipedia.org/wiki/ISO_8601#Durations

다음을 통해 공유

Service Configuration - Update

URI 매개 변수

요청 본문

응답

예제

Successful ServiceConfiguration_Update request

샘플 요청

샘플 응답

정의

ErrorResponse

InternalError

LearningMode

PersonalizerError

PersonalizerErrorCode

ServiceConfiguration

추가 리소스