Freigeben über

az staticwebapp backends

  • Referenz

Verknüpfen oder Aufheben der Verknüpfung eines vorhandenen Back-Ends mit einer statischen Web-App. Auch bekannt als "Bring your own API".

Befehle

Name Beschreibung Typ Status
az staticwebapp backends link

Verknüpfen sie ein Back-End mit einer statischen Web-App. Auch bekannt als "Bring your own API".

 Kern GA
az staticwebapp backends show

Zeigen Sie Details zum Back-End an, das mit einer statischen Web-App verknüpft ist.

 Kern GA
az staticwebapp backends unlink

Heben Sie die Verknüpfung von Back-End aus einer statischen Web-App auf.

 Kern GA
az staticwebapp backends validate

Überprüfen sie ein Back-End für eine statische Web-App.

 Kern GA

Verknüpfen sie ein Back-End mit einer statischen Web-App. Auch bekannt als "Bring your own API".

Nur ein Back-End ist für eine einzelne statische Web-App verfügbar. Wenn ein Back-End zuvor mit einer anderen statischen Web App verknüpft war, muss die Authentifizierungskonfiguration zuerst aus dem Back-End entfernt werden, bevor eine Verknüpfung mit einer anderen statischen Web App hergestellt wird. Die SKU für statische Web-Apps muss "Standard" oder "Dedicated" sein. Unterstützte Back-End-Typen sind Azure Functions, Azure API Management, Azure App Service, Azure Container Apps. Back-End-Region muss für Back-End-Back-End-Typen vom Typ Azure Functions und Azure App Service bereitgestellt werden. Weitere Informationen finden Sie unter https://learn.microsoft.com/azure/static-web-apps/apis-overview.

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

Verknüpfen eines Back-Ends mit einer statischen Web-App

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

Verknüpfen eines Back-End mit einer statischen Web-App-Umgebung

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

Ressourcen-ID des back-End-Back-Ends, das verknüpft werden soll.

--name -n

Name der statischen Website.

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

--backend-region

Region der Back-End-Ressource.

--environment-name

Name der Umgebung der statischen Website.

Standardwert: default
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az staticwebapp backends show

Zeigen Sie Details zum Back-End an, das mit einer statischen Web-App verknüpft ist.

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

Beispiele

Zeigen Sie statische Web-App-Back-Ends an.

az staticwebapp backends show -n MyStaticAppName -g MyResourceGroup

Zeigen Sie statische Web-App-Back-Ends für die Umgebung an.

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

Erforderliche Parameter

--name -n

Name der statischen Website.

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

Optionale Parameter

--environment-name

Name der Umgebung der statischen Website.

Standardwert: default
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Heben Sie die Verknüpfung von Back-End aus einer statischen Web-App auf.

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

Heben Sie die Verknüpfung statischer App-Back-Ends auf.

az staticwebapp backends unlink -n MyStaticAppName -g MyResourceGroup

Heben Sie die Verknüpfung von Back-End aus der statischen Web-App-Umgebung auf, und entfernen Sie die Authentifizierungskonfiguration aus dem Back-End.

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

Name der statischen Website.

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

--environment-name

Name der Umgebung der statischen Website.

Standardwert: default
--remove-backend-auth

Wenn dieser Wert auf "true" festgelegt ist, wird der im Back-End konfigurierte Identitätsanbieter während des Verknüpfungsprozesses entfernt.

Standardwert: False
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az staticwebapp backends validate

Überprüfen sie ein Back-End für eine statische Web-App.

Nur ein Back-End ist für eine einzelne statische Web-App verfügbar. Wenn ein Back-End zuvor mit einer anderen statischen Web App verknüpft war, muss die Authentifizierungskonfiguration zuerst aus dem Back-End entfernt werden, bevor eine Verknüpfung mit einer anderen statischen Web App hergestellt wird. Die SKU für statische Web-Apps muss "Standard" oder "Dedicated" sein. Unterstützte Back-End-Typen sind Azure Functions, Azure API Management, Azure App Service, Azure Container Apps. Back-End-Region muss für Back-End-Back-End-Typen vom Typ Azure Functions und Azure App Service bereitgestellt werden. Weitere Informationen finden Sie unter https://learn.microsoft.com/azure/static-web-apps/apis-overview.

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

Beispiele

Überprüfen eines Back-End für eine statische Web-App

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

Überprüfen eines Back-End für eine statische Web-App-Umgebung

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

Erforderliche Parameter

--backend-resource-id

Ressourcen-ID des back-End-Back-Ends, das verknüpft werden soll.

--name -n

Name der statischen Website.

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

Optionale Parameter

--backend-region

Region der Back-End-Ressource.

--environment-name

Name der Umgebung der statischen Website.

Standardwert: default
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.