Java

阿里云Java SDK（V1.0）

1. 通過Maven的方式在項目中引入RAM憑據插件。

   <dependency>
      <groupId>com.aliyun</groupId>
      <artifactId>aliyun-java-sdk-core</artifactId>
      <version>[4.3.2,5.0.0)</version>
   </dependency>
   <dependency>
     <groupId>com.aliyun</groupId>
     <artifactId>aliyun-java-sdk-core-managed-credentials-provider</artifactId>
     <version>[1.3.1,)</version>
   </dependency>

   說明

   建議您安裝最新版本的插件，更多信息，請參見原始代碼。

2. 獲得阿里云Java SDK客戶端并調用云服務。

   以調用ECS DescribeInstanceStatus為例：

   運行以下示例代碼時，請自行在pom.xml中添加云服務器aliyun-java-sdk-ecs依賴。

   import com.aliyuncs.IAcsClient;
   import com.aliyuncs.ecs.model.v20140526.DescribeInstanceStatusRequest;
   import com.aliyuncs.ecs.model.v20140526.DescribeInstanceStatusResponse;
   import com.aliyun.kms.secretsmanager.plugin.sdkcore.ProxyAcsClient;
   import com.aliyuncs.exceptions.ClientException;
   import com.aliyuncs.exceptions.ServerException;
   
   public class AliyunSdkProviderSample {
       public static void main(String[]args) {
           String secretName="******";
           /*
             如果應用無法設置從classpath和可執行jar包中讀取默認配置文件（managed_credentials_providers.properties），
             或需自定義配置文件名稱時，可調用以下代碼設置自定義配置文件,并按以下順序讀取：
             1."your-config-name"配置絕對路徑+文件名稱，即讀取絕對路徑下的文件
             2."your-config-name"僅配置文件名稱，默認先讀取classpath下的配置文件，再讀取可執行jar包中的配置文件
           */
           //ConfigLoader.setConfigName("your-config-name");
           
           // 1. 獲取ACSClient by aliyun-java-sdk-managed-credentials-provider
           IAcsClient client = null;
           try {
               client = new ProxyAcsClient("<the regionId of ECS>", secretName);
           } catch (ClientException e) {
                e.printStackTrace();
            }
           // 2. 調用ECS的OpenAPI實現業務功能
           DescribeInstanceStatusRequest request = new DescribeInstanceStatusRequest();
           DescribeInstanceStatusResponse response;
           try {
                response = client.getAcsResponse(request);
           } catch (ServerException e) {
                e.printStackTrace();
            } catch (ClientException e) {
                e.printStackTrace();
            }
           // 3. 通過下面方法關閉客戶端來釋放插件關聯的資源 
           client.shutdown();
       }
   }

在OSS SDK中使用

1. 通過Maven的方式在項目中引入RAM憑據插件。

   <dependency>
       <groupId>com.aliyun</groupId>
       <artifactId>aliyun-java-sdk-core</artifactId>
       <version>4.5.17</version>
   </dependency>
   <dependency>
   <groupId>com.aliyun.oss</groupId>
   <artifactId>aliyun-sdk-oss</artifactId>
   <version>[2.1.0,3.10.2]</version>
   <exclusions>
       <exclusion>
           <groupId>com.aliyun</groupId>
           <artifactId>aliyun-java-sdk-kms</artifactId>
       </exclusion>
   </exclusions>
   </dependency>
   <dependency>
   <groupId>com.aliyun</groupId>
   <artifactId>aliyun-sdk-oss-managed-credentials-provider</artifactId>
   <version>[1.3.1,]</version>
   </dependency>

   說明

   建議您安裝最新版本的插件，更多信息，請參見原始代碼。

2. 獲得OSS Java SDK客戶端并調用云服務。

   以調用OSS listBuckets 為例：

   import com.aliyun.kms.secretsmanager.plugin.oss.ProxyOSSClientBuilder;
   import com.aliyun.oss.OSS;
   import com.aliyun.oss.model.Bucket;
   
   import java.util.List;
   
   public class OssProviderSample {
   
       public static void main(String[] args) throws Exception {
           String secretName = "******";
           String endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
   
           /*
             如果應用無法設置從classpath和可執行jar包中讀取默認配置文件（managed_credentials_providers.properties），
             或需自定義配置文件名稱時，可調用以下代碼設置自定義配置文件,并按以下順序讀取：
             1."your-config-name"配置絕對路徑+文件名稱，即讀取絕對路徑下的文件
             2."your-config-name"僅配置文件名稱，默認先讀取classpath下的配置文件，再讀取可執行jar包中的配置文件
           */
           //ConfigLoader.setConfigName("your-config-name");
   
           // 獲取Oss Client
           OSS ossClient = new ProxyOSSClientBuilder().build(endpoint, secretName);
   
   
           // 以下為業務方業務代碼：調用阿里云OSS服務實現業務功能
           List<Bucket> buckets = ossClient.listBuckets();
           for (Bucket bucket : buckets) {
               if (bucket != null) {
                   // ...
               }
           }
   
           // 通過下面方法關閉客戶端來釋放插件關聯的資源 
           ossClient.shutdown();
       }
   
   }

