Redis - Update

Servizio:

Redis Cache

Versione API:

2024-11-01

Aggiornare una cache Redis esistente.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/redis/{name}?api-version=2024-11-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
name	path	True	string	Nome della cache Redis.
resourceGroupName	path	True	string	Nome del gruppo di risorse. Il nome non fa distinzione tra maiuscole e minuscole.
subscriptionId	path	True	string	ID della sottoscrizione di destinazione.
api-version	query	True	string	Versione dell'API da usare per questa operazione.

Corpo della richiesta

Nome	Tipo	Descrizione
identity	ManagedServiceIdentity	Identità della risorsa.
properties.disableAccessKeyAuthentication	boolean	L'autenticazione a Redis tramite chiavi di accesso viene disabilitata se impostata su true. Il valore predefinito è false.
properties.enableNonSslPort	boolean	Specifica se la porta del server Redis non ssl (6379) è abilitata.
properties.minimumTlsVersion	TlsVersion	Facoltativo: richiede ai client di usare una versione TLS specificata (o versione successiva) per connettersi (ad esempio, '1.0', '1.1', '1.2')
properties.publicNetworkAccess	PublicNetworkAccess	Indica se l'accesso all'endpoint pubblico è consentito per questa cache. Il valore è facoltativo, ma se passato, deve essere "Abilitato" o "Disabilitato". Se 'Disabled', gli endpoint privati sono il metodo di accesso esclusivo. Il valore predefinito è 'Enabled'
properties.redisConfiguration	RedisConfiguration	Tutte le impostazioni di Redis. Poche chiavi possibili: rdb-backup-enabled,rdb-storage-connection-string,rdb-backup-frequency,maxmemory-delta, maxmemory-policy,notify-keyspace-events, aof-backup-enabled, aof-storage-connection-string-0, aof-storage-connection-string-1 e così via.
properties.redisVersion	string	Versione di Redis. Deve essere nel formato 'major[.minor]' (è necessario solo 'major' ) o il valore 'latest' che fa riferimento alla versione stabile più recente di Redis disponibile. Versioni supportate: 4.0, 6.0 (versione più recente). Il valore predefinito è 'latest'.
properties.replicasPerMaster	integer	Numero di repliche da creare per ogni replica primaria.
properties.replicasPerPrimary	integer	Numero di repliche da creare per ogni replica primaria.
properties.shardCount	integer	Numero di partizioni da creare in una cache del cluster Premium.
properties.sku	Sku	SKU della cache Redis da distribuire.
properties.tenantSettings	object	Dizionario delle impostazioni del tenant
properties.updateChannel	UpdateChannel	Facoltativo: specifica il canale di aggiornamento per gli aggiornamenti mensili di Redis che la cache Redis riceverà. Le cache che usano il canale di aggiornamento 'Anteprima' ottengono gli aggiornamenti di Redis più recenti almeno 4 settimane prima delle cache dei canali 'Stable'. Il valore predefinito è 'Stable'.
properties.zonalAllocationPolicy	ZonalAllocationPolicy	Facoltativo: specifica la modalità di allocazione delle zone di disponibilità nella cache Redis. "Automatico" abilita la ridondanza della zona e Azure selezionerà automaticamente le zone in base alla disponibilità e alla capacità a livello di area. 'UserDefined' selezionerà le zone di disponibilità passate usando il parametro 'zones'. 'NoZones' produrrà una cache non di zona. Se 'zonalAllocationPolicy' non viene passato, verrà impostato su 'UserDefined' quando le zone vengono passate; in caso contrario, verrà impostata su 'Automatico' nelle aree in cui le zone sono supportate e 'NoZones' nelle aree in cui le zone non sono supportate.
tags	object	Tag di risorsa.

Risposte

Nome	Tipo	Descrizione
200 OK	RedisResource	La cache Redis esistente è stata aggiornata correttamente. Controllare provisioningState per visualizzare lo stato dettagliato.
202 Accepted	RedisResource	La cache Redis esistente è stata aggiornata correttamente. Controllare Azure-AsyncOperation intestazioni per eseguire il polling dello stato dettagliato.
Other Status Codes	ErrorResponse	Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

RedisCacheUpdate

Esempio di richiesta

HTTP

PATCH https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cache/redis/cache1?api-version=2024-11-01

{
  "properties": {
    "enableNonSslPort": true,
    "replicasPerPrimary": 2
  }
}

