适用于 Java 的 Amazon SDK 1.x于2025年12月31日达到支撑终止状态。我们建议您迁移到 [Amazon SDK for Java 2.x](https://docs.amazonaws.cn/sdk-for-java/latest/developer-guide/home.html) 以继续获得新功能、可用性改进和安全更新。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 使用 IAM 账户别名
<a name="examples-iam-account-aliases"></a>

如果您希望登录页面的 URL 包含贵公司名称（或其他友好标识符）而不是 Amazon Web Services 账户 ID，则可以为 Amazon Web Services 账户创建别名。

**注意**  
 Amazon 的每个账户支持一个账户别名。

## 创建账户别名
<a name="creating-an-account-alias"></a>

要创建账户别名，请使用包含别名的 [CreateAccountAliasRequest](https://docs.amazonaws.cn/sdk-for-java/v1/reference/com/amazonaws/services/identitymanagement/model/CreateAccountAliasRequest.html) 对象调用 AmazonIdentityManagementClient 的 `createAccountAlias` 方法。

 **导入**。

```
import com.amazonaws.services.identitymanagement.AmazonIdentityManagement;
import com.amazonaws.services.identitymanagement.AmazonIdentityManagementClientBuilder;
import com.amazonaws.services.identitymanagement.model.CreateAccountAliasRequest;
import com.amazonaws.services.identitymanagement.model.CreateAccountAliasResult;
```

 **代码** 

```
final AmazonIdentityManagement iam =
    AmazonIdentityManagementClientBuilder.defaultClient();

CreateAccountAliasRequest request = new CreateAccountAliasRequest()
    .withAccountAlias(alias);

CreateAccountAliasResult response = iam.createAccountAlias(request);
```

请参阅 GitHub 上的[完整示例](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/java/example_code/iam/src/main/java/aws/example/iam/CreateAccountAlias.java)。

## 列出账户别名
<a name="listing-account-aliases"></a>

要列出您的账户别名（如果有），请调用 AmazonIdentityManagementClient 的 `listAccountAliases` 方法。

**注意**  
返回的 [ListAccountAliasesResult](https://docs.amazonaws.cn/AWSJavaSDK/latest/javadoc/com/amazonaws/services/identitymanagement/model/ListAccountAliasesResult.html) 支持与其他适用于 Java 的 Amazon SDK *列出* 方法相同的 `getIsTruncated` 和 `getMarker` 方法，但一个 Amazon Web Services 账户只能有*一个* 账户别名。

 **导入** 

```
import com.amazonaws.services.identitymanagement.AmazonIdentityManagement;
import com.amazonaws.services.identitymanagement.AmazonIdentityManagementClientBuilder;
import com.amazonaws.services.identitymanagement.model.ListAccountAliasesResult;
```

 **代码** 

```
final AmazonIdentityManagement iam =
    AmazonIdentityManagementClientBuilder.defaultClient();

ListAccountAliasesResult response = iam.listAccountAliases();

for (String alias : response.getAccountAliases()) {
    System.out.printf("Retrieved account alias %s", alias);
}
```

请参阅 GitHub 上的[完整示例](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/java/example_code/iam/src/main/java/aws/example/iam/ListAccountAliases.java)。

## 删除账户别名
<a name="deleting-an-account-alias"></a>

要删除您账户的别名，请调用 AmazonIdentityManagementClient 的 `deleteAccountAlias` 方法。在删除账户别名时，您必须使用 [DeleteAccountAliasRequest](https://docs.amazonaws.cn/sdk-for-java/v1/reference/com/amazonaws/services/identitymanagement/model/DeleteAccountAliasRequest.html) 对象提供其名称。

 **导入** 

```
import com.amazonaws.services.identitymanagement.AmazonIdentityManagement;
import com.amazonaws.services.identitymanagement.AmazonIdentityManagementClientBuilder;
import com.amazonaws.services.identitymanagement.model.DeleteAccountAliasRequest;
import com.amazonaws.services.identitymanagement.model.DeleteAccountAliasResult;
```

 **代码** 

```
final AmazonIdentityManagement iam =
    AmazonIdentityManagementClientBuilder.defaultClient();

DeleteAccountAliasRequest request = new DeleteAccountAliasRequest()
    .withAccountAlias(alias);

DeleteAccountAliasResult response = iam.deleteAccountAlias(request);
```

请参阅 GitHub 上的[完整示例](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/java/example_code/iam/src/main/java/aws/example/iam/DeleteAccountAlias.java)。

## 更多信息
<a name="more-information"></a>
+  《IAM 用户指南》中的[您的 Amazon 账户 ID 及其别名](https://docs.amazonaws.cn/IAM/latest/UserGuide/console_account-alias.html)
+  《IAM API Reference》中的 [CreateAccountAlias](https://docs.amazonaws.cn/IAM/latest/APIReference/API_CreateAccountAlias.html)
+  《IAM API Reference》中的 [ListAccountAliases](https://docs.amazonaws.cn/IAM/latest/APIReference/API_ListAccountAliases.html)
+  《IAM API Reference》中的 [DeleteAccountAlias](https://docs.amazonaws.cn/IAM/latest/APIReference/API_DeleteAccountAlias.html)