17.3. GetActiveRestoreProcess

표 17.3. HTTP 응답 코드
코드	메시지	datatype
200	성공적인 응답입니다.	V1GetActiveDBRestoreProcessResponse
0	예기치 않은 오류 응답	RuntimeError

17.3.7.1. DBExportManifestEncodingType

복원 본문에 있는 파일 데이터의 인코딩은 일반적으로 압축 목적으로 사용됩니다.

열거 값
알 수 없음
비COMEESSED
조각화됨

17.3.7.2. DBRestoreProcessStatusResumeInfo

필드 이름	필수 항목	Cryostat	유형	설명	형식
POS			문자열		int64

17.3.7.3. DBRestoreRequestHeaderLocalFileInfo

LocalFileInfo는 지속적인 복원 프로세스에 대한 정보를 다른 사용자에게 제공하기 위해 복원 프로세스를 시작하는 사용자의 로컬 시스템에 있는 파일에 대한 정보를 제공합니다.

필드 이름	필수 항목	Cryostat	유형	설명	형식
path			문자열	파일의 전체 경로입니다.
bytesSize			문자열	파일의 크기(바이트)입니다. 알 수 없는 경우 0	int64

17.3.7.4. ProtobufAny

any 는 직렬화된 메시지의 유형을 설명하는 URL과 함께 임의의 직렬화된 프로토콜 버퍼 메시지를 포함합니다.

protobuf 라이브러리는 유틸리티 함수 또는 Any 유형의 추가 생성 메서드 형태로 모든 값의 팩/unpack을 지원합니다.

예 1: 팩 및 C++에서 메시지의 압축을 풉니다.

Foo foo = ...;
Any any;
any.PackFrom(foo);
...
if (any.UnpackTo(&foo)) {
  ...
}

Foo foo = ...;
Any any;
any.PackFrom(foo);
...
if (any.UnpackTo(&foo)) {
  ...
}

Copy to Clipboard

예 2: Java에서 메시지 팩 및 압축을 풉니다.

Foo foo = ...;
Any any = Any.pack(foo);
...
if (any.is(Foo.class)) {
  foo = any.unpack(Foo.class);
}
// or ...
if (any.isSameTypeAs(Foo.getDefaultInstance())) {
  foo = any.unpack(Foo.getDefaultInstance());
}

Foo foo = ...;
Any any = Any.pack(foo);
...
if (any.is(Foo.class)) {
  foo = any.unpack(Foo.class);
}
// or ...
if (any.isSameTypeAs(Foo.getDefaultInstance())) {
  foo = any.unpack(Foo.getDefaultInstance());
}

Copy to Clipboard

Example 3: Pack and unpack a message in Python.

Example 3: Pack and unpack a message in Python.

Copy to Clipboard

foo = Foo(...)
any = Any()
any.Pack(foo)
...
if any.Is(Foo.DESCRIPTOR):
  any.Unpack(foo)
  ...

foo = Foo(...)
any = Any()
any.Pack(foo)
...
if any.Is(Foo.DESCRIPTOR):
  any.Unpack(foo)
  ...

Copy to Clipboard

Example 4: Pack and unpack a message in Go

Example 4: Pack and unpack a message in Go

Copy to Clipboard

foo := &pb.Foo{...}
any, err := anypb.New(foo)
if err != nil {
  ...
}
...
foo := &pb.Foo{}
if err := any.UnmarshalTo(foo); err != nil {
  ...
}

foo := &pb.Foo{...}
any, err := anypb.New(foo)
if err != nil {
  ...
}
...
foo := &pb.Foo{}
if err := any.UnmarshalTo(foo); err != nil {
  ...
}

Copy to Clipboard

protobuf 라이브러리에서 제공하는 pack 메서드는 기본적으로 유형 URL로 'type.googleapis.com/full.type.name'을 사용하고 압축 해제 방법은 유형 URL에서 마지막 '/' 후에만 정규화된 유형 이름을 사용합니다(예: "foo.bar.com/x/y.z")는 유형 이름 "y.z"를 생성합니다.

17.3.7.4.1. JSON 표현

Any 값의 JSON 표현에서는 형식 URL을 포함하는 추가 필드 @type 과 함께 deserialized 포함 메시지의 정규식을 사용합니다. 예제:

package google.profile;
message Person {
  string first_name = 1;
  string last_name = 2;
}

package google.profile;
message Person {
  string first_name = 1;
  string last_name = 2;
}

Copy to Clipboard

{
  "@type": "type.googleapis.com/google.profile.Person",
  "firstName": <string>,
  "lastName": <string>
}

{
  "@type": "type.googleapis.com/google.profile.Person",
  "firstName": <string>,
  "lastName": <string>
}

Copy to Clipboard

포함된 메시지 유형이 잘 알려져 있고 사용자 지정 JSON 표현이 있는 경우 해당 표현에 @type 필드 외에도 사용자 지정 JSON이 포함된 필드 값을 추가합니다. 예(메시지 [google.protobuf.Duration][]).

{
  "@type": "type.googleapis.com/google.protobuf.Duration",
  "value": "1.212s"
}

{
  "@type": "type.googleapis.com/google.protobuf.Duration",
  "value": "1.212s"
}

Copy to Clipboard

