이 참조 항목에서는 NSX Distributed Malware Prevention 서비스를 등록하고, NSX Distributed Malware Prevention 서비스의 배포 규격을 검색하고, 기존 NSX Distributed Malware Prevention 서비스 정의의 배포 규격을 삭제하는 데 사용되는 API에 대한 정보를 제공합니다.

NSX Distributed Malware Prevention 서비스 등록

POST API를 사용하여 NSX Distributed Malware Prevention 서비스를 등록합니다. NSX Distributed Malware Prevention 서비스가 이미 등록된 경우 API는 기존 서비스 정의에 새 배포 규격을 추가합니다.

서비스를 등록하는 동안 API는 NSX Distributed Malware Prevention 서비스의 서비스 정의를 내부적으로 생성합니다.

API 요청

메서드: POST

URI 경로: napp/api/v1/malware-prevention/svm-spec

요청 헤더: 적용되지 않음

쿼리 매개 변수: 해당 없음

표 1. 매개 변수 목록
이름 설명 유형 참고
deployment_spec_name

배포 규격의 이름입니다. 서비스 정의에는 여러 배포 규격이 포함될 수 있습니다. 각 배포 규격 이름은 고유해야 합니다.

문자열

필요

ovf_url

웹 서버의 OVF 파일에 대한 전체 경로

문자열

필요

svm_version 서비스 가상 시스템의 버전 번호

문자열

필요

예제 요청
POST https://{nsx-manager-ip}/napp/api/v1/malware-prevention/svm-spec
{
    "ovf_url" : "http://{webserver-ip}/{path-to-ovf-file}/{filename}.ovf",
    "deployment_spec_name" : "MPS_Distributed_1",
    "svm_version" : "3.2"
}
예제 응답 #1
POST API가 NSX Distributed Malware Prevention 서비스를 등록하는 데 사용될 때의 샘플 응답입니다.
{
    "service_id": "5cd8d584-553e-4495-a112-04cdcf44064c",
    "display_name": "VMWare NSX Distributed Malware Prevention Service",
    "deployment_specs": {
        "_links": [],
        "results": [
            {
               "ovf_url": "http://{webserver-ip}/{path-to-ovf-file}/{filename}.ovf",
               "deployment_spec_name": "MPS_Distributed_1",
               "svm_version": "3.2"
            }
        ]
    }
}
}
예제 응답 #2
POST API가 기존 서비스 정의에 새 서비스 배포 규격을 추가하는 데 사용될 때의 샘플 응답입니다. 이 경우 응답은 서비스 정의의 모든 배포 규격을 나열합니다.

예를 들어 각 ESXi 호스트 클러스터의 서비스 배포에서 NSX 맬웨어 차단 SVM을 업그레이드하려면 이 POST API를 실행하여 기존 서비스 정의에 새 서비스 배포 규격을 추가합니다.

{
    "service_id": "5cd8d584-553e-4495-a112-04cdcf44064c",
    "display_name": "VMWare NSX Distributed Malware Prevention Service",
    "deployment_specs": {
        "_links": [],
        "results": [
            {
                "ovf_url": "http://{webserver-ip}/{path-to-ovf-file}/{filename2}.ovf",
                "deployment_spec_name": "MPS_Distributed_2",
                "svm_version": "3.3"
            },
            {
                "ovf_url": "http://{webserver-ip}/{path-to-ovf-file}/{filename1}.ovf",
                "deployment_spec_name": "MPS_Distributed_1",
                "svm_version": "3.2"
            }
        ]
    }
}

NSX Distributed Malware Prevention 서비스 배포 규격 검색

GET API를 사용하여 NSX Distributed Malware Prevention 서비스의 서비스 배포 규격을 검색합니다.

API 요청

메서드: GET

URI 경로: napp/api/v1/malware-prevention/svm-spec

요청 헤더: 적용되지 않음

쿼리 매개 변수: 해당 없음

요청 본문: 해당 없음

예제 응답
{
    "service_id": "5cd8d584-553e-4495-a112-04cdcf44064c",
    "display_name": "VMWare NSX Distributed Malware Prevention Service",
    "deployment_specs": {
        "_links": [],
        "results": [
            {
               "ovf_url": "http://{webserver-ip}/{path-to-ovf-file}/{filename}.ovf",
               "deployment_spec_name": "MPS_Distributed_1",
               "svm_version": "3.2"
            }
        ]
    }
}
}

NSX Distributed Malware Prevention 서비스 배포 규격 삭제

서비스 정의에 대해 둘 이상의 배포 규격을 추가했으며 배포 규격 중 하나가 더 이상 유효하지 않거나 어떤 서비스 배포에도 사용되지 않을 경우 DELETE API를 사용하여 NSX Distributed Malware Prevention 서비스 배포 규격을 삭제합니다.

경고: 다음과 같은 경우에는 DELETE API를 사용하지 마십시오.
  • NSX Distributed Malware Prevention 서비스 정의에는 단일 배포 규격만 있습니다.
  • 배포 규격은 모든 서비스 배포에 사용됩니다.

이러한 두 경우에 DELETE API가 실패합니다.

API 요청

메서드: DELETE

URI 경로: napp/api/v1/malware-prevention/svm-spec

요청 헤더: 적용되지 않음

쿼리 매개 변수: deployment_spec_name

요청 본문: 해당 없음

예제 요청
DELETE  https://{nsx-manager-ip}/napp/api/v1/malware-prevention/svm-spec?deployment_spec_name=MPS_Distributed_1