intersight_server_pool_qualification_policy

Server Pool Qualification Policy configuration for Cisco Intersight

Collection: cisco.intersight

Full Name: cisco.intersight.intersight_server_pool_qualification_policy

Synopsis

Server Pool Qualification Policy configuration for Cisco Intersight

Parameters

Name	Type	Required	Default	Description
api_private_key	string			Filename (absolute path) or string of PEM formatted private key data to be used for Intersight API authentication. If a string is used, Ansible vault should be used to encrypt string data. Ex. ansible-vault encrypt_string –vault-id tme@/Users/dsoper/Documents/vault_password_file ‘—–BEGIN EC PRIVATE KEY—– —–END EC PRIVATE KEY—–’ If not set, the value of the INTERSIGHT_API_PRIVATE_KEY environment variable is used. Required if I(api_bearer_token) is not provided. Secret value; omitted from logs and results.
api_uri	string		`https://intersight.com/api/v1`	URI used to access the Intersight API. If not set, the value of the INTERSIGHT_API_URI environment variable is used.
api_key_id	string			Public API Key ID associated with the private key. If not set, the value of the INTERSIGHT_API_KEY_ID environment variable is used. Required if I(api_bearer_token) is not provided.
api_bearer_token	string			Bearer token for OAuth2 authentication with the Intersight API. When provided, I(api_key_id) and I(api_private_key) are not required and the C(cryptography) Python library is not needed. If not set, the value of the INTERSIGHT_API_BEARER_TOKEN environment variable is used. Secret value; omitted from logs and results.
validate_certs	bool		`true`	Boolean control for verifying the api_uri TLS certificate
use_proxy	bool		`true`	If C(no), it will not use a proxy, even if one is defined in an environment variable on the target hosts.
state	string		`present`	If C(present), will verify the resource is present and will create if needed. If C(absent), will verify the resource is absent and will delete if needed. Choices: `present`, `absent`
organization	string		`default`	The name of the Organization this resource is assigned to. Profiles and Policies that are created within a Custom Organization are applicable only to devices in the same Organization.
name	string	yes		The name assigned to the Server Pool Qualification Policy. The name must be between 1 and 64 alphanumeric characters, allowing special characters :-_.
description	string			The user-defined description for the Server Pool Qualification Policy. Description can contain letters(a-z, A-Z), numbers(0-9), hyphen(-), period(.), colon(:), or an underscore(_).
tags	list			List of tags in Key: Value: format.
domain_qualifier	dict			Domain qualifier for Fabric Interconnect and domain-based qualification. Nested options: fabric_interconnect_pids (list); domain_names (list)
rack_server_qualifier	dict			Rack server qualifier for qualifying rack-based servers. Nested options: rack_id_ranges (list) {Nested options: min_value (int) required; max_value (int) required}; pids (list); asset_tags (list); user_labels (list)
blade_qualifier	dict			Blade qualifier for qualifying blade-based servers. Nested options: pids (list); chassis_pids (list); asset_tags (list); user_labels (list); chassis_slot_ranges (list) {Nested options: chassis_id_range (dict) required {Nested options: min_value (int) required; max_value (int) required}; slot_id_ranges (list) {Nested options: min_value (int) required; max_value (int) required}}
tag_qualifier	dict			Tag qualifier for qualifying resources based on tags. Nested options: server_tags (list) {Nested options: key (str) required; value (str) required}; domain_profile_tags (list) {Nested options: key (str) required; value (str) required}; chassis_tags (list) {Nested options: key (str) required; value (str) required}
memory_qualifier	dict			Memory qualifier for qualifying servers based on memory specifications. Nested options: capacity_range (dict) {Nested options: min_value (int) required; max_value (int) required}; units_range (dict) {Nested options: min_value (int) required; max_value (int) required}
gpu_qualifier	dict			GPU qualifier for qualifying servers based on GPU specifications. If not specified, a default GPU qualifier with C(servers_without_gpu) evaluation type is automatically added. Nested options: evaluation_type (str) default=servers_without_gpu; gpu_count_range (dict) {Nested options: min_value (int) required; max_value (int) required}; pids (list); vendor (str)
processor_qualifier	dict			Processor qualifier for qualifying servers based on CPU specifications. Nested options: cores_range (dict) {Nested options: min_value (int) required; max_value (int) required}; speed_range (dict) {Nested options: min_value (int) required; max_value (int) required}; pids (list); vendor (str)
network_adaptor_qualifier	dict			Network adaptor qualifier for qualifying servers based on network adaptor count. Nested options: adaptors_range (dict) {Nested options: min_value (int) required; max_value (int) required}