필드 이름	필수 항목	Cryostat	유형	설명	형식
typeUrl			문자열	직렬화된 프로토콜 버퍼 메시지의 유형을 고유하게 식별하는 URL/리소스 이름입니다. 이 문자열에는 하나 이상의 \"/\" 문자가 포함되어야 합니다. URL 경로의 마지막 세그먼트는 `경로/google.protobuf.Duration과 같이 유형의 정규화된 이름을 나타냅니다.` 이름은 표준 형식이어야 합니다(예: leading \".\"는 허용되지 않음). 실제로 팀은 일반적으로 Any의 컨텍스트에서 사용할 것으로 예상되는 모든 유형의 바이너리로 미리 컴파일됩니다. 그러나 스키마 `http`,`https` 또는 스키마를 사용하는 URL의 경우 선택 옵션으로 유형 URL을 메시지 정의에 매핑하는 유형 서버를 설정할 수 있습니다. * 스키마가 제공되지 않는 경우 `https` 로 가정합니다. * URL의 HTTP GET은 바이너리 형식으로 [google.protobuf.Type][] 값을 산출하거나 오류를 생성해야 합니다. * 애플리케이션은 URL을 기반으로 조회 결과를 캐시하거나 조회를 방지하기 위해 바이너리로 사전 컴파일되도록 할 수 있습니다. 따라서 유형 변경 시 바이너리 호환성을 유지해야 합니다. (버전이 지정된 유형 이름을 사용하여 중단 변경 사항을 관리합니다.) 참고: 이 기능은 현재 공식 protobuf 릴리스에서 제공되지 않으며 type.googleapis.com으로 시작하는 유형의 URL에는 사용되지 않습니다. 2023년 5월 현재 널리 사용되는 유형 서버 구현은 없으며 이를 구현할 계획이 없습니다. `http` 이외의 스키마,`https` (또는 빈 스키마)를 구현 특정 의미와 함께 사용할 수 있습니다.
value			byte[]	지정된 유형의 유효한 직렬화 프로토콜 버퍼여야 합니다.	byte

17.3.7.5. RuntimeError

필드 이름	유형	형식
error	문자열
코드	정수	int32
message	문자열
세부 정보	ProtobufAny목록

17.3.7.6. V1DBExportManifest

DB 내보내기 매니페스트는 복원 요청의 파일 내용을 설명합니다. 데이터 손실을 방지하려면 매니페스트가 항상 바인딩으로 해석됩니다. 즉, 서버에서 매니페스트에 나열된 모든 파일을 읽고 사용해야 합니다. 그렇지 않으면 요청을 거부해야 합니다.

필드 이름	필수 항목	Cryostat	유형	설명	형식
파일			V1DBExportManifestFile목록

17.3.7.7. V1DBExportManifestFile

복원 본문에 있는 단일 파일입니다.

필드 이름	유형	설명	형식
name	문자열	파일 이름입니다. 이는 해석해야 하는 (반복성) 파일 경로 및 서버로 표시될 수도 있고 아닐 수도 있습니다. ZIP 파일로 내보낸 데이터베이스의 경우 아카이브의 루트를 기준으로 하는 경로입니다.
인코딩	DBExportManifestEncodingType		UNKNOWN, UNCOMPREESSED, DEFLATED,
encodedSize	문자열		int64
decodedSize	문자열		int64
decodedCrc32	long	디코딩된 데이터의 CRC32(IEEE) 체크섬입니다.	int64

17.3.7.8. V1DBRestoreProcessMetadata

지속적 또는 완료된 복원 프로세스의 메타데이터입니다. 이 메타데이터는 변경되지 않는 정적 메타데이터입니다(예: status가 아님).

필드 이름	유형	설명	형식
id	문자열	복원 프로세스를 식별하는 ID입니다. 자동 할당됨.
header	V1DBRestoreRequestHeader
startTime	날짜	복원 프로세스가 시작된 시간입니다.	날짜-시간
initiatingUserName	문자열	데이터베이스 복원 프로세스를 시작한 사용자입니다.

17.3.7.9. V1DBRestoreProcessStatus

필드 이름	유형	형식
메타데이터	V1DBRestoreProcessMetadata
attemptId	문자열
상태	V1DBRestoreProcessStatusState	UNKNOWN, NOT_STARTED, IN_PROGRESS, PAUSED, COMPLETED,
resumeInfo	DBRestoreProcessStatusResumeInfo
error	문자열
bytesRead	문자열	int64
filesProcessed	문자열	int64

17.3.7.10. V1DBRestoreProcessStatusState

열거 값
알 수 없음
NOT_STARTED
IN_PROGRESS
일시 중지됨
완료됨

17.3.7.11. V1DBRestoreRequestHeader

필드 이름	유형	설명
formatName	문자열	데이터베이스 내보내기 형식의 이름입니다. 필수 항목입니다.
매니페스트	V1DBExportManifest
localFile	DBRestoreRequestHeaderLocalFileInfo

17.3.7.12. V1GetActiveDBRestoreProcessResponse

필드 이름	필수 항목	Cryostat	유형	설명	형식
activeStatus			V1DBRestoreProcessStatus

17.3.1. 설명

17.3.2. 매개 변수

17.3.3. 반환 유형

17.3.4. 콘텐츠 유형

17.3.5. 응답

17.3.6. Samples

17.3.7. 공통 오브젝트 참조

17.3.7.1. DBExportManifestEncodingType

17.3.7.2. DBRestoreProcessStatusResumeInfo

17.3.7.3. DBRestoreRequestHeaderLocalFileInfo

17.3.7.4. ProtobufAny

17.3.7.4.1. JSON 표현

17.3.7.5. RuntimeError

17.3.7.6. V1DBExportManifest

17.3.7.7. V1DBExportManifestFile

17.3.7.8. V1DBRestoreProcessMetadata

17.3.7.9. V1DBRestoreProcessStatus

17.3.7.10. V1DBRestoreProcessStatusState

17.3.7.11. V1DBRestoreRequestHeader

17.3.7.12. V1GetActiveDBRestoreProcessResponse

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat 소개

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links