2202 lines
99 KiB
PHP
2202 lines
99 KiB
PHP
<?php
|
|
/**
|
|
* ImagesApi
|
|
* PHP version 7.4
|
|
*
|
|
* @category Class
|
|
* @package OpenAPI\Client
|
|
* @author OpenAPI Generator team
|
|
* @link https://openapi-generator.tech
|
|
*/
|
|
|
|
/**
|
|
* Instance API
|
|
*
|
|
* Scaleway Instances are virtual machines in the cloud. Different [Instance types](https://www.scaleway.com/en/docs/compute/instances/reference-content/choosing-instance-type/) offer different technical specifications in terms of vCPU, RAM, bandwidth and storage. Once you have created your Instance and installed your image of choice (e.g. an operating system), you can [connect to your Instance via SSH](https://www.scaleway.com/en/docs/compute/instances/how-to/connect-to-instance/) to use it as you wish. When you are done using the Instance, you can delete it from your account. (switchcolumn) <Message type=\"tip\"> To retrieve information about the different [images](#path-images) available to install on Scaleway Instances, check out our [Marketplace API](https://www.scaleway.com/en/developers/api/marketplace). </Message> (switchcolumn) ## Concepts Refer to our [dedicated concepts page](https://www.scaleway.com/en/docs/compute/instances/concepts/) to find definitions of all concepts and terminology related to Instances. (switchcolumn) (switchcolumn) ## Quickstart 1. Configure your environment variables <Message type=\"note\"> This is an optional step that seeks to simplify your usage of the Instances API. See [Availability Zones](#availability-zones) below for help choosing an Availability Zone. You can find your Project ID in the [Scaleway console](https://console.scaleway.com/project/settings). </Message> ```bash export SCW_SECRET_KEY=\"<API secret key>\" export SCW_DEFAULT_ZONE=\"<Scaleway Availability Zone>\" export SCW_PROJECT_ID=\"<Scaleway Project ID>\" ``` 2. **Create an Instance**: Run the following command to create an Instance. You can customize the details in the payload (name, description, type, tags etc) to your needs: use the information below to adjust the payload as necessary. ```bash curl -X POST \\ -H \"X-Auth-Token: $SCW_SECRET_KEY\" \\ -H \"Content-Type: application/json\" \\ \"https://api.scaleway.com/instance/v1/zones/$SCW_DEFAULT_ZONE/servers\" \\ -d '{ \"name\": \"my-new-instance\", \"project\": \"'\"$SCW_PROJECT_ID\"'\", \"commercial_type\": \"GP1-S\", \"image\": \"ubuntu_noble\", \"enable_ipv6\": true, \"volumes\": { \"0\":{ \"size\": 300000000000, \"volume_type\": \"l_ssd\" } } }' ``` | Parameter | Description | Valid values | | --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `name` | A name of your choice for the Instance (string) | Any string containing only alphanumeric characters, dots, spaces and dashes, e.g. `\"my-new-instance\"`. | | `project` | The Project in which the Instance should be created (string) | Any valid Scaleway Project ID (see above), e.g. `\"b4bd99e0-b389-11ed-afa1-0242ac120002\"` | | `commercial-type` | The commercial Instance type to create (string) | Any valid ID of a Scaleway commercial Instance type, e.g. `\"GP1-S\"`, `\"PRO2-M\"`. Use the [List Instance Types](#path-instance-types-list-instance-types) endpoint to get a list of all valid Instance types and their IDs. | | `image` | The image to install on the Instance, e.g. a particular OS (string) | Any Scaleway image label, e.g. `\"ubuntu_noble\"`, or any valid Scaleway image ID, e.g. `\"6fc0ade6-d6a3-4fb9-87ab-2444ac71e5c0\"` which is the ID for the `Ubuntu 24.04 Noble Numbat` image. Use the [List Instance Images](#path-images-list-instance-images) endpoint to get a list of all available images with their IDs and labels, or check out the [Scaleway Marketplace API](https://www.scaleway.com/en/developers/api/marketplace). | | `enable_ipv6` | Whether to enable IPv6 on the Instance (boolean) | `true` or `false` | | `volumes` | An object that specifies the storage volumes to attach to the Instance. For more information, see **Creating an Instance: the volumes object** in the [Technical information](#technical-information) section of this quickstart. | A (dictionary) object with a minimum of one key (`\"0\"`) whose value is another object containing the parameters `\"name\"` (a name for the volume), `\"size\"` (the size for the volume, in bytes), and `\"volume_type\"` (`\"l_ssd\"` or `\"b_ssd\"`). Additional keys for additional volumes should increment by 1 each time (the second volume would have a key of `1`.) Further parameters are available, and it is possible to attach existing volumes rather than creating a new one, or create a volume from a snapshot. | 3. **List your Instances**: run the following command to get a list of all the Instances in your account, with their details: ```bash curl -X GET \\ -H \"Content-Type: application/json\" \\ -H \"X-Auth-Token: $SCW_SECRET_KEY\" \\ \"https://api.scaleway.com/instance/v1/zones/$SCW_DEFAULT_ZONE/servers/\" ``` 4. **Delete an Instance**: run the following command to delete an Instance, specified by its Instance ID: ```bash curl -X DELETE \\ -H \"X-Auth-Token: $SCW_SECRET_KEY\" \\ -H \"Content-Type: application/json\" \\ \"https://api.scaleway.com/instance/v1/zones/$SCW_DEFAULT_ZONE/servers/<Instance-ID>\" ``` The expected successful response is empty. (switchcolumn) <Message type=\"requirement\"> - You have a [Scaleway account](https://console.scaleway.com/) - You have created an [API key](https://www.scaleway.com/en/docs/identity-and-access-management/iam/how-to/create-api-keys/) and that the API key has sufficient [IAM permissions](https://www.scaleway.com/en/docs/identity-and-access-management/iam/reference-content/permission-sets/) to perform the actions described on this page - You have [installed `curl`](https://curl.se/download.html) </Message> (switchcolumn) ## Technical information ### Availability Zones Instances can be deployed in the following Availability Zones: | Name | API ID | |-----------|-----------------------| | Paris | `fr-par-1` `fr-par-2` `fr-par-3` | | Amsterdam | `nl-ams-1` `nl-ams-2` | | Warsaw | `pl-waw-1` `pl-waw-2` | (switchcolumn) (switchcolumn) ### Pagination Most listing requests receive a paginated response. Requests against paginated endpoints accept two `query` arguments: - `page`, a positive integer to choose which page to return. - `per_page`, an positive integer lower or equal to 100 to select the number of items to return per page. The default value is `50`. Paginated endpoints usually also accept filters to search and sort results.These filters are documented along each endpoint documentation. The `X-Total-Count` header contains the total number of items returned. (switchcolumn) (switchcolumn) ### Creating an Instance: the volumes object When [creating an Instance](#path-instances-create-an-instance) using the Scaleway API, the `volumes` object is **not strictly required**. However, the defaults vary depending on certain conditions: 1. If an image label is used: - The default will be an `sbs_volume` volume. - The size of this volume will be the OS size (typically 10GB in most cases). 2. If an image ID from the marketplace is used (or any image based on a unified snapshot): - If the Instance supports local storage: - The default will be an `l_ssd` volume. - The size of this volume will be the instance's maximum local storage capacity. - If the Instance does not support local storage: - The default will be a `b_ssd` volume. - The size of this volume will be the OS size. If you want to customize the storage configuration or add additional volumes, you will need to include the volumes object in your API request. This object should contain at least one (dictionary) object with a minimum of one key (`\"0\"`) whose value is another object containing the parameters `\"name\"` (a name for the volume), `\"size\"` (the size for the volume, in bytes), and `\"volume_type\"` (`\"sbs_volume\"`, `\"l_ssd\"` or `\"b_ssd\"`). Additional keys for additional volumes should increment by 1 each time (the second volume would have a key of `\"1\"`.) Note that volume `size` must respect the volume constraints of the Instance's `commercial_type`: for each type of Instance, a minimum amount of storage is required, and there is also a maximum that cannot be exceeded. All Instance types support Block Storage (`sbs_volume`, `b_ssd`), some also support local storage (`l_ssd`). Read more about these constraints in the [List Instance types](#path-instance-types-list-instance-types) documentation, specifically the `volume_constraints` parameter for each type listed in the response You can use the `volumes` object in different ways. The table below shows which parameters are required for each of the following use cases: | Use case | Required params | Optional params | Notes | |-------------------------|-----------------------|---------------------|----------------------------------------| | Create a volume (`l_ssd`, `b_ssd`, `sbs_volume`) from a snapshot of an image | | `volume_type`, `size`, `boot` | If the `size` parameter is not set, the size of the volume will equal the size of the corresponding snapshot of the image. The image snapshot type should be compatible with the `volume_type`. | | Create a volume (`l_ssd`, `b_ssd`) from a snapshot | `base_snapshot`, `name`, `volume_type` | `boot` | | | Create a volume of type `sbs_volume` from a snapshot | `base_snapshot`, `name`, `volume_type` | `size`, `boot` | | | Create an empty volume | `name`, `volume_type`, `size` | `boot` | | | Attach an existing volume (`l_ssd`, `b_ssd`) | `id` | `boot` | | | Attach an existing volume of type `sbs_volume` | `id`, `volume_type` | `boot` | | (switchcolumn) <Message type=\"note\"> This information is designed to help you correctly configure the `volumes` object when using the [Create an Instance](#path-instances-create-an-instance) or [Update an Instance](#path-instances-update-an-instance) methods. </Message> (switchcolumn) ## Going further For more help using Scaleway Instances, check out the following resources: - Our [main documentation](https://www.scaleway.com/en/docs/compute/instances/) - The #instance channel on our [Slack Community](https://www.scaleway.com/en/docs/tutorials/scaleway-slack-community/) - Our [support ticketing system](https://www.scaleway.com/en/docs/console/my-account/how-to/open-a-support-ticket/).
|
|
*
|
|
* The version of the OpenAPI document: v1
|
|
* Generated by: https://openapi-generator.tech
|
|
* Generator version: 7.11.0
|
|
*/
|
|
|
|
/**
|
|
* NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
|
|
* https://openapi-generator.tech
|
|
* Do not edit the class manually.
|
|
*/
|
|
|
|
namespace OpenAPI\Client\Api;
|
|
|
|
use GuzzleHttp\Client;
|
|
use GuzzleHttp\ClientInterface;
|
|
use GuzzleHttp\Exception\ConnectException;
|
|
use GuzzleHttp\Exception\RequestException;
|
|
use GuzzleHttp\Psr7\MultipartStream;
|
|
use GuzzleHttp\Psr7\Request;
|
|
use GuzzleHttp\RequestOptions;
|
|
use OpenAPI\Client\ApiException;
|
|
use OpenAPI\Client\Configuration;
|
|
use OpenAPI\Client\HeaderSelector;
|
|
use OpenAPI\Client\ObjectSerializer;
|
|
|
|
/**
|
|
* ImagesApi Class Doc Comment
|
|
*
|
|
* @category Class
|
|
* @package OpenAPI\Client
|
|
* @author OpenAPI Generator team
|
|
* @link https://openapi-generator.tech
|
|
*/
|
|
class ImagesApi
|
|
{
|
|
/**
|
|
* @var ClientInterface
|
|
*/
|
|
protected $client;
|
|
|
|
/**
|
|
* @var Configuration
|
|
*/
|
|
protected $config;
|
|
|
|
/**
|
|
* @var HeaderSelector
|
|
*/
|
|
protected $headerSelector;
|
|
|
|
/**
|
|
* @var int Host index
|
|
*/
|
|
protected $hostIndex;
|
|
|
|
/** @var string[] $contentTypes **/
|
|
public const contentTypes = [
|
|
'createImage' => [
|
|
'application/json',
|
|
],
|
|
'deleteImage' => [
|
|
'application/json',
|
|
],
|
|
'getImage' => [
|
|
'application/json',
|
|
],
|
|
'listImages' => [
|
|
'application/json',
|
|
],
|
|
'setImage' => [
|
|
'application/json',
|
|
],
|
|
'updateImage' => [
|
|
'application/json',
|
|
],
|
|
];
|
|
|
|
/**
|
|
* @param ClientInterface $client
|
|
* @param Configuration $config
|
|
* @param HeaderSelector $selector
|
|
* @param int $hostIndex (Optional) host index to select the list of hosts if defined in the OpenAPI spec
|
|
*/
|
|
public function __construct(
|
|
?ClientInterface $client = null,
|
|
?Configuration $config = null,
|
|
?HeaderSelector $selector = null,
|
|
int $hostIndex = 0
|
|
) {
|
|
$this->client = $client ?: new Client();
|
|
$this->config = $config ?: Configuration::getDefaultConfiguration();
|
|
$this->headerSelector = $selector ?: new HeaderSelector();
|
|
$this->hostIndex = $hostIndex;
|
|
}
|
|
|
|
/**
|
|
* Set the host index
|
|
*
|
|
* @param int $hostIndex Host index (required)
|
|
*/
|
|
public function setHostIndex($hostIndex): void
|
|
{
|
|
$this->hostIndex = $hostIndex;
|
|
}
|
|
|
|
/**
|
|
* Get the host index
|
|
*
|
|
* @return int Host index
|
|
*/
|
|
public function getHostIndex()
|
|
{
|
|
return $this->hostIndex;
|
|
}
|
|
|
|
/**
|
|
* @return Configuration
|
|
*/
|
|
public function getConfig()
|
|
{
|
|
return $this->config;
|
|
}
|
|
|
|
/**
|
|
* Operation createImage
|
|
*
|
|
* Create an Instance image
|
|
*
|
|
* @param string $zone The zone you want to target (required)
|
|
* @param \OpenAPI\Client\Model\CreateImageRequest $create_image_request create_image_request (required)
|
|
* @param string $contentType The value for the Content-Type header. Check self::contentTypes['createImage'] to see the possible values for this operation
|
|
*
|
|
* @throws \OpenAPI\Client\ApiException on non-2xx response or if the response body is not in the expected format
|
|
* @throws \InvalidArgumentException
|
|
* @return \OpenAPI\Client\Model\ScalewayInstanceV1CreateImageResponse
|
|
*/
|
|
public function createImage($zone, $create_image_request, string $contentType = self::contentTypes['createImage'][0])
|
|
{
|
|
list($response) = $this->createImageWithHttpInfo($zone, $create_image_request, $contentType);
|
|
return $response;
|
|
}
|
|
|
|
/**
|
|
* Operation createImageWithHttpInfo
|
|
*
|
|
* Create an Instance image
|
|
*
|
|
* @param string $zone The zone you want to target (required)
|
|
* @param \OpenAPI\Client\Model\CreateImageRequest $create_image_request (required)
|
|
* @param string $contentType The value for the Content-Type header. Check self::contentTypes['createImage'] to see the possible values for this operation
|
|
*
|
|
* @throws \OpenAPI\Client\ApiException on non-2xx response or if the response body is not in the expected format
|
|
* @throws \InvalidArgumentException
|
|
* @return array of \OpenAPI\Client\Model\ScalewayInstanceV1CreateImageResponse, HTTP status code, HTTP response headers (array of strings)
|
|
*/
|
|
public function createImageWithHttpInfo($zone, $create_image_request, string $contentType = self::contentTypes['createImage'][0])
|
|
{
|
|
$request = $this->createImageRequest($zone, $create_image_request, $contentType);
|
|
|
|
try {
|
|
$options = $this->createHttpClientOption();
|
|
try {
|
|
$response = $this->client->send($request, $options);
|
|
} catch (RequestException $e) {
|
|
throw new ApiException(
|
|
"[{$e->getCode()}] {$e->getMessage()}",
|
|
(int) $e->getCode(),
|
|
$e->getResponse() ? $e->getResponse()->getHeaders() : null,
|
|
$e->getResponse() ? (string) $e->getResponse()->getBody() : null
|
|
);
|
|
} catch (ConnectException $e) {
|
|
throw new ApiException(
|
|
"[{$e->getCode()}] {$e->getMessage()}",
|
|
(int) $e->getCode(),
|
|
null,
|
|
null
|
|
);
|
|
}
|
|
|
|
$statusCode = $response->getStatusCode();
|
|
|
|
|
|
switch($statusCode) {
|
|
case 201:
|
|
if ('\OpenAPI\Client\Model\ScalewayInstanceV1CreateImageResponse' === '\SplFileObject') {
|
|
$content = $response->getBody(); //stream goes to serializer
|
|
} else {
|
|
$content = (string) $response->getBody();
|
|
if ('\OpenAPI\Client\Model\ScalewayInstanceV1CreateImageResponse' !== 'string') {
|
|
try {
|
|
$content = json_decode($content, false, 512, JSON_THROW_ON_ERROR);
|
|
} catch (\JsonException $exception) {
|
|
throw new ApiException(
|
|
sprintf(
|
|
'Error JSON decoding server response (%s)',
|
|
$request->getUri()
|
|
),
|
|
$statusCode,
|
|
$response->getHeaders(),
|
|
$content
|
|
);
|
|
}
|
|
}
|
|
}
|
|
|
|
return [
|
|
ObjectSerializer::deserialize($content, '\OpenAPI\Client\Model\ScalewayInstanceV1CreateImageResponse', []),
|
|
$response->getStatusCode(),
|
|
$response->getHeaders()
|
|
];
|
|
}
|
|
|
|
if ($statusCode < 200 || $statusCode > 299) {
|
|
throw new ApiException(
|
|
sprintf(
|
|
'[%d] Error connecting to the API (%s)',
|
|
$statusCode,
|
|
(string) $request->getUri()
|
|
),
|
|
$statusCode,
|
|
$response->getHeaders(),
|
|
(string) $response->getBody()
|
|
);
|
|
}
|
|
|
|
$returnType = '\OpenAPI\Client\Model\ScalewayInstanceV1CreateImageResponse';
|
|
if ($returnType === '\SplFileObject') {
|
|
$content = $response->getBody(); //stream goes to serializer
|
|
} else {
|
|
$content = (string) $response->getBody();
|
|
if ($returnType !== 'string') {
|
|
try {
|
|
$content = json_decode($content, false, 512, JSON_THROW_ON_ERROR);
|
|
} catch (\JsonException $exception) {
|
|
throw new ApiException(
|
|
sprintf(
|
|
'Error JSON decoding server response (%s)',
|
|
$request->getUri()
|
|
),
|
|
$statusCode,
|
|
$response->getHeaders(),
|
|
$content
|
|
);
|
|
}
|
|
}
|
|
}
|
|
|
|
return [
|
|
ObjectSerializer::deserialize($content, $returnType, []),
|
|
$response->getStatusCode(),
|
|
$response->getHeaders()
|
|
];
|
|
|
|
} catch (ApiException $e) {
|
|
switch ($e->getCode()) {
|
|
case 201:
|
|
$data = ObjectSerializer::deserialize(
|
|
$e->getResponseBody(),
|
|
'\OpenAPI\Client\Model\ScalewayInstanceV1CreateImageResponse',
|
|
$e->getResponseHeaders()
|
|
);
|
|
$e->setResponseObject($data);
|
|
break;
|
|
}
|
|
throw $e;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Operation createImageAsync
|
|
*
|
|
* Create an Instance image
|
|
*
|
|
* @param string $zone The zone you want to target (required)
|
|
* @param \OpenAPI\Client\Model\CreateImageRequest $create_image_request (required)
|
|
* @param string $contentType The value for the Content-Type header. Check self::contentTypes['createImage'] to see the possible values for this operation
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @return \GuzzleHttp\Promise\PromiseInterface
|
|
*/
|
|
public function createImageAsync($zone, $create_image_request, string $contentType = self::contentTypes['createImage'][0])
|
|
{
|
|
return $this->createImageAsyncWithHttpInfo($zone, $create_image_request, $contentType)
|
|
->then(
|
|
function ($response) {
|
|
return $response[0];
|
|
}
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Operation createImageAsyncWithHttpInfo
|
|
*
|
|
* Create an Instance image
|
|
*
|
|
* @param string $zone The zone you want to target (required)
|
|
* @param \OpenAPI\Client\Model\CreateImageRequest $create_image_request (required)
|
|
* @param string $contentType The value for the Content-Type header. Check self::contentTypes['createImage'] to see the possible values for this operation
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @return \GuzzleHttp\Promise\PromiseInterface
|
|
*/
|
|
public function createImageAsyncWithHttpInfo($zone, $create_image_request, string $contentType = self::contentTypes['createImage'][0])
|
|
{
|
|
$returnType = '\OpenAPI\Client\Model\ScalewayInstanceV1CreateImageResponse';
|
|
$request = $this->createImageRequest($zone, $create_image_request, $contentType);
|
|
|
|
return $this->client
|
|
->sendAsync($request, $this->createHttpClientOption())
|
|
->then(
|
|
function ($response) use ($returnType) {
|
|
if ($returnType === '\SplFileObject') {
|
|
$content = $response->getBody(); //stream goes to serializer
|
|
} else {
|
|
$content = (string) $response->getBody();
|
|
if ($returnType !== 'string') {
|
|
$content = json_decode($content);
|
|
}
|
|
}
|
|
|
|
return [
|
|
ObjectSerializer::deserialize($content, $returnType, []),
|
|
$response->getStatusCode(),
|
|
$response->getHeaders()
|
|
];
|
|
},
|
|
function ($exception) {
|
|
$response = $exception->getResponse();
|
|
$statusCode = $response->getStatusCode();
|
|
throw new ApiException(
|
|
sprintf(
|
|
'[%d] Error connecting to the API (%s)',
|
|
$statusCode,
|
|
$exception->getRequest()->getUri()
|
|
),
|
|
$statusCode,
|
|
$response->getHeaders(),
|
|
(string) $response->getBody()
|
|
);
|
|
}
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Create request for operation 'createImage'
|
|
*
|
|
* @param string $zone The zone you want to target (required)
|
|
* @param \OpenAPI\Client\Model\CreateImageRequest $create_image_request (required)
|
|
* @param string $contentType The value for the Content-Type header. Check self::contentTypes['createImage'] to see the possible values for this operation
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @return \GuzzleHttp\Psr7\Request
|
|
*/
|
|
public function createImageRequest($zone, $create_image_request, string $contentType = self::contentTypes['createImage'][0])
|
|
{
|
|
|
|
// verify the required parameter 'zone' is set
|
|
if ($zone === null || (is_array($zone) && count($zone) === 0)) {
|
|
throw new \InvalidArgumentException(
|
|
'Missing the required parameter $zone when calling createImage'
|
|
);
|
|
}
|
|
|
|
// verify the required parameter 'create_image_request' is set
|
|
if ($create_image_request === null || (is_array($create_image_request) && count($create_image_request) === 0)) {
|
|
throw new \InvalidArgumentException(
|
|
'Missing the required parameter $create_image_request when calling createImage'
|
|
);
|
|
}
|
|
|
|
|
|
$resourcePath = '/instance/v1/zones/{zone}/images';
|
|
$formParams = [];
|
|
$queryParams = [];
|
|
$headerParams = [];
|
|
$httpBody = '';
|
|
$multipart = false;
|
|
|
|
|
|
|
|
// path params
|
|
if ($zone !== null) {
|
|
$resourcePath = str_replace(
|
|
'{' . 'zone' . '}',
|
|
ObjectSerializer::toPathValue($zone),
|
|
$resourcePath
|
|
);
|
|
}
|
|
|
|
|
|
$headers = $this->headerSelector->selectHeaders(
|
|
['application/json', ],
|
|
$contentType,
|
|
$multipart
|
|
);
|
|
|
|
// for model (json/xml)
|
|
if (isset($create_image_request)) {
|
|
if (stripos($headers['Content-Type'], 'application/json') !== false) {
|
|
# if Content-Type contains "application/json", json_encode the body
|
|
$httpBody = \GuzzleHttp\Utils::jsonEncode(ObjectSerializer::sanitizeForSerialization($create_image_request));
|
|
} else {
|
|
$httpBody = $create_image_request;
|
|
}
|
|
} elseif (count($formParams) > 0) {
|
|
if ($multipart) {
|
|
$multipartContents = [];
|
|
foreach ($formParams as $formParamName => $formParamValue) {
|
|
$formParamValueItems = is_array($formParamValue) ? $formParamValue : [$formParamValue];
|
|
foreach ($formParamValueItems as $formParamValueItem) {
|
|
$multipartContents[] = [
|
|
'name' => $formParamName,
|
|
'contents' => $formParamValueItem
|
|
];
|
|
}
|
|
}
|
|
// for HTTP post (form)
|
|
$httpBody = new MultipartStream($multipartContents);
|
|
|
|
} elseif (stripos($headers['Content-Type'], 'application/json') !== false) {
|
|
# if Content-Type contains "application/json", json_encode the form parameters
|
|
$httpBody = \GuzzleHttp\Utils::jsonEncode($formParams);
|
|
} else {
|
|
// for HTTP post (form)
|
|
$httpBody = ObjectSerializer::buildQuery($formParams);
|
|
}
|
|
}
|
|
|
|
// this endpoint requires API key authentication
|
|
$apiKey = $this->config->getApiKeyWithPrefix('X-Auth-Token');
|
|
if ($apiKey !== null) {
|
|
$headers['X-Auth-Token'] = $apiKey;
|
|
}
|
|
|
|
$defaultHeaders = [];
|
|
if ($this->config->getUserAgent()) {
|
|
$defaultHeaders['User-Agent'] = $this->config->getUserAgent();
|
|
}
|
|
|
|
$headers = array_merge(
|
|
$defaultHeaders,
|
|
$headerParams,
|
|
$headers
|
|
);
|
|
|
|
$operationHost = $this->config->getHost();
|
|
$query = ObjectSerializer::buildQuery($queryParams);
|
|
return new Request(
|
|
'POST',
|
|
$operationHost . $resourcePath . ($query ? "?{$query}" : ''),
|
|
$headers,
|
|
$httpBody
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Operation deleteImage
|
|
*
|
|
* Delete an Instance image
|
|
*
|
|
* @param string $zone The zone you want to target (required)
|
|
* @param string $image_id UUID of the image you want to delete. (required)
|
|
* @param string $contentType The value for the Content-Type header. Check self::contentTypes['deleteImage'] to see the possible values for this operation
|
|
*
|
|
* @throws \OpenAPI\Client\ApiException on non-2xx response or if the response body is not in the expected format
|
|
* @throws \InvalidArgumentException
|
|
* @return void
|
|
*/
|
|
public function deleteImage($zone, $image_id, string $contentType = self::contentTypes['deleteImage'][0])
|
|
{
|
|
$this->deleteImageWithHttpInfo($zone, $image_id, $contentType);
|
|
}
|
|
|
|
/**
|
|
* Operation deleteImageWithHttpInfo
|
|
*
|
|
* Delete an Instance image
|
|
*
|
|
* @param string $zone The zone you want to target (required)
|
|
* @param string $image_id UUID of the image you want to delete. (required)
|
|
* @param string $contentType The value for the Content-Type header. Check self::contentTypes['deleteImage'] to see the possible values for this operation
|
|
*
|
|
* @throws \OpenAPI\Client\ApiException on non-2xx response or if the response body is not in the expected format
|
|
* @throws \InvalidArgumentException
|
|
* @return array of null, HTTP status code, HTTP response headers (array of strings)
|
|
*/
|
|
public function deleteImageWithHttpInfo($zone, $image_id, string $contentType = self::contentTypes['deleteImage'][0])
|
|
{
|
|
$request = $this->deleteImageRequest($zone, $image_id, $contentType);
|
|
|
|
try {
|
|
$options = $this->createHttpClientOption();
|
|
try {
|
|
$response = $this->client->send($request, $options);
|
|
} catch (RequestException $e) {
|
|
throw new ApiException(
|
|
"[{$e->getCode()}] {$e->getMessage()}",
|
|
(int) $e->getCode(),
|
|
$e->getResponse() ? $e->getResponse()->getHeaders() : null,
|
|
$e->getResponse() ? (string) $e->getResponse()->getBody() : null
|
|
);
|
|
} catch (ConnectException $e) {
|
|
throw new ApiException(
|
|
"[{$e->getCode()}] {$e->getMessage()}",
|
|
(int) $e->getCode(),
|
|
null,
|
|
null
|
|
);
|
|
}
|
|
|
|
$statusCode = $response->getStatusCode();
|
|
|
|
|
|
return [null, $statusCode, $response->getHeaders()];
|
|
|
|
} catch (ApiException $e) {
|
|
switch ($e->getCode()) {
|
|
}
|
|
throw $e;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Operation deleteImageAsync
|
|
*
|
|
* Delete an Instance image
|
|
*
|
|
* @param string $zone The zone you want to target (required)
|
|
* @param string $image_id UUID of the image you want to delete. (required)
|
|
* @param string $contentType The value for the Content-Type header. Check self::contentTypes['deleteImage'] to see the possible values for this operation
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @return \GuzzleHttp\Promise\PromiseInterface
|
|
*/
|
|
public function deleteImageAsync($zone, $image_id, string $contentType = self::contentTypes['deleteImage'][0])
|
|
{
|
|
return $this->deleteImageAsyncWithHttpInfo($zone, $image_id, $contentType)
|
|
->then(
|
|
function ($response) {
|
|
return $response[0];
|
|
}
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Operation deleteImageAsyncWithHttpInfo
|
|
*
|
|
* Delete an Instance image
|
|
*
|
|
* @param string $zone The zone you want to target (required)
|
|
* @param string $image_id UUID of the image you want to delete. (required)
|
|
* @param string $contentType The value for the Content-Type header. Check self::contentTypes['deleteImage'] to see the possible values for this operation
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @return \GuzzleHttp\Promise\PromiseInterface
|
|
*/
|
|
public function deleteImageAsyncWithHttpInfo($zone, $image_id, string $contentType = self::contentTypes['deleteImage'][0])
|
|
{
|
|
$returnType = '';
|
|
$request = $this->deleteImageRequest($zone, $image_id, $contentType);
|
|
|
|
return $this->client
|
|
->sendAsync($request, $this->createHttpClientOption())
|
|
->then(
|
|
function ($response) use ($returnType) {
|
|
return [null, $response->getStatusCode(), $response->getHeaders()];
|
|
},
|
|
function ($exception) {
|
|
$response = $exception->getResponse();
|
|
$statusCode = $response->getStatusCode();
|
|
throw new ApiException(
|
|
sprintf(
|
|
'[%d] Error connecting to the API (%s)',
|
|
$statusCode,
|
|
$exception->getRequest()->getUri()
|
|
),
|
|
$statusCode,
|
|
$response->getHeaders(),
|
|
(string) $response->getBody()
|
|
);
|
|
}
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Create request for operation 'deleteImage'
|
|
*
|
|
* @param string $zone The zone you want to target (required)
|
|
* @param string $image_id UUID of the image you want to delete. (required)
|
|
* @param string $contentType The value for the Content-Type header. Check self::contentTypes['deleteImage'] to see the possible values for this operation
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @return \GuzzleHttp\Psr7\Request
|
|
*/
|
|
public function deleteImageRequest($zone, $image_id, string $contentType = self::contentTypes['deleteImage'][0])
|
|
{
|
|
|
|
// verify the required parameter 'zone' is set
|
|
if ($zone === null || (is_array($zone) && count($zone) === 0)) {
|
|
throw new \InvalidArgumentException(
|
|
'Missing the required parameter $zone when calling deleteImage'
|
|
);
|
|
}
|
|
|
|
// verify the required parameter 'image_id' is set
|
|
if ($image_id === null || (is_array($image_id) && count($image_id) === 0)) {
|
|
throw new \InvalidArgumentException(
|
|
'Missing the required parameter $image_id when calling deleteImage'
|
|
);
|
|
}
|
|
|
|
|
|
$resourcePath = '/instance/v1/zones/{zone}/images/{image_id}';
|
|
$formParams = [];
|
|
$queryParams = [];
|
|
$headerParams = [];
|
|
$httpBody = '';
|
|
$multipart = false;
|
|
|
|
|
|
|
|
// path params
|
|
if ($zone !== null) {
|
|
$resourcePath = str_replace(
|
|
'{' . 'zone' . '}',
|
|
ObjectSerializer::toPathValue($zone),
|
|
$resourcePath
|
|
);
|
|
}
|
|
// path params
|
|
if ($image_id !== null) {
|
|
$resourcePath = str_replace(
|
|
'{' . 'image_id' . '}',
|
|
ObjectSerializer::toPathValue($image_id),
|
|
$resourcePath
|
|
);
|
|
}
|
|
|
|
|
|
$headers = $this->headerSelector->selectHeaders(
|
|
[],
|
|
$contentType,
|
|
$multipart
|
|
);
|
|
|
|
// for model (json/xml)
|
|
if (count($formParams) > 0) {
|
|
if ($multipart) {
|
|
$multipartContents = [];
|
|
foreach ($formParams as $formParamName => $formParamValue) {
|
|
$formParamValueItems = is_array($formParamValue) ? $formParamValue : [$formParamValue];
|
|
foreach ($formParamValueItems as $formParamValueItem) {
|
|
$multipartContents[] = [
|
|
'name' => $formParamName,
|
|
'contents' => $formParamValueItem
|
|
];
|
|
}
|
|
}
|
|
// for HTTP post (form)
|
|
$httpBody = new MultipartStream($multipartContents);
|
|
|
|
} elseif (stripos($headers['Content-Type'], 'application/json') !== false) {
|
|
# if Content-Type contains "application/json", json_encode the form parameters
|
|
$httpBody = \GuzzleHttp\Utils::jsonEncode($formParams);
|
|
} else {
|
|
// for HTTP post (form)
|
|
$httpBody = ObjectSerializer::buildQuery($formParams);
|
|
}
|
|
}
|
|
|
|
// this endpoint requires API key authentication
|
|
$apiKey = $this->config->getApiKeyWithPrefix('X-Auth-Token');
|
|
if ($apiKey !== null) {
|
|
$headers['X-Auth-Token'] = $apiKey;
|
|
}
|
|
|
|
$defaultHeaders = [];
|
|
if ($this->config->getUserAgent()) {
|
|
$defaultHeaders['User-Agent'] = $this->config->getUserAgent();
|
|
}
|
|
|
|
$headers = array_merge(
|
|
$defaultHeaders,
|
|
$headerParams,
|
|
$headers
|
|
);
|
|
|
|
$operationHost = $this->config->getHost();
|
|
$query = ObjectSerializer::buildQuery($queryParams);
|
|
return new Request(
|
|
'DELETE',
|
|
$operationHost . $resourcePath . ($query ? "?{$query}" : ''),
|
|
$headers,
|
|
$httpBody
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Operation getImage
|
|
*
|
|
* Get an Instance image
|
|
*
|
|
* @param string $zone The zone you want to target (required)
|
|
* @param string $image_id UUID of the image you want to get. (required)
|
|
* @param string $contentType The value for the Content-Type header. Check self::contentTypes['getImage'] to see the possible values for this operation
|
|
*
|
|
* @throws \OpenAPI\Client\ApiException on non-2xx response or if the response body is not in the expected format
|
|
* @throws \InvalidArgumentException
|
|
* @return \OpenAPI\Client\Model\ScalewayInstanceV1GetImageResponse
|
|
*/
|
|
public function getImage($zone, $image_id, string $contentType = self::contentTypes['getImage'][0])
|
|
{
|
|
list($response) = $this->getImageWithHttpInfo($zone, $image_id, $contentType);
|
|
return $response;
|
|
}
|
|
|
|
/**
|
|
* Operation getImageWithHttpInfo
|
|
*
|
|
* Get an Instance image
|
|
*
|
|
* @param string $zone The zone you want to target (required)
|
|
* @param string $image_id UUID of the image you want to get. (required)
|
|
* @param string $contentType The value for the Content-Type header. Check self::contentTypes['getImage'] to see the possible values for this operation
|
|
*
|
|
* @throws \OpenAPI\Client\ApiException on non-2xx response or if the response body is not in the expected format
|
|
* @throws \InvalidArgumentException
|
|
* @return array of \OpenAPI\Client\Model\ScalewayInstanceV1GetImageResponse, HTTP status code, HTTP response headers (array of strings)
|
|
*/
|
|
public function getImageWithHttpInfo($zone, $image_id, string $contentType = self::contentTypes['getImage'][0])
|
|
{
|
|
$request = $this->getImageRequest($zone, $image_id, $contentType);
|
|
|
|
try {
|
|
$options = $this->createHttpClientOption();
|
|
try {
|
|
$response = $this->client->send($request, $options);
|
|
} catch (RequestException $e) {
|
|
throw new ApiException(
|
|
"[{$e->getCode()}] {$e->getMessage()}",
|
|
(int) $e->getCode(),
|
|
$e->getResponse() ? $e->getResponse()->getHeaders() : null,
|
|
$e->getResponse() ? (string) $e->getResponse()->getBody() : null
|
|
);
|
|
} catch (ConnectException $e) {
|
|
throw new ApiException(
|
|
"[{$e->getCode()}] {$e->getMessage()}",
|
|
(int) $e->getCode(),
|
|
null,
|
|
null
|
|
);
|
|
}
|
|
|
|
$statusCode = $response->getStatusCode();
|
|
|
|
|
|
switch($statusCode) {
|
|
case 200:
|
|
if ('\OpenAPI\Client\Model\ScalewayInstanceV1GetImageResponse' === '\SplFileObject') {
|
|
$content = $response->getBody(); //stream goes to serializer
|
|
} else {
|
|
$content = (string) $response->getBody();
|
|
if ('\OpenAPI\Client\Model\ScalewayInstanceV1GetImageResponse' !== 'string') {
|
|
try {
|
|
$content = json_decode($content, false, 512, JSON_THROW_ON_ERROR);
|
|
} catch (\JsonException $exception) {
|
|
throw new ApiException(
|
|
sprintf(
|
|
'Error JSON decoding server response (%s)',
|
|
$request->getUri()
|
|
),
|
|
$statusCode,
|
|
$response->getHeaders(),
|
|
$content
|
|
);
|
|
}
|
|
}
|
|
}
|
|
|
|
return [
|
|
ObjectSerializer::deserialize($content, '\OpenAPI\Client\Model\ScalewayInstanceV1GetImageResponse', []),
|
|
$response->getStatusCode(),
|
|
$response->getHeaders()
|
|
];
|
|
}
|
|
|
|
if ($statusCode < 200 || $statusCode > 299) {
|
|
throw new ApiException(
|
|
sprintf(
|
|
'[%d] Error connecting to the API (%s)',
|
|
$statusCode,
|
|
(string) $request->getUri()
|
|
),
|
|
$statusCode,
|
|
$response->getHeaders(),
|
|
(string) $response->getBody()
|
|
);
|
|
}
|
|
|
|
$returnType = '\OpenAPI\Client\Model\ScalewayInstanceV1GetImageResponse';
|
|
if ($returnType === '\SplFileObject') {
|
|
$content = $response->getBody(); //stream goes to serializer
|
|
} else {
|
|
$content = (string) $response->getBody();
|
|
if ($returnType !== 'string') {
|
|
try {
|
|
$content = json_decode($content, false, 512, JSON_THROW_ON_ERROR);
|
|
} catch (\JsonException $exception) {
|
|
throw new ApiException(
|
|
sprintf(
|
|
'Error JSON decoding server response (%s)',
|
|
$request->getUri()
|
|
),
|
|
$statusCode,
|
|
$response->getHeaders(),
|
|
$content
|
|
);
|
|
}
|
|
}
|
|
}
|
|
|
|
return [
|
|
ObjectSerializer::deserialize($content, $returnType, []),
|
|
$response->getStatusCode(),
|
|
$response->getHeaders()
|
|
];
|
|
|
|
} catch (ApiException $e) {
|
|
switch ($e->getCode()) {
|
|
case 200:
|
|
$data = ObjectSerializer::deserialize(
|
|
$e->getResponseBody(),
|
|
'\OpenAPI\Client\Model\ScalewayInstanceV1GetImageResponse',
|
|
$e->getResponseHeaders()
|
|
);
|
|
$e->setResponseObject($data);
|
|
break;
|
|
}
|
|
throw $e;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Operation getImageAsync
|
|
*
|
|
* Get an Instance image
|
|
*
|
|
* @param string $zone The zone you want to target (required)
|
|
* @param string $image_id UUID of the image you want to get. (required)
|
|
* @param string $contentType The value for the Content-Type header. Check self::contentTypes['getImage'] to see the possible values for this operation
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @return \GuzzleHttp\Promise\PromiseInterface
|
|
*/
|
|
public function getImageAsync($zone, $image_id, string $contentType = self::contentTypes['getImage'][0])
|
|
{
|
|
return $this->getImageAsyncWithHttpInfo($zone, $image_id, $contentType)
|
|
->then(
|
|
function ($response) {
|
|
return $response[0];
|
|
}
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Operation getImageAsyncWithHttpInfo
|
|
*
|
|
* Get an Instance image
|
|
*
|
|
* @param string $zone The zone you want to target (required)
|
|
* @param string $image_id UUID of the image you want to get. (required)
|
|
* @param string $contentType The value for the Content-Type header. Check self::contentTypes['getImage'] to see the possible values for this operation
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @return \GuzzleHttp\Promise\PromiseInterface
|
|
*/
|
|
public function getImageAsyncWithHttpInfo($zone, $image_id, string $contentType = self::contentTypes['getImage'][0])
|
|
{
|
|
$returnType = '\OpenAPI\Client\Model\ScalewayInstanceV1GetImageResponse';
|
|
$request = $this->getImageRequest($zone, $image_id, $contentType);
|
|
|
|
return $this->client
|
|
->sendAsync($request, $this->createHttpClientOption())
|
|
->then(
|
|
function ($response) use ($returnType) {
|
|
if ($returnType === '\SplFileObject') {
|
|
$content = $response->getBody(); //stream goes to serializer
|
|
} else {
|
|
$content = (string) $response->getBody();
|
|
if ($returnType !== 'string') {
|
|
$content = json_decode($content);
|
|
}
|
|
}
|
|
|
|
return [
|
|
ObjectSerializer::deserialize($content, $returnType, []),
|
|
$response->getStatusCode(),
|
|
$response->getHeaders()
|
|
];
|
|
},
|
|
function ($exception) {
|
|
$response = $exception->getResponse();
|
|
$statusCode = $response->getStatusCode();
|
|
throw new ApiException(
|
|
sprintf(
|
|
'[%d] Error connecting to the API (%s)',
|
|
$statusCode,
|
|
$exception->getRequest()->getUri()
|
|
),
|
|
$statusCode,
|
|
$response->getHeaders(),
|
|
(string) $response->getBody()
|
|
);
|
|
}
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Create request for operation 'getImage'
|
|
*
|
|
* @param string $zone The zone you want to target (required)
|
|
* @param string $image_id UUID of the image you want to get. (required)
|
|
* @param string $contentType The value for the Content-Type header. Check self::contentTypes['getImage'] to see the possible values for this operation
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @return \GuzzleHttp\Psr7\Request
|
|
*/
|
|
public function getImageRequest($zone, $image_id, string $contentType = self::contentTypes['getImage'][0])
|
|
{
|
|
|
|
// verify the required parameter 'zone' is set
|
|
if ($zone === null || (is_array($zone) && count($zone) === 0)) {
|
|
throw new \InvalidArgumentException(
|
|
'Missing the required parameter $zone when calling getImage'
|
|
);
|
|
}
|
|
|
|
// verify the required parameter 'image_id' is set
|
|
if ($image_id === null || (is_array($image_id) && count($image_id) === 0)) {
|
|
throw new \InvalidArgumentException(
|
|
'Missing the required parameter $image_id when calling getImage'
|
|
);
|
|
}
|
|
|
|
|
|
$resourcePath = '/instance/v1/zones/{zone}/images/{image_id}';
|
|
$formParams = [];
|
|
$queryParams = [];
|
|
$headerParams = [];
|
|
$httpBody = '';
|
|
$multipart = false;
|
|
|
|
|
|
|
|
// path params
|
|
if ($zone !== null) {
|
|
$resourcePath = str_replace(
|
|
'{' . 'zone' . '}',
|
|
ObjectSerializer::toPathValue($zone),
|
|
$resourcePath
|
|
);
|
|
}
|
|
// path params
|
|
if ($image_id !== null) {
|
|
$resourcePath = str_replace(
|
|
'{' . 'image_id' . '}',
|
|
ObjectSerializer::toPathValue($image_id),
|
|
$resourcePath
|
|
);
|
|
}
|
|
|
|
|
|
$headers = $this->headerSelector->selectHeaders(
|
|
['application/json', ],
|
|
$contentType,
|
|
$multipart
|
|
);
|
|
|
|
// for model (json/xml)
|
|
if (count($formParams) > 0) {
|
|
if ($multipart) {
|
|
$multipartContents = [];
|
|
foreach ($formParams as $formParamName => $formParamValue) {
|
|
$formParamValueItems = is_array($formParamValue) ? $formParamValue : [$formParamValue];
|
|
foreach ($formParamValueItems as $formParamValueItem) {
|
|
$multipartContents[] = [
|
|
'name' => $formParamName,
|
|
'contents' => $formParamValueItem
|
|
];
|
|
}
|
|
}
|
|
// for HTTP post (form)
|
|
$httpBody = new MultipartStream($multipartContents);
|
|
|
|
} elseif (stripos($headers['Content-Type'], 'application/json') !== false) {
|
|
# if Content-Type contains "application/json", json_encode the form parameters
|
|
$httpBody = \GuzzleHttp\Utils::jsonEncode($formParams);
|
|
} else {
|
|
// for HTTP post (form)
|
|
$httpBody = ObjectSerializer::buildQuery($formParams);
|
|
}
|
|
}
|
|
|
|
// this endpoint requires API key authentication
|
|
$apiKey = $this->config->getApiKeyWithPrefix('X-Auth-Token');
|
|
if ($apiKey !== null) {
|
|
$headers['X-Auth-Token'] = $apiKey;
|
|
}
|
|
|
|
$defaultHeaders = [];
|
|
if ($this->config->getUserAgent()) {
|
|
$defaultHeaders['User-Agent'] = $this->config->getUserAgent();
|
|
}
|
|
|
|
$headers = array_merge(
|
|
$defaultHeaders,
|
|
$headerParams,
|
|
$headers
|
|
);
|
|
|
|
$operationHost = $this->config->getHost();
|
|
$query = ObjectSerializer::buildQuery($queryParams);
|
|
return new Request(
|
|
'GET',
|
|
$operationHost . $resourcePath . ($query ? "?{$query}" : ''),
|
|
$headers,
|
|
$httpBody
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Operation listImages
|
|
*
|
|
* List Instance images
|
|
*
|
|
* @param string $zone The zone you want to target (required)
|
|
* @param string|null $organization organization (optional)
|
|
* @param int|null $per_page per_page (optional)
|
|
* @param int|null $page page (optional)
|
|
* @param string|null $name name (optional)
|
|
* @param bool|null $public public (optional)
|
|
* @param string|null $arch arch (optional)
|
|
* @param string|null $project project (optional)
|
|
* @param string|null $tags tags (optional)
|
|
* @param string $contentType The value for the Content-Type header. Check self::contentTypes['listImages'] to see the possible values for this operation
|
|
*
|
|
* @throws \OpenAPI\Client\ApiException on non-2xx response or if the response body is not in the expected format
|
|
* @throws \InvalidArgumentException
|
|
* @return \OpenAPI\Client\Model\ScalewayInstanceV1ListImagesResponse
|
|
*/
|
|
public function listImages($zone, $organization = null, $per_page = null, $page = null, $name = null, $public = null, $arch = null, $project = null, $tags = null, string $contentType = self::contentTypes['listImages'][0])
|
|
{
|
|
list($response) = $this->listImagesWithHttpInfo($zone, $organization, $per_page, $page, $name, $public, $arch, $project, $tags, $contentType);
|
|
return $response;
|
|
}
|
|
|
|
/**
|
|
* Operation listImagesWithHttpInfo
|
|
*
|
|
* List Instance images
|
|
*
|
|
* @param string $zone The zone you want to target (required)
|
|
* @param string|null $organization (optional)
|
|
* @param int|null $per_page (optional)
|
|
* @param int|null $page (optional)
|
|
* @param string|null $name (optional)
|
|
* @param bool|null $public (optional)
|
|
* @param string|null $arch (optional)
|
|
* @param string|null $project (optional)
|
|
* @param string|null $tags (optional)
|
|
* @param string $contentType The value for the Content-Type header. Check self::contentTypes['listImages'] to see the possible values for this operation
|
|
*
|
|
* @throws \OpenAPI\Client\ApiException on non-2xx response or if the response body is not in the expected format
|
|
* @throws \InvalidArgumentException
|
|
* @return array of \OpenAPI\Client\Model\ScalewayInstanceV1ListImagesResponse, HTTP status code, HTTP response headers (array of strings)
|
|
*/
|
|
public function listImagesWithHttpInfo($zone, $organization = null, $per_page = null, $page = null, $name = null, $public = null, $arch = null, $project = null, $tags = null, string $contentType = self::contentTypes['listImages'][0])
|
|
{
|
|
$request = $this->listImagesRequest($zone, $organization, $per_page, $page, $name, $public, $arch, $project, $tags, $contentType);
|
|
|
|
try {
|
|
$options = $this->createHttpClientOption();
|
|
try {
|
|
$response = $this->client->send($request, $options);
|
|
} catch (RequestException $e) {
|
|
throw new ApiException(
|
|
"[{$e->getCode()}] {$e->getMessage()}",
|
|
(int) $e->getCode(),
|
|
$e->getResponse() ? $e->getResponse()->getHeaders() : null,
|
|
$e->getResponse() ? (string) $e->getResponse()->getBody() : null
|
|
);
|
|
} catch (ConnectException $e) {
|
|
throw new ApiException(
|
|
"[{$e->getCode()}] {$e->getMessage()}",
|
|
(int) $e->getCode(),
|
|
null,
|
|
null
|
|
);
|
|
}
|
|
|
|
$statusCode = $response->getStatusCode();
|
|
|
|
|
|
switch($statusCode) {
|
|
case 200:
|
|
if ('\OpenAPI\Client\Model\ScalewayInstanceV1ListImagesResponse' === '\SplFileObject') {
|
|
$content = $response->getBody(); //stream goes to serializer
|
|
} else {
|
|
$content = (string) $response->getBody();
|
|
if ('\OpenAPI\Client\Model\ScalewayInstanceV1ListImagesResponse' !== 'string') {
|
|
try {
|
|
$content = json_decode($content, false, 512, JSON_THROW_ON_ERROR);
|
|
} catch (\JsonException $exception) {
|
|
throw new ApiException(
|
|
sprintf(
|
|
'Error JSON decoding server response (%s)',
|
|
$request->getUri()
|
|
),
|
|
$statusCode,
|
|
$response->getHeaders(),
|
|
$content
|
|
);
|
|
}
|
|
}
|
|
}
|
|
|
|
return [
|
|
ObjectSerializer::deserialize($content, '\OpenAPI\Client\Model\ScalewayInstanceV1ListImagesResponse', []),
|
|
$response->getStatusCode(),
|
|
$response->getHeaders()
|
|
];
|
|
}
|
|
|
|
if ($statusCode < 200 || $statusCode > 299) {
|
|
throw new ApiException(
|
|
sprintf(
|
|
'[%d] Error connecting to the API (%s)',
|
|
$statusCode,
|
|
(string) $request->getUri()
|
|
),
|
|
$statusCode,
|
|
$response->getHeaders(),
|
|
(string) $response->getBody()
|
|
);
|
|
}
|
|
|
|
$returnType = '\OpenAPI\Client\Model\ScalewayInstanceV1ListImagesResponse';
|
|
if ($returnType === '\SplFileObject') {
|
|
$content = $response->getBody(); //stream goes to serializer
|
|
} else {
|
|
$content = (string) $response->getBody();
|
|
if ($returnType !== 'string') {
|
|
try {
|
|
$content = json_decode($content, false, 512, JSON_THROW_ON_ERROR);
|
|
} catch (\JsonException $exception) {
|
|
throw new ApiException(
|
|
sprintf(
|
|
'Error JSON decoding server response (%s)',
|
|
$request->getUri()
|
|
),
|
|
$statusCode,
|
|
$response->getHeaders(),
|
|
$content
|
|
);
|
|
}
|
|
}
|
|
}
|
|
|
|
return [
|
|
ObjectSerializer::deserialize($content, $returnType, []),
|
|
$response->getStatusCode(),
|
|
$response->getHeaders()
|
|
];
|
|
|
|
} catch (ApiException $e) {
|
|
switch ($e->getCode()) {
|
|
case 200:
|
|
$data = ObjectSerializer::deserialize(
|
|
$e->getResponseBody(),
|
|
'\OpenAPI\Client\Model\ScalewayInstanceV1ListImagesResponse',
|
|
$e->getResponseHeaders()
|
|
);
|
|
$e->setResponseObject($data);
|
|
break;
|
|
}
|
|
throw $e;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Operation listImagesAsync
|
|
*
|
|
* List Instance images
|
|
*
|
|
* @param string $zone The zone you want to target (required)
|
|
* @param string|null $organization (optional)
|
|
* @param int|null $per_page (optional)
|
|
* @param int|null $page (optional)
|
|
* @param string|null $name (optional)
|
|
* @param bool|null $public (optional)
|
|
* @param string|null $arch (optional)
|
|
* @param string|null $project (optional)
|
|
* @param string|null $tags (optional)
|
|
* @param string $contentType The value for the Content-Type header. Check self::contentTypes['listImages'] to see the possible values for this operation
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @return \GuzzleHttp\Promise\PromiseInterface
|
|
*/
|
|
public function listImagesAsync($zone, $organization = null, $per_page = null, $page = null, $name = null, $public = null, $arch = null, $project = null, $tags = null, string $contentType = self::contentTypes['listImages'][0])
|
|
{
|
|
return $this->listImagesAsyncWithHttpInfo($zone, $organization, $per_page, $page, $name, $public, $arch, $project, $tags, $contentType)
|
|
->then(
|
|
function ($response) {
|
|
return $response[0];
|
|
}
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Operation listImagesAsyncWithHttpInfo
|
|
*
|
|
* List Instance images
|
|
*
|
|
* @param string $zone The zone you want to target (required)
|
|
* @param string|null $organization (optional)
|
|
* @param int|null $per_page (optional)
|
|
* @param int|null $page (optional)
|
|
* @param string|null $name (optional)
|
|
* @param bool|null $public (optional)
|
|
* @param string|null $arch (optional)
|
|
* @param string|null $project (optional)
|
|
* @param string|null $tags (optional)
|
|
* @param string $contentType The value for the Content-Type header. Check self::contentTypes['listImages'] to see the possible values for this operation
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @return \GuzzleHttp\Promise\PromiseInterface
|
|
*/
|
|
public function listImagesAsyncWithHttpInfo($zone, $organization = null, $per_page = null, $page = null, $name = null, $public = null, $arch = null, $project = null, $tags = null, string $contentType = self::contentTypes['listImages'][0])
|
|
{
|
|
$returnType = '\OpenAPI\Client\Model\ScalewayInstanceV1ListImagesResponse';
|
|
$request = $this->listImagesRequest($zone, $organization, $per_page, $page, $name, $public, $arch, $project, $tags, $contentType);
|
|
|
|
return $this->client
|
|
->sendAsync($request, $this->createHttpClientOption())
|
|
->then(
|
|
function ($response) use ($returnType) {
|
|
if ($returnType === '\SplFileObject') {
|
|
$content = $response->getBody(); //stream goes to serializer
|
|
} else {
|
|
$content = (string) $response->getBody();
|
|
if ($returnType !== 'string') {
|
|
$content = json_decode($content);
|
|
}
|
|
}
|
|
|
|
return [
|
|
ObjectSerializer::deserialize($content, $returnType, []),
|
|
$response->getStatusCode(),
|
|
$response->getHeaders()
|
|
];
|
|
},
|
|
function ($exception) {
|
|
$response = $exception->getResponse();
|
|
$statusCode = $response->getStatusCode();
|
|
throw new ApiException(
|
|
sprintf(
|
|
'[%d] Error connecting to the API (%s)',
|
|
$statusCode,
|
|
$exception->getRequest()->getUri()
|
|
),
|
|
$statusCode,
|
|
$response->getHeaders(),
|
|
(string) $response->getBody()
|
|
);
|
|
}
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Create request for operation 'listImages'
|
|
*
|
|
* @param string $zone The zone you want to target (required)
|
|
* @param string|null $organization (optional)
|
|
* @param int|null $per_page (optional)
|
|
* @param int|null $page (optional)
|
|
* @param string|null $name (optional)
|
|
* @param bool|null $public (optional)
|
|
* @param string|null $arch (optional)
|
|
* @param string|null $project (optional)
|
|
* @param string|null $tags (optional)
|
|
* @param string $contentType The value for the Content-Type header. Check self::contentTypes['listImages'] to see the possible values for this operation
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @return \GuzzleHttp\Psr7\Request
|
|
*/
|
|
public function listImagesRequest($zone, $organization = null, $per_page = null, $page = null, $name = null, $public = null, $arch = null, $project = null, $tags = null, string $contentType = self::contentTypes['listImages'][0])
|
|
{
|
|
|
|
// verify the required parameter 'zone' is set
|
|
if ($zone === null || (is_array($zone) && count($zone) === 0)) {
|
|
throw new \InvalidArgumentException(
|
|
'Missing the required parameter $zone when calling listImages'
|
|
);
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
$resourcePath = '/instance/v1/zones/{zone}/images';
|
|
$formParams = [];
|
|
$queryParams = [];
|
|
$headerParams = [];
|
|
$httpBody = '';
|
|
$multipart = false;
|
|
|
|
// query params
|
|
$queryParams = array_merge($queryParams, ObjectSerializer::toQueryValue(
|
|
$organization,
|
|
'organization', // param base name
|
|
'string', // openApiType
|
|
'form', // style
|
|
true, // explode
|
|
false // required
|
|
) ?? []);
|
|
// query params
|
|
$queryParams = array_merge($queryParams, ObjectSerializer::toQueryValue(
|
|
$per_page,
|
|
'per_page', // param base name
|
|
'integer', // openApiType
|
|
'form', // style
|
|
true, // explode
|
|
false // required
|
|
) ?? []);
|
|
// query params
|
|
$queryParams = array_merge($queryParams, ObjectSerializer::toQueryValue(
|
|
$page,
|
|
'page', // param base name
|
|
'integer', // openApiType
|
|
'form', // style
|
|
true, // explode
|
|
false // required
|
|
) ?? []);
|
|
// query params
|
|
$queryParams = array_merge($queryParams, ObjectSerializer::toQueryValue(
|
|
$name,
|
|
'name', // param base name
|
|
'string', // openApiType
|
|
'form', // style
|
|
true, // explode
|
|
false // required
|
|
) ?? []);
|
|
// query params
|
|
$queryParams = array_merge($queryParams, ObjectSerializer::toQueryValue(
|
|
$public,
|
|
'public', // param base name
|
|
'boolean', // openApiType
|
|
'form', // style
|
|
true, // explode
|
|
false // required
|
|
) ?? []);
|
|
// query params
|
|
$queryParams = array_merge($queryParams, ObjectSerializer::toQueryValue(
|
|
$arch,
|
|
'arch', // param base name
|
|
'string', // openApiType
|
|
'form', // style
|
|
true, // explode
|
|
false // required
|
|
) ?? []);
|
|
// query params
|
|
$queryParams = array_merge($queryParams, ObjectSerializer::toQueryValue(
|
|
$project,
|
|
'project', // param base name
|
|
'string', // openApiType
|
|
'form', // style
|
|
true, // explode
|
|
false // required
|
|
) ?? []);
|
|
// query params
|
|
$queryParams = array_merge($queryParams, ObjectSerializer::toQueryValue(
|
|
$tags,
|
|
'tags', // param base name
|
|
'string', // openApiType
|
|
'form', // style
|
|
true, // explode
|
|
false // required
|
|
) ?? []);
|
|
|
|
|
|
// path params
|
|
if ($zone !== null) {
|
|
$resourcePath = str_replace(
|
|
'{' . 'zone' . '}',
|
|
ObjectSerializer::toPathValue($zone),
|
|
$resourcePath
|
|
);
|
|
}
|
|
|
|
|
|
$headers = $this->headerSelector->selectHeaders(
|
|
['application/json', ],
|
|
$contentType,
|
|
$multipart
|
|
);
|
|
|
|
// for model (json/xml)
|
|
if (count($formParams) > 0) {
|
|
if ($multipart) {
|
|
$multipartContents = [];
|
|
foreach ($formParams as $formParamName => $formParamValue) {
|
|
$formParamValueItems = is_array($formParamValue) ? $formParamValue : [$formParamValue];
|
|
foreach ($formParamValueItems as $formParamValueItem) {
|
|
$multipartContents[] = [
|
|
'name' => $formParamName,
|
|
'contents' => $formParamValueItem
|
|
];
|
|
}
|
|
}
|
|
// for HTTP post (form)
|
|
$httpBody = new MultipartStream($multipartContents);
|
|
|
|
} elseif (stripos($headers['Content-Type'], 'application/json') !== false) {
|
|
# if Content-Type contains "application/json", json_encode the form parameters
|
|
$httpBody = \GuzzleHttp\Utils::jsonEncode($formParams);
|
|
} else {
|
|
// for HTTP post (form)
|
|
$httpBody = ObjectSerializer::buildQuery($formParams);
|
|
}
|
|
}
|
|
|
|
// this endpoint requires API key authentication
|
|
$apiKey = $this->config->getApiKeyWithPrefix('X-Auth-Token');
|
|
if ($apiKey !== null) {
|
|
$headers['X-Auth-Token'] = $apiKey;
|
|
}
|
|
|
|
$defaultHeaders = [];
|
|
if ($this->config->getUserAgent()) {
|
|
$defaultHeaders['User-Agent'] = $this->config->getUserAgent();
|
|
}
|
|
|
|
$headers = array_merge(
|
|
$defaultHeaders,
|
|
$headerParams,
|
|
$headers
|
|
);
|
|
|
|
$operationHost = $this->config->getHost();
|
|
$query = ObjectSerializer::buildQuery($queryParams);
|
|
return new Request(
|
|
'GET',
|
|
$operationHost . $resourcePath . ($query ? "?{$query}" : ''),
|
|
$headers,
|
|
$httpBody
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Operation setImage
|
|
*
|
|
* Update image
|
|
*
|
|
* @param string $zone The zone you want to target (required)
|
|
* @param string $id id (required)
|
|
* @param \OpenAPI\Client\Model\SetImageRequest $set_image_request set_image_request (required)
|
|
* @param string $contentType The value for the Content-Type header. Check self::contentTypes['setImage'] to see the possible values for this operation
|
|
*
|
|
* @throws \OpenAPI\Client\ApiException on non-2xx response or if the response body is not in the expected format
|
|
* @throws \InvalidArgumentException
|
|
* @return \OpenAPI\Client\Model\ScalewayInstanceV1SetImageResponse
|
|
*/
|
|
public function setImage($zone, $id, $set_image_request, string $contentType = self::contentTypes['setImage'][0])
|
|
{
|
|
list($response) = $this->setImageWithHttpInfo($zone, $id, $set_image_request, $contentType);
|
|
return $response;
|
|
}
|
|
|
|
/**
|
|
* Operation setImageWithHttpInfo
|
|
*
|
|
* Update image
|
|
*
|
|
* @param string $zone The zone you want to target (required)
|
|
* @param string $id (required)
|
|
* @param \OpenAPI\Client\Model\SetImageRequest $set_image_request (required)
|
|
* @param string $contentType The value for the Content-Type header. Check self::contentTypes['setImage'] to see the possible values for this operation
|
|
*
|
|
* @throws \OpenAPI\Client\ApiException on non-2xx response or if the response body is not in the expected format
|
|
* @throws \InvalidArgumentException
|
|
* @return array of \OpenAPI\Client\Model\ScalewayInstanceV1SetImageResponse, HTTP status code, HTTP response headers (array of strings)
|
|
*/
|
|
public function setImageWithHttpInfo($zone, $id, $set_image_request, string $contentType = self::contentTypes['setImage'][0])
|
|
{
|
|
$request = $this->setImageRequest($zone, $id, $set_image_request, $contentType);
|
|
|
|
try {
|
|
$options = $this->createHttpClientOption();
|
|
try {
|
|
$response = $this->client->send($request, $options);
|
|
} catch (RequestException $e) {
|
|
throw new ApiException(
|
|
"[{$e->getCode()}] {$e->getMessage()}",
|
|
(int) $e->getCode(),
|
|
$e->getResponse() ? $e->getResponse()->getHeaders() : null,
|
|
$e->getResponse() ? (string) $e->getResponse()->getBody() : null
|
|
);
|
|
} catch (ConnectException $e) {
|
|
throw new ApiException(
|
|
"[{$e->getCode()}] {$e->getMessage()}",
|
|
(int) $e->getCode(),
|
|
null,
|
|
null
|
|
);
|
|
}
|
|
|
|
$statusCode = $response->getStatusCode();
|
|
|
|
|
|
switch($statusCode) {
|
|
case 200:
|
|
if ('\OpenAPI\Client\Model\ScalewayInstanceV1SetImageResponse' === '\SplFileObject') {
|
|
$content = $response->getBody(); //stream goes to serializer
|
|
} else {
|
|
$content = (string) $response->getBody();
|
|
if ('\OpenAPI\Client\Model\ScalewayInstanceV1SetImageResponse' !== 'string') {
|
|
try {
|
|
$content = json_decode($content, false, 512, JSON_THROW_ON_ERROR);
|
|
} catch (\JsonException $exception) {
|
|
throw new ApiException(
|
|
sprintf(
|
|
'Error JSON decoding server response (%s)',
|
|
$request->getUri()
|
|
),
|
|
$statusCode,
|
|
$response->getHeaders(),
|
|
$content
|
|
);
|
|
}
|
|
}
|
|
}
|
|
|
|
return [
|
|
ObjectSerializer::deserialize($content, '\OpenAPI\Client\Model\ScalewayInstanceV1SetImageResponse', []),
|
|
$response->getStatusCode(),
|
|
$response->getHeaders()
|
|
];
|
|
}
|
|
|
|
if ($statusCode < 200 || $statusCode > 299) {
|
|
throw new ApiException(
|
|
sprintf(
|
|
'[%d] Error connecting to the API (%s)',
|
|
$statusCode,
|
|
(string) $request->getUri()
|
|
),
|
|
$statusCode,
|
|
$response->getHeaders(),
|
|
(string) $response->getBody()
|
|
);
|
|
}
|
|
|
|
$returnType = '\OpenAPI\Client\Model\ScalewayInstanceV1SetImageResponse';
|
|
if ($returnType === '\SplFileObject') {
|
|
$content = $response->getBody(); //stream goes to serializer
|
|
} else {
|
|
$content = (string) $response->getBody();
|
|
if ($returnType !== 'string') {
|
|
try {
|
|
$content = json_decode($content, false, 512, JSON_THROW_ON_ERROR);
|
|
} catch (\JsonException $exception) {
|
|
throw new ApiException(
|
|
sprintf(
|
|
'Error JSON decoding server response (%s)',
|
|
$request->getUri()
|
|
),
|
|
$statusCode,
|
|
$response->getHeaders(),
|
|
$content
|
|
);
|
|
}
|
|
}
|
|
}
|
|
|
|
return [
|
|
ObjectSerializer::deserialize($content, $returnType, []),
|
|
$response->getStatusCode(),
|
|
$response->getHeaders()
|
|
];
|
|
|
|
} catch (ApiException $e) {
|
|
switch ($e->getCode()) {
|
|
case 200:
|
|
$data = ObjectSerializer::deserialize(
|
|
$e->getResponseBody(),
|
|
'\OpenAPI\Client\Model\ScalewayInstanceV1SetImageResponse',
|
|
$e->getResponseHeaders()
|
|
);
|
|
$e->setResponseObject($data);
|
|
break;
|
|
}
|
|
throw $e;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Operation setImageAsync
|
|
*
|
|
* Update image
|
|
*
|
|
* @param string $zone The zone you want to target (required)
|
|
* @param string $id (required)
|
|
* @param \OpenAPI\Client\Model\SetImageRequest $set_image_request (required)
|
|
* @param string $contentType The value for the Content-Type header. Check self::contentTypes['setImage'] to see the possible values for this operation
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @return \GuzzleHttp\Promise\PromiseInterface
|
|
*/
|
|
public function setImageAsync($zone, $id, $set_image_request, string $contentType = self::contentTypes['setImage'][0])
|
|
{
|
|
return $this->setImageAsyncWithHttpInfo($zone, $id, $set_image_request, $contentType)
|
|
->then(
|
|
function ($response) {
|
|
return $response[0];
|
|
}
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Operation setImageAsyncWithHttpInfo
|
|
*
|
|
* Update image
|
|
*
|
|
* @param string $zone The zone you want to target (required)
|
|
* @param string $id (required)
|
|
* @param \OpenAPI\Client\Model\SetImageRequest $set_image_request (required)
|
|
* @param string $contentType The value for the Content-Type header. Check self::contentTypes['setImage'] to see the possible values for this operation
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @return \GuzzleHttp\Promise\PromiseInterface
|
|
*/
|
|
public function setImageAsyncWithHttpInfo($zone, $id, $set_image_request, string $contentType = self::contentTypes['setImage'][0])
|
|
{
|
|
$returnType = '\OpenAPI\Client\Model\ScalewayInstanceV1SetImageResponse';
|
|
$request = $this->setImageRequest($zone, $id, $set_image_request, $contentType);
|
|
|
|
return $this->client
|
|
->sendAsync($request, $this->createHttpClientOption())
|
|
->then(
|
|
function ($response) use ($returnType) {
|
|
if ($returnType === '\SplFileObject') {
|
|
$content = $response->getBody(); //stream goes to serializer
|
|
} else {
|
|
$content = (string) $response->getBody();
|
|
if ($returnType !== 'string') {
|
|
$content = json_decode($content);
|
|
}
|
|
}
|
|
|
|
return [
|
|
ObjectSerializer::deserialize($content, $returnType, []),
|
|
$response->getStatusCode(),
|
|
$response->getHeaders()
|
|
];
|
|
},
|
|
function ($exception) {
|
|
$response = $exception->getResponse();
|
|
$statusCode = $response->getStatusCode();
|
|
throw new ApiException(
|
|
sprintf(
|
|
'[%d] Error connecting to the API (%s)',
|
|
$statusCode,
|
|
$exception->getRequest()->getUri()
|
|
),
|
|
$statusCode,
|
|
$response->getHeaders(),
|
|
(string) $response->getBody()
|
|
);
|
|
}
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Create request for operation 'setImage'
|
|
*
|
|
* @param string $zone The zone you want to target (required)
|
|
* @param string $id (required)
|
|
* @param \OpenAPI\Client\Model\SetImageRequest $set_image_request (required)
|
|
* @param string $contentType The value for the Content-Type header. Check self::contentTypes['setImage'] to see the possible values for this operation
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @return \GuzzleHttp\Psr7\Request
|
|
*/
|
|
public function setImageRequest($zone, $id, $set_image_request, string $contentType = self::contentTypes['setImage'][0])
|
|
{
|
|
|
|
// verify the required parameter 'zone' is set
|
|
if ($zone === null || (is_array($zone) && count($zone) === 0)) {
|
|
throw new \InvalidArgumentException(
|
|
'Missing the required parameter $zone when calling setImage'
|
|
);
|
|
}
|
|
|
|
// verify the required parameter 'id' is set
|
|
if ($id === null || (is_array($id) && count($id) === 0)) {
|
|
throw new \InvalidArgumentException(
|
|
'Missing the required parameter $id when calling setImage'
|
|
);
|
|
}
|
|
|
|
// verify the required parameter 'set_image_request' is set
|
|
if ($set_image_request === null || (is_array($set_image_request) && count($set_image_request) === 0)) {
|
|
throw new \InvalidArgumentException(
|
|
'Missing the required parameter $set_image_request when calling setImage'
|
|
);
|
|
}
|
|
|
|
|
|
$resourcePath = '/instance/v1/zones/{zone}/images/{id}';
|
|
$formParams = [];
|
|
$queryParams = [];
|
|
$headerParams = [];
|
|
$httpBody = '';
|
|
$multipart = false;
|
|
|
|
|
|
|
|
// path params
|
|
if ($zone !== null) {
|
|
$resourcePath = str_replace(
|
|
'{' . 'zone' . '}',
|
|
ObjectSerializer::toPathValue($zone),
|
|
$resourcePath
|
|
);
|
|
}
|
|
// path params
|
|
if ($id !== null) {
|
|
$resourcePath = str_replace(
|
|
'{' . 'id' . '}',
|
|
ObjectSerializer::toPathValue($id),
|
|
$resourcePath
|
|
);
|
|
}
|
|
|
|
|
|
$headers = $this->headerSelector->selectHeaders(
|
|
['application/json', ],
|
|
$contentType,
|
|
$multipart
|
|
);
|
|
|
|
// for model (json/xml)
|
|
if (isset($set_image_request)) {
|
|
if (stripos($headers['Content-Type'], 'application/json') !== false) {
|
|
# if Content-Type contains "application/json", json_encode the body
|
|
$httpBody = \GuzzleHttp\Utils::jsonEncode(ObjectSerializer::sanitizeForSerialization($set_image_request));
|
|
} else {
|
|
$httpBody = $set_image_request;
|
|
}
|
|
} elseif (count($formParams) > 0) {
|
|
if ($multipart) {
|
|
$multipartContents = [];
|
|
foreach ($formParams as $formParamName => $formParamValue) {
|
|
$formParamValueItems = is_array($formParamValue) ? $formParamValue : [$formParamValue];
|
|
foreach ($formParamValueItems as $formParamValueItem) {
|
|
$multipartContents[] = [
|
|
'name' => $formParamName,
|
|
'contents' => $formParamValueItem
|
|
];
|
|
}
|
|
}
|
|
// for HTTP post (form)
|
|
$httpBody = new MultipartStream($multipartContents);
|
|
|
|
} elseif (stripos($headers['Content-Type'], 'application/json') !== false) {
|
|
# if Content-Type contains "application/json", json_encode the form parameters
|
|
$httpBody = \GuzzleHttp\Utils::jsonEncode($formParams);
|
|
} else {
|
|
// for HTTP post (form)
|
|
$httpBody = ObjectSerializer::buildQuery($formParams);
|
|
}
|
|
}
|
|
|
|
// this endpoint requires API key authentication
|
|
$apiKey = $this->config->getApiKeyWithPrefix('X-Auth-Token');
|
|
if ($apiKey !== null) {
|
|
$headers['X-Auth-Token'] = $apiKey;
|
|
}
|
|
|
|
$defaultHeaders = [];
|
|
if ($this->config->getUserAgent()) {
|
|
$defaultHeaders['User-Agent'] = $this->config->getUserAgent();
|
|
}
|
|
|
|
$headers = array_merge(
|
|
$defaultHeaders,
|
|
$headerParams,
|
|
$headers
|
|
);
|
|
|
|
$operationHost = $this->config->getHost();
|
|
$query = ObjectSerializer::buildQuery($queryParams);
|
|
return new Request(
|
|
'PUT',
|
|
$operationHost . $resourcePath . ($query ? "?{$query}" : ''),
|
|
$headers,
|
|
$httpBody
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Operation updateImage
|
|
*
|
|
* Update image
|
|
*
|
|
* @param string $zone The zone you want to target (required)
|
|
* @param string $image_id UUID of the image. (UUID format) (required)
|
|
* @param \OpenAPI\Client\Model\UpdateImageRequest $update_image_request update_image_request (required)
|
|
* @param string $contentType The value for the Content-Type header. Check self::contentTypes['updateImage'] to see the possible values for this operation
|
|
*
|
|
* @throws \OpenAPI\Client\ApiException on non-2xx response or if the response body is not in the expected format
|
|
* @throws \InvalidArgumentException
|
|
* @return \OpenAPI\Client\Model\ScalewayInstanceV1UpdateImageResponse
|
|
*/
|
|
public function updateImage($zone, $image_id, $update_image_request, string $contentType = self::contentTypes['updateImage'][0])
|
|
{
|
|
list($response) = $this->updateImageWithHttpInfo($zone, $image_id, $update_image_request, $contentType);
|
|
return $response;
|
|
}
|
|
|
|
/**
|
|
* Operation updateImageWithHttpInfo
|
|
*
|
|
* Update image
|
|
*
|
|
* @param string $zone The zone you want to target (required)
|
|
* @param string $image_id UUID of the image. (UUID format) (required)
|
|
* @param \OpenAPI\Client\Model\UpdateImageRequest $update_image_request (required)
|
|
* @param string $contentType The value for the Content-Type header. Check self::contentTypes['updateImage'] to see the possible values for this operation
|
|
*
|
|
* @throws \OpenAPI\Client\ApiException on non-2xx response or if the response body is not in the expected format
|
|
* @throws \InvalidArgumentException
|
|
* @return array of \OpenAPI\Client\Model\ScalewayInstanceV1UpdateImageResponse, HTTP status code, HTTP response headers (array of strings)
|
|
*/
|
|
public function updateImageWithHttpInfo($zone, $image_id, $update_image_request, string $contentType = self::contentTypes['updateImage'][0])
|
|
{
|
|
$request = $this->updateImageRequest($zone, $image_id, $update_image_request, $contentType);
|
|
|
|
try {
|
|
$options = $this->createHttpClientOption();
|
|
try {
|
|
$response = $this->client->send($request, $options);
|
|
} catch (RequestException $e) {
|
|
throw new ApiException(
|
|
"[{$e->getCode()}] {$e->getMessage()}",
|
|
(int) $e->getCode(),
|
|
$e->getResponse() ? $e->getResponse()->getHeaders() : null,
|
|
$e->getResponse() ? (string) $e->getResponse()->getBody() : null
|
|
);
|
|
} catch (ConnectException $e) {
|
|
throw new ApiException(
|
|
"[{$e->getCode()}] {$e->getMessage()}",
|
|
(int) $e->getCode(),
|
|
null,
|
|
null
|
|
);
|
|
}
|
|
|
|
$statusCode = $response->getStatusCode();
|
|
|
|
|
|
switch($statusCode) {
|
|
case 200:
|
|
if ('\OpenAPI\Client\Model\ScalewayInstanceV1UpdateImageResponse' === '\SplFileObject') {
|
|
$content = $response->getBody(); //stream goes to serializer
|
|
} else {
|
|
$content = (string) $response->getBody();
|
|
if ('\OpenAPI\Client\Model\ScalewayInstanceV1UpdateImageResponse' !== 'string') {
|
|
try {
|
|
$content = json_decode($content, false, 512, JSON_THROW_ON_ERROR);
|
|
} catch (\JsonException $exception) {
|
|
throw new ApiException(
|
|
sprintf(
|
|
'Error JSON decoding server response (%s)',
|
|
$request->getUri()
|
|
),
|
|
$statusCode,
|
|
$response->getHeaders(),
|
|
$content
|
|
);
|
|
}
|
|
}
|
|
}
|
|
|
|
return [
|
|
ObjectSerializer::deserialize($content, '\OpenAPI\Client\Model\ScalewayInstanceV1UpdateImageResponse', []),
|
|
$response->getStatusCode(),
|
|
$response->getHeaders()
|
|
];
|
|
}
|
|
|
|
if ($statusCode < 200 || $statusCode > 299) {
|
|
throw new ApiException(
|
|
sprintf(
|
|
'[%d] Error connecting to the API (%s)',
|
|
$statusCode,
|
|
(string) $request->getUri()
|
|
),
|
|
$statusCode,
|
|
$response->getHeaders(),
|
|
(string) $response->getBody()
|
|
);
|
|
}
|
|
|
|
$returnType = '\OpenAPI\Client\Model\ScalewayInstanceV1UpdateImageResponse';
|
|
if ($returnType === '\SplFileObject') {
|
|
$content = $response->getBody(); //stream goes to serializer
|
|
} else {
|
|
$content = (string) $response->getBody();
|
|
if ($returnType !== 'string') {
|
|
try {
|
|
$content = json_decode($content, false, 512, JSON_THROW_ON_ERROR);
|
|
} catch (\JsonException $exception) {
|
|
throw new ApiException(
|
|
sprintf(
|
|
'Error JSON decoding server response (%s)',
|
|
$request->getUri()
|
|
),
|
|
$statusCode,
|
|
$response->getHeaders(),
|
|
$content
|
|
);
|
|
}
|
|
}
|
|
}
|
|
|
|
return [
|
|
ObjectSerializer::deserialize($content, $returnType, []),
|
|
$response->getStatusCode(),
|
|
$response->getHeaders()
|
|
];
|
|
|
|
} catch (ApiException $e) {
|
|
switch ($e->getCode()) {
|
|
case 200:
|
|
$data = ObjectSerializer::deserialize(
|
|
$e->getResponseBody(),
|
|
'\OpenAPI\Client\Model\ScalewayInstanceV1UpdateImageResponse',
|
|
$e->getResponseHeaders()
|
|
);
|
|
$e->setResponseObject($data);
|
|
break;
|
|
}
|
|
throw $e;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Operation updateImageAsync
|
|
*
|
|
* Update image
|
|
*
|
|
* @param string $zone The zone you want to target (required)
|
|
* @param string $image_id UUID of the image. (UUID format) (required)
|
|
* @param \OpenAPI\Client\Model\UpdateImageRequest $update_image_request (required)
|
|
* @param string $contentType The value for the Content-Type header. Check self::contentTypes['updateImage'] to see the possible values for this operation
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @return \GuzzleHttp\Promise\PromiseInterface
|
|
*/
|
|
public function updateImageAsync($zone, $image_id, $update_image_request, string $contentType = self::contentTypes['updateImage'][0])
|
|
{
|
|
return $this->updateImageAsyncWithHttpInfo($zone, $image_id, $update_image_request, $contentType)
|
|
->then(
|
|
function ($response) {
|
|
return $response[0];
|
|
}
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Operation updateImageAsyncWithHttpInfo
|
|
*
|
|
* Update image
|
|
*
|
|
* @param string $zone The zone you want to target (required)
|
|
* @param string $image_id UUID of the image. (UUID format) (required)
|
|
* @param \OpenAPI\Client\Model\UpdateImageRequest $update_image_request (required)
|
|
* @param string $contentType The value for the Content-Type header. Check self::contentTypes['updateImage'] to see the possible values for this operation
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @return \GuzzleHttp\Promise\PromiseInterface
|
|
*/
|
|
public function updateImageAsyncWithHttpInfo($zone, $image_id, $update_image_request, string $contentType = self::contentTypes['updateImage'][0])
|
|
{
|
|
$returnType = '\OpenAPI\Client\Model\ScalewayInstanceV1UpdateImageResponse';
|
|
$request = $this->updateImageRequest($zone, $image_id, $update_image_request, $contentType);
|
|
|
|
return $this->client
|
|
->sendAsync($request, $this->createHttpClientOption())
|
|
->then(
|
|
function ($response) use ($returnType) {
|
|
if ($returnType === '\SplFileObject') {
|
|
$content = $response->getBody(); //stream goes to serializer
|
|
} else {
|
|
$content = (string) $response->getBody();
|
|
if ($returnType !== 'string') {
|
|
$content = json_decode($content);
|
|
}
|
|
}
|
|
|
|
return [
|
|
ObjectSerializer::deserialize($content, $returnType, []),
|
|
$response->getStatusCode(),
|
|
$response->getHeaders()
|
|
];
|
|
},
|
|
function ($exception) {
|
|
$response = $exception->getResponse();
|
|
$statusCode = $response->getStatusCode();
|
|
throw new ApiException(
|
|
sprintf(
|
|
'[%d] Error connecting to the API (%s)',
|
|
$statusCode,
|
|
$exception->getRequest()->getUri()
|
|
),
|
|
$statusCode,
|
|
$response->getHeaders(),
|
|
(string) $response->getBody()
|
|
);
|
|
}
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Create request for operation 'updateImage'
|
|
*
|
|
* @param string $zone The zone you want to target (required)
|
|
* @param string $image_id UUID of the image. (UUID format) (required)
|
|
* @param \OpenAPI\Client\Model\UpdateImageRequest $update_image_request (required)
|
|
* @param string $contentType The value for the Content-Type header. Check self::contentTypes['updateImage'] to see the possible values for this operation
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @return \GuzzleHttp\Psr7\Request
|
|
*/
|
|
public function updateImageRequest($zone, $image_id, $update_image_request, string $contentType = self::contentTypes['updateImage'][0])
|
|
{
|
|
|
|
// verify the required parameter 'zone' is set
|
|
if ($zone === null || (is_array($zone) && count($zone) === 0)) {
|
|
throw new \InvalidArgumentException(
|
|
'Missing the required parameter $zone when calling updateImage'
|
|
);
|
|
}
|
|
|
|
// verify the required parameter 'image_id' is set
|
|
if ($image_id === null || (is_array($image_id) && count($image_id) === 0)) {
|
|
throw new \InvalidArgumentException(
|
|
'Missing the required parameter $image_id when calling updateImage'
|
|
);
|
|
}
|
|
|
|
// verify the required parameter 'update_image_request' is set
|
|
if ($update_image_request === null || (is_array($update_image_request) && count($update_image_request) === 0)) {
|
|
throw new \InvalidArgumentException(
|
|
'Missing the required parameter $update_image_request when calling updateImage'
|
|
);
|
|
}
|
|
|
|
|
|
$resourcePath = '/instance/v1/zones/{zone}/images/{image_id}';
|
|
$formParams = [];
|
|
$queryParams = [];
|
|
$headerParams = [];
|
|
$httpBody = '';
|
|
$multipart = false;
|
|
|
|
|
|
|
|
// path params
|
|
if ($zone !== null) {
|
|
$resourcePath = str_replace(
|
|
'{' . 'zone' . '}',
|
|
ObjectSerializer::toPathValue($zone),
|
|
$resourcePath
|
|
);
|
|
}
|
|
// path params
|
|
if ($image_id !== null) {
|
|
$resourcePath = str_replace(
|
|
'{' . 'image_id' . '}',
|
|
ObjectSerializer::toPathValue($image_id),
|
|
$resourcePath
|
|
);
|
|
}
|
|
|
|
|
|
$headers = $this->headerSelector->selectHeaders(
|
|
['application/json', ],
|
|
$contentType,
|
|
$multipart
|
|
);
|
|
|
|
// for model (json/xml)
|
|
if (isset($update_image_request)) {
|
|
if (stripos($headers['Content-Type'], 'application/json') !== false) {
|
|
# if Content-Type contains "application/json", json_encode the body
|
|
$httpBody = \GuzzleHttp\Utils::jsonEncode(ObjectSerializer::sanitizeForSerialization($update_image_request));
|
|
} else {
|
|
$httpBody = $update_image_request;
|
|
}
|
|
} elseif (count($formParams) > 0) {
|
|
if ($multipart) {
|
|
$multipartContents = [];
|
|
foreach ($formParams as $formParamName => $formParamValue) {
|
|
$formParamValueItems = is_array($formParamValue) ? $formParamValue : [$formParamValue];
|
|
foreach ($formParamValueItems as $formParamValueItem) {
|
|
$multipartContents[] = [
|
|
'name' => $formParamName,
|
|
'contents' => $formParamValueItem
|
|
];
|
|
}
|
|
}
|
|
// for HTTP post (form)
|
|
$httpBody = new MultipartStream($multipartContents);
|
|
|
|
} elseif (stripos($headers['Content-Type'], 'application/json') !== false) {
|
|
# if Content-Type contains "application/json", json_encode the form parameters
|
|
$httpBody = \GuzzleHttp\Utils::jsonEncode($formParams);
|
|
} else {
|
|
// for HTTP post (form)
|
|
$httpBody = ObjectSerializer::buildQuery($formParams);
|
|
}
|
|
}
|
|
|
|
// this endpoint requires API key authentication
|
|
$apiKey = $this->config->getApiKeyWithPrefix('X-Auth-Token');
|
|
if ($apiKey !== null) {
|
|
$headers['X-Auth-Token'] = $apiKey;
|
|
}
|
|
|
|
$defaultHeaders = [];
|
|
if ($this->config->getUserAgent()) {
|
|
$defaultHeaders['User-Agent'] = $this->config->getUserAgent();
|
|
}
|
|
|
|
$headers = array_merge(
|
|
$defaultHeaders,
|
|
$headerParams,
|
|
$headers
|
|
);
|
|
|
|
$operationHost = $this->config->getHost();
|
|
$query = ObjectSerializer::buildQuery($queryParams);
|
|
return new Request(
|
|
'PATCH',
|
|
$operationHost . $resourcePath . ($query ? "?{$query}" : ''),
|
|
$headers,
|
|
$httpBody
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Create http client option
|
|
*
|
|
* @throws \RuntimeException on file opening failure
|
|
* @return array of http client options
|
|
*/
|
|
protected function createHttpClientOption()
|
|
{
|
|
$options = [];
|
|
if ($this->config->getDebug()) {
|
|
$options[RequestOptions::DEBUG] = fopen($this->config->getDebugFile(), 'a');
|
|
if (!$options[RequestOptions::DEBUG]) {
|
|
throw new \RuntimeException('Failed to open the debug file: ' . $this->config->getDebugFile());
|
|
}
|
|
}
|
|
|
|
return $options;
|
|
}
|
|
}
|