sdk

package
v1.62.336 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: May 22, 2023 License: Apache-2.0 Imports: 26 Imported by: 1,036

Documentation

Index

Constants

This section is empty.

Variables

View Source 
var DefaultUserAgent = fmt.Sprintf("AlibabaCloud (%s; %s) Golang/%s Core/%s", runtime.GOOS, runtime.GOARCH, strings.Trim(runtime.Version(), "go"), Version)
View Source 
var Version = "0.0.1"

Version this value will be replaced while build: -ldflags="-X sdk.version=x.x.x"

Functions

func Timeout 

func Timeout(connectTimeout time.Duration) func(cxt context.Context, net, addr string) (c net.Conn, err error)

func TransToString 

func TransToString(object interface{}) string

Types

type Client 

type Client struct {
	SourceIp        string
	SecureTransport string

	EndpointMap  map[string]string
	EndpointType string
	Network      string
	Domain       string
	// contains filtered or unexported fields
}

Client the type Client

func NewClient 

func NewClient() (client *Client, err error)

func NewClientWithAccessKey 

func NewClientWithAccessKey(regionId, accessKeyId, accessKeySecret string) (client *Client, err error)

func NewClientWithBearerToken 

func NewClientWithBearerToken(regionId, bearerToken string) (client *Client, err error)

func NewClientWithEcsRamRole 

func NewClientWithEcsRamRole(regionId string, roleName string) (client *Client, err error)

func NewClientWithOptions 

func NewClientWithOptions(regionId string, config *Config, credential auth.Credential) (client *Client, err error)

func NewClientWithProvider 

func NewClientWithProvider(regionId string, providers ...provider.Provider) (client *Client, err error)

func NewClientWithRamRoleArn 

func NewClientWithRamRoleArn(regionId string, accessKeyId, accessKeySecret, roleArn, roleSessionName string) (client *Client, err error)

func NewClientWithRamRoleArnAndPolicy 

func NewClientWithRamRoleArnAndPolicy(regionId string, accessKeyId, accessKeySecret, roleArn, roleSessionName, policy string) (client *Client, err error)

func NewClientWithRsaKeyPair 

func NewClientWithRsaKeyPair(regionId string, publicKeyId, privateKey string, sessionExpiration int) (client *Client, err error)

func NewClientWithStsRoleArn deprecated 

func NewClientWithStsRoleArn(regionId string, accessKeyId, accessKeySecret, roleArn, roleSessionName string) (client *Client, err error)

Deprecated: Use NewClientWithRamRoleArn in this package instead.

func NewClientWithStsRoleNameOnEcs deprecated 

func NewClientWithStsRoleNameOnEcs(regionId string, roleName string) (client *Client, err error)

Deprecated: Use NewClientWithEcsRamRole in this package instead.

func NewClientWithStsToken 

func NewClientWithStsToken(regionId, stsAccessKeyId, stsAccessKeySecret, stsToken string) (client *Client, err error)

func (*Client) AddAsyncTask 

func (client *Client) AddAsyncTask(task func()) (err error)

* only block when any one of the following occurs: 1. the asyncTaskQueue is full, increase the queue size to avoid this 2. Shutdown() in progressing, the client is being closed *

func (*Client) AppendUserAgent 

func (client *Client) AppendUserAgent(key, value string)

func (*Client) BuildRequestWithSigner 

func (client *Client) BuildRequestWithSigner(request requests.AcsRequest, signer auth.Signer) (err error)

func (*Client) CloseLogger 

func (client *Client) CloseLogger()

func (*Client) DoAction 

func (client *Client) DoAction(request requests.AcsRequest, response responses.AcsResponse) (err error)

func (*Client) DoActionWithSigner 

func (client *Client) DoActionWithSigner(request requests.AcsRequest, response responses.AcsResponse, signer auth.Signer) (err error)

func (*Client) EnableAsync 

func (client *Client) EnableAsync(routinePoolSize, maxTaskQueueSize int)

EnableAsync enable the async task queue

func (*Client) GetCloseTrace added in v1.62.0 

func (client *Client) GetCloseTrace() bool

func (*Client) GetConfig 

func (client *Client) GetConfig() *Config

func (*Client) GetConnectTimeout 

func (client *Client) GetConnectTimeout() time.Duration

func (*Client) GetEndpointRules 

func (client *Client) GetEndpointRules(regionId string, product string) (endpointRaw string, err error)

func (*Client) GetHTTPSInsecure 

func (client *Client) GetHTTPSInsecure() bool

func (*Client) GetHttpProxy 

func (client *Client) GetHttpProxy() string

func (*Client) GetHttpsProxy 

func (client *Client) GetHttpsProxy() string

func (*Client) GetLogger 

func (client *Client) GetLogger() *Logger

func (*Client) GetLoggerMsg 

func (client *Client) GetLoggerMsg() string

func (*Client) GetNoProxy 

func (client *Client) GetNoProxy() string

func (*Client) GetReadTimeout 

func (client *Client) GetReadTimeout() time.Duration

func (*Client) GetSigner added in v1.61.57 

func (client *Client) GetSigner() auth.Signer

func (*Client) GetTemplate 

func (client *Client) GetTemplate() string

func (*Client) GetTracerRootSpan added in v1.62.0 

func (client *Client) GetTracerRootSpan() opentracing.Span

func (*Client) Init 

func (client *Client) Init() (err error)

func (*Client) InitClientConfig 

func (client *Client) InitClientConfig() (config *Config)

func (*Client) InitWithAccessKey 

func (client *Client) InitWithAccessKey(regionId, accessKeyId, accessKeySecret string) (err error)

