---
title: "POST /core-networks"
method: POST
path: "/core-networks"
---

# POST /core-networks

`POST /core-networks`

Creates a core network as part of your global network, and optionally, with a core network policy.

## Request body

- object
  - `GlobalNetworkId` string, required — The ID of the global network that a core network will be a part of.
  - `Description` string — The description of a core network.
  - `Tags` Tag[] — Key-value tags associated with a core network request.
    - `Key` string — <p>The tag key.</p> <p>Constraints: Maximum length of 128 characters.</p>
    - `Value` string — <p>The tag value.</p> <p>Constraints: Maximum length of 256 characters.</p>
  - `PolicyDocument` string — The policy document for creating a core network.
  - `ClientToken` string — The client token associated with a core network request.

## Response `200`

Success

- CreateCoreNetworkResponse
  - `CoreNetwork` object — Returns details about a core network.
    - `GlobalNetworkId` string — The ID of the global network that your core network is a part of.
    - `CoreNetworkId` string — The ID of a core network.
    - `CoreNetworkArn` string — The ARN of a core network.
    - `Description` string — The description of a core network.
    - `CreatedAt` string, date-time — The timestamp when a core network was created.
    - `State` 'CREATING' | 'UPDATING' | 'AVAILABLE' | 'DELETING' — The current state of a core network.
    - `Segments` CoreNetworkSegment[] — The segments within a core network.
      - `Name` string — The name of a core network segment.
      - `EdgeLocations` ExternalRegionCode[] — The Regions where the edges are located.
      - `SharedSegments` ConstrainedString[] — The shared segments of a core network.
    - `Edges` CoreNetworkEdge[] — The edges within a core network.
      - `EdgeLocation` string — The Region where a core network edge is located.
      - `Asn` integer — The ASN of a core network edge.
      - `InsideCidrBlocks` ConstrainedString[] — The inside IP addresses used for core network edges.
    - `Tags` Tag[] — The list of key-value tags associated with a core network.
      - `Key` string — <p>The tag key.</p> <p>Constraints: Maximum length of 128 characters.</p>
      - `Value` string — <p>The tag value.</p> <p>Constraints: Maximum length of 256 characters.</p>

## Other responses

- `480` — CoreNetworkPolicyException
- `481` — ValidationException
- `482` — ServiceQuotaExceededException
- `483` — AccessDeniedException
- `484` — ConflictException
- `485` — ThrottlingException
- `486` — InternalServerException

---

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