홈페이지>프로그래밍 관련>기타 소스코드
다운로드
CLI 엣지워커

엣지워커스 CLI

EdgeWorkers CLI EdgeWorkers 명령줄 인터페이스(CLI)는 Akamai Edge 네트워크에서 EdgeWorkers 기능을 등록, 업로드, 활성화 및 테스트하는 프로세스를 가속화합니다.

EdgeKV 데이터베이스를 관리하고 명령줄에서 EdgeKV API를 호출하는 방법에 대한 자세한 내용은 EdgeKV용 Akamai CLI를 참조하세요.

기술 설정 요구 사항

이 도구를 사용하려면 다음이 필요합니다.

  • Akamai CLI가 설치되었습니다.

    • CLI가 없고 Mac에서 Homebrew를 사용하는 경우 다음 명령을 실행하세요. brew install akamai

    • OS별 CLI 바이너리 또는 Docker 이미지를 다운로드할 수도 있습니다.

  • Akamai Control Center를 통해 구성된 유효한 EdgeGrid 자격 증명(API 시작하기 참조)

  • 노드 버전 14 이상

EdgeWorkers 설치 또는 업데이트

  • EdgeWorkers CLI 패키지가 설치되어 있지 않은 경우 다음 Akamai CLI 명령을 사용하여 최신 EdgeWorkers CLI 패키지를 설치하십시오.

용법:
akamai install edgeworkers

  • CLI가 이미 설치되어 있는 경우 다음 Akamai CLI 명령을 사용하여 EdgeKV 기능이 포함된 최신 EdgeWorkers CLI 패키지를 설치하십시오.

용법:
akamai update edgeworkers

기본 구성 속성 제공

EdgeWorkers CLI를 사용하면 명령 옵션에 대한 기본값을 설정할 수 있습니다. 구성 파일을 생성하는 방법에는 두 가지가 있습니다.

  1. ~/.akamai-cli/ew-config 구성 파일을 생성하고 다음과 같이 속성을 저장합니다.

 [기본]
edgeworkerName=testEW
그룹 ID=12345
버전 ID=1-0-2

  1. config 명령을 사용하여 기본 속성을 설정합니다. akamai edgeworkers config set

사용 가능한 속성 이름이 여기에 표시됩니다.

명령 개요

EdgeWorkers CLI를 사용하면 EdgeWorkers API를 호출하여 EdgeWorkers 기능을 관리할 수 있습니다.

규칙:

  • 선택적 인수 []

  • 필수 인수 <>

용법:
akamai edgeworkers [options] [command]

옵션:

통사론 설명
-V, --버전 EdgeWorkers CLI 프로그램의 버전 번호를 표시합니다.
--디버그 디버그 정보를 표시합니다.
--edgerc 명령을 위해 edgerc 파일의 자격 증명을 사용하십시오. (기본 파일 위치는 ~/.edgerc )
--섹션 edgerc 파일에서 이 섹션을 사용하세요. (기본 섹션은 [default] 입니다)
--configSection 기본 구성 속성 세트가 포함된 ew-config 파일에서 이 섹션을 사용합니다. (기본 섹션은 [default] 입니다)
--timeout 2분 기본값을 재정의하기 위해 명령에 대한 시간 초과 값을 초 단위로 지정할 수 있습니다. 예를 들어, 명령에 "--timeout 10"을 추가하면 서버가 응답하는 데 10초 이상 걸리면 시간 초과됩니다.
--json [path] 선택적으로 제공된 경로에 CLI 출력을 JSON으로 작성합니다. 경로가 제공되지 않은 경우 CLI 홈 디렉터리에 JSON 출력을 씁니다.
--jsonout CLI 출력을 JSON으로 stdout에 씁니다.
-h, --help EdgeWorkers CLI의 사용 정보를 표시합니다.

명령:

