Share via

az sf managed-service

  • Referência

Gerencie serviços em execução em um cluster gerenciado do Azure Service Fabric. Suporta apenas serviços implantados por ARM.

Comandos

Name Description Tipo Estado
az sf managed-service correlation-scheme

Gerencie esquemas de correlação de serviços em execução em um cluster gerenciado do Azure Service Fabric. Suporta apenas serviços implantados por ARM.

 Principal GA
az sf managed-service correlation-scheme create

Crie um novo esquema de correlação de serviço gerenciado em um cluster gerenciado do Azure Service Fabric.

 Principal GA
az sf managed-service correlation-scheme delete

Exclua um esquema de correlação de serviço gerenciado.

 Principal GA
az sf managed-service correlation-scheme update

Atualize um esquema de correlação de serviço gerenciado.

 Principal GA
az sf managed-service create

Crie um novo serviço gerenciado em um cluster gerenciado do Azure Service Fabric.

 Principal GA
az sf managed-service delete

Exclua um serviço gerenciado.

 Principal GA
az sf managed-service list

Listar serviços gerenciados de um determinado aplicativo gerenciado.

 Principal GA
az sf managed-service load-metrics

Gerencie métricas de carga de serviço em execução em um cluster gerenciado do Azure Service Fabric. Suporta apenas serviços implantados por ARM.

 Principal GA
az sf managed-service load-metrics create

Crie uma nova métrica de carga de serviço gerenciado em um cluster gerenciado do Azure Service Fabric.

 Principal GA
az sf managed-service load-metrics delete

Exclua um serviço gerenciado.

 Principal GA
az sf managed-service load-metrics update

Atualize um serviço gerenciado.

 Principal GA
az sf managed-service show

Obtenha um serviço.

 Principal GA
az sf managed-service update

Atualize um serviço gerenciado.

 Principal GA

az sf managed-service create

Crie um novo serviço gerenciado em um cluster gerenciado do Azure Service Fabric.

az sf managed-service create --application
                             --cluster-name
                             --name
                             --resource-group
                             --service-type
                             --state {Stateful, Stateless}
                             [--activation-mode]
                             [--default-move-cost {High, Low, Medium, Zero}]
                             [--has-persisted-state {false, true}]
                             [--high-key]
                             [--instance-count]
                             [--keep-duration]
                             [--low-key]
                             [--min-inst-pct]
                             [--min-instance-count]
                             [--min-replica]
                             [--partition-count]
                             [--partition-names]
                             [--partition-scheme {Named, Singleton, UniformInt64Range}]
                             [--placement-constraints]
                             [--plcmt-time-limit]
                             [--quorum-loss-wait]
                             [--replica-restart-wait]
                             [--tags]
                             [--target-replica]

Exemplos

Crie um novo serviço gerenciado sem monitoração de estado "testService1" com contagem de instâncias -1 (em todos os nós).

az sf managed-service create -g testRG -c testCluster --application-name testApp --state stateless --service-name testService \
  --service-type testStateless --instance-count -1 --partition-scheme singleton

Crie um novo serviço stateful "testService2" com um destino de 5 nós.

az sf managed-service create -g testRG -c testCluster --application-name testApp --state stateful --service-name testService2 --has-persisted-state \
  --service-type testStatefulType --min-replica-set-size 3 --target-replica-set-size 5 --partition-scheme uniformint64range --partition-count 1 --low-key 0 --high-key 25

Parâmetros Obrigatórios

--application --application-name

Especifique o nome do serviço.

--cluster-name -c

Especifique o nome do cluster, se não for fornecido, será igual ao nome do grupo de recursos.

--name --service-name

Especifique o nome do serviço.

--resource-group -g

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

--service-type --type

Especifique o nome do tipo de serviço do aplicativo, ele deve existir no manifesto do aplicativo.

--state

Especifique se o serviço é stateless ou stateful.

valores aceites: Stateful, Stateless

Parâmetros Opcionais

--activation-mode --package-activation-mode --service-package-activation-mode

Especifique o modo de ativação do pacote de serviço.

--default-move-cost

Especifique o custo padrão para uma movimentação. Custos mais altos tornam menos provável que o Gerenciador de Recursos de Cluster mova a réplica ao tentar equilibrar o cluster.

valores aceites: High, Low, Medium, Zero
--has-persisted-state

Determina se este é um serviço persistente que armazena estados no disco local. Se for, então o valor desta propriedade é true, se não é false.

valores aceites: false, true
--high-key

Especifique o limite superior do intervalo de chaves de partição que deve ser dividido entre a partição 'Contagem' Isso só é usado com o esquema de partição UniformInt64.

--instance-count

Especifique a contagem de instâncias para o serviço sem monitoração de estado. Se -1 for usado, isso significa que ele será executado em todos os nós.

--keep-duration --stand-by-keep-duration --stand-by-replica-keep-duration

