Insert Service¶

Creates a new Service(s).

Request¶

HTTP Request:

POST https://example.com/services

Request Body¶

Service representation or list of Services representations.

Response¶

Response Status Codes¶

201 Created The Service(s) was inserted successfully.
400 Bad Request The data given in the request failed validation.
401 Unauthorized The supplied credentials are not enough to create new Service(s).
409 Conflict The Service(s) already inserted before.
500 Internal Server Error Service(s) couldn’t be inserted, try again.

Response Body¶

If one Service submitted: The new Service representation and Location HTTP header of that Service.

If list of Services submitted: List of Services created

Examples¶

The examples include only important HTTP header fields for clarity.

Insert single Service¶

Request:

POST /services HTTP/1.1
Host: example.com
Accept: application/perfsonar+json
Content-Type: application/perfsonar+json ;profile=http://unis.crest.iu.edu/schema/20120709/service#
Content-Length: 248

{
    "$schema": "http://unis.crest.iu.edu/schema/20120709/service#",
    "accessPoint": "http://example.com:111/ms1/",
    "name": "service1",
    "status": "ON",
    "serviceType": "http://some_schema_domain/measurement_store",
    "ttl": 1000,
    "description": "sample MS service",
    "runningOn": {
        "href": "http://unis/nodes/1",
        "rel": "full"
    },
    "properties": {
        "configurations": {
            "default_collection_size": 10000,
            "max_collection_size": 20000
        },
        "summary": {
            "metadata": [
                "http://unis/metadata/1",
                "http://unis/metadata/2"
            ]
        }
    }
}

Response

Note that the id, ts and selfRef were created by the server.:

HTTP/1.1 201 Created
Content-Type: application/perfsonar+json ;profile=http://unis.crest.iu.edu/schema/20120709/service#
Location: https://example.com/services/4fb4050bf4735379a7000000

{
    "$schema": "http://unis.crest.iu.edu/schema/20120709/service#",
    "status": "ON",
    "id": "4fb4050bf4735379a7000000",
    "selfRef": "https://example.com/services/4fb4050bf4735379a7000000",
    "accessPoint": "http://example.com:111/ms1/",
    "serviceType": "http://some_schema_domain/measurement_store",
    "name": "service1",
    "ttl": 1000,
    "ts": 1337197835687922,
    "description": "sample MS service",
    "runningOn": {
        "href": "http://unis/nodes/1",
        "rel": "full"
    },
    "properties": {
        "configurations": {
            "default_collection_size": 10000,
            "max_collection_size": 20000
        },
        "summary": {
            "metadata": [
                "http://unis/metadata/1",
                "http://unis/metadata/2"
            ]
        }
    }
}