Partilhar via

az staticwebapp backends

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

Comandos

Name Description Tipo Status
az staticwebapp backends link

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

 Core disponibilidade geral
az staticwebapp backends show

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

 Core disponibilidade geral
az staticwebapp backends unlink

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

 Core disponibilidade geral
az staticwebapp backends validate

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

 Core disponibilidade geral

Vincule 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" ou "Dedicado". Os tipos de back-end suportados 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. Consulte 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>.

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--backend-region

Região do recurso de back-end.

--environment-name

Nome do ambiente do site estático.

Propriedade Valor
Default value: default
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Default value: False

az staticwebapp backends show

Mostrar detalhes no 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 estáticos de aplicativos Web para ambiente.

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

Parâmetros Obrigatórios

--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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--environment-name

Nome do ambiente do site estático.

Propriedade Valor
Default value: default
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Default value: False

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 estáticos de aplicativos.

az staticwebapp backends unlink -n MyStaticAppName -g MyResourceGroup

Desvincule o back-end do ambiente estático do aplicativo Web 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>.

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--environment-name

Nome do ambiente do site estático.

Propriedade Valor
Default value: default
--remove-backend-auth

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

Propriedade Valor
Default value: False
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Default value: False

az staticwebapp backends validate

Valide 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" ou "Dedicado". Os tipos de back-end suportados 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. Consulte 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 Obrigatórios

--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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--backend-region

Região do recurso de back-end.

--environment-name

Nome do ambiente do site estático.

Propriedade Valor
Default value: default
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Default value: False