Especifique a definição por quanto tempo as réplicas em espera devem ser mantidas antes de serem removidas, representadas no formato ISO 8601 "hh:mm:ss".

--low-key

Especifique o limite inferior do intervalo de chaves de partição que deve ser dividido entre a partição 'Contagem' Isso só é usado com o esquema de partição UniformInt64.

--min-inst-pct --min-instance-percentage

Especifique a porcentagem mínima de InstanceCount que deve estar pronta para atender à verificação de segurança EnsureAvailability durante operações como atualizar ou desativar o nó. O número real usado é max( MinInstanceCount, ceil( MinInstancePercentage/100.0 * InstanceCount) ). Observe que, se InstanceCount estiver definido como -1, durante o cálculo de MinInstancePercentagem, -1 será primeiro convertido no número de nós nos quais as instâncias podem ser colocadas de acordo com as restrições de posicionamento no serviço. Os valores permitidos são de 0 a 100.

--min-instance-count

Especifique o número mínimo de instâncias que devem estar ativas para atender à verificação de segurança EnsureAvailability durante operações como atualizar ou desativar o nó. O número real usado é max( MinInstanceCount, ceil( MinInstancePercentage/100.0 * InstanceCount) ). Observe que, se InstanceCount estiver definido como -1, durante a computação MinInstanceCount -1 será primeiro convertido no número de nós nos quais as instâncias podem ser colocadas de acordo com as restrições de posicionamento no serviço.

--min-replica --min-replica-set-size

Especifique o tamanho mínimo do conjunto de réplicas para o serviço com monitoração de estado.

--partition-count

Especifique o número de partições. Isso só é usado com o esquema de partição UniformInt64.

--partition-names

Especifique a matriz para os nomes das partições. Isso só é usado com o esquema de partição nomeada.

--partition-scheme

Especifique qual esquema de partição usar. As partições singleton são normalmente usadas quando o serviço não requer nenhum roteamento adicional. UniformInt64 significa que cada partição possui um intervalo de chaves int64. Nomeado é geralmente para serviços com dados que podem ser bucketed, dentro de um conjunto limitado. Alguns exemplos comuns de campos de dados usados como chaves de partição nomeadas seriam regiões, códigos postais, grupos de clientes ou outros limites de negócios.

valores aceites: Named, Singleton, UniformInt64Range
valor predefinido: singleton
--placement-constraints

Especifique as restrições de posicionamento como uma cadeia de caracteres. As restrições de posicionamento são expressões booleanas nas propriedades do nó e permitem restringir um serviço a nós específicos com base nos requisitos do serviço. Por exemplo, para colocar um serviço em nós onde NodeType é azul, especifique o seguinte: "NodeColor == blue)".

--plcmt-time-limit --service-placement-time-limit

Especifique a duração durante a qual as réplicas podem permanecer no InBuild antes de relatar que a compilação está presa, representada no formato ISO 8601 "hh:mm:ss".

--quorum-loss-wait --quorum-loss-wait-duration

Especifique a duração máxima durante a qual uma partição pode estar em um estado de perda de quórum, representada no formato ISO 8601 "hh:mm:ss".

--replica-restart-wait --replica-restart-wait-duration

Especifique a duração entre quando uma réplica fica inativa e quando uma nova réplica é criada, representada no formato ISO 8601 "hh:mm:ss".

--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar tags existentes.

--target-replica --target-replica-set-size

Especifique o tamanho do conjunto de réplicas de destino para o serviço com monitoração de estado.

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

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

--verbose

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

az sf managed-service delete

Exclua um serviço gerenciado.

az sf managed-service delete --application
                             --cluster-name
                             --name
                             --resource-group

Exemplos

Excluir serviço gerenciado.

az sf managed-service delete -g testRG -c testCluster --application-name testApp --service-name testService

Parâmetros Obrigatórios

--application --application-name

Especifique o nome do serviço.

--cluster-name -c

Especifique o nome do cluster, se não for fornecido, será igual ao nome do grupo de recursos.

--name --service-name

Especifique o nome do serviço.

--resource-group -g

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

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

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

--verbose

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

az sf managed-service list

Listar serviços gerenciados de um determinado aplicativo gerenciado.

az sf managed-service list --application
                           --cluster-name
                           --resource-group

Exemplos

Listar serviços gerenciados.

az sf managed-service list -g testRG -c testCluster --application-name testApp

Parâmetros Obrigatórios

--application --application-name

Especifique o nome do serviço.

--cluster-name -c

Especifique o nome do cluster, se não for fornecido, será igual ao nome do grupo de recursos.

--resource-group -g

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

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

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

--verbose

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

az sf managed-service show

Obtenha um serviço.

az sf managed-service show --application
                           --cluster-name
                           --name
                           --resource-group

Exemplos

Mostrar as propriedades de um serviço gerenciado em um cluster gerenciado do Azure Service Fabric.

