Service Configuration - Update

Referens

Tjänst:: Cognitive Services - Personalizer

API-version:: v1.1-preview.1

Uppdatera tjänstkonfigurationen.
Uppdatera konfigurationen för personanpassningstjänsten.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
Endpoint	path	True	string	Cognitive Services-slutpunkt som stöds.

Begärandetext

Name	Obligatorisk	Typ	Description
defaultReward	True	number	Den belöning som ges om en belöning inte erhålls inom den angivna väntetiden.
explorationPercentage	True	number	Procentandelen rankningssvar som ska använda utforskning.
logRetentionDays	True	integer	Antal dagar som historiska loggar ska underhållas. -1 innebär att loggarna aldrig tas bort.
modelExportFrequency	True	string	Personanpassning börjar använda den mest uppdaterade tränade modellen för online-rangordningar automatiskt varje angiven tidsperiod. Till exempel PT5M (5 minuter). Information om tidsformatet finns i http://en.wikipedia.org/wiki/ISO_8601#Durations
rewardAggregation	True	string	Funktionen som används för att bearbeta belöningar, om flera belöningspoäng tas emot innan rewardWaitTime är över.
rewardWaitTime	True	string	Tidsintervallet väntade tills en begäran har markerats med standardbelöningen och bör vara mellan 5 sekunder och 2 dagar. Till exempel PT5M (5 minuter). Information om tidsformatet finns i http://en.wikipedia.org/wiki/ISO_8601#Durations
autoOptimizationFrequency		string	Frekvens för automatisk optimering. Endast relevant om IsAutoOptimizationEnabled är sant. Till exempel PT5M (5 minuter). Information om tidsformatet finns i \r\nhttp://en.wikipedia.org/wiki/ISO_8601#Durations
autoOptimizationStartDate		string	Datum då den första automatiska optimeringsutvärderingen måste utföras. Endast relevant om IsAutoOptimizationEnabled är sant.
isAutoOptimizationEnabled		boolean	Flagga som anger om Personanpassning automatiskt optimerar inlärningsinställningar genom att köra offlineutvärderingar med jämna mellanrum.
lastConfigurationEditDate		string	Senaste gången modellträningskonfigurationen uppdaterades
learningMode		LearningMode	Inlärningslägen för personanpassning
logMirrorEnabled		boolean	Flaggan anger om loggspegling är aktiverat.
logMirrorSasUri		string	Azure Storage-kontocontainern SAS URI för loggspegling.

Svar

Name	Typ	Description
200 OK	ServiceConfiguration	Klart
Other Status Codes	ErrorResponse	Uppdatering av defaultReward, rewardWaitTime och rewardAggregation när du ändrar inlärningsläge från Online till Lärlingsläge och vice versa tillåts inte. Ändra läget och ändra sedan de ytterligare inställningarna med ytterligare ett API-anrop.

Exempel

Successful ServiceConfiguration_Update request

Exempelbegäran

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"
}

Exempelsvar

Statuskod:: 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"
}

Definitioner

Name	Description
ErrorResponse	Används för att returnera ett fel till klienten
InternalError	Ett objekt som innehåller mer specifik information än det överordnade objektet om felet.
LearningMode	Inlärningslägen för personanpassning
PersonalizerError	Felobjektet.
PersonalizerErrorCode	Felkoder som returneras av Personanpassning
ServiceConfiguration	Konfigurationen av tjänsten.

ErrorResponse

Används för att returnera ett fel till klienten

Name	Typ	Description
error	PersonalizerError	Felobjektet.

InternalError

Ett objekt som innehåller mer specifik information än det överordnade objektet om felet.

Name	Typ	Description
code	string	Detaljerad felkod.
innererror	InternalError	Ett objekt som innehåller mer specifik information än det överordnade objektet om felet.

LearningMode

Inlärningslägen för personanpassning

Name	Typ	Description
Apprentice	string
LoggingOnly	string
Online	string

PersonalizerError

Felobjektet.

Name	Typ	Description
code	PersonalizerErrorCode	Felkoder som returneras av Personanpassning
details	PersonalizerError[]	En matris med information om specifika fel som ledde till det rapporterade felet.
innerError	InternalError	Ett objekt som innehåller mer specifik information än det överordnade objektet om felet.
message	string	Ett meddelande som förklarar felet som rapporterats av tjänsten.
target	string	Felkällans element.

PersonalizerErrorCode

Felkoder som returneras av Personanpassning

