diff --git a/buf/registry/module/v1beta1/commit_service.proto b/buf/registry/module/v1beta1/commit_service.proto index c89ae2a..c3a8882 100644 --- a/buf/registry/module/v1beta1/commit_service.proto +++ b/buf/registry/module/v1beta1/commit_service.proto @@ -39,6 +39,8 @@ service CommitService { // // This is used by push and sync. // + // This operation is atomic. Either all Commits and associated content are created or an error is returned. + // // TODO: PushCommits? Something else? This is creating potentially a bunch of resources. rpc CreateCommits(CreateCommitsRequest) returns (CreateCommitsResponse) { option idempotency_level = IDEMPOTENT; diff --git a/buf/registry/module/v1beta1/module_service.proto b/buf/registry/module/v1beta1/module_service.proto index e4f596a..48297fa 100644 --- a/buf/registry/module/v1beta1/module_service.proto +++ b/buf/registry/module/v1beta1/module_service.proto @@ -36,14 +36,20 @@ service ModuleService { // // When a Module is created, a Branch representing the release Branch // is created as well. + // + // This operation is atomic. Either all Modules are created or an error is returned. rpc CreateModules(CreateModulesRequest) returns (CreateModulesResponse) { option idempotency_level = IDEMPOTENT; } // Update existing Modules. + // + // This operation is atomic. Either all Modules are updated or an error is returned. rpc UpdateModules(UpdateModulesRequest) returns (UpdateModulesResponse) { option idempotency_level = IDEMPOTENT; } // Delete existing Modules. + // + // This operation is atomic. Either all Modules are deleted or an error is returned. rpc DeleteModules(DeleteModulesRequest) returns (DeleteModulesResponse) { option idempotency_level = IDEMPOTENT; } diff --git a/buf/registry/module/v1beta1/tag_service.proto b/buf/registry/module/v1beta1/tag_service.proto index 4c8decf..ab32fdd 100644 --- a/buf/registry/module/v1beta1/tag_service.proto +++ b/buf/registry/module/v1beta1/tag_service.proto @@ -34,10 +34,14 @@ service TagService { option idempotency_level = NO_SIDE_EFFECTS; } // Create new Tags on a Module. + // + // This operation is atomic. Either all Tags are created or an error is returned. rpc CreateTags(CreateTagsRequest) returns (CreateTagsResponse) { option idempotency_level = IDEMPOTENT; } // Delete existing Tags. + // + // This operation is atomic. Either all Tags are deleted or an error is returned. rpc DeleteTags(DeleteTagsRequest) returns (DeleteTagsResponse) { option idempotency_level = IDEMPOTENT; } diff --git a/buf/registry/owner/v1beta1/organization_service.proto b/buf/registry/owner/v1beta1/organization_service.proto index 0efaf8b..e2639c0 100644 --- a/buf/registry/owner/v1beta1/organization_service.proto +++ b/buf/registry/owner/v1beta1/organization_service.proto @@ -33,14 +33,20 @@ service OrganizationService { option idempotency_level = NO_SIDE_EFFECTS; } // Create new Organizations. + // + // This operation is atomic. Either all Organizations are created or an error is returned. rpc CreateOrganizations(CreateOrganizationsRequest) returns (CreateOrganizationsResponse) { option idempotency_level = IDEMPOTENT; } // Update existing organizations. + // + // This operation is atomic. Either all Organizations are updated or an error is returned. rpc UpdateOrganizations(UpdateOrganizationsRequest) returns (UpdateOrganizationsResponse) { option idempotency_level = IDEMPOTENT; } // Delete existsing organizations. + // + // This operation is atomic. Either all Organizations are deleted or an error is returned. rpc DeleteOrganizations(DeleteOrganizationsRequest) returns (DeleteOrganizationsResponse) { option idempotency_level = IDEMPOTENT; } diff --git a/buf/registry/owner/v1beta1/user_service.proto b/buf/registry/owner/v1beta1/user_service.proto index 4e8ca36..a32cb52 100644 --- a/buf/registry/owner/v1beta1/user_service.proto +++ b/buf/registry/owner/v1beta1/user_service.proto @@ -33,14 +33,20 @@ service UserService { option idempotency_level = NO_SIDE_EFFECTS; } // Create new Users. + // + // This operation is atomic. Either all Users are created or an error is returned. rpc CreateUsers(CreateUsersRequest) returns (CreateUsersResponse) { option idempotency_level = IDEMPOTENT; } // Update existing Users. + // + // This operation is atomic. Either all Users are updated or an error is returned. rpc UpdateUsers(UpdateUsersRequest) returns (UpdateUsersResponse) { option idempotency_level = IDEMPOTENT; } // Delete existing Users. + // + // This operation is atomic. Either all Users are deleted or an error is returned. rpc DeleteUsers(DeleteUsersRequest) returns (DeleteUsersResponse) { option idempotency_level = IDEMPOTENT; }