can_delete

can_delete 메소드는 권고 삭제가 활성화된 상태에서 온라인 삭제를 사용할 때 삭제할 수 있는 최신 ledger 버전을 rippled 서버에 알려줍니다. 권고 삭제가 활성화되지 않은 경우 이 메소드는 아무 작업도 수행하지 않습니다.

can_delete 메소드는 권한이 없는 사용자가 실행할 수 없는 관리자 메소드입니다.

요청 형식

요청 형식의 예입니다:

WebSocket

{
  "id": 2,
  "command": "can_delete",
  "can_delete": 11320417
}

JSON-RPC

{
    "method": "can_delete",
    "params": [
        {
            "can_delete": 11320417
        }
    ]
}

Commandline

#Syntax: can_delete [<ledger_index>|<ledger_hash>|now|always|never]
rippled can_delete 11320417

이 요청은 다음 매개 변수를 허용합니다:

Field	유형	설명
can_delete	문자열 또는 정수	(선택 사항) 삭제를 허용할 최대 원장 버전의 원장 인덱스입니다. 특수 케이스는 온라인 삭제를 비활성화하지 않습니다. 특수 케이스는 항상 권고 삭제가 비활성화된 것처럼 자동 온라인 삭제를 활성화합니다. 이제 특수 케이스는 구성된 online_delete 값을 충족하거나 초과하는 다음 검증 원장에서 온라인 삭제를 한 번만 허용합니다. 생략하면 서버는 아무런 변경도 하지 않지만, 여전히 현재 can_delete 값으로 응답합니다.

응답 형식

응답은 표준 형식을 따르며, 성공적인 결과에는 다음 필드가 포함됩니다:

Field	유형	설명
can_delete	정수	온라인 삭제 루틴에 의해 제거될 수 있는 최대 원장 인덱스입니다.

이 명령을 매개변수 없이 사용하면 기존 can_delete 설정을 쿼리할 수 있습니다.

발생 가능한 오류

• 일반적인 오류 유형입니다.

• invalidParams - 하나 이상의 필드가 잘못 지정되었거나 하나 이상의 필수 필드가 누락되었습니다.

• lgrNotFound - 요청의 can_delete 필드에 지정된 ledger이 존재하지 않거나 존재하지만 서버에 해당 ledger이 없습니다.

• notEnabled - 서버의 구성에서 온라인 삭제 또는 권고 삭제가 활성화되어 있지 않은 경우.

• notReady - 서버가 현재 온라인 삭제를 실행할 준비가 되어 있지 않습니다. 이는 일반적으로 서버가 최근에 시작되었고 아직 유효한 ledger을 얻지 못했음을 의미합니다.

• reportingUnsupported - (리포팅 모드 서버만 해당) 이 메소드는 리포팅 모드에서 사용할 수 없습니다.