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 backend suportados são Funções do Azure, API Management do Azure, Serviço de Aplicações do Azure, Azure Container Apps. A região backend deve ser fornecida para backends do tipo Funções do Azure e Serviço de Aplicações 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
                              [--acquire-policy-token]
                              [--backend-region]
                              [--change-reference]
                              [--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.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--backend-region

Região do recurso de back-end.

--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--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
                                [--acquire-policy-token]
                                [--change-reference]
                                [--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.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--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 backend suportados são Funções do Azure, API Management do Azure, Serviço de Aplicações do Azure, Azure Container Apps. A região backend deve ser fornecida para backends do tipo Funções do Azure e Serviço de Aplicações 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
                                  [--acquire-policy-token]
                                  [--backend-region]
                                  [--change-reference]
                                  [--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.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--backend-region

Região do recurso de back-end.

--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--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