결과
결과는 스토리지 버킷에 게시 된 데이터 또는 파일의 레코드입니다. 저장 위치에서이 데이터를 검색하는 데 필요한 정보가 들어 있습니다.
속성
이름 | 유형 | 기술 |
---|---|---|
id | 결과 ID | 자원 식별자. |
resource | 문자열, 항상 result | 자원 유형 지정자. |
organisation | 조직 ID | 이 리소스와 연결된 조직입니다. |
poll | 설문 조사 ID | 결과와 관련된 폴링. |
task | 작업 ID | 결과와 관련된 작업입니다. |
identifier | 끈 | 게시 된 데이터의 내용에 대한 식별자입니다. |
url | 끈 | 이 결과가 게시 된 스토리지 환경 설정 URL입니다. |
type | 선택적 문자열 | 식별 가능한 경우 파일 유형입니다. |
checksum | 끈 | 저장된 데이터의 md5 체크섬입니다. |
size | int | 게시 된 데이터의 크기 (바이트)입니다. |
signed_url | 선택적 사전 | 사용중인 스토리지 구성에서 활성화 된 경우 서명 된 URL 세부 정보로 채워집니다. |
state | 끈 | 중 하나 available , consumed , expired . |
date_created | 날짜 시간 | 리소스가 생성 된 시점. |
date_consumed | 날짜 시간 | 결과가 소비 된 것으로 인정 될 때 |
date_deleted | 날짜 시간 | 결과가 API에 의해 저장 위치에서 제거 된 경우. |
서명 된 URL
결과 공개에 사용 된 스토리지 구성에서 서명 된 URL 생성이 사용 가능한 경우 signed_url
이 다음 형식의 사전으로 설정됩니다.
{ "url": "<signed URL value here>", "date_expires": "2020-02-29T11:59:15.110451Z" }
date_expires
속성은 서명 된 URL의 유효 기간을 나타냅니다. 이 날짜 이후에 결과의 signed_url
속성이 null
로 설정됩니다.
스토리지 구성 문서 에서 서명 된 URL 구성에 대한 자세한 내용을 참조하십시오.
주
-
available
- 결과가 양동이에서 다운로드 할 준비가되었습니다.
-
consumed
- 결과가 다운로드되었으며 API에 정보가 제공되었습니다.
-
expired
- 결과가 예정된 정리에 의해 버킷에서 삭제되었습니다. 이 상태는 클라이언트가 소유 한 버킷에는 적용되지 않습니다.
GET /results/{result ID}
cURL 사용
curl https://ricloud-api.reincubate.com/results/<result ID> \ -H 'Authorization: Token <your key_token>'
ricloud-py 사용하기
import ricloud results = ricloud.Result.retrieve(<result ID>)
GET /results
나열
consumed
되거나 expired
상태의 결과는 기본적으로 목록에 표시되지 않습니다.
매개 변수
이름 | 유형 | 기술 |
---|---|---|
poll | 설문 조사 ID | 연관된 폴링으로 필터링하십시오. |
task | 작업 ID | 관련 작업별로 필터링하십시오. |
identifier | 끈 | 결과 식별자로 필터링하십시오. |
checksum | 끈 | 결과 체크섬으로 필터링합니다. |
state | 끈 | 결과 상태별로 필터링하십시오. |
date_created | 날짜 시간 필터 | 리소스가 생성되었을 때 필터링합니다. |
date_consumed | 날짜 시간 필터 | 결과가 소비 된 것으로 표시 될 때 필터링합니다. |
date_deleted | 날짜 시간 필터 | 결과가 삭제 된 것으로 표시 될 때 필터링합니다. |
cURL 사용
curl https://ricloud-api.reincubate.com/results \ -H 'Authorization: Token <your key_token>'
ricloud-py 사용하기
import ricloud results = ricloud.Result.list()
POST /results/{result ID}/ack
소비 된 것으로 결과를 인정하십시오.
cURL 사용
curl https://ricloud-api.reincubate.com/results/<result ID>/ack \ -X POST \ -H 'Authorization: Token <your key_token>'
ricloud-py 사용하기
import ricloud result = ricloud.Result.acknowledge_with_id(<result ID>) # OR result = ricloud.Result.retrieve(<result ID>) result.acknowledge()
일괄 승인 POST /results/ack
소비 된 것으로 일괄 처리 결과를 확인합니다.
지정된 결과 중 하나가 이미 인정되었거나 찾을 수없는 경우 엔드 포인트에서 오류가 발생하지 않습니다.
이름 | 유형 | 기술 |
---|---|---|
ids | 결과 ID 목록 | 인식 할 결과의 ID 목록. |
cURL 사용
curl https://ricloud-api.reincubate.com/results/ack \ -X POST \ -H 'Authorization: Token <your key_token>' \ -H 'Content-Type: application/json' \ -d '{ "ids": ["<result ID>", "<result ID>"] }'
변경 로그
2020-02-27
-
signed_url
속성을 결과 객체에 추가합니다. 이것은url
속성에 서명 된 URL과date_expires
에서 만료 될 때 포함 된 중첩 된 사전입니다. - 새로운
POST /results/ack
엔드 포인트를 사용하여 결과를 일괄 처리 할 수있는 기능을 추가합니다.