X-Role string
Example: metal-infra-admin
GreenLake Platform role name
@@ -3012,7 +3012,7 @@
Option 2: Getting the token directly from UI
post /services https://client.greenlake.hpe.com{basePath} /services
Response samples Content type application/json
Copy
Expand all Collapse all { "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" ,
"Description" : "Description of the image" ,
"Category" : "linux" ,
"Flavor" : "ubuntu" ,
"Version" : "20.04.5" ,
"Origin" : "Custom" ,
"Timeout" : 1000 ,
"DeviceLayouts" :
[ { "Device" : "/dev/sda" ,
"Description" : "string" ,
"StartOffset" : 0 ,
"TableType" : "gpt" ,
} ] , "Files" :
[ { "ID" : "046b6c7f-0b8a-43b9-b35d-6489e6daee92" ,
"Path" : "image.tgz" ,
"FileSize" : 934960345 ,
"DownloadTimeout" : 32000 ,
"Signature" : "5260deb631d6a9f29bca14043d406bea36d704677dff4cae1a4d48dc568406eb" ,
"Algorithm" : "sha512sum" ,
"Expand" : true ,
"DisplayURL" : "s3://bmmas-images20210506193558893900000003/images/linux/ubuntu/18.04-20220404/v2-kiwi-ubuntu18.04-15616.04_appliance.x86_64-1.16.4.tar.gz" ,
"SecureURL" : "string" ,
"SkipSslVerify" : true
} ] , "Info" :
[ { "Contents" : "string" ,
"Encoding" : "base64" ,
"Templating" : "go-text-template" ,
"TemplatingInput" : "hostdef-v2" ,
"Target" : "vmedia-floppy" ,
"Path" : "/etc/cloud/cloud.cfg.d/92_datasource.cfg"
} ] , "Approach" : "vmedia" ,
"AssumedBootMethod" : "na" ,
"NoSwitchLAG" : false ,
"BondMode" : "none" ,
"FWBaselineID" : "046b6c7f-0b8a-43b9-b35d-6489e6daee92" ,
"UserDefinedSteps" :
{ "ImagingPrepSteps" :
[ { "ID" : "046b6c7f-0b8a-43b9-b35d-6489e6daee92" ,
"Operation" : "Boot Service OS" ,
"Description" : "string" ,
"Parameters" :
[ { "Name" : "string" ,
"Value" : "string" ,
"Description" : "string" ,
"Type" : "Integer" ,
"SecureValue" : "string"
} ] } ] , "MaintenanceSteps" :
[ { "ID" : "046b6c7f-0b8a-43b9-b35d-6489e6daee92" ,
"Operation" : "Boot Service OS" ,
"Description" : "string" ,
"Parameters" :
[ { "Name" : "string" ,
"Value" : "string" ,
"Description" : "string" ,
"Type" : "Integer" ,
"SecureValue" : "string"
} ] } ] } , "Classifiers" :
[ { "Name" : "string" ,
"Rules" :
[ { "SubAttributeRules" :
[ { "Attribute" : "model" ,
"Value" : "Gen10" ,
"Operator" : "contains"
} ] , "Attribute" : "model" ,
"Value" : "Gen10" ,
"Operator" : "contains"
} ] } ] }
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
Copy
Expand all Collapse all { "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" ,
"Description" : "Description of the image" ,
"Category" : "linux" ,
"Flavor" : "ubuntu" ,
"Version" : "20.04.5" ,
"Origin" : "Custom" ,
"Timeout" : 1000 ,
"DeviceLayouts" :
[ { "Device" : "/dev/sda" ,
"Description" : "string" ,
"StartOffset" : 0 ,
"TableType" : "gpt" ,
} ] , "Files" :
[ { "ID" : "046b6c7f-0b8a-43b9-b35d-6489e6daee92" ,
"Path" : "image.tgz" ,
"FileSize" : 934960345 ,
"DownloadTimeout" : 32000 ,
"Signature" : "5260deb631d6a9f29bca14043d406bea36d704677dff4cae1a4d48dc568406eb" ,
"Algorithm" : "sha512sum" ,
"Expand" : true ,
"DisplayURL" : "s3://bmmas-images20210506193558893900000003/images/linux/ubuntu/18.04-20220404/v2-kiwi-ubuntu18.04-15616.04_appliance.x86_64-1.16.4.tar.gz" ,
"SecureURL" : "string" ,
"SkipSslVerify" : true
} ] , "Info" :
[ { "Contents" : "string" ,
"Encoding" : "base64" ,
"Templating" : "go-text-template" ,
"TemplatingInput" : "hostdef-v2" ,
"Target" : "vmedia-floppy" ,
"Path" : "/etc/cloud/cloud.cfg.d/92_datasource.cfg"
} ] , "Approach" : "vmedia" ,
"AssumedBootMethod" : "na" ,
"NoSwitchLAG" : false ,
"BondMode" : "none" ,
"FWBaselineID" : "046b6c7f-0b8a-43b9-b35d-6489e6daee92" ,
"UserDefinedSteps" :
{ "ImagingPrepSteps" :
[ { "ID" : "046b6c7f-0b8a-43b9-b35d-6489e6daee92" ,
"Operation" : "Boot Service OS" ,
"Description" : "string" ,
"Parameters" :
[ { "Name" : "string" ,
"Value" : "string" ,
"Description" : "string" ,
"Type" : "Integer" ,
"SecureValue" : "string"
} ] } ] , "ImagingCompleteSteps" :
[ { "ID" : "046b6c7f-0b8a-43b9-b35d-6489e6daee92" ,
"Operation" : "Boot Service OS" ,
"Description" : "string" ,
"Parameters" :
[ { "Name" : "string" ,
"Value" : "string" ,
"Description" : "string" ,
"Type" : "Integer" ,
"SecureValue" : "string"
} ] } ] , "MaintenanceSteps" :
[ { "ID" : "046b6c7f-0b8a-43b9-b35d-6489e6daee92" ,
"Operation" : "Boot Service OS" ,
"Description" : "string" ,
"Parameters" :
[ { "Name" : "string" ,
"Value" : "string" ,
"Description" : "string" ,
"Type" : "Integer" ,
"SecureValue" : "string"
} ] } ] } , "Classifiers" :
[ { "Name" : "string" ,
"Rules" :
[ { "SubAttributeRules" :
[ { "Attribute" : "model" ,
"Value" : "Gen10" ,
"Operator" : "contains"
} ] , "Attribute" : "model" ,
"Value" : "Gen10" ,
"Operator" : "contains"
} ] } ] }
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.
(BearerAuth Project ) (BearerAuth Membership )
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
get /services/{serviceId} https://client.greenlake.hpe.com{basePath} /services/{serviceId}
Response samples Content type application/json
Copy
Expand all Collapse all { "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" ,
"Description" : "Description of the image" ,
"Category" : "linux" ,
"Flavor" : "ubuntu" ,
"Version" : "20.04.5" ,
"Origin" : "Custom" ,
"Timeout" : 1000 ,
"DeviceLayouts" :
[ { "Device" : "/dev/sda" ,
"Description" : "string" ,
"StartOffset" : 0 ,
"TableType" : "gpt" ,
} ] , "Files" :
[ { "ID" : "046b6c7f-0b8a-43b9-b35d-6489e6daee92" ,
"Path" : "image.tgz" ,
"FileSize" : 934960345 ,
"DownloadTimeout" : 32000 ,
"Signature" : "5260deb631d6a9f29bca14043d406bea36d704677dff4cae1a4d48dc568406eb" ,
"Algorithm" : "sha512sum" ,
"Expand" : true ,
"DisplayURL" : "s3://bmmas-images20210506193558893900000003/images/linux/ubuntu/18.04-20220404/v2-kiwi-ubuntu18.04-15616.04_appliance.x86_64-1.16.4.tar.gz" ,
"SecureURL" : "string" ,
"SkipSslVerify" : true
} ] , "Info" :
[ { "Contents" : "string" ,
"Encoding" : "base64" ,
"Templating" : "go-text-template" ,
"TemplatingInput" : "hostdef-v2" ,
"Target" : "vmedia-floppy" ,
"Path" : "/etc/cloud/cloud.cfg.d/92_datasource.cfg"
} ] , "Approach" : "vmedia" ,
"AssumedBootMethod" : "na" ,
"NoSwitchLAG" : false ,
"BondMode" : "none" ,
"FWBaselineID" : "046b6c7f-0b8a-43b9-b35d-6489e6daee92" ,
"UserDefinedSteps" :
{ "ImagingPrepSteps" :
[ { "ID" : "046b6c7f-0b8a-43b9-b35d-6489e6daee92" ,
"Operation" : "Boot Service OS" ,
"Description" : "string" ,
"Parameters" :
[ { "Name" : "string" ,
"Value" : "string" ,
"Description" : "string" ,
"Type" : "Integer" ,
"SecureValue" : "string"
} ] } ] , "MaintenanceSteps" :
[ { "ID" : "046b6c7f-0b8a-43b9-b35d-6489e6daee92" ,
"Operation" : "Boot Service OS" ,
"Description" : "string" ,
"Parameters" :
[ { "Name" : "string" ,
"Value" : "string" ,
"Description" : "string" ,
"Type" : "Integer" ,
"SecureValue" : "string"
} ] } ] } , "Classifiers" :
[ { "Name" : "string" ,
"Rules" :
[ { "SubAttributeRules" :
[ { "Attribute" : "model" ,
"Value" : "Gen10" ,
"Operator" : "contains"
} ] , "Attribute" : "model" ,
"Value" : "Gen10" ,
"Operator" : "contains"
} ] } ] }
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
Copy
Expand all Collapse all { "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" ,
"Description" : "Description of the image" ,
"Category" : "linux" ,
"Flavor" : "ubuntu" ,
"Version" : "20.04.5" ,
"Origin" : "Custom" ,
"Timeout" : 1000 ,
"DeviceLayouts" :
[ { "Device" : "/dev/sda" ,
"Description" : "string" ,
"StartOffset" : 0 ,
"TableType" : "gpt" ,
} ] , "Files" :
[ { "ID" : "046b6c7f-0b8a-43b9-b35d-6489e6daee92" ,
"Path" : "image.tgz" ,
"FileSize" : 934960345 ,
"DownloadTimeout" : 32000 ,
"Signature" : "5260deb631d6a9f29bca14043d406bea36d704677dff4cae1a4d48dc568406eb" ,
"Algorithm" : "sha512sum" ,
"Expand" : true ,
"DisplayURL" : "s3://bmmas-images20210506193558893900000003/images/linux/ubuntu/18.04-20220404/v2-kiwi-ubuntu18.04-15616.04_appliance.x86_64-1.16.4.tar.gz" ,
"SecureURL" : "string" ,
"SkipSslVerify" : true
} ] , "Info" :
[ { "Contents" : "string" ,
"Encoding" : "base64" ,
"Templating" : "go-text-template" ,
"TemplatingInput" : "hostdef-v2" ,
"Target" : "vmedia-floppy" ,
"Path" : "/etc/cloud/cloud.cfg.d/92_datasource.cfg"
} ] , "Approach" : "vmedia" ,
"AssumedBootMethod" : "na" ,
"NoSwitchLAG" : false ,
"BondMode" : "none" ,
"FWBaselineID" : "046b6c7f-0b8a-43b9-b35d-6489e6daee92" ,
"UserDefinedSteps" :
{ "ImagingPrepSteps" :
[ { "ID" : "046b6c7f-0b8a-43b9-b35d-6489e6daee92" ,
"Operation" : "Boot Service OS" ,
"Description" : "string" ,
"Parameters" :
[ { "Name" : "string" ,
"Value" : "string" ,
"Description" : "string" ,
"Type" : "Integer" ,
"SecureValue" : "string"
} ] } ] , "ImagingCompleteSteps" :
[ { "ID" : "046b6c7f-0b8a-43b9-b35d-6489e6daee92" ,
"Operation" : "Boot Service OS" ,
"Description" : "string" ,
"Parameters" :
[ { "Name" : "string" ,
"Value" : "string" ,
"Description" : "string" ,
"Type" : "Integer" ,
"SecureValue" : "string"
} ] } ] , "MaintenanceSteps" :
[ { "ID" : "046b6c7f-0b8a-43b9-b35d-6489e6daee92" ,
"Operation" : "Boot Service OS" ,
"Description" : "string" ,
"Parameters" :
[ { "Name" : "string" ,
"Value" : "string" ,
"Description" : "string" ,
"Type" : "Integer" ,
"SecureValue" : "string"
} ] } ] } , "Classifiers" :
[ { "Name" : "string" ,
"Rules" :
[ { "SubAttributeRules" :
[ { "Attribute" : "model" ,
"Value" : "Gen10" ,
"Operator" : "contains"
} ] , "Attribute" : "model" ,
"Value" : "Gen10" ,
"Operator" : "contains"
} ] } ] }
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.
(BearerAuth Project ) (BearerAuth Membership )
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
put /services/{serviceId} https://client.greenlake.hpe.com{basePath} /services/{serviceId}
Response samples Content type application/json
Copy
Expand all Collapse all { "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" ,
"Description" : "Description of the image" ,
"Category" : "linux" ,
"Flavor" : "ubuntu" ,
"Version" : "20.04.5" ,
"Origin" : "Custom" ,
"Timeout" : 1000 ,
"DeviceLayouts" :
[ { "Device" : "/dev/sda" ,
"Description" : "string" ,
"StartOffset" : 0 ,
"TableType" : "gpt" ,
} ] , "Files" :
[ { "ID" : "046b6c7f-0b8a-43b9-b35d-6489e6daee92" ,
"Path" : "image.tgz" ,
"FileSize" : 934960345 ,
"DownloadTimeout" : 32000 ,
"Signature" : "5260deb631d6a9f29bca14043d406bea36d704677dff4cae1a4d48dc568406eb" ,
"Algorithm" : "sha512sum" ,
"Expand" : true ,
"DisplayURL" : "s3://bmmas-images20210506193558893900000003/images/linux/ubuntu/18.04-20220404/v2-kiwi-ubuntu18.04-15616.04_appliance.x86_64-1.16.4.tar.gz" ,
"SecureURL" : "string" ,
"SkipSslVerify" : true
} ] , "Info" :
[ { "Contents" : "string" ,
"Encoding" : "base64" ,
"Templating" : "go-text-template" ,
"TemplatingInput" : "hostdef-v2" ,
"Target" : "vmedia-floppy" ,
"Path" : "/etc/cloud/cloud.cfg.d/92_datasource.cfg"
} ] , "Approach" : "vmedia" ,
"AssumedBootMethod" : "na" ,
"NoSwitchLAG" : false ,
"BondMode" : "none" ,
"FWBaselineID" : "046b6c7f-0b8a-43b9-b35d-6489e6daee92" ,
"UserDefinedSteps" :
{ "ImagingPrepSteps" :
[ { "ID" : "046b6c7f-0b8a-43b9-b35d-6489e6daee92" ,
"Operation" : "Boot Service OS" ,
"Description" : "string" ,
"Parameters" :
[ { "Name" : "string" ,
"Value" : "string" ,
"Description" : "string" ,
"Type" : "Integer" ,
"SecureValue" : "string"
} ] } ] , "MaintenanceSteps" :
[ { "ID" : "046b6c7f-0b8a-43b9-b35d-6489e6daee92" ,
"Operation" : "Boot Service OS" ,
"Description" : "string" ,
"Parameters" :
[ { "Name" : "string" ,
"Value" : "string" ,
"Description" : "string" ,
"Type" : "Integer" ,
"SecureValue" : "string"
} ] } ] } , "Classifiers" :
[ { "Name" : "string" ,
"Rules" :
[ { "SubAttributeRules" :
[ { "Attribute" : "model" ,
"Value" : "Gen10" ,
"Operator" : "contains"
} ] , "Attribute" : "model" ,
"Value" : "Gen10" ,
"Operator" : "contains"
} ] } ] }
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
Copy
Expand all Collapse all { "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" ,
"Description" : "Description of the image" ,
"Category" : "linux" ,
"Flavor" : "ubuntu" ,
"Version" : "20.04.5" ,
"Origin" : "Custom" ,
"Timeout" : 1000 ,
"DeviceLayouts" :
[ { "Device" : "/dev/sda" ,
"Description" : "string" ,
"StartOffset" : 0 ,
"TableType" : "gpt" ,
} ] , "Files" :
[ { "ID" : "046b6c7f-0b8a-43b9-b35d-6489e6daee92" ,
"Path" : "image.tgz" ,
"FileSize" : 934960345 ,
"DownloadTimeout" : 32000 ,
"Signature" : "5260deb631d6a9f29bca14043d406bea36d704677dff4cae1a4d48dc568406eb" ,
"Algorithm" : "sha512sum" ,
"Expand" : true ,
"DisplayURL" : "s3://bmmas-images20210506193558893900000003/images/linux/ubuntu/18.04-20220404/v2-kiwi-ubuntu18.04-15616.04_appliance.x86_64-1.16.4.tar.gz" ,
"SecureURL" : "string" ,
"SkipSslVerify" : true
} ] , "Info" :
[ { "Contents" : "string" ,
"Encoding" : "base64" ,
"Templating" : "go-text-template" ,
"TemplatingInput" : "hostdef-v2" ,
"Target" : "vmedia-floppy" ,
"Path" : "/etc/cloud/cloud.cfg.d/92_datasource.cfg"
} ] , "Approach" : "vmedia" ,
"AssumedBootMethod" : "na" ,
"NoSwitchLAG" : false ,
"BondMode" : "none" ,
"FWBaselineID" : "046b6c7f-0b8a-43b9-b35d-6489e6daee92" ,
"UserDefinedSteps" :
{ "ImagingPrepSteps" :
[ { "ID" : "046b6c7f-0b8a-43b9-b35d-6489e6daee92" ,
"Operation" : "Boot Service OS" ,
"Description" : "string" ,
"Parameters" :
[ { "Name" : "string" ,
"Value" : "string" ,
"Description" : "string" ,
"Type" : "Integer" ,
"SecureValue" : "string"
} ] } ] , "ImagingCompleteSteps" :
[ { "ID" : "046b6c7f-0b8a-43b9-b35d-6489e6daee92" ,
"Operation" : "Boot Service OS" ,
"Description" : "string" ,
"Parameters" :
[ { "Name" : "string" ,
"Value" : "string" ,
"Description" : "string" ,
"Type" : "Integer" ,
"SecureValue" : "string"
} ] } ] , "MaintenanceSteps" :
[ { "ID" : "046b6c7f-0b8a-43b9-b35d-6489e6daee92" ,
"Operation" : "Boot Service OS" ,
"Description" : "string" ,
"Parameters" :
[ { "Name" : "string" ,
"Value" : "string" ,
"Description" : "string" ,
"Type" : "Integer" ,
"SecureValue" : "string"
} ] } ] } , "Classifiers" :
[ { "Name" : "string" ,
"Rules" :
[ { "SubAttributeRules" :
[ { "Attribute" : "model" ,
"Value" : "Gen10" ,
"Operator" : "contains"
} ] , "Attribute" : "model" ,
"Value" : "Gen10" ,
"Operator" : "contains"
} ] } ] }
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.
(BearerAuth Project ) (BearerAuth Membership )
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
@@ -3047,7 +3047,11 @@
Option 2: Getting the token directly from UI
delete /services/{serviceId} https://client.greenlake.hpe.com{basePath} /services/{serviceId}
Response samples Content type application/json
{ "message" : "string" ,
"details" : "string"
}