Compartir vía

az sf managed-service

  • Referencia

Administre los servicios que se ejecutan en un clúster administrado de Azure Service Fabric. Solo admite servicios implementados por ARM.

Comandos

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

Administre esquemas de correlación de servicios que se ejecutan en un clúster administrado de Azure Service Fabric. Solo admite servicios implementados por ARM.

 Principal GA
az sf managed-service correlation-scheme create

Cree un nuevo esquema de correlación de servicio administrado en un clúster administrado de Azure Service Fabric.

 Principal GA
az sf managed-service correlation-scheme delete

Elimine un esquema de correlación de servicio administrado.

 Principal GA
az sf managed-service correlation-scheme update

Actualice un esquema de correlación de servicio administrado.

 Principal GA
az sf managed-service create

Cree un nuevo servicio administrado en un clúster administrado de Azure Service Fabric.

 Principal GA
az sf managed-service delete

Elimine un servicio administrado.

 Principal GA
az sf managed-service list

Enumeración de servicios administrados de una aplicación administrada determinada.

 Principal GA
az sf managed-service load-metrics

Administre las métricas de carga de servicio que se ejecutan en un clúster administrado de Azure Service Fabric. Solo admite servicios implementados por ARM.

 Principal GA
az sf managed-service load-metrics create

Cree una nueva métrica de carga de servicio administrado en un clúster administrado de Azure Service Fabric.

 Principal GA
az sf managed-service load-metrics delete

Elimine un servicio administrado.

 Principal GA
az sf managed-service load-metrics update

Actualice un servicio administrado.

 Principal GA
az sf managed-service show

Obtener un servicio.

 Principal GA
az sf managed-service update

Actualice un servicio administrado.

 Principal GA

az sf managed-service create

Cree un nuevo servicio administrado en un clúster administrado de 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]

Ejemplos

Cree un nuevo servicio administrado sin estado "testService1" con el recuento de instancias -1 (en todos los nodos).

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

Cree un nuevo servicio con estado "testService2" con un destino de 5 nodos.

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 requeridos

--application --application-name

Especifique el nombre del servicio.

--cluster-name -c

Especifique el nombre del clúster, si no se le asigna, será el mismo que el nombre del grupo de recursos.

--name --service-name

Especifique el nombre del servicio.

--resource-group -g

Especifique el nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--service-type --type

Especifique el nombre de tipo de servicio de la aplicación; debe existir en el manifiesto de aplicación.

--state

Especifique si el servicio no tiene estado o tiene estado.

Valores aceptados: Stateful, Stateless

Parámetros opcionales

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

Especifique el modo de activación del paquete de servicio.

--default-move-cost

Especifique el costo predeterminado de un traslado. Los costos más altos hacen que sea menos probable que Cluster Resource Manager mueva la réplica al intentar equilibrar el clúster.

Valores aceptados: High, Low, Medium, Zero
--has-persisted-state

Determina si se trata de un servicio persistente que almacena los estados en el disco local. Si es entonces el valor de esta propiedad es true, si no es false.

Valores aceptados: false, true
--high-key

Especifique el límite superior del intervalo de claves de partición que se debe dividir entre la partición "Count" Esto solo se usa con el esquema de partición UniformInt64.

--instance-count

Especifique el recuento de instancias para el servicio sin estado. Si se usa -1, significa que se ejecutará en todos los nodos.

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

Especifique la definición sobre cuánto tiempo se deben mantener las réplicas StandBy antes de quitarse, representadas en formato ISO 8601 "hh:mm:ss".

--low-key

Especifique el límite inferior del intervalo de claves de partición que se debe dividir entre la partición "Count" Esto solo se usa con el esquema de partición UniformInt64.

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

Especifique el porcentaje mínimo de InstanceCount que debe cumplir la comprobación de seguridad de EnsureAvailability durante las operaciones como actualizar o desactivar el nodo. El número real que se usa es max( MinInstanceCount, ceil( MinInstancePercentage/100.0 * InstanceCount) ). Tenga en cuenta que, si InstanceCount se establece en -1, durante el cálculo de MinInstancePercentage, -1 se convierte primero en el número de nodos en los que se permite colocar las instancias según las restricciones de ubicación del servicio. Los valores permitidos son de 0 a 100.

--min-instance-count

Especifique el número mínimo de instancias que deben cumplir la comprobación de seguridad de EnsureAvailability durante las operaciones como actualizar o desactivar el nodo. El número real que se usa es max( MinInstanceCount, ceil( MinInstancePercentage/100.0 * InstanceCount) ). Tenga en cuenta que, si InstanceCount se establece en -1, durante el cálculo de MinInstanceCount -1 se convierte primero en el número de nodos en los que se permite colocar las instancias según las restricciones de ubicación del servicio.

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

Especifique el tamaño mínimo del conjunto de réplicas para el servicio con estado.

--partition-count

Especifique el número de particiones. Esto solo se usa con el esquema de partición UniformInt64.

--partition-names

Especifique la matriz para los nombres de las particiones. Esto solo se usa con el esquema de partición con nombre.

--partition-scheme

Especifique qué esquema de partición se va a usar. Las particiones de singleton se usan normalmente cuando el servicio no requiere ningún enrutamiento adicional. UniformInt64 significa que cada partición posee un intervalo de claves int64. El nombre suele ser para los servicios con datos que se pueden agrupar en depósitos, dentro de un conjunto limitado. Algunos ejemplos habituales de campos de datos que se usan como claves de partición con nombre son regiones, códigos postales, grupos de clientes u otros límites empresariales.