Java

import com.azure.resourcemanager.redis.models.RedisUpdateParameters;

/**
 * Samples for Redis Update.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/redis/resource-manager/Microsoft.Cache/stable/2024-11-01/examples/RedisCacheUpdate.json
     */
    /**
     * Sample code: RedisCacheUpdate.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void redisCacheUpdate(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.redisCaches().manager().serviceClient().getRedis().update("rg1", "cache1",
            new RedisUpdateParameters().withEnableNonSslPort(true).withReplicasPerPrimary(2),
            com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Python

from azure.identity import DefaultAzureCredential

from azure.mgmt.redis import RedisManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-redis
# USAGE
    python redis_cache_update.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = RedisManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="subid",
    )

    response = client.redis.begin_update(
        resource_group_name="rg1",
        name="cache1",
        parameters={"properties": {"enableNonSslPort": True, "replicasPerPrimary": 2}},
    ).result()
    print(response)


# x-ms-original-file: specification/redis/resource-manager/Microsoft.Cache/stable/2024-11-01/examples/RedisCacheUpdate.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Go

package armredis_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/redis/armredis/v3"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/45374f48f560b3337ed55735038f1e9bf8cbea65/specification/redis/resource-manager/Microsoft.Cache/stable/2024-11-01/examples/RedisCacheUpdate.json
func ExampleClient_BeginUpdate() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armredis.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewClient().BeginUpdate(ctx, "rg1", "cache1", armredis.UpdateParameters{
		Properties: &armredis.UpdateProperties{
			EnableNonSSLPort:   to.Ptr(true),
			ReplicasPerPrimary: to.Ptr[int32](2),
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to pull the result: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.ResourceInfo = armredis.ResourceInfo{
	// 	Name: to.Ptr("cache1"),
	// 	Type: to.Ptr("Microsoft.Cache/Redis"),
	// 	ID: to.Ptr("/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cache/Redis/cache1"),
	// 	Location: to.Ptr("East US"),
	// 	Tags: map[string]*string{
	// 	},
	// 	Properties: &armredis.Properties{
	// 		EnableNonSSLPort: to.Ptr(true),
	// 		RedisConfiguration: &armredis.CommonPropertiesRedisConfiguration{
	// 			Maxclients: to.Ptr("1000"),
	// 			MaxmemoryDelta: to.Ptr("50"),
	// 			MaxmemoryReserved: to.Ptr("50"),
	// 		},
	// 		RedisVersion: to.Ptr("3.0"),
	// 		ReplicasPerMaster: to.Ptr[int32](2),
	// 		ReplicasPerPrimary: to.Ptr[int32](2),
	// 		UpdateChannel: to.Ptr(armredis.UpdateChannelStable),
	// 		ZonalAllocationPolicy: to.Ptr(armredis.ZonalAllocationPolicyAutomatic),
	// 		SKU: &armredis.SKU{
	// 			Name: to.Ptr(armredis.SKUNamePremium),
	// 			Capacity: to.Ptr[int32](1),
	// 			Family: to.Ptr(armredis.SKUFamilyP),
	// 		},
	// 		AccessKeys: &armredis.AccessKeys{
	// 			PrimaryKey: to.Ptr("<primaryKey>"),
	// 			SecondaryKey: to.Ptr("<secondaryKey>"),
	// 		},
	// 		HostName: to.Ptr("cache1.redis.cache.windows.net"),
	// 		Instances: []*armredis.InstanceDetails{
	// 			{
	// 				IsMaster: to.Ptr(true),
	// 				IsPrimary: to.Ptr(true),
	// 				NonSSLPort: to.Ptr[int32](13000),
	// 				SSLPort: to.Ptr[int32](15000),
	// 			},
	// 			{
	// 				IsMaster: to.Ptr(false),
	// 				IsPrimary: to.Ptr(false),
	// 				NonSSLPort: to.Ptr[int32](13001),
	// 				SSLPort: to.Ptr[int32](15001),
	// 			},
	// 			{
	// 				IsMaster: to.Ptr(false),
	// 				IsPrimary: to.Ptr(false),
	// 				NonSSLPort: to.Ptr[int32](13002),
	// 				SSLPort: to.Ptr[int32](15002),
	// 		}},
	// 		Port: to.Ptr[int32](6379),
	// 		ProvisioningState: to.Ptr(armredis.ProvisioningStateSucceeded),
	// 		SSLPort: to.Ptr[int32](6380),
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

JavaScript

const { RedisManagementClient } = require("@azure/arm-rediscache");
const { DefaultAzureCredential } = require("@azure/identity");
require("dotenv/config");

/**
 * This sample demonstrates how to Update an existing Redis cache.
 *
 * @summary Update an existing Redis cache.
 * x-ms-original-file: specification/redis/resource-manager/Microsoft.Cache/stable/2024-11-01/examples/RedisCacheUpdate.json
 */