명령 | 별명 설명
도움말 [command] 해당 명령에 대한 사용법 정보를 표시합니다.
목록 그룹 | lg [group-identifier] 고객 개발자는 Luna 액세스 제어 그룹별로 EdgeWorkers 액세스 수준을 찾을 수 있습니다.
목록 ID | li [options] [edgeworker-identifier] 현재 등록된 EdgeWorker ID를 나열합니다.
등록 | create-id 속성 관리자 동작에서 참조할 새 EdgeWorker ID를 등록합니다.
업데이트 ID | ui [options] 고객 개발자가 기존 EdgeWorker 식별자의 Luna ACG 또는 이름 속성을 업데이트할 수 있습니다.
삭제-ID | 삭제 ID [options] 기존 EdgeWorker ID를 영구적으로 삭제합니다.
목록 버전 | lv [version-identifier] 지정된 EdgeWorker ID의 버전 정보를 나열합니다.
업로드 | 생성 버전 [options] 코드 번들을 포함하는 지정된 EdgeWorker ID의 새 버전을 생성합니다.
버전 삭제 | 버전 삭제 [options] 지정된 EdgeWorker ID의 기존 버전을 영구적으로 삭제합니다.
다운로드 | 다운로드 버전 [options] EdgeWorker 버전의 코드 번들을 다운로드하세요.
다운로드 개정 | dr [options] EdgeWorker가 실행하는 코드와 종속성을 포함하는 결합된 코드 번들을 다운로드합니다.
상태 | 목록 활성화 [options] 지정된 EdgeWorker ID의 활성화 상태를 나열합니다.
목록 개정 | lr [options] 지정된 EdgeWorker ID의 개정 기록을 나열합니다.
개정판 받기 | gr 특정 버전에 대한 세부정보를 확인하세요.
비교 개정 | cr 동일한 EdgeWorker의 두 개정판 간 종속성 차이를 확인하세요.
활성화-개정 | ar [options] Akamai 네트워크에서 특정 EdgeWorker ID에 대한 개정을 활성화합니다.
pin-revision [options] 특정 EdgeWorker ID에 대한 활성 버전을 고정합니다.
unpin-revision [options] 특정 EdgeWorker ID에 대해 활성 고정된 개정을 고정 해제합니다.
get-revision-bom | gb [options] 복합 번들의 특정 개정판에 대한 세부사항을 보십시오.
목록 개정 활성화 | lra [options] 지정된 EdgeWorker ID의 개정 활성화 상태를 나열합니다.
활성화 | av Akamai 네트워크에서 특정 EdgeWorker ID에 대한 버전을 활성화합니다.
비활성화 | deact Akamai 네트워크에서 특정 EdgeWorker ID의 버전을 비활성화합니다.
검증 | vv 코드 번들을 업로드하지 않고 코드 번들 버전을 검증합니다.
인증 토큰 생성 | 인증 [options] 자세한 EdgeWorker 디버그 응답 헤더를 가져오는 데 사용할 수 있는 인증 토큰을 생성합니다. 이 명령을 실행하려면 EdgeWorkers CLI 버전 1.7.1 이상이 필요합니다.
클론 | clone [options] 기존 EdgeWorker ID에서 EdgeWorker를 복제합니다.
목록 계약 | li-계약 [options] 사용자가 액세스할 수 있는 계약 ID 목록입니다.
목록 속성 | lp [options] 지정된 EdgeWorker ID와 연결된 속성 목록입니다.
목록 제한 | li-한계 EdgeWorkers가 활성화 수, EdgeWorkers ID 및 배포할 수 있는 버전에 부과하는 다양한 제한을 확인하세요.
목록 복원 | 리레스티에르 [options] EdgeWorker ID를 생성하거나 복제하는 데 사용할 수 있는 리소스 계층을 나열합니다.
쇼 레스티에 | 쇼-레스티어 고객은 특정 EdgeWorker ID에 대한 리소스 계층 세부 정보를 얻을 수 있습니다.
보고서를 받다 사용 가능한 모든 EdgeWorkers 보고서 목록을 가져옵니다.
보고서 가져오기 [options] 특정 EdgeWorker ID에 대한 EdgeWorkers 보고서를 받으세요.
구성 목록 구성 파일의 모든 값을 가져옵니다.
구성 가져오기 구성 파일의 섹션에서 구성 값을 가져옵니다.
구성 세트 섹션에서 구성 값을 설정합니다.
config save -p 섹션에 구성 속성을 저장합니다.
설정 해제 섹션에서 구성 값을 설정 해제합니다.

EdgeWorkers 액세스 권한이 있는 권한 그룹 나열

고객 개발자는 Luna 액세스 제어 그룹별로 EdgeWorkers 액세스 수준을 찾을 수 있습니다.

사용법: akamai edgeworkers list-groups [options] [group-identifier]

옵션 설명
-h, --help 출력 사용 정보
논쟁 존재 설명
그룹 식별자 선택 과목 EdgeWorkers 권한을 확인하기 위한 Luna 액세스 그룹 값(일반적으로 숫자)

주요 내용

  1. 출력은 EdgeWorkers 기능이 하나 이상 있는 Luna 액세스 제어 그룹으로만 필터링됩니다.

  2. 기능은 다음과 같습니다: VIEW,VIEW_VERSION,EDIT,VIEW_ACTIVATION,CREATE_VERSION,ACTIVATE

기존 EdgeWorker 식별자 나열

현재 등록된 EdgeWorker ID를 나열합니다.

사용법: akamai edgeworkers list-ids [options] [edgeworker-identifier]

옵션 설명
-h, --help 출력 사용 정보
--groupId 권한 그룹별로 EdgeWorker ID 목록 필터링
--resourceTierId 리소스 계층별로 EdgeWorker ID 필터링
논쟁 존재 설명
edgeworker 식별자 선택 과목 EdgeWorkers 인스턴스에 대한 고유한 정수 핸들

새로운 EdgeWorker 식별자 등록

속성 관리자 동작에서 참조할 새 EdgeWorker ID를 등록합니다.

