Delen via


Redis Enterprise - Create

Hiermee maakt of werkt u een bestaand cachecluster bij (overschrijven/opnieuw maken, met mogelijke downtime)

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/redisEnterprise/{clusterName}?api-version=2025-07-01

URI-parameters

Name In Vereist Type Description
clusterName
path True

string

pattern: ^(?=.{1,60}$)[A-Za-z0-9]+(-[A-Za-z0-9]+)*$

De naam van het Redis Enterprise-cluster. De naam moet 1 tot 60 tekens lang zijn. Toegestane tekens (A-Z, a-z, 0-9) en afbreekstreepje(-). Er kunnen geen voorloop- of volgstreepjes of opeenvolgende afbreekstreepjes zijn

resourceGroupName
path True

string

minLength: 1
maxLength: 90

De naam van de resourcegroep. De naam is hoofdletterongevoelig.

subscriptionId
path True

string

minLength: 1

De id van het doelabonnement.

api-version
query True

string

minLength: 1

De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagbody

Name Vereist Type Description
location True

string

De geografische locatie waar de resource zich bevindt

properties.publicNetworkAccess True

PublicNetworkAccess

Of openbaar netwerkverkeer al dan niet toegang heeft tot het Redis-cluster. Alleen 'Ingeschakeld' of 'Uitgeschakeld' kan worden ingesteld. null wordt alleen geretourneerd voor clusters die zijn gemaakt met behulp van een oude API-versie die deze eigenschap niet hebben en niet kunnen worden ingesteld.

sku True

Sku

De SKU die moet worden gemaakt, wat van invloed is op de prijs, prestaties en functies.

identity

ManagedServiceIdentity

De identiteit van de resource.

properties.encryption

Encryption

Versleuteling-at-rest-configuratie voor het cluster.

properties.highAvailability

HighAvailability

Standaard ingeschakeld. Als highAvailability is uitgeschakeld, wordt de gegevensset niet gerepliceerd. Dit is van invloed op de SLA voor beschikbaarheid en verhoogt het risico op gegevensverlies.

properties.minimumTlsVersion

TlsVersion

De minimale TLS-versie voor het cluster dat moet worden ondersteund, bijvoorbeeld '1.2'. Nieuwere versies kunnen in de toekomst worden toegevoegd. Houd er rekening mee dat TLS 1.0 en TLS 1.1 nu volledig verouderd zijn. U kunt ze niet gebruiken. Ze worden alleen genoemd omwille van consistentie met oude API-versies.

tags

object

Resourcetags.

zones

string[]

De beschikbaarheidszones waar dit cluster wordt geïmplementeerd.

Antwoorden

Name Type Description
200 OK

Cluster

Het cluster werd/wordt geüpdatet. Controleer provisioningState en resourceState om de gedetailleerde status te bekijken.

201 Created

Cluster

Het cluster was/wordt opgericht. Controleer provisioningState en resourceState om de gedetailleerde status te bekijken.

Other Status Codes

ErrorResponse

Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

OAuth2-stroom voor Azure Active Directory.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name Description
user_impersonation Uw gebruikersaccount imiteren

Voorbeelden

RedisEnterpriseCreate

Voorbeeldaanvraag

PUT https://management.azure.com/subscriptions/e7b5a9d2-6b6a-4d2f-9143-20d9a10f5b8f/resourceGroups/rg1/providers/Microsoft.Cache/redisEnterprise/cache1?api-version=2025-07-01

{
  "location": "West US",
  "sku": {
    "name": "EnterpriseFlash_F300",
    "capacity": 3
  },
  "zones": [
    "1",
    "2",
    "3"
  ],
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/your-subscription/resourceGroups/your-rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/your-identity": {}
    }
  },
  "properties": {
    "minimumTlsVersion": "1.2",
    "encryption": {
      "customerManagedKeyEncryption": {
        "keyEncryptionKeyIdentity": {
          "identityType": "userAssignedIdentity",
          "userAssignedIdentityResourceId": "/subscriptions/your-subscription/resourceGroups/your-rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/your-identity"
        },
        "keyEncryptionKeyUrl": "https://your-kv.vault.azure.net/keys/your-key/your-key-version"
      }
    },
    "publicNetworkAccess": "Disabled"
  },
  "tags": {
    "tag1": "value1"
  }
}

Voorbeeldrespons