Name	Typ	Description
ApprenticeModeNeverTurnedOn	string	Lärlingsläget har aldrig aktiverats.
BadRequest	string	Servern kunde inte förstå begäran.
DuplicateCustomPolicyNames	string	Anpassade principnamn ska vara unika.
EvaluationModelNotFound	string	Det gick inte att hitta modellen i utvärderingen.
EvaluationNotFound	string	Offlineutvärdering hittades inte.
FrontEndNotFound	string	Klientdelen hittades inte.
InternalServerError	string	Ett allmänt fel har uppstått på servern.
InvalidContainer	string	SAS Uri måste vara Uri för en container som har skrivbehörighet.
InvalidEvaluationContract	string	Ogiltigt utvärderingskontrakt.
InvalidEventIdToActivate	string	Ogiltig begäran om aktiveringshändelse.
InvalidExportLogsRequest	string	Ogiltig begäran.
InvalidLearningModeServiceConfiguration	string	Uppdatering av defaultReward, rewardWaitTime och rewardAggregation när du ändrar inlärningsläge från Online till Lärlingsläge och vice versa tillåts inte. Ändra läget och ändra sedan de ytterligare inställningarna med ytterligare ett API-anrop.
InvalidModelMetadata	string	Ogiltiga modellmetadata.
InvalidMultiSlotApiAccess	string	Funktionen för flera fack är för närvarande inaktiverad. Följ dokumentationen om personanpassning med flera fack för att uppdatera loopinställningarna för att aktivera funktioner för flera fack.
InvalidPolicyConfiguration	string	Ogiltig principkonfiguration.
InvalidPolicyContract	string	Ogiltigt principkontrakt.
InvalidRankRequest	string	Ogiltig begäran.
InvalidRewardRequest	string	Ogiltig belöningsbegäran.
InvalidRewardWaitTime	string	Väntetiden för belöningen bör vara mellan 5 sekunder och 2 dagar
InvalidServiceConfiguration	string	Ogiltig tjänstkonfiguration.
LearningSettingsNotFound	string	Inlärningsinställningar hittades inte i utvärderingen.
LogsPropertiesNotFound	string	Loggegenskaper hittades inte.
LogsSizeExceedAllowedLimit	string	Den totala storleken på loggarna överskrider den tillåtna gränsen.
MissingAppId	string	AppId saknas i rubriken.
ModelFileAccessDenied	string	Nyckelvalvsnyckel som används för kundhanterad nyckel kan inte nås.
ModelMetadataUpdateFailed	string	Uppdatering av modellmetadata misslyckades.
ModelPublishFailed	string	Det gick inte att publicera modellen.
ModelRankingError	string	Fel vid rangordning av åtgärder med hjälp av modellen. Kontrollera att utbildningsinställningarna är giltiga.
ModelResetFailed	string	Modellåterställningen misslyckades.
NoLogsExistInDateRange	string	Det finns inga loggar i datumintervallet.
OperationNotAllowed	string	Den här åtgärden är inte tillåten för tillfället.
ProblemTypeIncompatibleWithAutoOptimization	string	Automatisk optimering är inte kompatibelt med anpassning med flera fack.
RankNullResponse	string	Rangordningsanropet returnerade null-svar.
ResourceNotFound	string	Den begärda resursen finns inte på servern.
UpdateConfigurationFailed	string	Det gick inte att uppdatera konfigurationen.

ServiceConfiguration

Konfigurationen av tjänsten.

Name	Typ	Description
autoOptimizationFrequency	string	Frekvens för automatisk optimering. Endast relevant om IsAutoOptimizationEnabled är sant. Till exempel PT5M (5 minuter). Information om tidsformatet finns i \r\nhttp://en.wikipedia.org/wiki/ISO_8601#Durations
autoOptimizationStartDate	string	Datum då den första automatiska optimeringsutvärderingen måste utföras. Endast relevant om IsAutoOptimizationEnabled är sant.
defaultReward	number	Den belöning som ges om en belöning inte erhålls inom den angivna väntetiden.
explorationPercentage	number	Procentandelen rankningssvar som ska använda utforskning.
isAutoOptimizationEnabled	boolean	Flagga som anger om Personanpassning automatiskt optimerar inlärningsinställningar genom att köra offlineutvärderingar med jämna mellanrum.
lastConfigurationEditDate	string	Senaste gången modellträningskonfigurationen uppdaterades
learningMode	LearningMode	Inlärningslägen för personanpassning
logMirrorEnabled	boolean	Flaggan anger om loggspegling är aktiverat.
logMirrorSasUri	string	Azure Storage-kontocontainern SAS URI för loggspegling.
logRetentionDays	integer	Antal dagar som historiska loggar ska underhållas. -1 innebär att loggarna aldrig tas bort.
modelExportFrequency	string	Personanpassning börjar använda den mest uppdaterade tränade modellen för online-rangordningar automatiskt varje angiven tidsperiod. Till exempel PT5M (5 minuter). Information om tidsformatet finns i http://en.wikipedia.org/wiki/ISO_8601#Durations
rewardAggregation	string	Funktionen som används för att bearbeta belöningar, om flera belöningspoäng tas emot innan rewardWaitTime är över.
rewardWaitTime	string	Tidsintervallet väntade tills en begäran har markerats med standardbelöningen och bör vara mellan 5 sekunder och 2 dagar. Till exempel PT5M (5 minuter). Information om tidsformatet finns i http://en.wikipedia.org/wiki/ISO_8601#Durations

Dela via