Python

阿里云Python SDK（V1.0）

1. 執行pip命令以在項目中使用RAM憑據插件。

   pip install aliyun-openapi-python-sdk-managed-credentials-provider

   說明

   請確保插件版本為0.1.0及以上版本，更多信息，請參見原始代碼。

2. 獲得阿里云Python SDK客戶端并調用云服務。

   from aliyun_sdk_secretsmanager_sdk_core_plugin.proxy_acs_client import ProxyAcsClient
   
      region="cn-hangzhou"
      secretName="******"
   
      # 1. 獲取ACSClient
      client = ProxyAcsClient(region_id=region, secret_name=secretName )
   
      # 2. 業務方業務代碼：使用client調用阿里云服務，無需代碼改動。
      ...
   
      # 3. 通過下面方法關閉客戶端來釋放插件關聯的資源
      client.shutdown()

OSS Python SDK

1. 執行pip命令以在項目中使用RAM憑據插件。

   pip install aliyun-oss-python-sdk-managed-credentials-provider

   說明

   請確保插件版本為0.1.0及以上版本，更多信息，請參見原始代碼。

2. 獲得阿里云OSS Python SDK客戶端并調用云服務。

   from aliyun_sdk_secretsmanager_oss_plugin.proxy_bucket import ProxyBucket
   from itertools import islice
   
   endpoint = "******"
   secret_name ="******"
   bucket_name = "******"
   bucket = ProxyBucket(secret_name=secret_name, endpoint=endpoint, bucket_name=bucket_name)
   objects = bucket.list_objects()
   for b in islice(objects.object_list, 10):
       print(b.key)
   bucket.shutdown()

Go

阿里云Go SDK（V1.0）

1. 安裝阿里云Go SDK的RAM憑據插件。

   說明

   建議您安裝最新版本的插件，更多信息，請參見原始代碼。

   • 方式一：使用go.mod管理您的依賴。

     在go.mod文件中添加以下內容安裝依賴包。

     require (
         github.com/aliyun/aliyun-sdk-managed-credentials-providers-go/aliyun-sdk-managed-credentials-providers/alibaba-cloud-sdk-go-managed-credentials-provider vX.X.X
     )

   • 方式二：使用go get命令獲取遠程代碼包。

     go get -u github.com/aliyun/aliyun-sdk-mxanaged-credentials-providers-go/aliyun-sdk-managed-credentials-providers/alibaba-cloud-sdk-go-managed-credentials-provider

2. 獲得阿里云Go SDK的客戶端并調用云服務。

   以調用ECS DescribeInstances 為例：

   package sample
   
   import (
       "fmt"
       "github.com/aliyun/alibaba-cloud-sdk-go/services/ecs"
       sdkcoreprovider "github.com/aliyun/aliyun-sdk-managed-credentials-providers-go/aliyun-sdk-managed-credentials-providers/alibaba-cloud-sdk-go-managed-credentials-provider/sdk"
   )
   
   func main() {
       secretName := "********"
       regionId := "cn-hangzhou"
   
       client, err := sdkcoreprovider.GetClient(&ecs.Client{}, regionId, secretName)
       if err != nil {
           fmt.Println(err)
           return
       }
       ecsClient := client.(*ecs.Client)
   
       request := ecs.CreateDescribeInstancesRequest()
       instancesResponse, err := ecsClient.DescribeInstances(request)
       if err != nil {
           fmt.Println(err)
           return
       }
   
       for _, instance := range instancesResponse.Instances.Instance {
           // do something with instance
       }
   }

OSS Go SDK

1. 安裝OSS Go SDK的RAM憑據插件。

   說明

   建議您安裝最新版本的插件，更多信息，請參見原始代碼。

   • 方式一：使用go.mod管理您的依賴。

     在go.mod文件中添加以下內容安裝依賴包。

     require (
         github.com/aliyun/aliyun-sdk-managed-credentials-providers-go/aliyun-sdk-managed-credentials-providers/aliyun-oss-go-sdk-managed-credentials-provider vX.X.X
     )

   • 方式二：使用go get命令獲取遠程代碼包。

     go get -u github.com/aliyun/aliyun-sdk-managed-credentials-providers-go/aliyun-sdk-managed-credentials-providers/aliyun-oss-go-sdk-managed-credentials-provider

2. 獲得阿里云OSS Go SDK客戶端并調用云服務。

   package sample
   
   import (
       "fmt"
       ossprovider "aliyun-oss-go-sdk-managed-credentials-provider/sdk"
   )
   
   func main() {
       secretName := "********"
       endpoint := "https://oss-cn-hangzhou.aliyuncs.com"
   
       // 獲取Proxy Oss Client
       client, err := ossprovider.New(endpoint, secretName)
       if err != nil {
           fmt.Println(err)
           return
       }
   
       result, err := client.ListBuckets()
       if err != nil {
           fmt.Println(err)
           return
       }
       for _, bucket := range result.Buckets {
           //業務代碼
       }
   
       // 關閉客戶端來釋放插件關聯的資源
       client.Shutdown()
   }