SpectrumX Partition

Create SpectrumX Partition

Changed on

Create a SpectrumX Partition for the org.

Org must have a Tenant entity. User must have authorization role with TENANT_ADMIN suffix.

The Tenant must have an Allocation or TargetedInstanceCreation on the Site. Omit vni to let the Site allocate one; a requested vni that is already allocated or outside the Site's pool is rejected.

post/v2/org/{org}/nico/spectrumx-partition

Request

  • Base URL
    https://nico-rest-api.nico.svc.cluster.local
  • URL
    https://nico-rest-api.nico.svc.cluster.local/v2/org/{org}/nico/spectrumx-partition
  • Auth
    HTTP bearer

Request body

namestring required

Name of the Partition to create

descriptionstring nullable

Optional description of the Partition

siteIdstring uuid required

ID of the Site the Partition should belong to

vniinteger nullable

Requested VXLAN Network Identifier. Omit it to let the Site allocate one from its pool. A requested value that is already allocated or outside that pool is rejected by the Site

labelsLabels

Label keys must not be empty or whitespace-only. Keys and values may contain at most 255 characters and must not contain the Unicode NUL character (U+0000). Empty values are allowed.

Example request

{
  "name": "east-west-net",
  "siteId": "8c43e859-d301-4ecf-9d0e-46bf374473c4"
}

Response

Created

idstring uuid required

Unique UUID v4 identifier for the SpectrumX Partition

namestring required

Name of the SpectrumX Partition

descriptionstring nullable

Description of the SpectrumX Partition

siteIdstring uuid required

ID of the Site the Partition belongs to

tenantIdstring uuid required

ID of the Tenant that owns the Partition

vniinteger nullable

VXLAN Network Identifier for the Partition. Allocated by the Site when the create request omits it

labelsLabels

Label keys must not be empty or whitespace-only. Keys and values may contain at most 255 characters and must not contain the Unicode NUL character (U+0000). Empty values are allowed.

status'Pending' | 'Provisioning' | 'Ready' | 'Error' | 'Deleting' required

Status of the SpectrumX Partition. A Partition becomes Ready once the Site reports it in inventory

createdstring date-time

ISO datetime string for when the SpectrumX Partition was created

updatedstring date-time

ISO datetime string for when the SpectrumX Partition was last updated

Example response

{
  "id": "8e6f2a1c-9b3d-4e5f-a6b7-c8d9e0f1a2b3",
  "name": "east-west-net",
  "description": "SpectrumX Partition for east-west training traffic",
  "siteId": "60189e9c-7d12-438c-b9ca-6998d9c364b1",
  "tenantId": "f97df110-f4de-492e-8849-4a6af68026b0",
  "vni": 10200,
  "labels": {
    "environment": "production",
    "team": "devops"
  },
  "status": "Ready",
  "statusHistory": [
    {
      "status": "Ready",
      "message": "SpectrumX Partition is ready for use",
      "created": "2019-08-24T14:15:22Z",
      "updated": "2019-08-24T14:15:22Z"
    }
  ],
  "created": "2019-08-24T14:15:22Z",
  "updated": "2019-08-24T14:15:22Z"
}

Changes

  • 04bf8e76558fRevision changes
    • info

      the response optional property // became read-only for the status

  • 293dc126ab73Revision changes
    • info

      removed the nico enum value from the response property for the response status

    • info

      removed the nico enum value from the response property for the response status

    • info

      removed the nico enum value from the response property for the response status