

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Registrar uma meta escalável
<a name="AutoScaling-Register-Policy"></a>

Você pode aplicar uma política de escalabilidade com base em uma métrica predefinida ou personalizada. Para fazer isso, você pode usar a API Application Auto Scaling AWS CLI ou a API Application Auto Scaling. A primeira etapa é registrar seu grupo de replicação ElastiCache para Valkey e Redis OSS com o Auto Scaling. 

Antes de usar o escalonamento ElastiCache automático com um cluster, você deve registrar seu cluster com o escalonamento ElastiCache automático. Você faz isso para definir a dimensão e os limites de escalabilidade a serem aplicados a esse cluster. ElastiCache o auto scaling dimensiona dinamicamente o cluster ao longo da dimensão `elasticache:replication-group:Replicas` escalável, que representa o número de réplicas de cluster por fragmento. 

**Uso da CLI** 

Para registrar seu ElastiCache cluster, use o comando [register-scalable-target com](https://docs.aws.amazon.com/cli/latest/reference/application-autoscaling/register-scalable-target.html) os seguintes parâmetros: 
+ --service-namespace: defina este valor como elasticache. 
+ --resource-id — O identificador do recurso para o cluster. ElastiCache Para esse parâmetro, o tipo de recurso é ReplicationGroup e o identificador exclusivo é o nome do cluster, por exemplo`replication-group/myscalablecluster`. 
+ --scalable-dimension: defina este valor como `elasticache:replication-group:Replicas`. 
+ --min-capacity — O número mínimo de réplicas a serem gerenciadas pelo escalonamento automático. ElastiCache Para obter informações sobre a relação entre --min-capacity, --max-capacity e o número de réplicas no cluster, consulte [Capacidades mínima e máxima](AutoScaling-Policies.md#AutoScaling-MinMax).
+ --max-capacity — O número máximo de réplicas a serem gerenciadas pelo escalonamento automático. ElastiCache Para obter informações sobre a relação entre --min-capacity, --max-capacity e o número de réplicas no cluster, consulte [Capacidades mínima e máxima](AutoScaling-Policies.md#AutoScaling-MinMax).

**Example**  
No exemplo a seguir, você registra um ElastiCache cluster chamado`myscalablecluster`. O registro indica que o cluster deve ser escalado dinamicamente para ter de uma a 5 réplicas.   
Para Linux, macOS ou Unix:  

```
aws application-autoscaling register-scalable-target \
    --service-namespace elasticache \
    --resource-id replication-group/myscalablecluster \
    --scalable-dimension elasticache:replication-group:Replicas \
    --min-capacity 1 \
    --max-capacity 5 \
```
Para Windows:  

```
aws application-autoscaling register-scalable-target ^
    --service-namespace elasticache ^
    --resource-id replication-group/myscalablecluster ^
    --scalable-dimension elasticache:replication-group:Replicas ^
    --min-capacity 1 ^
    --max-capacity 5 ^
```

**Uso da API**

Para registrar seu ElastiCache cluster, use o comando [register-scalable-target com](https://docs.aws.amazon.com/cli/latest/reference/application-autoscaling/register-scalable-target.html) os seguintes parâmetros: 
+ ServiceNamespace — Defina esse valor como elasticache. 
+ resourceID — O identificador do recurso para o cluster. ElastiCache Para esse parâmetro, o tipo de recurso é ReplicationGroup e o identificador exclusivo é o nome do cluster, por exemplo`replication-group/myscalablecluster`. 
+ ScalableDimension — Defina esse valor como`elasticache:replication-group:Replicas`. 
+ MinCapacity — O número mínimo de réplicas a serem gerenciadas pelo ElastiCache escalonamento automático. Para obter informações sobre a relação entre --min-capacity, --max-capacity e o número de réplicas no cluster, consulte [Capacidades mínima e máxima](AutoScaling-Policies.md#AutoScaling-MinMax).
+ MaxCapacity — O número máximo de réplicas a serem gerenciadas pelo ElastiCache escalonamento automático. Para obter informações sobre a relação entre --min-capacity, --max-capacity e o número de réplicas no cluster, consulte [Capacidades mínima e máxima](AutoScaling-Policies.md#AutoScaling-MinMax).

**Example**  
No exemplo a seguir, um cluster chamado `myscalablecluster` é registrado na API do Application Auto Scaling. Este registro indica que o cluster deve ser escalado dinamicamente para ter de uma a 5 réplicas. 

```
POST / HTTP/1.1
Host: autoscaling.us-east-2.amazonaws.com
Accept-Encoding: identity
Content-Length: 219
X-Amz-Target: AnyScaleFrontendService.RegisterScalableTarget
X-Amz-Date: 20160506T182145Z
User-Agent: aws-cli/1.10.23 Python/2.7.11 Darwin/15.4.0 botocore/1.4.8
Content-Type: application/x-amz-json-1.1
Authorization: AUTHPARAMS
{
    "ServiceNamespace": "elasticache",
    "ResourceId": "replication-group/myscalablecluster",
    "ScalableDimension": "elasticache:replication-group:Replicas",
    "MinCapacity": 1,
    "MaxCapacity": 5
}
```