다음을 통해 공유


az staticwebapp backends

정적 웹앱을 사용하여 기존 백 엔드를 연결하거나 연결 해제합니다. "Bring Your Own API"라고도 합니다.

명령

Name Description 형식 상태
az staticwebapp backends link

백 엔드를 정적 웹앱에 연결합니다. "Bring Your Own API"라고도 합니다.

핵심 GA
az staticwebapp backends show

정적 웹앱에 연결된 백 엔드에 대한 세부 정보를 표시합니다.

핵심 GA
az staticwebapp backends unlink

정적 웹앱에서 백 엔드 연결을 해제합니다.

핵심 GA
az staticwebapp backends validate

정적 웹앱에 대한 백 엔드의 유효성을 검사합니다.

핵심 GA

백 엔드를 정적 웹앱에 연결합니다. "Bring Your Own API"라고도 합니다.

단일 정적 웹앱에는 하나의 백 엔드만 사용할 수 있습니다. 백 엔드가 이전에 다른 정적 웹앱에 연결된 경우 다른 정적 웹앱에 연결하기 전에 먼저 백 엔드에서 인증 구성을 제거해야 합니다. 정적 웹앱 SKU는 "표준"이어야 합니다. 지원되는 백 엔드 유형은 Azure Functions, Azure API Management, Azure 앱 Service, Azure Container Apps입니다. Azure Functions 및 Azure 앱 Service 유형의 백 엔드에 대해 백 엔드 지역을 제공해야 합니다. 자세한 내용은 참조 https://learn.microsoft.com/azure/static-web-apps/apis-overview 하세요.

az staticwebapp backends link --backend-resource-id
                              --name
                              --resource-group
                              [--backend-region]
                              [--environment-name]

정적 웹앱에 백 엔드 연결

az staticwebapp backends link -n MyStaticAppName -g MyResourceGroup --backend-resource-id "/subscriptions/<subscription-id>/resourceGroups/<resource-group>/providers/<resource-provider>/<resource-type>/<backend-name>" --backend-region MyBackendRegion

정적 웹앱 환경에 백 엔드 연결

az staticwebapp backends link -n MyStaticAppName -g MyResourceGroup --environment-name MyEnvironmentName --backend-resource-id "/subscriptions/<subscription-id>/resourceGroups/<resource-group>/providers/<resource-provider>/<resource-type>/<backend-name>" --backend-region MyBackendRegion
--backend-resource-id

연결할 백 엔드의 리소스 ID입니다.

--name -n

정적 사이트의 이름입니다.

--resource-group -g

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

--backend-region

백 엔드 리소스의 지역입니다.

--environment-name

정적 사이트의 환경 이름입니다.

기본값: default
전역 매개 변수
--debug

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

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
기본값: json
--query

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

--subscription

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

--verbose

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

az staticwebapp backends show

정적 웹앱에 연결된 백 엔드에 대한 세부 정보를 표시합니다.

az staticwebapp backends show --name
                              --resource-group
                              [--environment-name]

예제

정적 웹앱 백 엔드를 표시합니다.

az staticwebapp backends show -n MyStaticAppName -g MyResourceGroup

환경에 대한 정적 웹앱 백 엔드를 표시합니다.

az staticwebapp backends show -n MyStaticAppName -g MyResourceGroup --environment-name MyEnvironmentName

필수 매개 변수

--name -n

정적 사이트의 이름입니다.

--resource-group -g

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

선택적 매개 변수

--environment-name

정적 사이트의 환경 이름입니다.

기본값: default
전역 매개 변수
--debug

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

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
기본값: json
--query

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

--subscription

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

--verbose

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

정적 웹앱에서 백 엔드 연결을 해제합니다.

az staticwebapp backends unlink --name
                                --resource-group
                                [--environment-name]
                                [--remove-backend-auth]

정적 앱 백 엔드의 연결을 해제합니다.

az staticwebapp backends unlink -n MyStaticAppName -g MyResourceGroup

정적 웹앱 환경에서 백 엔드의 연결을 해제하고 백 엔드에서 인증 구성을 제거합니다.

az staticwebapp backends unlink -n MyStaticAppName -g MyResourceGroup --environment-name MyEnvironmentName --remove-backend-auth
--name -n

정적 사이트의 이름입니다.

--resource-group -g

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

--environment-name

정적 사이트의 환경 이름입니다.

기본값: default
--remove-backend-auth

true로 설정하면 연결 프로세스 중에 백 엔드에 구성된 ID 공급자를 제거합니다.

기본값: False
전역 매개 변수
--debug

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

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
기본값: json
--query

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

--subscription

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

--verbose

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

az staticwebapp backends validate

정적 웹앱에 대한 백 엔드의 유효성을 검사합니다.

단일 정적 웹앱에는 하나의 백 엔드만 사용할 수 있습니다. 백 엔드가 이전에 다른 정적 웹앱에 연결된 경우 다른 정적 웹앱에 연결하기 전에 먼저 백 엔드에서 인증 구성을 제거해야 합니다. 정적 웹앱 SKU는 "표준"이어야 합니다. 지원되는 백 엔드 유형은 Azure Functions, Azure API Management, Azure 앱 Service, Azure Container Apps입니다. Azure Functions 및 Azure 앱 Service 유형의 백 엔드에 대해 백 엔드 지역을 제공해야 합니다. 자세한 내용은 참조 https://learn.microsoft.com/azure/static-web-apps/apis-overview 하세요.

az staticwebapp backends validate --backend-resource-id
                                  --name
                                  --resource-group
                                  [--backend-region]
                                  [--environment-name]

예제

정적 웹앱에 대한 백 엔드 유효성 검사

az staticwebapp backends validate -n MyStaticAppName -g MyResourceGroup --backend-resource-id "/subscriptions/<subscription-id>/resourceGroups/<resource-group>/providers/<resource-provider>/<resource-type>/<backend-name>" --backend-region MyBackendRegion

정적 웹앱 환경에 대한 백 엔드 유효성 검사

az staticwebapp backends validate -n MyStaticAppName -g MyResourceGroup --environment-name MyEnvironmentName --backend-resource-id "/subscriptions/<subscription-id>/resourceGroups/<resource-group>/providers/<resource-provider>/<resource-type>/<backend-name>" --backend-region MyBackendRegion

필수 매개 변수

--backend-resource-id

연결할 백 엔드의 리소스 ID입니다.

--name -n

정적 사이트의 이름입니다.

--resource-group -g

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

선택적 매개 변수

--backend-region

백 엔드 리소스의 지역입니다.

--environment-name

정적 사이트의 환경 이름입니다.

기본값: default
전역 매개 변수
--debug

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

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
기본값: json
--query

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

--subscription

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

--verbose

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