Get Operating System

Get Operating System
Get operating system

Returns an operating system

Request
URI
GET
https://api.app-catalog.vmware.com/v1/operating-systems/{operating_system_id}
COPY
Path Parameters
operating_system_id
Required

A string as the identifier of an operating system


Authentication
This operation uses the following authentication methods.
Responses
200

The operating system

Returns OperatingSystemDetailed of type(s) application/json
This response body class contains all of the following: InlineOperatingSystemDetailed0 , InlineOperatingSystemDetailed1
{
    "id": "d16c7f4d-b38a-405b-a1ca-3ac0a79418c1",
    "name": "Centos 7",
    "distro": "centos",
    "version": "7",
    "distroless": false,
    "fips_compliant": false,
    "stig_compliant": false,
    "status": "ACTIVE",
    "replaced_by": "d16c7f4d-b38a-405b-a1ca-3ac0a79418c1",
    "created_at": "2023-03-03T00:59:52.762Z",
    "updated_at": "2023-03-03T00:59:52.762Z",
    "deprecated_at": "2023-03-03T00:59:52.762Z",
    "replaced_at": "2023-03-03T00:59:52.762Z"
}

400

An error related to the request

Returns ConstraintsViolationsError of type(s) application/problem+json
This response body class contains all of the following: InlineConstraintsViolationsError0
{
    "type": "https://example.com/probs/validation-error",
    "title": "Validation error",
    "status": 400,
    "detail": "There was an error validating the request",
    "violations": [
        {
            "field": "amount",
            "message": "It should be greater than zero"
        }
    ]
}
array of object
violations
Required

It represents a constraints violation error


403

The requesting user is not authorized to get the operating system

Returns Error403 of type(s) application/problem+json
This response body class contains all of the following: InlineError4030
{
    "type": "https://example.com/probs/out-of-credit",
    "title": "You do not have enough credit.",
    "status": 403,
    "detail": "Your current balance is 30, but that costs 50",
    "instance": "/account/2217eb9c-f042-11eb-9a03-0242ac130003/msgs/abc"
}

404

The operating system is not found

Returns Error404 of type(s) application/problem+json
This response body class contains all of the following: InlineError4040
{
    "type": "https://example.com/probs/out-of-credit",
    "title": "You do not have enough credit.",
    "status": 403,
    "detail": "Your current balance is 30, but that costs 50",
    "instance": "/account/2217eb9c-f042-11eb-9a03-0242ac130003/msgs/abc"
}

500

An internal server error object

Returns Error500 of type(s) application/problem+json
This response body class contains all of the following: InlineError5000
{
    "type": "https://example.com/probs/out-of-credit",
    "title": "You do not have enough credit.",
    "status": 403,
    "detail": "Your current balance is 30, but that costs 50",
    "instance": "/account/2217eb9c-f042-11eb-9a03-0242ac130003/msgs/abc"
}

503

The server is temporarily unavailable

Returns Error503 of type(s) application/problem+json
This response body class contains all of the following: InlineError5030
{
    "type": "https://example.com/probs/out-of-credit",
    "title": "You do not have enough credit.",
    "status": 403,
    "detail": "Your current balance is 30, but that costs 50",
    "instance": "/account/2217eb9c-f042-11eb-9a03-0242ac130003/msgs/abc"
}

Code Samples
COPY
                    curl -H 'Authorization: <value>' https://{api_host}/v1/operating-systems/{operating_system_id}