Snow Family 디바이스에서 Amazon EC2 호환 엔드포인트 사용 - AWS Snowball Edge 개발자 가이드
EC2호환 가능한 엔드포인트를 엔드포인트로 지정 AWS CLI 지원되는 EC2 호환 명령 AWS CLI Amazon EC2 호환 작업 API 지원

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

Snow Family 디바이스에서 Amazon EC2 호환 엔드포인트 사용

다음은 Amazon EC2 호환 엔드포인트의 개요를 확인할 수 있습니다. 이 엔드포인트를 사용하면 Amazon Machine Images (AMIs) 를 관리하고 Amazon EC2 호환 API 작업을 사용하여 프로그래밍 방식으로 인스턴스를 계산할 수 있습니다.

EC2-호환 가능한 엔드포인트를 Snow Family 디바이스의 AWS CLI 엔드포인트로 지정

를 사용하여 AWS Snowball Edge 디바이스에 명령을 실행할 때 엔드포인트가 Amazon EC2 호환 엔드포인트가 되도록 지정할 수 있습니다. AWS CLI 다음과 같이 엔드포인트 또는 비보안 HTTPS HTTP 엔드포인트를 사용할 수 있습니다.

HTTPS보안 엔드포인트

aws ec2 describe-instances --endpoint https://192.0.2.0:8243 --ca-bundle path/to/certificate

HTTP보안되지 않은 엔드포인트

aws ec2 describe-instances --endpoint http://192.0.2.0:8008

의 HTTPS 8243 엔드포인트를 사용하는 경우 전송 중인 데이터가 암호화됩니다. 이 암호화는 Snowball Edge가 잠금 해제될 때마다 생성하는 인증서로 보장됩니다. 인증서가 생기면 이를 로컬 ca-bundle.pem 파일에 저장할 수 있습니다. 그런 다음, 다음 설명과 같이 인증서 경로를 포함하도록 AWS CLI 프로필을 구성할 수 있습니다.

인증서를 Amazon EC2 호환 엔드포인트와 연결하려면

  1. Snowball Edge를 전원과 네트워크에 연결한 후 켭니다.

  2. 디바이스의 잠금 해제가 완료되면 로컬 네트워크상의 IP 주소를 적어 둡니다.

  3. 네트워크의 터미널에서 Snowball Edge를 ping할 수 있는지 확인합니다.

  4. 터미널에서 snowballEdge get-certificate 명령을 실행합니다. 이 명령에 대한 자세한 내용은 Snow Family 디바이스의 공개 키 인증서 관리 섹션을 참조하세요.

  5. snowballEdge get-certificate 명령의 출력을 파일(예: ca-bundle.pem)에 저장합니다.

  6. 터미널에서 다음 명령을 실행합니다.

    aws configure set profile.snowballEdge.ca_bundle /path/to/ca-bundle.pem

절차를 완료한 후 이러한 로컬 자격 증명, 인증서 및 지정된 엔드포인트를 CLI 사용하여 명령을 실행할 수 있습니다.

Snow 패밀리 디바이스에서 Amazon EC2 호환 AWS CLI 명령 지원

Amazon EC2 호환 엔드포인트를 통해 Snow Family 디바이스의 컴퓨팅 인스턴스를 관리할 수 있습니다. 이 유형의 엔드포인트는 의 많은 Amazon EC2 CLI 명령 및 작업을 지원합니다 AWS SDKs. AWS CLI 전화를 걸 대상을 지정하는 AWS 리전 것을 AWS CLI포함하여 설치 및 설정에 대한 자세한 내용은 AWS Command Line Interface 사용 설명서를 참조하십시오.

Snow Family 디바이스에서 지원되는 EC2 호환 AWS CLI 명령 목록