{
  "name": "cache1",
  "type": "Microsoft.Cache/redisEnterprise",
  "id": "/subscriptions/e7b5a9d2-6b6a-4d2f-9143-20d9a10f5b8f/resourceGroups/rg1/providers/Microsoft.Cache/redisEnterprise/cache1",
  "location": "West US",
  "kind": "v1",
  "sku": {
    "name": "EnterpriseFlash_F300",
    "capacity": 3
  },
  "zones": [
    "1",
    "2",
    "3"
  ],
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/your-subscription/resourceGroups/your-rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/your-identity": {
        "principalId": "00000000-0000-0000-0000-000000000000",
        "clientId": "00000000-0000-0000-0000-000000000000"
      }
    }
  },
  "properties": {
    "provisioningState": "Creating",
    "resourceState": "Creating",
    "hostName": "cache1.westus.something.azure.net",
    "redisVersion": "5",
    "minimumTlsVersion": "1.2",
    "publicNetworkAccess": "Disabled",
    "encryption": {
      "customerManagedKeyEncryption": {
        "keyEncryptionKeyIdentity": {
          "userAssignedIdentityResourceId": "/subscriptions/your-subscription/resourceGroups/your-rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/your-identity",
          "identityType": "userAssignedIdentity"
        },
        "keyEncryptionKeyUrl": "https://your-kv.vault.azure.net/keys/your-key/your-key-version"
      }
    }
  },
  "tags": {
    "tag1": "value1"
  }
}
{
  "name": "cache1",
  "type": "Microsoft.Cache/redisEnterprise",
  "id": "/subscriptions/e7b5a9d2-6b6a-4d2f-9143-20d9a10f5b8f/resourceGroups/rg1/providers/Microsoft.Cache/redisEnterprise/cache1",
  "location": "West US",
  "kind": "v1",
  "sku": {
    "name": "EnterpriseFlash_F300",
    "capacity": 3
  },
  "zones": [
    "1",
    "2",
    "3"
  ],
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/your-subscription/resourceGroups/your-rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/your-identity": {
        "principalId": "00000000-0000-0000-0000-000000000000",
        "clientId": "00000000-0000-0000-0000-000000000000"
      }
    }
  },
  "properties": {
    "provisioningState": "Succeeded",
    "resourceState": "Running",
    "hostName": "cache1.westus.something.azure.net",
    "redisVersion": "5",
    "minimumTlsVersion": "1.2",
    "publicNetworkAccess": "Disabled"
  },
  "tags": {
    "tag1": "value1"
  }
}

Definities

Name Description
Cluster

Beschrijft het Redis Enterprise-cluster

CmkIdentityType

Alleen userAssignedIdentity wordt ondersteund in deze API-versie; andere typen kunnen in de toekomst worden ondersteund

CustomerManagedKeyEncryption

Alle door de klant beheerde sleutelversleutelingseigenschappen voor de resource. Stel dit in op een leeg object om door Microsoft beheerde sleutelversleuteling te gebruiken.

Encryption

Versleuteling-at-rest-configuratie voor het cluster.

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

ErrorDetail

De foutdetails.

ErrorResponse

Foutreactie

HighAvailability

Standaard ingeschakeld. Als highAvailability is uitgeschakeld, wordt de gegevensset niet gerepliceerd. Dit is van invloed op de SLA voor beschikbaarheid en verhoogt het risico op gegevensverlies.

KeyEncryptionKeyIdentity

Alle identiteitsconfiguraties voor door de klant beheerde sleutelinstellingen die definiëren welke identiteit moet worden gebruikt voor verificatie bij Key Vault.

Kind

Onderscheidt het soort cluster. Alleen lezen.

ManagedServiceIdentity

Beheerde service-identiteit (door het systeem toegewezen en/of door de gebruiker toegewezen identiteiten)

ManagedServiceIdentityType

Type beheerde service-identiteit (waarbij zowel SystemAssigned- als UserAssigned-typen zijn toegestaan).

PrivateEndpoint

De privé-eindpuntresource.

PrivateEndpointConnection

De privé-eindpuntverbindingsresource.

PrivateEndpointConnectionProvisioningState

De huidige inrichtingsstatus.

PrivateEndpointServiceConnectionStatus

De verbindingsstatus van het privé-eindpunt.

PrivateLinkServiceConnectionState

Een verzameling informatie over de status van de verbinding tussen serviceconsumer en provider.

ProvisioningState

Huidige provisioningstatus

PublicNetworkAccess

Of openbaar netwerkverkeer al dan niet toegang heeft tot het Redis-cluster. Alleen 'Ingeschakeld' of 'Uitgeschakeld' kan worden ingesteld. null wordt alleen geretourneerd voor clusters die zijn gemaakt met behulp van een oude API-versie die deze eigenschap niet hebben en niet kunnen worden ingesteld.

RedundancyMode

Hierin wordt de huidige redundantiestrategie van het cluster uitgelegd, die van invloed is op de verwachte SLA.

