요청 구조
요청 구조:
요청은 아래에서 설명하는 형식의 URI(Uniform Resource Identifier)가 포함된 HTTPS 요청으로 Management Center에 전송됩니다.
https://<management_center_IP_or_name>:<https_port>/<object_URL>/object_UUIDoptions
여기서 각 항목은 다음을 나타냅니다.
-
Management Center의 IP 주소 또는 FQDN(Fully Qualified Domain Name).<management_center_IP_or_name>
-
Management Center에서 HTTPS 연결에 사용하는 포트 번호. 이 포트는 항상 443입니다.<https_port>
-
원하는 리소스의 구체적인 URL. 이러한 URL(아래에 나와 있음)은 각 리소스에 대해 고유합니다.<object_URL>
-
요청과 함께 제공되는 옵션. 옵션을 사용하여 출력을 수정하고 결과를 필터링할 수 있습니다.options
-
대부분의 URL에는 지정해야 하는 UUID가 하나 이상 포함되어 있습니다. 대다수 URI에는 도메인 UUID(인증 토큰에서 확인할 수 있음)가 포함됩니다. 개체를 삭제 또는 수정할 때나 특정 개체에 대한 정보를 요청할 때 URI는 개체 UUID로 끝납니다.{UUID}
사용 가능한 요청 메서드는 다음과 같습니다.
-
- 지정된 개체에서 데이터를 검색합니다. GET는 읽기 전용 작업입니다.GET
-
- 제공된 정보를 지정된 개체에 추가합니다. 개체가 없을 경우 404 Resource Not Found(404 리소스를 찾을 수 없음) 오류가 반환됩니다.PUT
참고
현재는 PUT을 사용하여 새 개체를 생성할 수 있지만 향후 릴리스에서는 이 기능이 제거될 수 있습니다. POST를 사용하여 새 개체를 생성하고, PUT을 사용하여 기존 개체를 수정합니다.
-
- 제공된 정보로 개체를 생성합니다. POST 작업 뒤에는 생성할 JSON 개체로 구성된 페이로드를 다음과 같이 중괄호로 묶어서 추가해야 합니다.POST
{object]
참고
사용할 수 있는 최대 규칙 수는 디바이스의 메모리에 따라 달라집니다. 복잡한 규칙은 메모리를 더 많이 사용하므로 설정된 제한은 없습니다. 규칙 성능 및 최적화 지침은 Management Center 구성 가이드를 참조하십시오.
-
- 지정된 개체를 삭제합니다.DELETE
-
- 지원되지 않습니다.PATCH
API는 거의 모든 요청에 대해 쿼리 파라미터를 지원합니다. GET 요청의 경우 다음 쿼리 파라미터를 사용하여 반환되는 개체의 수와 페이지 매기기를 제어할 수 있습니다.
-
- 목록에 항목의 전체 목록이 제공되는지 아니면 참조만 제공되는지를 나타내는 True/False 값입니다. 이 플래그가 true로 설정되면 일부 필드만 표시됩니다.expanded
-
- 목록에서 시작할 위치를 나타냅니다.offset
-
- 페이지에서 검색할 항목 수를 나타냅니다.limit
API는 요청과 함께 전달된 쿼리 파라미터를 기반으로 한 필터링을 지원합니다. 모델의 특정 속성을 기준으로 필터링을 수행할 수 있습니다. 필터링에 사용할 수 있는 파라미터(아래에 요청과 함께 나와 있음)는 개체별로 다릅니다.