Revert "sync upstream"

This reverts commit 8038568.

Author: Islam Alibekov

AUTHORS

@@ -1,32 +1,11 @@
-The following authors have created the source code of "Yandex.Cloud API" published and distributed by YANDEX LLC as the owner:
+The following authors have created the source code of "Yandex.Cloud Go SDK" published and distributed by YANDEX LLC as the owner:
 
-Alexander Burmak <alex-burmak@yandex-team.ru>
-Alexander Kirakozov <akirakozov@yandex-team.ru>
-Alexander Klyuev <wizard@yandex-team.ru>
-Alexander Serkov <alxn1@yandex-team.ru>
 Alexey Baranov <baranovich@yandex-team.ru>
-Alexey Zamulla <zamulla@yandex-team.ru>
-Alexey Zasimov <zasimov-a@yandex-team.ru>
-Amy Krishnevsky <krishnevsky@yandex-team.ru>
-Anastasia Karavaeva <dottir@yandex-team.ru>
-Andrey Polyakov <koshachy@yandex-team.ru>
-Damir Makhmutov <yesworld@yandex-team.ru>
-Danila Diugurov <terry@yandex-team.ru>
-David Lanchava <landavid@yandex-team.ru>
-Elena Ilycheva <eilycheva@yandex-team.ru>
-Evgeny Arhipov <arhipov@yandex-team.ru>
+Andrey Kraynov <iceman@yandex-team.ru>
+Dmitry Novikov <novikoff@yandex-team.ru>
+Gennady Lipenkov <xgen@yandex-team.ru>
 Luba Grinkevich <luba239@yandex-team.ru>
 Maxim Kolganov <manykey@yandex-team.ru>
-Mikhail Goncharov <migelle@yandex-team.ru>
-Nikolay Amelichev <entropia@yandex-team.ru>
-Pavel Fomin <vaccarium@yandex-team.ru>
 Rurik Krylov <rurikk@yandex-team.ru>
-Evgeny Dyukov <secwall@yandex-team.ru>
-Sergey Kanunnikov <skanunnikov@yandex-team.ru>
-Sergey Kiselev <intr13@yandex-team.ru>
-Sergey Sytnik <ssytnik@yandex-team.ru>
-Stanislav Ievlev <sievlev@yandex-team.ru>
 Vasilii Briginets <0x40@yandex-team.ru>
-Vlad Arkhipov <potamus@yandex-team.ru>
-Vladimir Borodin <d0uble@yandex-team.ru>
 Vladimir Skipor <skipor@yandex-team.ru>

README.md

@@ -1,15 +1,68 @@
-# Yandex Cloud API
+# Yandex.Cloud Go SDK
 
-This repository contains the interface definitions of Yandex Cloud API. 
+[![GoDoc](https://godoc.org/github.com/yandex-cloud/go-sdk?status.svg)](https://godoc.org/github.com/yandex-cloud/go-sdk)
+[![CircleCI](https://circleci.com/gh/yandex-cloud/go-sdk.svg?style=shield)](https://circleci.com/gh/yandex-cloud/go-sdk)
 
-For more details see [documentation](https://yandex.cloud/docs).
+Go SDK for Yandex.Cloud services.
 
-## Overview
+**NOTE:** SDK is under development, and may make
+backwards-incompatible changes.
 
-You can access Yandex Cloud by using REST or gRPC API.
+## Installation
 
-Yandex Cloud API uses Protocol Buffers to define API interfaces and data structures. These definitions are used for both REST and GRPC versions of the Yandex Cloud API. 
+```bash
+go get github.com/yandex-cloud/go-sdk
+```
 
-## Repository structure
+## Example usages
 
-Repository structure reflects Yandex Cloud service hierarchy. Folders represent different services of the platform and contain protobuf files. Each service folder contains resource data structure and interface definitions for API calls. 
+### Initializing SDK
+
+```go
+sdk, err := ycsdk.Build(ctx, ycsdk.Config{
+	Credentials: ycsdk.OAuthToken(token),
+})
+if err != nil {
+	log.Fatal(err)
+}
+```
+
+### Retries
+
+SDK provide built-in retry policy, that supports [exponential backoff and jitter](https://aws.amazon.com/ru/blogs/architecture/exponential-backoff-and-jitter/), and also [retry budget](https://github.com/grpc/proposal/blob/master/A6-client-retries.md#throttling-retry-attempts-and-hedged-rpcs). 
+It's necessary to avoid retry amplification.
+
+```go
+import (
+	...
+	ycsdk "github.com/yandex-cloud/go-sdk"
+	"github.com/yandex-cloud/go-sdk/pkg/retry/v1"
+)
+
+...
+
+retriesDialOption, err := retry.DefaultRetryDialOption()
+if err != nil {
+	log.Fatal(err)
+}
+
+_, err = ycsdk.Build(
+	ctx,
+	ycsdk.Config{
+		Credentials: ycsdk.OAuthToken(*token),
+	},
+	retriesDialOption,
+)
+```
+
+SDK provide different modes for retry throttling policy:
+
+* `persistent` is suitable when you use SDK in any long-lived application, when SDK instance will live long enough for manage budget;
+* `temporary` is suitable when you use SDK in any short-lived application, e.g. scripts or CI/CD.
+
+By default, SDK will use temporary mode, but you can change it through functional option.
+
+
+### More examples
+
+More examples can be found in [examples dir](examples).