ResourceState

Huidige status van de middelen

Sku

SKU-parameters die worden geleverd aan de Create Redis Enterprise-clusterbewerking.

SkuName

Het niveau van het Redis Enterprise-cluster dat moet worden geïmplementeerd. Mogelijke waarden: ('Balanced_B5', 'MemoryOptimized_M10', 'ComputeOptimized_X5', enzovoort). Zie de meest recente prijsdocumentatie voor meer informatie over SKU's. Houd er rekening mee dat extra SKU's in de toekomst mogelijk worden ondersteund.

TlsVersion

De minimale TLS-versie voor het cluster dat moet worden ondersteund, bijvoorbeeld '1.2'. Nieuwere versies kunnen in de toekomst worden toegevoegd. Houd er rekening mee dat TLS 1.0 en TLS 1.1 nu volledig verouderd zijn. U kunt ze niet gebruiken. Ze worden alleen genoemd omwille van consistentie met oude API-versies.

UserAssignedIdentity

Door de gebruiker toegewezen identiteitseigenschappen

Cluster

Beschrijft het Redis Enterprise-cluster

Name Type Description
id

string

Volledig gekwalificeerde resource-id voor de resource. Vb.: - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

identity

ManagedServiceIdentity

De identiteit van de resource.

kind

Kind

Onderscheidt het soort cluster. Alleen lezen.

location

string

De geografische locatie waar de resource zich bevindt

name

string

De naam van de resource

properties.encryption

Encryption

Versleuteling-at-rest-configuratie voor het cluster.

properties.highAvailability

HighAvailability

Standaard ingeschakeld. Als highAvailability is uitgeschakeld, wordt de gegevensset niet gerepliceerd. Dit is van invloed op de SLA voor beschikbaarheid en verhoogt het risico op gegevensverlies.

properties.hostName

string

DNS-naam van het clustereindpunt

properties.minimumTlsVersion

TlsVersion

De minimale TLS-versie voor het cluster dat moet worden ondersteund, bijvoorbeeld '1.2'. Nieuwere versies kunnen in de toekomst worden toegevoegd. Houd er rekening mee dat TLS 1.0 en TLS 1.1 nu volledig verouderd zijn. U kunt ze niet gebruiken. Ze worden alleen genoemd omwille van consistentie met oude API-versies.

properties.privateEndpointConnections

PrivateEndpointConnection[]

Lijst met privé-eindpuntverbindingen die zijn gekoppeld aan het opgegeven Redis Enterprise-cluster

properties.provisioningState

ProvisioningState

Huidige inrichtingsstatus van het cluster

properties.publicNetworkAccess

PublicNetworkAccess

Of openbaar netwerkverkeer al dan niet toegang heeft tot het Redis-cluster. Alleen 'Ingeschakeld' of 'Uitgeschakeld' kan worden ingesteld. null wordt alleen geretourneerd voor clusters die zijn gemaakt met behulp van een oude API-versie die deze eigenschap niet hebben en niet kunnen worden ingesteld.

properties.redisVersion

string

Versie van redis die het cluster ondersteunt, bijvoorbeeld '6'

properties.redundancyMode

RedundancyMode

Hierin wordt de huidige redundantiestrategie van het cluster uitgelegd, die van invloed is op de verwachte SLA.

properties.resourceState

ResourceState

Huidige resourcestatus van het cluster

sku

Sku

De SKU die moet worden gemaakt, wat van invloed is op de prijs, prestaties en functies.

tags

object

Resourcetags.

type

string

Het type bron. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

zones

string[]

De beschikbaarheidszones waar dit cluster wordt geïmplementeerd.

CmkIdentityType

Alleen userAssignedIdentity wordt ondersteund in deze API-versie; andere typen kunnen in de toekomst worden ondersteund

Waarde Description
systemAssignedIdentity
userAssignedIdentity

CustomerManagedKeyEncryption

Alle door de klant beheerde sleutelversleutelingseigenschappen voor de resource. Stel dit in op een leeg object om door Microsoft beheerde sleutelversleuteling te gebruiken.

Name Type Description
keyEncryptionKeyIdentity

KeyEncryptionKeyIdentity

Alle identiteitsconfiguraties voor door de klant beheerde sleutelinstellingen die definiëren welke identiteit moet worden gebruikt voor verificatie bij Key Vault.

keyEncryptionKeyUrl

string

Url van sleutelversleutelingssleutel, alleen versiebeheer. Bijvoorbeeld: https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78

Encryption

Versleuteling-at-rest-configuratie voor het cluster.

Name Type Description
customerManagedKeyEncryption

