本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 使用 的 Network Manager 範例 AWS CLI
下列程式碼範例示範如何使用 AWS Command Line Interface 搭配 Network Manager 來執行動作和實作常見案例。
*Actions* 是大型程式的程式碼摘錄，必須在內容中執行。雖然動作會告訴您如何呼叫個別服務函數，但您可以在其相關情境中查看內容中的動作。
每個範例均包含完整原始碼的連結，您可在連結中找到如何設定和執行內容中程式碼的相關指示。
**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"
}
}
```
如需詳細資訊，請參閱《傳輸閘道網路管理員指南》**中的[客戶閘道關聯](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"
}
}
```
如需詳細資訊，請參閱《傳輸閘道網路管理員指南》**中的[裝置與連結關聯](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"
}
}
```
如需詳細資訊，請參閱《傳輸閘道網路管理員指南》**中的[使用裝置](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` 範例會刪除 Connect 連接。
```
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"
}
}
```
如需詳細資訊，請參閱《傳輸閘道網路管理員指南》**中的[使用裝置](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 指南》**中的 [Transit Gateway 註冊](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"
}
}
```
如需詳細資訊，請參閱《傳輸閘道網路管理員指南》**中的[客戶閘道關聯](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"
}
}
```
如需詳細資訊，請參閱《傳輸閘道網路管理員指南》**中的[裝置與連結關聯](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-01-01。
```
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 指南》**中的 [Transit Gateway 註冊](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
}
}
```
如需詳細資訊，請參閱《適用於 Transit Gateways 的AWS 全球網路使用者指南》**中的[路由分析器](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` 範例會透過指定裝置的網站 ID 來更新裝置 `device-07f6fd08867abc123`。
```
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"
}
}
```
如需詳細資訊，請參閱《傳輸閘道網路管理員指南》**中的[使用裝置](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)。