---
title: "POST /sol/nslcm/v1/ns_instances"
method: POST
path: "/sol/nslcm/v1/ns_instances"
---

# POST /sol/nslcm/v1/ns_instances

`POST /sol/nslcm/v1/ns_instances`

Creates a network instance.

A network instance is a single network created in Amazon Web Services TNB that can be deployed and on which life-cycle operations (like terminate, update, and delete) can be performed. Creating a network instance is the third step after creating a network package. For more information about network instances, [Network instances](https://docs.aws.amazon.com/tnb/latest/ug/network-instances.html) in the _Amazon Web Services Telco Network Builder User Guide_.

Once you create a network instance, you can instantiate it. To instantiate a network, see [InstantiateSolNetworkInstance](https://docs.aws.amazon.com/tnb/latest/APIReference/API_InstantiateSolNetworkInstance.html).

## Request body

- object
  - `nsDescription` string — Network instance description.
  - `nsName` string, required — Network instance name.
  - `nsdInfoId` string, required — ID for network service descriptor.
  - `tags` object — A tag is a label that you assign to an Amazon Web Services resource. Each tag consists of a key and an optional value. You can use tags to search and filter your resources or track your Amazon Web Services costs.

## Response `201`

Success

- CreateSolNetworkInstanceOutput
  - `arn` string, required — Network instance ARN.
  - `id` string, required — Network instance ID.
  - `nsInstanceName` string, required — Network instance name.
  - `nsdInfoId` string, required — Network service descriptor ID.
  - `tags` object — A tag is a label that you assign to an Amazon Web Services resource. Each tag consists of a key and an optional value. You can use tags to search and filter your resources or track your Amazon Web Services costs.

## Other responses

- `480` — InternalServerException
- `481` — ServiceQuotaExceededException
- `482` — ThrottlingException
- `483` — ValidationException
- `484` — ResourceNotFoundException
- `485` — AccessDeniedException

---

[API](https://skmtc.net/aws/apis/tnb.md) · [All operations](https://skmtc.net/aws/apis/tnb/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/tnb/versions/0ae8563a8404/schema)