網路管理員範例使用 AWS CLI - AWS Command Line Interface

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

網路管理員範例使用 AWS CLI

下列程式碼範例說明如何使用 Network Manager 來執行動作和實作常見案例。 AWS Command Line Interface

Actions 是大型程式的程式碼摘錄,必須在內容中執行。雖然動作會告訴您如何呼叫個別服務函數,但您可以在其相關情境和跨服務範例中查看內容中的動作。

Scenarios (案例) 是向您展示如何呼叫相同服務中的多個函數來完成特定任務的程式碼範例。

每個範例都包含一個連結 GitHub,您可以在其中找到如何在內容中設定和執行程式碼的指示。

主題

動作

下列程式碼範例會示範如何使用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" } }

如需詳細資訊,請參閱傳輸閘道網路管理員指南中的客戶閘道關聯

下列程式碼範例會示範如何使用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 網路管理員指南中的裝置和連結關聯

  • 如需 API 詳細資訊,請參閱AWS CLI 命令參考AssociateLink中的。

下列程式碼範例會示範如何使用create-core-network

AWS CLI

若要建立核心網路

下列create-core-network範例會在 AWS Cloud WAN 全域網路中使用選擇性描述和標籤來建立核心網路。

aws networkmanager create-core-network \ --global-network-id global-network-0d59060f16a73bc41\ --description "Main headquarters location"\ --tags Key=Name,Value="New York City office"

輸出:

{ "CoreNetwork": { "GlobalNetworkId": "global-network-0d59060f16a73bc41", "CoreNetworkId": "core-network-0fab62fe438d94db6", "CoreNetworkArn": "arn:aws:networkmanager::987654321012:core-network/core-network-0fab62fe438d94db6", "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 使用者指南中的核心網路

下列程式碼範例會示範如何使用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 網路管理員指南中的使用裝置

  • 如需 API 詳細資訊,請參閱AWS CLI 命令參考CreateDevice中的。

下列程式碼範例會示範如何使用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" } }

下列程式碼範例會示範如何使用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 網路管理員指南中的使用連結。

  • 如需 API 詳細資訊,請參閱AWS CLI 命令參考CreateLink中的。

下列程式碼範例會示範如何使用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 網路管理員指南中的使用站台。

  • 如需 API 詳細資訊,請參閱AWS CLI 命令參考CreateSite中的。

下列程式碼範例會示範如何使用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 使用指南中的建立附件

下列程式碼範例會示範如何使用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 使用手冊》中的「刪除附件」。

  • 如需 API 詳細資訊,請參閱AWS CLI 命令參考DeleteAttachment中的。

下列程式碼範例會示範如何使用delete-bucket-analytics-configuration

AWS CLI

若要刪除值區的分析設定

下列delete-bucket-analytics-configuration範例會移除指定值區和 ID 的分析設定。

aws s3api delete-bucket-analytics-configuration \ --bucket my-bucket \ --id 1

此命令不會產生輸出。

下列程式碼範例會示範如何使用delete-bucket-metrics-configuration

AWS CLI

若要刪除值區的指標組態

下列delete-bucket-metrics-configuration範例會移除指定值區和 ID 的指標組態。

aws s3api delete-bucket-metrics-configuration \ --bucket my-bucket \ --id 123

此命令不會產生輸出。

下列程式碼範例會示範如何使用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 使用者指南中的核心網路

下列程式碼範例會示範如何使用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 網路管理員指南中的使用裝置

  • 如需 API 詳細資訊,請參閱AWS CLI 命令參考DeleteDevice中的。

下列程式碼範例會示範如何使用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" } }

下列程式碼範例會示範如何使用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 網路管理員指南中的使用連結。

  • 如需 API 詳細資訊,請參閱AWS CLI 命令參考DeleteLink中的。

下列程式碼範例會示範如何使用delete-public-access-block

AWS CLI

刪除值區的區塊公用存取設定

下列delete-public-access-block範例會移除指定值區上的區塊公用存取設定。

aws s3api delete-public-access-block \ --bucket my-bucket

此命令不會產生輸出。

下列程式碼範例會示範如何使用delete-site

AWS CLI

刪除網站的步驟

下列delete-site範例會刪除指定的全域網路中指定的 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 網路管理員指南中的使用站台。

  • 如需 API 詳細資訊,請參閱AWS CLI 命令參考DeleteSite中的。

下列程式碼範例會示範如何使用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 網路管理員指南中的 Transit Gateway 註冊

下列程式碼範例會示範如何使用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" } ] }

下列程式碼範例會示範如何使用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" } }

如需詳細資訊,請參閱傳輸閘道網路管理員指南中的客戶閘道關聯

下列程式碼範例會示範如何使用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 網路管理員指南中的裝置和連結關聯

  • 如需 API 詳細資訊,請參閱AWS CLI 命令參考DisassociateLink中的。

下列程式碼範例會示範如何使用get-bucket-analytics-configuration

AWS CLI

若要擷取具有特定 ID 的值區的分析設定

下列get-bucket-analytics-configuration範例會顯示指定值區和 ID 的分析設定。

aws s3api get-bucket-analytics-configuration \ --bucket my-bucket \ --id 1

輸出:

{ "AnalyticsConfiguration": { "StorageClassAnalysis": {}, "Id": "1" } }

下列程式碼範例會示範如何使用get-bucket-metrics-configuration

AWS CLI

若要擷取具有特定 ID 的值區的指標組態

下列get-bucket-metrics-configuration範例顯示指定值區和 ID 的指標組態。

aws s3api get-bucket-metrics-configuration \ --bucket my-bucket \ --id 123

輸出:

{ "MetricsConfiguration": { "Filter": { "Prefix": "logs" }, "Id": "123" } }

下列程式碼範例會示範如何使用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" } ] }

下列程式碼範例會示範如何使用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中的。

下列程式碼範例會示範如何使用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" } ] }

下列程式碼範例會示範如何使用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中的。

下列程式碼範例會示範如何使用get-object-retention

AWS CLI

若要擷取物件的物件保留組態

下列get-object-retention範例會擷取指定物件的物件保留組態。

aws s3api get-object-retention \ --bucket my-bucket-with-object-lock \ --key doc1.rtf

輸出:

{ "Retention": { "Mode": "GOVERNANCE", "RetainUntilDate": "2025-01-01T00:00:00.000Z" } }

下列程式碼範例會示範如何使用get-public-access-block

AWS CLI

設定或修改值區的區塊公用存取設定

下列get-public-access-block範例會顯示指定值區的區塊公用存取設定。

aws s3api get-public-access-block --bucket my-bucket

輸出:

{ "PublicAccessBlockConfiguration": { "IgnorePublicAcls": true, "BlockPublicPolicy": true, "BlockPublicAcls": true, "RestrictPublicBuckets": true } }

下列程式碼範例會示範如何使用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中的。

下列程式碼範例會示範如何使用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" } } ] }

下列程式碼範例會示範如何使用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 使用者指南中的附件

  • 如需 API 詳細資訊,請參閱AWS CLI 命令參考GetVpcAttachment中的。

下列程式碼範例會示範如何使用list-bucket-analytics-configurations

AWS CLI

擷取值區的分析設定清單

以下內容list-bucket-analytics-configurations會擷取指定值區的分析組態清單。

aws s3api list-bucket-analytics-configurations \ --bucket my-bucket

輸出:

{ "AnalyticsConfigurationList": [ { "StorageClassAnalysis": {}, "Id": "1" } ], "IsTruncated": false }

下列程式碼範例會示範如何使用list-bucket-metrics-configurations

AWS CLI

擷取值區的指標組態清單

下列list-bucket-metrics-configurations範例會擷取指定值區的量度組態清單。

aws s3api list-bucket-metrics-configurations \ --bucket my-bucket

輸出:

{ "IsTruncated": false, "MetricsConfigurationList": [ { "Filter": { "Prefix": "logs" }, "Id": "123" }, { "Filter": { "Prefix": "tmp" }, "Id": "234" } ] }

下列程式碼範例會示範如何使用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" } ] }

下列程式碼範例會示範如何使用put-bucket-metrics-configuration

AWS CLI

若要設定值區的指標組態

下列put-bucket-metrics-configuration範例會為指定值區設定識別碼為 123 的度量組態。

aws s3api put-bucket-metrics-configuration \ --bucket my-bucket \ --id 123 \ --metrics-configuration '{"Id": "123", "Filter": {"Prefix": "logs"}}'

此命令不會產生輸出。

下列程式碼範例會示範如何使用put-object-retention

AWS CLI

若要設定物件的物件保留組態

下列put-object-retention範例會設定指定物件的物件保留組態,直到 2025-01-01 為止。

aws s3api put-object-retention \ --bucket my-bucket-with-object-lock \ --key doc1.rtf \ --retention '{ "Mode": "GOVERNANCE", "RetainUntilDate": "2025-01-01T00:00:00" }'

此命令不會產生輸出。

下列程式碼範例會示範如何使用put-public-access-block

AWS CLI

設定值區的區塊公用存取設定

下列put-public-access-block範例會為指定值區設定限制性區塊公用存取設定。

aws s3api put-public-access-block \ --bucket my-bucket \ --public-access-block-configuration "BlockPublicAcls=true,IgnorePublicAcls=true,BlockPublicPolicy=true,RestrictPublicBuckets=true"

此命令不會產生輸出。

下列程式碼範例會示範如何使用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 網路管理員指南中的 Transit Gateway 註冊

下列程式碼範例會示範如何使用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 使用者指南中的附件接受程度

  • 如需 API 詳細資訊,請參閱AWS CLI 命令參考RejectAttachment中的。

下列程式碼範例會示範如何使用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 全球網路使用指南中的路由分析器

下列程式碼範例會示範如何使用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中的。

下列程式碼範例會示範如何使用untag-resource

AWS CLI

若要從資源中移除標籤

下列untag-resource範例會從裝置移除含有金鑰Network的標籤device-07f6fd08867abc123

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中的。

下列程式碼範例會示範如何使用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 網路管理員指南中的使用裝置

  • 如需 API 詳細資訊,請參閱AWS CLI 命令參考UpdateDevice中的。

下列程式碼範例會示範如何使用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 網路管理員指南中的球網路

下列程式碼範例會示範如何使用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 網路管理員指南中的使用連結。

  • 如需 API 詳細資訊,請參閱AWS CLI 命令參考UpdateLink中的。

下列程式碼範例會示範如何使用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 網路管理員指南中的使用站台。

  • 如需 API 詳細資訊,請參閱AWS CLI 命令參考UpdateSite中的。