az sf managed-service show -g testRG -c testCluster --application-name testApp --service-name testService

Parâmetros Obrigatórios

--application --application-name

Especifique o nome do serviço.

--cluster-name -c

Especifique o nome do cluster, se não for fornecido, será igual ao nome do grupo de recursos.

--name --service-name

Especifique o nome do serviço.

--resource-group -g

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

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

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

--verbose

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

az sf managed-service update

Atualize um serviço gerenciado.

az sf managed-service update --application
                             --cluster-name
                             --name
                             --resource-group
                             [--default-move-cost {High, Low, Medium, Zero}]
                             [--instance-count]
                             [--keep-duration]
                             [--min-inst-pct]
                             [--min-instance-count]
                             [--min-replica]
                             [--placement-constraints]
                             [--plcmt-time-limit]
                             [--quorum-loss-wait]
                             [--replica-restart-wait]
                             [--tags]
                             [--target-replica]

Exemplos

Atualize o serviço sem monitoração de estado gerenciado.

az sf managed-service update -g testRG -c testCluster --application-name testApp --service-name testService --min-instance-count 2 \
  --min-instance-percentage 20

Atualize o serviço stateful gerenciado.

az sf managed-service update -g testRG -c testCluster --application-name testApp --service-name testService2 --service-placement-time-limit '00:11:00' \
  --stand-by-replica-keep-duration '00:11:00' --replica-restart-wait-duration '00:11:00' --quorum-loss-wait-duration '00:11:00'

Parâmetros Obrigatórios

--application --application-name

Especifique o nome do serviço.

--cluster-name -c

Especifique o nome do cluster, se não for fornecido, será igual ao nome do grupo de recursos.

--name --service-name

Especifique o nome do serviço.

--resource-group -g

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

Parâmetros Opcionais

--default-move-cost

Especifique o custo padrão para uma movimentação. Custos mais altos tornam menos provável que o Gerenciador de Recursos de Cluster mova a réplica ao tentar equilibrar o cluster.

valores aceites: High, Low, Medium, Zero
--instance-count

Especifique a contagem de instâncias para o serviço sem monitoração de estado. Se -1 for usado, isso significa que ele será executado em todos os nós.

--keep-duration --stand-by-keep-duration --stand-by-replica-keep-duration

Especifique a definição por quanto tempo as réplicas em espera devem ser mantidas antes de serem removidas, representadas no formato ISO 8601 "hh:mm:ss".

--min-inst-pct --min-instance-percentage

Especifique a porcentagem mínima de InstanceCount que deve estar pronta para atender à verificação de segurança EnsureAvailability durante operações como atualizar ou desativar o nó. O número real usado é max( MinInstanceCount, ceil( MinInstancePercentage/100.0 * InstanceCount) ). Observe que, se InstanceCount estiver definido como -1, durante o cálculo de MinInstancePercentagem, -1 será primeiro convertido no número de nós nos quais as instâncias podem ser colocadas de acordo com as restrições de posicionamento no serviço. Os valores permitidos são de 0 a 100.

--min-instance-count

Especifique o número mínimo de instâncias que devem estar ativas para atender à verificação de segurança EnsureAvailability durante operações como atualizar ou desativar o nó. O número real usado é max( MinInstanceCount, ceil( MinInstancePercentage/100.0 * InstanceCount) ). Observe que, se InstanceCount estiver definido como -1, durante a computação MinInstanceCount -1 será primeiro convertido no número de nós nos quais as instâncias podem ser colocadas de acordo com as restrições de posicionamento no serviço.

--min-replica --min-replica-set-size

Especifique o tamanho mínimo do conjunto de réplicas para o serviço com monitoração de estado.

--placement-constraints

Especifique as restrições de posicionamento como uma cadeia de caracteres. As restrições de posicionamento são expressões booleanas nas propriedades do nó e permitem restringir um serviço a nós específicos com base nos requisitos do serviço. Por exemplo, para colocar um serviço em nós onde NodeType é azul, especifique o seguinte: "NodeColor == blue)".

--plcmt-time-limit --service-placement-time-limit

Especifique a duração durante a qual as réplicas podem permanecer no InBuild antes de relatar que a compilação está presa, representada no formato ISO 8601 "hh:mm:ss".

--quorum-loss-wait --quorum-loss-wait-duration

Especifique a duração máxima durante a qual uma partição pode estar em um estado de perda de quórum, representada no formato ISO 8601 "hh:mm:ss".

--replica-restart-wait --replica-restart-wait-duration

Especifique a duração entre quando uma réplica fica inativa e quando uma nova réplica é criada, representada no formato ISO 8601 "hh:mm:ss".

--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar tags existentes.

--target-replica --target-replica-set-size

Especifique o tamanho do conjunto de réplicas de destino para o serviço com monitoração de estado.

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

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

--verbose

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