文档 AWS SDK 示例 GitHub 存储库中还有更多 [S AWS DK 示例](https://github.com/awsdocs/aws-doc-sdk-examples)。
本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 使用网络管理器示例 AWS CLI
以下代码示例向您展示了如何通过 AWS Command Line Interface 与网络管理器一起使用来执行操作和实现常见场景。
*操作*是大型程序的代码摘录，必须在上下文中运行。您可以通过操作了解如何调用单个服务函数，还可以通过函数相关场景的上下文查看操作。
每个示例都包含一个指向完整源代码的链接，您可以从中找到有关如何在上下文中设置和运行代码的说明。
**Topics**
+ [操作](#actions)
## 操作
### `associate-customer-gateway`
以下代码示例演示了如何使用 `associate-customer-gateway`。
**AWS CLI**
**关联客户网关**
以下 `associate-customer-gateway` 示例将指定全局网络中的客户网关 `cgw-11223344556677889` 与设备 `device-07f6fd08867abc123` 相关联。
```
aws networkmanager associate-customer-gateway \
--customer-gateway-arn arn:aws:ec2:us-west-2:123456789012:customer-gateway/cgw-11223344556677889 \
--global-network-id global-network-01231231231231231 \
--device-id device-07f6fd08867abc123 \
--region us-west-2
```
输出：
```
{
"CustomerGatewayAssociation": {
"CustomerGatewayArn": "arn:aws:ec2:us-west-2:123456789012:customer-gateway/cgw-11223344556677889",
"GlobalNetworkId": "global-network-01231231231231231",
"DeviceId": "device-07f6fd08867abc123",
"State": "PENDING"
}
}
```
有关更多信息，请参阅《Transit Gateway Network Manager 指南》**中的[客户网关关联](https://docs.aws.amazon.com/vpc/latest/tgw/on-premises-networks.html#cgw-association)。
+ 有关 API 的详细信息，请参阅*AWS CLI 命令参考[AssociateCustomerGateway](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/associate-customer-gateway.html)*中的。
### `associate-link`
以下代码示例演示了如何使用 `associate-link`。
**AWS CLI**
**关联链接**
以下 `associate-link` 示例将链接 `link-11112222aaaabbbb1` 与设备 `device-07f6fd08867abc123` 关联。该链接和设备位于指定全局网络中。
```
aws networkmanager associate-link \
--global-network-id global-network-01231231231231231 \
--device-id device-07f6fd08867abc123 \
--link-id link-11112222aaaabbbb1 \
--region us-west-2
```
输出：
```
{
"LinkAssociation": {
"GlobalNetworkId": "global-network-01231231231231231",
"DeviceId": "device-07f6fd08867abc123",
"LinkId": "link-11112222aaaabbbb1",
"LinkAssociationState": "PENDING"
}
}
```
有关更多信息，请参阅《Transit Gateway Network Manager 指南》**中的[设备和链接关联](https://docs.aws.amazon.com/vpc/latest/tgw/on-premises-networks.html#device-link-association)。
+ 有关 API 的详细信息，请参阅*AWS CLI 命令参考[AssociateLink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/associate-link.html)*中的。
### `create-core-network`
以下代码示例演示了如何使用 `create-core-network`。
**AWS CLI**
**创建核心网络**
以下`create-core-network`示例使用可选描述和标签在 AWS Cloud WAN 全球网络中创建核心网络。
```
aws networkmanager create-core-network \
--global-network-id global-network-cdef-EXAMPLE22222 \
--description "Main headquarters location" \
--tags Key=Name,Value="New York City office"
```
输出：
```
{
"CoreNetwork": {
"GlobalNetworkId": "global-network-cdef-EXAMPLE22222",
"CoreNetworkId": "core-network-cdef-EXAMPLE33333",
"CoreNetworkArn": "arn:aws:networkmanager::987654321012:core-network/core-network-cdef-EXAMPLE33333",
"Description": "Main headquarters location",
"CreatedAt": "2022-01-10T19:53:59+00:00",
"State": "AVAILABLE",
"Tags": [
{
"Key": "Name",
"Value": "New York City office"
}
]
}
}
```
有关更多信息，请参阅《AWS Cloud WAN 用户指南》**中的[全局和核心网络](https://docs.aws.amazon.com/network-manager/latest/cloudwan/cloudwan-core-network-policy.html)。
+ 有关 API 的详细信息，请参阅*AWS CLI 命令参考[CreateCoreNetwork](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/create-core-network.html)*中的。
### `create-device`
以下代码示例演示了如何使用 `create-device`。
**AWS CLI**
**创建设备**
以下 `create-device` 示例在指定全局网络中创建一个设备。该设备的详细信息包括描述、类型、供应商、型号和序列号。
```
aws networkmanager create-device
--global-network-id global-network-01231231231231231 \
--description "New York office device" \
--type "office device" \
--vendor "anycompany" \
--model "abcabc" \
--serial-number "1234" \
--region us-west-2
```
输出：
```
{
"Device": {
"DeviceId": "device-07f6fd08867abc123",
"DeviceArn": "arn:aws:networkmanager::123456789012:device/global-network-01231231231231231/device-07f6fd08867abc123",
"GlobalNetworkId": "global-network-01231231231231231",
"Description": "New York office device",
"Type": "office device",
"Vendor": "anycompany",
"Model": "abcabc",
"SerialNumber": "1234",
"CreatedAt": 1575554005.0,
"State": "PENDING"
}
}
```
有关更多信息，请参阅《Transit Gateway Network Manager 指南》中的**[使用设备](https://docs.aws.amazon.com/vpc/latest/tgw/on-premises-networks.html#working-with-devices)。
+ 有关 API 的详细信息，请参阅*AWS CLI 命令参考[CreateDevice](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/create-device.html)*中的。
### `create-global-network`
以下代码示例演示了如何使用 `create-global-network`。
**AWS CLI**
**创建全局网络**
以下 `create-global-network` 示例创建一个新的全局网络。创建时的初始状态为 `PENDING`。
```
aws networkmanager create-global-network
```
输出：
```
{
"GlobalNetwork": {
"GlobalNetworkId": "global-network-00a77fc0f722dae74",
"GlobalNetworkArn": "arn:aws:networkmanager::987654321012:global-network/global-network-00a77fc0f722dae74",
"CreatedAt": "2022-03-14T20:31:56+00:00",
"State": "PENDING"
}
}
```
+ 有关 API 的详细信息，请参阅*AWS CLI 命令参考[CreateGlobalNetwork](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/create-global-network.html)*中的。
### `create-link`
以下代码示例演示了如何使用 `create-link`。
**AWS CLI**
**创建链接**
以下 `create-link` 示例在指定全局网络中创建一个链接。该链接包括有关链接类型、带宽和提供商的描述和详细信息。站点 ID 表示链接所关联的站点。
```
aws networkmanager create-link \
--global-network-id global-network-01231231231231231 \
--description "VPN Link" \
--type "broadband" \
--bandwidth UploadSpeed=10,DownloadSpeed=20 \
--provider "AnyCompany" \
--site-id site-444555aaabbb11223 \
--region us-west-2
```
输出：
```
{
"Link": {
"LinkId": "link-11112222aaaabbbb1",
"LinkArn": "arn:aws:networkmanager::123456789012:link/global-network-01231231231231231/link-11112222aaaabbbb1",
"GlobalNetworkId": "global-network-01231231231231231",
"SiteId": "site-444555aaabbb11223",
"Description": "VPN Link",
"Type": "broadband",
"Bandwidth": {
"UploadSpeed": 10,
"DownloadSpeed": 20
},
"Provider": "AnyCompany",
"CreatedAt": 1575555811.0,
"State": "PENDING"
}
}
```
有关更多信息，请参阅《Transit Gateway Network Manager 指南》**中的[使用链接](https://docs.aws.amazon.com/vpc/latest/tgw/on-premises-networks.html#working-with-links)。
+ 有关 API 的详细信息，请参阅*AWS CLI 命令参考[CreateLink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/create-link.html)*中的。
### `create-site`
以下代码示例演示了如何使用 `create-site`。
**AWS CLI**
**创建站点**
以下 `create-site` 示例在指定全局网络中创建一个站点。该站点的详细信息包括描述和位置信息。
```
aws networkmanager create-site \
--global-network-id global-network-01231231231231231 \
--description "New York head office" \
--location Latitude=40.7128,Longitude=-74.0060 \
--region us-west-2
```
输出：
```
{
"Site": {
"SiteId": "site-444555aaabbb11223",
"SiteArn": "arn:aws:networkmanager::123456789012:site/global-network-01231231231231231/site-444555aaabbb11223",
"GlobalNetworkId": "global-network-01231231231231231",
"Description": "New York head office",
"Location": {
"Latitude": "40.7128",
"Longitude": "-74.0060"
},
"CreatedAt": 1575554300.0,
"State": "PENDING"
}
}
```
有关更多信息，请参阅《Transit Gateway Network Manager 指南》**中的[使用站点](https://docs.aws.amazon.com/vpc/latest/tgw/on-premises-networks.html#working-with-sites)。
+ 有关 API 的详细信息，请参阅*AWS CLI 命令参考[CreateSite](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/create-site.html)*中的。
### `create-vpc-attachment`
以下代码示例演示了如何使用 `create-vpc-attachment`。
**AWS CLI**
**创建 VPC 挂载**
以下`create-vpc-attachment`示例创建了一个 IPv6 支持核心网络的 VPC 附件。
```
aws networkmanager create-vpc-attachment \
--core-network-id core-network-0fab62fe438d94db6 \
--vpc-arn arn:aws:ec2:us-east-1:987654321012:vpc/vpc-09f37f69e2786eeb8 \
--subnet-arns arn:aws:ec2:us-east-1:987654321012:subnet/subnet-04ca4e010857e7bb7 \
--Ipv6Support=true
```
输出：
```
{
"VpcAttachment": {
"Attachment": {
"CoreNetworkId": "core-network-0fab62fe438d94db6",
"AttachmentId": "attachment-05e1da6eba87a06e6",
"OwnerAccountId": "987654321012",
"AttachmentType": "VPC",
"State": "CREATING",
"EdgeLocation": "us-east-1",
"ResourceArn": "arn:aws:ec2:us-east-1:987654321012:vpc/vpc-09f37f69e2786eeb8",
"Tags": [],
"CreatedAt": "2022-03-10T20:59:14+00:00",
"UpdatedAt": "2022-03-10T20:59:14+00:00"
},
"SubnetArns": [
"arn:aws:ec2:us-east-1:987654321012:subnet/subnet-04ca4e010857e7bb7"
],
"Options": {
"Ipv6Support": true
}
}
}
```
有关更多信息，请参阅《Cloud WAN 用户指南》**中的[创建挂载](https://docs.aws.amazon.com/vpc/latest/cloudwan/cloudwan-create-attachment.html)。
+ 有关 API 的详细信息，请参阅*AWS CLI 命令参考[CreateVpcAttachment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/create-vpc-attachment.html)*中的。
### `delete-attachment`
以下代码示例演示了如何使用 `delete-attachment`。
**AWS CLI**
**删除挂载**
以下 `delete-attachment` 示例删除一个连接挂载。
```
aws networkmanager delete-attachment \
--attachment-id attachment-01feddaeae26ab68c
```
输出：
```
{
"Attachment": {
"CoreNetworkId": "core-network-0f4b0a9d5ee7761d1",
"AttachmentId": "attachment-01feddaeae26ab68c",
"OwnerAccountId": "987654321012",
"AttachmentType": "CONNECT",
"State": "DELETING",
"EdgeLocation": "us-east-1",
"ResourceArn": "arn:aws:networkmanager::987654321012:attachment/attachment-02c3964448fedf5aa",
"CreatedAt": "2022-03-15T19:18:41+00:00",
"UpdatedAt": "2022-03-15T19:28:59+00:00"
}
}
```
有关更多信息，请参阅《Cloud WAN 用户指南》**中的[删除挂载](https://docs.aws.amazon.com/vpc/latest/cloudwan/cloudwan-attachments-working-with.html#cloudwan-attachments-deleting)。
+ 有关 API 的详细信息，请参阅*AWS CLI 命令参考[DeleteAttachment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/delete-attachment.html)*中的。
### `delete-bucket-analytics-configuration`
以下代码示例演示了如何使用 `delete-bucket-analytics-configuration`。
**AWS CLI**
**删除存储桶的分析配置**
以下 `delete-bucket-analytics-configuration` 示例移除指定存储桶和 ID 的分析配置。
```
aws s3api delete-bucket-analytics-configuration \
--bucket amzn-s3-demo-bucket \
--id 1
```
此命令不生成任何输出。
+ 有关 API 的详细信息，请参阅*AWS CLI 命令参考[DeleteBucketAnalyticsConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/delete-bucket-analytics-configuration.html)*中的。
### `delete-bucket-metrics-configuration`
以下代码示例演示了如何使用 `delete-bucket-metrics-configuration`。
**AWS CLI**
**删除存储桶的指标配置**
以下 `delete-bucket-metrics-configuration` 示例移除指定存储桶和 ID 的指标配置。
```
aws s3api delete-bucket-metrics-configuration \
--bucket amzn-s3-demo-bucket \
--id 123
```
此命令不生成任何输出。
+ 有关 API 的详细信息，请参阅*AWS CLI 命令参考[DeleteBucketMetricsConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/delete-bucket-metrics-configuration.html)*中的。
### `delete-core-network`
以下代码示例演示了如何使用 `delete-core-network`。
**AWS CLI**
**删除核心网络**
以下 `delete-core-network` 示例从 Cloud WAN 全局网络中删除核心网络。
```
aws networkmanager delete-core-network \
--core-network-id core-network-0fab62fe438d94db6
```
输出：
```
{
"CoreNetwork": {
"GlobalNetworkId": "global-network-0d59060f16a73bc41",
"CoreNetworkId": "core-network-0fab62fe438d94db6",
"Description": "Main headquarters location",
"CreatedAt": "2021-12-09T18:31:11+00:00",
"State": "DELETING",
"Segments": [
{
"Name": "dev",
"EdgeLocations": [
"us-east-1"
],
"SharedSegments": []
}
],
"Edges": [
{
"EdgeLocation": "us-east-1",
"Asn": 64512,
"InsideCidrBlocks": []
}
]
}
}
```
有关更多信息，请参阅《Cloud WAN 用户指南》**中的[核心网络](https://docs.aws.amazon.com/vpc/latest/cloudwan/cloudwan-networks-working-with.html#cloudwan-core-networks)。
+ 有关 API 的详细信息，请参阅*AWS CLI 命令参考[DeleteCoreNetwork](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/delete-core-network.html)*中的。
### `delete-device`
以下代码示例演示了如何使用 `delete-device`。
**AWS CLI**
**删除设备**
以下 `delete-device` 示例从指定的全局网络中删除指定设备。
```
aws networkmanager delete-device \
--global-network-id global-network-01231231231231231 \
--device-id device-07f6fd08867abc123 \
--region us-west-2
```
输出：
```
{
"Device": {
"DeviceId": "device-07f6fd08867abc123",
"DeviceArn": "arn:aws:networkmanager::123456789012:device/global-network-01231231231231231/device-07f6fd08867abc123",
"GlobalNetworkId": "global-network-01231231231231231",
"Description": "New York office device",
"Type": "office device",
"Vendor": "anycompany",
"Model": "abcabc",
"SerialNumber": "1234",
"SiteId": "site-444555aaabbb11223",
"CreatedAt": 1575554005.0,
"State": "DELETING"
}
}
```
有关更多信息，请参阅《Transit Gateway Network Manager 指南》中的**[使用设备](https://docs.aws.amazon.com/vpc/latest/tgw/on-premises-networks.html#working-with-devices)。
+ 有关 API 的详细信息，请参阅*AWS CLI 命令参考[DeleteDevice](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/delete-device.html)*中的。
### `delete-global-network`
以下代码示例演示了如何使用 `delete-global-network`。
**AWS CLI**
**删除全局网络**
以下 `delete-global-network` 示例删除一个全局网络。
```
aws networkmanager delete-global-network \
--global-network-id global-network-052bedddccb193b6b
```
输出：
```
{
"GlobalNetwork": {
"GlobalNetworkId": "global-network-052bedddccb193b6b",
"GlobalNetworkArn": "arn:aws:networkmanager::987654321012:global-network/global-network-052bedddccb193b6b",
"CreatedAt": "2021-12-09T18:19:12+00:00",
"State": "DELETING"
}
}
```
+ 有关 API 的详细信息，请参阅*AWS CLI 命令参考[DeleteGlobalNetwork](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/delete-global-network.html)*中的。
### `delete-link`
以下代码示例演示了如何使用 `delete-link`。
**AWS CLI**
**删除链接**
以下 `delete-link` 示例从指定的全局网络中删除指定的链接。
```
aws networkmanager delete-link \
--global-network-id global-network-01231231231231231 \
--link-id link-11112222aaaabbbb1 \
--region us-west-2
```
输出：
```
{
"Link": {
"LinkId": "link-11112222aaaabbbb1",
"LinkArn": "arn:aws:networkmanager::123456789012:link/global-network-01231231231231231/link-11112222aaaabbbb1",
"GlobalNetworkId": "global-network-01231231231231231",
"SiteId": "site-444555aaabbb11223",
"Description": "VPN Link",
"Type": "broadband",
"Bandwidth": {
"UploadSpeed": 20,
"DownloadSpeed": 20
},
"Provider": "AnyCompany",
"CreatedAt": 1575555811.0,
"State": "DELETING"
}
}
```
有关更多信息，请参阅《Transit Gateway Network Manager 指南》**中的[使用链接](https://docs.aws.amazon.com/vpc/latest/tgw/on-premises-networks.html#working-with-links)。
+ 有关 API 的详细信息，请参阅*AWS CLI 命令参考[DeleteLink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/delete-link.html)*中的。
### `delete-public-access-block`
以下代码示例演示了如何使用 `delete-public-access-block`。
**AWS CLI**
**删除存储桶的屏蔽公共访问权限配置**
以下 `delete-public-access-block` 示例移除指定存储桶上的屏蔽公共访问权限配置。
```
aws s3api delete-public-access-block \
--bucket amzn-s3-demo-bucket
```
此命令不生成任何输出。
+ 有关 API 的详细信息，请参阅*AWS CLI 命令参考[DeletePublicAccessBlock](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/delete-public-access-block.html)*中的。
### `delete-site`
以下代码示例演示了如何使用 `delete-site`。
**AWS CLI**
**删除站点**
以下 `delete-site` 示例删除指定全局网络中的指定站点（`site-444555aaabbb11223`）。
```
aws networkmanager delete-site \
--global-network-id global-network-01231231231231231 \
--site-id site-444555aaabbb11223 \
--region us-west-2
```
输出：
```
{
"Site": {
"SiteId": "site-444555aaabbb11223",
"SiteArn": "arn:aws:networkmanager::123456789012:site/global-network-01231231231231231/site-444555aaabbb11223",
"GlobalNetworkId": "global-network-01231231231231231",
"Description": "New York head office",
"Location": {
"Latitude": "40.7128",
"Longitude": "-74.0060"
},
"CreatedAt": 1575554300.0,
"State": "DELETING"
}
}
```
有关更多信息，请参阅《Transit Gateway Network Manager 指南》**中的[使用站点](https://docs.aws.amazon.com/vpc/latest/tgw/on-premises-networks.html#working-with-sites)。
+ 有关 API 的详细信息，请参阅*AWS CLI 命令参考[DeleteSite](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/delete-site.html)*中的。
### `deregister-transit-gateway`
以下代码示例演示了如何使用 `deregister-transit-gateway`。
**AWS CLI**
**从全局网络中注销中转网关**
以下 `deregister-transit-gateway` 示例从指定的全局网络注销指定的中转网关。
```
aws networkmanager deregister-transit-gateway \
--global-network-id global-network-01231231231231231 \
--transit-gateway-arn arn:aws:ec2:us-west-2:123456789012:transit-gateway/tgw-123abc05e04123abc \
--region us-west-2
```
输出：
```
{
"TransitGatewayRegistration": {
"GlobalNetworkId": "global-network-01231231231231231",
"TransitGatewayArn": "arn:aws:ec2:us-west-2:123456789012:transit-gateway/tgw-123abc05e04123abc",
"State": {
"Code": "DELETING"
}
}
}
```
有关更多信息，请参阅《Transit Gateway Network Manager 指南》**中的[中转网关注册](https://docs.aws.amazon.com/vpc/latest/tgw/tgw-registrations.html)。
+ 有关 API 的详细信息，请参阅*AWS CLI 命令参考[DeregisterTransitGateway](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/deregister-transit-gateway.html)*中的。
### `describe-global-networks`
以下代码示例演示了如何使用 `describe-global-networks`。
**AWS CLI**
**描述您的全局网络**
以下 `describe-global-networks` 示例描述您的账户中的所有全局网络。
```
aws networkmanager describe-global-networks \
--region us-west-2
```
输出：
```
{
"GlobalNetworks": [
{
"GlobalNetworkId": "global-network-01231231231231231",
"GlobalNetworkArn": "arn:aws:networkmanager::123456789012:global-network/global-network-01231231231231231",
"Description": "Company 1 global network",
"CreatedAt": 1575553525.0,
"State": "AVAILABLE"
}
]
}
```
+ 有关 API 的详细信息，请参阅*AWS CLI 命令参考[DescribeGlobalNetworks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/describe-global-networks.html)*中的。
### `disassociate-customer-gateway`
以下代码示例演示了如何使用 `disassociate-customer-gateway`。
**AWS CLI**
**取消关联客户网关**
以下 `disassociate-customer-gateway` 示例取消指定客户网关（`cgw-11223344556677889`）与指定全局网络的关联。
```
aws networkmanager disassociate-customer-gateway \
--global-network-id global-network-01231231231231231 \
--customer-gateway-arn arn:aws:ec2:us-west-2:123456789012:customer-gateway/cgw-11223344556677889 \
--region us-west-2
```
输出：
```
{
"CustomerGatewayAssociation": {
"CustomerGatewayArn": "arn:aws:ec2:us-west-2:123456789012:customer-gateway/cgw-11223344556677889",
"GlobalNetworkId": "global-network-01231231231231231",
"DeviceId": "device-07f6fd08867abc123",
"State": "DELETING"
}
}
```
有关更多信息，请参阅《Transit Gateway Network Manager 指南》**中的[客户网关关联](https://docs.aws.amazon.com/vpc/latest/tgw/on-premises-networks.html#cgw-association)。
+ 有关 API 的详细信息，请参阅*AWS CLI 命令参考[DisassociateCustomerGateway](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/disassociate-customer-gateway.html)*中的。
### `disassociate-link`
以下代码示例演示了如何使用 `disassociate-link`。
**AWS CLI**
**取消关联链接**
以下 `disassociate-link` 示例取消指定的全局网络中指定链接与设备 `device-07f6fd08867abc123` 的关联。
```
aws networkmanager disassociate-link \
--global-network-id global-network-01231231231231231 \
--device-id device-07f6fd08867abc123 \
--link-id link-11112222aaaabbbb1 \
--region us-west-2
```
输出：
```
{
"LinkAssociation": {
"GlobalNetworkId": "global-network-01231231231231231",
"DeviceId": "device-07f6fd08867abc123",
"LinkId": "link-11112222aaaabbbb1",
"LinkAssociationState": "DELETING"
}
}
```
有关更多信息，请参阅《Transit Gateway Network Manager 指南》**中的[设备和链接关联](https://docs.aws.amazon.com/vpc/latest/tgw/on-premises-networks.html#device-link-association)。
+ 有关 API 的详细信息，请参阅*AWS CLI 命令参考[DisassociateLink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/disassociate-link.html)*中的。
### `get-bucket-analytics-configuration`
以下代码示例演示了如何使用 `get-bucket-analytics-configuration`。
**AWS CLI**
**检索具有特定 ID 的存储桶的分析配置**
以下 `get-bucket-analytics-configuration` 示例显示了指定存储桶和 ID 的分析配置。
```
aws s3api get-bucket-analytics-configuration \
--bucket amzn-s3-demo-bucket \
--id 1
```
输出：
```
{
"AnalyticsConfiguration": {
"StorageClassAnalysis": {},
"Id": "1"
}
}
```
+ 有关 API 的详细信息，请参阅*AWS CLI 命令参考[GetBucketAnalyticsConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/get-bucket-analytics-configuration.html)*中的。
### `get-bucket-metrics-configuration`
以下代码示例演示了如何使用 `get-bucket-metrics-configuration`。
**AWS CLI**
**检索具有特定 ID 的存储桶的指标配置**
以下 `get-bucket-metrics-configuration` 示例显示了指定存储桶和 ID 的指标配置。
```
aws s3api get-bucket-metrics-configuration \
--bucket amzn-s3-demo-bucket \
--id 123
```
输出：
```
{
"MetricsConfiguration": {
"Filter": {
"Prefix": "logs"
},
"Id": "123"
}
}
```
+ 有关 API 的详细信息，请参阅*AWS CLI 命令参考[GetBucketMetricsConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/get-bucket-metrics-configuration.html)*中的。
### `get-customer-gateway-associations`
以下代码示例演示了如何使用 `get-customer-gateway-associations`。
**AWS CLI**
**获取您的客户网关关联**
以下 `get-customer-gateway-associations` 示例获取指定全局网络的客户网关关联。
```
aws networkmanager get-customer-gateway-associations \
--global-network-id global-network-01231231231231231 \
--region us-west-2
```
输出：
```
{
"CustomerGatewayAssociations": [
{
"CustomerGatewayArn": "arn:aws:ec2:us-west-2:123456789012:customer-gateway/cgw-11223344556677889",
"GlobalNetworkId": "global-network-01231231231231231",
"DeviceId": "device-07f6fd08867abc123",
"State": "AVAILABLE"
}
]
}
```
+ 有关 API 的详细信息，请参阅*AWS CLI 命令参考[GetCustomerGatewayAssociations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/get-customer-gateway-associations.html)*中的。
### `get-devices`
以下代码示例演示了如何使用 `get-devices`。
**AWS CLI**
**获取您的设备**
以下 `get-devices` 示例获取指定全局网络中的设备。
```
aws networkmanager get-devices \
--global-network-id global-network-01231231231231231 \
--region us-west-2
```
输出：
```
{
"Devices": [
{
"DeviceId": "device-07f6fd08867abc123",
"DeviceArn": "arn:aws:networkmanager::123456789012:device/global-network-01231231231231231/device-07f6fd08867abc123",
"GlobalNetworkId": "global-network-01231231231231231",
"Description": "NY office device",
"Type": "office device",
"Vendor": "anycompany",
"Model": "abcabc",
"SerialNumber": "1234",
"CreatedAt": 1575554005.0,
"State": "AVAILABLE"
}
]
}
```
+ 有关 API 的详细信息，请参阅*AWS CLI 命令参考[GetDevices](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/get-devices.html)*中的。
### `get-link-associations`
以下代码示例演示了如何使用 `get-link-associations`。
**AWS CLI**
**获取您的链接关联**
以下 `get-link-associations` 示例获取指定全局网络中的链接关联。
```
aws networkmanager get-link-associations \
--global-network-id global-network-01231231231231231 \
--region us-west-2
```
输出：
```
{
"LinkAssociations": [
{
"GlobalNetworkId": "global-network-01231231231231231",
"DeviceId": "device-07f6fd08867abc123",
"LinkId": "link-11112222aaaabbbb1",
"LinkAssociationState": "AVAILABLE"
}
]
}
```
+ 有关 API 的详细信息，请参阅*AWS CLI 命令参考[GetLinkAssociations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/get-link-associations.html)*中的。
### `get-links`
以下代码示例演示了如何使用 `get-links`。
**AWS CLI**
**获取您的链接**
以下 `get-links` 示例获取指定全局网络中的链接。
```
aws networkmanager get-links \
--global-network-id global-network-01231231231231231 \
--region us-west-2
```
输出：
```
{
"Links": [
{
"LinkId": "link-11112222aaaabbbb1",
"LinkArn": "arn:aws:networkmanager::123456789012:link/global-network-01231231231231231/link-11112222aaaabbbb1",
"GlobalNetworkId": "global-network-01231231231231231",
"SiteId": "site-444555aaabbb11223",
"Description": "VPN Link",
"Type": "broadband",
"Bandwidth": {
"UploadSpeed": 10,
"DownloadSpeed": 20
},
"Provider": "AnyCompany",
"CreatedAt": 1575555811.0,
"State": "AVAILABLE"
}
]
}
```
+ 有关 API 的详细信息，请参阅*AWS CLI 命令参考[GetLinks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/get-links.html)*中的。
### `get-object-retention`
以下代码示例演示了如何使用 `get-object-retention`。
**AWS CLI**
**检索对象的对象保留配置**
以下 `get-object-retention` 示例检索指定对象的对象保留配置。
```
aws s3api get-object-retention \
--bucket amzn-s3-demo-bucket-with-object-lock \
--key doc1.rtf
```
输出：
```
{
"Retention": {
"Mode": "GOVERNANCE",
"RetainUntilDate": "2025-01-01T00:00:00.000Z"
}
}
```
+ 有关 API 的详细信息，请参阅*AWS CLI 命令参考[GetObjectRetention](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/get-object-retention.html)*中的。
### `get-public-access-block`
以下代码示例演示了如何使用 `get-public-access-block`。
**AWS CLI**
**设置或修改存储桶的屏蔽公共访问权限配置**
以下 `get-public-access-block` 示例显示了指定存储桶的屏蔽公共访问权限配置。
```
aws s3api get-public-access-block --bucket amzn-s3-demo-bucket
```
输出：
```
{
"PublicAccessBlockConfiguration": {
"IgnorePublicAcls": true,
"BlockPublicPolicy": true,
"BlockPublicAcls": true,
"RestrictPublicBuckets": true
}
}
```
+ 有关 API 的详细信息，请参阅*AWS CLI 命令参考[GetPublicAccessBlock](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/get-public-access-block.html)*中的。
### `get-sites`
以下代码示例演示了如何使用 `get-sites`。
**AWS CLI**
**获取您的站点**
以下 `get-sites` 示例获取指定全局网络中的站点。
```
aws networkmanager get-sites \
--global-network-id global-network-01231231231231231 \
--region us-west-2
```
输出：
```
{
"Sites": [
{
"SiteId": "site-444555aaabbb11223",
"SiteArn": "arn:aws:networkmanager::123456789012:site/global-network-01231231231231231/site-444555aaabbb11223",
"GlobalNetworkId": "global-network-01231231231231231",
"Description": "NY head office",
"Location": {
"Latitude": "40.7128",
"Longitude": "-74.0060"
},
"CreatedAt": 1575554528.0,
"State": "AVAILABLE"
}
]
}
```
+ 有关 API 的详细信息，请参阅*AWS CLI 命令参考[GetSites](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/get-sites.html)*中的。
### `get-transit-gateway-registrations`
以下代码示例演示了如何使用 `get-transit-gateway-registrations`。
**AWS CLI**
**获取中转网关注册**
以下 `get-transit-gateway-registrations` 示例获取注册到指定全局网络的中转网关。
```
aws networkmanager get-transit-gateway-registrations \
--global-network-id global-network-01231231231231231 \
--region us-west-2
```
输出：
```
{
"TransitGatewayRegistrations": [
{
"GlobalNetworkId": "global-network-01231231231231231",
"TransitGatewayArn": "arn:aws:ec2:us-west-2:123456789012:transit-gateway/tgw-123abc05e04123abc",
"State": {
"Code": "AVAILABLE"
}
}
]
}
```
+ 有关 API 的详细信息，请参阅*AWS CLI 命令参考[GetTransitGatewayRegistrations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/get-transit-gateway-registrations.html)*中的。
### `get-vpc-attachment`
以下代码示例演示了如何使用 `get-vpc-attachment`。
**AWS CLI**
**获取 VPC 挂载**
以下 `get-vpc-attachment` 示例返回有关 VPC 挂载的信息。
```
aws networkmanager get-vpc-attachment \
--attachment-id attachment-03b7ea450134787da
```
输出：
```
{
"VpcAttachment": {
"Attachment": {
"CoreNetworkId": "core-network-0522de1b226a5d7b3",
"AttachmentId": "attachment-03b7ea450134787da",
"OwnerAccountId": "987654321012",
"AttachmentType": "VPC",
"State": "CREATING",
"EdgeLocation": "us-east-1",
"ResourceArn": "arn:aws:ec2:us-east-1:987654321012:vpc/vpc-a7c4bbda",
"Tags": [
{
"Key": "Name",
"Value": "DevVPC"
}
],
"CreatedAt": "2022-03-11T17:48:58+00:00",
"UpdatedAt": "2022-03-11T17:48:58+00:00"
},
"SubnetArns": [
"arn:aws:ec2:us-east-1:987654321012:subnet/subnet-202cde6c",
"arn:aws:ec2:us-east-1:987654321012:subnet/subnet-e5022dba",
"arn:aws:ec2:us-east-1:987654321012:subnet/subnet-2387ae02",
"arn:aws:ec2:us-east-1:987654321012:subnet/subnet-cda9dffc"
],
"Options": {
"Ipv6Support": false
}
}
}
```
有关更多信息，请参阅《Cloud WAN 用户指南》**中的[挂载](https://docs.aws.amazon.com/vpc/latest/cloudwan/cloudwan-attachments-working-with.html)。
+ 有关 API 的详细信息，请参阅*AWS CLI 命令参考[GetVpcAttachment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/get-vpc-attachment.html)*中的。
### `list-bucket-analytics-configurations`
以下代码示例演示了如何使用 `list-bucket-analytics-configurations`。
**AWS CLI**
**检索存储桶的分析配置列表**
下面的 `list-bucket-analytics-configurations` 检索指定存储桶的分析配置列表。
```
aws s3api list-bucket-analytics-configurations \
--bucket amzn-s3-demo-bucket
```
输出：
```
{
"AnalyticsConfigurationList": [
{
"StorageClassAnalysis": {},
"Id": "1"
}
],
"IsTruncated": false
}
```
+ 有关 API 的详细信息，请参阅*AWS CLI 命令参考[ListBucketAnalyticsConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/list-bucket-analytics-configurations.html)*中的。
### `list-bucket-metrics-configurations`
以下代码示例演示了如何使用 `list-bucket-metrics-configurations`。
**AWS CLI**
**检索存储桶的指标配置列表**
以下 `list-bucket-metrics-configurations` 示例检索指定存储桶的指标配置列表。
```
aws s3api list-bucket-metrics-configurations \
--bucket amzn-s3-demo-bucket
```
输出：
```
{
"IsTruncated": false,
"MetricsConfigurationList": [
{
"Filter": {
"Prefix": "logs"
},
"Id": "123"
},
{
"Filter": {
"Prefix": "tmp"
},
"Id": "234"
}
]
}
```
+ 有关 API 的详细信息，请参阅*AWS CLI 命令参考[ListBucketMetricsConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/list-bucket-metrics-configurations.html)*中的。
### `list-tags-for-resource`
以下代码示例演示了如何使用 `list-tags-for-resource`。
**AWS CLI**
**列出资源标签**
以下 `list-tags-for-resource` 示例列出指定设备资源（`device-07f6fd08867abc123`）的标签。
```
aws networkmanager list-tags-for-resource \
--resource-arn arn:aws:networkmanager::123456789012:device/global-network-01231231231231231/device-07f6fd08867abc123 \
--region us-west-2
```
输出：
```
{
"TagList": [
{
"Key": "Network",
"Value": "Northeast"
}
]
}
```
+ 有关 API 的详细信息，请参阅*AWS CLI 命令参考[ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/list-tags-for-resource.html)*中的。
### `put-bucket-metrics-configuration`
以下代码示例演示了如何使用 `put-bucket-metrics-configuration`。
**AWS CLI**
**设置存储桶的指标配置**
以下 `put-bucket-metrics-configuration` 示例为指定存储桶设置 ID 为 123 的指标配置。
```
aws s3api put-bucket-metrics-configuration \
--bucket amzn-s3-demo-bucket \
--id 123 \
--metrics-configuration '{"Id": "123", "Filter": {"Prefix": "logs"}}'
```
此命令不生成任何输出。
+ 有关 API 的详细信息，请参阅*AWS CLI 命令参考[PutBucketMetricsConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/put-bucket-metrics-configuration.html)*中的。
### `put-object-retention`
以下代码示例演示了如何使用 `put-object-retention`。
**AWS CLI**
**为对象设置对象保留配置**
以下 `put-object-retention` 示例为指定对象设置直到 2025 年 1 月 1 日的对象保留配置。
```
aws s3api put-object-retention \
--bucket amzn-s3-demo-bucket-with-object-lock \
--key doc1.rtf \
--retention '{ "Mode": "GOVERNANCE", "RetainUntilDate": "2025-01-01T00:00:00" }'
```
此命令不生成任何输出。
+ 有关 API 的详细信息，请参阅*AWS CLI 命令参考[PutObjectRetention](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/put-object-retention.html)*中的。
### `put-public-access-block`
以下代码示例演示了如何使用 `put-public-access-block`。
**AWS CLI**
**为存储桶设置阻止公共访问配置**
以下 `put-public-access-block` 示例为指定存储桶设置限制性阻止公共访问配置。
```
aws s3api put-public-access-block \
--bucket amzn-s3-demo-bucket \
--public-access-block-configuration "BlockPublicAcls=true,IgnorePublicAcls=true,BlockPublicPolicy=true,RestrictPublicBuckets=true"
```
此命令不生成任何输出。
+ 有关 API 的详细信息，请参阅*AWS CLI 命令参考[PutPublicAccessBlock](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/put-public-access-block.html)*中的。
### `register-transit-gateway`
以下代码示例演示了如何使用 `register-transit-gateway`。
**AWS CLI**
**在全局网络中注册中转网关**
以下 `register-transit-gateway` 示例在指定全局网络中注册中转网关 `tgw-123abc05e04123abc`。
```
aws networkmanager register-transit-gateway \
--global-network-id global-network-01231231231231231 \
--transit-gateway-arn arn:aws:ec2:us-west-2:123456789012:transit-gateway/tgw-123abc05e04123abc \
--region us-west-2
```
输出：
```
{
"TransitGatewayRegistration": {
"GlobalNetworkId": "global-network-01231231231231231",
"TransitGatewayArn": "arn:aws:ec2:us-west-2:123456789012:transit-gateway/tgw-123abc05e04123abc",
"State": {
"Code": "PENDING"
}
}
}
```
有关更多信息，请参阅《Transit Gateway Network Manager 指南》**中的[中转网关注册](https://docs.aws.amazon.com/vpc/latest/tgw/tgw-registrations.html)。
+ 有关 API 的详细信息，请参阅*AWS CLI 命令参考[RegisterTransitGateway](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/register-transit-gateway.html)*中的。
### `reject-attachment`
以下代码示例演示了如何使用 `reject-attachment`。
**AWS CLI**
**拒绝挂载**
以下 `reject-attachment` 示例拒绝 VPC 挂载请求。
```
aws networkmanager reject-attachment \
--attachment-id attachment-03b7ea450134787da
```
输出：
```
{
"Attachment": {
"CoreNetworkId": "core-network-0522de1b226a5d7b3",
"AttachmentId": "attachment-03b7ea450134787da",
"OwnerAccountId": "987654321012",
"AttachmentType": "VPC",
"State": "AVAILABLE",
"EdgeLocation": "us-east-1",
"ResourceArn": "arn:aws:ec2:us-east-1:987654321012:vpc/vpc-a7c4bbda",
"CreatedAt": "2022-03-11T17:48:58+00:00",
"UpdatedAt": "2022-03-11T17:51:25+00:00"
}
}
```
有关更多信息，请参阅《Cloud WAN 用户指南》**中的[接受挂载](https://docs.aws.amazon.com/vpc/latest/cloudwan/cloudwan-attachments-working-with.html#cloudwan-attachments-acceptance)。
+ 有关 API 的详细信息，请参阅*AWS CLI 命令参考[RejectAttachment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/reject-attachment.html)*中的。
### `start-route-analysis`
以下代码示例演示了如何使用 `start-route-analysis`。
**AWS CLI**
**启动路由分析**
以下 `start-route-analysis` 示例启动源和目标之间的分析，包括可选的 `include-return-path`。
```
aws networkmanager start-route-analysis \
--global-network-id global-network-00aa0aaa0b0aaa000 \
--source TransitGatewayAttachmentArn=arn:aws:ec2:us-east-1:503089527312:transit-gateway-attachment/tgw-attach-0d4a2d491bf68c093,IpAddress=10.0.0.0 \
--destination TransitGatewayAttachmentArn=arn:aws:ec2:us-west-1:503089527312:transit-gateway-attachment/tgw-attach-002577f30bb181742,IpAddress=11.0.0.0 \
--include-return-path
```
输出：
```
{
"RouteAnalysis": {
"GlobalNetworkId": "global-network-00aa0aaa0b0aaa000
"OwnerAccountId": "1111222233333",
"RouteAnalysisId": "a1873de1-273c-470c-1a2bc2345678",
"StartTimestamp": 1695760154.0,
"Status": "RUNNING",
"Source": {
"TransitGatewayAttachmentArn": "arn:aws:ec2:us-east-1:111122223333:transit-gateway-attachment/tgw-attach-1234567890abcdef0,
"TransitGatewayArn": "arn:aws:ec2:us-east-1:111122223333:transit-gateway/tgw-abcdef01234567890",
"IpAddress": "10.0.0.0"
},
"Destination": {
"TransitGatewayAttachmentArn": "arn:aws:ec2:us-west-1:555555555555:transit-gateway-attachment/tgw-attach-021345abcdef6789",
"TransitGatewayArn": "arn:aws:ec2:us-west-1:111122223333:transit-gateway/tgw-09876543210fedcba0",
"IpAddress": "11.0.0.0"
},
"IncludeReturnPath": true,
"UseMiddleboxes": false
}
}
```
有关更多信息，请参阅《AWS Global Networks for Transit Gateways 用户指南》**中的[路由分析器](https://docs.aws.amazon.com/network-manager/latest/tgwnm/route-analyzer.html)。
+ 有关 API 的详细信息，请参阅*AWS CLI 命令参考[StartRouteAnalysis](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/start-route-analysis.html)*中的。
### `tag-resource`
以下代码示例演示了如何使用 `tag-resource`。
**AWS CLI**
**将标签应用于资源**
以下 `tag-resource` 示例将标签 `Network=Northeast` 应用于设备 `device-07f6fd08867abc123`。
```
aws networkmanager tag-resource \
--resource-arn arn:aws:networkmanager::123456789012:device/global-network-01231231231231231/device-07f6fd08867abc123 \
--tags Key=Network,Value=Northeast \
--region us-west-2
```
此命令不生成任何输出。
+ 有关 API 的详细信息，请参阅*AWS CLI 命令参考[TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/tag-resource.html)*中的。
### `untag-resource`
以下代码示例演示了如何使用 `untag-resource`。
**AWS CLI**
**从资源中删除标签**
以下 `untag-resource` 示例从设备 `device-07f6fd08867abc123` 移除键为 `Network` 的标签。
```
aws networkmanager untag-resource \
--resource-arn arn:aws:networkmanager::123456789012:device/global-network-01231231231231231/device-07f6fd08867abc123 ]
--tag-keys Network \
--region us-west-2
```
此命令不生成任何输出。
+ 有关 API 的详细信息，请参阅*AWS CLI 命令参考[UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/untag-resource.html)*中的。
### `update-device`
以下代码示例演示了如何使用 `update-device`。
**AWS CLI**
**更新设备**
以下 `update-device` 示例通过为设备 `device-07f6fd08867abc123` 指定站点 ID 来更新设备。
```
aws networkmanager update-device \
--global-network-id global-network-01231231231231231 \
--device-id device-07f6fd08867abc123 \
--site-id site-444555aaabbb11223 \
--region us-west-2
```
输出：
```
{
"Device": {
"DeviceId": "device-07f6fd08867abc123",
"DeviceArn": "arn:aws:networkmanager::123456789012:device/global-network-01231231231231231/device-07f6fd08867abc123",
"GlobalNetworkId": "global-network-01231231231231231",
"Description": "NY office device",
"Type": "Office device",
"Vendor": "anycompany",
"Model": "abcabc",
"SerialNumber": "1234",
"SiteId": "site-444555aaabbb11223",
"CreatedAt": 1575554005.0,
"State": "UPDATING"
}
}
```
有关更多信息，请参阅《Transit Gateway Network Manager 指南》中的**[使用设备](https://docs.aws.amazon.com/vpc/latest/tgw/on-premises-networks.html#working-with-devices)。
+ 有关 API 的详细信息，请参阅*AWS CLI 命令参考[UpdateDevice](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/update-device.html)*中的。
### `update-global-network`
以下代码示例演示了如何使用 `update-global-network`。
**AWS CLI**
**更新全局网络**
以下 `update-global-network` 示例更新全局网络 `global-network-01231231231231231` 的描述。
```
aws networkmanager update-global-network \
--global-network-id global-network-01231231231231231 \
--description "Head offices" \
--region us-west-2
```
输出：
```
{
"GlobalNetwork": {
"GlobalNetworkId": "global-network-01231231231231231",
"GlobalNetworkArn": "arn:aws:networkmanager::123456789012:global-network/global-network-01231231231231231",
"Description": "Head offices",
"CreatedAt": 1575553525.0,
"State": "UPDATING"
}
}
```
有关更多信息，请参阅《Transit Gateway Network Manager 指南》**中的[全局网络](https://docs.aws.amazon.com/vpc/latest/tgw/global-networks.html)。
+ 有关 API 的详细信息，请参阅*AWS CLI 命令参考[UpdateGlobalNetwork](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/update-global-network.html)*中的。
### `update-link`
以下代码示例演示了如何使用 `update-link`。
**AWS CLI**
**更新链接**
以下 `update-link` 示例更新链接 `link-11112222aaaabbbb1` 的带宽信息。
```
aws networkmanager update-link \
--global-network-id global-network-01231231231231231 \
--link-id link-11112222aaaabbbb1 \
--bandwidth UploadSpeed=20,DownloadSpeed=20 \
--region us-west-2
```
输出：
```
{
"Link": {
"LinkId": "link-11112222aaaabbbb1",
"LinkArn": "arn:aws:networkmanager::123456789012:link/global-network-01231231231231231/link-11112222aaaabbbb1",
"GlobalNetworkId": "global-network-01231231231231231",
"SiteId": "site-444555aaabbb11223",
"Description": "VPN Link",
"Type": "broadband",
"Bandwidth": {
"UploadSpeed": 20,
"DownloadSpeed": 20
},
"Provider": "AnyCompany",
"CreatedAt": 1575555811.0,
"State": "UPDATING"
}
}
```
有关更多信息，请参阅《Transit Gateway Network Manager 指南》**中的[使用链接](https://docs.aws.amazon.com/vpc/latest/tgw/on-premises-networks.html#working-with-links)。
+ 有关 API 的详细信息，请参阅*AWS CLI 命令参考[UpdateLink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/update-link.html)*中的。
### `update-site`
以下代码示例演示了如何使用 `update-site`。
**AWS CLI**
**更新站点**
以下 `update-site` 示例更新指定全局网络中站点 `site-444555aaabbb11223` 的描述。
```
aws networkmanager update-site \
--global-network-id global-network-01231231231231231 \
--site-id site-444555aaabbb11223 \
--description "New York Office site" \
--region us-west-2
```
输出：
```
{
"Site": {
"SiteId": "site-444555aaabbb11223",
"SiteArn": "arn:aws:networkmanager::123456789012:site/global-network-01231231231231231/site-444555aaabbb11223",
"GlobalNetworkId": "global-network-01231231231231231",
"Description": "New York Office site",
"Location": {
"Latitude": "40.7128",
"Longitude": "-74.0060"
},
"CreatedAt": 1575554528.0,
"State": "UPDATING"
}
}
```
有关更多信息，请参阅《Transit Gateway Network Manager 指南》**中的[使用站点](https://docs.aws.amazon.com/vpc/latest/tgw/on-premises-networks.html#working-with-sites)。
+ 有关 API 的详细信息，请参阅*AWS CLI 命令参考[UpdateSite](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/update-site.html)*中的。