github.com/pachyderm/pachyderm@v1.13.4/src/client/admin/v1_7/enterprise/enterprise.proto (about)

     1  syntax = "proto3";
     2  
     3  package enterprise_1_7;
     4  option go_package = "github.com/pachyderm/pachyderm/src/client/admin/v1_7/enterprise";
     5  
     6  import "google/protobuf/timestamp.proto";
     7  
     8  // Enterprise data structures
     9  
    10  // EnterpriseRecord is the record we store in etcd for a Pachyderm enterprise
    11  // token that has been provided to a Pachyderm cluster
    12  message EnterpriseRecord {
    13    string activation_code = 1;
    14  
    15    // expires is a timestamp indicating when this activation code will expire.
    16    google.protobuf.Timestamp expires = 2;
    17  }
    18  
    19  //// Enterprise Activation API
    20  
    21  // TokenInfo contains information about the currently active enterprise token
    22  message TokenInfo {
    23    // expires indicates when the current token expires (unset if there is no
    24    // current token)
    25    google.protobuf.Timestamp expires = 1;
    26  }
    27  
    28  message ActivateRequest {
    29    // activation_code is a Pachyderm enterprise activation code. New users can
    30    // obtain trial activation codes
    31    string activation_code = 1;
    32  
    33    // expires is a timestamp indicating when this activation code will expire.
    34    // This should not generally be set (it's primarily used for testing), and is
    35    // only applied if it's earlier than the signed expiration time in
    36    // 'activation_code'.
    37    google.protobuf.Timestamp expires = 2;
    38  }
    39  message ActivateResponse {
    40    TokenInfo info = 1;
    41  }
    42  
    43  message GetStateRequest {}
    44  
    45  enum State {
    46    NONE = 0;
    47    ACTIVE = 1;
    48    EXPIRED = 2;
    49  }
    50  
    51  message GetStateResponse {
    52    State state = 1;
    53    TokenInfo info = 2;
    54  }
    55  
    56  message DeactivateRequest{}
    57  message DeactivateResponse{}
    58  
    59  service API {
    60    // Provide a Pachyderm enterprise token, enabling Pachyderm enterprise
    61    // features, such as the Pachyderm Dashboard and Auth system
    62    rpc Activate(ActivateRequest) returns (ActivateResponse) {}
    63    rpc GetState(GetStateRequest) returns (GetStateResponse) {}
    64  
    65    // Deactivate is a testing API. It removes a cluster's enterprise activation
    66    // token and sets its enterprise state to NONE (normally, once a cluster has
    67    // been activated, the only reachable state is EXPIRED).
    68    //
    69    // NOTE: This endpoint also calls DeleteAll (and deletes all Pachyderm data in
    70    // its cluster). This is to avoid dealing with invalid, intermediate states
    71    // (e.g. auth is activated but enterprise state is NONE)
    72    rpc Deactivate(DeactivateRequest) returns (DeactivateResponse) {}
    73  }
    74