community.general.gcp_iam_role_info (0.1.1) — module

Gather info for GCP Role

Authors: Google Inc. (@googlecloudplatform)

preview | supported by community

Install collection

Install with ansible-galaxy collection install community.general:==0.1.1


Add to requirements.yml

  collections:
    - name: community.general
      version: 0.1.1

Description

Gather info for GCP Role


Requirements

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: get info on a role
  gcp_iam_role_info:
    project: test_project
    auth_kind: serviceaccount
    service_account_file: "/tmp/auth.pem"

Inputs

    
scopes:
    description:
    - Array of scopes to be used
    type: list

project:
    description:
    - The Google Cloud Platform project to use.
    type: str

env_type:
    description:
    - Specifies which Ansible environment you're running this module within.
    - This should not be set unless you know what you're doing.
    - This only alters the User Agent string for any API requests.
    type: str

auth_kind:
    choices:
    - application
    - machineaccount
    - serviceaccount
    description:
    - The type of credential used.
    required: true
    type: str

service_account_file:
    description:
    - The path of a Service Account JSON file if serviceaccount is selected as type.
    type: path

service_account_email:
    description:
    - An optional service account email address if machineaccount is selected and the
      user does not wish to use the default email.
    type: str

service_account_contents:
    description:
    - The contents of a Service Account JSON file, either in a dictionary or as a JSON
      string that represents it.
    type: jsonarg

Outputs

resources:
  contains:
    deleted:
      description:
      - The current deleted state of the role.
      returned: success
      type: bool
    description:
      description:
      - Human-readable description for the role.
      returned: success
      type: str
    includedPermissions:
      description:
      - Names of permissions this role grants when bound in an IAM policy.
      returned: success
      type: list
    name:
      description:
      - The name of the role.
      returned: success
      type: str
    stage:
      description:
      - The current launch stage of the role.
      returned: success
      type: str
    title:
      description:
      - A human-readable title for the role. Typically this is limited to 100 UTF-8
        bytes.
      returned: success
      type: str
  description: List of resources
  returned: always
  type: complex