Valores aceptados: Named, Singleton, UniformInt64Range
Valor predeterminado: singleton
--placement-constraints

Especifique las restricciones de selección de ubicación como una cadena. Las restricciones de colocación son expresiones booleanas en las propiedades del nodo y permiten restringir un servicio en nodos concretos según los requisitos de servicio. Por ejemplo, para colocar un servicio en nodos donde NodeType es azul, especifique lo siguiente: "NodeColor == azul)".

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

Especifique la duración de las réplicas que pueden permanecer en InBuild antes de notificar que la compilación está bloqueada, representada en formato ISO 8601 "hh:mm:ss".

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

Especifique la duración máxima para la que se permite que una partición esté en un estado de pérdida de cuórum, representada en formato ISO 8601 "hh:mm:ss".

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

Especifique la duración entre cuando una réplica deja de funcionar y cuando se crea una nueva réplica, representada en formato ISO 8601 "hh:mm:ss".

--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

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

Especifique el tamaño del conjunto de réplicas de destino para el servicio con estado.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az sf managed-service delete

Elimine un servicio administrado.

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

Ejemplos

Elimine el servicio administrado.

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

Parámetros requeridos

--application --application-name

Especifique el nombre del servicio.

--cluster-name -c

Especifique el nombre del clúster, si no se le asigna, será el mismo que el nombre del grupo de recursos.

--name --service-name

Especifique el nombre del servicio.

--resource-group -g

Especifique el nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az sf managed-service list

Enumeración de servicios administrados de una aplicación administrada determinada.

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

Ejemplos

Enumeración de servicios administrados.

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

Parámetros requeridos

--application --application-name

Especifique el nombre del servicio.

--cluster-name -c

Especifique el nombre del clúster, si no se le asigna, será el mismo que el nombre del grupo de recursos.

--resource-group -g

Especifique el nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az sf managed-service show

Obtener un servicio.

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

Ejemplos

Muestra las propiedades de un servicio administrado en un clúster administrado de Azure Service Fabric.

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

Parámetros requeridos

--application --application-name

Especifique el nombre del servicio.

--cluster-name -c

Especifique el nombre del clúster, si no se le asigna, será el mismo que el nombre del grupo de recursos.

--name --service-name

Especifique el nombre del servicio.

--resource-group -g

Especifique el nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az sf managed-service update

Actualice un servicio administrado.

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]

Ejemplos

Actualice el servicio sin estado administrado.

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

Actualice el servicio con estado administrado.

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 requeridos

--application --application-name

Especifique el nombre del servicio.

--cluster-name -c

Especifique el nombre del clúster, si no se le asigna, será el mismo que el nombre del grupo de recursos.

--name --service-name

Especifique el nombre del servicio.

--resource-group -g

Especifique el nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--default-move-cost

Especifique el costo predeterminado de un traslado. Los costos más altos hacen que sea menos probable que Cluster Resource Manager mueva la réplica al intentar equilibrar el clúster.

Valores aceptados: High, Low, Medium, Zero
--instance-count

Especifique el recuento de instancias para el servicio sin estado. Si se usa -1, significa que se ejecutará en todos los nodos.

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

Especifique la definición sobre cuánto tiempo se deben mantener las réplicas StandBy antes de quitarse, representadas en formato ISO 8601 "hh:mm:ss".

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

Especifique el porcentaje mínimo de InstanceCount que debe cumplir la comprobación de seguridad de EnsureAvailability durante las operaciones como actualizar o desactivar el nodo. El número real que se usa es max( MinInstanceCount, ceil( MinInstancePercentage/100.0 * InstanceCount) ). Tenga en cuenta que, si InstanceCount se establece en -1, durante el cálculo de MinInstancePercentage, -1 se convierte primero en el número de nodos en los que se permite colocar las instancias según las restricciones de ubicación del servicio. Los valores permitidos son de 0 a 100.

--min-instance-count

Especifique el número mínimo de instancias que deben cumplir la comprobación de seguridad de EnsureAvailability durante las operaciones como actualizar o desactivar el nodo. El número real que se usa es max( MinInstanceCount, ceil( MinInstancePercentage/100.0 * InstanceCount) ). Tenga en cuenta que, si InstanceCount se establece en -1, durante el cálculo de MinInstanceCount -1 se convierte primero en el número de nodos en los que se permite colocar las instancias según las restricciones de ubicación del servicio.

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

Especifique el tamaño mínimo del conjunto de réplicas para el servicio con estado.

--placement-constraints

Especifique las restricciones de selección de ubicación como una cadena. Las restricciones de colocación son expresiones booleanas en las propiedades del nodo y permiten restringir un servicio en nodos concretos según los requisitos de servicio. Por ejemplo, para colocar un servicio en nodos donde NodeType es azul, especifique lo siguiente: "NodeColor == azul)".

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

Especifique la duración de las réplicas que pueden permanecer en InBuild antes de notificar que la compilación está bloqueada, representada en formato ISO 8601 "hh:mm:ss".

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

Especifique la duración máxima para la que se permite que una partición esté en un estado de pérdida de cuórum, representada en formato ISO 8601 "hh:mm:ss".

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

Especifique la duración entre cuando una réplica deja de funcionar y cuando se crea una nueva réplica, representada en formato ISO 8601 "hh:mm:ss".

--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

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

Especifique el tamaño del conjunto de réplicas de destino para el servicio con estado.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.