Compartilhar via


az staticwebapp backends

Vincular ou desvincular um back-end existente a um aplicativo Web estático. Também conhecido como "Traga sua própria API.".

Comandos

Nome Description Tipo Status
az staticwebapp backends link

Vincular um back-end a um aplicativo Web estático. Também conhecido como "Traga sua própria API.".

Núcleo GA
az staticwebapp backends show

Mostrar detalhes sobre o back-end vinculado a um aplicativo Web estático.

Núcleo GA
az staticwebapp backends unlink

Desvincule o back-end de um aplicativo Web estático.

Núcleo GA
az staticwebapp backends validate

Validar um back-end para um aplicativo Web estático.

Núcleo GA

Vincular um back-end a um aplicativo Web estático. Também conhecido como "Traga sua própria API.".

Apenas um back-end está disponível para um único aplicativo Web estático. Se um back-end foi vinculado anteriormente a outro aplicativo Web estático, a configuração de autenticação deve primeiro ser removida do back-end antes de vincular a um aplicativo Web estático diferente. O SKU do aplicativo Web estático deve ser "Padrão". Os tipos de back-end com suporte são Azure Functions, Azure API Management, Azure App Service, Azure Container Apps. A região de back-end deve ser fornecida para back-ends do tipo Azure Functions e Serviço de Aplicativo do Azure. Veja https://learn.microsoft.com/azure/static-web-apps/apis-overview para saber mais.

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

Vincular um back-end a um aplicativo Web estático

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

Vincular um back-end a um ambiente de aplicativo Web estático

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 do recurso do back-end a ser vinculado.

--name -n

Nome do site estático.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--backend-region

Região do recurso de back-end.

--environment-name

Nome do ambiente do site estático.

valor padrão: default
Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az staticwebapp backends show

Mostrar detalhes sobre o back-end vinculado a um aplicativo Web estático.

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

Exemplos

Mostrar back-ends estáticos de aplicativos Web.

az staticwebapp backends show -n MyStaticAppName -g MyResourceGroup

Mostrar back-ends de aplicativo Web estático para o ambiente.

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

Parâmetros Exigidos

--name -n

Nome do site estático.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--environment-name

Nome do ambiente do site estático.

valor padrão: default
Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

Desvincule o back-end de um aplicativo Web estático.

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

Desvincule back-ends de aplicativos estáticos.

az staticwebapp backends unlink -n MyStaticAppName -g MyResourceGroup

Desvincule o back-end do ambiente de aplicativo Web estático e remova a configuração de autenticação do back-end.

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

Nome do site estático.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--environment-name

Nome do ambiente do site estático.

valor padrão: default
--remove-backend-auth

Se definido como true, remove o provedor de identidade configurado no back-end durante o processo de vinculação.

valor padrão: False
Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az staticwebapp backends validate

Validar um back-end para um aplicativo Web estático.

Apenas um back-end está disponível para um único aplicativo Web estático. Se um back-end foi vinculado anteriormente a outro aplicativo Web estático, a configuração de autenticação deve primeiro ser removida do back-end antes de vincular a um aplicativo Web estático diferente. O SKU do aplicativo Web estático deve ser "Padrão". Os tipos de back-end com suporte são Azure Functions, Azure API Management, Azure App Service, Azure Container Apps. A região de back-end deve ser fornecida para back-ends do tipo Azure Functions e Serviço de Aplicativo do Azure. Veja https://learn.microsoft.com/azure/static-web-apps/apis-overview para saber mais.

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

Exemplos

Validar um back-end para um aplicativo Web estático

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

Validar um back-end para um ambiente de aplicativo Web estático

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

Parâmetros Exigidos

--backend-resource-id

ID do recurso do back-end a ser vinculado.

--name -n

Nome do site estático.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--backend-region

Região do recurso de back-end.

--environment-name

Nome do ambiente do site estático.

valor padrão: default
Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.