Skip to content

Latest commit

 

History

History
89 lines (73 loc) · 3.45 KB

stackscript_list.md

File metadata and controls

89 lines (73 loc) · 3.45 KB
Raw

stackscript_list

List and filter on Linode stackscripts.

Examples

- name: List all of the stackscripts for the current Linode Account
  linode.cloud.stackscript_list: {}
- name: List the latest 5 stackscripts for the current Linode Account
  linode.cloud.stackscript_list:
    count: 5
    order_by: created
    order: desc
- name: List all personal stackscripts for the current Linode Account
  linode.cloud.stackscript_list:
    filters:
      - name: mine
        values: true

Parameters

Field Type Required Description
order str Optional The order to list events in. (Choices: desc, asc; Default: asc)
order_by str Optional The attribute to order events by.
filters (sub-options) list Optional A list of filters to apply to the resulting events.
count int Optional The number of results to return. If undefined, all results will be returned.

filters

Field Type Required Description
name str Required The name of the field to filter on. Valid filterable attributes can be found here: https://www.linode.com/docs/api/stackscripts/#stackscripts-list__response-samples
values list Required A list of values to allow for this field. Fields will pass this filter if at least one of these values matches.

Return Values

  • stackscripts - The returned stackscripts.

    • Sample Response: 
      [
    {
        "created": "2018-01-01T00:01:01",
        "deployments_active": 1,
        "deployments_total": 12,
        "description": "This StackScript installs and configures MySQL\n",
        "id": 10079,
        "images": [
            "linode/debian9",
            "linode/debian8"
        ],
        "is_public": true,
        "label": "a-stackscript",
        "mine": true,
        "rev_note": "Set up MySQL",
        "script": ""#!/bin/bash"\n",
        "updated": "2018-01-01T00:01:01",
        "user_defined_fields": [
            {
                "default": null,
                "example": "hunter2",
                "label": "Enter the password",
                "manyOf": "avalue,anothervalue,thirdvalue",
                "name": "DB_PASSWORD",
                "oneOf": "avalue,anothervalue,thirdvalue"
            }
        ],
        "user_gravatar_id": "a445b305abda30ebc766bc7fda037c37",
        "username": "myuser"
    }
]
    • See the Linode API response documentation for a list of returned fields