` for details.
To use it in a playbook, specify: :code:`stephrobert.scaleway.instance_image`.
.. version_added
.. rst-class:: ansible-version-added
New in stephrobert.scaleway 0.1.0
.. contents::
:local:
:depth: 1
.. Deprecated
Synopsis
--------
.. Description
- Update the properties of an image.
- The module reads the resource first and writes only the fields that differ, so a second run reports no change.
.. Aliases
.. Requirements
.. _ansible_collections.stephrobert.scaleway.instance_image_module_requirements:
Requirements
------------
The below requirements are needed on the host that executes this module.
- scaleway \>= 2.9.0
.. Options
Parameters
----------
.. tabularcolumns:: \X{1}{3}\X{2}{3}
.. list-table::
:width: 100%
:widths: auto
:header-rows: 1
:class: longtable ansible-option-table
* - Parameter
- Comments
* - .. raw:: html
.. _ansible_collections.stephrobert.scaleway.instance_image_module__parameter-access_key:
.. rst-class:: ansible-option-title
**access_key**
.. raw:: html
.. ansible-option-type-line::
:ansible-option-type:`string`
.. raw:: html
- .. raw:: html
Scaleway API access key.
.. raw:: html
* - .. raw:: html
.. _ansible_collections.stephrobert.scaleway.instance_image_module__parameter-api_allow_insecure:
.. rst-class:: ansible-option-title
**api_allow_insecure**
.. raw:: html
.. ansible-option-type-line::
:ansible-option-type:`boolean`
.. raw:: html
- .. raw:: html
Allow the API endpoint to be reached without verifying its TLS certificate.
Falls back to the Scaleway configuration file, then to :literal:`false`.
.. rst-class:: ansible-option-line
:ansible-option-choices:`Choices:`
- :ansible-option-choices-entry:`false`
- :ansible-option-choices-entry:`true`
.. raw:: html
* - .. raw:: html
.. _ansible_collections.stephrobert.scaleway.instance_image_module__parameter-api_timeout:
.. rst-class:: ansible-option-title
**api_timeout**
.. raw:: html
.. ansible-option-type-line::
:ansible-option-type:`integer`
.. raw:: html
- .. raw:: html
Seconds allowed for a single API call, connection and read.
Without a limit a silent connection would hang the module forever: the Scaleway SDK issues its requests with no timeout at all.
This bounds a single call, not a whole wait. Modules that can wait for a state bound the overall wait separately.
.. rst-class:: ansible-option-line
:ansible-option-default-bold:`Default:` :ansible-option-default:`60`
.. raw:: html
* - .. raw:: html
.. _ansible_collections.stephrobert.scaleway.instance_image_module__parameter-api_url:
.. rst-class:: ansible-option-title
**api_url**
.. raw:: html
.. ansible-option-type-line::
:ansible-option-type:`string`
.. raw:: html
- .. raw:: html
URL of the Scaleway API endpoint.
Point it at a local emulator to exercise a playbook without credentials.
Falls back to the Scaleway configuration file, then to :literal:`https://api.scaleway.com`. It carries no module default on purpose: a default is never unset, so it would always override the profile.
.. raw:: html
* - .. raw:: html
.. _ansible_collections.stephrobert.scaleway.instance_image_module__parameter-arch:
.. rst-class:: ansible-option-title
**arch**
.. raw:: html
.. ansible-option-type-line::
:ansible-option-type:`string`
.. raw:: html
- .. raw:: html
Architecture of the image.
.. rst-class:: ansible-option-line
:ansible-option-choices:`Choices:`
- :ansible-option-choices-entry:`"unknown\_arch"`
- :ansible-option-choices-entry:`"x86\_64"`
- :ansible-option-choices-entry:`"arm"`
- :ansible-option-choices-entry:`"arm64"`
.. raw:: html
* - .. raw:: html
.. _ansible_collections.stephrobert.scaleway.instance_image_module__parameter-config_file:
.. rst-class:: ansible-option-title
**config_file**
.. raw:: html
.. ansible-option-type-line::
:ansible-option-type:`path`
.. raw:: html
- .. raw:: html
Path to the Scaleway configuration file.
.. raw:: html
* - .. raw:: html
.. _ansible_collections.stephrobert.scaleway.instance_image_module__parameter-extra_volumes:
.. rst-class:: ansible-option-title
**extra_volumes**
.. raw:: html
.. ansible-option-type-line::
:ansible-option-type:`dictionary`
.. raw:: html
- .. raw:: html
Additional snapshots of the image, with extra\_volumeKey being the position of the snapshot in the image.
.. raw:: html
* - .. raw:: html
.. _ansible_collections.stephrobert.scaleway.instance_image_module__parameter-image_id:
.. rst-class:: ansible-option-title
**image_id**
.. raw:: html
.. ansible-option-type-line::
:ansible-option-type:`string` / :ansible-option-required:`required`
.. raw:: html
- .. raw:: html
UUID of the image. (UUID format)
.. raw:: html
* - .. raw:: html
.. _ansible_collections.stephrobert.scaleway.instance_image_module__parameter-name:
.. rst-class:: ansible-option-title
**name**
.. raw:: html
.. ansible-option-type-line::
:ansible-option-type:`string`
.. raw:: html
- .. raw:: html
Name of the image.
To clear this field, write \`name: ""\`; omit the option to leave the current value untouched.
Setting it to null is refused: this API reads null as "field not provided" and would change nothing.
.. raw:: html
* - .. raw:: html
.. _ansible_collections.stephrobert.scaleway.instance_image_module__parameter-organization_id:
.. rst-class:: ansible-option-title
**organization_id**
.. raw:: html
.. ansible-option-type-line::
:ansible-option-type:`string`
.. raw:: html
- .. raw:: html
Default Organization ID used when an operation does not name one.
.. raw:: html
* - .. raw:: html
.. _ansible_collections.stephrobert.scaleway.instance_image_module__parameter-profile:
.. rst-class:: ansible-option-title
**profile**
.. raw:: html
.. ansible-option-type-line::
:ansible-option-type:`string`
.. raw:: html
- .. raw:: html
Name of the profile to read in the Scaleway configuration file.
.. raw:: html
* - .. raw:: html
.. _ansible_collections.stephrobert.scaleway.instance_image_module__parameter-project_id:
.. rst-class:: ansible-option-title
**project_id**
.. raw:: html
.. ansible-option-type-line::
:ansible-option-type:`string`
.. raw:: html
- .. raw:: html
Default Project ID used when an operation does not name one.
.. raw:: html
* - .. raw:: html
.. _ansible_collections.stephrobert.scaleway.instance_image_module__parameter-public:
.. rst-class:: ansible-option-title
**public**
.. raw:: html
.. ansible-option-type-line::
:ansible-option-type:`boolean`
.. raw:: html
- .. raw:: html
True to set the image as public.
The contract marks this field clearable, but bool has no empty value, so the API cannot clear it. Setting it to null is refused: this API reads null as "field not provided" and would change nothing.
.. rst-class:: ansible-option-line
:ansible-option-choices:`Choices:`
- :ansible-option-choices-entry:`false`
- :ansible-option-choices-entry:`true`
.. raw:: html
* - .. raw:: html
.. _ansible_collections.stephrobert.scaleway.instance_image_module__parameter-secret_key:
.. rst-class:: ansible-option-title
**secret_key**
.. raw:: html
.. ansible-option-type-line::
:ansible-option-type:`string`
.. raw:: html
- .. raw:: html
Scaleway API secret key.
.. raw:: html
* - .. raw:: html
.. _ansible_collections.stephrobert.scaleway.instance_image_module__parameter-tags:
.. rst-class:: ansible-option-title
**tags**
.. raw:: html
.. ansible-option-type-line::
:ansible-option-type:`list` / :ansible-option-elements:`elements=string`
.. raw:: html
- .. raw:: html
Tags of the image.
To clear this field, write \`tags: []\`; omit the option to leave the current value untouched.
Setting it to null is refused: this API reads null as "field not provided" and would change nothing.
.. raw:: html
* - .. raw:: html
.. _ansible_collections.stephrobert.scaleway.instance_image_module__parameter-user_agent:
.. rst-class:: ansible-option-title
**user_agent**
.. raw:: html
.. ansible-option-type-line::
:ansible-option-type:`string`
.. raw:: html
- .. raw:: html
Value of the User\-Agent header sent to the API.
.. raw:: html
* - .. raw:: html
.. _ansible_collections.stephrobert.scaleway.instance_image_module__parameter-zone:
.. rst-class:: ansible-option-title
**zone**
.. raw:: html
.. ansible-option-type-line::
:ansible-option-type:`string` / :ansible-option-required:`required`
.. raw:: html
- .. raw:: html
The zone you want to target
.. rst-class:: ansible-option-line
:ansible-option-choices:`Choices:`
- :ansible-option-choices-entry:`"fr\-par\-1"`
- :ansible-option-choices-entry:`"fr\-par\-2"`
- :ansible-option-choices-entry:`"fr\-par\-3"`
- :ansible-option-choices-entry:`"nl\-ams\-1"`
- :ansible-option-choices-entry:`"nl\-ams\-2"`
- :ansible-option-choices-entry:`"nl\-ams\-3"`
- :ansible-option-choices-entry:`"pl\-waw\-1"`
- :ansible-option-choices-entry:`"pl\-waw\-2"`
- :ansible-option-choices-entry:`"pl\-waw\-3"`
- :ansible-option-choices-entry:`"it\-mil\-1"`
.. raw:: html
.. Attributes
Attributes
----------
.. tabularcolumns:: \X{2}{10}\X{3}{10}\X{5}{10}
.. list-table::
:width: 100%
:widths: auto
:header-rows: 1
:class: longtable ansible-option-table
* - Attribute
- Support
- Description
* - .. raw:: html
.. _ansible_collections.stephrobert.scaleway.instance_image_module__attribute-check_mode:
.. rst-class:: ansible-option-title
**check_mode**
.. raw:: html
.. raw:: html
- .. raw:: html
:ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full`
.. raw:: html
- .. raw:: html
In check mode the module reads the resource and compares it, then reports what it would write without writing it.
.. raw:: html
* - .. raw:: html
.. _ansible_collections.stephrobert.scaleway.instance_image_module__attribute-diff_mode:
.. rst-class:: ansible-option-title
**diff_mode**
.. raw:: html
.. raw:: html
- .. raw:: html
:ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full`
.. raw:: html
- .. raw:: html
The module reports the fields that differ, read through the same projection the comparison uses.
.. raw:: html
.. Notes
Notes
-----
.. note::
- Every option can be set from its environment variable, respectively :literal:`SCW\_PROFILE`\ , :literal:`SCW\_CONFIG\_PATH`\ , :literal:`SCW\_ACCESS\_KEY`\ , :literal:`SCW\_SECRET\_KEY`\ , :literal:`SCW\_API\_URL`\ , :literal:`SCW\_DEFAULT\_ORGANIZATION\_ID` and :literal:`SCW\_DEFAULT\_PROJECT\_ID`.
- Module options take precedence over environment variables, which take precedence over the configuration file.
.. Seealso
.. Examples
Examples
--------
.. code-block:: yaml+jinja
# The module reads the resource, compares, and writes only what
# differs: run it twice and the second run reports no change.
#
# Check mode compares without writing, and `--diff` shows what would
# change. A parameter you do not pass is a parameter the module does
# not touch.
- name: Update a Scaleway Instance image
stephrobert.scaleway.instance_image:
zone: fr-par-1
image_id: 11111111-2222-3333-4444-555555555555
name: my-image
register: result
- name: Preview the change on a Scaleway Instance image without writing
stephrobert.scaleway.instance_image:
zone: fr-par-1
image_id: 11111111-2222-3333-4444-555555555555
name: my-image
register: result
check_mode: true
diff: true
.. Facts
.. Return values
Return Values
-------------
Common return values are documented :ref:`here `, the following are the fields unique to this module:
.. tabularcolumns:: \X{1}{3}\X{2}{3}
.. list-table::
:width: 100%
:widths: auto
:header-rows: 1
:class: longtable ansible-option-table
* - Key
- Description
* - .. raw:: html
.. _ansible_collections.stephrobert.scaleway.instance_image_module__return-image:
.. rst-class:: ansible-option-title
**image**
.. raw:: html
.. ansible-option-type-line::
:ansible-option-type:`dictionary`
.. raw:: html
- .. raw:: html
Get details of an image with the specified ID.
.. rst-class:: ansible-option-line
:ansible-option-returned-bold:`Returned:` success
.. raw:: html
* - .. raw:: html
.. raw:: latex
\hspace{0.02\textwidth}\begin{minipage}[t]{0.3\textwidth}
.. _ansible_collections.stephrobert.scaleway.instance_image_module__return-image/arch:
.. rst-class:: ansible-option-title
**arch**
.. raw:: html
.. ansible-option-type-line::
:ansible-option-type:`string`
.. raw:: html
.. raw:: latex
\end{minipage}
- .. raw:: html
CPU architecture of the image.
.. rst-class:: ansible-option-line
:ansible-option-returned-bold:`Returned:` when the API returns it
.. raw:: html
* - .. raw:: html
.. raw:: latex
\hspace{0.02\textwidth}\begin{minipage}[t]{0.3\textwidth}
.. _ansible_collections.stephrobert.scaleway.instance_image_module__return-image/creation_date:
.. rst-class:: ansible-option-title
**creation_date**
.. raw:: html
.. ansible-option-type-line::
:ansible-option-type:`string`
.. raw:: html
.. raw:: latex
\end{minipage}
- .. raw:: html
(RFC 3339 format)
.. rst-class:: ansible-option-line
:ansible-option-returned-bold:`Returned:` when the API returns it
.. raw:: html
* - .. raw:: html
.. raw:: latex
\hspace{0.02\textwidth}\begin{minipage}[t]{0.3\textwidth}
.. _ansible_collections.stephrobert.scaleway.instance_image_module__return-image/default_bootscript:
.. rst-class:: ansible-option-title
**default_bootscript**
.. raw:: html
.. ansible-option-type-line::
:ansible-option-type:`dictionary`
.. raw:: html
.. raw:: latex
\end{minipage}
- .. raw:: html
Default bootscript of the image.
Deprecated by the Scaleway API contract.
.. rst-class:: ansible-option-line
:ansible-option-returned-bold:`Returned:` when the API returns it
.. raw:: html
* - .. raw:: html
.. raw:: latex
\hspace{0.02\textwidth}\begin{minipage}[t]{0.3\textwidth}
.. _ansible_collections.stephrobert.scaleway.instance_image_module__return-image/extra_volumes:
.. rst-class:: ansible-option-title
**extra_volumes**
.. raw:: html
.. ansible-option-type-line::
:ansible-option-type:`dictionary`
.. raw:: html
.. raw:: latex
\end{minipage}
- .. raw:: html
Extra volumes of the image.
.. rst-class:: ansible-option-line
:ansible-option-returned-bold:`Returned:` when the API returns it
.. raw:: html
* - .. raw:: html
.. raw:: latex
\hspace{0.02\textwidth}\begin{minipage}[t]{0.3\textwidth}
.. _ansible_collections.stephrobert.scaleway.instance_image_module__return-image/from_server:
.. rst-class:: ansible-option-title
**from_server**
.. raw:: html
.. ansible-option-type-line::
:ansible-option-type:`string`
.. raw:: html
.. raw:: latex
\end{minipage}
- .. raw:: html
Server the image comes from.
.. rst-class:: ansible-option-line
:ansible-option-returned-bold:`Returned:` when the API returns it
.. raw:: html
* - .. raw:: html
.. raw:: latex
\hspace{0.02\textwidth}\begin{minipage}[t]{0.3\textwidth}
.. _ansible_collections.stephrobert.scaleway.instance_image_module__return-image/id:
.. rst-class:: ansible-option-title
**id**
.. raw:: html
.. ansible-option-type-line::
:ansible-option-type:`string`
.. raw:: html
.. raw:: latex
\end{minipage}
- .. raw:: html
Unique ID of the image.
.. rst-class:: ansible-option-line
:ansible-option-returned-bold:`Returned:` when the API returns it
.. raw:: html
* - .. raw:: html
.. raw:: latex
\hspace{0.02\textwidth}\begin{minipage}[t]{0.3\textwidth}
.. _ansible_collections.stephrobert.scaleway.instance_image_module__return-image/modification_date:
.. rst-class:: ansible-option-title
**modification_date**
.. raw:: html
.. ansible-option-type-line::
:ansible-option-type:`string`
.. raw:: html
.. raw:: latex
\end{minipage}
- .. raw:: html
(RFC 3339 format)
.. rst-class:: ansible-option-line
:ansible-option-returned-bold:`Returned:` when the API returns it
.. raw:: html
* - .. raw:: html
.. raw:: latex
\hspace{0.02\textwidth}\begin{minipage}[t]{0.3\textwidth}
.. _ansible_collections.stephrobert.scaleway.instance_image_module__return-image/name:
.. rst-class:: ansible-option-title
**name**
.. raw:: html
.. ansible-option-type-line::
:ansible-option-type:`string`
.. raw:: html
.. raw:: latex
\end{minipage}
- .. raw:: html
Name of the image.
.. rst-class:: ansible-option-line
:ansible-option-returned-bold:`Returned:` when the API returns it
.. raw:: html
* - .. raw:: html
.. raw:: latex
\hspace{0.02\textwidth}\begin{minipage}[t]{0.3\textwidth}
.. _ansible_collections.stephrobert.scaleway.instance_image_module__return-image/organization:
.. rst-class:: ansible-option-title
**organization**
.. raw:: html
.. ansible-option-type-line::
:ansible-option-type:`string`
.. raw:: html
.. raw:: latex
\end{minipage}
- .. raw:: html
Organization ID of the image.
.. rst-class:: ansible-option-line
:ansible-option-returned-bold:`Returned:` when the API returns it
.. raw:: html
* - .. raw:: html
.. raw:: latex
\hspace{0.02\textwidth}\begin{minipage}[t]{0.3\textwidth}
.. _ansible_collections.stephrobert.scaleway.instance_image_module__return-image/project:
.. rst-class:: ansible-option-title
**project**
.. raw:: html
.. ansible-option-type-line::
:ansible-option-type:`string`
.. raw:: html
.. raw:: latex
\end{minipage}
- .. raw:: html
Project ID of the image.
.. rst-class:: ansible-option-line
:ansible-option-returned-bold:`Returned:` when the API returns it
.. raw:: html
* - .. raw:: html
.. raw:: latex
\hspace{0.02\textwidth}\begin{minipage}[t]{0.3\textwidth}
.. _ansible_collections.stephrobert.scaleway.instance_image_module__return-image/public:
.. rst-class:: ansible-option-title
**public**
.. raw:: html
.. ansible-option-type-line::
:ansible-option-type:`boolean`
.. raw:: html
.. raw:: latex
\end{minipage}
- .. raw:: html
Whether the image is public.
.. rst-class:: ansible-option-line
:ansible-option-returned-bold:`Returned:` when the API returns it
.. raw:: html
* - .. raw:: html
.. raw:: latex
\hspace{0.02\textwidth}\begin{minipage}[t]{0.3\textwidth}
.. _ansible_collections.stephrobert.scaleway.instance_image_module__return-image/root_volume:
.. rst-class:: ansible-option-title
**root_volume**
.. raw:: html
.. ansible-option-type-line::
:ansible-option-type:`dictionary`
.. raw:: html
.. raw:: latex
\end{minipage}
- .. raw:: html
UUID of the snapshot.
.. rst-class:: ansible-option-line
:ansible-option-returned-bold:`Returned:` when the API returns it
.. raw:: html
* - .. raw:: html
.. raw:: latex
\hspace{0.02\textwidth}\begin{minipage}[t]{0.3\textwidth}
.. _ansible_collections.stephrobert.scaleway.instance_image_module__return-image/state:
.. rst-class:: ansible-option-title
**state**
.. raw:: html
.. ansible-option-type-line::
:ansible-option-type:`string`
.. raw:: html
.. raw:: latex
\end{minipage}
- .. raw:: html
State of the image.
.. rst-class:: ansible-option-line
:ansible-option-returned-bold:`Returned:` when the API returns it
.. raw:: html
* - .. raw:: html
.. raw:: latex
\hspace{0.02\textwidth}\begin{minipage}[t]{0.3\textwidth}
.. _ansible_collections.stephrobert.scaleway.instance_image_module__return-image/tags:
.. rst-class:: ansible-option-title
**tags**
.. raw:: html
.. ansible-option-type-line::
:ansible-option-type:`list` / :ansible-option-elements:`elements=string`
.. raw:: html
.. raw:: latex
\end{minipage}
- .. raw:: html
Tags of the image.
.. rst-class:: ansible-option-line
:ansible-option-returned-bold:`Returned:` when the API returns it
.. raw:: html
* - .. raw:: html
.. raw:: latex
\hspace{0.02\textwidth}\begin{minipage}[t]{0.3\textwidth}
.. _ansible_collections.stephrobert.scaleway.instance_image_module__return-image/zone:
.. rst-class:: ansible-option-title
**zone**
.. raw:: html
.. ansible-option-type-line::
:ansible-option-type:`string`
.. raw:: html
.. raw:: latex
\end{minipage}
- .. raw:: html
The zone you want to target
.. rst-class:: ansible-option-line
:ansible-option-returned-bold:`Returned:` when the API returns it
.. raw:: html
.. Status (Presently only deprecated)
.. Authors
Authors
~~~~~~~
- Stéphane Robert (@stephrobert)
.. Extra links
Collection links
~~~~~~~~~~~~~~~~
.. ansible-links::
- title: "Issue Tracker"
url: "https://github.com/stephrobert/collection-scaleway/issues"
external: true
- title: "Repository (Sources)"
url: "https://github.com/stephrobert/collection-scaleway"
external: true
.. Parsing errors