ONTAP REST API에서 지원하는 HTTP 메서드는 다음 표에 나와 있습니다.

각 REST API 호출에 사용되는 끝점 경로에는 다양한 식별자가 포함될 수 있습니다. 각 ID는 특정 리소스 인스턴스에 해당합니다. 예를 들어 클러스터 ID 및 SVM ID가 있습니다.

HTTP 요청에 여러 개의 헤더를 포함해야 합니다.

요청 본문의 내용은 특정 호출에 따라 달라집니다. HTTP 요청 본문은 다음 중 하나로 구성됩니다.

Get 메서드를 사용하여 API 호출을 실행할 때 쿼리 매개 변수를 사용하여 모든 특성을 기준으로 반환된 객체를 제한하거나 필터링할 수 있습니다.

하나 이상의 매개 변수 집합을 뒤에 오는 URL 문자열에 추가할 수 있습니다 ? 문자. 둘 이상의 매개 변수가 제공된 경우 쿼리 매개 변수는 을 기반으로 분할됩니다 & 문자. 매개 변수의 각 키와 값은 에서 분할됩니다 = 문자.

예를 들어 등호를 사용하여 정확히 일치하는 값을 지정할 수 있습니다.

<field>=<value>

보다 복잡한 쿼리의 경우 추가 연산자는 등호 뒤에 배치됩니다. 예를 들어 일부 값보다 크거나 같은 특정 필드를 기준으로 개체 집합을 선택하려면 쿼리는 다음과 같습니다.

<field>=>=<value>

위에 제공된 예제 외에 값 범위에 걸쳐 개체를 반환하는 추가 연산자를 사용할 수 있습니다. ONTAP REST API가 지원하는 필터링 연산자에 대한 요약은 아래 표와 같다.

쿼리의 일부로 "null" 키워드 또는 "Negation"!null"을 사용하여 특정 필드가 설정되었는지 여부를 기준으로 개체 컬렉션을 반환할 수도 있습니다.

이 사이트의 REST API 워크플로에 포함된 몇 가지 예가 아래에 나와 있습니다.

기본적으로 Get을 사용하여 API 호출을 실행하면 HAL 자체 링크와 함께 개체나 개체를 고유하게 식별하는 특성만 반환됩니다. 이 최소 필드 집합은 각 개체의 키 역할을 하며 개체 유형에 따라 달라집니다. 다음과 같은 방법으로 '필드' 쿼리 매개 변수를 사용하여 추가 개체 속성을 선택할 수 있습니다.

리소스 컬렉션의 레코드는 개체에서 정의한 기본 순서로 반환됩니다. 다음과 같이 필드 이름 및 정렬 방향을 가진 "ORDER_BY" 쿼리 매개 변수를 사용하여 순서를 변경할 수 있습니다.

'ORDER_BY=<필드 이름>ASC|desc'

예를 들어 유형 필드를 내림차순으로 정렬한 다음 ID를 오름차순으로 정렬할 수 있습니다.

order_by=desc, id asc를 입력합니다

다음 사항에 유의하십시오.

Get 을 사용하여 API 호출을 실행하여 같은 형식의 개체 컬렉션에 액세스하면 ONTAP 는 두 가지 제약 조건에 따라 가능한 한 많은 개체를 반환합니다. 요청에 대한 추가 쿼리 매개 변수를 사용하여 이러한 각 제약 조건을 제어할 수 있습니다. 특정 GET 요청에 대한 첫 번째 제약 조건에 도달하면 요청이 종료되고 반환된 레코드 수가 제한됩니다.

일부 API 호출과 특정 쿼리 매개 변수에 사용되는 입력 값은 숫자입니다. 정수(바이트)를 제공하는 대신 다음 표에 나와 있는 접미사를 선택적으로 사용할 수 있습니다.