diff --git a/v1/api/swagger/components/schemas/OSServiceImage.yaml b/v1/api/swagger/components/schemas/OSServiceImage.yaml index ba9de67..a54c01a 100644 --- a/v1/api/swagger/components/schemas/OSServiceImage.yaml +++ b/v1/api/swagger/components/schemas/OSServiceImage.yaml @@ -20,6 +20,7 @@ allOf: - UserDefinedSteps - Classifiers - ProjectID + - DownloadHealth properties: ProjectID: type: string @@ -27,6 +28,8 @@ allOf: description: >- Unique ID of the project that owns this OS service image. example: 046b6c7f-0b8a-43b9-b35d-6489e6daee92 + DownloadHealth: + $ref: OSServiceImageDownloadHealth.yaml Description: type: string example: Description of the image diff --git a/v1/api/swagger/components/schemas/OSServiceImageDetailedDownloadHealth.yaml b/v1/api/swagger/components/schemas/OSServiceImageDetailedDownloadHealth.yaml new file mode 100644 index 0000000..f5d73be --- /dev/null +++ b/v1/api/swagger/components/schemas/OSServiceImageDetailedDownloadHealth.yaml @@ -0,0 +1,3 @@ +type: object +additionalProperties: + $ref: OSServiceImageDownloadHealthDetails.yaml \ No newline at end of file diff --git a/v1/api/swagger/components/schemas/OSServiceImageDownloadHealth.yaml b/v1/api/swagger/components/schemas/OSServiceImageDownloadHealth.yaml new file mode 100644 index 0000000..8d35438 --- /dev/null +++ b/v1/api/swagger/components/schemas/OSServiceImageDownloadHealth.yaml @@ -0,0 +1,11 @@ +type: object +required: + - DetailedDownloadHealth + - DownloadHealthSummary +properties: + DetailedDownloadHealth: + $ref: OSServiceImageDetailedDownloadHealth.yaml + DownloadHealthSummary: + $ref: OSServiceImageDownloadHealthSummary.yaml +description: >- + Provides download health info of the OS service image. \ No newline at end of file diff --git a/v1/api/swagger/components/schemas/OSServiceImageDownloadHealthDetails.yaml b/v1/api/swagger/components/schemas/OSServiceImageDownloadHealthDetails.yaml new file mode 100644 index 0000000..f869cd1 --- /dev/null +++ b/v1/api/swagger/components/schemas/OSServiceImageDownloadHealthDetails.yaml @@ -0,0 +1,24 @@ +type: object +required: + - Changed + - Details + - Reason + - Summary +properties: + Changed: + type: string + format: date-time + example: 2019-06-27T22:59:01.661Z + description: >- + Indicates last time this download health has been updated. + Details: + type: object + additionalProperties: + $ref: OSServiceImageDownloadHealthSummary.yaml + Reason: + type: string + example: "Service download health timed out" + description: >- + Indicates the reason for the reported download health status if not OK. + Summary: + $ref: OSServiceImageDownloadHealthSummary.yaml \ No newline at end of file diff --git a/v1/api/swagger/components/schemas/OSServiceImageDownloadHealthSummary.yaml b/v1/api/swagger/components/schemas/OSServiceImageDownloadHealthSummary.yaml new file mode 100644 index 0000000..dc1581d --- /dev/null +++ b/v1/api/swagger/components/schemas/OSServiceImageDownloadHealthSummary.yaml @@ -0,0 +1,9 @@ +type: string +enum: + - OK + - Warning + - Critical + - Unknown +example: OK +description: > + Indicates the download health summary of the OS service image. \ No newline at end of file diff --git a/v1/html/index.html b/v1/html/index.html index 3f331b4..ecbee12 100644 --- a/v1/html/index.html +++ b/v1/html/index.html @@ -3000,7 +3000,7 @@

Option 2: Getting the token directly from UI

Response samples

Content type
application/json
[
  • {
    }
]

