[{"label":"Latest (v1.0)","version":"latest"}]
nsx-vmc-policy

Create Tier 0

Description

If a Tier-0 with the tier-0-id is not already present, create a new Tier-0. If it already exists, replace the Tier-0 instance with the new object.

Request

Request

URL

URL


put
https://nsxmanager.your.domain/policy/api/v1/infra/tier-0s/{tier-0-id}
Copy

Path Parameters

Path Parameters

string
tier-0-id Required

Request Body

Request Body

Tier0 of type(s) application/json Required
This request body class requires all of the following: PolicyConfigResource, InlineTier01
Authentication

Authentication

This operation uses the following authentication methods.

Response

Response

Response Body

Response Body

200 OK

Returns Tier0 of type(s) application/json
This response body class contains all of the following: PolicyConfigResource, InlineTier01
Errors

Errors

400

Bad Request


403

Forbidden


404

Not Found


412

Precondition Failed


500

Internal Server Error


503

Service Unavailable

Code Samples

Code Samples

PowerCLI Client SDK Example

$ResourceLink = Initialize-ResourceLink -Action "MyAction" -Href "MyHref" -Rel "MyRel"
$SelfResourceLink = Initialize-SelfResourceLink -Action "MyAction" -Href "MyHref" -Rel "MyRel"
$Tag = Initialize-Tag -Scope "MyScope" -_Tag "My_Tag"
$PolicyRequestParameter = Initialize-PolicyRequestParameter -ResourceType "MyResourceType"
$ChildPolicyConfigResource = Initialize-ChildPolicyConfigResource -Links $ResourceLink -Schema "MySchema" -Self $SelfResourceLink -Revision 0 -CreateTime 0 -CreateUser "MyCreateUser" -LastModifiedTime 0 -LastModifiedUser "MyLastModifiedUser" -Protection "MyProtection" -SystemOwned $false -Description "MyDescription" -DisplayName "MyDisplayName" -Id "MyId" -ResourceType "MyResourceType" -Tags $Tag -MarkForOverride $false -MarkedForDelete $false -RequestParameter $PolicyRequestParameter
$Tier0AdvancedConfig = Initialize-Tier0AdvancedConfig -Connectivity "ON" -ForwardingUpTimer 0
$SiteAllocationIndexForEdge = Initialize-SiteAllocationIndexForEdge -Index 0 -TargetResourcePath "MyTargetResourcePath"
$FederationGatewayConfig = Initialize-FederationGatewayConfig -GlobalOverlayId 0 -SiteAllocationIndices $SiteAllocationIndexForEdge -TransitSegmentId "MyTransitSegmentId"
$IntersiteGatewayConfig = Initialize-IntersiteGatewayConfig -FallbackSites "MyFallbackSites" -IntersiteTransitSubnet "MyIntersiteTransitSubnet" -LastAdminActiveEpoch 0 -PrimarySitePath "MyPrimarySitePath"
$VrfRouteTargets = Initialize-VrfRouteTargets -AddressFamily "L2VPN_EVPN" -ExportRouteTargets "MyExportRouteTargets" -ImportRouteTargets "MyImportRouteTargets"
$VrfL2VniConfig = Initialize-VrfL2VniConfig -L2Vni 0 -RouteDistinguisher "MyRouteDistinguisher" -RouteTargets $VrfRouteTargets
$VrfEvpnL2VniConfig = Initialize-VrfEvpnL2VniConfig -EnableVtepGroups $false -L2VniConfigs $VrfL2VniConfig
$Tier0VrfConfig = Initialize-Tier0VrfConfig -EvpnL2VniConfig $VrfEvpnL2VniConfig -EvpnTransitVni 0 -RouteDistinguisher "MyRouteDistinguisher" -RouteTargets $VrfRouteTargets -Tier0Path "MyTier0Path"
$Tier0 = Initialize-Tier0 -Links $ResourceLink -Schema "MySchema" -Self $SelfResourceLink -Revision 0 -CreateTime 0 -CreateUser "MyCreateUser" -LastModifiedTime 0 -LastModifiedUser "MyLastModifiedUser" -Protection "MyProtection" -SystemOwned $false -Description "MyDescription" -DisplayName "MyDisplayName" -Id "MyId" -ResourceType "MyResourceType" -Tags $Tag -ParentPath "MyParentPath" -Path "MyPath" -RealizationId "MyRealizationId" -RelativePath "MyRelativePath" -UniqueId "MyUniqueId" -Children $ChildPolicyConfigResource -MarkedForDelete $false -Overridden $false -AdvancedConfig $Tier0AdvancedConfig -ArpLimit 0 -DefaultRuleLogging $false -DhcpConfigPaths "MyDhcpConfigPaths" -DisableFirewall $false -FailoverMode "PREEMPTIVE" -FederationConfig $FederationGatewayConfig -ForceWhitelisting $false -HaMode "ACTIVE_ACTIVE" -InternalTransitSubnets "MyInternalTransitSubnets" -IntersiteConfig $IntersiteGatewayConfig -Ipv6ProfilePaths "MyIpv6ProfilePaths" -RdAdminField "MyRdAdminField" -TransitSubnets "MyTransitSubnets" -VrfConfig $Tier0VrfConfig
Invoke-CreateOrReplaceTier0 -tier0Id "Mytier0Id" -tier0 $tier0

cURL Command

curl -X PUT -H "Content-Type: application/json" -d '{}' https://nsxmanager.your.domain/policy/api/v1/infra/tier-0s/{tier-0-id}
Vendor Extensions

Vendor Extensions

This operation contains the following vendor extensions defined in the spec:
x-vmw-doc-operation: create-tier-0
x-vmw-nsx-module: PolicyConnectivity


[{"label":"Latest (v1.0)","version":"latest"}]
nsx-vmc-policy
Feedback

Was this page helpful?