CustomerManagedKeyEncryption

Alle door de klant beheerde sleutelversleutelingseigenschappen voor de resource. Stel dit in op een leeg object om door Microsoft beheerde sleutelversleuteling te gebruiken.

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

Name Type Description
info

object

De aanvullende informatie.

type

string

Het extra informatietype.

ErrorDetail

De foutdetails.

Name Type Description
additionalInfo

ErrorAdditionalInfo[]

De fout bevat aanvullende informatie.

code

string

De foutcode.

details

ErrorDetail[]

De foutdetails.

message

string

Het foutbericht.

target

string

Het foutdoel.

ErrorResponse

Foutreactie

Name Type Description
error

ErrorDetail

Het foutobject.

HighAvailability

Standaard ingeschakeld. Als highAvailability is uitgeschakeld, wordt de gegevensset niet gerepliceerd. Dit is van invloed op de SLA voor beschikbaarheid en verhoogt het risico op gegevensverlies.

Waarde Description
Enabled
Disabled

KeyEncryptionKeyIdentity

Alle identiteitsconfiguraties voor door de klant beheerde sleutelinstellingen die definiëren welke identiteit moet worden gebruikt voor verificatie bij Key Vault.

Name Type Description
identityType

CmkIdentityType

Alleen userAssignedIdentity wordt ondersteund in deze API-versie; andere typen kunnen in de toekomst worden ondersteund

userAssignedIdentityResourceId

string

Door de gebruiker toegewezen identiteit die moet worden gebruikt voor toegang tot de URL van de sleutelversleutelingssleutel. Voorbeeld: /subscriptions//resourceGroups/<resource group>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId.

Kind

Onderscheidt het soort cluster. Alleen lezen.

Waarde Description
v1
v2

ManagedServiceIdentity

Beheerde service-identiteit (door het systeem toegewezen en/of door de gebruiker toegewezen identiteiten)

Name Type Description
principalId

string (uuid)

De service-principal-id van de door het systeem toegewezen identiteit. Deze eigenschap wordt alleen verstrekt voor een door het systeem toegewezen identiteit.

tenantId

string (uuid)

De tenant-id van de door het systeem toegewezen identiteit. Deze eigenschap wordt alleen verstrekt voor een door het systeem toegewezen identiteit.

type

ManagedServiceIdentityType

Type beheerde service-identiteit (waarbij zowel SystemAssigned- als UserAssigned-typen zijn toegestaan).

userAssignedIdentities

<string,  UserAssignedIdentity>

User-Assigned identiteiten
De set door de gebruiker toegewezen identiteiten die aan de resource zijn gekoppeld. De woordenlijstsleutels userAssignedIdentities zijn ARM-resource-id's in de vorm: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. De waarden van de woordenlijst kunnen lege objecten ({}) zijn in aanvragen.

ManagedServiceIdentityType

Type beheerde service-identiteit (waarbij zowel SystemAssigned- als UserAssigned-typen zijn toegestaan).

Waarde Description
None
SystemAssigned
UserAssigned
SystemAssigned, UserAssigned

PrivateEndpoint

De privé-eindpuntresource.

Name Type Description
id

string

De ARM-id voor privé-eindpunt

PrivateEndpointConnection

De privé-eindpuntverbindingsresource.

Name Type Description
id

string

Volledig gekwalificeerde resource-id voor de resource. Vb.: - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

De naam van de resource

properties.privateEndpoint

PrivateEndpoint

De resource van het privé-eindpunt.

properties.privateLinkServiceConnectionState

PrivateLinkServiceConnectionState

Een verzameling informatie over de status van de verbinding tussen serviceconsumer en provider.

properties.provisioningState

PrivateEndpointConnectionProvisioningState

De inrichtingsstatus van de privé-eindpuntverbindingsresource.

type

string

Het type bron. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

PrivateEndpointConnectionProvisioningState

De huidige inrichtingsstatus.

Waarde Description
Succeeded
Creating
Deleting
Failed

PrivateEndpointServiceConnectionStatus

De verbindingsstatus van het privé-eindpunt.

Waarde Description
Pending
Approved
Rejected

PrivateLinkServiceConnectionState

Een verzameling informatie over de status van de verbinding tussen serviceconsumer en provider.

Name Type Description
actionsRequired

string

Een bericht dat aangeeft of wijzigingen in de serviceprovider updates voor de consument vereisen.

description

string

De reden voor goedkeuring/afwijzing van de verbinding.

status

PrivateEndpointServiceConnectionStatus

Geeft aan of de verbinding is goedgekeurd/geweigerd/verwijderd door de eigenaar van de service.

ProvisioningState

