goldyfruit.ibmcloud_automation.ic_resource_instance (1.0.4) — module

Manage resource instance on IBM Cloud.

| "added in version" 2.9 of goldyfruit.ibmcloud_automation"

Authors: James Regis (@jregis)

preview | supported by community

Install collection

Install with ansible-galaxy collection install goldyfruit.ibmcloud_automation:==1.0.4


Add to requirements.yml

  collections:
    - name: goldyfruit.ibmcloud_automation
      version: 1.0.4

Description

The resource controller can provision or create an instance. Provisioning reserves a resource on a service, and the reserved resource is a service instance. A resource instance can vary by service.

Examples include a single database on a multi-tenant server, a dedicated cluster, or an account on a web application.


Requirements

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Create resource instance
  ic_resource_instance:
    instance: ibmcloud-resource-instance-baby
    resource_plan: ibmcloud-resource-plan
    target: bluemix-global
    tags:
      - cos
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Delete resource instance
  ic_resource_instance:
    instance: ibmcloud-resource-instance-baby
    state: absent
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Delete resource instance and its belonging resources
  ic_resource_instance:
    instance: ibmcloud-resource-instance-baby
    recursive: true
    state: absent

Inputs

    
tags:
    description:
    - Tags that are attached to the instance after provisioning. These tags can be searched
      and managed through the Tagging API in IBM Cloud.
    type: list

state:
    choices:
    - present
    - absent
    default: present
    description:
    - Should the resource be present or absent.

target:
    description:
    - The deployment location where the instance should be hosted.
    type: str

instance:
    description:
    - The name of the instance. Must be 180 characters or less and cannot include any
      special characters other than (space) - . _ :.
    required: true
    type: str

recursive:
    choices:
    - true
    - false
    default: false
    description:
    - A boolean that dictates if resource service instance belonging resources should
      be deleted as well.
    type: bool

parameters:
    description:
    - Configuration options represented as key-value pairs that are passed through to
      the target resource brokers.
    type: str

allow_cleanup:
    choices:
    - true
    - false
    default: false
    description:
    - A boolean that dictates if the resource instance should be deleted (cleaned up)
      during the processing of a region instance delete call.
    type: bool

resource_plan:
    description:
    - The unique ID of the plan associated with the offering. This value is provided by
      and stored in the global catalog.
    type: str

resource_group:
    description:
    - Short or long ID of resource group.
    type: str