az spring gateway

참고 항목

이 참조는 Azure CLI(버전 2.56.0 이상)에 대한 스프링 확장의 일부입니다. az spring gateway 명령을 처음 실행할 때 확장이 자동으로 설치됩니다. 확장 프로그램에 대해 자세히 알아보세요.

(엔터프라이즈 계층에만 해당) Azure Spring Apps에서 게이트웨이를 관리하는 명령입니다.

명령

Name	Description	형식	상태
az spring gateway clear	게이트웨이의 모든 설정을 지웁니다.	내선 번호	GA
az spring gateway create	Spring Cloud Gateway를 만듭니다.	내선 번호	GA
az spring gateway custom-domain	게이트웨이에 대한 사용자 지정 do기본를 관리하는 명령입니다.	내선 번호	GA
az spring gateway custom-domain bind	게이트웨이에 사용자 지정 do기본 바인딩합니다.	내선 번호	GA
az spring gateway custom-domain list	게이트웨이의 모든 사용자 지정 작업기본 나열합니다.	내선 번호	GA
az spring gateway custom-domain show	사용자 지정 do기본 세부 정보를 표시합니다.	내선 번호	GA
az spring gateway custom-domain unbind	게이트웨이의 custom-do기본 바인딩을 해제합니다.	내선 번호	GA
az spring gateway custom-domain update	게이트웨이의 사용자 지정 do기본 업데이트합니다.	내선 번호	GA
az spring gateway delete	Spring Cloud Gateway를 삭제합니다.	내선 번호	GA
az spring gateway restart	Spring Cloud Gateway를 다시 시작합니다.	내선 번호	GA
az spring gateway route-config	Azure Spring Apps에서 게이트웨이 경로 구성을 관리하는 명령입니다.	내선 번호	GA
az spring gateway route-config create	Json 배열 형식의 라우팅 규칙을 사용하여 게이트웨이 경로 구성을 만듭니다.	내선 번호	GA
az spring gateway route-config list	모든 기존 게이트웨이 경로 구성을 나열합니다.	내선 번호	GA
az spring gateway route-config remove	기존 게이트웨이 경로 구성을 삭제합니다.	내선 번호	GA
az spring gateway route-config show	기존 게이트웨이 경로 구성을 가져옵니다.	내선 번호	GA
az spring gateway route-config update	Json 배열 형식의 라우팅 규칙을 사용하여 기존 게이트웨이 경로 구성을 업데이트합니다.	내선 번호	GA
az spring gateway show	게이트웨이의 설정, 프로비저닝 상태 및 런타임 상태 표시합니다.	내선 번호	GA
az spring gateway sync-cert	게이트웨이의 인증서를 동기화합니다.	내선 번호	GA
az spring gateway update	기존 게이트웨이 속성을 업데이트합니다.	내선 번호	GA

az spring gateway clear

게이트웨이의 모든 설정을 지웁니다.

az spring gateway clear --resource-group
                        --service
                        [--no-wait]

필수 매개 변수

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--service -s

Azure Spring Apps 인스턴스의 이름으로, az configure --defaults spring=를 사용하여 기본 서비스를 구성할 수 있습니다.

선택적 매개 변수

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

Default value: False

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az spring gateway create

Spring Cloud Gateway를 만듭니다.

az spring gateway create --resource-group
                         --service
                         [--instance-count]

예제

Spring Cloud Gateway를 만듭니다.

az spring gateway create -s MyService -g MyResourceGroup --instance-count 2

필수 매개 변수

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--service -s

Azure Spring Apps 인스턴스의 이름으로, az configure --defaults spring=를 사용하여 기본 서비스를 구성할 수 있습니다.

선택적 매개 변수

--instance-count

인스턴스 수입니다.

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az spring gateway delete

Spring Cloud Gateway를 삭제합니다.

az spring gateway delete --resource-group
                         --service
                         [--yes]

필수 매개 변수

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--service -s

Azure Spring Apps 인스턴스의 이름으로, az configure --defaults spring=를 사용하여 기본 서비스를 구성할 수 있습니다.

선택적 매개 변수

--yes -y

확인을 묻는 메시지를 표시하지 마세요.