async function redisCacheUpdate() {
  const subscriptionId = process.env["REDIS_SUBSCRIPTION_ID"] || "subid";
  const resourceGroupName = process.env["REDIS_RESOURCE_GROUP"] || "rg1";
  const name = "cache1";
  const parameters = {
    enableNonSslPort: true,
    replicasPerPrimary: 2,
  };
  const credential = new DefaultAzureCredential();
  const client = new RedisManagementClient(credential, subscriptionId);
  const result = await client.redis.beginUpdateAndWait(resourceGroupName, name, parameters);
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

dotnet

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Models;
using Azure.ResourceManager.Redis.Models;
using Azure.ResourceManager.Redis;

// Generated from example definition: specification/redis/resource-manager/Microsoft.Cache/stable/2024-11-01/examples/RedisCacheUpdate.json
// this example is just showing the usage of "Redis_Update" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this RedisResource created on azure
// for more information of creating RedisResource, please refer to the document of RedisResource
string subscriptionId = "subid";
string resourceGroupName = "rg1";
string name = "cache1";
ResourceIdentifier redisResourceId = RedisResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, name);
RedisResource redis = client.GetRedisResource(redisResourceId);

// invoke the operation
RedisPatch patch = new RedisPatch
{
    EnableNonSslPort = true,
    ReplicasPerPrimary = 2,
};
ArmOperation<RedisResource> lro = await redis.UpdateAsync(WaitUntil.Completed, patch);
RedisResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
RedisData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Risposta di esempio

Codice di stato:

200

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cache/Redis/cache1",
  "location": "East US",
  "name": "cache1",
  "type": "Microsoft.Cache/Redis",
  "tags": {},
  "properties": {
    "accessKeys": {
      "primaryKey": "<primaryKey>",
      "secondaryKey": "<secondaryKey>"
    },
    "provisioningState": "Succeeded",
    "redisVersion": "3.0",
    "sku": {
      "name": "Premium",
      "family": "P",
      "capacity": 1
    },
    "enableNonSslPort": true,
    "replicasPerMaster": 2,
    "replicasPerPrimary": 2,
    "updateChannel": "Stable",
    "zonalAllocationPolicy": "Automatic",
    "redisConfiguration": {
      "maxclients": "1000",
      "maxmemory-reserved": "50",
      "maxmemory-delta": "50"
    },
    "hostName": "cache1.redis.cache.windows.net",
    "port": 6379,
    "sslPort": 6380,
    "instances": [
      {
        "sslPort": 15000,
        "nonSslPort": 13000,
        "isMaster": true,
        "isPrimary": true
      },
      {
        "sslPort": 15001,
        "nonSslPort": 13001,
        "isMaster": false,
        "isPrimary": false
      },
      {
        "sslPort": 15002,
        "nonSslPort": 13002,
        "isMaster": false,
        "isPrimary": false
      }
    ]
  }
}

Codice di stato:

202

location: https://management.azure.com/subscriptions/subid/providers/Microsoft.Cache/...pathToOperationResult...

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cache/Redis/cache1",
  "location": "East US",
  "name": "cache1",
  "type": "Microsoft.Cache/Redis",
  "tags": {},
  "properties": {
    "accessKeys": {
      "primaryKey": "<primaryKey>",
      "secondaryKey": "<secondaryKey>"
    },
    "provisioningState": "Succeeded",
    "redisVersion": "3.0",
    "sku": {
      "name": "Premium",
      "family": "P",
      "capacity": 1
    },
    "enableNonSslPort": true,
    "replicasPerMaster": 2,
    "replicasPerPrimary": 2,
    "updateChannel": "Stable",
    "zonalAllocationPolicy": "Automatic",
    "redisConfiguration": {
      "maxclients": "1000",
      "maxmemory-reserved": "50",
      "maxmemory-delta": "50"
    },
    "hostName": "cache1.redis.cache.windows.net",
    "port": 6379,
    "sslPort": 6380,
    "instances": [
      {
        "sslPort": 15000,
        "nonSslPort": 13000,
        "isMaster": true,
        "isPrimary": true
      },
      {
        "sslPort": 15001,
        "nonSslPort": 13001,
        "isMaster": false,
        "isPrimary": false
      },
      {
        "sslPort": 15002,
        "nonSslPort": 13002,
        "isMaster": false,
        "isPrimary": false
      }
    ]
  }
}

