sync upstream

Author: yandex-cloud-bot

README.md

@@ -27,6 +27,64 @@ if err != nil {
 }
 ```
 
+### Retries
+
+If you want to add retries to SDK, provide configuration using `retry/v1` package:
+
+```go
+import (
+	...
+
+	ycsdk "bb.yandex-team.ru/cloud/cloud-go/sdk"
+	"bb.yandex-team.ru/cloud/cloud-go/sdk/pkg/retry/v1"
+)
+
+...
+
+retriesDialOption, err := retry.RetryDialOption(
+	retry.WithRetries(retry.DefaultNameConfig(), 2),
+	retry.WithRetryableStatusCodes(retry.DefaultNameConfig(), codes.AlreadyExists, codes.Unavailable),
+)
+if err != nil {
+	log.Fatal(err)
+}
+
+_, err = ycsdk.Build(
+	ctx,
+	ycsdk.Config{
+		Credentials: ycsdk.OAuthToken(*token),
+	},
+	retriesDialOption,
+)
+```
+
+It's **strongly recommended** to use provided default configuration to avoid retry amplification:
+
+```go
+import (
+	...
+
+	ycsdk "bb.yandex-team.ru/cloud/cloud-go/sdk"
+	"bb.yandex-team.ru/cloud/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,
+)
+```
+
+
 ### More examples
 
 More examples can be found in [examples dir](examples).