Dela via

Skapa program

  • Artikel

Skapar ett Service Fabric-program.

Skapar ett Service Fabric-program med den angivna beskrivningen.

Förfrågan

Metod URI för förfrågan
POST /Applications/$/Create?api-version=6.0&timeout={timeout}

Parametrar

Namn Typ Obligatorisk Location
api-version sträng Ja Söka i data
timeout heltal (int64) No Söka i data
ApplicationDescription ApplicationDescription Yes Brödtext

api-version

Typ: sträng
Obligatoriskt: Ja
Standard: 6.0

Versionen av API:et. Den här parametern krävs och dess värde måste vara "6.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. Det här ä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 beskrivs i den här specifikationen.

Dessutom accepterar körningen alla versioner som är högre än den senaste versionen som stöds fram till den aktuella versionen av körningen. Så om den senaste API-versionen är 6.0, men om körningen är 6.1, för att göra det enklare att skriva klienterna, accepterar körningen version 6.1 för det API:et. Beteendet för API:et kommer dock att vara enligt den dokumenterade 6.0-versionen.

timeout

Typ: heltal (int64)
Obligatoriskt: Nej
Standard: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1

Serverns timeout 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.

ApplicationDescription

Typ: ApplicationDescription
Obligatoriskt: Ja

Beskrivning för att skapa ett program.

Svar

HTTP-statuskod Description Svarsschema
201 (skapad) Ett lyckat svar innebär att programmet har skapats. Använd GetApplication-åtgärden för att hämta programmets status. När GetApplicationInfo returnerar programinformation skapas programmet. Om programmet har standardtjänster kan de vara i färd med att skapas. Använd GetServiceInfo-åtgärden för att hämta status för tjänsten i programmet.
Alla andra statuskoder Det detaljerade felsvaret.
 FabricError

Exempel

Skapa program.

Det här exemplet visar hur du skapar ett Service Fabric-program utan att åsidosätta några programparametervärden.

Förfrågan

POST http://localhost:19080/Applications/$/Create?api-version=6.0
Brödtext
{
  "Name": "fabric:/samples/CalcApp",
  "TypeVersion": "1.0",
  "TypeName": "CalculatorApp"
}

201-svar

Brödtext

Svarstexten är tom.