文件 AWS 開發套件範例 GitHub 儲存庫中有更多可用的 [AWS SDK 範例](https://github.com/awsdocs/aws-doc-sdk-examples)。
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# `GetPasswordData` 搭配 AWS SDK 或 CLI 使用
下列程式碼範例示範如何使用 `GetPasswordData`。
------
#### [ CLI ]
**AWS CLI**
**取得加密的密碼**
此範例取得加密的密碼。
命令：
```
aws ec2 get-password-data --instance-id i-1234567890abcdef0
```
輸出：
```
{
"InstanceId": "i-1234567890abcdef0",
"Timestamp": "2013-08-07T22:18:38.000Z",
"PasswordData": "gSlJFq+VpcZXqy+iktxMF6NyxQ4qCrT4+gaOuNOenX1MmgXPTj7XEXAMPLE
UQ+YeFfb+L1U4C4AKv652Ux1iRB3CPTYP7WmU3TUnhsuBd+p6LVk7T2lKUml6OXbk6WPW1VYYm/TRPB1
e1DQ7PY4an/DgZT4mwcpRFigzhniQgDDeO1InvSDcwoUTwNs0Y1S8ouri2W4n5GNlriM3Q0AnNVelVz/
53TkDtxbNoU606M1gK9zUWSxqEgwvbV2j8c5rP0WCuaMWSFl4ziDu4bd7q+4RSyi8NUsVWnKZ4aEZffu
DPGzKrF5yLlf3etP2L4ZR6CvG7K1hx7VKOQVN32Dajw=="
}
```
**取得解密的密碼**
此範例取得解密的密碼。
命令：
```
aws ec2 get-password-data --instance-id i-1234567890abcdef0 --priv-launch-key C:\Keys\MyKeyPair.pem
```
輸出：
```
{
"InstanceId": "i-1234567890abcdef0",
"Timestamp": "2013-08-30T23:18:05.000Z",
"PasswordData": "&ViJ652e*u"
}
```
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [GetPasswordData](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/get-password-data.html)。
------
#### [ Java ]
**SDK for Java 2.x**
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/ec2#code-examples)中設定和執行。
```
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.ec2.Ec2AsyncClient;
import software.amazon.awssdk.services.ec2.model.*;
import java.util.concurrent.CompletableFuture;
/**
* Before running this Java V2 code example, set up your development
* environment, including your credentials.
*
* For more information, see the following documentation topic:
*
* https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/get-started.html
*/
public class GetPasswordData {
public static void main(String[] args) {
final String usage = """
Usage:
Where:
instanceId - An instance id value that you can obtain from the AWS Management Console.\s
""";
if (args.length != 1) {
System.out.println(usage);
System.exit(1);
}
String instanceId = args[0];
Ec2AsyncClient ec2AsyncClient = Ec2AsyncClient.builder()
.region(Region.US_EAST_1)
.build();
try {
CompletableFuture future = getPasswordDataAsync(ec2AsyncClient, instanceId);
future.join();
} catch (RuntimeException rte) {
System.err.println("An exception occurred: " + (rte.getCause() != null ? rte.getCause().getMessage() : rte.getMessage()));
}
}
/**
* Fetches the password data for the specified EC2 instance asynchronously.
*
* @param ec2AsyncClient the EC2 asynchronous client to use for the request
* @param instanceId instanceId the ID of the EC2 instance for which you want to fetch the password data
* @return a {@link CompletableFuture} that completes when the password data has been fetched
* @throws RuntimeException if there was a failure in fetching the password data
*/
public static CompletableFuture getPasswordDataAsync(Ec2AsyncClient ec2AsyncClient, String instanceId) {
GetPasswordDataRequest getPasswordDataRequest = GetPasswordDataRequest.builder()
.instanceId(instanceId)
.build();
CompletableFuture response = ec2AsyncClient.getPasswordData(getPasswordDataRequest);
response.whenComplete((getPasswordDataResponse, ex) -> {
if (ex != null) {
throw new RuntimeException("Failed to get password data for instance: " + instanceId, ex);
} else if (getPasswordDataResponse == null || getPasswordDataResponse.passwordData().isEmpty()) {
throw new RuntimeException("No password data found for instance: " + instanceId);
} else {
String encryptedPasswordData = getPasswordDataResponse.passwordData();
System.out.println("Encrypted Password Data: " + encryptedPasswordData);
}
});
return response.thenApply(resp -> null);
}
}
```
+ 如需 API 詳細資訊，請參閱《AWS SDK for Java 2.x API 參考》**中的 [GetPasswordData](https://docs.aws.amazon.com/goto/SdkForJavaV2/ec2-2016-11-15/GetPasswordData)。
------
#### [ PowerShell ]
**Tools for PowerShell V4**
**範例 1：此範例會解密 Amazon EC2 指派給指定之 Windows 執行個體管理員帳戶的密碼。由於指定了 pem 檔案，因此會自動採用 -Decrypt 參數的設定。**
```
Get-EC2PasswordData -InstanceId i-12345678 -PemFile C:\path\my-key-pair.pem
```
**輸出：**
```
mYZ(PA9?C)Q
```
**範例 2：（僅限 Windows PowerShell) 檢查執行個體，以判斷用來啟動執行個體的金鑰對名稱，然後嘗試在 AWS Toolkit for Visual Studio 的組態存放區中尋找對應的金鑰對資料。如果找到金鑰對資料，則會將密碼解密。**
```
Get-EC2PasswordData -InstanceId i-12345678 -Decrypt
```
**輸出：**
```
mYZ(PA9?C)Q
```
**範例 3：傳回執行個體的加密密碼資料。**
```
Get-EC2PasswordData -InstanceId i-12345678
```
**輸出：**
```
iVz3BAK/WAXV.....dqt8WeMA==
```
+ 如需 API 詳細資訊，請參閱《AWS Tools for PowerShell Cmdlet 參考 (V4)》**中的 [GetPasswordData](https://docs.aws.amazon.com/powershell/v4/reference)。
**Tools for PowerShell V5**
**範例 1：此範例會解密 Amazon EC2 指派給指定之 Windows 執行個體管理員帳戶的密碼。由於指定了 pem 檔案，因此會自動採用 -Decrypt 參數的設定。**
```
Get-EC2PasswordData -InstanceId i-12345678 -PemFile C:\path\my-key-pair.pem
```
**輸出：**
```
mYZ(PA9?C)Q
```
**範例 2：（僅限 Windows PowerShell) 檢查執行個體，以判斷用來啟動執行個體的金鑰對名稱，然後嘗試在 AWS Toolkit for Visual Studio 的組態存放區中尋找對應的金鑰對資料。如果找到金鑰對資料，則會將密碼解密。**
```
Get-EC2PasswordData -InstanceId i-12345678 -Decrypt
```
**輸出：**
```
mYZ(PA9?C)Q
```
**範例 3：傳回執行個體的加密密碼資料。**
```
Get-EC2PasswordData -InstanceId i-12345678
```
**輸出：**
```
iVz3BAK/WAXV.....dqt8WeMA==
```
+ 如需 API 詳細資訊，請參閱《AWS Tools for PowerShell Cmdlet 參考 (V5)》**中的 [GetPasswordData](https://docs.aws.amazon.com/powershell/v5/reference)。
------