Default value: False

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az spring gateway restart

Spring Cloud Gateway를 다시 시작합니다.

az spring gateway restart --resource-group
                          --service
                          [--no-wait]
                          [--yes]

예제

Spring Cloud Gateway를 다시 시작합니다.

az spring gateway restart -s MyService -g MyResourceGroup

필수 매개 변수

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--service -s

Azure Spring Apps 인스턴스의 이름으로, az configure --defaults spring=를 사용하여 기본 서비스를 구성할 수 있습니다.

선택적 매개 변수

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

Default value: False

--yes -y

확인을 묻는 메시지를 표시하지 마세요.

Default value: False

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az spring gateway show

게이트웨이의 설정, 프로비저닝 상태 및 런타임 상태 표시합니다.

az spring gateway show --resource-group
                       --service

필수 매개 변수

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--service -s

Azure Spring Apps 인스턴스의 이름으로, az configure --defaults spring=를 사용하여 기본 서비스를 구성할 수 있습니다.

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az spring gateway sync-cert

게이트웨이의 인증서를 동기화합니다.

az spring gateway sync-cert --resource-group
                            --service
                            [--no-wait]
                            [--yes]

예제

게이트웨이의 인증서를 동기화합니다.

az spring gateway sync-cert -s MyService -g MyResourceGroup

필수 매개 변수

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--service -s

Azure Spring Apps 인스턴스의 이름으로, az configure --defaults spring=를 사용하여 기본 서비스를 구성할 수 있습니다.

선택적 매개 변수

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

Default value: False

--yes -y

확인을 묻는 메시지를 표시하지 마세요.

Default value: False

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az spring gateway update

기존 게이트웨이 속성을 업데이트합니다.

az spring gateway update --resource-group
                         --service
                         [--addon-configs-file]
                         [--addon-configs-json]
                         [--allow-credentials {false, true}]
                         [--allow-origin-patterns]
                         [--allowed-headers]
                         [--allowed-methods]
                         [--allowed-origins]
                         [--api-description]
                         [--api-doc-location]
                         [--api-title]
                         [--api-version]
                         [--apm-types]
                         [--apms]
                         [--assign-endpoint {false, true}]
                         [--certificate-names]
                         [--client-id]
                         [--client-secret]
                         [--cpu]
                         [--enable-cert-verify {false, true}]
                         [--enable-response-cache {false, true}]
                         [--exposed-headers]
                         [--https-only {false, true}]
                         [--instance-count]
                         [--issuer-uri]
                         [--max-age]
                         [--memory]
                         [--no-wait]
                         [--properties]
                         [--response-cache-scope]
                         [--response-cache-size]
                         [--response-cache-ttl]
                         [--scope]
                         [--secrets]
                         [--server-url]

예제

게이트웨이 속성을 업데이트합니다.

az spring gateway update -s MyService -g MyResourceGroup --assign-endpoint true --https-only true

경로 수준에서 응답 캐시를 사용하도록 설정하고 구성하고 ttl을 5분으로 설정합니다.

az spring gateway update -s MyService -g MyResourceGroup --enable-response-cache --response-cache-scope Route --response-cache-ttl 5m

응답 캐시를 사용하도록 설정하면 ttl을 3분으로 업데이트합니다.

az spring gateway update -s MyService -g MyResourceGroup --response-cache-ttl 3m

응답 캐시를 사용하지 않도록 설정합니다.

az spring gateway update -s MyService -g MyResourceGroup --enable-response-cache false

필수 매개 변수

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--service -s

Azure Spring Apps 인스턴스의 이름으로, az configure --defaults spring=를 사용하여 기본 서비스를 구성할 수 있습니다.

선택적 매개 변수

--addon-configs-file

추가 기능 구성의 JSON 문자열 파일 경로입니다.

--addon-configs-json

추가 기능 구성의 JSON 문자열입니다.

--allow-credentials

사이트 간 요청에서 사용자 자격 증명이 지원되는지 여부

허용되는 값: false, true

--allow-origin-patterns --allowed-origin-patterns

사이트 간 요청을 할 수 있는 허용된 원본 패턴의 쉼표로 구분된 목록입니다.

