oracle.oci.oci_database_management_external_exadata_infrastructure_facts (5.0.0) — module

Fetches details about one or multiple ExternalExadataInfrastructure resources in Oracle Cloud Infrastructure

| "added in version" 2.9.0 of oracle.oci"

Authors: Oracle (@oracle)

preview | supported by community

Install collection

Install with ansible-galaxy collection install oracle.oci:==5.0.0


Add to requirements.yml

  collections:
    - name: oracle.oci
      version: 5.0.0

Description

Fetches details about one or multiple ExternalExadataInfrastructure resources in Oracle Cloud Infrastructure

Lists the Exadata infrastructures for a specific compartment.

If I(external_exadata_infrastructure_id) is specified, the details of a single ExternalExadataInfrastructure will be returned.


Requirements

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Get a specific external_exadata_infrastructure
  oci_database_management_external_exadata_infrastructure_facts:
    # required
    external_exadata_infrastructure_id: "ocid1.externalexadatainfrastructure.oc1..xxxxxxEXAMPLExxxxxx"
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: List external_exadata_infrastructures
  oci_database_management_external_exadata_infrastructure_facts:
    # required
    compartment_id: "ocid1.compartment.oc1..xxxxxxEXAMPLExxxxxx"

    # optional
    display_name: display_name_example
    sort_by: TIMECREATED
    sort_order: ASC

Inputs

    
region:
    description:
    - The Oracle Cloud Infrastructure region to use for all OCI API requests. If not set,
      then the value of the OCI_REGION variable, if any, is used. This option is required
      if the region is not specified through a configuration file (See C(config_file_location)).
      Please refer to U(https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/regions.htm)
      for more information on OCI regions.
    type: str

sort_by:
    choices:
    - TIMECREATED
    - NAME
    description:
    - The field to sort information by. Only one sortOrder can be used. The default sort
      order for 'TIMECREATED' is descending and the default sort order for 'NAME' is ascending.
      The 'NAME' sort order is case-sensitive.
    type: str

