NSX 계층형 API는 사용자에게 단일 API를 호출하여 의도한 계층 전체 또는 일부를 생성할 수 있는 방법을 제공합니다. API에 대한 입력은 트리 형식으로 표현됩니다. 트리의 각 노드에는 유형이 다른 여러 하위 항목이 있을 수 있습니다.

계층형 API는 프로젝트에 대해 지원됩니다. 프로젝트 사용자는 이 설명서에 설명된 대로 패치 API 호출을 호출하여 전체 의도 계층 또는 의도 계층의 일부를 생성, 업데이트 또는 삭제할 수 있습니다.

패치 API

이 섹션의 API 호출은 사용자 역할 측면에서 구성됩니다.

엔터프라이즈 관리자

엔터프라이즈 관리자는 다음과 같은 패치 API 호출을 실행할 수 있습니다.

PATCH https://<nsx-mgr>/policy/api/v1/org-root
PATCH https://<nsx-mgr>/policy/api/v1/orgs/default/projects/<project-id>/infra

요청 본문 예:

PATCH https://<nsx-mgr>/policy/api/v1/org-root
{
	"resource_type": "OrgRoot",
	"children": [{
		"resource_type": "ChildResourceReference",
		"id": "default",
		"target_type": "Org",
		"children": [{
			"resource_type": "ChildProject",
			"Project": {
				"id": "project-1",
				"resource_type": "Project",
				"display_name": "Test HAPI Project",
				"site_infos": [{
					"edge_cluster_paths": [
						"/infra/sites/default/enforcement-points/default/edge-clusters/ec1"
					],
					"site_path": "/infra/sites/default"
				}],
				"tier_0s": [
					"/infra/tier-0s/vmware"
				]
			}
		}]
	}]
}

역할 기반 액세스 제어는 이 패치 API의 응답 페이로드에 적용됩니다.

org-root 스키마에 대한 자세한 내용은 "NSX API 가이드" 항목을 참조하십시오.

프로젝트 관리자

프로젝트 관리자는 다음 패치 API 호출을 실행하고 ChildResourceReference를 사용하여 노드에 대한 하위 항목을 지정할 수 있습니다.

PATCH https://<nsx-mgr>/policy/api/v1/org-root

또는 다음과 같은 패치 API 호출을 실행할 수 있습니다.

PATCH https://<nsx-mgr>/policy/api/v1/orgs/default/projects/<project-id>/infra

이러한 API에 대한 자세한 내용은 "NSX API 가이드" 항목을 참조하십시오.

기타 프로젝트 사용자
다음과 같은 패치 API 호출을 실행할 수 있습니다. 
PATCH https://<nsx-mgr>/policy/api/v1/orgs/default/projects/<project-id>/infra

그러나 이러한 사용자는 수정이 허용되는 개체에 대해서만 이 URI에 대해 패치 API를 실행할 수 있습니다.

Get API

이 섹션의 API 호출은 사용자 역할 측면에서 구성됩니다.

엔터프라이즈 관리자

엔터프라이즈 관리자만 Get API 호출을 실행하여 org-root 속성을 읽을 수 있습니다.

GET https://<nsx-mgr>/policy/api/v1/org-root

엔터프라이즈 관리자는 다음 GET API 호출을 실행할 수도 있습니다.

GET https://<nsx-mgr>/policy/api/v1/org-root?base_path=/orgs/default
GET https://<nsx-mgr>/policy/api/v1/orgs/default/projects/<project-id>/infra?filter=Type-

이러한 API에 대한 자세한 내용은 "NSX API 가이드" 항목을 참조하십시오.

프로젝트 관리자

프로젝트 관리자는 다음 Get API 호출을 실행할 수 있습니다.

GET https://<nsx-mgr>/policy/api/v1/orgs/default/projects/<project-id>/infra?filter=Type-
기타 프로젝트 사용자

계층형 Get API 호출은 허용되지 않습니다.