Add Application With Tiers | VMware Aria Operations for Networks API

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.

array of TierRequest

tiers

Optional

tiers

Authentication

This operation uses the following authentication methods.

ApiKeyAuth

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": "someone@else.com",
    "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

array of ErrorDetail

details

Optional

details