Skip to main content

Contract

Location in GUI: Tenants » XXX » Contracts » Standard

Diagram

Classes

tenants (apic)

NameTypeConstraintMandatoryDefault Value
contractsList[contracts]No

contracts (apic.tenants)

NameTypeConstraintMandatoryDefault Value
nameStringRegex: ^[a-zA-Z0-9_.:-]{1,64}$Yes
aliasStringRegex: ^[a-zA-Z0-9_.:-]{1,64}$No
descriptionStringRegex: ^[a-zA-Z0-9\\!#$%()*,-./:;@ _{|}~?&+]{1,128}$No
scopeChoiceapplication-profile, tenant, context, globalNocontext
qos_classChoicelevel1, level2, level3, level4, level5, level6, unspecifiedNounspecified
target_dscpAnyChoice[CS0, CS1, AF11, AF12, AF13, CS2, AF21, AF22, AF23, CS3, AF31, AF32, AF33, CS4, AF41, AF42, AF43, CS5, VA, EF, CS6, CS7, unspecified] or Integer[min: 0, max: 63]Nounspecified
subjectsList[subjects]No
expected_stateClass[expected_state]No

subjects (apic.tenants.contracts)

NameTypeConstraintMandatoryDefault Value
nameStringRegex: ^[a-zA-Z0-9_.:-]{1,64}$Yes
aliasStringRegex: ^[a-zA-Z0-9_.:-]{1,64}$No
descriptionStringRegex: ^[a-zA-Z0-9\\!#$%()*,-./:;@ _{|}~?&+]{1,128}$No
qos_classChoicelevel1, level2, level3, level4, level5, level6, unspecifiedNounspecified
target_dscpAnyChoice[CS0, CS1, AF11, AF12, AF13, CS2, AF21, AF22, AF23, CS3, AF31, AF32, AF33, CS4, AF41, AF42, AF43, CS5, VA, EF, CS6, CS7, unspecified] or Integer[min: 0, max: 63]Nounspecified
service_graphStringRegex: ^[a-zA-Z0-9_.:-]{1,64}$No
filtersList[filters]No

expected_state (apic.tenants.contracts)

NameTypeConstraintMandatoryDefault Value
minimum_healthIntegermin: 0, max: 100No
maximum_critical_faultsIntegermin: 0No
maximum_major_faultsIntegermin: 0No
maximum_minor_faultsIntegermin: 0No

filters (apic.tenants.contracts.subjects)

NameTypeConstraintMandatoryDefault Value
filterStringRegex: ^[a-zA-Z0-9_.:-]{1,64}$Yes
actionChoicepermit, denyNopermit
priorityChoicedefault, level1, level2, level3Nodefault
logBooleantrue, falseNofalse
no_statsBooleantrue, falseNofalse

Examples

Simple example:

apic:
tenants:
- name: ABC
contracts:
- name: CON1
subjects:
- name: SUB1
filters:
- filter: HTTP

Full example:

apic:
tenants:
- name: ABC
contracts:
- name: CON1
alias: CON1-ALIAS
description: My Desc
scope: global
qos_class: level3
target_dscp: AF13
subjects:
- name: SUB1
alias: SUB1-ALIAS
description: My Desc
service_graph: TEMPLATE1
qos_class: level3
target_dscp: AF13
filters:
- filter: FILTER1
action: permit
priority: default
log: true
no_stats: false