tenancy:
    description:
    - OCID of your tenancy. If not set, then the value of the OCI_TENANCY variable, if
      any, is used. This option is required if the tenancy OCID is not specified through
      a configuration file (See C(config_file_location)). To get the tenancy OCID, please
      refer U(https://docs.us-phoenix-1.oraclecloud.com/Content/API/Concepts/apisigningkey.htm)
    type: str

api_user:
    description:
    - The OCID of the user, on whose behalf, OCI APIs are invoked. If not set, then the
      value of the OCI_USER_ID environment variable, if any, is used. This option is required
      if the user is not specified through a configuration file (See C(config_file_location)).
      To get the user's OCID, please refer U(https://docs.us-phoenix-1.oraclecloud.com/Content/API/Concepts/apisigningkey.htm).
    type: str

auth_type:
    choices:
    - api_key
    - instance_principal
    - instance_obo_user
    - resource_principal
    - security_token
    default: api_key
    description:
    - The type of authentication to use for making API requests. By default C(auth_type="api_key")
      based authentication is performed and the API key (see I(api_user_key_file)) in
      your config file will be used. If this 'auth_type' module option is not specified,
      the value of the OCI_ANSIBLE_AUTH_TYPE, if any, is used. Use C(auth_type="instance_principal")
      to use instance principal based authentication when running ansible playbooks within
      an OCI compute instance.
    type: str

sort_order:
    choices:
    - ASC
    - DESC
    description:
    - The option to sort information in ascending ('ASC') or descending ('DESC') order.
      Ascending order is the default order.
    type: str

cert_bundle:
    description:
    - The full path to a CA certificate bundle to be used for SSL verification. This will
      override the default CA certificate bundle. If not set, then the value of the OCI_ANSIBLE_CERT_BUNDLE
      variable, if any, is used.
    type: str

auth_purpose:
    choices:
    - service_principal
    description:
    - The auth purpose which can be used in conjunction with 'auth_type=instance_principal'.
      The default auth_purpose for instance_principal is None.
    type: str

display_name:
    aliases:
    - name
    description:
    - The optional single value query filter parameter on the entity display name.
    type: str

compartment_id:
    description:
    - The L(OCID,https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm)
      of the compartment.
    - Required to list multiple external_exadata_infrastructures.
    type: str

api_user_key_file:
    description:
    - Full path and filename of the private key (in PEM format). If not set, then the
      value of the OCI_USER_KEY_FILE variable, if any, is used. This option is required
      if the private key is not specified through a configuration file (See C(config_file_location)).
      If the key is encrypted with a pass-phrase, the C(api_user_key_pass_phrase) option
      must also be provided.
    type: str

config_profile_name:
    description:
    - The profile to load from the config file referenced by C(config_file_location).
      If not set, then the value of the OCI_CONFIG_PROFILE environment variable, if any,
      is used. Otherwise, defaults to the "DEFAULT" profile in C(config_file_location).
    type: str

api_user_fingerprint:
    description:
    - Fingerprint for the key pair being used. If not set, then the value of the OCI_USER_FINGERPRINT
      environment variable, if any, is used. This option is required if the key fingerprint
      is not specified through a configuration file (See C(config_file_location)). To
      get the key pair's fingerprint value please refer U(https://docs.us-phoenix-1.oraclecloud.com/Content/API/Concepts/apisigningkey.htm).
    type: str

config_file_location:
    description:
    - Path to configuration file. If not set then the value of the OCI_CONFIG_FILE environment
      variable, if any, is used. Otherwise, defaults to ~/.oci/config.
    type: str

api_user_key_pass_phrase:
    description:
    - Passphrase used by the key referenced in C(api_user_key_file), if it is encrypted.
      If not set, then the value of the OCI_USER_KEY_PASS_PHRASE variable, if any, is
      used. This option is required if the key passphrase is not specified through a configuration
      file (See C(config_file_location)).
    type: str

external_exadata_infrastructure_id:
    aliases:
    - id
    description:
    - The L(OCID,https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm)
      of the Exadata infrastructure.
    - Required to get a specific external_exadata_infrastructure.
    type: str

realm_specific_endpoint_template_enabled:
    description:
    - Enable/Disable realm specific endpoint template for service client. By Default,
      realm specific endpoint template is disabled. If not set, then the value of the
      OCI_REALM_SPECIFIC_SERVICE_ENDPOINT_TEMPLATE_ENABLED variable, if any, is used.
    type: bool

Outputs

external_exadata_infrastructures:
  contains:
    additional_details:
      description:
      - 'The additional details of the resource defined in `{"key": "value"}` format.
        Example: `{"bar-key": "value"}`'
      returned: on success
      sample: {}
      type: dict
    compartment_id:
      description:
      - The L(OCID,https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm)
        of compartment.
      returned: on success
      sample: ocid1.compartment.oc1..xxxxxxEXAMPLExxxxxx
      type: str
    database_compartments:
      description:
      - The list of L(OCIDs],https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm)
        of the compartments
      - Returned for get operation
      returned: on success
      sample: []
      type: list
    database_systems:
      contains:
        additional_details:
          description:
          - 'The additional details of the resource defined in `{"key": "value"}`
            format. Example: `{"bar-key": "value"}`'
          returned: on success
          sample: {}
          type: dict
        compartment_id:
          description:
          - The L(OCID,https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm)
            of compartment.
          returned: on success
          sample: ocid1.compartment.oc1..xxxxxxEXAMPLExxxxxx
          type: str
        display_name:
          description:
          - The name of the resource. English letters, numbers, "-", "_" and "." only.
          returned: on success
          sample: display_name_example
          type: str
        id:
          description:
          - The L(OCID,https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm)
            of the Exadata resource.
          returned: on success
          sample: ocid1.resource.oc1..xxxxxxEXAMPLExxxxxx
          type: str
        internal_id:
          description:
          - The internal ID.
          returned: on success
          sample: ocid1.internal.oc1..xxxxxxEXAMPLExxxxxx
          type: str
        license_model:
          description:
          - The Oracle license model that applies to the database management resources.
          returned: on success
          sample: LICENSE_INCLUDED
          type: str
        lifecycle_details:
          description:
          - The details of the lifecycle state.
          returned: on success
          sample: lifecycle_details_example
          type: str
        lifecycle_state:
          description:
          - The current lifecycle state of the database resource.
          returned: on success
          sample: CREATING
          type: str
        resource_type:
          description:
          - The type of resource.
          returned: on success
          sample: INFRASTRUCTURE_SUMMARY
          type: str
        status:
          description:
          - The status of the entity.
          returned: on success
          sample: status_example
          type: str
        time_created:
          description:
          - The timestamp of the creation.
          returned: on success
          sample: '2013-10-20T19:20:30+01:00'
          type: str
        time_updated:
          description:
          - The timestamp of the last update.
          returned: on success
          sample: '2013-10-20T19:20:30+01:00'
          type: str
        version:
          description:
          - The version of the resource.
          returned: on success
          sample: version_example
          type: str
      description:
      - A list of database systems.
      - Returned for get operation
      returned: on success
      type: complex
    display_name:
      description:
      - The name of the resource. English letters, numbers, "-", "_" and "." only.
      returned: on success
      sample: display_name_example
      type: str
    grid_home_path:
      description:
      - The Oracle grid home path.
      - Returned for list operation
      returned: on success
      sample: grid_home_path_example
      type: str
    id:
      description:
      - The L(OCID,https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm)
        of the Exadata resource.
      returned: on success
      sample: ocid1.resource.oc1..xxxxxxEXAMPLExxxxxx
      type: str
    internal_id:
      description:
      - The internal ID.
      returned: on success
      sample: ocid1.internal.oc1..xxxxxxEXAMPLExxxxxx
      type: str
    license_model:
      description:
      - The Oracle license model that applies to the database management resources.
      returned: on success
      sample: LICENSE_INCLUDED
      type: str
    lifecycle_details:
      description:
      - The details of the lifecycle state.
      returned: on success
      sample: lifecycle_details_example
      type: str
    lifecycle_state:
      description:
      - The current lifecycle state of the database resource.
      returned: on success
      sample: CREATING
      type: str
    rack_size:
      description:
      - The rack size of the Exadata infrastructure.
      returned: on success
      sample: FULL
      type: str
    resource_type:
      description:
      - The type of resource.
      returned: on success
      sample: INFRASTRUCTURE_SUMMARY
      type: str
    status:
      description:
      - The status of the entity.
      returned: on success
      sample: status_example
      type: str
    storage_grid:
      contains:
        additional_details:
          description:
          - 'The additional details of the resource defined in `{"key": "value"}`
            format. Example: `{"bar-key": "value"}`'
          returned: on success
          sample: {}
          type: dict
        display_name:
          description:
          - The name of the resource. English letters, numbers, "-", "_" and "." only.
          returned: on success
          sample: display_name_example
          type: str
        id:
          description:
          - The L(OCID,https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm)
            of the Exadata resource.
          returned: on success
          sample: ocid1.resource.oc1..xxxxxxEXAMPLExxxxxx
          type: str
        internal_id:
          description:
          - The internal ID.
          returned: on success
          sample: ocid1.internal.oc1..xxxxxxEXAMPLExxxxxx
          type: str
        lifecycle_details:
          description:
          - The details of the lifecycle state.
          returned: on success
          sample: lifecycle_details_example
          type: str
        lifecycle_state:
          description:
          - The current lifecycle state of the database resource.
          returned: on success
          sample: CREATING
          type: str
        resource_type:
          description:
          - The type of resource.
          returned: on success
          sample: INFRASTRUCTURE_SUMMARY
          type: str
        server_count:
          description:
          - The number of the storage servers in the Exadata infrastructure.
          returned: on success
          sample: 10
          type: float
        status:
          description:
          - The status of the entity.
          returned: on success
          sample: status_example
          type: str
        time_created:
          description:
          - The timestamp of the creation.
          returned: on success
          sample: '2013-10-20T19:20:30+01:00'
          type: str
        time_updated:
          description:
          - The timestamp of the last update.
          returned: on success
          sample: '2013-10-20T19:20:30+01:00'
          type: str
        version:
          description:
          - The version of the resource.
          returned: on success
          sample: version_example
          type: str
      description:
      - ''
      - Returned for get operation
      returned: on success
      type: complex
    time_created:
      description:
      - The timestamp of the creation.
      returned: on success
      sample: '2013-10-20T19:20:30+01:00'
      type: str
    time_updated:
      description:
      - The timestamp of the last update.
      returned: on success
      sample: '2013-10-20T19:20:30+01:00'
      type: str
    version:
      description:
      - The version of the resource.
      returned: on success
      sample: version_example
      type: str
  description:
  - List of ExternalExadataInfrastructure resources
  returned: on success
  sample:
  - additional_details: {}
    compartment_id: ocid1.compartment.oc1..xxxxxxEXAMPLExxxxxx
    database_compartments: []
    database_systems:
    - additional_details: {}
      compartment_id: ocid1.compartment.oc1..xxxxxxEXAMPLExxxxxx
      display_name: display_name_example
      id: ocid1.resource.oc1..xxxxxxEXAMPLExxxxxx
      internal_id: ocid1.internal.oc1..xxxxxxEXAMPLExxxxxx
      license_model: LICENSE_INCLUDED
      lifecycle_details: lifecycle_details_example
      lifecycle_state: CREATING
      resource_type: INFRASTRUCTURE_SUMMARY
      status: status_example
      time_created: '2013-10-20T19:20:30+01:00'
      time_updated: '2013-10-20T19:20:30+01:00'
      version: version_example
    display_name: display_name_example
    grid_home_path: grid_home_path_example
    id: ocid1.resource.oc1..xxxxxxEXAMPLExxxxxx
    internal_id: ocid1.internal.oc1..xxxxxxEXAMPLExxxxxx
    license_model: LICENSE_INCLUDED
    lifecycle_details: lifecycle_details_example
    lifecycle_state: CREATING
    rack_size: FULL
    resource_type: INFRASTRUCTURE_SUMMARY
    status: status_example
    storage_grid:
      additional_details: {}
      display_name: display_name_example
      id: ocid1.resource.oc1..xxxxxxEXAMPLExxxxxx
      internal_id: ocid1.internal.oc1..xxxxxxEXAMPLExxxxxx
      lifecycle_details: lifecycle_details_example
      lifecycle_state: CREATING
      resource_type: INFRASTRUCTURE_SUMMARY
      server_count: 10
      status: status_example
      time_created: '2013-10-20T19:20:30+01:00'
      time_updated: '2013-10-20T19:20:30+01:00'
      version: version_example
    time_created: '2013-10-20T19:20:30+01:00'
    time_updated: '2013-10-20T19:20:30+01:00'
    version: version_example
  type: complex