사용법: akamai edgeworkers register [options]

옵션 설명
--resourceTierId EdgeWorker가 연결될 새 리소스 계층 ID입니다.
-h, --help 출력 사용 정보
논쟁 존재 설명
그룹 식별자 필수의 EdgeWorkers 권한을 확인하기 위한 Luna 액세스 그룹 값(일반적으로 숫자)
edgeworker 이름 필수의 EdgeWorkers 인스턴스를 설명하는 사람이 읽을 수 있는 짧은 라벨

주요 내용

  1. 위치 응답 헤더에는 새로운 EdgeWorker ID가 제공됩니다.

  2. EdgeWorker ID 세부정보 응답 본문(JSON)은 201 응답 코드와 함께 제공됩니다.

  3. 자동화 목적으로 프롬프트를 비활성화하려면 "resourceTierId"를 입력으로 제공할 수 있습니다.

EdgeWorker 식별자 정보 업데이트

고객 개발자가 기존 EdgeWorker 식별자의 Luna ACG 또는 이름 속성을 업데이트할 수 있습니다.

사용법: akamai edgeworkers update-id [options]

옵션 설명
--resourceTierId EdgeWorker가 연결될 새 리소스 계층 ID
-h, --help 출력 사용 정보
논쟁 존재 설명
edgeworker 식별자 필수의 EdgeWorkers 인스턴스에 대한 고유한 정수 핸들
그룹 식별자 필수의 EdgeWorkers 권한을 확인하기 위한 Luna 액세스 그룹 값(일반적으로 숫자)
edgeworker 이름 필수의 EdgeWorkers 인스턴스를 설명하는 사람이 읽을 수 있는 짧은 라벨

주요 내용

  1. API에서는 이러한 속성 중 하나만 변경하는 경우에도 groupId와 name을 모두 제공해야 합니다.

  2. EdgeWorker ID 세부 응답 본문(JSON)은 200 응답 코드로 제공됩니다.

  3. 제공된 리소스 계층 ID는 EdgeWorker ID에 이미 있는 것과 동일해야 합니다. 다른 리소스 계층 ID를 제공하려면 복제 작업을 사용하세요.

기존 EdgeWorker 식별자 삭제

기존 EdgeWorker 식별자를 영구적으로 삭제합니다.

사용법: akamai edgeworkers delete-id [options]

옵션 설명
-h, --help 출력 사용 정보
--noPrompt 삭제 확인 프롬프트 건너뛰기
논쟁 존재 설명
edgeworker 식별자 필수의 EdgeWorkers 인스턴스에 대한 고유한 정수 핸들

주요 내용

  1. EdgeWorker ID 삭제는 현재 활성화된 버전이 없거나 Akamai 네트워크에서 활성화 중인 경우에만 가능합니다.

  2. 삭제하기 전에 EdgeWorker와 연결된 활성 속성이 없는지 확인하세요.

EdgeWorker 버전 나열

지정된 EdgeWorker ID의 버전 정보를 나열합니다.

사용법: akamai edgeworkers list-versions [options] [version-identifier]

옵션 설명
-h, --help 출력 사용 정보
논쟁 존재 설명
edgeworker 식별자 필수의 EdgeWorkers 인스턴스에 대한 고유한 정수 핸들
버전 식별자 선택 과목 EdgeWorkers 인스턴스 버전에 대한 고유한 정수 핸들

주요 내용

  1. 결과 세트는 표시되지 않은 업로드 순서 값(내부 증분 정수)을 기준으로 정렬됩니다.

  2. EdgeWorker 버전은 고객이 정의한 문자열입니다.

새 EdgeWorker 버전 업로드

코드 번들을 포함하는 지정된 EdgeWorker ID의 새 버전을 생성합니다.

사용법: akamai edgeworkers upload [options]

옵션 설명
-h, --help 출력 사용 정보
--bundle tgz 형식의 번들 파일 경로
--codeDir main.js 및 Bundle.json 파일이 포함된 작업 디렉터리
논쟁 존재 설명
edgeworker 식별자 필수의 EdgeWorkers 인스턴스에 대한 고유한 정수 핸들

주요 내용

  1. --bundle 또는 --codeDir 중 하나(둘 다는 아님)를 제공해야 합니다.

  2. 코드 번들 경로와 파일은 로컬 파일 시스템에서 찾아야 합니다.

  3. --bundle EdgeWorkers 사양에 따라 이미 빌드된 tgz 파일을 예상합니다.

  4. --codeDir main.js(이벤트 파일)와 Bundle.json(매니페스트 파일)이 모두 포함된 디렉터리 경로가 필요합니다.

  5. --codeDir 옵션은 Bundle.json 형식 유효성 검사를 제공합니다.

  6. --codeDir main.js 및 Bundle.json 이외의 다른 디렉터리나 코드를 압축하지 않습니다.

  7. --codeDir 파일 유효성 검사가 성공하면 tarball(tgz) 파일을 빌드합니다.

  8. 서비스는 동일한 EdgeWorker ID( ewId )에 대해 이전에 업로드된 tarball과 새 tarball의 체크섬을 비교합니다. 일치하는 항목이 있으면 새 버전 생성이 허용되지 않습니다.

  9. versionId 는 고객이 생성한 것이며 Bundle.json에서 가져옵니다.

  10. 위치 응답 헤더에는 새로운 EdgeWorker 버전 ID가 제공됩니다.

  11. EdgeWorker 버전 세부 정보 응답 본문(JSON)에는 201 응답 코드가 제공됩니다.

