https://andygol-etcd.netlify.app/uk/docs/v3.6/dev-guide/Recent content in Посібник розробника on etcdHugoukhttps://andygol-etcd.netlify.app/uk/docs/v3.6/dev-guide/discovery_protocol/Mon, 01 Jan 0001 00:00:00 +0000https://andygol-etcd.netlify.app/uk/docs/v3.6/dev-guide/discovery_protocol/<p>Протокол служби виявлення допомагає новому учаснику etcd виявити всіх інших учасників у фазі завантаження кластера за допомогою спільної URL-адреси виявлення.</p> <p>Протокол служби виявлення використовується <em>лише</em> на етапі запуску кластера і не може застосовуватися для переналаштування під час роботи або моніторингу кластера.</p> <p>Протокол використовує новий токен виявлення для завантаження одного <em>унікального</em> кластера etcd. Памʼятайте, що один токен виявлення може представляти лише один кластер etcd. Як тільки протокол виявлення на цьому токені починається, навіть якщо він переривається на півдорозі, його не можна використовувати для завантаження іншого кластера etcd.</p>https://andygol-etcd.netlify.app/uk/docs/v3.6/dev-guide/local_cluster/Mon, 01 Jan 0001 00:00:00 +0000https://andygol-etcd.netlify.app/uk/docs/v3.6/dev-guide/local_cluster/<p>Для тестування та розробки найшвидший і найпростіший спосіб — налаштувати локальний кластер. Для розгортання в операційному середовищі зверніться до розділу <a href="https://andygol-etcd.netlify.app/uk/docs/v3.6/op-guide/clustering/">кластеризація</a>.</p> <h2 id="local-standalone-cluster">Локальний автономний кластер<a class="td-heading-self-link" href="#local-standalone-cluster" aria-label="Heading self-link"></a></h2> <h3 id="starting-a-cluster">Запуск кластера<a class="td-heading-self-link" href="#starting-a-cluster" aria-label="Heading self-link"></a></h3> <p>Виконайте наступне, щоб розгорнути кластер etcd як автономний кластер:</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl">$ ./etcd </span></span><span class="line"><span class="cl">... </span></span></code></pre></div><p>Якщо бінарний файл <code>etcd</code> не присутній у поточній робочій теці, він може знаходитися або в <code>$GOPATH/bin/etcd</code>, або в <code>/usr/local/bin/etcd</code>. Виконайте команду відповідно.</p> <p>Запущений член etcd слухає на <code>localhost:2379</code> для клієнтських запитів.</p>https://andygol-etcd.netlify.app/uk/docs/v3.6/dev-guide/interacting_v3/Mon, 01 Jan 0001 00:00:00 +0000https://andygol-etcd.netlify.app/uk/docs/v3.6/dev-guide/interacting_v3/<p>Користувачі здебільшого взаємодіють з etcd, встановлюючи або отримуючи значення ключа. У цьому розділі описано, як це зробити за допомогою etcdctl, інструменту командного рядка для взаємодії з сервером etcd. Описані концепції повинні застосовуватися до gRPC API або API бібліотеки клієнта.</p> <p>Версія API, яку використовує etcdctl для взаємодії з etcd, може бути встановлена на версію <code>2</code> або <code>3</code> за допомогою змінної середовища <code>ETCDCTL_API</code>. Стандартно, etcdctl на master (3.4) використовує API v3, а попередні версії (3.3 і раніше) стандартно використовують API v2.</p>https://andygol-etcd.netlify.app/uk/docs/v3.6/dev-guide/api_grpc_gateway/Mon, 01 Jan 0001 00:00:00 +0000https://andygol-etcd.netlify.app/uk/docs/v3.6/dev-guide/api_grpc_gateway/<p>etcd v3 використовує <a href="https://www.grpc.io/">gRPC</a> для свого протоколу обміну повідомленнями. Проєкт etcd включає клієнт на основі gRPC <a href="https://github.com/etcd-io/etcd/tree/main/client/v3">Go client</a> та утиліту командного рядка <a href="https://github.com/etcd-io/etcd/tree/main/etcdctl">etcdctl</a> для спілкування з кластером etcd через gRPC. Для мов, які не підтримують gRPC, etcd надає JSON <a href="https://github.com/grpc-ecosystem/grpc-gateway">gRPC gateway</a>. Цей шлюз обслуговує RESTful проксі, який перетворює HTTP/JSON запити в gRPC повідомлення.</p> <h2 id="using-grpc-gateway">Використання gRPC gateway<a class="td-heading-self-link" href="#using-grpc-gateway" aria-label="Heading self-link"></a></h2> <p>Шлюз приймає <a href="https://developers.google.com/protocol-buffers/docs/proto3#json">JSON mapping</a> для <a href="https://andygol-etcd.netlify.app/uk/docs/v3.6/dev-guide/api_reference_v3/">protocol buffer</a> визначень повідомлень etcd. Зверніть увагу, що поля <code>key</code> та <code>value</code> визначені як масиви байтів і тому повинні бути закодовані в base64 у JSON. Наступні приклади використовують <code>curl</code>, але будь-який HTTP/JSON клієнт повинен працювати так само.</p>https://andygol-etcd.netlify.app/uk/docs/v3.6/dev-guide/grpc_naming/Mon, 01 Jan 0001 00:00:00 +0000https://andygol-etcd.netlify.app/uk/docs/v3.6/dev-guide/grpc_naming/<p>etcd надає gRPC резолвер для підтримки альтернативної системи імен, яка отримує точки доступу з etcd для виявлення gRPC сервісів. Основний механізм базується на спостереженні за оновленнями ключів з префіксом імені сервісу.</p> <p>Зверніть увагу, що ця функція є експериментальною, оскільки вона залежить від пакунку <a href="https://github.com/grpc/grpc-go/tree/4cedec40eb2ccfbe3f56bb15e894903111ada2d2/resolver">google.golang.org/grpc/resolver</a>, який досі є експериментальним у grpc-go.</p> <h2 id="using-etcd-discovery-with-go-grpc">Використання etcd discovery з go-grpc<a class="td-heading-self-link" href="#using-etcd-discovery-with-go-grpc" aria-label="Heading self-link"></a></h2> <p>Клієнт etcd надає gRPC резолвер для вирішення gRPC точок доступу з бекендом etcd. Резолвер ініціалізується клієнтом etcd:</p>https://andygol-etcd.netlify.app/uk/docs/v3.6/dev-guide/golang_embed_pkg/Mon, 01 Jan 0001 00:00:00 +0000https://andygol-etcd.netlify.app/uk/docs/v3.6/dev-guide/golang_embed_pkg/<p>Пакунок <code>embed</code> Go надає простий спосіб вбудувати сервер etcd прямо у ваш застосунок.</p> <p>Для отримання додаткової інформації див. <a href="https://pkg.go.dev/go.etcd.io/etcd/server/v3/embed">документацію пакунка embed</a>.</p>https://andygol-etcd.netlify.app/uk/docs/v3.6/dev-guide/limit/Mon, 01 Jan 0001 00:00:00 +0000https://andygol-etcd.netlify.app/uk/docs/v3.6/dev-guide/limit/<h2 id="request-size-limit">Обмеження розміру запиту<a class="td-heading-self-link" href="#request-size-limit" aria-label="Heading self-link"></a></h2> <p>etcd розроблений для обробки невеликих пар ключ-значення, типових для метаданих. Більші запити також працюватимуть, але можуть збільшити затримку інших запитів. Стандартно максимальний розмір будь-якого запиту становить 1.5 MiB. Це обмеження можна налаштувати за допомогою прапорця <code>--max-request-bytes</code> для сервера etcd.</p> <h2 id="storage-size-limit">Обмеження розміру зберігання<a class="td-heading-self-link" href="#storage-size-limit" aria-label="Heading self-link"></a></h2> <p>Стандартно обмеження розміру зберігання становить 2 GiB, яке можна налаштувати за допомогою прапорця <code>--quota-backend-bytes</code>. 8 GiB є рекомендованим максимальним розміром для нормальних середовищ, і etcd попереджає при запуску, якщо налаштоване значення перевищує його.</p>https://andygol-etcd.netlify.app/uk/docs/v3.6/dev-guide/features/Mon, 01 Jan 0001 00:00:00 +0000https://andygol-etcd.netlify.app/uk/docs/v3.6/dev-guide/features/<p>Цей документ надає огляд функцій etcd, щоб допомогти користувачам краще зрозуміти функції та повʼязаний процес їх застарівання. Якщо вас цікавить, як функції розробляються в etcd, будь ласка, перегляньте ці <a href="https://github.com/etcd-io/etcd/blob/main/Documentation/contributor-guide/features.md">керівні принципи розробки</a>.</p> <p>Функції etcd поділяються на три стадії: експериментальні, стабільні та небезпечні. Ви можете отримати список функцій, запустивши <code>etcd --help</code>.</p> <h2 id="experimental">Експериментальні<a class="td-heading-self-link" href="#experimental" aria-label="Heading self-link"></a></h2> <p>Щоб отримати ранній зворотний звʼязок, будь-яка нова функція зазвичай додається як експериментальна. Експериментальну функцію можна визначити за назвою прапорця, яка повинна мати префікс <code>--experimental</code>. Будь ласка, врахуйте наступні моменти під час використання експериментальної функції:</p>https://andygol-etcd.netlify.app/uk/docs/v3.6/dev-guide/api_reference_v3/Mon, 01 Jan 0001 00:00:00 +0000https://andygol-etcd.netlify.app/uk/docs/v3.6/dev-guide/api_reference_v3/<p>Ця довідник API автоматично згенерована з вказаних файлів <code>.proto</code>.</p> <h5 id="service-auth-apietcdserverpbrpcproto">service <code>Auth</code> (api/etcdserverpb/rpc.proto)<a class="td-heading-self-link" href="#service-auth-apietcdserverpbrpcproto" aria-label="Heading self-link"></a></h5> <table> <thead> <tr> <th>Метод</th> <th>Тип запиту</th> <th>Тип відповіді</th> <th>Опис</th> </tr> </thead> <tbody> <tr> <td>AuthEnable</td> <td>AuthEnableRequest</td> <td>AuthEnableResponse</td> <td>AuthEnable вмикає автентифікацію.</td> </tr> <tr> <td>AuthDisable</td> <td>AuthDisableRequest</td> <td>AuthDisableResponse</td> <td>AuthDisable вимикає автентифікацію.</td> </tr> <tr> <td>AuthStatus</td> <td>AuthStatusRequest</td> <td>AuthStatusResponse</td> <td>AuthStatus показує статус автентифікації.</td> </tr> <tr> <td>Authenticate</td> <td>AuthenticateRequest</td> <td>AuthenticateResponse</td> <td>Authenticate обробляє запит автентифікації.</td> </tr> <tr> <td>UserAdd</td> <td>AuthUserAddRequest</td> <td>AuthUserAddResponse</td> <td>UserAdd додає нового користувача. Імʼя користувача не може бути порожнім.</td> </tr> <tr> <td>UserGet</td> <td>AuthUserGetRequest</td> <td>AuthUserGetResponse</td> <td>UserGet отримує детальну інформацію про користувача.</td> </tr> <tr> <td>UserList</td> <td>AuthUserListRequest</td> <td>AuthUserListResponse</td> <td>UserList отримує список всіх користувачів.</td> </tr> <tr> <td>UserDelete</td> <td>AuthUserDeleteRequest</td> <td>AuthUserDeleteResponse</td> <td>UserDelete видаляє вказаного користувача.</td> </tr> <tr> <td>UserChangePassword</td> <td>AuthUserChangePasswordRequest</td> <td>AuthUserChangePasswordResponse</td> <td>UserChangePassword змінює пароль вказаного користувача.</td> </tr> <tr> <td>UserGrantRole</td> <td>AuthUserGrantRoleRequest</td> <td>AuthUserGrantRoleResponse</td> <td>UserGrant надає роль вказаному користувачу.</td> </tr> <tr> <td>UserRevokeRole</td> <td>AuthUserRevokeRoleRequest</td> <td>AuthUserRevokeRoleResponse</td> <td>UserRevokeRole відкликає роль вказаного користувача.</td> </tr> <tr> <td>RoleAdd</td> <td>AuthRoleAddRequest</td> <td>AuthRoleAddResponse</td> <td>RoleAdd додає нову роль. Імʼя ролі не може бути порожнім.</td> </tr> <tr> <td>RoleGet</td> <td>AuthRoleGetRequest</td> <td>AuthRoleGetResponse</td> <td>RoleGet отримує детальну інформацію про роль.</td> </tr> <tr> <td>RoleList</td> <td>AuthRoleListRequest</td> <td>AuthRoleListResponse</td> <td>RoleList отримує список всіх ролей.</td> </tr> <tr> <td>RoleDelete</td> <td>AuthRoleDeleteRequest</td> <td>AuthRoleDeleteResponse</td> <td>RoleDelete видаляє вказану роль.</td> </tr> <tr> <td>RoleGrantPermission</td> <td>AuthRoleGrantPermissionRequest</td> <td>AuthRoleGrantPermissionResponse</td> <td>RoleGrantPermission надає дозвіл на вказаний ключ або діапазон вказаній ролі.</td> </tr> <tr> <td>RoleRevokePermission</td> <td>AuthRoleRevokePermissionRequest</td> <td>AuthRoleRevokePermissionResponse</td> <td>RoleRevokePermission відкликає дозвіл на ключ або діапазон вказаної ролі.</td> </tr> </tbody> </table> <h5 id="service-cluster-apietcdserverpbrpcproto">service <code>Cluster</code> (api/etcdserverpb/rpc.proto)<a class="td-heading-self-link" href="#service-cluster-apietcdserverpbrpcproto" aria-label="Heading self-link"></a></h5> <table> <thead> <tr> <th>Метод</th> <th>Тип запиту</th> <th>Тип відповіді</th> <th>Опис</th> </tr> </thead> <tbody> <tr> <td>MemberAdd</td> <td>MemberAddRequest</td> <td>MemberAddResponse</td> <td>MemberAdd додає учасника до кластера.</td> </tr> <tr> <td>MemberRemove</td> <td>MemberRemoveRequest</td> <td>MemberRemoveResponse</td> <td>MemberRemove видаляє існуючого учасника з кластера.</td> </tr> <tr> <td>MemberUpdate</td> <td>MemberUpdateRequest</td> <td>MemberUpdateResponse</td> <td>MemberUpdate оновлює конфігурацію учасника.</td> </tr> <tr> <td>MemberList</td> <td>MemberListRequest</td> <td>MemberListResponse</td> <td>MemberList показує всіх учасників кластера.</td> </tr> <tr> <td>MemberPromote</td> <td>MemberPromoteRequest</td> <td>MemberPromoteResponse</td> <td>MemberPromote підвищує учасника з raft learner (без права голосу) до raft учасника з правом голосу.</td> </tr> </tbody> </table> <h5 id="service-kv-apietcdserverpbrpcproto">service <code>KV</code> (api/etcdserverpb/rpc.proto)<a class="td-heading-self-link" href="#service-kv-apietcdserverpbrpcproto" aria-label="Heading self-link"></a></h5> <table> <thead> <tr> <th>Метод</th> <th>Тип запиту</th> <th>Тип відповіді</th> <th>Опис</th> </tr> </thead> <tbody> <tr> <td>Range</td> <td>RangeRequest</td> <td>RangeResponse</td> <td>Range отримує ключі в діапазоні з сховища ключ-значення.</td> </tr> <tr> <td>Put</td> <td>PutRequest</td> <td>PutResponse</td> <td>Put вставляє вказаний ключ у сховище ключ-значення. Запит на вставку збільшує ревізію сховища ключ-значення і генерує одну подію в історії подій.</td> </tr> <tr> <td>DeleteRange</td> <td>DeleteRangeRequest</td> <td>DeleteRangeResponse</td> <td>DeleteRange видаляє вказаний діапазон зі сховища ключ-значення. Запит на видалення збільшує ревізію сховища ключ-значення і генерує подію видалення в історії подій для кожного видаленого ключа.</td> </tr> <tr> <td>Txn</td> <td>TxnRequest</td> <td>TxnResponse</td> <td>Txn обробляє кілька запитів в одній транзакції. Запит на транзакцію збільшує ревізію сховища ключ-значення і генерує події з тією ж ревізією для кожного завершеного запиту. Не дозволяється змінювати один і той самий ключ кілька разів в одній транзакції.</td> </tr> <tr> <td>Compact</td> <td>CompactionRequest</td> <td>CompactionResponse</td> <td>Compact стискає історію подій у сховищі ключ-значення etcd. Сховище ключ-значення повинно періодично стискатися, інакше історія подій буде рости нескінченно.</td> </tr> </tbody> </table> <h5 id="service-lease-apietcdserverpbrpcproto">service <code>Lease</code> (api/etcdserverpb/rpc.proto)<a class="td-heading-self-link" href="#service-lease-apietcdserverpbrpcproto" aria-label="Heading self-link"></a></h5> <table> <thead> <tr> <th>Метод</th> <th>Тип запиту</th> <th>Тип відповіді</th> <th>Опис</th> </tr> </thead> <tbody> <tr> <td>LeaseGrant</td> <td>LeaseGrantRequest</td> <td>LeaseGrantResponse</td> <td>LeaseGrant створює лізинг, який закінчується, якщо сервер не отримує keepAlive протягом заданого періоду часу. Всі ключі, прикріплені до лізингу, будуть видалені після закінчення терміну дії лізингу. Кожен видалений ключ генерує подію видалення в історії подій.</td> </tr> <tr> <td>LeaseRevoke</td> <td>LeaseRevokeRequest</td> <td>LeaseRevokeResponse</td> <td>LeaseRevoke відкликає лізинг. Всі ключі, прикріплені до лізингу, будуть видалені.</td> </tr> <tr> <td>LeaseKeepAlive</td> <td>LeaseKeepAliveRequest</td> <td>LeaseKeepAliveResponse</td> <td>LeaseKeepAlive підтримує лізинг активним, передаючи запити keep alive від клієнта до сервера і відповіді keep alive від сервера до клієнта.</td> </tr> <tr> <td>LeaseTimeToLive</td> <td>LeaseTimeToLiveRequest</td> <td>LeaseTimeToLiveResponse</td> <td>LeaseTimeToLive отримує інформацію про лізинг.</td> </tr> <tr> <td>LeaseLeases</td> <td>LeaseLeasesRequest</td> <td>LeaseLeasesResponse</td> <td>LeaseLeases показує всі існуючі лізинги.</td> </tr> </tbody> </table> <h5 id="service-maintenance-apietcdserverpbrpcproto">service <code>Maintenance</code> (api/etcdserverpb/rpc.proto)<a class="td-heading-self-link" href="#service-maintenance-apietcdserverpbrpcproto" aria-label="Heading self-link"></a></h5> <table> <thead> <tr> <th>Метод</th> <th>Тип запиту</th> <th>Тип відповіді</th> <th>Опис</th> </tr> </thead> <tbody> <tr> <td>Alarm</td> <td>AlarmRequest</td> <td>AlarmResponse</td> <td>Alarm активує, деактивує та запитує тривоги щодо справності кластера.</td> </tr> <tr> <td>Status</td> <td>StatusRequest</td> <td>StatusResponse</td> <td>Status отримує статус учасника.</td> </tr> <tr> <td>Defragment</td> <td>DefragmentRequest</td> <td>DefragmentResponse</td> <td>Defragment дефрагментує бекенд бази даних учасника для відновлення місця для зберігання.</td> </tr> <tr> <td>Hash</td> <td>HashRequest</td> <td>HashResponse</td> <td>Hash обчислює хеш всього бекенду ключового простору, включаючи ключі, лізинги та інші сегменти в сховищі. Це призначено ТІЛЬКИ для тестування! Не покладайтеся на це у промисловій експлуатації з поточними транзакціями, оскільки операція Hash не утримує блокування MVCC. Використовуйте API &ldquo;HashKV&rdquo; замість цього для перевірки узгодженості сегмента &ldquo;ключ&rdquo;.</td> </tr> <tr> <td>HashKV</td> <td>HashKVRequest</td> <td>HashKVResponse</td> <td>HashKV обчислює хеш всіх ключів MVCC до вказаної ревізії. Він ітерує тільки сегмент &ldquo;ключ&rdquo; в бекенді сховища.</td> </tr> <tr> <td>Snapshot</td> <td>SnapshotRequest</td> <td>SnapshotResponse</td> <td>Snapshot надсилає знімок всього бекенду від учасника через потік до клієнта.</td> </tr> <tr> <td>MoveLeader</td> <td>MoveLeaderRequest</td> <td>MoveLeaderResponse</td> <td>MoveLeader запитує поточного лідера вузла передати своє лідерство іншому вузлу.</td> </tr> <tr> <td>Downgrade</td> <td>DowngradeRequest</td> <td>DowngradeResponse</td> <td>Downgrade запитує зниження, перевіряє можливість або скасовує зниження версії кластера. Підтримується з версії etcd 3.5.</td> </tr> </tbody> </table> <h5 id="service-watch-apietcdserverpbrpcproto">service <code>Watch</code> (api/etcdserverpb/rpc.proto)<a class="td-heading-self-link" href="#service-watch-apietcdserverpbrpcproto" aria-label="Heading self-link"></a></h5> <table> <thead> <tr> <th>Метод</th> <th>Тип запиту</th> <th>Тип відповіді</th> <th>Опис</th> </tr> </thead> <tbody> <tr> <td>Watch</td> <td>WatchRequest</td> <td>WatchResponse</td> <td>Watch спостерігає за подіями, що відбуваються або вже відбулися. Вхідний і вихідний потоки; вхідний потік створює і скасовує спостерігачів, а вихідний потік надсилає події. Один запит на спостереження може спостерігати за кількома діапазонами ключів, передаючи події для кількох спостережень одночасно. Вся історія подій може бути переглянута, починаючи з останньої ревізії стиснення.</td> </tr> </tbody> </table> <h5 id="message-alarmmember-apietcdserverpbrpcproto">message <code>AlarmMember</code> (api/etcdserverpb/rpc.proto)<a class="td-heading-self-link" href="#message-alarmmember-apietcdserverpbrpcproto" aria-label="Heading self-link"></a></h5> <table> <thead> <tr> <th>Поле</th> <th>Опис</th> <th>Тип</th> </tr> </thead> <tbody> <tr> <td>(versionpb.etcd_version_msg)</td> <td></td> <td>option</td> </tr> <tr> <td>memberID</td> <td>memberID - це ID учасника, повʼязаного з піднятою тривогою.</td> <td>uint64</td> </tr> <tr> <td>alarm</td> <td>alarm - це тип тривоги, яка була піднята.</td> <td>AlarmType</td> </tr> </tbody> </table> <h5 id="message-alarmrequest-apietcdserverpbrpcproto">message <code>AlarmRequest</code> (api/etcdserverpb/rpc.proto)<a class="td-heading-self-link" href="#message-alarmrequest-apietcdserverpbrpcproto" aria-label="Heading self-link"></a></h5> <table> <thead> <tr> <th>Поле</th> <th>Опис</th> <th>Тип</th> </tr> </thead> <tbody> <tr> <td>(versionpb.etcd_version_msg)</td> <td></td> <td>option</td> </tr> <tr> <td>action</td> <td>action - це тип запиту на тривогу. Дія може бути GET для отримання статусів тривог, ACTIVATE для активації тривоги або DEACTIVATE для деактивації піднятої тривоги.</td> <td>AlarmAction</td> </tr> <tr> <td>memberID</td> <td>memberID - це ID учасника, повʼязаного з тривогою. Якщо memberID дорівнює 0, запит на тривогу охоплює всіх учасників.</td> <td>uint64</td> </tr> <tr> <td>alarm</td> <td>alarm - це тип тривоги, яку слід розглянути для цього запиту.</td> <td>AlarmType</td> </tr> </tbody> </table> <h5 id="message-alarmresponse-apietcdserverpbrpcproto">message <code>AlarmResponse</code> (api/etcdserverpb/rpc.proto)<a class="td-heading-self-link" href="#message-alarmresponse-apietcdserverpbrpcproto" aria-label="Heading self-link"></a></h5> <table> <thead> <tr> <th>Поле</th> <th>Опис</th> <th>Тип</th> </tr> </thead> <tbody> <tr> <td>(versionpb.etcd_version_msg)</td> <td></td> <td>option</td> </tr> <tr> <td>header</td> <td></td> <td>ResponseHeader</td> </tr> <tr> <td>alarms</td> <td>alarms - це список тривог, повʼязаних із запитом на тривогу.</td> <td>(slice of) AlarmMember</td> </tr> </tbody> </table> <h5 id="message-authdisablerequest-apietcdserverpbrpcproto">message <code>AuthDisableRequest</code> (api/etcdserverpb/rpc.proto)<a class="td-heading-self-link" href="#message-authdisablerequest-apietcdserverpbrpcproto" aria-label="Heading self-link"></a></h5> <table> <thead> <tr> <th>Поле</th> <th>Опис</th> <th>Тип</th> </tr> </thead> <tbody> <tr> <td>(versionpb.etcd_version_msg)</td> <td></td> <td>option</td> </tr> </tbody> </table> <h5 id="message-authdisableresponse-apietcdserverpbrpcproto">message <code>AuthDisableResponse</code> (api/etcdserverpb/rpc.proto)<a class="td-heading-self-link" href="#message-authdisableresponse-apietcdserverpbrpcproto" aria-label="Heading self-link"></a></h5> <table> <thead> <tr> <th>Поле</th> <th>Опис</th> <th>Тип</th> </tr> </thead> <tbody> <tr> <td>(versionpb.etcd_version_msg)</td> <td></td> <td>option</td> </tr> <tr> <td>header</td> <td></td> <td>ResponseHeader</td> </tr> </tbody> </table> <h5 id="message-authenablerequest-apietcdserverpbrpcproto">message <code>AuthEnableRequest</code> (api/etcdserverpb/rpc.proto)<a class="td-heading-self-link" href="#message-authenablerequest-apietcdserverpbrpcproto" aria-label="Heading self-link"></a></h5> <table> <thead> <tr> <th>Поле</th> <th>Опис</th> <th>Тип</th> </tr> </thead> <tbody> <tr> <td>(versionpb.etcd_version_msg)</td> <td></td> <td>option</td> </tr> </tbody> </table> <h5 id="message-authenableresponse-apietcdserverpbrpcproto">message <code>AuthEnableResponse</code> (api/etcdserverpb/rpc.proto)<a class="td-heading-self-link" href="#message-authenableresponse-apietcdserverpbrpcproto" aria-label="Heading self-link"></a></h5> <table> <thead> <tr> <th>Поле</th> <th>Опис</th> <th>Тип</th> </tr> </thead> <tbody> <tr> <td>(versionpb.etcd_version_msg)</td> <td></td> <td>option</td> </tr> <tr> <td>header</td> <td></td> <td>ResponseHeader</td> </tr> </tbody> </table> <h5 id="message-authroleaddrequest-apietcdserverpbrpcproto">message <code>AuthRoleAddRequest</code> (api/etcdserverpb/rpc.proto)<a class="td-heading-self-link" href="#message-authroleaddrequest-apietcdserverpbrpcproto" aria-label="Heading self-link"></a></h5> <table> <thead> <tr> <th>Поле</th> <th>Опис</th> <th>Тип</th> </tr> </thead> <tbody> <tr> <td>(versionpb.etcd_version_msg)</td> <td></td> <td>option</td> </tr> <tr> <td>name</td> <td>name - це імʼя ролі, яку потрібно додати до системи автентифікації.</td> <td>string</td> </tr> </tbody> </table> <h5 id="message-authroleaddresponse-apietcdserverpbrpcproto">message <code>AuthRoleAddResponse</code> (api/etcdserverpb/rpc.proto)<a class="td-heading-self-link" href="#message-authroleaddresponse-apietcdserverpbrpcproto" aria-label="Heading self-link"></a></h5> <table> <thead> <tr> <th>Поле</th> <th>Опис</th> <th>Тип</th> </tr> </thead> <tbody> <tr> <td>(versionpb.etcd_version_msg)</td> <td></td> <td>option</td> </tr> <tr> <td>header</td> <td></td> <td>ResponseHeader</td> </tr> </tbody> </table> <h5 id="message-authroledeleterequest-apietcdserverpbrpcproto">message <code>AuthRoleDeleteRequest</code> (api/etcdserverpb/rpc.proto)<a class="td-heading-self-link" href="#message-authroledeleterequest-apietcdserverpbrpcproto" aria-label="Heading self-link"></a></h5> <table> <thead> <tr> <th>Поле</th> <th>Опис</th> <th>Тип</th> </tr> </thead> <tbody> <tr> <td>(versionpb.etcd_version_msg)</td> <td></td> <td>option</td> </tr> <tr> <td>role</td> <td></td> <td>string</td> </tr> </tbody> </table> <h5 id="message-authroledeleteresponse-apietcdserverpbrpcproto">message <code>AuthRoleDeleteResponse</code> (api/etcdserverpb/rpc.proto)<a class="td-heading-self-link" href="#message-authroledeleteresponse-apietcdserverpbrpcproto" aria-label="Heading self-link"></a></h5> <table> <thead> <tr> <th>Поле</th> <th>Опис</th> <th>Тип</th> </tr> </thead> <tbody> <tr> <td>(versionpb.etcd_version_msg)</td> <td></td> <td>option</td> </tr> <tr> <td>header</td> <td></td> <td>ResponseHeader</td> </tr> </tbody> </table> <h5 id="message-authrolegetrequest-apietcdserverpbrpcproto">message <code>AuthRoleGetRequest</code> (api/etcdserverpb/rpc.proto)<a class="td-heading-self-link" href="#message-authrolegetrequest-apietcdserverpbrpcproto" aria-label="Heading self-link"></a></h5> <table> <thead> <tr> <th>Поле</th> <th>Опис</th> <th>Тип</th> </tr> </thead> <tbody> <tr> <td>(versionpb.etcd_version_msg)</td> <td></td> <td>option</td> </tr> <tr> <td>role</td> <td></td> <td>string</td> </tr> </tbody> </table> <h5 id="message-authrolegetresponse-apietcdserverpbrpcproto">message <code>AuthRoleGetResponse</code> (api/etcdserverpb/rpc.proto)<a class="td-heading-self-link" href="#message-authrolegetresponse-apietcdserverpbrpcproto" aria-label="Heading self-link"></a></h5> <table> <thead> <tr> <th>Поле</th> <th>Опис</th> <th>Тип</th> </tr> </thead> <tbody> <tr> <td>header</td> <td></td> <td>ResponseHeader</td> </tr> <tr> <td>perm</td> <td></td> <td>(slice of) authpb.Permission</td> </tr> </tbody> </table> <h5 id="message-authrolegrantpermissionrequest-apietcdserverpbrpcproto">message <code>AuthRoleGrantPermissionRequest</code> (api/etcdserverpb/rpc.proto)<a class="td-heading-self-link" href="#message-authrolegrantpermissionrequest-apietcdserverpbrpcproto" aria-label="Heading self-link"></a></h5> <table> <thead> <tr> <th>Поле</th> <th>Опис</th> <th>Тип</th> </tr> </thead> <tbody> <tr> <td>(versionpb.etcd_version_msg)</td> <td></td> <td>option</td> </tr> <tr> <td>name</td> <td>name - це імʼя ролі, якій буде надано дозвіл.</td> <td>string</td> </tr> <tr> <td>perm</td> <td>perm - це дозвіл, який буде надано ролі.</td> <td>authpb.Permission</td> </tr> </tbody> </table> <h5 id="message-authrolegrantpermissionresponse-apietcdserverpbrpcproto">message <code>AuthRoleGrantPermissionResponse</code> (api/etcdserverpb/rpc.proto)<a class="td-heading-self-link" href="#message-authrolegrantpermissionresponse-apietcdserverpbrpcproto" aria-label="Heading self-link"></a></h5> <table> <thead> <tr> <th>Поле</th> <th>Опис</th> <th>Тип</th> </tr> </thead> <tbody> <tr> <td>(versionpb.etcd_version_msg)</td> <td></td> <td>option</td> </tr> <tr> <td>header</td> <td></td> <td>ResponseHeader</td> </tr> </tbody> </table> <h5 id="message-authrolelistrequest-apietcdserverpbrpcproto">message <code>AuthRoleListRequest</code> (api/etcdserverpb/rpc.proto)<a class="td-heading-self-link" href="#message-authrolelistrequest-apietcdserverpbrpcproto" aria-label="Heading self-link"></a></h5> <table> <thead> <tr> <th>Поле</th> <th>Опис</th> <th>Тип</th> </tr> </thead> <tbody> <tr> <td>(versionpb.etcd_version_msg)</td> <td></td> <td>option</td> </tr> </tbody> </table> <h5 id="message-authrolelistresponse-apietcdserverpbrpcproto">message <code>AuthRoleListResponse</code> (api/etcdserverpb/rpc.proto)<a class="td-heading-self-link" href="#message-authrolelistresponse-apietcdserverpbrpcproto" aria-label="Heading self-link"></a></h5> <table> <thead> <tr> <th>Поле</th> <th>Опис</th> <th>Тип</th> </tr> </thead> <tbody> <tr> <td>(versionpb.etcd_version_msg)</td> <td></td> <td>option</td> </tr> <tr> <td>header</td> <td></td> <td>ResponseHeader</td> </tr> <tr> <td>roles</td> <td></td> <td>(slice of) string</td> </tr> </tbody> </table> <h5 id="message-authrolerevokepermissionrequest-apietcdserverpbrpcproto">message <code>AuthRoleRevokePermissionRequest</code> (api/etcdserverpb/rpc.proto)<a class="td-heading-self-link" href="#message-authrolerevokepermissionrequest-apietcdserverpbrpcproto" aria-label="Heading self-link"></a></h5> <table> <thead> <tr> <th>Поле</th> <th>Опис</th> <th>Тип</th> </tr> </thead> <tbody> <tr> <td>(versionpb.etcd_version_msg)</td> <td></td> <td>option</td> </tr> <tr> <td>role</td> <td></td> <td>string</td> </tr> <tr> <td>key</td> <td></td> <td>bytes</td> </tr> <tr> <td>range_end</td> <td></td> <td>bytes</td> </tr> </tbody> </table> <h5 id="message-authrolerevokepermissionresponse-apietcdserverpbrpcproto">message <code>AuthRoleRevokePermissionResponse</code> (api/etcdserverpb/rpc.proto)<a class="td-heading-self-link" href="#message-authrolerevokepermissionresponse-apietcdserverpbrpcproto" aria-label="Heading self-link"></a></h5> <table> <thead> <tr> <th>Поле</th> <th>Опис</th> <th>Тип</th> </tr> </thead> <tbody> <tr> <td>(versionpb.etcd_version_msg)</td> <td></td> <td>option</td> </tr> <tr> <td>header</td> <td></td> <td>ResponseHeader</td> </tr> </tbody> </table> <h5 id="message-authstatusrequest-apietcdserverpbrpcproto">message <code>AuthStatusRequest</code> (api/etcdserverpb/rpc.proto)<a class="td-heading-self-link" href="#message-authstatusrequest-apietcdserverpbrpcproto" aria-label="Heading self-link"></a></h5> <table> <thead> <tr> <th>Поле</th> <th>Опис</th> <th>Тип</th> </tr> </thead> <tbody> <tr> <td>(versionpb.etcd_version_msg)</td> <td></td> <td>option</td> </tr> </tbody> </table> <h5 id="message-authstatusresponse-apietcdserverpbrpcproto">message <code>AuthStatusResponse</code> (api/etcdserverpb/rpc.proto)<a class="td-heading-self-link" href="#message-authstatusresponse-apietcdserverpbrpcproto" aria-label="Heading self-link"></a></h5> <table> <thead> <tr> <th>Поле</th> <th>Опис</th> <th>Тип</th> </tr> </thead> <tbody> <tr> <td>(versionpb.etcd_version_msg)</td> <td></td> <td>option</td> </tr> <tr> <td>header</td> <td></td> <td>ResponseHeader</td> </tr> <tr> <td>enabled</td> <td></td> <td>bool</td> </tr> <tr> <td>authRevision</td> <td>authRevision - це поточна ревізія сховища автентифікації</td> <td>uint64</td> </tr> </tbody> </table> <h5 id="message-authuseraddrequest-apietcdserverpbrpcproto">message <code>AuthUserAddRequest</code> (api/etcdserverpb/rpc.proto)<a class="td-heading-self-link" href="#message-authuseraddrequest-apietcdserverpbrpcproto" aria-label="Heading self-link"></a></h5> <table> <thead> <tr> <th>Поле</th> <th>Опис</th> <th>Тип</th> </tr> </thead> <tbody> <tr> <td>(versionpb.etcd_version_msg)</td> <td></td> <td>option</td> </tr> <tr> <td>name</td> <td></td> <td>string</td> </tr> <tr> <td>password</td> <td></td> <td>string</td> </tr> <tr> <td>options</td> <td></td> <td>authpb.UserAddOptions</td> </tr> <tr> <td>hashedPassword</td> <td></td> <td>string</td> </tr> </tbody> </table> <h5 id="message-authuseraddresponse-apietcdserverpbrpcproto">message <code>AuthUserAddResponse</code> (api/etcdserverpb/rpc.proto)<a class="td-heading-self-link" href="#message-authuseraddresponse-apietcdserverpbrpcproto" aria-label="Heading self-link"></a></h5> <table> <thead> <tr> <th>Поле</th> <th>Опис</th> <th>Тип</th> </tr> </thead> <tbody> <tr> <td>(versionpb.etcd_version_msg)</td> <td></td> <td>option</td> </tr> <tr> <td>header</td> <td></td> <td>ResponseHeader</td> </tr> </tbody> </table> <h5 id="message-authuserchangepasswordrequest-apietcdserverpbrpcproto">message <code>AuthUserChangePasswordRequest</code> (api/etcdserverpb/rpc.proto)<a class="td-heading-self-link" href="#message-authuserchangepasswordrequest-apietcdserverpbrpcproto" aria-label="Heading self-link"></a></h5> <table> <thead> <tr> <th>Поле</th> <th>Опис</th> <th>Тип</th> </tr> </thead> <tbody> <tr> <td>(versionpb.etcd_version_msg)</td> <td></td> <td>option</td> </tr> <tr> <td>name</td> <td>name - це імʼя користувача, пароль якого змінюється.</td> <td>string</td> </tr> <tr> <td>password</td> <td>password - це новий пароль для користувача. Зверніть увагу, що це поле буде видалено на рівні API.</td> <td>string</td> </tr> <tr> <td>hashedPassword</td> <td>hashedPassword - це новий пароль для користувача. Зверніть увагу, що це поле буде ініціалізовано на рівні API.</td> <td>string</td> </tr> </tbody> </table> <h5 id="message-authuserchangepasswordresponse-apietcdserverpbrpcproto">message <code>AuthUserChangePasswordResponse</code> (api/etcdserverpb/rpc.proto)<a class="td-heading-self-link" href="#message-authuserchangepasswordresponse-apietcdserverpbrpcproto" aria-label="Heading self-link"></a></h5> <table> <thead> <tr> <th>Поле</th> <th>Опис</th> <th>Тип</th> </tr> </thead> <tbody> <tr> <td>(versionpb.etcd_version_msg)</td> <td></td> <td>option</td> </tr> <tr> <td>header</td> <td></td> <td>ResponseHeader</td> </tr> </tbody> </table> <h5 id="message-authuserdeleterequest-apietcdserverpbrpcproto">message <code>AuthUserDeleteRequest</code> (api/etcdserverpb/rpc.proto)<a class="td-heading-self-link" href="#message-authuserdeleterequest-apietcdserverpbrpcproto" aria-label="Heading self-link"></a></h5> <table> <thead> <tr> <th>Поле</th> <th>Опис</th> <th>Тип</th> </tr> </thead> <tbody> <tr> <td>(versionpb.etcd_version_msg)</td> <td></td> <td>option</td> </tr> <tr> <td>name</td> <td>name - це імʼя користувача, якого потрібно видалити.</td> <td>string</td> </tr> </tbody> </table> <h5 id="message-authuserdeleteresponse-apietcdserverpbrpcproto">message <code>AuthUserDeleteResponse</code> (api/etcdserverpb/rpc.proto)<a class="td-heading-self-link" href="#message-authuserdeleteresponse-apietcdserverpbrpcproto" aria-label="Heading self-link"></a></h5> <table> <thead> <tr> <th>Поле</th> <th>Опис</th> <th>Тип</th> </tr> </thead> <tbody> <tr> <td>(versionpb.etcd_version_msg)</td> <td></td> <td>option</td> </tr> <tr> <td>header</td> <td></td> <td>ResponseHeader</td> </tr> </tbody> </table> <h5 id="message-authusergetrequest-apietcdserverpbrpcproto">message <code>AuthUserGetRequest</code> (api/etcdserverpb/rpc.proto)<a class="td-heading-self-link" href="#message-authusergetrequest-apietcdserverpbrpcproto" aria-label="Heading self-link"></a></h5> <table> <thead> <tr> <th>Поле</th> <th>Опис</th> <th>Тип</th> </tr> </thead> <tbody> <tr> <td>(versionpb.etcd_version_msg)</td> <td></td> <td>option</td> </tr> <tr> <td>name</td> <td></td> <td>string</td> </tr> </tbody> </table> <h5 id="message-authusergetresponse-apietcdserverpbrpcproto">message <code>AuthUserGetResponse</code> (api/etcdserverpb/rpc.proto)<a class="td-heading-self-link" href="#message-authusergetresponse-apietcdserverpbrpcproto" aria-label="Heading self-link"></a></h5> <table> <thead> <tr> <th>Поле</th> <th>Опис</th> <th>Тип</th> </tr> </thead> <tbody> <tr> <td>(versionpb.etcd_version_msg)</td> <td></td> <td>option</td> </tr> <tr> <td>header</td> <td></td> <td>ResponseHeader</td> </tr> <tr> <td>roles</td> <td></td> <td>(slice of) string</td> </tr> </tbody> </table> <h5 id="message-authusergrantrolerequest-apietcdserverpbrpcproto">message <code>AuthUserGrantRoleRequest</code> (api/etcdserverpb/rpc.proto)<a class="td-heading-self-link" href="#message-authusergrantrolerequest-apietcdserverpbrpcproto" aria-label="Heading self-link"></a></h5> <table> <thead> <tr> <th>Поле</th> <th>Опис</th> <th>Тип</th> </tr> </thead> <tbody> <tr> <td>(versionpb.etcd_version_msg)</td> <td></td> <td>option</td> </tr> <tr> <td>user</td> <td>user - це імʼя користувача, якому слід надати вказану роль.</td> <td>string</td> </tr> <tr> <td>role</td> <td>role - це імʼя ролі, яку слід надати користувачу.</td> <td>string</td> </tr> </tbody> </table> <h5 id="message-authusergrantroleresponse-apietcdserverpbrpcproto">message <code>AuthUserGrantRoleResponse</code> (api/etcdserverpb/rpc.proto)<a class="td-heading-self-link" href="#message-authusergrantroleresponse-apietcdserverpbrpcproto" aria-label="Heading self-link"></a></h5> <table> <thead> <tr> <th>Поле</th> <th>Опис</th> <th>Тип</th> </tr> </thead> <tbody> <tr> <td>(versionpb.etcd_version_msg)</td> <td></td> <td>option</td> </tr> <tr> <td>header</td> <td></td> <td>ResponseHeader</td> </tr> </tbody> </table> <h5 id="message-authuserlistrequest-apietcdserverpbrpcproto">message <code>AuthUserListRequest</code> (api/etcdserverpb/rpc.proto)<a class="td-heading-self-link" href="#message-authuserlistrequest-apietcdserverpbrpcproto" aria-label="Heading self-link"></a></h5> <table> <thead> <tr> <th>Поле</th> <th>Опис</th> <th>Тип</th> </tr> </thead> <tbody> <tr> <td>(versionpb.etcd_version_msg)</td> <td></td> <td>option</td> </tr> </tbody> </table> <h5 id="message-authuserlistresponse-apietcdserverpbrpcproto">message <code>AuthUserListResponse</code> (api/etcdserverpb/rpc.proto)<a class="td-heading-self-link" href="#message-authuserlistresponse-apietcdserverpbrpcproto" aria-label="Heading self-link"></a></h5> <table> <thead> <tr> <th>Поле</th> <th>Опис</th> <th>Тип</th> </tr> </thead> <tbody> <tr> <td>(versionpb.etcd_version_msg)</td> <td></td> <td>option</td> </tr> <tr> <td>header</td> <td></td> <td>ResponseHeader</td> </tr> <tr> <td>users</td> <td></td> <td>(slice of) string</td> </tr> </tbody> </table> <h5 id="message-authuserrevokerolerequest-apietcdserverpbrpcproto">message <code>AuthUserRevokeRoleRequest</code> (api/etcdserverpb/rpc.proto)<a class="td-heading-self-link" href="#message-authuserrevokerolerequest-apietcdserverpbrpcproto" aria-label="Heading self-link"></a></h5> <table> <thead> <tr> <th>Поле</th> <th>Опис</th> <th>Тип</th> </tr> </thead> <tbody> <tr> <td>(versionpb.etcd_version_msg)</td> <td></td> <td>option</td> </tr> <tr> <td>name</td> <td></td> <td>string</td> </tr> <tr> <td>role</td> <td></td> <td>string</td> </tr> </tbody> </table> <h5 id="message-authuserrevokeroleresponse-apietcdserverpbrpcproto">message <code>AuthUserRevokeRoleResponse</code> (api/etcdserverpb/rpc.proto)<a class="td-heading-self-link" href="#message-authuserrevokeroleresponse-apietcdserverpbrpcproto" aria-label="Heading self-link"></a></h5> <table> <thead> <tr> <th>Поле</th> <th>Опис</th> <th>Тип</th> </tr> </thead> <tbody> <tr> <td>(versionpb.etcd_version_msg)</td> <td></td> <td>option</td> </tr> <tr> <td>header</td> <td></td> <td>ResponseHeader</td> </tr> </tbody> </table> <h5 id="message-authenticaterequest-apietcdserverpbrpcproto">message <code>AuthenticateRequest</code> (api/etcdserverpb/rpc.proto)<a class="td-heading-self-link" href="#message-authenticaterequest-apietcdserverpbrpcproto" aria-label="Heading self-link"></a></h5> <table> <thead> <tr> <th>Поле</th> <th>Опис</th> <th>Тип</th> </tr> </thead> <tbody> <tr> <td>(versionpb.etcd_version_msg)</td> <td></td> <td>option</td> </tr> <tr> <td>name</td> <td></td> <td>string</td> </tr> <tr> <td>password</td> <td></td> <td>string</td> </tr> </tbody> </table> <h5 id="message-authenticateresponse-apietcdserverpbrpcproto">message <code>AuthenticateResponse</code> (api/etcdserverpb/rpc.proto)<a class="td-heading-self-link" href="#message-authenticateresponse-apietcdserverpbrpcproto" aria-label="Heading self-link"></a></h5> <table> <thead> <tr> <th>Поле</th> <th>Опис</th> <th>Тип</th> </tr> </thead> <tbody> <tr> <td>(versionpb.etcd_version_msg)</td> <td></td> <td>option</td> </tr> <tr> <td>header</td> <td></td> <td>ResponseHeader</td> </tr> <tr> <td>token</td> <td>token - це авторизований токен, який можна використовувати в наступних RPC</td> <td>string</td> </tr> </tbody> </table> <h5 id="message-compactionrequest-apietcdserverpbrpcproto">message <code>CompactionRequest</code> (api/etcdserverpb/rpc.proto)<a class="td-heading-self-link" href="#message-compactionrequest-apietcdserverpbrpcproto" aria-label="Heading self-link"></a></h5> <p>CompactionRequest стискає сховище ключ-значення до вказаної ревізії. Всі замінені ключі з ревізією менше ревізії стиснення будуть видалені.</p>https://andygol-etcd.netlify.app/uk/docs/v3.6/dev-guide/api_concurrency_reference_v3/Mon, 01 Jan 0001 00:00:00 +0000https://andygol-etcd.netlify.app/uk/docs/v3.6/dev-guide/api_concurrency_reference_v3/<p>Ця довідка API автоматично згенерована з вказаних файлів <code>.proto</code>.</p> <h5 id="service-lock-serveretcdserverapiv3lockv3lockpbv3lockproto">service <code>Lock</code> (server/etcdserver/api/v3lock/v3lockpb/v3lock.proto)<a class="td-heading-self-link" href="#service-lock-serveretcdserverapiv3lockv3lockpbv3lockproto" aria-label="Heading self-link"></a></h5> <p>Сервіс блокування надає клієнтські засоби блокування як інтерфейс gRPC.</p> <table> <thead> <tr> <th>Метод</th> <th>Тип запиту</th> <th>Тип відповіді</th> <th>Опис</th> </tr> </thead> <tbody> <tr> <td>Lock</td> <td>LockRequest</td> <td>LockResponse</td> <td>Lock отримує розподілений спільний блок на вказаному іменованому блоці. У разі успіху, він поверне унікальний ключ, який існує, поки блок утримується викликачем. Цей ключ можна використовувати разом з транзакціями, щоб безпечно забезпечити оновлення до etcd лише під час утримання блоку. Блок утримується до виклику Unlock на ключі або до закінчення терміну дії оренди, повʼязаної з власником.</td> </tr> <tr> <td>Unlock</td> <td>UnlockRequest</td> <td>UnlockResponse</td> <td>Unlock приймає ключ, повернутий Lock, і звільняє утримання блоку. Наступний викликач Lock, який чекає на блок, буде розбуджений і отримає право власності на блок.</td> </tr> </tbody> </table> <h5 id="message-lockrequest-serveretcdserverapiv3lockv3lockpbv3lockproto">message <code>LockRequest</code> (server/etcdserver/api/v3lock/v3lockpb/v3lock.proto)<a class="td-heading-self-link" href="#message-lockrequest-serveretcdserverapiv3lockv3lockpbv3lockproto" aria-label="Heading self-link"></a></h5> <table> <thead> <tr> <th>Поле</th> <th>Опис</th> <th>Тип</th> </tr> </thead> <tbody> <tr> <td>name</td> <td>name є ідентифікатором для розподіленого спільного блоку, який потрібно отримати.</td> <td>bytes</td> </tr> <tr> <td>lease</td> <td>lease є ID оренди, яка буде прикріплена до права власності на блок. Якщо оренда закінчується або відкликається і наразі утримує блок, блок автоматично звільняється. Виклики до Lock з тією ж орендою будуть розглядатися як одне отримання; блокування двічі з тією ж орендою є бездіяльністю.</td> <td>int64</td> </tr> </tbody> </table> <h5 id="message-lockresponse-serveretcdserverapiv3lockv3lockpbv3lockproto">message <code>LockResponse</code> (server/etcdserver/api/v3lock/v3lockpb/v3lock.proto)<a class="td-heading-self-link" href="#message-lockresponse-serveretcdserverapiv3lockv3lockpbv3lockproto" aria-label="Heading self-link"></a></h5> <table> <thead> <tr> <th>Поле</th> <th>Опис</th> <th>Тип</th> </tr> </thead> <tbody> <tr> <td>header</td> <td></td> <td>etcdserverpb.ResponseHeader</td> </tr> <tr> <td>key</td> <td>key є ключем, який існуватиме в etcd протягом часу, коли викликач Lock утримує блок. Користувачі не повинні змінювати цей ключ, інакше блок може проявляти невизначену поведінку.</td> <td>bytes</td> </tr> </tbody> </table> <h5 id="message-unlockrequest-serveretcdserverapiv3lockv3lockpbv3lockproto">message <code>UnlockRequest</code> (server/etcdserver/api/v3lock/v3lockpb/v3lock.proto)<a class="td-heading-self-link" href="#message-unlockrequest-serveretcdserverapiv3lockv3lockpbv3lockproto" aria-label="Heading self-link"></a></h5> <table> <thead> <tr> <th>Поле</th> <th>Опис</th> <th>Тип</th> </tr> </thead> <tbody> <tr> <td>key</td> <td>key є ключем права власності на блок, наданим Lock.</td> <td>bytes</td> </tr> </tbody> </table> <h5 id="message-unlockresponse-serveretcdserverapiv3lockv3lockpbv3lockproto">message <code>UnlockResponse</code> (server/etcdserver/api/v3lock/v3lockpb/v3lock.proto)<a class="td-heading-self-link" href="#message-unlockresponse-serveretcdserverapiv3lockv3lockpbv3lockproto" aria-label="Heading self-link"></a></h5> <table> <thead> <tr> <th>Поле</th> <th>Опис</th> <th>Тип</th> </tr> </thead> <tbody> <tr> <td>header</td> <td></td> <td>etcdserverpb.ResponseHeader</td> </tr> </tbody> </table> <h5 id="service-election-serveretcdserverapiv3electionv3electionpbv3electionproto">service <code>Election</code> (server/etcdserver/api/v3election/v3electionpb/v3election.proto)<a class="td-heading-self-link" href="#service-election-serveretcdserverapiv3electionv3electionpbv3electionproto" aria-label="Heading self-link"></a></h5> <p>Сервіс виборів надає клієнтські засоби виборів як інтерфейс gRPC.</p>