Definizioni

Nome	Descrizione
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
ManagedServiceIdentity	Identità del servizio gestita (identità assegnate dal sistema e/o assegnate dall'utente)
ManagedServiceIdentityType	Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned).
PrivateEndpoint	Risorsa endpoint privato.
PrivateEndpointConnection	Risorsa connessione endpoint privato.
PrivateEndpointConnectionProvisioningState	Stato di provisioning corrente.
PrivateEndpointServiceConnectionStatus	Stato della connessione dell'endpoint privato.
PrivateLinkServiceConnectionState	Raccolta di informazioni sullo stato della connessione tra consumer di servizi e provider.
ProvisioningState	Stato del provisioning dell'istanza di Redis.
PublicNetworkAccess	Indica se l'accesso all'endpoint pubblico è consentito per questa cache. Il valore è facoltativo, ma se passato, deve essere "Abilitato" o "Disabilitato". Se 'Disabled', gli endpoint privati sono il metodo di accesso esclusivo. Il valore predefinito è 'Enabled'
RedisAccessKeys	Chiavi di accesso alla cache Redis.
RedisConfiguration	Tutte le impostazioni di Redis. Poche chiavi possibili: rdb-backup-enabled,rdb-storage-connection-string,rdb-backup-frequency,maxmemory-delta, maxmemory-policy,notify-keyspace-events, aof-backup-enabled, aof-storage-connection-string-0, aof-storage-connection-string-1 e così via.
RedisInstanceDetails	Dettagli della singola istanza di Redis.
RedisLinkedServer	ID server collegato
RedisResource	Un singolo elemento Redis nell'elenco o nell'operazione Get.
RedisUpdateParameters	Parametri forniti all'operazione Update Redis.
Sku	Parametri SKU forniti all'operazione di creazione di Redis.
SkuFamily	Famiglia di SKU da usare. Valori validi: (C, P). (C = Basic/Standard, P = Premium).
SkuName	Tipo di cache Redis da distribuire. Valori validi: (Basic, Standard, Premium)
TlsVersion	Facoltativo: richiede ai client di usare una versione TLS specificata (o versione successiva) per connettersi (ad esempio, '1.0', '1.1', '1.2')
UpdateChannel	Facoltativo: specifica il canale di aggiornamento per gli aggiornamenti mensili di Redis che la cache Redis riceverà. Le cache che usano il canale di aggiornamento 'Anteprima' ottengono gli aggiornamenti di Redis più recenti almeno 4 settimane prima delle cache dei canali 'Stable'. Il valore predefinito è 'Stable'.
UserAssignedIdentity	Proprietà di identità assegnate dall'utente
ZonalAllocationPolicy	Facoltativo: specifica la modalità di allocazione delle zone di disponibilità nella cache Redis. "Automatico" abilita la ridondanza della zona e Azure selezionerà automaticamente le zone in base alla disponibilità e alla capacità a livello di area. 'UserDefined' selezionerà le zone di disponibilità passate usando il parametro 'zones'. 'NoZones' produrrà una cache non di zona. Se 'zonalAllocationPolicy' non viene passato, verrà impostato su 'UserDefined' quando le zone vengono passate; in caso contrario, verrà impostata su 'Automatico' nelle aree in cui le zone sono supportate e 'NoZones' nelle aree in cui le zone non sono supportate.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

ManagedServiceIdentity