기존 EdgeWorker 버전 삭제

지정된 EdgeWorker ID의 기존 버전을 영구적으로 삭제합니다.

사용법: akamai edgeworkers delete-version [options]

옵션 설명
-h, --help 출력 사용 정보
--noPrompt 삭제 확인 프롬프트 건너뛰기
논쟁 존재 설명
edgeworker 식별자 필수의 EdgeWorkers 인스턴스에 대한 고유한 정수 핸들
버전 식별자 필수의 EdgeWorkers 인스턴스 버전에 대한 고유한 정수 핸들

주요 내용

  1. 버전 삭제는 해당 버전이 현재 활성화되어 있지 않거나 Akamai 네트워크에서 활성화 중인 경우에만 가능합니다.

  2. 버전이 현재 활성 상태인 경우 삭제하기 전에 비활성화해야 합니다.

EdgeWorkers 코드 번들 다운로드

EdgeWorker 버전의 코드 번들을 다운로드하세요.

사용법: akamai edgeworkers download [options]

옵션 설명
-h, --help 출력 사용 정보
--downloadPath 다운로드한 번들 파일을 저장할 경로. 제공되지 않은 경우 기본값은 CLI 홈 디렉터리입니다.
논쟁 존재 설명
edgeworker 식별자 필수의 EdgeWorkers 인스턴스에 대한 고유한 정수 핸들
버전 식별자 필수의 EdgeWorkers 인스턴스 버전에 대한 고유한 정수 핸들

주요 내용

  1. --downloadPath 제공되지 않거나 로컬 파일 시스템에서 찾을 수 없는 경우 AkamaiCLI 캐시 하위 디렉터리인 /edgeworkers-cli/edgeworkers// 사용됩니다.

EdgeWorkers 결합 코드 번들 다운로드

EdgeWorker가 실행하는 코드와 종속성을 포함하는 결합된 코드 번들을 다운로드합니다.

사용법: akamai edgeworkers download-revision [options]

옵션 설명
-h, --help 출력 사용 정보
--downloadPath 다운로드한 결합 번들 파일을 저장할 경로. 제공되지 않은 경우 기본값은 CLI 홈 디렉터리입니다.
논쟁 존재 설명
edgeworker 식별자 필수의 EdgeWorkers 인스턴스에 대한 고유한 정수 핸들
개정 식별자 필수의 특정 EdgeWorkers 인스턴스에 대한 고유 개정 식별자

주요 내용

  1. --downloadPath 제공되지 않거나 로컬 파일 시스템에서 찾을 수 없는 경우 AkamaiCLI 캐시 하위 디렉터리인 /edgeworkers-cli/edgeworkers// 사용됩니다.

EdgeWorker 버전 활성화 상태 나열

지정된 EdgeWorker ID의 활성화 상태를 나열합니다.

사용법: akamai edgeworkers status [options]

옵션 설명
-h, --help 출력 사용 정보
--versionId 버전 식별자
--activationId 활성화 식별자
--activeOnNetwork 현재 활성화된 버전만 표시하도록 결과를 제한합니다.
--network 특정 네트워크(STAGING 또는 PRODUCTION)에서 활성화된 버전으로 결과를 제한합니다.
논쟁 존재 설명
edgeworker 식별자 필수의 EdgeWorkers 인스턴스에 대한 고유한 정수 핸들

주요 내용

  1. 버전과 활성화 식별자를 모두 제공할 수는 없습니다.

EdgeWorker 개정 내역 나열

지정된 EdgeWorker ID의 개정 기록을 나열합니다.

사용법: akamai edgeworkers list-revisions [options]

옵션 설명
-h, --help 출력 사용 정보
--versionId 버전 식별자
--activationId 활성화 식별자
--pinnedOnly 현재 또는 이전에 고정된 수정본만 표시하도록 결과를 제한합니다.
--현재 고정됨 현재 고정된 버전만 표시하도록 결과를 제한합니다.
--network 특정 네트워크(STAGING 또는 PRODUCTION)에서 활성화된 버전으로 결과를 제한합니다.
논쟁 존재 설명
edgeworker 식별자 필수의 EdgeWorkers 인스턴스에 대한 고유한 정수 핸들

주요 내용

  1. 네트워크는 STAGING 또는 PRODUCTION이어야 합니다. 대문자 사용은 대문자로 정규화됩니다.

