리소스 및 속성
이 섹션에서는 Lenovo에서 제공하는 DMTF 표준 스키마 파일 및 OEM 스키마 파일을 기반으로 하는 REST 인터페이스의 리소스 및 속성에 대해 설명합니다. 리소스 요약 하위 섹션에는 리소스 수, 리소스 경로 및 참조된 스키마 파일이 나열되어 있습니다. 또 다른 하위 섹션인 속성 값은 속성 값, 작업 및 기타 REST 작업을 포함하는 각 URI의 정의를 제공합니다.
REST에서 오류가 발생하여 요청을 완료할 수 없는 경우 "500 내부 서버 오류"를 반환합니다.
120초 이상 요청을 받은 후 응답이 준비되지 않으면 REST는 "503 서비스를 일시적으로 사용할 수 없음"을 반환합니다.
동일한 스키마 리소스에 대한 요청이 두 개 이상 있는 경우 하나씩 처리되며, 즉, 첫 번째 요청이 완료된 후 두 번째 요청이 처리됩니다. 예를 들어, MetricReport 리소스에 두 개의 요청이 있고, 첫 번째 요청이 PowerMetrics에 액세스하며 두 번째 요청이 CPUTemp에 액세스하는 경우, PowerMetrics에 대한 요청이 완료될 때까지 CPUTemp에 대한 요청은 대기하게 됩니다. 따라서 이 경우 CPUTemp의 응답 시간은 CPUTemp에 대한 단일 요청보다 길어집니다.
PATCH
REST 업데이트(PATCH)의 경우 REST는 먼저 모든 입력 속성/값이 스키마 정의와 일치하는지 확인합니다. 잘못된 입력 속성/값이 있는 경우 REST는 업데이트를 수행하지 않고 오류(400 잘못된 요청)를 반환합니다. 입력 속성 중 하나라도 읽기 전용이거나 구현되지 않은 경우 이 속성의 값은 변경되지 않습니다. 한 속성 값의 경우 추가 유효성 검사가 필요하며, 자세한 내용은 속성의 "Comment" 열에 설명되어 있습니다. 그렇지 않은 경우, 그것은 데이터 원본으로 직접 전달됩니다. REST는 데이터 원본을 업데이트하지 못한 경우 오류를 직접 반환합니다. 작업 중에 오류가 발생하면 REST는 이미 수행된 업데이트를 되돌리지 않습니다.
PATCH Body ERROR | HTTP 상태 코드 | Messageld (Base) | 주석 |
비어 있음 | 400(잘못된 요청) | EmptyJSON | |
잘못된 JSON 형식 | 400(잘못된 요청) | MalformedJSON | |
알 수 없는 속성만 | 400(잘못된 요청) | PropertyUnknown | |
잘못된 값 형식 | 400(잘못된 요청) | PropertyValueTypeError | |
잘못된 값 범위/형식 | 400(잘못된 요청) | PropertyValueFormatError | |
잘못된 열거형 값 | 400(잘못된 요청) | PropertyValueNotInList | |
읽기 전용 또는 구현되지 않은 속성만 | 400(잘못된 요청) | PropertyNotWritable | |
읽기 전용 또는 구현되지 않은 속성과 함께 유효한 쓰기 가능한 속성 | 200 (OK) | PropertyNotWritable | 읽기 전용 속성에 대한 응답에서 ExtendedInfo이(가) 추가됩니다. |
알 수 없는 속성과 함께 유효한 쓰기 가능한 속성 | 200 (OK) | PropertyUnknown | 알 수 없음 속성에 대한 응답에서 ExtendedInfo이(가) 추가됩니다. |
내용 없음 오류 | 500(내부 서버 오류) | GeneralError | 예를 들어, API 호출이 실패했습니다. |
Odata 주석 | 이것은 무시됩니다. "@odata." 패턴과 일치하는 모든 속성은 Odata 주석으로 처리됩니다. | ||
Odata 주석만 | 400(잘못된 요청) | 응답에서 ExtendedInfo이(가) NoOperation에 추가됩니다. |
컬렉션
구현된 모든 컬렉션 리소스 및 해당 속성은 DSP 0266 및 컬렉션 스키마(예: 해당 URI는 CSDL 스키마의 "Redfish.Uris"를 준수해야 함)를 준수해야 합니다. 이 문서에서는 구현된 컬렉션 리소스에 주석이 필요한 경우를 제외하고 구현된 모든 컬렉션 리소스에 대해 설명하지 않습니다.
사용자가 컬렉션 구성원 리소스에 액세스하려는 경우 사용자는 먼저 컬렉션 리소스에 액세스하여 리소스의 존재 여부를 확인해야 합니다. 그렇지 않으면 리소스에 액세스할 수 없거나 리소스의 데이터가 유효하지 않을 수 있습니다.
Odata 주석 속성
구현된 모든 Odata 주석 속성은 DSP 0266을 준수해야 합니다. 이 문서에서는 구현된 속성에 몇 가지 추가 주석이 필요하지 않는 한 구현된 모든 Odata 주석 속성을 구체적으로 설명하지 않습니다.