/** * Add a new trace span receiver. * * @param desc The span receiver description. * @return The ID of the new trace span receiver. * * @throws IOException On error. */ @AtMostOnce public long addSpanReceiver(SpanReceiverInfo desc) throws IOException;
/** * Remove a trace span receiver. * * @param spanReceiverId The id of the span receiver to remove. * @throws IOException On error. */ @AtMostOnce public void removeSpanReceiver(long spanReceiverId) throws IOException; }
/** * A request to the active name-node to finalize * previously started checkpoint. * * @param registration the requesting node * @param sig {@code CheckpointSignature} which identifies the checkpoint. * @throws IOException */ @AtMostOnce public void endCheckpoint(NamenodeRegistration registration, CheckpointSignature sig) throws IOException;
/** * @return Gets the next available sps path, otherwise null. This API used * by External SPS. */ @AtMostOnce Long getNextSPSPath() throws IOException; }
/** * A request to the active name-node to start a checkpoint. * The name-node should decide whether to admit it or reject. * The name-node also decides what should be done with the backup node * image before and after the checkpoint. * * @see CheckpointCommand * @see NamenodeCommand * @see #ACT_SHUTDOWN * * @param registration the requesting node * @return {@link CheckpointCommand} if checkpoint is allowed. * @throws IOException */ @AtMostOnce public NamenodeCommand startCheckpoint(NamenodeRegistration registration) throws IOException;
/** * Create a snapshot. * @param snapshotRoot the path that is being snapshotted * @param snapshotName name of the snapshot created * @return the snapshot path. * @throws IOException */ @AtMostOnce String createSnapshot(String snapshotRoot, String snapshotName) throws IOException;
/** * Modify a CacheDirective in the CacheManager. * * @param flags {@link CacheFlag}s to use for this operation. * @throws IOException if the directive could not be modified */ @AtMostOnce void modifyCacheDirective(CacheDirectiveInfo directive, EnumSet<CacheFlag> flags) throws IOException;
/** * Remove erasure coding policy. * @param ecPolicyName The name of the policy to be removed. * @throws IOException */ @AtMostOnce void removeErasureCodingPolicy(String ecPolicyName) throws IOException;
/** * Add a new trace span receiver. * * @param desc The span receiver description. * @return The ID of the new trace span receiver. * * @throws IOException On error. */ @AtMostOnce public long addSpanReceiver(SpanReceiverInfo desc) throws IOException;
/** * Modify an existing cache pool. * * @param req * The request to modify a cache pool. * @throws IOException * If the request could not be completed. */ @AtMostOnce public void modifyCachePool(CachePoolInfo req) throws IOException;
/** * Delete a specific snapshot of a snapshottable directory * @param snapshotRoot The snapshottable directory * @param snapshotName Name of the snapshot for the snapshottable directory * @throws IOException */ @AtMostOnce public void deleteSnapshot(String snapshotRoot, String snapshotName) throws IOException;
/** * Add a new cache pool. * * @param info Description of the new cache pool * @throws IOException If the request could not be completed. */ @AtMostOnce public void addCachePool(CachePoolInfo info) throws IOException;
/** * Rename a snapshot. * @param snapshotRoot the directory path where the snapshot was taken * @param snapshotOldName old name of the snapshot * @param snapshotNewName new name of the snapshot * @throws IOException */ @AtMostOnce void renameSnapshot(String snapshotRoot, String snapshotOldName, String snapshotNewName) throws IOException;
/** * Create an encryption zone. */ @AtMostOnce void createEncryptionZone(String src, String keyName) throws IOException;
/** * Enable erasure coding policy. * @param ecPolicyName The name of the policy to be enabled. * @throws IOException */ @AtMostOnce void enableErasureCodingPolicy(String ecPolicyName) throws IOException;
/** * Unset erasure coding policy from a specified path. * @param src The path to unset policy. */ @AtMostOnce void unsetErasureCodingPolicy(String src) throws IOException;
/** * Remove a trace span receiver. * * @param spanReceiverId The id of the span receiver to remove. * @throws IOException On error. */ @AtMostOnce public void removeSpanReceiver(long spanReceiverId) throws IOException; }
/** * Add a new trace span receiver. * * @param desc The span receiver description. * @return The ID of the new trace span receiver. * * @throws IOException On error. */ @AtMostOnce public long addSpanReceiver(SpanReceiverInfo desc) throws IOException;
/** * A request to the active name-node to finalize * previously started checkpoint. * * @param registration the requesting node * @param sig {@code CheckpointSignature} which identifies the checkpoint. * @throws IOException */ @AtMostOnce public void endCheckpoint(NamenodeRegistration registration, CheckpointSignature sig) throws IOException;
/** * Create a snapshot * @param snapshotRoot the path that is being snapshotted * @param snapshotName name of the snapshot created * @return the snapshot path. * @throws IOException */ @AtMostOnce public String createSnapshot(String snapshotRoot, String snapshotName) throws IOException;