Identità del servizio gestita (identità assegnate dal sistema e/o assegnate dall'utente)

Nome	Tipo	Descrizione
principalId	string	ID entità servizio dell'identità assegnata dal sistema. Questa proprietà verrà fornita solo per un'identità assegnata dal sistema.
tenantId	string	ID tenant dell'identità assegnata dal sistema. Questa proprietà verrà fornita solo per un'identità assegnata dal sistema.
type	ManagedServiceIdentityType	Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned).
userAssignedIdentities	<string,  UserAssignedIdentity>	identità User-Assigned Set di identità assegnate dall'utente associate alla risorsa. Le chiavi del dizionario userAssignedIdentities saranno ID risorsa ARM nel formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. I valori del dizionario possono essere oggetti vuoti ({}) nelle richieste.

ManagedServiceIdentityType

Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned).

Nome	Tipo	Descrizione
None	string
SystemAssigned	string
SystemAssigned, UserAssigned	string
UserAssigned	string

PrivateEndpoint

Risorsa endpoint privato.

Nome	Tipo	Descrizione
id	string	Identificatore arm per endpoint privato

PrivateEndpointConnection

Risorsa connessione endpoint privato.

Nome	Tipo	Descrizione
id	string	ID risorsa completo per la risorsa. Ad esempio - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Nome della risorsa
properties.privateEndpoint	PrivateEndpoint	Risorsa dell'endpoint privato.
properties.privateLinkServiceConnectionState	PrivateLinkServiceConnectionState	Raccolta di informazioni sullo stato della connessione tra consumer di servizi e provider.
properties.provisioningState	PrivateEndpointConnectionProvisioningState	Stato di provisioning della risorsa di connessione dell'endpoint privato.
type	string	Tipo della risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

PrivateEndpointConnectionProvisioningState

Stato di provisioning corrente.

Nome	Tipo	Descrizione
Creating	string
Deleting	string
Failed	string
Succeeded	string

PrivateEndpointServiceConnectionStatus

Stato della connessione dell'endpoint privato.

Nome	Tipo	Descrizione
Approved	string
Pending	string
Rejected	string

PrivateLinkServiceConnectionState

Raccolta di informazioni sullo stato della connessione tra consumer di servizi e provider.

Nome	Tipo	Descrizione
actionsRequired	string	Messaggio che indica se le modifiche apportate al provider di servizi richiedono aggiornamenti sul consumer.
description	string	Motivo dell'approvazione/rifiuto della connessione.
status	PrivateEndpointServiceConnectionStatus	Indica se la connessione è stata approvata/rifiutata/rimossa dal proprietario del servizio.

ProvisioningState

Stato del provisioning dell'istanza di Redis.

Nome	Tipo	Descrizione
ConfiguringAAD	string
Creating	string
Deleting	string
Disabled	string
Failed	string
Linking	string
Provisioning	string
RecoveringScaleFailure	string
Scaling	string
Succeeded	string
Unlinking	string
Unprovisioning	string
Updating	string

PublicNetworkAccess

Indica se l'accesso all'endpoint pubblico è consentito per questa cache. Il valore è facoltativo, ma se passato, deve essere "Abilitato" o "Disabilitato". Se 'Disabled', gli endpoint privati sono il metodo di accesso esclusivo. Il valore predefinito è 'Enabled'

Nome	Tipo	Descrizione
Disabled	string
Enabled	string

RedisAccessKeys

Chiavi di accesso alla cache Redis.

Nome	Tipo	Descrizione
primaryKey	string	Chiave primaria corrente che i client possono usare per eseguire l'autenticazione con cache Redis.
secondaryKey	string	Chiave secondaria corrente che i client possono usare per eseguire l'autenticazione con la cache Redis.

RedisConfiguration

Tutte le impostazioni di Redis. Poche chiavi possibili: rdb-backup-enabled,rdb-storage-connection-string,rdb-backup-frequency,maxmemory-delta, maxmemory-policy,notify-keyspace-events, aof-backup-enabled, aof-storage-connection-string-0, aof-storage-connection-string-1 e così via.

