Edit Application Tier
Edit tier in application
Edit a tier of an application with specified membership criteria or members list. The membership criteria is defined in terms of virtual machines or IP addresses/subnet. Please refer to API Guide on how to construct membership criteria.
Request
URI
PUT
https://{api_host}/api/ni/groups/applications/{id}/tiers/{tier-id}
COPY
Path Parameters
string
id
Required
The Entity ID of object requestion information on
string
tier-id
Required
tier-id
Request Body
TierRequest
of type(s)
application/json
Required
{
"name": "string",
"entity_id": "string",
"group_membership_criteria": [
{
"membership_type": "string",
"ip_address_membership_criteria": {
"ip_addresses": [
"string"
]
},
"search_membership_criteria": {
"entity_type": "string",
"filter": "string"
}
}
],
"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"
}
]
},
"source_group_entity_id": [
"string"
]
}
string
name
Optional
name
string
entity_id
Optional
entity_id
array of
object
group_membership_criteria
Optional
EntityType currently restricted to VirtualMachine
object
member_list
Optional
Member list
array of
string
source_group_entity_id
Optional
Entity ID of corresponding tier application.
Responses
201
Created
Returns
Tier
of type(s)
application/json
This response body class contains all of the following:
BaseEntity ,
InlineTier1
{
"entity_id": "18230:562:1266458745",
"name": "tier-1",
"entity_type": "Tier",
"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"
}
]
},
"application": {
"entity_id": "18230:561:271275765",
"entity_type": "Application"
}
}
400
Bad Request
Returns
BadRequestResponse
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
object
details
Optional
details
401
Unauthorized
Returns
UnauthorizedResponse
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
object
details
Optional
details
403
Forbidden
Returns
ForbiddenResponse
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
object
details
Optional
details
404
Not Found
Returns
NotFoundResponse
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
object
details
Optional
details
500
Internal error
Returns
InternalErrorResponse
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
object
details
Optional
details
Code Samples
COPY
curl -X PUT -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '{}' https://{api_host}/api/ni/groups/applications/{id}/tiers/{tier-id}
On This Page
Applications Operations
GET
List Applications
POST
Add Application
GET
Get Application By Id
DELETE
Delete Application
GET
Get Bulk Application Task Progress
POST
Save Discovered Applications
GET
Get App Problems
GET
Get Application Vms
POST
Get Applications Members
POST
Get Tiers Members
GET
Get Application Flow Summary
GET
Get App Flow Properties
GET
Get App Flow Metrics
GET
Get App Top Talking Members
GET
Get App Top Talking Pairs
GET
Get Saved Applications Summaries
GET
List Application Tiers
POST
Add Tier
POST
Add Application With Tiers
GET
Get Application Tier
PUT
Edit Application Tier
DELETE
Delete Tier
GET
Get Tier
GET
Get Discovered Applications
GET
Get Discovered Application Summaries
GET
Get Application Updates
GET
Get FBAD Config Ids
POST
Create FBAD Config
GET
Get FBAD Config
PUT
Update FBAD Config
DELETE
Delete FBAD Config
GET
Get FBAD Progress
GET
Get CSV Used For FBAD
GET
Export FBADCSV Errors
POST
Upload FBADCSV