Create a new OS service image

Adds a new OS service image that can be referenced during host creation. If GreenLake Cloud Services IAM issued token is used for authentication, then it is required to pass either 'spaceid' header or 'Space' header. If GreenLake Platform IAM issued token is used for authentication, then it is required to pass 'X-Role' and 'X-Workspaceid' headers. Note that Hoster or BMaaS Access Owner role is required for this operation.

+
https://client.greenlake.hpe.com{basePath}/services

Response samples

Content type
application/json
[
  • {
    }
]

Create a new OS service image

Adds a new OS service image that can be referenced during host creation. If GreenLake Cloud Services IAM issued token is used for authentication, then it is required to pass either 'spaceid' header or 'Space' header. If GreenLake Platform IAM issued token is used for authentication, then it is required to pass 'X-Role' and 'X-Workspaceid' headers. Note that Hoster or BMaaS Access Owner role is required for this operation.

Authorizations:
(BearerAuthProject) (BearerAuthMembership)
header Parameters
spaceid
string
Example: 95688cf9-82ff-4e32-80fc-2b0b41648dab

GreenLake Cloud Services space ID

Space
string
Example: Default

GreenLake Cloud Services space name

X-Role
string
Example: metal-infra-admin

GreenLake Platform role name

@@ -3012,7 +3012,7 @@

Option 2: Getting the token directly from UI

Response samples

Content type
application/json
{
  • "ID": "3892eb50-4697-4c72-aadc-32b766bce3c0",
  • "ETag": "a8a0a8d9-d35b-45c6-840f-2b3694efc394",
  • "Name": "My Object Name",
  • "Created": "2019-06-27T22:59:01.661Z",
  • "Modified": "2020-02-27T18:28:02.863Z",
  • "ProjectID": "046b6c7f-0b8a-43b9-b35d-6489e6daee92",
  • "Description": "Description of the image",
  • "Category": "linux",
  • "Flavor": "ubuntu",
  • "Version": "20.04.5",
  • "Origin": "Custom",
  • "Timeout": 1000,
  • "DeviceLayouts": [
    ],
  • "PermittedProjects": [
    ],
  • "Files": [
    ],
  • "Info": [
    ],
  • "Approach": "vmedia",
  • "AssumedBootMethod": "na",
  • "NoSwitchLAG": false,
  • "BondMode": "none",
  • "FWBaselineID": "046b6c7f-0b8a-43b9-b35d-6489e6daee92",
  • "UserDefinedSteps": {
    },
  • "Classifiers": [
    ]
}

Retrieve an OS service image

Returns a single OS service image object with its matching ID. If GreenLake Platform IAM issued token is used for authentication, then it is required to pass 'X-Role' and 'X-Workspaceid' headers.

+
https://client.greenlake.hpe.com{basePath}/services

Response samples

Content type
application/json
{
  • "ID": "3892eb50-4697-4c72-aadc-32b766bce3c0",
  • "ETag": "a8a0a8d9-d35b-45c6-840f-2b3694efc394",
  • "Name": "My Object Name",
  • "Created": "2019-06-27T22:59:01.661Z",
  • "Modified": "2020-02-27T18:28:02.863Z",
  • "ProjectID": "046b6c7f-0b8a-43b9-b35d-6489e6daee92",
  • "DownloadHealth": {
    },
  • "Description": "Description of the image",
  • "Category": "linux",
  • "Flavor": "ubuntu",
  • "Version": "20.04.5",
  • "Origin": "Custom",
  • "Timeout": 1000,
  • "DeviceLayouts": [
    ],
  • "PermittedProjects": [
    ],
  • "Files": [
    ],
  • "Info": [
    ],
  • "Approach": "vmedia",
  • "AssumedBootMethod": "na",
  • "NoSwitchLAG": false,
  • "BondMode": "none",
  • "FWBaselineID": "046b6c7f-0b8a-43b9-b35d-6489e6daee92",
  • "UserDefinedSteps": {
    },
  • "Classifiers": [
    ]
}