다음은 Snowball Edge 디바이스에서 지원되는 Amazon AWS CLI EC2 명령 및 옵션의 하위 집합에 대한 설명을 확인할 수 있습니다. 아래에 나열되지 않은 명령이나 옵션은 지원되지 않습니다. 명령과 함께 지원되지 않는 옵션을 선언할 수 있습니다. 하지만 이러한 옵션은 무시됩니다.

  • associate-address – 가상 IP 주소를 디바이스의 물리적 네트워크 인터페이스 3개 중 하나에 사용되는 인스턴스와 연결합니다.

    • --instance-id – 단일 sbe 인스턴스의 ID입니다.

    • --public-ip – 인스턴스에 액세스하기 위해 사용할 가상 IP 주소입니다.

  • attach-volume — Amazon EBS 볼륨을 디바이스에서 중지되거나 실행 중인 인스턴스에 연결하고 지정된 디바이스 이름을 가진 인스턴스에 노출합니다.

    • --device value - 디바이스의 이름입니다.

    • --instance-id — 대상 아마존 호환 인스턴스의 ID입니다. EC2

    • --볼륨-id — value 볼륨의 ID입니다. EBS

  • authorize-security-group-egress— Snowball Edge 디바이스와 함께 사용할 하나 이상의 송신 규칙을 보안 그룹에 추가합니다. 특히 이 작업을 통해 인스턴스는 하나 이상의 대상 IPv4 CIDR 주소 범위로 트래픽을 전송할 수 있습니다. 자세한 내용은 Snow Family 디바이스의 보안 그룹을 통해 네트워크 트래픽을 제어합니다. 단원을 참조하십시오.

    • --group-id value - 보안 그룹의 ID입니다.

    • [--ip-permissions value] - 하나 이상의 IP 권한 집합입니다.

  • authorize-security-group-ingress— 보안 그룹에 하나 이상의 인그레스 규칙을 추가합니다. authorize-security-group-ingress 호출 시 group-name 또는 group-id에 대한 값을 지정해야 합니다.

    • [--group-name value] - 보안 그룹의 이름입니다.

    • [--group-id value] - 보안 그룹의 ID입니다.

    • [--ip-permissions value] - 하나 이상의 IP 권한 집합입니다.

    • [--protocol value] IP 프로토콜. 가능한 값은 tcp, udp 및 icmp입니다. "모든 프로토콜" 값이 지정되지 않는 한(-1) --port 인수가 필요합니다.

    • [--portvalue] — TCP 또는UDP, 허용할 포트 범위입니다. 이 값은 단일 정수 또는 범위(최소~최대)일 수 있습니다.

      F의 경우ICMP, 단일 정수 또는 ICMP 유형 번호를 나타내고 code ICMP 코드 번호를 type 나타내는 범위 (type-code) 입니다. 값이 -1이면 모든 ICMP 유형의 모든 ICMP 코드를 나타냅니다. for 값만 -1이면 지정된 ICMP 유형의 모든 ICMP 코드를 type 나타냅니다.

    • [--cidrvalue] — CIDR IP 범위입니다.

  • create-launch-template— 시작 템플릿을 만듭니다. 시작 템플릿에는 인스턴스를 시작하기 위한 파라미터가 포함되어 있습니다. RunInstances를 사용하여 인스턴스를 시작하면 요청에 시작 파라미터를 제공하는 대신 시작 템플릿을 지정할 수 있습니다. 디바이스당 최대 100개의 템플릿을 생성할 수 있습니다.

    • launch-template-name string-- 시작 템플릿의 이름.

    • -- launch-template-data structure — 시작 템플릿에 대한 정보. 다음과 같은 속성이 지원됩니다.

      • ImageId

      • InstanceType

      • SecurityGroupIds

      • TagSpecifications

      • UserData

      JSON구문:

      {
    "ImageId":"string",
    "InstanceType":"sbe-c.large",
    "SecurityGroupIds":["string", ...],
    "TagSpecifications":[{"ResourceType":"instance","Tags":[{"Key":"Name","Value":"Test"},
    {"Key":"Stack","Value":"Gamma"}]}],
    "UserData":"this is my user data"
}

    • [--version-description string] - 시작 템플릿의 첫 번째 버전에 대한 설명입니다.

    • --endpoint snowballEndpoint — Amazon EC2 호환 API 작업을 사용하여 프로그래밍 방식으로 컴퓨팅 인스턴스를 관리할 수 있게 해주는 값입니다. 자세한 내용은 EC2-호환 가능한 엔드포인트를 Snow Family 디바이스의 AWS CLI 엔드포인트로 지정 단원을 참조하십시오.

  • create-launch-template-version— 시작 템플릿의 새 버전을 생성합니다. 새 버전을 기반으로 하는 시작 템플릿의 기존 버전을 지정할 수 있습니다. 시작 템플릿 버전은 생성한 순서대로 번호가 지정됩니다. 시작 템플릿 버전의 숫자는 지정, 변경 또는 대체할 수 없습니다. 각 시작 템플릿의 버전을 최대 100개까지 생성할 수 있습니다.

    요청에서 시작 템플릿 ID 또는 시작 템플릿 이름을 지정합니다.

    • -- launch-template-id string — 시작 템플릿의 ID.

    • -- launch-template-name string — 시작 템플릿의 이름.

    • -- launch-template-data structure — 시작 템플릿에 대한 정보. 다음과 같은 속성이 지원됩니다.

      • ImageId

      • InstanceType

      • SecurityGroupIds

      • TagSpecifications

      • UserData

      JSON구문:

      {
    "ImageId":"string",
    "InstanceType":"sbe-c.large",
    "SecurityGroupIds":["string", ...],
    "TagSpecifications":[{"ResourceType":"instance","Tags":[{"Key":"Name","Value":"Test"},
     {"Key":"Stack","Value":"Gamma"}]}],
    "UserData":"this is my user data"
}

    • [--source-version string] - 새 버전을 기반으로 하는 시작 템플릿의 버전 번호입니다. 새 버전은 launch-template-data에 지정된 파라미터를 제외하고 소스 버전과 동일한 시작 파라미터를 상속합니다.

    • [--version-description string] - 시작 템플릿의 첫 번째 버전에 대한 설명입니다.

    • --endpoint snowballEndpoint — Amazon EC2 호환 API 작업을 사용하여 프로그래밍 방식으로 컴퓨팅 인스턴스를 관리할 수 있게 해주는 값입니다. 자세한 내용은 EC2-호환 가능한 엔드포인트를 Snow Family 디바이스의 AWS CLI 엔드포인트로 지정 단원을 참조하십시오.

  • create-tags - 지정된 리소스에 대해 하나 이상의 태그를 추가하거나 덮어씁니다. 각 리소스는 최대 50개의 태그를 보유할 수 있습니다. 각 태그는 키와 값(선택 사항)으로 구성됩니다. 태그 키는 리소스에 대해 고유해야 합니다. 다음 리소스가 지원됩니다.

    • AMI

    • Instance

    • 시작 템플릿

    • 보안 그룹

    • 키 페어

  • create-security-group— Snowball Edge에 보안 그룹을 생성합니다. 최대 50개의 보안 그룹을 생성할 수 있습니다. 보안 그룹을 생성할 때 친근한 이름을 직접 선택하여 지정합니다.

    • --group-name value – 보안 그룹의 이름입니다.

    • --description value – 보안 그룹의 설명입니다. 이는 참조용일 뿐입니다. 이 값의 최대 길이는 255자입니다.

  • create-volume — 디바이스의 인스턴스에 연결할 수 있는 Amazon EBS 볼륨을 생성합니다.

    • [--sizevalue] - 볼륨 크기 (단위) 로 GiBs, 1GiB에서 1TB ( GiBs1000) 사이일 수 있습니다.

    • [--snapshot-id value] - 볼륨이 생성되는 스냅샷의 ID입니다.

    • [--volume-type value] - 볼륨 유형입니다. 값을 지정하지 않을 경우 기본값은 sbg1입니다. 가능한 값은 다음을 포함합니다.

      • 마그네틱 볼륨인 sbg1

      • sbp1볼륨의 경우 SSD

    • [--tag-specification value] - 생성 중 볼륨에 적용되는 태그 목록입니다.

  • delete-launch-template— 시작 템플릿을 삭제합니다. 시작 템플릿을 삭제하면 모든 버전이 삭제됩니다.

    요청에서 시작 템플릿 ID 또는 시작 템플릿 이름을 지정합니다.

  • delete-launch-template-version— 시작 템플릿의 하나 이상의 버전을 삭제합니다. 시작 템플릿의 기본 버전은 삭제할 수 없으며, 먼저 다른 버전을 기본 버전으로 할당해야 합니다. 기본 버전이 시작 템플릿의 유일한 버전인 경우 delete-launch-template 명령을 사용하여 전체 시작 템플릿을 삭제합니다.

    요청에서 시작 템플릿 ID 또는 시작 템플릿 이름을 지정합니다.

    • -- launch-template-id string — 시작 템플릿의 ID.

    • -- launch-template-name string — 시작 템플릿의 이름.

    • --versions(list) "string" "string" - 삭제할 하나 이상의 시작 템플릿 버전에 대한 버전 번호입니다.

    • --endpoint snowballEndpoint — Amazon EC2 호환 API 작업을 사용하여 프로그래밍 방식으로 컴퓨팅 인스턴스를 관리할 수 있게 해주는 값입니다. 자세한 내용은 EC2-호환 가능한 엔드포인트를 Snow Family 디바이스의 AWS CLI 엔드포인트로 지정 단원을 참조하십시오.

  • delete-security-group— 보안 그룹을 삭제합니다.

    인스턴스와 연결된 보안 그룹이나 다른 보안 그룹에서 참조하는 보안 그룹의 삭제를 시도하는 경우 DependencyViolation으로 작업이 실패합니다.

    • --group-name value – 보안 그룹의 이름입니다.

    • --description value – 보안 그룹의 설명입니다. 이는 참조용일 뿐입니다. 이 값의 최대 길이는 255자입니다.

  • delete-tags - 지정된 리소스 (AMI, 컴퓨팅 인스턴스, 시작 템플릿 또는 보안 그룹) 에서 지정된 태그 세트를 삭제합니다.

  • 볼륨 삭제 — 지정된 Amazon 볼륨을 삭제합니다. EBS 이때 볼륨은 available 상태(인스턴스에 연결되지 않음)여야 합니다.

    • --volume-id value - 볼륨의 ID입니다.

  • describe-address - 디바이스에서 동일한 수의 sbe 인스턴스와 관련된 하나 이상의 가상 IP 주소를 설명합니다.

    • --public-ips - 인스턴스와 연결된 한 개 이상의 가상 IP 주소입니다.

  • 설명 이미지 — 사용할 수 있는 하나 이상의 이미지 () 를 설명합니다. AMIs 사용 가능한 이미지는 작업 생성 중에 Snowball Edge 디바이스에 추가됩니다.

    • --image-id — 의 AMI Snowball ID입니다. AMI

  • describe-instance-attribute— 지정된 인스턴스의 지정된 속성을 설명합니다. 힌 번에 하나의 속성만 지정할 수 있습니다. 다음과 같은 속성이 지원됩니다.

    • instanceInitiatedShutdownBehavior

    • instanceType

    • userData

  • describe-instances - 하나 이상의 인스턴스를 설명합니다. 응답은 인스턴스에 할당된 보안 그룹을 반환합니다.

    • --instance-ids — 디바이스에서 중지된 하나 이상의 sbe 인스턴스 IDs 중 하나입니다.

    • --page-size - 직접 호출을 받아들일 각 페이지의 크기입니다. 이 값은 명령의 출력을 통해 반환되는 항목의 수에는 영향을 미치지 않습니다. 페이지 크기를 더 작게 설정하면 디바이스에 대한 추가 호출이 이루어져 각 호출에서 더 적은 항목을 가져옵니다. 따라서 호출이 시간 초과되는 것을 방지하는 데 도움이 됩니다.

    • --max-items - 명령의 출력을 통해 반환될 항목의 총 수입니다. 사용 가능한 총 항목 수가 지정된 값을 초과하는 경우 명령의 출력에 NextToken이 제공됩니다. 페이지 매김을 재개하려면 후속 명령의 starting-token 인수에 NextToken 값을 제공합니다.

    • --starting-token - 페이지 매김을 시작할 위치를 지정하기 위한 토큰입니다. 이 토큰은 이전에 잘린 응답에서 도출된 NextToken 값입니다.

  • describe-instance-status— 지정된 인스턴스 또는 모든 인스턴스의 상태를 설명합니다. 모든 인스턴스의 상태를 반환하도록 특별히 지정하지 않는 한 기본적으로 실행 중인 인스턴스만 설명됩니다. 인스턴스 상태는 다음 구성 요소를 포함합니다.

    • 상태 확인 — Snow 디바이스는 Amazon EC2 호환 인스턴스 실행 시 상태 검사를 수행하여 하드웨어 및 소프트웨어 문제를 식별합니다.

    • 인스턴스 상태 - 인스턴스를 시작하는 순간부터 종료까지 인스턴스를 관리할 수 있습니다.

    이 명령에서는 다음 필터가 지원됩니다.

    • [--filters] (list)

      필터.

      • instance-state-code - 인스턴스 상태의 코드(16비트 부호 없는 정수). 상위 바이트는 내부 서비스 보고 용도로 사용되므로 무시해야 합니다. 하위 바이트는 표시된 상태를 기반으로 설정됩니다. 유효한 값은 0(보류 중), 16(실행 중), 32(종료 중), 48(종료됨), 64(중지 중), 80(중지됨)입니다.

      • instance-state-name – 인스턴스의 상태입니다(pending | running | shutting-down | terminated | stopping | stopped).

      • instance-status.reachability - 이름이 reachability인 인스턴스 상태를 기준으로 필터링합니다(passed | failed | initializing | insufficient-data).

      • instance-status.status – 인스턴스의 상태입니다(ok | impaired | initializing | insufficient-data | not-applicable).

      • system-status.reachability - 이름이 연결 가능 여부인 시스템 상태를 필터링합니다(passed | failed | initializing | insufficient-data).

      • system-status.status – 인스턴스의 시스템 상태입니다(ok | impaired | initializing | insufficient-data | not-applicable).

    • JSON구문:

      [
  {
    "Name": "string",
    "Values": ["string", ...]
  }
  ...
]

    • [--instance-ids] (list)

      인스턴스IDs.

      기본값: 모든 인스턴스에 대해 설명합니다.

    • [--dry-run|--no-dry-run](부울)

      실제로 요청하지 않고 작업에 필요한 권한이 있는지 확인하고 오류 응답을 제공합니다. 필요한 권한이 있는 경우 오류 응답은 DryRunOperation입니다

      그렇지 않으면 UnauthorizedOperation입니다.

    • [--include-all-instances | --no-include-all-instances](부울)

      true 상태일 경우 모든 인스턴스의 상태를 포함합니다. false 상태일 경우 실행 중인 인스턴스의 상태만을 포함합니다.

      기본값: false

    • [--page-size](정수) – 직접 호출을 받아들일 각 페이지의 크기입니다. 이 값은 명령의 출력을 통해 반환되는 항목의 수에는 영향을 미치지 않습니다. 페이지 크기를 더 작게 설정하면 디바이스에 대한 추가 호출이 이루어져 각 호출에서 더 적은 항목을 가져옵니다. 따라서 호출이 시간 초과되는 것을 방지하는 데 도움이 됩니다.

    • [--max-items](정수) – 명령의 출력에서 반환되는 항목의 총 수입니다. 사용 가능한 총 항목 수가 지정된 값을 초과하는 경우 명령의 출력에 NextToken이 제공됩니다. 페이지 매김을 재개하려면 후속 명령의 starting-token 인수에 NextToken 값을 제공합니다.

    • [--starting-token](문자열) - 페이지 매김을 시작할 위치를 지정하는 토큰입니다. 이 토큰은 이전에 잘린 응답에서 도출된 NextToken 값입니다.

  • describe-launch-templates— 하나 이상의 시작 템플릿에 대해 설명합니다. describe-launch-templates 명령은 페이지 매김 작업입니다. 다중 호출을 생성하여 결과의 전체 데이터 세트를 검색할 수 있습니다.

    요청에 시작 템플릿 IDs 또는 시작 템플릿 이름을 지정합니다.

    • -- launch-template-ids (목록) "string" "string" — 시작 템플릿 목록입니다. IDs

    • -- launch-template-names (목록) "string" "string" — 시작 템플릿의 이름 목록입니다.

    • --page-size - 직접 호출을 받아들일 각 페이지의 크기입니다. 이 값은 명령의 출력을 통해 반환되는 항목의 수에는 영향을 미치지 않습니다. 페이지 크기를 더 작게 설정하면 디바이스에 대한 추가 호출이 이루어져 각 호출에서 더 적은 항목을 가져옵니다. 따라서 호출이 시간 초과되는 것을 방지하는 데 도움이 됩니다.

    • --max-items - 명령의 출력을 통해 반환될 항목의 총 수입니다. 사용 가능한 총 항목 수가 지정된 값을 초과하는 경우 명령의 출력에 NextToken이 제공됩니다. 페이지 매김을 재개하려면 후속 명령의 starting-token 인수에 NextToken 값을 제공합니다.

    • --starting-token - 페이지 매김을 시작할 위치를 지정하기 위한 토큰입니다. 이 토큰은 이전에 잘린 응답에서 도출된 NextToken 값입니다.

    • --endpoint snowballEndpoint — Amazon EC2 호환 API 작업을 사용하여 프로그래밍 방식으로 컴퓨팅 인스턴스를 관리할 수 있게 해주는 값입니다. 자세한 내용은 EC2-호환 가능한 엔드포인트를 Snow Family 디바이스의 AWS CLI 엔드포인트로 지정 단원을 참조하십시오.

  • describe-launch-template-versions— 지정된 시작 템플릿의 하나 이상의 버전을 설명합니다. 모든 버전, 개별 버전 또는 특정 버전 범위를 설명할 수 있습니다. describe-launch-template-versions 명령은 페이지 매김 작업입니다. 다중 호출을 생성하여 결과의 전체 데이터 세트를 검색할 수 있습니다.

    요청에 시작 템플릿 IDs 또는 시작 템플릿 이름을 지정하십시오.

    • -- launch-template-id string — 시작 템플릿의 ID.

    • -- launch-template-name string — 시작 템플릿의 이름.

    • [--versions (list) "string" "string"] - 삭제할 하나 이상의 시작 템플릿 버전에 대한 버전 번호입니다.

    • [--min-version string] - 시작 템플릿 버전을 설명하는 최소 버전 번호입니다.

    • [--max-version string] - 시작 템플릿 버전을 설명하는 최대 버전 번호입니다.

    • --page-size - 직접 호출을 받아들일 각 페이지의 크기입니다. 이 값은 명령의 출력을 통해 반환되는 항목의 수에는 영향을 미치지 않습니다. 페이지 크기를 더 작게 설정하면 디바이스에 대한 추가 호출이 이루어져 각 호출에서 더 적은 항목을 가져옵니다. 따라서 호출이 시간 초과되는 것을 방지하는 데 도움이 됩니다.

    • --max-items - 명령의 출력을 통해 반환될 항목의 총 수입니다. 사용 가능한 총 항목 수가 지정된 값을 초과하는 경우 명령의 출력에 NextToken이 제공됩니다. 페이지 매김을 재개하려면 후속 명령의 starting-token 인수에 NextToken 값을 제공합니다.

    • --starting-token - 페이지 매김을 시작할 위치를 지정하기 위한 토큰입니다. 이 토큰은 이전에 잘린 응답에서 도출된 NextToken 값입니다.

    • --endpoint snowballEndpoint — Amazon EC2 호환 API 작업을 사용하여 프로그래밍 방식으로 컴퓨팅 인스턴스를 관리할 수 있게 해주는 값입니다. 자세한 내용은 EC2-호환 가능한 엔드포인트를 Snow Family 디바이스의 AWS CLI 엔드포인트로 지정 단원을 참조하십시오.

  • describe-security-groups— 하나 이상의 보안 그룹을 설명합니다.

    describe-security-groups 명령은 페이지 매김 작업입니다. 여러 번 API 호출을 실행하여 전체 결과 데이터세트를 검색할 수 있습니다.

    • [--group-name value] - 보안 그룹의 이름입니다.

    • [--group-id value] - 보안 그룹의 ID입니다.

    • [--page-sizevalue] — 서비스 호출에서 가져올 각 페이지의 크기입니다. AWS 이 크기는 명령의 출력에서 반환된 항목의 수에 영향을 주지 않습니다. 페이지 크기를 작게 설정하면 AWS 서비스에 대한 직접 호출이 많아지고 각 직접 호출의 항목에서 검색 항목이 줄어듭니다. 이 방법을 사용하면 AWS 서비스 호출 시간이 초과되는 것을 방지할 수 있습니다. 사용 예시는 AWS Command Line Interface 사용 설명서의 페이지 매김 섹션을 참조하세요.

    • [--max-items value] - 명령의 출력을 통해 반환될 항목의 총 수입니다. 사용 가능한 총 항목 수가 지정된 값을 초과하는 경우 명령의 출력에 NextToken이 제공됩니다. 페이지 매김을 재개하려면 후속 명령의 starting-token 인수에 NextToken 값을 제공합니다. NextToken 외부에서 직접 AWS CLI응답 요소를 사용하면 안 됩니다. 사용 예시는 AWS Command Line Interface 사용 설명서의 페이지 매김 섹션을 참조하세요.

    • [--starting-token value] - 페이지 매김이 시작되는 곳을 지정하는 토큰입니다. 이 토큰은 이전에 잘린 응답에서 도출된 NextToken 값입니다. 사용 예시는 AWS Command Line Interface 사용 설명서의 페이지 매김 섹션을 참조하세요.

  • describe-tags - 지정된 리소스(image, instance 또는 보안 그룹)에 대한 하나 이상의 태그를 설명합니다. 이 명령에서는 다음 필터가 지원됩니다.

    • launch-template

    • resource-id

    • resource-type - image 또는 instance입니다.

    • 키

    • 값

  • 설명 볼륨 — 지정된 아마존 볼륨에 대해 설명합니다. EBS

    • [--max-items value] - 명령의 출력을 통해 반환될 항목의 총 수입니다. 사용 가능한 총 항목 수가 지정된 값을 초과하는 경우 명령의 출력에 NextToken이 제공됩니다. 페이지 매김을 재개하려면 후속 명령의 starting-token 인수에 NextToken 값을 제공합니다.

    • [--starting-token value] - 페이지 매김이 시작되는 곳을 지정하는 토큰입니다. 이 토큰은 이전에 잘린 응답에서 도출된 NextToken 값입니다.

    • [--volume-idsvalue] — 하나 이상의 볼륨. IDs

  • detach-volume — 중지되거나 실행 중인 인스턴스에서 EBS Amazon 볼륨을 분리합니다.

    • [--device value] - 디바이스의 이름입니다.

    • [--instance-id] — 대상 아마존 인스턴스의 ID입니다. EC2

    • --volume-id value - 볼륨의 ID입니다.

  • disassociate-address - 가상 IP 주소를 연결된 인스턴스에서 분리합니다.

    • --public-ip - 인스턴스에서 분리하려고 하는 가상 IP 주소입니다.

  • get-launch-template-data— 지정된 인스턴스의 구성 데이터를 검색합니다. 이 데이터를 사용하여 시작 템플릿을 생성할 수 있습니다.

  • modify-launch-template— 시작 템플릿을 수정합니다. 기본 버전으로 설정할 시작 템플릿의 버전을 지정할 수 있습니다. 시작 템플릿 버전을 지정하지 않고 인스턴스를 시작하면 시작 템플릿의 기본 버전이 적용됩니다.

    요청에서 시작 템플릿 ID 또는 시작 템플릿 이름을 지정합니다.

    • -- launch-template-id string — 시작 템플릿의 ID.

    • -- launch-template-name string — 시작 템플릿의 이름.

    • --default-version string - 기본 버전으로 설정할 시작 템플릿의 버전 번호입니다.

    • --endpoint snowballEndpoint — Amazon EC2 호환 API 작업을 사용하여 프로그래밍 방식으로 컴퓨팅 인스턴스를 관리할 수 있게 해주는 값입니다. 자세한 내용은 EC2-호환 가능한 엔드포인트를 Snow Family 디바이스의 AWS CLI 엔드포인트로 지정 단원을 참조하십시오.

  • modify-instance-attribute— 지정된 인스턴스의 속성을 수정합니다. 다음과 같은 속성이 지원됩니다.

    • instanceInitiatedShutdownBehavior

    • userData

  • revoke-security-group-egress— 보안 그룹에서 하나 이상의 송신 규칙을 제거합니다.

    • [--group-id value] - 보안 그룹의 ID입니다.

    • [--ip-permissions value] - 하나 이상의 IP 권한 집합입니다.

  • revoke-security-group-ingress— 보안 그룹에 대한 하나 이상의 인그레스 규칙을 취소합니다. revoke-security-group-ingress 호출 시 group-name 또는 group-id에 대한 값을 지정해야 합니다.

    • [--group-name value] - 보안 그룹의 이름입니다.

    • [--group-id value] - 보안 그룹의 ID입니다.

    • [--ip-permissions value] - 하나 이상의 IP 권한 집합입니다.

    • [--protocol value] IP 프로토콜. 가능한 값은 tcp, udp 및 icmp입니다. "모든 프로토콜" 값이 지정되지 않는 한(-1) --port 인수가 필요합니다.

    • [--portvalue] — TCP 또는UDP, 허용할 포트 범위입니다. 단일 정수 또는 범위(최소~최대값)입니다.

      F의 경우ICMP, 단일 정수 또는 ICMP 유형 번호를 나타내고 code ICMP 코드 번호를 type 나타내는 범위 (type-code) 입니다. 값이 -1이면 모든 ICMP 유형의 모든 ICMP 코드를 나타냅니다. for 값만 -1이면 지정된 ICMP 유형의 모든 ICMP 코드를 type 나타냅니다.

    • [--cidrvalue] — CIDR IP 범위입니다.

  • 실행 인스턴스 - Snowball AMI ID를 사용하여 여러 컴퓨팅 인스턴스를 시작합니다. AMI

    참고

    컴퓨팅 인스턴스의 크기 및 유형에 따라 Snowball Edge에서 컴퓨팅 인스턴스를 시작하는 데 최대 한 시간 반이 소요될 수 있습니다.

    • [-- block-device-mappings (list)] — 블록 디바이스 매핑 항목. DeleteOnTermination, VolumeSize, VolumeType 파라미터를 지원합니다. 부트 볼륨은 sbg1 유형이어야 합니다.

      이 명령의 JSON 구문은 다음과 같습니다.

      {
   "DeviceName": "/dev/sdh",
   "Ebs": 
   {
      "DeleteOnTermination": true|false,
      "VolumeSize": 100,
      "VolumeType": "sbp1"|"sbg1"
   }
}

    • --count - 시작할 인스턴스의 개수입니다. 단일 숫자가 제공된 경우 최소 개수를 시작하는 것으로 가정합니다(1로 기본 설정). 범위가 min:max 형식으로 제공될 경우 첫 번째 수는 시작할 인스턴스의 최소 수로 해석하고 두 번째 수는 시작할 인스턴스의 최대 수로 해석합니다.

    • --image-id — 의 Snowball AMI ID로AMI, 호출을 통해 확인할 수 있습니다. describe-images 인스턴스를 시작하려면 AMI An이 필요합니다.

    • -- InstanceInitiatedShutdownBehavior — 기본적으로 shutdown 또는 poweroff와 같은 명령을 사용하여 인스턴스 종료를 시작하면 인스턴스가 중지됩니다. 인스턴스가 중지되지 않고 종료되도록 이 동작을 변경할 수 있습니다. stop 및 terminate 파라미터가 지원됩니다. 기본값은 stop입니다. 자세한 내용은 Linux 인스턴스용 Amazon EC2 사용 설명서의 인스턴스 시작 종료 동작 변경을 참조하십시오.

    • --instance-type - sbe 인스턴스 유형입니다.

    • --launch-template structure - 인스턴스를 시작하는 데 사용할 시작 템플릿입니다. run-instances 명령에서 파라미터를 지정하면 시작 템플릿에 있는 동일한 파라미터가 재정의됩니다. 시작 템플릿의 이름이나 ID는 지정할 수 있지만, 둘 다 지정할 수는 없습니다.

      {
   "LaunchTemplateId": "string",
   "LaunchTemplateName": "string",
   "Version": "string"
}

    • -- security-group-ids — 하나 이상의 보안 그룹. IDs 를 사용하여 보안 그룹을 생성할 수 CreateSecurityGroup있습니다. 값이 제공되지 않는 경우 기본 보안 그룹의 ID가 생성된 인스턴스에 할당됩니다.

    • --tag-specifications - 시작 시 리소스에 적용되는 태그입니다. 시작 시에만 인스턴스에 태그를 지정할 수 있습니다. 지정된 태그는 시작 시 생성된 모든 인스턴스에 적용됩니다. 생성된 후에 리소스에 태그를 지정하려면 create-tags를 사용합니다.

    • --user-data - 인스턴스에 사용할 수 있는 사용자 데이터입니다. 를 사용하는 AWS CLI경우 base64 인코딩이 자동으로 수행되며 파일에서 텍스트를 로드할 수 있습니다. 그렇지 않으면 base64 인코딩 형식의 텍스트를 입력해야 합니다.

    • --key-name (string) - 키 페어의 이름입니다. CreateKeyPair 또는 ImportKeyPair를 사용하여 키 페어를 생성할 수 있습니다.

      주의

      키 페어를 지정하지 않으면 사용자가 다른 방법으로 로그인할 수 있도록 구성된 키 페어를 선택하지 않는 한 인스턴스에 연결할 수 없습니다. AMI

  • start-instances - 이전에 중지했던 sbe 인스턴스를 시작합니다. 인스턴스에 연결된 모든 자원은 시작 및 중지를 통해 지속되지만 인스턴스가 해지되면 삭제됩니다.

    • --instance-ids — 기기에서 중지된 하나 이상의 sbe 인스턴스 IDs 중 하나입니다.

  • stop-instances - 실행 중인 sbe 인스턴스를 중지합니다. 인스턴스에 연결된 모든 자원은 시작 및 중지를 통해 지속되지만 인스턴스가 해지되면 삭제됩니다.

    • --instance-ids — 디바이스에서 중지할 하나 이상의 sbe 인스턴스 IDs 중 하나입니다.

  • terminate-instances - 하나 이상의 인스턴스를 종료합니다. 이 작업은 멱등성을 갖기 때문에 인스턴스를 2회 이상 종료해도 모든 호출이 성공적으로 처리됩니다. 인스턴스에 연결된 모든 리소스는 시작 및 중지 사태가 발생해도 지속되지만 인스턴스가 종료되면 데이터가 삭제됩니다.

    참고

    기본적으로 shutdown 또는 poweroff 등의 명령을 사용하여 인스턴스에서 종료를 시작하면 인스턴스가 중지됩니다. 그러나 이러한 명령이 인스턴스를 종료하도록 InstanceInitiatedShutdownBehavior 속성을 사용하여 이 동작을 변경할 수 있습니다. 자세한 내용은 Linux 인스턴스용 Amazon EC2 사용 설명서의 인스턴스 시작 종료 동작 변경을 참조하십시오.

    • --instance-ids — 디바이스에서 IDs 종료될 하나 이상의 sbe 인스턴스 중 하나입니다. 이러한 인스턴스에 대해 저장된 연결된 데이터는 모두 손실됩니다.

  • create-key-pair— 지정된 이름을 가진 2048비트 RSA 키 페어를 생성합니다. EC2Amazon은 퍼블릭 키를 저장하고 사용자가 파일에 저장할 수 있도록 프라이빗 키를 표시합니다. 개인 키는 암호화되지 않은 PKCS #1 개인 키로 PEM 반환됩니다. 지정된 이름의 키가 이미 존재하는 경우 Amazon은 오류를 EC2 반환합니다.

    • --key-name (string) - 키 페어의 고유 이름입니다.

      제약: 최대 ASCII 255자.

    • [--tag-specifications] (list) – 새 키 페어에 적용할 태그입니다.

    {
    "ResourceType": "image"|"instance"|"key-pair"|"launch-template"|"security-group",
    "Tags": [
      {
        "Key": "string",
        "Value": "string"
      }
      ...
    ]
  }
  ...

  • import-key-pair –

    • --key-name (string) - 키 페어의 고유 이름입니다.

      제약: 최대 ASCII 255자.

    • -- public-key-material (블럽) — 퍼블릭 키. API통화의 경우 텍스트는 base64로 인코딩되어야 합니다. 명령줄 도구의 경우 base64-encoding이 수행됩니다.

    • [--tag-specifications] (list) – 새 키 페어에 적용할 태그입니다.

    {
    "ResourceType": "image"|"instance"|"key-pair"|"launch-template"|"security-group",
    "Tags": [
      {
        "Key": "string",
        "Value": "string"
      }
      ...
    ]
  }

  • describe-key-pairs –

    [--filters] (list) – 필터입니다.

    • key-pair-id — 키 페어의 ID.

    • key-name - 키 페어의 이름입니다.

    • tag-key - 리소스에 할당된 태그의 키입니다. 이 필터를 사용하면 태그 값에 상관없이 특정 키가 있는 태그가 할당된 모든 리소스를 찾을 수 있습니다.

    • [--tag-specifications] (list) – 새 키 페어에 적용할 태그입니다.

    • tag :key – 리소스에 할당된 태그의 키/값 조합입니다. 필터 이름에 태그 키를 사용하고 태그 값을 필터 값으로 사용합니다. 예를 들어, Owner 키와 Team A 값이 있는 태그가 있는 모든 리소스를 찾으려면 필터 이름에 tag:Owner를 지정하고 필터 값에 Team A를 지정합니다.

    {
    "Name": "string",
    "Values": ["string", ...]
  }
  ...

  • [--key-names] (list) – 키 페어 이름입니다.

    기본값: 모든 키 페어를 설명합니다.

  • [--key-pair-ids] (목록) — 키 페어 IDs

  • delete-key-pair –

    • [--key-name] (string) – 키 페어의 이름입니다.

    • [--key-pair-id] (문자열) — 키 쌍의 ID입니다.

