Flex Metal Tags

FlexMetal tags can be assigned to FlexMetal servers to administratively group them together and use them for filtering.

Get all your FlexMetal tags

get

Authorizations

PRIVATE-TOKENstringRequired

Header parameters

RANGED-DATAstringOptional

Example header and default range: RANGED-DATA:start=0,results=25

Responses

200

List of tags

application/json

A Flex Metal tag

tagstringRequired

The tag name

Example: my-tag

403

Invalid credentials

500

Internal Server Error

application/json

get/v3/flexMetal/tags

GET /v3/flexMetal/tags HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*

[
  {
    "tag": "my-tag",
    "resources": {
      "count": 1,
      "flexMetalServers": {
        "count": 1
      }
    }
  }
]

Create a FlexMetal tag

post

Authorizations

PRIVATE-TOKENstringRequired

Body

A Flex Metal tag

tagstringRequired

The tag name

Example: my-tag

Responses

200

The new tag

application/json

A Flex Metal tag

tagstringRequired

The tag name

Example: my-tag

403

Invalid credentials

422

Unprocessable content

500

Internal Server Error

application/json

post/v3/flexMetal/tags

POST /v3/flexMetal/tags HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 16

{
  "tag": "my-tag"
}

[
  {
    "tag": "my-tag",
    "resources": {
      "count": 1,
      "flexMetalServers": {
        "count": 1
      }
    }
  }
]

Get a tag by name

get

Authorizations

PRIVATE-TOKENstringRequired

Responses

200

List of tags

application/json

A Flex Metal tag

tagstringRequired

The tag name

Example: my-tag

403

Invalid credentials

404

Resource not found

500

Internal Server Error

application/json

get/v3/flexMetal/tags/{tag}

GET /v3/flexMetal/tags/{tag} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*

[
  {
    "tag": "my-tag",
    "resources": {
      "count": 1,
      "flexMetalServers": {
        "count": 1
      }
    }
  }
]

Rename a FlexMetal tag

put

Authorizations

PRIVATE-TOKENstringRequired

Body

A Flex Metal tag

tagstringRequired

The tag name

Example: my-tag

Responses

200

The updated tag model

application/json

A Flex Metal tag

tagstringRequired

The tag name

Example: my-tag

403

Invalid credentials

404

Resource not found

409

New tag name already exists

422

Unprocessable content

500

Internal Server Error

application/json

put/v3/flexMetal/tags/{tag}

PUT /v3/flexMetal/tags/{tag} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 16

{
  "tag": "my-tag"
}

[
  {
    "tag": "my-tag",
    "resources": {
      "count": 1,
      "flexMetalServers": {
        "count": 1
      }
    }
  }
]

Delete a FlexMetal tag

delete

Authorizations

PRIVATE-TOKENstringRequired

Responses

204

No Content

No content

403

Invalid credentials

404

Resource not found

500

Internal Server Error

application/json

delete/v3/flexMetal/tags/{tag}

DELETE /v3/flexMetal/tags/{tag} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*

No content