Nome	Tipo	Descrizione
aad-enabled	string	Specifica se l'autenticazione basata su AAD è stata abilitata o disabilitata per la cache
aof-backup-enabled	string	Specifica se il backup aof è abilitato
aof-storage-connection-string-0	string	Prima stringa di connessione dell'account di archiviazione
aof-storage-connection-string-1	string	Seconda stringa di connessione dell'account di archiviazione
authnotrequired	string	Specifica se l'autenticazione è disabilitata. L'impostazione di questa proprietà è altamente sconsigliata dal punto di vista della sicurezza.
maxclients	string	Configurazione max clients
maxfragmentationmemory-reserved	string	Valore in megabyte riservato per frammentazione per partizione
maxmemory-delta	string	Valore in megabyte riservato per l'utilizzo non della cache per partizione, ad esempio il failover.
maxmemory-policy	string	Strategia di rimozione usata quando i dati non rientrano nel limite di memoria.
maxmemory-reserved	string	Valore in megabyte riservato per l'utilizzo non della cache per partizione, ad esempio il failover.
notify-keyspace-events	string	Eventi keyspace che devono essere monitorati.
preferred-data-archive-auth-method	string	Metodo di autenticazione preferito per comunicare con l'account di archiviazione usato per l'archivio dati, specificare firma di accesso condiviso o ManagedIdentity. Il valore predefinito è SAS
preferred-data-persistence-auth-method	string	Metodo di autenticazione preferito per comunicare con l'account di archiviazione usato per la persistenza dei dati, specificare firma di accesso condiviso o ManagedIdentity. Il valore predefinito è SAS
rdb-backup-enabled	string	Specifica se il backup rdb è abilitato
rdb-backup-frequency	string	Specifica la frequenza di creazione del backup rdb in pochi minuti. Valori validi: (15, 30, 60, 360, 720, 1440)
rdb-backup-max-snapshot-count	string	Specifica il numero massimo di snapshot per il backup di rdb
rdb-storage-connection-string	string	Stringa di connessione dell'account di archiviazione per l'archiviazione del file rdb
storage-subscription-id	string	SubscriptionId dell'account di archiviazione per la persistenza (aof/rdb) tramite ManagedIdentity.
zonal-configuration	string	Configurazione zonale

RedisInstanceDetails

Dettagli della singola istanza di Redis.

Nome	Tipo	Descrizione
isMaster	boolean	Specifica se l'istanza è un nodo primario.
isPrimary	boolean	Specifica se l'istanza è un nodo primario.
nonSslPort	integer	Se enableNonSslPort è true, fornisce la porta non SSL dell'istanza di Redis.
shardId	integer	Se il clustering è abilitato, l'ID partizione dell'istanza di Redis
sslPort	integer	Porta SSL dell'istanza di Redis.
zone	string	Se la cache usa le zone di disponibilità, specifica la zona di disponibilità in cui si trova questa istanza.

RedisLinkedServer

ID server collegato

Nome	Tipo	Descrizione
id	string	ID server collegato.

RedisResource

Un singolo elemento Redis nell'elenco o nell'operazione Get.