--allowed-headers

사이트 간 요청에서 허용된 헤더의 쉼표로 구분된 목록입니다. 특수 값을 * 사용하면 실제 요청에서 헤더를 보낼 수 있습니다.

--allowed-methods

사이트 간 요청에 대해 허용된 HTTP 메서드의 쉼표로 구분된 목록입니다. 특수 값 * 은 모든 메서드를 허용합니다.

--allowed-origins

사이트 간 요청을 할 수 있도록 허용된 원본의 쉼표로 구분된 목록입니다. 특수 값을 * 사용하면 모든 작업을 수행할 수 기본.

--api-description

게이트웨이 인스턴스에서 사용할 수 있는 API에 대한 자세한 설명입니다.

--api-doc-location

게이트웨이 인스턴스에서 사용할 수 있는 API에 대한 추가 설명서의 위치입니다.

--api-title

게이트웨이 인스턴스에서 사용할 수 있는 API의 컨텍스트를 설명하는 제목입니다.

--api-version

이 게이트웨이 인스턴스에서 사용할 수 있는 API 버전입니다.

--apm-types

게이트웨이와 통합된 APM의 공간으로 구분된 목록입니다. 허용되는 값은 ApplicationInsights, AppDynamics, Dynatrace, NewRelic, ElasticAPM입니다.

--apms

게이트웨이와 통합할 Azure Spring Apps의 APM 참조 이름에 대한 공간으로 구분된 목록입니다.

--assign-endpoint

true이면 직접 액세스를 위해 엔드포인트 URL을 할당합니다.

허용되는 값: false, true

--certificate-names

Azure Spring Apps에서 쉼표로 구분된 인증서 이름 목록입니다.

--client-id

애플리케이션의 공용 식별자입니다.

--client-secret

애플리케이션 및 권한 부여 서버에만 알려진 비밀입니다.

--cpu

CPU 리소스 수량입니다. 500m 또는 CPU 코어 수여야 합니다.

--enable-cert-verify --enable-certificate-verification

true이면 게이트웨이에서 앱으로의 TLS 연결에서 인증서를 확인합니다.

허용되는 값: false, true

--enable-response-cache

Spring Cloud Gateway에서 응답 캐시 설정을 사용하도록 설정합니다.

허용되는 값: false, true

--exposed-headers

사이트 간 요청에 노출할 HTTP 응답 헤더의 쉼표로 구분된 목록입니다.

--https-only

true이면 https를 통해 엔드포인트에 액세스합니다.

허용되는 값: false, true

--instance-count

인스턴스 수입니다.

--issuer-uri

발급자 식별자의 URI입니다.

--max-age

클라이언트가 플라이트 전 요청의 응답을 캐시할 수 있는 기간(초)

--memory

메모리 리소스 수량입니다. 512Mi 또는 #Gi(예: 1Gi, 3Gi)이어야 합니다.

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

Default value: False

--properties

환경 변수에 대한 민감하지 않은 속성입니다. "key[=value]" 형식을 지정하고 공백으로 구분합니다.

--response-cache-scope

응답 캐시의 범위, 사용 가능한 값은 [Route, Instance]입니다.

--response-cache-size

캐시에서 일부 항목을 제거해야 하는지 여부를 결정하는 캐시의 최대 크기입니다. 예는 [1GB, 10MB, 100KB]입니다. "기본값"을 사용하여 다시 설정하면 게이트웨이에서 이 속성을 관리합니다.

--response-cache-ttl

캐시된 항목이 만료되기까지의 시간입니다. 예는 [1h, 30m, 50s]입니다. "기본값"을 사용하여 다시 설정하면 게이트웨이에서 이 속성을 관리합니다.

--scope

쉼표로 구분된 특정 작업 애플리케이션 목록은 사용자를 대신하여 수행할 수 있습니다.

--secrets

환경 변수에 대한 중요한 속성입니다. 일단 넣으면 암호화되고 반환되지 않습니다. "key[=value]" 형식을 지정하고 공백으로 구분합니다.

--server-url

API 소비자가 게이트웨이 인스턴스의 API에 액세스하는 데 사용하는 기본 URL입니다.

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.