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 가이드" 항목을 참조하십시오.
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 가이드" 항목을 참조하십시오.