Nome	Tipo	Valore predefinito	Descrizione
disableAccessKeyAuthentication	boolean	False	L'autenticazione a Redis tramite chiavi di accesso viene disabilitata se impostata su true. Il valore predefinito è false.
enableNonSslPort	boolean	False	Specifica se la porta del server Redis non ssl (6379) è abilitata.
id	string		ID risorsa completo per la risorsa. Ad esempio - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	ManagedServiceIdentity		Identità della risorsa.
location	string		Posizione geografica in cui risiede la risorsa
minimumTlsVersion	TlsVersion		Facoltativo: richiede ai client di usare una versione TLS specificata (o versione successiva) per connettersi (ad esempio, '1.0', '1.1', '1.2')
name	string		Nome della risorsa
properties.accessKeys	RedisAccessKeys		Chiavi della cache Redis: non impostate se questo oggetto non è la risposta alla cache Redis di creazione o aggiornamento
properties.hostName	string		Nome host Redis.
properties.instances	RedisInstanceDetails[]		Elenco delle istanze di Redis associate alla cache
properties.linkedServers	RedisLinkedServer[]		Elenco dei server collegati associati alla cache
properties.port	integer		Porta redis non SSL.
properties.privateEndpointConnections	PrivateEndpointConnection[]		Elenco della connessione dell'endpoint privato associata alla cache Redis specificata
properties.provisioningState	ProvisioningState		Stato del provisioning dell'istanza di Redis.
properties.sku	Sku		SKU della cache Redis da distribuire.
properties.sslPort	integer		Porta SSL Redis.
properties.staticIP	string		Indirizzo IP statico. Facoltativamente, può essere specificato quando si distribuisce una cache Redis all'interno di una rete virtuale di Azure esistente; auto assegnato per impostazione predefinita.
properties.subnetId	string		ID risorsa completo di una subnet in una rete virtuale in cui distribuire la cache Redis. Formato di esempio: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/Microsoft. {Network|ClassicNetwork}/VirtualNetworks/vnet1/subnets/subnet1
publicNetworkAccess	PublicNetworkAccess	Enabled	Indica se l'accesso all'endpoint pubblico è consentito per questa cache. Il valore è facoltativo, ma se passato, deve essere "Abilitato" o "Disabilitato". Se 'Disabled', gli endpoint privati sono il metodo di accesso esclusivo. Il valore predefinito è 'Enabled'
redisConfiguration	RedisConfiguration		Tutte le impostazioni di Redis. Poche chiavi possibili: rdb-backup-enabled,rdb-storage-connection-string,rdb-backup-frequency,maxmemory-delta, maxmemory-policy,notify-keyspace-events, aof-backup-enabled, aof-storage-connection-string-0, aof-storage-connection-string-1 e così via.
redisVersion	string		Versione di Redis. Deve essere nel formato 'major[.minor]' (è necessario solo 'major' ) o il valore 'latest' che fa riferimento alla versione stabile più recente di Redis disponibile. Versioni supportate: 4.0, 6.0 (versione più recente). Il valore predefinito è 'latest'.
replicasPerMaster	integer		Numero di repliche da creare per ogni replica primaria.
replicasPerPrimary	integer		Numero di repliche da creare per ogni replica primaria.
shardCount	integer		Numero di partizioni da creare in una cache del cluster Premium.
tags	object		Tag di risorsa.
tenantSettings	object		Dizionario delle impostazioni del tenant
type	string		Tipo della risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"
updateChannel	UpdateChannel		Facoltativo: specifica il canale di aggiornamento per gli aggiornamenti mensili di Redis che la cache Redis riceverà. Le cache che usano il canale di aggiornamento 'Anteprima' ottengono gli aggiornamenti di Redis più recenti almeno 4 settimane prima delle cache dei canali 'Stable'. Il valore predefinito è 'Stable'.
zonalAllocationPolicy	ZonalAllocationPolicy		Facoltativo: specifica la modalità di allocazione delle zone di disponibilità nella cache Redis. "Automatico" abilita la ridondanza della zona e Azure selezionerà automaticamente le zone in base alla disponibilità e alla capacità a livello di area. 'UserDefined' selezionerà le zone di disponibilità passate usando il parametro 'zones'. 'NoZones' produrrà una cache non di zona. Se 'zonalAllocationPolicy' non viene passato, verrà impostato su 'UserDefined' quando le zone vengono passate; in caso contrario, verrà impostata su 'Automatico' nelle aree in cui le zone sono supportate e 'NoZones' nelle aree in cui le zone non sono supportate.
zones	string[]		Elenco delle zone di disponibilità che denota la provenienza della risorsa.

RedisUpdateParameters

Parametri forniti all'operazione Update Redis.