EdgeWorker의 개정 세부정보 가져오기

특정 버전에 대한 세부정보를 확인하세요.

사용법: akamai edgeworkers get-revision [options]

옵션 설명
-h, --help 출력 사용 정보
논쟁 존재 설명
edgeworker 식별자 필수의 EdgeWorkers 인스턴스에 대한 고유한 정수 핸들
개정 식별자 필수의 개정 식별자

EdgeWorker의 두 개정판 세부정보 비교

동일한 EdgeWorker의 두 개정판 간 종속성 차이를 확인하세요.

사용법: akamai edgeworkers compare-revisions [options]

옵션 설명
-h, --help 출력 사용 정보
논쟁 존재 설명
edgeworker 식별자 필수의 EdgeWorkers 인스턴스에 대한 고유한 정수 핸들
개정 식별자 필수의 첫 번째 개정 식별자
개정 식별자 필수의 두 번째 개정 식별자

주요 내용

  1. 두 개정 식별자는 서로 달라야 합니다.

EdgeWorker의 개정판 활성화

Akamai 네트워크에서 특정 EdgeWorker ID에 대한 개정을 활성화합니다.

사용법: akamai edgeworkers activate-revision [options]

옵션 설명
-h, --help 출력 사용 정보
--메모 개정판이 다시 활성화되는 이유를 지정하는 참고 사항
논쟁 존재 설명
edgeworker 식별자 필수의 EdgeWorkers 인스턴스에 대한 고유한 정수 핸들
개정 식별자 필수의 개정 식별자

주요 내용

  1. 개정은 이전에 활성화되었던 동일한 네트워크(프로덕션 또는 스테이징)에서 다시 활성화됩니다.

EdgeWorker의 개정판 고정

특정 EdgeWorker ID에 대한 활성 버전을 고정합니다.

사용법: akamai edgeworkers pin-revision [options]

옵션 설명
-h, --help 출력 사용 정보
--메모 개정이 고정되는 이유를 지정하는 참고 사항
논쟁 존재 설명
edgeworker 식별자 필수의 EdgeWorkers 인스턴스에 대한 고유한 정수 핸들
개정 식별자 필수의 개정 식별자

주요 내용

  1. 고정하기 전에 개정을 활성화해야 합니다.

EdgeWorker의 개정판 고정 해제

특정 EdgeWorker ID에 대해 활성 고정된 개정을 고정 해제합니다.

사용법: akamai edgeworkers unpin-revision [options]

옵션 설명
-h, --help 출력 사용 정보
--메모 버전이 고정 해제되는 이유를 지정하는 참고 사항
논쟁 존재 설명
edgeworker 식별자 필수의 EdgeWorkers 인스턴스에 대한 고유한 정수 핸들
개정 식별자 필수의 개정 식별자

주요 내용

  1. 고정을 해제하기 전에 버전을 고정해야 합니다.

EdgeWorker의 개정 세부정보 가져오기

복합 번들의 특정 개정판에 대한 세부사항을 보십시오.

사용법: akamai edgeworkers get-revision-bom [options]

옵션 설명
-h, --help 출력 사용 정보
--activeVerses 활성 버전만 표시하도록 결과 제한
--현재PinnedRevisions 현재 고정된 개정에 대한 추가 정보를 표시합니다.
논쟁 존재 설명
edgeworker 식별자 필수의 EdgeWorkers 인스턴스에 대한 고유한 정수 핸들
개정 식별자 필수의 개정 식별자

EdgeWorker의 개정 활성화 나열

지정된 EdgeWorker ID의 개정 활성화 상태를 나열합니다.

사용법: akamai edgeworkers list-revision-activations [options]

옵션 설명
-h, --help 출력 사용 정보
--versionId 버전 식별자
--활성화 ID 활성화 식별자
--회로망 특정 네트워크(STAGING 또는 PRODUCTION)에서 활성화된 버전으로 결과를 제한합니다.
논쟁 존재 설명
edgeworker 식별자 필수의 EdgeWorkers 인스턴스에 대한 고유한 정수 핸들

주요 내용

  1. 버전과 활성화 식별자를 모두 제공할 수는 없습니다.

  2. 네트워크는 STAGING 또는 PRODUCTION이어야 합니다. 대문자 사용은 대문자로 정규화됩니다.

EdgeWorker 활성화

Akamai 네트워크에서 특정 EdgeWorker ID에 대한 버전을 활성화합니다.

사용법: akamai edgeworkers activate [options]

옵션 설명
-h, --help 출력 사용 정보
논쟁 존재 설명
edgeworker 식별자 필수의 EdgeWorkers 인스턴스에 대한 고유한 정수 핸들
회로망 필수의 Akamai 네트워크(STAGING 또는 PRODUCTION) 활성화를 전송해야 하는 라벨
버전 식별자 필수의 EdgeWorkers 인스턴스 버전에 대한 고유한 정수 핸들

