를 사용한 Network Manager 예제 AWS CLI - AWS Command Line Interface

이 설명서는 의 버전 1 AWS CLI 전용입니다. 의 버전 2와 관련된 설명서는 버전 2 사용 설명서 를 AWS CLI참조하세요.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

를 사용한 Network Manager 예제 AWS CLI

다음 코드 예제에서는 Network Manager AWS Command Line Interface 와 함께 를 사용하여 작업을 수행하고 일반적인 시나리오를 구현하는 방법을 보여줍니다.

작업은 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 작업은 개별 서비스 함수를 직접적으로 호출하는 방법을 보여주며 관련 시나리오의 컨텍스트에 맞는 작업을 볼 수 있습니다.

각 예제에는 컨텍스트에서 코드를 설정하고 실행하는 방법에 대한 지침을 찾을 수 있는 전체 소스 코드에 대한 링크가 포함되어 있습니다.

주제

작업

다음 코드 예시에서는 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 안내서의 Customer Gateway Associations를 참조하세요.

다음 코드 예시에서는 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 가이드디바이스 및 링크 연결을 참조하세요.

  • 자세한 API 내용은 명령 참조AssociateLink의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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 클라우드 WAN 사용 설명서글로벌 및 코어 네트워크를 참조하세요.

  • 자세한 API 내용은 명령 참조CreateCoreNetwork의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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 가이드디바이스 작업을 참조하세요.

  • 자세한 API 내용은 명령 참조CreateDevice의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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 내용은 명령 참조CreateGlobalNetwork의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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 가이드링크 작업을 참조하세요.

  • 자세한 API 내용은 명령 참조CreateLink의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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 가이드사이트 작업을 참조하세요.

  • 자세한 API 내용은 명령 참조CreateSite의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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 } } }

자세한 내용은 클라우드 WAN 사용 설명서첨부 파일 생성을 참조하세요.

  • 자세한 API 내용은 명령 참조CreateVpcAttachment의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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" } }

자세한 내용은 클라우드 WAN 사용 설명서첨부 파일 삭제를 참조하세요.

  • 자세한 API 내용은 명령 참조DeleteAttachment의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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": [] } ] } }

자세한 내용은 클라우드 WAN 사용 설명서코어 네트워크를 참조하세요.

  • 자세한 API 내용은 명령 참조DeleteCoreNetwork의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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 가이드디바이스 작업을 참조하세요.

  • 자세한 API 내용은 명령 참조DeleteDevice의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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 내용은 명령 참조DeleteGlobalNetwork의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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 가이드링크 작업을 참조하세요.

  • 자세한 API 내용은 명령 참조DeleteLink의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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-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 가이드사이트 작업을 참조하세요.

  • 자세한 API 내용은 명령 참조DeleteSite의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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 등록 참조하세요.

다음 코드 예시에서는 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" } }

자세한 내용은 Transit Gateway Network Manager 안내서의 Customer Gateway Associations를 참조하세요.

다음 코드 예시에서는 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 가이드디바이스 및 링크 연결을 참조하세요.

  • 자세한 API 내용은 명령 참조DisassociateLink의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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 내용은 명령 참조GetDevices의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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 내용은 명령 참조GetLinkAssociations의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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 내용은 명령 참조GetLinks의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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" } }
  • 자세한 API 내용은 명령 참조GetObjectRetention의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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 내용은 명령 참조GetSites의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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 } } }

자세한 내용은 클라우드 WAN 사용 설명서첨부 파일을 참조하세요.

  • 자세한 API 내용은 명령 참조GetVpcAttachment의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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" } ] }
  • 자세한 API 내용은 명령 참조ListTagsForResource의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 put-bucket-metrics-configuration을 사용하는 방법을 보여 줍니다.

AWS CLI

버킷에 대한 지표 구성을 설정하려면

다음 put-bucket-metrics-configuration 예제에서는 지정된 버킷에 대해 ID 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" }'

이 명령은 출력을 생성하지 않습니다.

  • 자세한 API 내용은 명령 참조PutObjectRetention의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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 Network Manager 가이드의 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" } }

자세한 내용은 클라우드 WAN 사용 설명서첨부 파일 수락을 참조하세요.

  • 자세한 API 내용은 명령 참조RejectAttachment의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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용 글로벌 네트워크 사용 설명서의 Route Analyzer를 참조하세요. AWS

  • 자세한 API 내용은 명령 참조StartRouteAnalysis의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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 내용은 명령 참조TagResource의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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 내용은 명령 참조UntagResource의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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" } }

자세한 내용은 Transit Gateway Network Manager 가이드디바이스 작업을 참조하세요.

  • 자세한 API 내용은 명령 참조UpdateDevice의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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 가이드글로벌 네트워크를 참조하세요.

  • 자세한 API 내용은 명령 참조UpdateGlobalNetwork의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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 가이드링크 작업을 참조하세요.

  • 자세한 API 내용은 명령 참조UpdateLink의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 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 가이드사이트 작업을 참조하세요.

  • 자세한 API 내용은 명령 참조UpdateSite의 섹션을 참조하세요. AWS CLI