Snow Family API 디바이스에서 Amazon EC2 호환 운영 지원

다음은 Snowball Edge와 함께 사용할 수 있는 Amazon EC2 호환 API 작업을 찾을 수 있으며, Amazon EC2 API 레퍼런스에 있는 설명으로 연결되는 링크를 참조하십시오. EC2Amazon과 호환되는 API 통화에는 서명 버전 4 (SigV4) 서명이 필요합니다. AWS CLI 또는 AWS SDK an을 사용하여 이러한 API 전화를 걸면 SigV4 서명이 자동으로 처리됩니다. 그렇지 않은 경우 자체 SigV4 서명 솔루션을 구현해야 합니다. 자세한 내용은 Snow Family 디바이스에서 로컬 Amazon S3 자격 증명 가져오기 및 사용 단원을 참조하십시오.

  • AssociateAddress— 엘라스틱 IP 주소를 인스턴스 또는 네트워크 인터페이스와 연결합니다.

  • AttachVolume— 다음과 같은 요청 파라미터가 지원됩니다.

    • Device

    • InstanceId

    • VolumeId

  • AuthorizeSecurityGroupEgress— Snowball Edge 디바이스와 함께 사용할 하나 이상의 송신 규칙을 보안 그룹에 추가합니다. 특히 이 작업을 통해 인스턴스는 하나 이상의 대상 IPv4 CIDR 주소 범위로 트래픽을 전송할 수 있습니다.

  • AuthorizeSecurityGroupIngress— 보안 그룹에 하나 이상의 인그레스 규칙을 추가합니다. AuthorizeSecurityGroupIngress호출할 때는 GroupName 또는 GroupId 에 대한 값을 지정해야 합니다.

  • CreateVolume— 다음과 같은 요청 파라미터가 지원됩니다.

    • SnapshotId

    • Size

    • VolumeType

    • TagSpecification.N

  • CreateLaunchTemplate— 다음과 같은 요청 매개변수가 지원됩니다.

    • ImageId

    • InstanceType

    • SecurityGroupIds

    • TagSpecifications

    • UserData

  • CreateLaunchTemplateVersion

  • CreateTags— 다음과 같은 요청 매개변수가 지원됩니다.

    • AMI

    • Instance

    • Launch template

    • Security group

  • CreateSecurityGroup— Snowball Edge에 보안 그룹을 생성합니다. 최대 50개의 보안 그룹을 생성할 수 있습니다. 보안 그룹을 생성할 때 친근한 이름을 직접 선택하여 지정합니다.

  • DeleteLaunchTemplate

  • DeleteLaunchTemplateVersions

  • DeleteSecurityGroup— 보안 그룹을 삭제합니다. 인스턴스와 연결된 보안 그룹이나 다른 보안 그룹에서 참조하는 보안 그룹의 삭제를 시도하는 경우 DependencyViolation으로 작업이 실패합니다.

  • DeleteTags— 지정된 리소스 세트에서 지정된 태그 세트를 삭제합니다.

  • DeleteVolume— 다음과 같은 요청 파라미터가 지원됩니다.

    • VolumeId

  • DescribeAddresses

  • DescribeImages

  • DescribeInstanceAttribute— 지원되는 속성은 다음과 같습니다.

    • instanceType

    • userData

  • DescribeInstanceStatus

  • DescribeLaunchTemplates

  • DescribeLaunchTemplateVersions

  • DescribeInstances

  • DescribeSecurityGroups— 하나 이상의 보안 그룹을 설명합니다. DescribeSecurityGroups페이지 매김 작업입니다. 여러 번 API 호출하여 전체 결과 데이터세트를 검색할 수 있습니다.

  • DescribeTags— 이 명령어에서는 다음과 같은 필터가 지원됩니다.

    • resource-id

    • resource-type— AMI 또는 컴퓨팅 인스턴스만

    • key

    • value

  • DescribeVolume— 다음과 같은 요청 파라미터가 지원됩니다.

    • MaxResults

    • NextToken

    • VolumeId.N

  • DetachVolume— 다음과 같은 요청 매개변수가 지원됩니다.

    • Device

    • InstanceId

    • VolumeId

  • DisassociateAddress

  • GetLaunchTemplateData

  • ModifyLaunchTemplate

  • ModifyInstanceAttribute— userData 속성만 지원됩니다.

  • RevokeSecurityGroupEgress— 보안 그룹에서 하나 이상의 송신 규칙을 제거합니다.

  • RevokeSecurityGroupIngress— 보안 그룹에 대한 하나 이상의 인그레스 규칙을 취소합니다. RevokeSecurityGroupIngress호출할 때는 또는 에 대한 값을 지정해야 합니다. group-name group-id

  • RunInstances –

    참고

    컴퓨팅 인스턴스의 크기 및 유형에 따라 Snowball Edge에서 컴퓨팅 인스턴스를 시작하는 데 최대 한 시간 반이 소요될 수 있습니다.

  • StartInstances

  • StopInstances— 중지된 인스턴스와 연결된 리소스는 유지됩니다. 이러한 리소스를 확보하기 위해 인스턴스를 종료할 수 있습니다. 하지만 연결된 모든 데이터가 삭제됩니다.

  • TerminateInstances