주요 내용

  1. 네트워크는 STAGING 또는 PRODUCTION이어야 합니다. 대문자 사용은 대문자로 정규화됩니다.

  2. 위치 응답 헤더에는 새로운 EdgeWorker 활성화 ID가 제공됩니다.

  3. EdgeWorker 활성화 세부 정보 응답 본문(JSON)에는 201 응답 코드가 제공됩니다.

EdgeWorkers 코드 번들 검증

코드 번들을 업로드하지 않고 코드 번들 버전을 확인합니다.

사용법: akamai edgeworkers validate [options]

옵션 설명
-h, --help 출력 사용 정보
논쟁 존재 설명
번들 경로 필수의 tgz 형식의 번들 파일 경로

주요 내용

  1. 코드 번들 경로는 로컬 파일 시스템에서 찾아야 합니다.

  2. 코드 번들은 EdgeWorkers 사양에 따라 이미 빌드된 tgz 파일을 예상합니다.

EdgeWorker 비활성화

Akamai 네트워크에서 특정 EdgeWorker ID의 버전을 비활성화합니다.

사용법: akamai edgeworkers deactivate [options]

옵션 설명
-h, --help 출력 사용 정보
논쟁 존재 설명
edgeworker 식별자 필수의 EdgeWorkers 인스턴스에 대한 고유한 정수 핸들
회로망 필수의 Akamai 네트워크(STAGING 또는 PRODUCTION) 활성화를 전송해야 하는 라벨
버전 식별자 필수의 EdgeWorkers 인스턴스 버전에 대한 고유한 정수 핸들

주요 내용

  1. 네트워크는 STAGING 또는 PRODUCTION이어야 합니다. 대문자 사용은 대문자로 정규화됩니다.

  2. 위치 응답 헤더에는 새로운 EdgeWorker 활성화 ID가 제공됩니다.

  3. EdgeWorker 활성화 세부 정보 응답 본문(JSON)에는 201 응답 코드가 제공됩니다.

EdgeWorkers 인증 토큰 생성

자세한 EdgeWorker 디버그 응답 헤더를 가져오는 데 사용할 수 있는 인증 토큰을 생성합니다. 이 명령을 실행하려면 EdgeWorkers CLI 버전 1.7.1 이상이 필요합니다. EdgeWorkers CLI의 현재 버전 번호를 표시하려면 -V, --version 옵션을 사용하십시오.

사용법: akamai edgeworkers create-auth-token [options]

