Uppdatera metadata för programarmen
Uppdateringar armmetadata för ett visst program.
Uppdateringar armmetadata för ett visst program. Kan anropas omedelbart efter att API:et för att skapa appen anropas.
Förfrågan
Metod | URI för förfrågan |
---|---|
POST | /Applications/{applicationId}/$/UpdateArmMetadata?api-version=9.0&timeout={timeout}&Force={Force} |
Parametrar
Namn | Typ | Obligatorisk | Location |
---|---|---|---|
applicationId |
sträng | Ja | Sökväg |
api-version |
sträng | Ja | Söka i data |
timeout |
heltal (int64) | No | Söka i data |
Force |
boolean | No | Söka i data |
ApplicationArmMetadataUpdateDescription |
ArmMetadata | Yes | Brödtext |
applicationId
Typ: sträng
Krävs: Ja
Programmets identitet. Detta är vanligtvis det fullständiga namnet på programmet utan URI-schemat "fabric:".
Från och med version 6.0 avgränsas hierarkiska namn med tecknet "~".
Om programnamnet till exempel är "fabric:/myapp/app1" skulle programidentiteten vara "myapp~app1" i 6.0+ och "myapp/app1" i tidigare versioner.
api-version
Typ: sträng
Krävs: Ja
Standard: 9.0
Versionen av API:et. Den här parametern krävs och dess värde måste vara "9.0".
Service Fabric REST API-versionen baseras på körningsversionen där API:et introducerades eller ändrades. Service Fabric Runtime stöder mer än en version av API:et. Den här versionen är den senaste versionen av API:et som stöds. Om en lägre API-version skickas kan det returnerade svaret skilja sig från det som dokumenteras i den här specifikationen.
Dessutom accepterar körningen alla versioner som är högre än den senaste versionen som stöds upp till den aktuella versionen av körningen. Så om den senaste API-versionen är 6.0 och körningen är 6.1 accepterar körningen version 6.1 för det API:et. Beteendet för API:et är dock enligt den dokumenterade 6.0-versionen.
timeout
Typ: heltal (int64)
Krävs: Nej
Standard: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1
Serverns tidsgräns för att utföra åtgärden i sekunder. Den här tidsgränsen anger hur lång tid klienten är villig att vänta på att den begärda åtgärden ska slutföras. Standardvärdet för den här parametern är 60 sekunder.
Force
Typ: booleskt värde
Krävs: Nej
Framtvinga parameter som används för att förhindra oavsiktlig uppdatering av Arm-metadata.
ApplicationArmMetadataUpdateDescription
Typ: ArmMetadata
Krävs: Ja
Arm-metadata som ska associeras med ett specifikt program
Svar
HTTP-statuskod | Description | Svarsschema |
---|---|---|
200 (OK) | En lyckad uppdatering returnerar 200 statuskod. |
|
Alla andra statuskoder | Det detaljerade felsvaret. |
FabricError |