Nome	Tipo	Valore predefinito	Descrizione
identity	ManagedServiceIdentity		Identità della risorsa.
properties.disableAccessKeyAuthentication	boolean	False	L'autenticazione a Redis tramite chiavi di accesso viene disabilitata se impostata su true. Il valore predefinito è false.
properties.enableNonSslPort	boolean	False	Specifica se la porta del server Redis non ssl (6379) è abilitata.
properties.minimumTlsVersion	TlsVersion		Facoltativo: richiede ai client di usare una versione TLS specificata (o versione successiva) per connettersi (ad esempio, '1.0', '1.1', '1.2')
properties.publicNetworkAccess	PublicNetworkAccess	Enabled	Indica se l'accesso all'endpoint pubblico è consentito per questa cache. Il valore è facoltativo, ma se passato, deve essere "Abilitato" o "Disabilitato". Se 'Disabled', gli endpoint privati sono il metodo di accesso esclusivo. Il valore predefinito è 'Enabled'
properties.redisConfiguration	RedisConfiguration		Tutte le impostazioni di Redis. Poche chiavi possibili: rdb-backup-enabled,rdb-storage-connection-string,rdb-backup-frequency,maxmemory-delta, maxmemory-policy,notify-keyspace-events, aof-backup-enabled, aof-storage-connection-string-0, aof-storage-connection-string-1 e così via.
properties.redisVersion	string		Versione di Redis. Deve essere nel formato 'major[.minor]' (è necessario solo 'major' ) o il valore 'latest' che fa riferimento alla versione stabile più recente di Redis disponibile. Versioni supportate: 4.0, 6.0 (versione più recente). Il valore predefinito è 'latest'.
properties.replicasPerMaster	integer		Numero di repliche da creare per ogni replica primaria.
properties.replicasPerPrimary	integer		Numero di repliche da creare per ogni replica primaria.
properties.shardCount	integer		Numero di partizioni da creare in una cache del cluster Premium.
properties.sku	Sku		SKU della cache Redis da distribuire.
properties.tenantSettings	object		Dizionario delle impostazioni del tenant
properties.updateChannel	UpdateChannel		Facoltativo: specifica il canale di aggiornamento per gli aggiornamenti mensili di Redis che la cache Redis riceverà. Le cache che usano il canale di aggiornamento 'Anteprima' ottengono gli aggiornamenti di Redis più recenti almeno 4 settimane prima delle cache dei canali 'Stable'. Il valore predefinito è 'Stable'.
properties.zonalAllocationPolicy	ZonalAllocationPolicy		Facoltativo: specifica la modalità di allocazione delle zone di disponibilità nella cache Redis. "Automatico" abilita la ridondanza della zona e Azure selezionerà automaticamente le zone in base alla disponibilità e alla capacità a livello di area. 'UserDefined' selezionerà le zone di disponibilità passate usando il parametro 'zones'. 'NoZones' produrrà una cache non di zona. Se 'zonalAllocationPolicy' non viene passato, verrà impostato su 'UserDefined' quando le zone vengono passate; in caso contrario, verrà impostata su 'Automatico' nelle aree in cui le zone sono supportate e 'NoZones' nelle aree in cui le zone non sono supportate.
tags	object		Tag di risorsa.

Sku

Parametri SKU forniti all'operazione di creazione di Redis.

Nome	Tipo	Descrizione
capacity	integer	Dimensioni della cache Redis da distribuire. Valori validi: per la famiglia C (Basic/Standard) (0, 1, 2, 3, 4, 5, 6), per la famiglia P (Premium) (1, 2, 3, 4).
family	SkuFamily	Famiglia di SKU da usare. Valori validi: (C, P). (C = Basic/Standard, P = Premium).
name	SkuName	Tipo di cache Redis da distribuire. Valori validi: (Basic, Standard, Premium)

SkuFamily

Famiglia di SKU da usare. Valori validi: (C, P). (C = Basic/Standard, P = Premium).

Nome	Tipo	Descrizione
C	string
P	string

SkuName

Tipo di cache Redis da distribuire. Valori validi: (Basic, Standard, Premium)

Nome	Tipo	Descrizione
Basic	string
Premium	string
Standard	string

TlsVersion

Facoltativo: richiede ai client di usare una versione TLS specificata (o versione successiva) per connettersi (ad esempio, '1.0', '1.1', '1.2')

Nome	Tipo	Descrizione
1.0	string
1.1	string
1.2	string

UpdateChannel

Facoltativo: specifica il canale di aggiornamento per gli aggiornamenti mensili di Redis che la cache Redis riceverà. Le cache che usano il canale di aggiornamento 'Anteprima' ottengono gli aggiornamenti di Redis più recenti almeno 4 settimane prima delle cache dei canali 'Stable'. Il valore predefinito è 'Stable'.

Nome	Tipo	Descrizione
Preview	string
Stable	string

UserAssignedIdentity

Proprietà di identità assegnate dall'utente

Nome	Tipo	Descrizione
clientId	string	ID client dell'identità assegnata.
principalId	string	ID entità dell'identità assegnata.

ZonalAllocationPolicy

Facoltativo: specifica la modalità di allocazione delle zone di disponibilità nella cache Redis. "Automatico" abilita la ridondanza della zona e Azure selezionerà automaticamente le zone in base alla disponibilità e alla capacità a livello di area. 'UserDefined' selezionerà le zone di disponibilità passate usando il parametro 'zones'. 'NoZones' produrrà una cache non di zona. Se 'zonalAllocationPolicy' non viene passato, verrà impostato su 'UserDefined' quando le zone vengono passate; in caso contrario, verrà impostata su 'Automatico' nelle aree in cui le zone sono supportate e 'NoZones' nelle aree in cui le zone non sono supportate.

Nome	Tipo	Descrizione
Automatic	string
NoZones	string
UserDefined	string