Document atomic nature of batch create/update/delete RPCs

buf/registry/module/v1beta1/commit_service.proto

@@ -181,6 +181,8 @@ message CreateCommitsRequest {
   //
   // If there are already VCSCommits on the associated Module with a given hash, this
   // will result in an error. Otherwise, a new VCSCommit is created.
+  //
+  // This operation is atomic. Either all Commits are created, or an error happens and none of them are created.
   repeated AssociatedVCSCommit associated_vcs_commits = 5;
 }
 

buf/registry/module/v1beta1/module_service.proto

@@ -112,6 +112,8 @@ message CreateModulesRequest {
     string release_branch_name = 6 [(buf.validate.field).string.max_len = 255];
   }
   // The Modules to create.
+  //
+  // This operation is atomic. Either all Modules are created, or an error happens and none of them are created.
   repeated Value values = 1 [(buf.validate.field).repeated.min_items = 1];
 }
 
@@ -148,6 +150,8 @@ message UpdateModulesRequest {
     }
   }
   // The Modules to update.
+  //
+  // This operation is atomic. Either all Modules are updated, or an error happens and none of them are updated.
   repeated Value values = 1 [(buf.validate.field).repeated.min_items = 1];
 }
 
@@ -158,6 +162,8 @@ message UpdateModulesResponse {
 
 message DeleteModulesRequest {
   // The Modules to delete.
+  //
+  // This operation is atomic. Either all Modules are deleted, or an error happens and none of them are deleted.
   repeated ModuleRef module_refs = 1 [(buf.validate.field).repeated.min_items = 1];
 }
 

buf/registry/module/v1beta1/tag_service.proto

@@ -101,6 +101,8 @@ message CreateTagsRequest {
     ];
   }
   // The Tags to create.
+  //
+  // This operation is atomic. Either all Tags are created, or an error happens and none of them are created.
   repeated Value values = 1 [(buf.validate.field).repeated.min_items = 1];
 }
 
@@ -111,6 +113,8 @@ message CreateTagsResponse {
 
 message DeleteTagsRequest {
   // The Tags to delete.
+  //
+  // This operation is atomic. Either all Tags are deleted, or an error happens and none of them are deleted.
   repeated TagRef tag_refs = 1 [(buf.validate.field).repeated.min_items = 1];
 }
 

buf/registry/owner/v1beta1/organization_service.proto

@@ -102,6 +102,8 @@ message CreateOrganizationsRequest {
     OrganizationVerificationStatus verification_status = 4 [(buf.validate.field).enum.defined_only = true];
   }
   // The Organizations to create.
+  //
+  // This operation is atomic. Either all Organizations are created, or an error happens and none of them are created.
   repeated Value values = 1 [(buf.validate.field).repeated.min_items = 1];
 }
 
@@ -126,6 +128,8 @@ message UpdateOrganizationsRequest {
     optional OrganizationVerificationStatus verification_status = 4 [(buf.validate.field).enum.defined_only = true];
   }
   // The Organizations to update.
+  //
+  // This operation is atomic. Either all Organizations are updated, or an error happens and none of them are updated.
   repeated Value values = 1 [(buf.validate.field).repeated.min_items = 1];
 }
 
@@ -136,6 +140,8 @@ message UpdateOrganizationsResponse {
 
 message DeleteOrganizationsRequest {
   // The Organizations to delete.
+  //
+  // This operation is atomic. Either all Organizations are deleted, or an error happens and none of them are deleted.
   repeated OrganizationRef organization_refs = 1 [(buf.validate.field).repeated.min_items = 1];
 }
 

buf/registry/owner/v1beta1/user_service.proto

@@ -110,6 +110,8 @@ message CreateUsersRequest {
     UserVerificationStatus verification_status = 6 [(buf.validate.field).enum.defined_only = true];
   }
   // The Users to create.
+  //
+  // This operation is atomic. Either all Users are created, or an error happens and none of them are created.
   repeated Value values = 1 [(buf.validate.field).repeated.min_items = 1];
 }
 
@@ -138,6 +140,8 @@ message UpdateUsersRequest {
     optional UserVerificationStatus verification_status = 6 [(buf.validate.field).enum.defined_only = true];
   }
   // The Users to update.
+  //
+  // This operation is atomic. Either all Users are updated, or an error happens and none of them are updated.
   repeated Value values = 1 [(buf.validate.field).repeated.min_items = 1];
 }
 
@@ -148,6 +152,8 @@ message UpdateUsersResponse {
 
 message DeleteUsersRequest {
   // The Users to delete.
+  //
+  // This operation is atomic. Either all Users are deleted, or an error happens and none of them are deleted.
   repeated UserRef user_refs = 1 [(buf.validate.field).repeated.min_items = 1];
 }