Retrieve an OS service image

Returns a single OS service image object with its matching ID. If GreenLake Platform IAM issued token is used for authentication, then it is required to pass 'X-Role' and 'X-Workspaceid' headers.

Authorizations:
(BearerAuthProject) (BearerAuthMembership)
path Parameters
serviceId
required
string

ID of OS service image to return

header Parameters
X-Role
string
Example: metal-infra-admin

GreenLake Platform role name

X-Workspaceid
string
Example: 1a2ba81600dd11efa47076a3447ec4eb

GreenLake Platform workspace ID

@@ -3022,7 +3022,7 @@

Option 2: Getting the token directly from UI

Response samples

Content type
application/json
{
  • "ID": "3892eb50-4697-4c72-aadc-32b766bce3c0",
  • "ETag": "a8a0a8d9-d35b-45c6-840f-2b3694efc394",
  • "Name": "My Object Name",
  • "Created": "2019-06-27T22:59:01.661Z",
  • "Modified": "2020-02-27T18:28:02.863Z",
  • "ProjectID": "046b6c7f-0b8a-43b9-b35d-6489e6daee92",
  • "Description": "Description of the image",
  • "Category": "linux",
  • "Flavor": "ubuntu",
  • "Version": "20.04.5",
  • "Origin": "Custom",
  • "Timeout": 1000,
  • "DeviceLayouts": [
    ],
  • "PermittedProjects": [
    ],
  • "Files": [
    ],
  • "Info": [
    ],
  • "Approach": "vmedia",
  • "AssumedBootMethod": "na",
  • "NoSwitchLAG": false,
  • "BondMode": "none",
  • "FWBaselineID": "046b6c7f-0b8a-43b9-b35d-6489e6daee92",
  • "UserDefinedSteps": {
    },
  • "Classifiers": [
    ]
}

Update an OS service image by its ID

Updates an OS service image with a matching ID. Note that Hoster or BMaaS Access Owner role is required for this operation under GreenLake Cloud Services. If GreenLake Platform IAM issued token is used for authentication, then it is required to pass 'X-Role' and 'X-Workspaceid' headers.

+
https://client.greenlake.hpe.com{basePath}/services/{serviceId}

Response samples

Content type
application/json
{
  • "ID": "3892eb50-4697-4c72-aadc-32b766bce3c0",
  • "ETag": "a8a0a8d9-d35b-45c6-840f-2b3694efc394",
  • "Name": "My Object Name",
  • "Created": "2019-06-27T22:59:01.661Z",
  • "Modified": "2020-02-27T18:28:02.863Z",
  • "ProjectID": "046b6c7f-0b8a-43b9-b35d-6489e6daee92",
  • "DownloadHealth": {
    },
  • "Description": "Description of the image",
  • "Category": "linux",
  • "Flavor": "ubuntu",
  • "Version": "20.04.5",
  • "Origin": "Custom",
  • "Timeout": 1000,
  • "DeviceLayouts": [
    ],
  • "PermittedProjects": [
    ],
  • "Files": [
    ],
  • "Info": [
    ],
  • "Approach": "vmedia",
  • "AssumedBootMethod": "na",
  • "NoSwitchLAG": false,
  • "BondMode": "none",
  • "FWBaselineID": "046b6c7f-0b8a-43b9-b35d-6489e6daee92",
  • "UserDefinedSteps": {
    },
  • "Classifiers": [
    ]
}

Update an OS service image by its ID

Updates an OS service image with a matching ID. Note that Hoster or BMaaS Access Owner role is required for this operation under GreenLake Cloud Services. If GreenLake Platform IAM issued token is used for authentication, then it is required to pass 'X-Role' and 'X-Workspaceid' headers.

Authorizations:
(BearerAuthProject) (BearerAuthMembership)
path Parameters
serviceId
required
string

