---
title: "Creates a Service Fabric application."
method: POST
path: "/Applications/$/Create"
tags: ["Application"]
---

# Creates a Service Fabric application.

`POST /Applications/$/Create`

Creates a Service Fabric application using the specified description.

## Query parameters

- `api-version` '6.0', required
- `timeout` integer

## Request body

- ApplicationDescription — Describes a Service Fabric application.
  - `Name` string, required — The name of the application, including the 'fabric:' URI scheme.
  - `TypeName` string, required — The application type name as defined in the application manifest.
  - `TypeVersion` string, required — The version of the application type as defined in the application manifest.
  - `ParameterList` ApplicationParameter[] — List of application parameters with overridden values from their default values specified in the application manifest.
    - `Key` string, required — The name of the parameter.
    - `Value` string, required — The value of the parameter.
  - `ApplicationCapacity` ApplicationCapacityDescription — Describes capacity information for services of this application. This description can be used for describing the following. - Reserving the capacity for the services on the nodes - Limiting the total number of nodes that services of this application can run on - Limiting the custom capacity metrics to limit the total consumption of this metric by the services of this application
    - `MinimumNodes` integer — The minimum number of nodes where Service Fabric will reserve capacity for this application. Note that this does not mean that the services of this application will be placed on all of those nodes. If this property is set to zero, no capacity will be reserved. The value of this property cannot be more than the value of the MaximumNodes property.
    - `MaximumNodes` integer — The maximum number of nodes where Service Fabric will reserve capacity for this application. Note that this does not mean that the services of this application will be placed on all of those nodes. By default, the value of this property is zero and it means that the services can be placed on any node.
    - `ApplicationMetrics` ApplicationMetricDescription[] — List of application capacity metric description.
      - `Name` string — The name of the metric.
      - `MaximumCapacity` integer — The maximum node capacity for Service Fabric application. This is the maximum Load for an instance of this application on a single node. Even if the capacity of node is greater than this value, Service Fabric will limit the total load of services within the application on each node to this value. If set to zero, capacity for this metric is unlimited on each node. When creating a new application with application capacity defined, the product of MaximumNodes and this value must always be smaller than or equal to TotalApplicationCapacity. When updating existing application with application capacity, the product of MaximumNodes and this value must always be smaller than or equal to TotalApplicationCapacity.
      - `ReservationCapacity` integer — The node reservation capacity for Service Fabric application. This is the amount of load which is reserved on nodes which have instances of this application. If MinimumNodes is specified, then the product of these values will be the capacity reserved in the cluster for the application. If set to zero, no capacity is reserved for this metric. When setting application capacity or when updating application capacity; this value must be smaller than or equal to MaximumCapacity for each metric.
      - `TotalApplicationCapacity` integer — The total metric capacity for Service Fabric application. This is the total metric capacity for this application in the cluster. Service Fabric will try to limit the sum of loads of services within the application to this value. When creating a new application with application capacity defined, the product of MaximumNodes and MaximumCapacity must always be smaller than or equal to this value.
  - `ManagedApplicationIdentity` ManagedApplicationIdentityDescription — Managed application identity description.
    - `TokenServiceEndpoint` string — Token service endpoint.
    - `ManagedIdentities` ManagedApplicationIdentity[] — A list of managed application identity objects.
      - `Name` string, required — The name of the identity.
      - `PrincipalId` string — The identity's PrincipalId.

## Response `201`

A successful response means that the application creation has been started. Use GetApplication operation to get the status of the application. Once GetApplicationInfo successfully returns application information, the application is created. If the application has default services those may be in the process of being created. Use GetServiceInfo operation to get the status of the service within the application.

## Other responses

- `default` — The detailed error response.

---

[API](https://skmtc.net/azure/apis/service-fabric-client-apis.md) · [All operations](https://skmtc.net/azure/apis/service-fabric-client-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/service-fabric-client-apis/revisions/6df9f2f4d542/schema)