Example

yaml

- cisco.intersight.intersight_server_pool_qualification_policy:
    api_key_id: '{{ api_key_id }}'
    api_private_key: '{{ api_private_key }}'
    description: Minimal policy - GPU qualifier automatically added with servers_without_gpu
    name: ServerPool-Minimal-Policy
    organization: default
    state: present
  name: Create minimal Server Pool Qualification Policy

- cisco.intersight.intersight_server_pool_qualification_policy:
    api_key_id: '{{ api_key_id }}'
    api_private_key: '{{ api_private_key }}'
    description: Server pool qualification with domain and rack filters
    domain_qualifier:
        domain_names:
            - AC08-6454
        fabric_interconnect_pids:
            - ucs-fi-6454
            - ucs-fi-64108
    name: ServerPool-Qual-Policy-01
    organization: default
    rack_server_qualifier:
        asset_tags:
            - production
        pids:
            - UCSC-C245-M8SX
            - UCSC-C220-M8S
        rack_id_ranges:
            - max_value: 4
              min_value: 2
            - max_value: 8
              min_value: 5
        user_labels:
            - datacenter-a
    state: present
  name: Create Server Pool Qualification Policy with domain and rack qualifiers

- cisco.intersight.intersight_server_pool_qualification_policy:
    api_key_id: '{{ api_key_id }}'
    api_private_key: '{{ api_private_key }}'
    blade_qualifier:
        chassis_pids:
            - N20-C6508
        chassis_slot_ranges:
            - chassis_id_range:
                max_value: 10
                min_value: 2
              slot_id_ranges:
                - max_value: 6
                  min_value: 4
        pids:
            - UCSB-B480-M5
            - UCSB-B200-M5
    memory_qualifier:
        capacity_range:
            max_value: 512
            min_value: 64
        units_range:
            max_value: 20
            min_value: 10
    name: ServerPool-Blade-Policy
    state: present
  name: Create Server Pool Qualification Policy with blade and memory qualifiers

- cisco.intersight.intersight_server_pool_qualification_policy:
    api_key_id: '{{ api_key_id }}'
    api_private_key: '{{ api_private_key }}'
    description: Policy for servers with NVIDIA GPUs
    gpu_qualifier:
        evaluation_type: servers_with_gpu
        gpu_count_range:
            max_value: 4
            min_value: 2
        vendor: nvidia
    name: ServerPool-GPU-Policy
    processor_qualifier:
        cores_range:
            max_value: 64
            min_value: 16
        vendor: intel
    state: present
  name: Create Server Pool Qualification Policy with GPU requirements

- cisco.intersight.intersight_server_pool_qualification_policy:
    api_key_id: '{{ api_key_id }}'
    api_private_key: '{{ api_private_key }}'
    name: ServerPool-Tag-Policy
    network_adaptor_qualifier:
        adaptors_range:
            max_value: 8
            min_value: 2
    state: present
    tag_qualifier:
        chassis_tags:
            - key: location
              value: datacenter-a
        server_tags:
            - key: environment
              value: production
            - key: tier
              value: "1"
  name: Create Server Pool Qualification Policy with tag qualifiers

- cisco.intersight.intersight_server_pool_qualification_policy:
    api_key_id: '{{ api_key_id }}'
    api_private_key: '{{ api_private_key }}'
    blade_qualifier:
        pids:
            - UCSX-210C-M7
            - UCSX-410C-M7
    description: Comprehensive qualification policy with multiple qualifiers
    domain_qualifier:
        fabric_interconnect_pids:
            - ucs-fi-6454
    gpu_qualifier:
        evaluation_type: servers_without_gpu
    memory_qualifier:
        capacity_range:
            max_value: 1024
            min_value: 128
    name: ServerPool-Comprehensive-Policy
    network_adaptor_qualifier:
        adaptors_range:
            max_value: 4
            min_value: 2
    organization: Production
    processor_qualifier:
        cores_range:
            max_value: 128
            min_value: 32
        vendor: intel
    rack_server_qualifier:
        pids:
            - UCSC-C220-M6S
            - UCSC-C240-M6S
    state: present
    tags:
        - Key: Environment
          Value: Production
  name: Create comprehensive Server Pool Qualification Policy

- cisco.intersight.intersight_server_pool_qualification_policy:
    api_key_id: '{{ api_key_id }}'
    api_private_key: '{{ api_private_key }}'
    name: ServerPool-Qual-Policy-01
    state: absent
  name: Delete Server Pool Qualification Policy