ClientNamenodeProtocol.proto 28 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983
  1. /**
  2. * Licensed to the Apache Software Foundation (ASF) under one
  3. * or more contributor license agreements. See the NOTICE file
  4. * distributed with this work for additional information
  5. * regarding copyright ownership. The ASF licenses this file
  6. * to you under the Apache License, Version 2.0 (the
  7. * "License"); you may not use this file except in compliance
  8. * with the License. You may obtain a copy of the License at
  9. *
  10. * http://www.apache.org/licenses/LICENSE-2.0
  11. *
  12. * Unless required by applicable law or agreed to in writing, software
  13. * distributed under the License is distributed on an "AS IS" BASIS,
  14. * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  15. * See the License for the specific language governing permissions and
  16. * limitations under the License.
  17. */
  18. /**
  19. * These .proto interfaces are private and stable.
  20. * Please see http://wiki.apache.org/hadoop/Compatibility
  21. * for what changes are allowed for a *stable* .proto interface.
  22. */
  23. option java_package = "org.apache.hadoop.hdfs.protocol.proto";
  24. option java_outer_classname = "ClientNamenodeProtocolProtos";
  25. option java_generic_services = true;
  26. option java_generate_equals_and_hash = true;
  27. package hadoop.hdfs;
  28. import "Security.proto";
  29. import "hdfs.proto";
  30. import "acl.proto";
  31. import "xattr.proto";
  32. import "encryption.proto";
  33. import "inotify.proto";
  34. import "erasurecoding.proto";
  35. /**
  36. * The ClientNamenodeProtocol Service defines the interface between a client
  37. * (as runnign inside a MR Task) and the Namenode.
  38. * See org.apache.hadoop.hdfs.protocol.ClientProtocol for the javadoc
  39. * for each of the methods.
  40. * The exceptions declared in the above class also apply to this protocol.
  41. * Exceptions are unwrapped and thrown by the PB libraries.
  42. */
  43. message GetBlockLocationsRequestProto {
  44. required string src = 1; // file name
  45. required uint64 offset = 2; // range start offset
  46. required uint64 length = 3; // range length
  47. }
  48. message GetBlockLocationsResponseProto {
  49. optional LocatedBlocksProto locations = 1;
  50. }
  51. message GetServerDefaultsRequestProto { // No parameters
  52. }
  53. message GetServerDefaultsResponseProto {
  54. required FsServerDefaultsProto serverDefaults = 1;
  55. }
  56. enum CreateFlagProto {
  57. CREATE = 0x01; // Create a file
  58. OVERWRITE = 0x02; // Truncate/overwrite a file. Same as POSIX O_TRUNC
  59. APPEND = 0x04; // Append to a file
  60. LAZY_PERSIST = 0x10; // File with reduced durability guarantees.
  61. NEW_BLOCK = 0x20; // Write data to a new block when appending
  62. SHOULD_REPLICATE = 0x80; // Enforce to create a replicate file
  63. }
  64. message CreateRequestProto {
  65. required string src = 1;
  66. required FsPermissionProto masked = 2;
  67. required string clientName = 3;
  68. required uint32 createFlag = 4; // bits set using CreateFlag
  69. required bool createParent = 5;
  70. required uint32 replication = 6; // Short: Only 16 bits used
  71. required uint64 blockSize = 7;
  72. repeated CryptoProtocolVersionProto cryptoProtocolVersion = 8;
  73. optional FsPermissionProto unmasked = 9;
  74. optional string ecPolicyName = 10;
  75. }
  76. message CreateResponseProto {
  77. optional HdfsFileStatusProto fs = 1;
  78. }
  79. message AppendRequestProto {
  80. required string src = 1;
  81. required string clientName = 2;
  82. optional uint32 flag = 3; // bits set using CreateFlag
  83. }
  84. message AppendResponseProto {
  85. optional LocatedBlockProto block = 1;
  86. optional HdfsFileStatusProto stat = 2;
  87. }
  88. message SetReplicationRequestProto {
  89. required string src = 1;
  90. required uint32 replication = 2; // Short: Only 16 bits used
  91. }
  92. message SetReplicationResponseProto {
  93. required bool result = 1;
  94. }
  95. message SetStoragePolicyRequestProto {
  96. required string src = 1;
  97. required string policyName = 2;
  98. }
  99. message SetStoragePolicyResponseProto { // void response
  100. }
  101. message UnsetStoragePolicyRequestProto {
  102. required string src = 1;
  103. }
  104. message UnsetStoragePolicyResponseProto {
  105. }
  106. message GetStoragePolicyRequestProto {
  107. required string path = 1;
  108. }
  109. message GetStoragePolicyResponseProto {
  110. required BlockStoragePolicyProto storagePolicy = 1;
  111. }
  112. message GetStoragePoliciesRequestProto { // void request
  113. }
  114. message GetStoragePoliciesResponseProto {
  115. repeated BlockStoragePolicyProto policies = 1;
  116. }
  117. message SetPermissionRequestProto {
  118. required string src = 1;
  119. required FsPermissionProto permission = 2;
  120. }
  121. message SetPermissionResponseProto { // void response
  122. }
  123. message SetOwnerRequestProto {
  124. required string src = 1;
  125. optional string username = 2;
  126. optional string groupname = 3;
  127. }
  128. message SetOwnerResponseProto { // void response
  129. }
  130. message AbandonBlockRequestProto {
  131. required ExtendedBlockProto b = 1;
  132. required string src = 2;
  133. required string holder = 3;
  134. optional uint64 fileId = 4 [default = 0]; // default to GRANDFATHER_INODE_ID
  135. }
  136. message AbandonBlockResponseProto { // void response
  137. }
  138. enum AddBlockFlagProto {
  139. NO_LOCAL_WRITE = 1; // avoid writing to local node.
  140. }
  141. message AddBlockRequestProto {
  142. required string src = 1;
  143. required string clientName = 2;
  144. optional ExtendedBlockProto previous = 3;
  145. repeated DatanodeInfoProto excludeNodes = 4;
  146. optional uint64 fileId = 5 [default = 0]; // default as a bogus id
  147. repeated string favoredNodes = 6; //the set of datanodes to use for the block
  148. repeated AddBlockFlagProto flags = 7; // default to empty.
  149. }
  150. message AddBlockResponseProto {
  151. required LocatedBlockProto block = 1;
  152. }
  153. message GetAdditionalDatanodeRequestProto {
  154. required string src = 1;
  155. required ExtendedBlockProto blk = 2;
  156. repeated DatanodeInfoProto existings = 3;
  157. repeated DatanodeInfoProto excludes = 4;
  158. required uint32 numAdditionalNodes = 5;
  159. required string clientName = 6;
  160. repeated string existingStorageUuids = 7;
  161. optional uint64 fileId = 8 [default = 0]; // default to GRANDFATHER_INODE_ID
  162. }
  163. message GetAdditionalDatanodeResponseProto {
  164. required LocatedBlockProto block = 1;
  165. }
  166. message CompleteRequestProto {
  167. required string src = 1;
  168. required string clientName = 2;
  169. optional ExtendedBlockProto last = 3;
  170. optional uint64 fileId = 4 [default = 0]; // default to GRANDFATHER_INODE_ID
  171. }
  172. message CompleteResponseProto {
  173. required bool result = 1;
  174. }
  175. message ReportBadBlocksRequestProto {
  176. repeated LocatedBlockProto blocks = 1;
  177. }
  178. message ReportBadBlocksResponseProto { // void response
  179. }
  180. message ConcatRequestProto {
  181. required string trg = 1;
  182. repeated string srcs = 2;
  183. }
  184. message ConcatResponseProto { // void response
  185. }
  186. message TruncateRequestProto {
  187. required string src = 1;
  188. required uint64 newLength = 2;
  189. required string clientName = 3;
  190. }
  191. message TruncateResponseProto {
  192. required bool result = 1;
  193. }
  194. message RenameRequestProto {
  195. required string src = 1;
  196. required string dst = 2;
  197. }
  198. message RenameResponseProto {
  199. required bool result = 1;
  200. }
  201. message Rename2RequestProto {
  202. required string src = 1;
  203. required string dst = 2;
  204. required bool overwriteDest = 3;
  205. optional bool moveToTrash = 4;
  206. }
  207. message Rename2ResponseProto { // void response
  208. }
  209. message DeleteRequestProto {
  210. required string src = 1;
  211. required bool recursive = 2;
  212. }
  213. message DeleteResponseProto {
  214. required bool result = 1;
  215. }
  216. message MkdirsRequestProto {
  217. required string src = 1;
  218. required FsPermissionProto masked = 2;
  219. required bool createParent = 3;
  220. optional FsPermissionProto unmasked = 4;
  221. }
  222. message MkdirsResponseProto {
  223. required bool result = 1;
  224. }
  225. message GetListingRequestProto {
  226. required string src = 1;
  227. required bytes startAfter = 2;
  228. required bool needLocation = 3;
  229. }
  230. message GetListingResponseProto {
  231. optional DirectoryListingProto dirList = 1;
  232. }
  233. message GetSnapshottableDirListingRequestProto { // no input parameters
  234. }
  235. message GetSnapshottableDirListingResponseProto {
  236. optional SnapshottableDirectoryListingProto snapshottableDirList = 1;
  237. }
  238. message GetSnapshotDiffReportRequestProto {
  239. required string snapshotRoot = 1;
  240. required string fromSnapshot = 2;
  241. required string toSnapshot = 3;
  242. }
  243. message GetSnapshotDiffReportResponseProto {
  244. required SnapshotDiffReportProto diffReport = 1;
  245. }
  246. message RenewLeaseRequestProto {
  247. required string clientName = 1;
  248. }
  249. message RenewLeaseResponseProto { //void response
  250. }
  251. message RecoverLeaseRequestProto {
  252. required string src = 1;
  253. required string clientName = 2;
  254. }
  255. message RecoverLeaseResponseProto {
  256. required bool result = 1;
  257. }
  258. message GetFsStatusRequestProto { // no input paramters
  259. }
  260. message GetFsStatsResponseProto {
  261. required uint64 capacity = 1;
  262. required uint64 used = 2;
  263. required uint64 remaining = 3;
  264. required uint64 under_replicated = 4;
  265. required uint64 corrupt_blocks = 5;
  266. required uint64 missing_blocks = 6;
  267. optional uint64 missing_repl_one_blocks = 7;
  268. optional uint64 blocks_in_future = 8;
  269. optional uint64 pending_deletion_blocks = 9;
  270. }
  271. message GetFsReplicatedBlockStatsRequestProto { // no input paramters
  272. }
  273. message GetFsReplicatedBlockStatsResponseProto {
  274. required uint64 low_redundancy = 1;
  275. required uint64 corrupt_blocks = 2;
  276. required uint64 missing_blocks = 3;
  277. required uint64 missing_repl_one_blocks = 4;
  278. required uint64 blocks_in_future = 5;
  279. required uint64 pending_deletion_blocks = 6;
  280. }
  281. message GetFsECBlockGroupStatsRequestProto { // no input paramters
  282. }
  283. message GetFsECBlockGroupStatsResponseProto {
  284. required uint64 low_redundancy = 1;
  285. required uint64 corrupt_blocks = 2;
  286. required uint64 missing_blocks = 3;
  287. required uint64 blocks_in_future = 4;
  288. required uint64 pending_deletion_blocks = 5;
  289. }
  290. enum DatanodeReportTypeProto { // type of the datanode report
  291. ALL = 1;
  292. LIVE = 2;
  293. DEAD = 3;
  294. DECOMMISSIONING = 4;
  295. ENTERING_MAINTENANCE = 5;
  296. IN_MAINTENANCE = 6;
  297. }
  298. message GetDatanodeReportRequestProto {
  299. required DatanodeReportTypeProto type = 1;
  300. }
  301. message GetDatanodeReportResponseProto {
  302. repeated DatanodeInfoProto di = 1;
  303. }
  304. message GetDatanodeStorageReportRequestProto {
  305. required DatanodeReportTypeProto type = 1;
  306. }
  307. message DatanodeStorageReportProto {
  308. required DatanodeInfoProto datanodeInfo = 1;
  309. repeated StorageReportProto storageReports = 2;
  310. }
  311. message GetDatanodeStorageReportResponseProto {
  312. repeated DatanodeStorageReportProto datanodeStorageReports = 1;
  313. }
  314. message GetPreferredBlockSizeRequestProto {
  315. required string filename = 1;
  316. }
  317. message GetPreferredBlockSizeResponseProto {
  318. required uint64 bsize = 1;
  319. }
  320. enum SafeModeActionProto {
  321. SAFEMODE_LEAVE = 1;
  322. SAFEMODE_ENTER = 2;
  323. SAFEMODE_GET = 3;
  324. SAFEMODE_FORCE_EXIT = 4;
  325. }
  326. message SetSafeModeRequestProto {
  327. required SafeModeActionProto action = 1;
  328. optional bool checked = 2 [default = false];
  329. }
  330. message SetSafeModeResponseProto {
  331. required bool result = 1;
  332. }
  333. message SaveNamespaceRequestProto {
  334. optional uint64 timeWindow = 1 [default = 0];
  335. optional uint64 txGap = 2 [default = 0];
  336. }
  337. message SaveNamespaceResponseProto { // void response
  338. optional bool saved = 1 [default = true];
  339. }
  340. message RollEditsRequestProto { // no parameters
  341. }
  342. message RollEditsResponseProto { // response
  343. required uint64 newSegmentTxId = 1;
  344. }
  345. message RestoreFailedStorageRequestProto {
  346. required string arg = 1;
  347. }
  348. message RestoreFailedStorageResponseProto {
  349. required bool result = 1;
  350. }
  351. message RefreshNodesRequestProto { // no parameters
  352. }
  353. message RefreshNodesResponseProto { // void response
  354. }
  355. message FinalizeUpgradeRequestProto { // no parameters
  356. }
  357. message FinalizeUpgradeResponseProto { // void response
  358. }
  359. enum RollingUpgradeActionProto {
  360. QUERY = 1;
  361. START = 2;
  362. FINALIZE = 3;
  363. }
  364. message RollingUpgradeRequestProto {
  365. required RollingUpgradeActionProto action = 1;
  366. }
  367. message RollingUpgradeInfoProto {
  368. required RollingUpgradeStatusProto status = 1;
  369. required uint64 startTime = 2;
  370. required uint64 finalizeTime = 3;
  371. required bool createdRollbackImages = 4;
  372. }
  373. message RollingUpgradeResponseProto {
  374. optional RollingUpgradeInfoProto rollingUpgradeInfo= 1;
  375. }
  376. message ListCorruptFileBlocksRequestProto {
  377. required string path = 1;
  378. optional string cookie = 2;
  379. }
  380. message ListCorruptFileBlocksResponseProto {
  381. required CorruptFileBlocksProto corrupt = 1;
  382. }
  383. message MetaSaveRequestProto {
  384. required string filename = 1;
  385. }
  386. message MetaSaveResponseProto { // void response
  387. }
  388. message GetFileInfoRequestProto {
  389. required string src = 1;
  390. }
  391. message GetFileInfoResponseProto {
  392. optional HdfsFileStatusProto fs = 1;
  393. }
  394. message IsFileClosedRequestProto {
  395. required string src = 1;
  396. }
  397. message IsFileClosedResponseProto {
  398. required bool result = 1;
  399. }
  400. message CacheDirectiveInfoProto {
  401. optional int64 id = 1;
  402. optional string path = 2;
  403. optional uint32 replication = 3;
  404. optional string pool = 4;
  405. optional CacheDirectiveInfoExpirationProto expiration = 5;
  406. }
  407. message CacheDirectiveInfoExpirationProto {
  408. required int64 millis = 1;
  409. required bool isRelative = 2;
  410. }
  411. message CacheDirectiveStatsProto {
  412. required int64 bytesNeeded = 1;
  413. required int64 bytesCached = 2;
  414. required int64 filesNeeded = 3;
  415. required int64 filesCached = 4;
  416. required bool hasExpired = 5;
  417. }
  418. enum CacheFlagProto {
  419. FORCE = 0x01; // Ignore pool resource limits
  420. }
  421. message AddCacheDirectiveRequestProto {
  422. required CacheDirectiveInfoProto info = 1;
  423. optional uint32 cacheFlags = 2; // bits set using CacheFlag
  424. }
  425. message AddCacheDirectiveResponseProto {
  426. required int64 id = 1;
  427. }
  428. message ModifyCacheDirectiveRequestProto {
  429. required CacheDirectiveInfoProto info = 1;
  430. optional uint32 cacheFlags = 2; // bits set using CacheFlag
  431. }
  432. message ModifyCacheDirectiveResponseProto {
  433. }
  434. message RemoveCacheDirectiveRequestProto {
  435. required int64 id = 1;
  436. }
  437. message RemoveCacheDirectiveResponseProto {
  438. }
  439. message ListCacheDirectivesRequestProto {
  440. required int64 prevId = 1;
  441. required CacheDirectiveInfoProto filter = 2;
  442. }
  443. message CacheDirectiveEntryProto {
  444. required CacheDirectiveInfoProto info = 1;
  445. required CacheDirectiveStatsProto stats = 2;
  446. }
  447. message ListCacheDirectivesResponseProto {
  448. repeated CacheDirectiveEntryProto elements = 1;
  449. required bool hasMore = 2;
  450. }
  451. message CachePoolInfoProto {
  452. optional string poolName = 1;
  453. optional string ownerName = 2;
  454. optional string groupName = 3;
  455. optional int32 mode = 4;
  456. optional int64 limit = 5;
  457. optional int64 maxRelativeExpiry = 6;
  458. optional uint32 defaultReplication = 7 [default=1];
  459. }
  460. message CachePoolStatsProto {
  461. required int64 bytesNeeded = 1;
  462. required int64 bytesCached = 2;
  463. required int64 bytesOverlimit = 3;
  464. required int64 filesNeeded = 4;
  465. required int64 filesCached = 5;
  466. }
  467. message AddCachePoolRequestProto {
  468. required CachePoolInfoProto info = 1;
  469. }
  470. message AddCachePoolResponseProto { // void response
  471. }
  472. message ModifyCachePoolRequestProto {
  473. required CachePoolInfoProto info = 1;
  474. }
  475. message ModifyCachePoolResponseProto { // void response
  476. }
  477. message RemoveCachePoolRequestProto {
  478. required string poolName = 1;
  479. }
  480. message RemoveCachePoolResponseProto { // void response
  481. }
  482. message ListCachePoolsRequestProto {
  483. required string prevPoolName = 1;
  484. }
  485. message ListCachePoolsResponseProto {
  486. repeated CachePoolEntryProto entries = 1;
  487. required bool hasMore = 2;
  488. }
  489. message CachePoolEntryProto {
  490. required CachePoolInfoProto info = 1;
  491. required CachePoolStatsProto stats = 2;
  492. }
  493. message GetFileLinkInfoRequestProto {
  494. required string src = 1;
  495. }
  496. message GetFileLinkInfoResponseProto {
  497. optional HdfsFileStatusProto fs = 1;
  498. }
  499. message GetContentSummaryRequestProto {
  500. required string path = 1;
  501. }
  502. message GetContentSummaryResponseProto {
  503. required ContentSummaryProto summary = 1;
  504. }
  505. message GetQuotaUsageRequestProto {
  506. required string path = 1;
  507. }
  508. message GetQuotaUsageResponseProto {
  509. required QuotaUsageProto usage = 1;
  510. }
  511. message SetQuotaRequestProto {
  512. required string path = 1;
  513. required uint64 namespaceQuota = 2;
  514. required uint64 storagespaceQuota = 3;
  515. optional StorageTypeProto storageType = 4;
  516. }
  517. message SetQuotaResponseProto { // void response
  518. }
  519. message FsyncRequestProto {
  520. required string src = 1;
  521. required string client = 2;
  522. optional sint64 lastBlockLength = 3 [default = -1];
  523. optional uint64 fileId = 4 [default = 0]; // default to GRANDFATHER_INODE_ID
  524. }
  525. message FsyncResponseProto { // void response
  526. }
  527. message SetTimesRequestProto {
  528. required string src = 1;
  529. required uint64 mtime = 2;
  530. required uint64 atime = 3;
  531. }
  532. message SetTimesResponseProto { // void response
  533. }
  534. message CreateSymlinkRequestProto {
  535. required string target = 1;
  536. required string link = 2;
  537. required FsPermissionProto dirPerm = 3;
  538. required bool createParent = 4;
  539. }
  540. message CreateSymlinkResponseProto { // void response
  541. }
  542. message GetLinkTargetRequestProto {
  543. required string path = 1;
  544. }
  545. message GetLinkTargetResponseProto {
  546. optional string targetPath = 1;
  547. }
  548. message UpdateBlockForPipelineRequestProto {
  549. required ExtendedBlockProto block = 1;
  550. required string clientName = 2;
  551. }
  552. message UpdateBlockForPipelineResponseProto {
  553. required LocatedBlockProto block = 1;
  554. }
  555. message UpdatePipelineRequestProto {
  556. required string clientName = 1;
  557. required ExtendedBlockProto oldBlock = 2;
  558. required ExtendedBlockProto newBlock = 3;
  559. repeated DatanodeIDProto newNodes = 4;
  560. repeated string storageIDs = 5;
  561. }
  562. message UpdatePipelineResponseProto { // void response
  563. }
  564. message SetBalancerBandwidthRequestProto {
  565. required int64 bandwidth = 1;
  566. }
  567. message SetBalancerBandwidthResponseProto { // void response
  568. }
  569. message GetDataEncryptionKeyRequestProto { // no parameters
  570. }
  571. message GetDataEncryptionKeyResponseProto {
  572. optional DataEncryptionKeyProto dataEncryptionKey = 1;
  573. }
  574. message CreateSnapshotRequestProto {
  575. required string snapshotRoot = 1;
  576. optional string snapshotName = 2;
  577. }
  578. message CreateSnapshotResponseProto {
  579. required string snapshotPath = 1;
  580. }
  581. message RenameSnapshotRequestProto {
  582. required string snapshotRoot = 1;
  583. required string snapshotOldName = 2;
  584. required string snapshotNewName = 3;
  585. }
  586. message RenameSnapshotResponseProto { // void response
  587. }
  588. message AllowSnapshotRequestProto {
  589. required string snapshotRoot = 1;
  590. }
  591. message AllowSnapshotResponseProto {
  592. }
  593. message DisallowSnapshotRequestProto {
  594. required string snapshotRoot = 1;
  595. }
  596. message DisallowSnapshotResponseProto {
  597. }
  598. message DeleteSnapshotRequestProto {
  599. required string snapshotRoot = 1;
  600. required string snapshotName = 2;
  601. }
  602. message DeleteSnapshotResponseProto { // void response
  603. }
  604. message CheckAccessRequestProto {
  605. required string path = 1;
  606. required AclEntryProto.FsActionProto mode = 2;
  607. }
  608. message CheckAccessResponseProto { // void response
  609. }
  610. message GetCurrentEditLogTxidRequestProto {
  611. }
  612. message GetCurrentEditLogTxidResponseProto {
  613. required int64 txid = 1;
  614. }
  615. message GetEditsFromTxidRequestProto {
  616. required int64 txid = 1;
  617. }
  618. message GetEditsFromTxidResponseProto {
  619. required EventsListProto eventsList = 1;
  620. }
  621. enum OpenFilesTypeProto {
  622. ALL_OPEN_FILES = 1;
  623. BLOCKING_DECOMMISSION = 2;
  624. }
  625. message ListOpenFilesRequestProto {
  626. required int64 id = 1;
  627. repeated OpenFilesTypeProto types = 2;
  628. }
  629. message OpenFilesBatchResponseProto {
  630. required int64 id = 1;
  631. required string path = 2;
  632. required string clientName = 3;
  633. required string clientMachine = 4;
  634. }
  635. message ListOpenFilesResponseProto {
  636. repeated OpenFilesBatchResponseProto entries = 1;
  637. required bool hasMore = 2;
  638. repeated OpenFilesTypeProto types = 3;
  639. }
  640. service ClientNamenodeProtocol {
  641. rpc getBlockLocations(GetBlockLocationsRequestProto)
  642. returns(GetBlockLocationsResponseProto);
  643. rpc getServerDefaults(GetServerDefaultsRequestProto)
  644. returns(GetServerDefaultsResponseProto);
  645. rpc create(CreateRequestProto)returns(CreateResponseProto);
  646. rpc append(AppendRequestProto) returns(AppendResponseProto);
  647. rpc setReplication(SetReplicationRequestProto)
  648. returns(SetReplicationResponseProto);
  649. rpc setStoragePolicy(SetStoragePolicyRequestProto)
  650. returns(SetStoragePolicyResponseProto);
  651. rpc unsetStoragePolicy(UnsetStoragePolicyRequestProto)
  652. returns(UnsetStoragePolicyResponseProto);
  653. rpc getStoragePolicy(GetStoragePolicyRequestProto)
  654. returns(GetStoragePolicyResponseProto);
  655. rpc getStoragePolicies(GetStoragePoliciesRequestProto)
  656. returns(GetStoragePoliciesResponseProto);
  657. rpc setPermission(SetPermissionRequestProto)
  658. returns(SetPermissionResponseProto);
  659. rpc setOwner(SetOwnerRequestProto) returns(SetOwnerResponseProto);
  660. rpc abandonBlock(AbandonBlockRequestProto) returns(AbandonBlockResponseProto);
  661. rpc addBlock(AddBlockRequestProto) returns(AddBlockResponseProto);
  662. rpc getAdditionalDatanode(GetAdditionalDatanodeRequestProto)
  663. returns(GetAdditionalDatanodeResponseProto);
  664. rpc complete(CompleteRequestProto) returns(CompleteResponseProto);
  665. rpc reportBadBlocks(ReportBadBlocksRequestProto)
  666. returns(ReportBadBlocksResponseProto);
  667. rpc concat(ConcatRequestProto) returns(ConcatResponseProto);
  668. rpc truncate(TruncateRequestProto) returns(TruncateResponseProto);
  669. rpc rename(RenameRequestProto) returns(RenameResponseProto);
  670. rpc rename2(Rename2RequestProto) returns(Rename2ResponseProto);
  671. rpc delete(DeleteRequestProto) returns(DeleteResponseProto);
  672. rpc mkdirs(MkdirsRequestProto) returns(MkdirsResponseProto);
  673. rpc getListing(GetListingRequestProto) returns(GetListingResponseProto);
  674. rpc renewLease(RenewLeaseRequestProto) returns(RenewLeaseResponseProto);
  675. rpc recoverLease(RecoverLeaseRequestProto)
  676. returns(RecoverLeaseResponseProto);
  677. rpc getFsStats(GetFsStatusRequestProto) returns(GetFsStatsResponseProto);
  678. rpc getFsReplicatedBlockStats(GetFsReplicatedBlockStatsRequestProto)
  679. returns (GetFsReplicatedBlockStatsResponseProto);
  680. rpc getFsECBlockGroupStats(GetFsECBlockGroupStatsRequestProto)
  681. returns (GetFsECBlockGroupStatsResponseProto);
  682. rpc getDatanodeReport(GetDatanodeReportRequestProto)
  683. returns(GetDatanodeReportResponseProto);
  684. rpc getDatanodeStorageReport(GetDatanodeStorageReportRequestProto)
  685. returns(GetDatanodeStorageReportResponseProto);
  686. rpc getPreferredBlockSize(GetPreferredBlockSizeRequestProto)
  687. returns(GetPreferredBlockSizeResponseProto);
  688. rpc setSafeMode(SetSafeModeRequestProto)
  689. returns(SetSafeModeResponseProto);
  690. rpc saveNamespace(SaveNamespaceRequestProto)
  691. returns(SaveNamespaceResponseProto);
  692. rpc rollEdits(RollEditsRequestProto)
  693. returns(RollEditsResponseProto);
  694. rpc restoreFailedStorage(RestoreFailedStorageRequestProto)
  695. returns(RestoreFailedStorageResponseProto);
  696. rpc refreshNodes(RefreshNodesRequestProto) returns(RefreshNodesResponseProto);
  697. rpc finalizeUpgrade(FinalizeUpgradeRequestProto)
  698. returns(FinalizeUpgradeResponseProto);
  699. rpc rollingUpgrade(RollingUpgradeRequestProto)
  700. returns(RollingUpgradeResponseProto);
  701. rpc listCorruptFileBlocks(ListCorruptFileBlocksRequestProto)
  702. returns(ListCorruptFileBlocksResponseProto);
  703. rpc metaSave(MetaSaveRequestProto) returns(MetaSaveResponseProto);
  704. rpc getFileInfo(GetFileInfoRequestProto) returns(GetFileInfoResponseProto);
  705. rpc addCacheDirective(AddCacheDirectiveRequestProto)
  706. returns (AddCacheDirectiveResponseProto);
  707. rpc modifyCacheDirective(ModifyCacheDirectiveRequestProto)
  708. returns (ModifyCacheDirectiveResponseProto);
  709. rpc removeCacheDirective(RemoveCacheDirectiveRequestProto)
  710. returns (RemoveCacheDirectiveResponseProto);
  711. rpc listCacheDirectives(ListCacheDirectivesRequestProto)
  712. returns (ListCacheDirectivesResponseProto);
  713. rpc addCachePool(AddCachePoolRequestProto)
  714. returns(AddCachePoolResponseProto);
  715. rpc modifyCachePool(ModifyCachePoolRequestProto)
  716. returns(ModifyCachePoolResponseProto);
  717. rpc removeCachePool(RemoveCachePoolRequestProto)
  718. returns(RemoveCachePoolResponseProto);
  719. rpc listCachePools(ListCachePoolsRequestProto)
  720. returns(ListCachePoolsResponseProto);
  721. rpc getFileLinkInfo(GetFileLinkInfoRequestProto)
  722. returns(GetFileLinkInfoResponseProto);
  723. rpc getContentSummary(GetContentSummaryRequestProto)
  724. returns(GetContentSummaryResponseProto);
  725. rpc setQuota(SetQuotaRequestProto) returns(SetQuotaResponseProto);
  726. rpc fsync(FsyncRequestProto) returns(FsyncResponseProto);
  727. rpc setTimes(SetTimesRequestProto) returns(SetTimesResponseProto);
  728. rpc createSymlink(CreateSymlinkRequestProto)
  729. returns(CreateSymlinkResponseProto);
  730. rpc getLinkTarget(GetLinkTargetRequestProto)
  731. returns(GetLinkTargetResponseProto);
  732. rpc updateBlockForPipeline(UpdateBlockForPipelineRequestProto)
  733. returns(UpdateBlockForPipelineResponseProto);
  734. rpc updatePipeline(UpdatePipelineRequestProto)
  735. returns(UpdatePipelineResponseProto);
  736. rpc getDelegationToken(hadoop.common.GetDelegationTokenRequestProto)
  737. returns(hadoop.common.GetDelegationTokenResponseProto);
  738. rpc renewDelegationToken(hadoop.common.RenewDelegationTokenRequestProto)
  739. returns(hadoop.common.RenewDelegationTokenResponseProto);
  740. rpc cancelDelegationToken(hadoop.common.CancelDelegationTokenRequestProto)
  741. returns(hadoop.common.CancelDelegationTokenResponseProto);
  742. rpc setBalancerBandwidth(SetBalancerBandwidthRequestProto)
  743. returns(SetBalancerBandwidthResponseProto);
  744. rpc getDataEncryptionKey(GetDataEncryptionKeyRequestProto)
  745. returns(GetDataEncryptionKeyResponseProto);
  746. rpc createSnapshot(CreateSnapshotRequestProto)
  747. returns(CreateSnapshotResponseProto);
  748. rpc renameSnapshot(RenameSnapshotRequestProto)
  749. returns(RenameSnapshotResponseProto);
  750. rpc allowSnapshot(AllowSnapshotRequestProto)
  751. returns(AllowSnapshotResponseProto);
  752. rpc disallowSnapshot(DisallowSnapshotRequestProto)
  753. returns(DisallowSnapshotResponseProto);
  754. rpc getSnapshottableDirListing(GetSnapshottableDirListingRequestProto)
  755. returns(GetSnapshottableDirListingResponseProto);
  756. rpc deleteSnapshot(DeleteSnapshotRequestProto)
  757. returns(DeleteSnapshotResponseProto);
  758. rpc getSnapshotDiffReport(GetSnapshotDiffReportRequestProto)
  759. returns(GetSnapshotDiffReportResponseProto);
  760. rpc isFileClosed(IsFileClosedRequestProto)
  761. returns(IsFileClosedResponseProto);
  762. rpc modifyAclEntries(ModifyAclEntriesRequestProto)
  763. returns(ModifyAclEntriesResponseProto);
  764. rpc removeAclEntries(RemoveAclEntriesRequestProto)
  765. returns(RemoveAclEntriesResponseProto);
  766. rpc removeDefaultAcl(RemoveDefaultAclRequestProto)
  767. returns(RemoveDefaultAclResponseProto);
  768. rpc removeAcl(RemoveAclRequestProto)
  769. returns(RemoveAclResponseProto);
  770. rpc setAcl(SetAclRequestProto)
  771. returns(SetAclResponseProto);
  772. rpc getAclStatus(GetAclStatusRequestProto)
  773. returns(GetAclStatusResponseProto);
  774. rpc setXAttr(SetXAttrRequestProto)
  775. returns(SetXAttrResponseProto);
  776. rpc getXAttrs(GetXAttrsRequestProto)
  777. returns(GetXAttrsResponseProto);
  778. rpc listXAttrs(ListXAttrsRequestProto)
  779. returns(ListXAttrsResponseProto);
  780. rpc removeXAttr(RemoveXAttrRequestProto)
  781. returns(RemoveXAttrResponseProto);
  782. rpc checkAccess(CheckAccessRequestProto)
  783. returns(CheckAccessResponseProto);
  784. rpc createEncryptionZone(CreateEncryptionZoneRequestProto)
  785. returns(CreateEncryptionZoneResponseProto);
  786. rpc listEncryptionZones(ListEncryptionZonesRequestProto)
  787. returns(ListEncryptionZonesResponseProto);
  788. rpc reencryptEncryptionZone(ReencryptEncryptionZoneRequestProto)
  789. returns(ReencryptEncryptionZoneResponseProto);
  790. rpc listReencryptionStatus(ListReencryptionStatusRequestProto)
  791. returns(ListReencryptionStatusResponseProto);
  792. rpc getEZForPath(GetEZForPathRequestProto)
  793. returns(GetEZForPathResponseProto);
  794. rpc setErasureCodingPolicy(SetErasureCodingPolicyRequestProto)
  795. returns(SetErasureCodingPolicyResponseProto);
  796. rpc unsetErasureCodingPolicy(UnsetErasureCodingPolicyRequestProto)
  797. returns(UnsetErasureCodingPolicyResponseProto);
  798. rpc getCurrentEditLogTxid(GetCurrentEditLogTxidRequestProto)
  799. returns(GetCurrentEditLogTxidResponseProto);
  800. rpc getEditsFromTxid(GetEditsFromTxidRequestProto)
  801. returns(GetEditsFromTxidResponseProto);
  802. rpc getErasureCodingPolicies(GetErasureCodingPoliciesRequestProto)
  803. returns(GetErasureCodingPoliciesResponseProto);
  804. rpc addErasureCodingPolicies(AddErasureCodingPoliciesRequestProto)
  805. returns(AddErasureCodingPoliciesResponseProto);
  806. rpc removeErasureCodingPolicy(RemoveErasureCodingPolicyRequestProto)
  807. returns(RemoveErasureCodingPolicyResponseProto);
  808. rpc enableErasureCodingPolicy(EnableErasureCodingPolicyRequestProto)
  809. returns(EnableErasureCodingPolicyResponseProto);
  810. rpc disableErasureCodingPolicy(DisableErasureCodingPolicyRequestProto)
  811. returns(DisableErasureCodingPolicyResponseProto);
  812. rpc getErasureCodingPolicy(GetErasureCodingPolicyRequestProto)
  813. returns(GetErasureCodingPolicyResponseProto);
  814. rpc getErasureCodingCodecs(GetErasureCodingCodecsRequestProto)
  815. returns(GetErasureCodingCodecsResponseProto);
  816. rpc getQuotaUsage(GetQuotaUsageRequestProto)
  817. returns(GetQuotaUsageResponseProto);
  818. rpc listOpenFiles(ListOpenFilesRequestProto)
  819. returns(ListOpenFilesResponseProto);
  820. }