Huidige provisioningstatus

Waarde Description
Succeeded
Failed
Canceled
Creating
Updating
Deleting

PublicNetworkAccess

Of openbaar netwerkverkeer al dan niet toegang heeft tot het Redis-cluster. Alleen 'Ingeschakeld' of 'Uitgeschakeld' kan worden ingesteld. null wordt alleen geretourneerd voor clusters die zijn gemaakt met behulp van een oude API-versie die deze eigenschap niet hebben en niet kunnen worden ingesteld.

Waarde Description
Enabled
Disabled

RedundancyMode

Hierin wordt de huidige redundantiestrategie van het cluster uitgelegd, die van invloed is op de verwachte SLA.

Waarde Description
None

Geen redundantie. Verlies van beschikbaarheid zal optreden.

LR

Lokale redundantie met hoge beschikbaarheid.

ZR

Zone overbodig. Hogere beschikbaarheid.

ResourceState

Huidige status van de middelen

Waarde Description
Running
Creating
CreateFailed
Updating
UpdateFailed
Deleting
DeleteFailed
Enabling
EnableFailed
Disabling
DisableFailed
Disabled
Scaling
ScalingFailed
Moving

Sku

SKU-parameters die worden geleverd aan de Create Redis Enterprise-clusterbewerking.

Name Type Description
capacity

integer (int32)

Deze eigenschap wordt alleen gebruikt met Enterprise- en EnterpriseFlash-SKU's. Bepaalt de grootte van het cluster. Geldige waarden zijn (2, 4, 6, ...) voor Enterprise-SKU's en (3, 9, 15, ...) voor EnterpriseFlash-SKU's.

name

SkuName

Het niveau van het Redis Enterprise-cluster dat moet worden geïmplementeerd. Mogelijke waarden: ('Balanced_B5', 'MemoryOptimized_M10', 'ComputeOptimized_X5', enzovoort). Zie de meest recente prijsdocumentatie voor meer informatie over SKU's. Houd er rekening mee dat extra SKU's in de toekomst mogelijk worden ondersteund.

SkuName

Het niveau van het Redis Enterprise-cluster dat moet worden geïmplementeerd. Mogelijke waarden: ('Balanced_B5', 'MemoryOptimized_M10', 'ComputeOptimized_X5', enzovoort). Zie de meest recente prijsdocumentatie voor meer informatie over SKU's. Houd er rekening mee dat extra SKU's in de toekomst mogelijk worden ondersteund.

Waarde Description
Enterprise_E1
Enterprise_E5
Enterprise_E10
Enterprise_E20
Enterprise_E50
Enterprise_E100
Enterprise_E200
Enterprise_E400
EnterpriseFlash_F300
EnterpriseFlash_F700
EnterpriseFlash_F1500
Balanced_B0
Balanced_B1
Balanced_B3
Balanced_B5
Balanced_B10
Balanced_B20
Balanced_B50
Balanced_B100
Balanced_B150
Balanced_B250
Balanced_B350
Balanced_B500
Balanced_B700
Balanced_B1000
MemoryOptimized_M10
MemoryOptimized_M20
MemoryOptimized_M50
MemoryOptimized_M100
MemoryOptimized_M150
MemoryOptimized_M250
MemoryOptimized_M350
MemoryOptimized_M500
MemoryOptimized_M700
MemoryOptimized_M1000
MemoryOptimized_M1500
MemoryOptimized_M2000
ComputeOptimized_X3
ComputeOptimized_X5
ComputeOptimized_X10
ComputeOptimized_X20
ComputeOptimized_X50
ComputeOptimized_X100
ComputeOptimized_X150
ComputeOptimized_X250
ComputeOptimized_X350
ComputeOptimized_X500
ComputeOptimized_X700
FlashOptimized_A250
FlashOptimized_A500
FlashOptimized_A700
FlashOptimized_A1000
FlashOptimized_A1500
FlashOptimized_A2000
FlashOptimized_A4500

TlsVersion

De minimale TLS-versie voor het cluster dat moet worden ondersteund, bijvoorbeeld '1.2'. Nieuwere versies kunnen in de toekomst worden toegevoegd. Houd er rekening mee dat TLS 1.0 en TLS 1.1 nu volledig verouderd zijn. U kunt ze niet gebruiken. Ze worden alleen genoemd omwille van consistentie met oude API-versies.

Waarde Description
1.0
1.1
1.2

UserAssignedIdentity

Door de gebruiker toegewezen identiteitseigenschappen

Name Type Description
clientId

string (uuid)

De client-id van de toegewezen identiteit.

principalId

string (uuid)

De principal-id van de toegewezen identiteit.