Add Application With Tiers

Add Application With Tiers

Creates a manual application or saves discovered application. While saving discovered application user can curate it. This API also allows to merge multiple discovered application and save it as a single saved applicaiton. For merging application, customer should add criteria of tiers to be merged in one tier and similarly update rest of the imformation. Also, allows edit of saved application. To make sure changes are being applied on latest saved app, use "If-Match" header.

Request
URI
POST
https://{api_host}/api/ni/groups/applications/full/
COPY
Header Parameters
integer
If-Match
Optional

Represent lastModifiedTimestamp of application definition which user is modifying


Request Body
AppWithTiersRequest of type(s) application/json
Required
{
    "name": "string",
    "entity_id": "string",
    "source_group_entity_id": [
        "string"
    ],
    "enable_intent": false,
    "tiers": [
        {
            "name": "tier-1",
            "source_group_entity_id": [
                "18230:566:264351372"
            ],
            "group_membership_criteria": [
                {
                    "membership_type": "SearchMembershipCriteria",
                    "search_membership_criteria": {
                        "entity_type": "VirtualMachine",
                        "filter": "security_groups.entity_id = '18230:82:604573173'"
                    }
                },
                {
                    "membership_type": "IPAddressMembershipCriteria",
                    "ip_address_membership_criteria": {
                        "ip_addresses": [
                            "10.0.0.1",
                            "10.0.0.1/24",
                            "10.0.0.1-10.0.0.200"
                        ]
                    }
                }
            ],
            "member_list": {
                "vms": [
                    {
                        "key": {
                            "entity_id": "18230:1:1158969162",
                            "entity_type": "VIRTUALMACHINE"
                        },
                        "name": "VM1"
                    },
                    {
                        "key": {
                            "entity_id": "18230:601:863301375",
                            "entity_type": "EC2INSTANCE"
                        },
                        "name": "EC2-VM1"
                    },
                    {
                        "key": {
                            "entity_id": "18230:1702:264351372",
                            "entity_type": "AZUREVM"
                        },
                        "name": "Azure-VM1"
                    }
                ],
                "physical_ips": [
                    {
                        "key": {
                            "entity_id": "18230:541:365252372",
                            "entity_type": "IPENDPOINT"
                        },
                        "name": "52.35.41.245"
                    }
                ],
                "kubernetes_services": [
                    {
                        "key": {
                            "entity_id": "18230:1504:263252172",
                            "entity_type": "KUBERNETESSERVICE"
                        },
                        "name": "KS"
                    }
                ]
            }
        }
    ]
}
string
name
Optional

name

string
entity_id
Optional

entity_id

array of string
source_group_entity_id
Optional

Entity ID of corresponding discovered application. It's recommended to not merge tiers and use only one source group.

boolean
enable_intent
Optional

Enabling intent will enable 2 intents which will creates a dynamic threshold configuration that analyses "Application flow health" and "Application flow utilization" for all VMs belonging to the application at tier level and generates alerts if violation is detected for any of them based on their historic behavior.

tiers
Optional

tiers

Authentication
This operation uses the following authentication methods.
Responses
201

Created

Returns Application of type(s) application/json
This response body class contains all of the following: BaseEntity , InlineApplication1
{
    "entity_id": "1000:104:12213212",
    "name": "My Name",
    "entity_type": "VirtualMachine",
    "create_time": 159724400600,
    "created_by": "admin@local",
    "last_modified_time": 159724400600,
    "last_modified_by": "[email protected]",
    "last_modified_by_service": "Ensemble",
    "tier_count": 25,
    "member_count": 500,
    "update_status": "string",
    "confidence": "Medium"
}

400

Bad Request

Returns ApiError of type(s) application/json
{
    "code": 0,
    "message": "string",
    "details": [
        {
            "code": 0,
            "message": "string",
            "target": [
                "string"
            ]
        }
    ]
}
integer As int32 As int32
code
Optional

code

string
message
Optional

message

details
Optional

details


401

Unauthorized

Operation doesn't return any data structure

403

Forbidden

Operation doesn't return any data structure

404

Not Found

Operation doesn't return any data structure

500

Internal Error

Operation doesn't return any data structure