StorageGRID Swift REST API 작업
-
이 문서 사이트의 PDF
-
어플라이언스 하드웨어를 설치하고 유지 관리합니다
-
![](/ko-kr/storagegrid-116/images/pdf-zip.png)
별도의 PDF 문서 모음
Creating your file...
StorageGRID 시스템별 Swift REST API에 작업이 추가됩니다.
컨테이너 일관성 요청 가져오기
정합성 보장 레벨은 오브젝트의 가용성과 서로 다른 스토리지 노드 및 사이트에서 이러한 오브젝트의 일관성 간의 균형을 제공합니다. 컨테이너 일관성 가져오기 요청을 사용하면 특정 컨테이너에 적용되는 일관성 수준을 확인할 수 있습니다.
요청하십시오
HTTP 헤더를 요청합니다 | 설명 |
---|---|
X-Auth-Token |
요청에 사용할 계정의 Swift 인증 토큰을 지정합니다. |
'x-ntap-sg-consistency' |
요청 유형을 지정합니다. 여기서 true는 컨테이너 일관성을 얻고 false는 컨테이너를 가져옵니다. |
호스트 |
요청이 전달되는 호스트 이름입니다. |
요청 예
GET /v1/28544923908243208806/Swift container X-Auth-Token: SGRD_3a877009a2d24cb1801587bfa9050f29 x-ntap-sg-consistency: true Host: test.com
응답
응답 HTTP 헤더 | 설명 |
---|---|
다 |
응답의 날짜 및 시간입니다. |
'연결'을 선택합니다 |
서버에 대한 연결이 열려 있는지 또는 닫혀 있는지 여부 |
X-Trans-ID |
요청에 대한 고유한 트랜잭션 식별자입니다. |
콘텐츠 길이 |
응답 바디의 길이. |
'x-ntap-sg-consistency' |
컨테이너에 적용되는 정합성 보장 제어 레벨입니다. 지원되는 값은 다음과 같습니다.
|
응답 예
HTTP/1.1 204 No Content Date: Sat, 29 Nov 2015 01:02:18 GMT Connection: CLOSE X-Trans-Id: 1936575373 Content-Length: 0 x-ntap-sg-consistency: strong-site
컨테이너 일관성 요청
저장 컨테이너 일관성 요청을 사용하면 컨테이너에서 수행된 작업에 적용할 일관성 수준을 지정할 수 있습니다. 기본적으로 새 컨테이너는 "새 쓰기 후 다시 쓰기" 일관성 수준을 사용하여 생성됩니다.
요청하십시오
HTTP 헤더를 요청합니다 | 설명 |
---|---|
X-Auth-Token |
요청에 사용할 계정의 Swift 인증 토큰입니다. |
'x-ntap-sg-consistency' |
컨테이너의 작업에 적용할 일관성 제어 수준입니다. 지원되는 값은 다음과 같습니다.
|
호스트 |
요청이 전달되는 호스트 이름입니다. |
일관성 제어 및 ILM 규칙이 상호 작용하여 데이터 보호에 영향을 미치는 방식
일관성 제어와 ILM 규칙 모두 오브젝트의 보호 방법에 영향을 미칩니다. 이러한 설정은 상호 작용할 수 있습니다.
예를 들어, 개체가 저장될 때 사용되는 일관성 컨트롤은 오브젝트 메타데이터의 초기 배치에 영향을 미치는 반면 ILM 규칙에 대해 선택된 수집 동작은 오브젝트 복사본의 초기 배치에 영향을 줍니다. StorageGRID에서는 클라이언트 요청을 이행하기 위해 오브젝트의 메타데이터와 해당 데이터에 모두 액세스해야 하므로 일관성 수준과 수집 동작에 적합한 보호 수준을 선택하면 초기 데이터 보호 수준을 높이고 시스템 응답을 더욱 정확하게 예측할 수 있습니다.
ILM 규칙에 대해 다음과 같은 수집 동작을 사용할 수 있습니다.
-
* Strict * : ILM 규칙에 지정된 모든 사본은 클라이언트에 반환되기 전에 만들어야 합니다.
-
* 균형 *: StorageGRID는 수집 시 ILM 규칙에 지정된 모든 복제본을 생성하려고 합니다. 그렇지 않을 경우 중간 복사본이 만들어지고 클라이언트에 성공적으로 반환됩니다. ILM 규칙에 지정된 복사본은 가능한 경우 만들어집니다.
-
* 이중 커밋*: StorageGRID는 즉시 개체의 임시 복사본을 만들고 클라이언트에 성공을 반환합니다. ILM 규칙에 지정된 복사본은 가능한 경우 만들어집니다.
|
ILM 규칙의 수집 동작을 선택하기 전에 정보 수명 주기 관리를 통해 개체를 관리하기 위한 지침에서 이러한 설정에 대한 전체 설명을 읽어보십시오. |
일관성 제어 및 ILM 규칙이 상호 작용하는 방법의 예
다음 ILM 규칙 및 다음 일관성 수준 설정이 있는 두 사이트 그리드가 있다고 가정합니다.
-
* ILM 규칙 *: 로컬 사이트와 원격 사이트에 각각 하나씩, 두 개의 오브젝트 복사본을 만듭니다. Strict 수집 동작이 선택됩니다.
-
* Consistency level *: "trong-global"(개체 메타데이터가 모든 사이트에 즉시 배포됩니다.)
클라이언트가 오브젝트를 그리드에 저장할 때 StorageGRID는 오브젝트 복사본을 둘 다 만들고 메타데이터를 두 사이트에 분산한 다음 클라이언트에 성공을 반환합니다.
수집 성공 메시지가 표시된 시점에 객체가 손실로부터 완벽하게 보호됩니다. 예를 들어, 수집 직후 로컬 사이트가 손실되면 오브젝트 데이터와 오브젝트 메타데이터의 복사본이 원격 사이트에 계속 존재합니다. 개체를 완전히 검색할 수 있습니다.
대신 동일한 ILM 규칙 및 "'strong-site' 정합성 보장 수준을 사용한 경우 객체 데이터가 원격 사이트에 복제되었지만 객체 메타데이터가 그 위치에 배포되기 전에 클라이언트에 성공 메시지가 표시될 수 있습니다. 이 경우 오브젝트 메타데이터의 보호 수준이 오브젝트 데이터의 보호 수준과 일치하지 않습니다. 수집 후 곧바로 로컬 사이트가 손실되면 오브젝트 메타데이터가 손실됩니다. 객체를 검색할 수 없습니다.
일관성 수준과 ILM 규칙 간의 상호 관계는 복잡할 수 있습니다. 도움이 필요한 경우 NetApp에 문의하십시오.
요청 예
PUT /v1/28544923908243208806/_Swift container_ X-Auth-Token: SGRD_3a877009a2d24cb1801587bfa9050f29 x-ntap-sg-consistency: strong-site Host: test.com
응답
응답 HTTP 헤더 | 설명 |
---|---|
다 |
응답의 날짜 및 시간입니다. |
'연결'을 선택합니다 |
서버에 대한 연결이 열려 있는지 또는 닫혀 있는지 여부 |
X-Trans-ID |
요청에 대한 고유한 트랜잭션 식별자입니다. |
콘텐츠 길이 |
응답 바디의 길이. |
응답 예
HTTP/1.1 204 No Content Date: Sat, 29 Nov 2015 01:02:18 GMT Connection: CLOSE X-Trans-Id: 1936575373 Content-Length: 0