From 083fbda52c78855359d799e089d37ea8423715ac Mon Sep 17 00:00:00 2001 From: Willy Kloucek Date: Thu, 28 Oct 2021 13:09:36 +0200 Subject: [PATCH 1/2] add CreateFile --- cs3/gateway/v1beta1/gateway_api.proto | 4 + .../provider/v1beta1/provider_api.proto | 22 +++++ docs/index.html | 92 +++++++++++++++++++ 3 files changed, 118 insertions(+) diff --git a/cs3/gateway/v1beta1/gateway_api.proto b/cs3/gateway/v1beta1/gateway_api.proto index a1831efe..1d432375 100644 --- a/cs3/gateway/v1beta1/gateway_api.proto +++ b/cs3/gateway/v1beta1/gateway_api.proto @@ -96,6 +96,10 @@ service GatewayAPI { // MUST return CODE_PRECONDITION_FAILED if the container // cannot be created at the specified reference. rpc CreateContainer(cs3.storage.provider.v1beta1.CreateContainerRequest) returns (cs3.storage.provider.v1beta1.CreateContainerResponse); + // Creates a new resource of type file. + // MUST return CODE_PRECONDITION_FAILED if the file + // cannot be created at the specified reference. + rpc CreateFile(cs3.storage.provider.v1beta1.CreateFileRequest) returns (cs3.storage.provider.v1beta1.CreateFileResponse); // Deletes a resource. // If a resource specifies the non-empty container (directory, ...), // then the entire directory is deleted recursively. diff --git a/cs3/storage/provider/v1beta1/provider_api.proto b/cs3/storage/provider/v1beta1/provider_api.proto index 63b94d3f..c94142b3 100644 --- a/cs3/storage/provider/v1beta1/provider_api.proto +++ b/cs3/storage/provider/v1beta1/provider_api.proto @@ -57,6 +57,10 @@ service ProviderAPI { // MUST return CODE_PRECONDITION_FAILED if the container // cannot be created at the specified reference. rpc CreateContainer(CreateContainerRequest) returns (CreateContainerResponse); + // Creates a new resource of type file. + // MUST return CODE_PRECONDITION_FAILED if the file + // cannot be created at the specified reference. + rpc CreateFile(CreateFileRequest) returns (CreateFileResponse); // Deletes a resource. // If a resource specifies the non-empty container (directory, ...), // then the entire directory is deleted recursively. @@ -237,6 +241,24 @@ message CreateContainerResponse { cs3.types.v1beta1.Opaque opaque = 2; } +message CreateFileRequest { + // OPTIONAL. + // Opaque information. + cs3.types.v1beta1.Opaque opaque = 1; + // REQUIRED. + // The reference to which the action should be performed. + Reference ref = 2; +} + +message CreateFileResponse { + // REQUIRED. + // The response status. + cs3.rpc.v1beta1.Status status = 1; + // OPTIONAL. + // Opaque information. + cs3.types.v1beta1.Opaque opaque = 2; +} + message DeleteRequest { // OPTIONAL. // Opaque information. diff --git a/docs/index.html b/docs/index.html index 21f4fa3a..9d97515c 100644 --- a/docs/index.html +++ b/docs/index.html @@ -1510,6 +1510,14 @@

Table of Contents

MCreateContainerResponse +
  • + MCreateFileRequest +
    • + +
  • + MCreateFileResponse +
    • +
  • MCreateHomeRequest
    • @@ -2418,6 +2426,15 @@

    GatewayAPI

    cannot be created at the specified reference.

    + + CreateFile + .cs3.storage.provider.v1beta1.CreateFileRequest + .cs3.storage.provider.v1beta1.CreateFileResponse +

    Creates a new resource of type file. +MUST return CODE_PRECONDITION_FAILED if the file +cannot be created at the specified reference.

    + + Delete .cs3.storage.provider.v1beta1.DeleteRequest @@ -12865,6 +12882,72 @@

    CreateContainerRes +

    CreateFileRequest

    +

    + + + + + + + + + + + + + + + + + + + + + + + +
    FieldTypeLabelDescription
    opaquecs3.types.v1beta1.Opaque

    OPTIONAL. +Opaque information.

    refReference

    REQUIRED. +The reference to which the action should be performed.

    + + + + + +

    CreateFileResponse

    +

    + + + + + + + + + + + + + + + + + + + + + + + +
    FieldTypeLabelDescription
    statuscs3.rpc.v1beta1.Status

    REQUIRED. +The response status.

    opaquecs3.types.v1beta1.Opaque

    OPTIONAL. +Opaque information.

    + + + + +

    CreateHomeRequest

    @@ -15235,6 +15318,15 @@

    ProviderAPI

    cannot be created at the specified reference.

    + + CreateFile + CreateFileRequest + CreateFileResponse +

    Creates a new resource of type file. +MUST return CODE_PRECONDITION_FAILED if the file +cannot be created at the specified reference.

    + + Delete DeleteRequest From 42c662fe936fc0a2051b5716add0ed7a6d74f2f9 Mon Sep 17 00:00:00 2001 From: Willy Kloucek Date: Thu, 2 Dec 2021 15:19:39 +0100 Subject: [PATCH 2/2] rename CreateFile... to TouchFile... --- cs3/gateway/v1beta1/gateway_api.proto | 2 +- .../provider/v1beta1/provider_api.proto | 6 +- docs/index.html | 160 +++++++++--------- 3 files changed, 84 insertions(+), 84 deletions(-) diff --git a/cs3/gateway/v1beta1/gateway_api.proto b/cs3/gateway/v1beta1/gateway_api.proto index 1d432375..9123ac62 100644 --- a/cs3/gateway/v1beta1/gateway_api.proto +++ b/cs3/gateway/v1beta1/gateway_api.proto @@ -99,7 +99,7 @@ service GatewayAPI { // Creates a new resource of type file. // MUST return CODE_PRECONDITION_FAILED if the file // cannot be created at the specified reference. - rpc CreateFile(cs3.storage.provider.v1beta1.CreateFileRequest) returns (cs3.storage.provider.v1beta1.CreateFileResponse); + rpc TouchFile(cs3.storage.provider.v1beta1.TouchFileRequest) returns (cs3.storage.provider.v1beta1.TouchFileResponse); // Deletes a resource. // If a resource specifies the non-empty container (directory, ...), // then the entire directory is deleted recursively. diff --git a/cs3/storage/provider/v1beta1/provider_api.proto b/cs3/storage/provider/v1beta1/provider_api.proto index c94142b3..a5f2f500 100644 --- a/cs3/storage/provider/v1beta1/provider_api.proto +++ b/cs3/storage/provider/v1beta1/provider_api.proto @@ -60,7 +60,7 @@ service ProviderAPI { // Creates a new resource of type file. // MUST return CODE_PRECONDITION_FAILED if the file // cannot be created at the specified reference. - rpc CreateFile(CreateFileRequest) returns (CreateFileResponse); + rpc TouchFile(TouchFileRequest) returns (TouchFileResponse); // Deletes a resource. // If a resource specifies the non-empty container (directory, ...), // then the entire directory is deleted recursively. @@ -241,7 +241,7 @@ message CreateContainerResponse { cs3.types.v1beta1.Opaque opaque = 2; } -message CreateFileRequest { +message TouchFileRequest { // OPTIONAL. // Opaque information. cs3.types.v1beta1.Opaque opaque = 1; @@ -250,7 +250,7 @@ message CreateFileRequest { Reference ref = 2; } -message CreateFileResponse { +message TouchFileResponse { // REQUIRED. // The response status. cs3.rpc.v1beta1.Status status = 1; diff --git a/docs/index.html b/docs/index.html index 9d97515c..a0df5272 100644 --- a/docs/index.html +++ b/docs/index.html @@ -1510,14 +1510,6 @@

    Table of Contents

    MCreateContainerResponse -
  • - MCreateFileRequest -
    • - -
  • - MCreateFileResponse -
    • -
  • MCreateHomeRequest
    • @@ -1730,6 +1722,14 @@

    Table of Contents

    MStatResponse +
  • + MTouchFileRequest +
    • + +
  • + MTouchFileResponse +
    • +
  • MUnsetArbitraryMetadataRequest
    • @@ -2427,9 +2427,9 @@

    GatewayAPI

    - CreateFile - .cs3.storage.provider.v1beta1.CreateFileRequest - .cs3.storage.provider.v1beta1.CreateFileResponse + TouchFile + .cs3.storage.provider.v1beta1.TouchFileRequest + .cs3.storage.provider.v1beta1.TouchFileResponse

    Creates a new resource of type file. MUST return CODE_PRECONDITION_FAILED if the file cannot be created at the specified reference.

    @@ -12882,72 +12882,6 @@

    CreateContainerRes -

    CreateFileRequest

    -

    - - - - - - - - - - - - - - - - - - - - - - - -
    FieldTypeLabelDescription
    opaquecs3.types.v1beta1.Opaque

    OPTIONAL. -Opaque information.

    refReference

    REQUIRED. -The reference to which the action should be performed.

    - - - - - -

    CreateFileResponse

    -

    - - - - - - - - - - - - - - - - - - - - - - - -
    FieldTypeLabelDescription
    statuscs3.rpc.v1beta1.Status

    REQUIRED. -The response status.

    opaquecs3.types.v1beta1.Opaque

    OPTIONAL. -Opaque information.

    - - - - -

    CreateHomeRequest

    @@ -15025,6 +14959,72 @@

    StatResponse

    +

    TouchFileRequest

    +

    + + + + + + + + + + + + + + + + + + + + + + + +
    FieldTypeLabelDescription
    opaquecs3.types.v1beta1.Opaque

    OPTIONAL. +Opaque information.

    refReference

    REQUIRED. +The reference to which the action should be performed.

    + + + + + +

    TouchFileResponse

    +

    + + + + + + + + + + + + + + + + + + + + + + + +
    FieldTypeLabelDescription
    statuscs3.rpc.v1beta1.Status

    REQUIRED. +The response status.

    opaquecs3.types.v1beta1.Opaque

    OPTIONAL. +Opaque information.

    + + + + +

    UnsetArbitraryMetadataRequest

    @@ -15319,9 +15319,9 @@

    ProviderAPI

    - CreateFile - CreateFileRequest - CreateFileResponse + TouchFile + TouchFileRequest + TouchFileResponse

    Creates a new resource of type file. MUST return CODE_PRECONDITION_FAILED if the file cannot be created at the specified reference.