func (*Client) InitWithBearerToken 

func (client *Client) InitWithBearerToken(regionId, bearerToken string) (err error)

func (*Client) InitWithEcsRamRole 

func (client *Client) InitWithEcsRamRole(regionId, roleName string) (err error)

func (*Client) InitWithOptions 

func (client *Client) InitWithOptions(regionId string, config *Config, credential auth.Credential) (err error)

func (*Client) InitWithProviderChain 

func (client *Client) InitWithProviderChain(regionId string, provider provider.Provider) (err error)

InitWithProviderChain will get credential from the providerChain, the RsaKeyPairCredential Only applicable to regionID `ap-northeast-1`, if your providerChain may return a credential type with RsaKeyPairCredential, please ensure your regionID is `ap-northeast-1`.

func (*Client) InitWithRamRoleArn 

func (client *Client) InitWithRamRoleArn(regionId, accessKeyId, accessKeySecret, roleArn, roleSessionName string) (err error)

func (*Client) InitWithRamRoleArnAndPolicy 

func (client *Client) InitWithRamRoleArnAndPolicy(regionId, accessKeyId, accessKeySecret, roleArn, roleSessionName, policy string) (err error)

func (*Client) InitWithRsaKeyPair 

func (client *Client) InitWithRsaKeyPair(regionId, publicKeyId, privateKey string, sessionExpiration int) (err error)

func (*Client) InitWithStsToken 

func (client *Client) InitWithStsToken(regionId, accessKeyId, accessKeySecret, securityToken string) (err error)

func (*Client) OpenLogger 

func (client *Client) OpenLogger()

func (*Client) ProcessCommonRequest 

func (client *Client) ProcessCommonRequest(request *requests.CommonRequest) (response *responses.CommonResponse, err error)

func (*Client) ProcessCommonRequestWithSigner 

func (client *Client) ProcessCommonRequestWithSigner(request *requests.CommonRequest, signerInterface interface{}) (response *responses.CommonResponse, err error)

func (*Client) SetCloseTrace added in v1.62.0 

func (client *Client) SetCloseTrace(isCloseTrace bool)

func (*Client) SetConnectTimeout 

func (client *Client) SetConnectTimeout(connectTimeout time.Duration)

func (*Client) SetEndpointRules 

func (client *Client) SetEndpointRules(endpointMap map[string]string, endpointType string, netWork string)

func (*Client) SetHTTPSInsecure 

func (client *Client) SetHTTPSInsecure(isInsecure bool)

func (*Client) SetHttpProxy 

func (client *Client) SetHttpProxy(httpProxy string)

func (*Client) SetHttpsProxy 

func (client *Client) SetHttpsProxy(httpsProxy string)

func (*Client) SetLogger 

func (client *Client) SetLogger(level string, channel string, out io.Writer, template string)

func (*Client) SetNoProxy 

func (client *Client) SetNoProxy(noProxy string)

func (*Client) SetReadTimeout 

func (client *Client) SetReadTimeout(readTimeout time.Duration)

func (*Client) SetSigner added in v1.61.57 

func (client *Client) SetSigner(signer auth.Signer)

func (*Client) SetTemplate 

func (client *Client) SetTemplate(template string)

func (*Client) SetTracerRootSpan added in v1.62.0 

func (client *Client) SetTracerRootSpan(rootSpan opentracing.Span)

func (*Client) SetTransport added in v1.60.349 

func (client *Client) SetTransport(transport http.RoundTripper)

func (*Client) Shutdown 

func (client *Client) Shutdown()

type Config 

type Config struct {
	AutoRetry         bool              `default:"false"`
	MaxRetryTime      int               `default:"3"`
	UserAgent         string            `default:""`
	Debug             bool              `default:"false"`
	HttpTransport     *http.Transport   `default:""`
	Transport         http.RoundTripper `default:""`
	EnableAsync       bool              `default:"false"`
	MaxTaskQueueSize  int               `default:"1000"`
	GoRoutinePoolSize int               `default:"5"`
	Scheme            string            `default:"HTTP"`
	Timeout           time.Duration
}

func NewConfig 

func NewConfig() (config *Config)

func (*Config) WithAutoRetry 

func (c *Config) WithAutoRetry(isAutoRetry bool) *Config

func (*Config) WithDebug 

func (c *Config) WithDebug(isDebug bool) *Config

func (*Config) WithEnableAsync 

func (c *Config) WithEnableAsync(isEnableAsync bool) *Config

func (*Config) WithGoRoutinePoolSize 

func (c *Config) WithGoRoutinePoolSize(goRoutinePoolSize int) *Config

func (*Config) WithHttpTransport 

func (c *Config) WithHttpTransport(httpTransport *http.Transport) *Config

func (*Config) WithMaxRetryTime 

func (c *Config) WithMaxRetryTime(maxRetryTime int) *Config

func (*Config) WithMaxTaskQueueSize 

func (c *Config) WithMaxTaskQueueSize(maxTaskQueueSize int) *Config

func (*Config) WithScheme 

func (c *Config) WithScheme(scheme string) *Config

func (*Config) WithTimeout 

func (c *Config) WithTimeout(timeout time.Duration) *Config

func (*Config) WithUserAgent 

func (c *Config) WithUserAgent(userAgent string) *Config

type Logger 

type Logger struct {
	*log.Logger
	// contains filtered or unexported fields
}

Source Files

View all Source files

Directories

Path Synopsis
credentials
credentials/provider
credentials/providers
Package providers Deprecated
 Package providers Deprecated
signers
* Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License.
 * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.