ID of OS service image to update

header Parameters
X-Role
string
Example: metal-infra-admin

GreenLake Platform role name

X-Workspaceid
string
Example: 1a2ba81600dd11efa47076a3447ec4eb

GreenLake Platform workspace ID

@@ -3035,7 +3035,7 @@

Option 2: Getting the token directly from UI

Response samples

Content type
application/json
{
  • "ID": "3892eb50-4697-4c72-aadc-32b766bce3c0",
  • "ETag": "a8a0a8d9-d35b-45c6-840f-2b3694efc394",
  • "Name": "My Object Name",
  • "Created": "2019-06-27T22:59:01.661Z",
  • "Modified": "2020-02-27T18:28:02.863Z",
  • "ProjectID": "046b6c7f-0b8a-43b9-b35d-6489e6daee92",
  • "Description": "Description of the image",
  • "Category": "linux",
  • "Flavor": "ubuntu",
  • "Version": "20.04.5",
  • "Origin": "Custom",
  • "Timeout": 1000,
  • "DeviceLayouts": [
    ],
  • "PermittedProjects": [
    ],
  • "Files": [
    ],
  • "Info": [
    ],
  • "Approach": "vmedia",
  • "AssumedBootMethod": "na",
  • "NoSwitchLAG": false,
  • "BondMode": "none",
  • "FWBaselineID": "046b6c7f-0b8a-43b9-b35d-6489e6daee92",
  • "UserDefinedSteps": {
    },
  • "Classifiers": [
    ]
}

Delete an OS service image

Deletes the OS service image with the matching ID. Note that Hoster or BMaaS Access Owner role is required for this operation under GreenLake Cloud Services. If GreenLake Platform IAM issued token is used for authentication, then it is required to pass 'X-Role' and 'X-Workspaceid' headers.

+
https://client.greenlake.hpe.com{basePath}/services/{serviceId}

Response samples

Content type
application/json
{
  • "ID": "3892eb50-4697-4c72-aadc-32b766bce3c0",
  • "ETag": "a8a0a8d9-d35b-45c6-840f-2b3694efc394",
  • "Name": "My Object Name",
  • "Created": "2019-06-27T22:59:01.661Z",
  • "Modified": "2020-02-27T18:28:02.863Z",
  • "ProjectID": "046b6c7f-0b8a-43b9-b35d-6489e6daee92",
  • "DownloadHealth": {
    },
  • "Description": "Description of the image",
  • "Category": "linux",
  • "Flavor": "ubuntu",
  • "Version": "20.04.5",
  • "Origin": "Custom",
  • "Timeout": 1000,
  • "DeviceLayouts": [
    ],
  • "PermittedProjects": [
    ],
  • "Files": [
    ],
  • "Info": [
    ],
  • "Approach": "vmedia",
  • "AssumedBootMethod": "na",
  • "NoSwitchLAG": false,
  • "BondMode": "none",
  • "FWBaselineID": "046b6c7f-0b8a-43b9-b35d-6489e6daee92",
  • "UserDefinedSteps": {
    },
  • "Classifiers": [
    ]
}

Delete an OS service image

Deletes the OS service image with the matching ID. Note that Hoster or BMaaS Access Owner role is required for this operation under GreenLake Cloud Services. If GreenLake Platform IAM issued token is used for authentication, then it is required to pass 'X-Role' and 'X-Workspaceid' headers.

Authorizations:
(BearerAuthProject) (BearerAuthMembership)
path Parameters
serviceId
required
string

ID of OS service image to delete

header Parameters
X-Role
string
Example: metal-infra-admin

GreenLake Platform role name

X-Workspaceid
string
Example: 1a2ba81600dd11efa47076a3447ec4eb

GreenLake Platform workspace ID

@@ -3057,7 +3057,7 @@

Option 2: Getting the token directly from UI

Response samples

Content type
application/json
{
  • "message": "string",
  • "details": "string"
}