옵션 설명
-h, --help 출력 사용 정보
--만료 토큰의 만료 기간(분)입니다.
--format 출력이 인쇄되는 형식
논쟁 존재 설명
호스트 이름 선택사항 속성의 호스트 이름입니다. 호스트 이름이 제공되지 않으면 속성 아래의 모든 호스트( /* )에 대해 토큰이 생성됩니다. 예: www.test.com, www.test1.com

주요 내용

  1. --expiry 값은 1~720분(12시간) 사이여야 합니다. 기본값은 8 hours 입니다.

EdgeWorker ID 복제

고객이 기존 EdgeWorker ID에서 EdgeWorker를 복제할 수 있습니다.

사용법: akamai edgeworkers clone [options]

옵션 설명
-h, --help 출력 사용 정보
--ew이름 EdgeWorker의 이름
--groupId 그룹 식별자
논쟁 존재 설명
리소스계층 ID 필수의 EdgeWorker가 복제될 리소스 계층 ID입니다.

주요 내용

  1. 이 엔드포인트를 사용하면 사용자는 특정 EdgeWorker ID를 복제하여 다른 리소스 계층 ID를 선택할 수 있습니다. 동일한 리소스 계층에 대한 복제는 실패합니다.

계약 나열

사용자가 액세스할 수 있는 계약 ID 목록입니다.

사용법: akamai list-contracts

옵션 설명
-h, --help 출력 사용 정보

목록 속성

특정 EdgeWorker ID와 연결된 속성 목록입니다.

사용법: akamai edgeworkers list-properties [options]

옵션 설명
-h, --help 출력 사용 정보
--activeOnly 활성 속성만 반환
논쟁 존재 설명
edgeworker 식별자 필수의 EdgeWorker 식별자입니다.

주요 내용

  1. 사용자에게 계정 아래의 최상위 그룹에 대한 액세스 권한이 없거나 이 그룹에 대한 관리자 역할이 없는 경우 반환된 부울 LimitedAccessToProperties는 true입니다.

목록 제한

EdgeWorkers가 활성화 수, EdgeWorkers ID 및 배포할 수 있는 버전에 부과하는 다양한 제한을 나열합니다.

사용법: akamai edgeworkers list-limits [options]

옵션 설명
-h, --help 출력 사용 정보

특정 계약 ID에 대한 리소스 계층 나열

EdgeWorker ID를 생성하거나 복제하는 데 사용할 수 있는 리소스 계층을 나열합니다.

사용법: akamai list-restiers

옵션 설명
--contractId 지정된 계약 ID에 대한 리소스 계층입니다.
-h, --help 출력 사용 정보

주요 내용

  1. 사용자가 액세스할 수 있는 계약 ID 목록이 표시됩니다. 선택한 계약 ID는 리소스 계층을 가져오는 데 사용됩니다.

  2. 자동화 목적으로 프롬프트를 비활성화하려면 계약 ID를 입력으로 제공할 수 있습니다.

특정 EdgeWorker ID에 대한 리소스 계층 가져오기

고객은 특정 EdgeWorker ID에 대한 리소스 계층 세부 정보를 얻을 수 있습니다.

사용법: akamai show-restier

옵션 설명
-h, --help 출력 사용 정보
논쟁 존재 설명
edgeworkerID 필수의 EdgeWorker 식별자

사용 가능한 EdgeWorkers 보고서 유형 가져오기

EdgeWorker ID에 대해 생성할 수 있는 사용 가능한 보고서 유형을 나열합니다.

사용법: akamai get reports

옵션 설명
-h, --help 출력 사용 정보

주요 내용

  1. 사용자에게는 ReportId가 포함된 테이블과 각 보고서에 대한 설명이 제공됩니다. 지정된 EdgeWorker에 대한 보고서를 가져오려면 get report 명령과 함께 지정된 ReportId를 사용합니다.

EdgeWorker 보고서 받기

특정 EdgeWorker ID에 대한 보고서를 가져옵니다.

사용법: akamai get report

옵션 존재 설명
-h, --help 선택 과목 출력 사용 정보
-s, --startDate 필수의 EdgeWorkers 보고서의 시작 시간을 나타내는 ISO 8601 타임스탬프입니다.
-e, --endDate 선택 과목 EdgeWorkers 보고서의 종료 시간을 나타내는 ISO 8601 타임스탬프입니다. 지정하지 않으면 종료 시간은 기본적으로 현재 시간으로 설정됩니다.
--status 선택 과목 EdgeWorkers 상태별로 필터링하기 위한 쉼표로 구분된 문자열입니다. 값: success , genericError , unknownEdgeWorkerId , unimplementedEventHandler , runtimeError , executionError , timeoutError , resourceLimitHit , cpuTimeoutError , wallTimeoutError , initCpuTimeoutError , initWallTimeoutError .
--ev, --eventHandlers 선택 과목 EdgeWorkers를 트리거하는 이벤트별로 필터링하기 위한 쉼표로 구분된 문자열입니다. 값: onClientRequest , onOriginRequest , onOriginResponse , onClientResponse , responseProvider .
논쟁 존재 설명
보고서 ID 필수의 보고서 유형.
edgeworker 식별자 필수의 EdgeWorker 식별자입니다.

주요 내용

  1. 사용 가능한 보고서 ID 목록을 보려면 get reports 명령을 사용하세요.

  2. startDate 옵션은 필수 옵션입니다.

구성 파일 섹션의 모든 기본값 나열

구성 파일의 섹션에서 모든 기본 속성을 가져옵니다.

사용법: akamai config list

옵션 존재 설명
-h, --help 선택 과목 출력 사용 정보

주요 내용

  1. config 섹션은 기본적으로 default 입니다. 다른 섹션을 사용하려면 사용자는 --configSection 옵션과 함께 akamai edgeworkers 명령을 지정해야 합니다.

  2. 다음 config 명령에도 동일한 접근 방식을 적용해야 합니다.

구성 파일에서 섹션의 기본값 가져오기

구성 파일의 섹션에서 하나의 특정 기본값을 가져옵니다.

사용법: akamai config get

옵션 존재 설명
-h, --help 선택 과목 출력 사용 정보
논쟁 존재 설명
열쇠 필수의 기본 속성의 이름

구성 파일 섹션의 기본값 설정/업데이트

고객이 구성 파일의 섹션에서 특정 기본값을 설정/업데이트할 수 있습니다.

사용법: akamai config set

옵션 존재 설명
-h, --help 선택 과목 출력 사용 정보
논쟁 존재 설명
열쇠 필수의 기본 속성의 이름
값 필수의 기본 속성의 값

구성 파일에서 섹션의 기본값 설정 해제

고객이 구성 파일의 섹션에서 특정 기본값을 설정 해제할 수 있습니다.

사용법: akamai config unset

옵션 존재 설명
-h, --help 선택 과목 출력 사용 정보
논쟁 존재 설명
열쇠 필수의 기본 속성의 이름

구성 파일의 섹션에 대한 대량 저장 기본 속성

고객이 기본값을 대량으로 저장할 수 있습니다.

사용법: akamai config save [options]

옵션 존재 설명
-h, --help 선택 과목 출력 사용 정보
-p, --속성 필수의 구성 속성. 속성을 설정하려면 'key=value' 형식을 사용하고 이를 분할하려면 공백을 사용하세요.

주요 내용

  1. 컨텍스트에 잘못된 항목이 포함된 경우 명령은 해당 항목을 건너뛰고 계속됩니다.

EdgeWorker의 현재 로깅 수준 보기

고객이 Edgeworker에 대한 로깅 수준 재정의 세부정보를 볼 수 있습니다.

사용법: akamai edgeworkers log-level get [options] [logging-identifier]

옵션 존재 설명
-h, --help 선택 과목 출력 사용 정보
논쟁 존재 설명
edgeworker 식별자 필수의 로깅 수준 재정의 정보를 표시할 EdgeWorker 식별자입니다.
로깅 식별자 선택 과목 표시할 로깅 수준 재정의의 로깅 ID입니다.

주요 내용

  1. logging-identifier 지정하지 않으면 모든 로깅 수준 재정의가 표시됩니다.

  2. logging-identifier 로그 수준 재정의를 식별하는 숫자 상수입니다. 재정의 생성 중에 또는 선택적 인수를 제공하지 않고 모든 재정의를 나열하고 특정 재정의의 loggingId 필드를 조회하여 얻을 수 있습니다.

EdgeWorker의 현재 로깅 수준 설정

고객이 EdgeWorker에 대한 로깅 수준을 설정할 수 있습니다.

사용법: akamai edgeworkers log-level set [options]

옵션 존재 설명
-h, --help 선택 과목 출력 사용 정보
--만료 선택 과목 사용자의 로깅 수준 재정의가 적용될 기간을 지정합니다. 이를 통과한 후에는 로깅 수준이 번들에 지정된 기본값으로 되돌아갑니다.
--ds2Id 선택 과목 EdgeWorker의 bundle.json 파일에 지정된 것과 함께 사용할 Datastream ID입니다.
논쟁 존재 설명
edgeworker 식별자 필수의 로깅 수준을 변경할 EdgeWorker 식별자입니다.
회로망 필수의 새 로깅 수준을 적용할 네트워크입니다. "프로덕션" 또는 "스테이징"입니다.
수준 필수의 EdgeWorker에 적용할 새로운 로깅 수준입니다. 가능한 값은 고객 로깅 설명서를 참조하세요.

주요 내용

  1. 가장 최근에 생성된 로그 수준 재정의만 적용됩니다.

  2. 재정의가 만료되면 로깅 수준은 Edgeworker의 bundle.json 파일에 지정된 수준으로 재설정됩니다.

  3. 명령이 성공하면 재정의의 loggingId 포함하는 로그 수준 재정의 세부 정보가 인쇄됩니다. log-level get 하위 명령을 사용하고 이를 logging-identifier 선택적 인수에 전달하면 언제든지 loggingId 사용하여 이러한 세부 정보를 얻을 수 있습니다.

  4. --expires 옵션이 지정되지 않은 경우 기본값은 재정의가 만료되지 않는 것입니다.

  5. --expires 옵션은 자연어 입력과 표준 타임스탬프를 모두 지원합니다. 전체 사양은 chrono 패키지 문서를 참조하세요.

예

  1. 프로덕션 네트워크의 로그 수준 재정의를 정보 수준으로 설정합니다. 이 정보는 1시간 후에 만료됩니다. 

./akamai-edgeworkers log-level set 654321 production info --expires 1h

  1. 스테이징 네트워크의 로그 수준 재정의를 추적 수준으로 설정합니다. 추적 수준은 2024년 8월 13일 오후 3시 CEST(중앙 유럽 서머타임)에 만료됩니다. 

./akamai-edgeworkers log-level set 654321 staging trace --expires "2024-08-13T15:00+02:00"

자원

EdgeWorkers에 대한 자세한 내용은 다음 리소스를 참조하세요.

  • EdgeWorkers 개발자 페이지

  • EdgeWorkers 사용자 가이드

  • EdgeWorkers API 가이드

보고 문제

모든 준비가 완료되었습니다. 즐거운 코딩 되세요! EdgeWorkers CLI에 문제가 발생하면 github 문제로 제기하세요. 수정 사항이나 제안 사항이 포함된 끌어오기 요청을 자유롭게 작성하세요.

기여

Akamai 직원, 고객 또는 기타 사람들의 기여를 환영합니다. PR을 시작하기 전에 다음 사항을 다시 확인하세요.

  1. PR과 함께 사용할 몇 가지 테스트 사례를 추가하세요. 이를 통해 PR에 추가되거나 수정된 ​​기능을 확인하고 코드가 작동함을 다른 사람에게 증명합니다. :)

  2. 코드가 모든 커밋 전 검사를 통과했는지 확인하세요. 코드는 성공적으로 빌드되고 모든 단위 테스트를 통과하며 Linting 문제가 없어야 합니다.

  3. 모든 PR은 마스터가 아닌 개발을 목표로 해야 합니다. 마스터로 병합은 모든 고객에게 즉시 릴리스됩니다.

확장하다
추가 정보
관련 버전
추천
관련 정보 전체
사용자 리뷰