oracle.oci.oci_compute_management_cluster_network (5.0.0) — module

Manage a ClusterNetwork resource 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

This module allows the user to create, update and delete a ClusterNetwork resource in Oracle Cloud Infrastructure

For I(state=present), creates a L(cluster network with instance pools,https://docs.cloud.oracle.com/iaas/Content/Compute/Tasks/managingclusternetworks.htm). A cluster network is a group of high performance computing (HPC), GPU, or optimized bare metal instances that are connected with an ultra low-latency remote direct memory access (RDMA) network. Cluster networks with instance pools use instance pools to manage groups of identical instances.

Use cluster networks with instance pools when you want predictable capacity for a specific number of identical instances that are managed as a group.

If you want to manage instances in the RDMA network independently of each other or use different types of instances in the network group, create a compute cluster by using the L(CreateComputeCluster,https://docs.cloud.oracle.com/en- us/iaas/api/#/en/iaas/latest/ComputeCluster/CreateComputeCluster) operation.

To determine whether capacity is available for a specific shape before you create a cluster network, use the L(CreateComputeCapacityReport,https://docs.cloud.oracle.com/en-us/iaas/api/#/en/iaas/latest/ComputeCapacityReport/CreateComputeCapacityReport) operation.

This resource has the following action operations in the M(oracle.oci.oci_compute_management_cluster_network_actions) module: change_compartment.


Requirements

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Create cluster_network
  oci_compute_management_cluster_network:
    # required
    compartment_id: "ocid1.compartment.oc1..xxxxxxEXAMPLExxxxxx"
    placement_configuration:
      # required
      availability_domain: Uocm:PHX-AD-1
      primary_subnet_id: "ocid1.primarysubnet.oc1..xxxxxxEXAMPLExxxxxx"

      # optional
      placement_constraint: SINGLE_TIER
      secondary_vnic_subnets:
      - # required
        subnet_id: "ocid1.subnet.oc1..xxxxxxEXAMPLExxxxxx"

        # optional
        display_name: display_name_example
    instance_pools:
    - # optional
      id: "ocid1.resource.oc1..xxxxxxEXAMPLExxxxxx"
      defined_tags: {'Operations': {'CostCenter': 'US'}}
      display_name: display_name_example
      freeform_tags: {'Department': 'Finance'}
      size: 56
      instance_configuration_id: "ocid1.instanceconfiguration.oc1..xxxxxxEXAMPLExxxxxx"

    # optional
    cluster_configuration:
      # required
      hpc_island_id: "ocid1.hpcisland.oc1..xxxxxxEXAMPLExxxxxx"

      # optional
      network_block_ids: [ "network_block_ids_example" ]
    defined_tags: {'Operations': {'CostCenter': 'US'}}
    display_name: display_name_example
    freeform_tags: {'Department': 'Finance'}
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Update cluster_network
  oci_compute_management_cluster_network:
    # required
    cluster_network_id: "ocid1.clusternetwork.oc1..xxxxxxEXAMPLExxxxxx"

    # optional
    defined_tags: {'Operations': {'CostCenter': 'US'}}
    display_name: display_name_example
    freeform_tags: {'Department': 'Finance'}
    instance_pools:
    - # optional
      id: "ocid1.resource.oc1..xxxxxxEXAMPLExxxxxx"
      defined_tags: {'Operations': {'CostCenter': 'US'}}
      display_name: display_name_example
      freeform_tags: {'Department': 'Finance'}
      size: 56
      instance_configuration_id: "ocid1.instanceconfiguration.oc1..xxxxxxEXAMPLExxxxxx"
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Update cluster_network using name (when environment variable OCI_USE_NAME_AS_IDENTIFIER is set)
  oci_compute_management_cluster_network:
    # required
    compartment_id: "ocid1.compartment.oc1..xxxxxxEXAMPLExxxxxx"
    display_name: display_name_example

    # optional
    defined_tags: {'Operations': {'CostCenter': 'US'}}
    freeform_tags: {'Department': 'Finance'}
    instance_pools:
    - # optional
      id: "ocid1.resource.oc1..xxxxxxEXAMPLExxxxxx"
      defined_tags: {'Operations': {'CostCenter': 'US'}}
      display_name: display_name_example
      freeform_tags: {'Department': 'Finance'}
      size: 56
      instance_configuration_id: "ocid1.instanceconfiguration.oc1..xxxxxxEXAMPLExxxxxx"
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Delete cluster_network
  oci_compute_management_cluster_network:
    # required
    cluster_network_id: "ocid1.clusternetwork.oc1..xxxxxxEXAMPLExxxxxx"
    state: absent
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Delete cluster_network using name (when environment variable OCI_USE_NAME_AS_IDENTIFIER is set)
  oci_compute_management_cluster_network:
    # required
    compartment_id: "ocid1.compartment.oc1..xxxxxxEXAMPLExxxxxx"
    display_name: display_name_example
    state: absent

Inputs

    
wait:
    default: true
    description: Whether to wait for create or delete operation to complete.
    type: bool

state:
    choices:
    - present
    - absent
    default: present
    description:
    - The state of the ClusterNetwork.
    - Use I(state=present) to create or update a ClusterNetwork.
    - Use I(state=absent) to delete a ClusterNetwork.
    required: false
    type: str

key_by:
    description: The list of attributes of this resource which should be used to uniquely
      identify an instance of the resource. By default, all the attributes of a resource
      are used to uniquely identify a resource.
    elements: str
    type: list

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

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

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

defined_tags:
    description:
    - Defined tags for this resource. Each key is predefined and scoped to a namespace.
      For more information, see L(Resource Tags,https://docs.cloud.oracle.com/iaas/Content/General/Concepts/resourcetags.htm).
    - 'Example: `{"Operations": {"CostCenter": "42"}}`'
    - This parameter is updatable.
    type: dict

display_name:
    aliases:
    - name
    description:
    - A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering
      confidential information.
    - Required for create, update, delete when environment variable C(OCI_USE_NAME_AS_IDENTIFIER)
      is set.
    - This parameter is updatable when C(OCI_USE_NAME_AS_IDENTIFIER) is not set.
    type: str

force_create:
    default: false
    description: Whether to attempt non-idempotent creation of a resource. By default,
      create resource is an idempotent operation, and doesn't create the resource if it
      already exists. Setting this option to true, forcefully creates a copy of the resource,
      even if it already exists.This option is mutually exclusive with I(key_by).
    type: bool

wait_timeout:
    description: Time, in seconds, to wait when I(wait=yes). Defaults to 1200 for most
      of the services but some services might have a longer wait timeout.
    type: int

freeform_tags:
    description:
    - Free-form tags for this resource. Each tag is a simple key-value pair with no predefined
      name, type, or namespace. For more information, see L(Resource Tags,https://docs.cloud.oracle.com/iaas/Content/General/Concepts/resourcetags.htm).
    - 'Example: `{"Department": "Finance"}`'
    - This parameter is updatable.
    type: dict

compartment_id:
    description:
    - The L(OCID,https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm)
      of the compartment containing the cluster network.
    - Required for create using I(state=present).
    - Required for update when environment variable C(OCI_USE_NAME_AS_IDENTIFIER) is set.
    - Required for delete when environment variable C(OCI_USE_NAME_AS_IDENTIFIER) is set.
    type: str

instance_pools:
    description:
    - The data to create the instance pools in the cluster network.
    - Each cluster network can have one instance pool.
    - Required for create using I(state=present).
    - This parameter is updatable.
    elements: dict
    suboptions:
      defined_tags:
        description:
        - Defined tags for this resource. Each key is predefined and scoped to a namespace.
          For more information, see L(Resource Tags,https://docs.cloud.oracle.com/iaas/Content/General/Concepts/resourcetags.htm).
        - 'Example: `{"Operations": {"CostCenter": "42"}}`'
        - This parameter is updatable.
        type: dict
      display_name:
        aliases:
        - name
        description:
        - A user-friendly name. Does not have to be unique, and it's changeable. Avoid
          entering confidential information.
        - This parameter is updatable.
        type: str
      freeform_tags:
        description:
        - Free-form tags for this resource. Each tag is a simple key-value pair with no
          predefined name, type, or namespace. For more information, see L(Resource Tags,https://docs.cloud.oracle.com/iaas/Content/General/Concepts/resourcetags.htm).
        - 'Example: `{"Department": "Finance"}`'
        - This parameter is updatable.
        type: dict
      id:
        description:
        - The L(OCID,https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm)
          of the instance pool.
        - This parameter is updatable.
        type: str
      instance_configuration_id:
        description:
        - The L(OCID,https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm)
          of the instance configuration associated with the instance pool.
        - This parameter is updatable.
        type: str
      size:
        description:
        - The number of instances that should be in the instance pool.
        - This parameter is updatable.
        type: int
    type: list

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

cluster_network_id:
    aliases:
    - id
    description:
    - The L(OCID,https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm)
      of the cluster network.
    - Required for update using I(state=present) when environment variable C(OCI_USE_NAME_AS_IDENTIFIER)
      is not set.
    - Required for delete using I(state=absent) when environment variable C(OCI_USE_NAME_AS_IDENTIFIER)
      is not set.
    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

cluster_configuration:
    description:
    - ''
    suboptions:
      hpc_island_id:
        description:
        - The L(OCID,https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm)
          of the HPC island.
        required: true
        type: str
      network_block_ids:
        description:
        - The list of network block OCIDs.
        elements: str
        type: list
    type: dict

placement_configuration:
    description:
    - ''
    - Required for create using I(state=present).
    suboptions:
      availability_domain:
        description:
        - The availability domain to place instances.
        - 'Example: `Uocm:PHX-AD-1`'
        required: true
        type: str
      placement_constraint:
        choices:
        - SINGLE_TIER
        - SINGLE_BLOCK
        - PACKED_DISTRIBUTION_MULTI_BLOCK
        description:
        - The placement constraint when reserving hosts.
        type: str
      primary_subnet_id:
        description:
        - The L(OCID,https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm)
          of the primary subnet to place instances.
        required: true
        type: str
      secondary_vnic_subnets:
        description:
        - The set of secondary VNIC data for instances in the pool.
        elements: dict
        suboptions:
          display_name:
            aliases:
            - name
            description:
            - The display name of the VNIC. This is also used to match against the instance
              configuration defined secondary VNIC.
            type: str
          subnet_id:
            description:
            - The subnet L(OCID,https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm)
              for the secondary VNIC.
            required: true
            type: str
        type: list
    type: dict

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

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

cluster_network:
  contains:
    compartment_id:
      description:
      - The L(OCID,https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm)
        of the compartment containing the cluster network.
      returned: on success
      sample: ocid1.compartment.oc1..xxxxxxEXAMPLExxxxxx
      type: str
    defined_tags:
      description:
      - Defined tags for this resource. Each key is predefined and scoped to a namespace.
        For more information, see L(Resource Tags,https://docs.cloud.oracle.com/iaas/Content/General/Concepts/resourcetags.htm).
      - 'Example: `{"Operations": {"CostCenter": "42"}}`'
      returned: on success
      sample:
        Operations:
          CostCenter: US
      type: dict
    display_name:
      description:
      - A user-friendly name. Does not have to be unique, and it's changeable. Avoid
        entering confidential information.
      returned: on success
      sample: display_name_example
      type: str
    freeform_tags:
      description:
      - Free-form tags for this resource. Each tag is a simple key-value pair with
        no predefined name, type, or namespace. For more information, see L(Resource
        Tags,https://docs.cloud.oracle.com/iaas/Content/General/Concepts/resourcetags.htm).
      - 'Example: `{"Department": "Finance"}`'
      returned: on success
      sample:
        Department: Finance
      type: dict
    hpc_island_id:
      description:
      - The L(OCID,https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm)
        of the HPC island used by the cluster network.
      returned: on success
      sample: ocid1.hpcisland.oc1..xxxxxxEXAMPLExxxxxx
      type: str
    id:
      description:
      - The L(OCID,https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm)
        of the cluster network.
      returned: on success
      sample: ocid1.resource.oc1..xxxxxxEXAMPLExxxxxx
      type: str
    instance_pools:
      contains:
        compartment_id:
          description:
          - The L(OCID,https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm)
            of the compartment containing the instance pool.
          returned: on success
          sample: ocid1.compartment.oc1..xxxxxxEXAMPLExxxxxx
          type: str
        defined_tags:
          description:
          - Defined tags for this resource. Each key is predefined and scoped to a
            namespace. For more information, see L(Resource Tags,https://docs.cloud.oracle.com/iaas/Content/General/Concepts/resourcetags.htm).
          - 'Example: `{"Operations": {"CostCenter": "42"}}`'
          returned: on success
          sample:
            Operations:
              CostCenter: US
          type: dict
        display_name:
          description:
          - A user-friendly name. Does not have to be unique, and it's changeable.
            Avoid entering confidential information.
          returned: on success
          sample: display_name_example
          type: str
        freeform_tags:
          description:
          - Free-form tags for this resource. Each tag is a simple key-value pair
            with no predefined name, type, or namespace. For more information, see
            L(Resource Tags,https://docs.cloud.oracle.com/iaas/Content/General/Concepts/resourcetags.htm).
          - 'Example: `{"Department": "Finance"}`'
          returned: on success
          sample:
            Department: Finance
          type: dict
        id:
          description:
          - The L(OCID,https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm)
            of the instance pool.
          returned: on success
          sample: ocid1.resource.oc1..xxxxxxEXAMPLExxxxxx
          type: str
        instance_configuration_id:
          description:
          - The L(OCID,https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm)
            of the instance configuration associated with the instance pool.
          returned: on success
          sample: ocid1.instanceconfiguration.oc1..xxxxxxEXAMPLExxxxxx
          type: str
        instance_display_name_formatter:
          description:
          - A user-friendly formatter for the instance pool's instances. Instance
            displaynames follow the format. The formatter does not retroactively change
            instance's displaynames, only instance displaynames in the future follow
            the format
          returned: on success
          sample: instance_display_name_formatter_example
          type: str
        instance_hostname_formatter:
          description:
          - A user-friendly formatter for the instance pool's instances. Instance
            hostnames follow the format. The formatter does not retroactively change
            instance's hostnames, only instance hostnames in the future follow the
            format
          returned: on success
          sample: instance_hostname_formatter_example
          type: str
        lifecycle_state:
          description:
          - The current state of the instance pool.
          returned: on success
          sample: PROVISIONING
          type: str
        load_balancers:
          contains:
            backend_set_name:
              description:
              - The name of the backend set on the load balancer.
              returned: on success
              sample: backend_set_name_example
              type: str
            id:
              description:
              - The L(OCID,https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm)
                of the load balancer attachment.
              returned: on success
              sample: ocid1.resource.oc1..xxxxxxEXAMPLExxxxxx
              type: str
            instance_pool_id:
              description:
              - The L(OCID,https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm)
                of the instance pool of the load balancer attachment.
              returned: on success
              sample: ocid1.instancepool.oc1..xxxxxxEXAMPLExxxxxx
              type: str
            lifecycle_state:
              description:
              - The status of the interaction between the instance pool and the load
                balancer.
              returned: on success
              sample: ATTACHING
              type: str
            load_balancer_id:
              description:
              - The L(OCID,https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm)
                of the load balancer attached to the instance pool.
              returned: on success
              sample: ocid1.loadbalancer.oc1..xxxxxxEXAMPLExxxxxx
              type: str
            port:
              description:
              - The port value used for the backends.
              returned: on success
              sample: 56
              type: int
            vnic_selection:
              description:
              - Indicates which VNIC on each instance in the instance pool should
                be used to associate with the load balancer. Possible values are "PrimaryVnic"
                or the displayName of one of the secondary VNICs on the instance configuration
                that is associated with the instance pool.
              returned: on success
              sample: vnic_selection_example
              type: str
          description:
          - The load balancers attached to the instance pool.
          returned: on success
          type: complex
        placement_configurations:
          contains:
            availability_domain:
              description:
              - The availability domain to place instances.
              - 'Example: `Uocm:PHX-AD-1`'
              returned: on success
              sample: Uocm:PHX-AD-1
              type: str
            fault_domains:
              description:
              - The fault domains to place instances.
              - If you don't provide any values, the system makes a best effort to
                distribute instances across all fault domains based on capacity.
              - To distribute the instances evenly across selected fault domains,
                provide a set of fault domains. For example, you might want instances
                to be evenly distributed if your applications require high availability.
              - To get a list of fault domains, use the L(ListFaultDomains,https://docs.cloud.oracle.com/en-us/iaas/api/#/en/identity/20160918/FaultDomain/ListFaultDomains)
                operation in the Identity and Access Management Service API.
              - 'Example: `[FAULT-DOMAIN-1, FAULT-DOMAIN-2, FAULT-DOMAIN-3]`'
              returned: on success
              sample: []
              type: list
            primary_subnet_id:
              description:
              - The L(OCID,https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm)
                of the primary subnet in which to place instances.
              returned: on success
              sample: ocid1.primarysubnet.oc1..xxxxxxEXAMPLExxxxxx
              type: str
            secondary_vnic_subnets:
              contains:
                display_name:
                  description:
                  - The display name of the VNIC. This is also used to match against
                    the instance configuration defined secondary VNIC.
                  returned: on success
                  sample: display_name_example
                  type: str
                subnet_id:
                  description:
                  - The subnet L(OCID,https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm)
                    for the secondary VNIC.
                  returned: on success
                  sample: ocid1.subnet.oc1..xxxxxxEXAMPLExxxxxx
                  type: str
              description:
              - The set of secondary VNIC data for instances in the pool.
              returned: on success
              type: complex
          description:
          - The placement configurations for the instance pool.
          returned: on success
          type: complex
        size:
          description:
          - The number of instances that should be in the instance pool.
          returned: on success
          sample: 56
          type: int
        time_created:
          description:
          - 'The date and time the instance pool was created, in the format defined
            by L(RFC3339,https://tools.ietf.org/html/rfc3339). Example: `2016-08-25T21:10:29.600Z`'
          returned: on success
          sample: '2013-10-20T19:20:30+01:00'
          type: str
      description:
      - The instance pools in the cluster network.
      - Each cluster network can have one instance pool.
      returned: on success
      type: complex
    lifecycle_state:
      description:
      - The current state of the cluster network.
      returned: on success
      sample: PROVISIONING
      type: str
    network_block_ids:
      description:
      - The list of network block OCIDs of the HPC island.
      returned: on success
      sample: []
      type: list
    placement_configuration:
      contains:
        availability_domain:
          description:
          - The availability domain to place instances.
          - 'Example: `Uocm:PHX-AD-1`'
          returned: on success
          sample: Uocm:PHX-AD-1
          type: str
        placement_constraint:
          description:
          - The placement constraint when reserving hosts.
          returned: on success
          sample: SINGLE_TIER
          type: str
        primary_subnet_id:
          description:
          - The L(OCID,https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm)
            of the primary subnet to place instances.
          returned: on success
          sample: ocid1.primarysubnet.oc1..xxxxxxEXAMPLExxxxxx
          type: str
        secondary_vnic_subnets:
          contains:
            display_name:
              description:
              - The display name of the VNIC. This is also used to match against the
                instance configuration defined secondary VNIC.
              returned: on success
              sample: display_name_example
              type: str
            subnet_id:
              description:
              - The subnet L(OCID,https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm)
                for the secondary VNIC.
              returned: on success
              sample: ocid1.subnet.oc1..xxxxxxEXAMPLExxxxxx
              type: str
          description:
          - The set of secondary VNIC data for instances in the pool.
          returned: on success
          type: complex
      description:
      - ''
      returned: on success
      type: complex
    time_created:
      description:
      - The date and time the resource was created, in the format defined by L(RFC3339,https://tools.ietf.org/html/rfc3339).
      - 'Example: `2016-08-25T21:10:29.600Z`'
      returned: on success
      sample: '2013-10-20T19:20:30+01:00'
      type: str
    time_updated:
      description:
      - The date and time the resource was updated, in the format defined by L(RFC3339,https://tools.ietf.org/html/rfc3339).
      - 'Example: `2016-08-25T21:10:29.600Z`'
      returned: on success
      sample: '2013-10-20T19:20:30+01:00'
      type: str
  description:
  - Details of the ClusterNetwork resource acted upon by the current operation
  returned: on success
  sample:
    compartment_id: ocid1.compartment.oc1..xxxxxxEXAMPLExxxxxx
    defined_tags:
      Operations:
        CostCenter: US
    display_name: display_name_example
    freeform_tags:
      Department: Finance
    hpc_island_id: ocid1.hpcisland.oc1..xxxxxxEXAMPLExxxxxx
    id: ocid1.resource.oc1..xxxxxxEXAMPLExxxxxx
    instance_pools:
    - compartment_id: ocid1.compartment.oc1..xxxxxxEXAMPLExxxxxx
      defined_tags:
        Operations:
          CostCenter: US
      display_name: display_name_example
      freeform_tags:
        Department: Finance
      id: ocid1.resource.oc1..xxxxxxEXAMPLExxxxxx
      instance_configuration_id: ocid1.instanceconfiguration.oc1..xxxxxxEXAMPLExxxxxx
      instance_display_name_formatter: instance_display_name_formatter_example
      instance_hostname_formatter: instance_hostname_formatter_example
      lifecycle_state: PROVISIONING
      load_balancers:
      - backend_set_name: backend_set_name_example
        id: ocid1.resource.oc1..xxxxxxEXAMPLExxxxxx
        instance_pool_id: ocid1.instancepool.oc1..xxxxxxEXAMPLExxxxxx
        lifecycle_state: ATTACHING
        load_balancer_id: ocid1.loadbalancer.oc1..xxxxxxEXAMPLExxxxxx
        port: 56
        vnic_selection: vnic_selection_example
      placement_configurations:
      - availability_domain: Uocm:PHX-AD-1
        fault_domains: []
        primary_subnet_id: ocid1.primarysubnet.oc1..xxxxxxEXAMPLExxxxxx
        secondary_vnic_subnets:
        - display_name: display_name_example
          subnet_id: ocid1.subnet.oc1..xxxxxxEXAMPLExxxxxx
      size: 56
      time_created: '2013-10-20T19:20:30+01:00'
    lifecycle_state: PROVISIONING
    network_block_ids: []
    placement_configuration:
      availability_domain: Uocm:PHX-AD-1
      placement_constraint: SINGLE_TIER
      primary_subnet_id: ocid1.primarysubnet.oc1..xxxxxxEXAMPLExxxxxx
      secondary_vnic_subnets:
      - display_name: display_name_example
        subnet_id: ocid1.subnet.oc1..xxxxxxEXAMPLExxxxxx
    time_created: '2013-10-20T19:20:30+01:00'
    time_updated: '2013-10-20T19:20:30+01:00'
  type: complex