Redis Enterprise - Create

Referentie

Service:: Redis Cache

API-versie:: 2024-10-01

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

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

URI-parameters

Name	In	Vereist	Type	Description
clusterName	path	True	string	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 Regex-patroon: `^(?=.{1,60}$)[A-Za-z0-9]+(-[A-Za-z0-9]+)*$`
resourceGroupName	path	True	string	De naam van de resourcegroep. De naam is niet hoofdlettergevoelig.
subscriptionId	path	True	string	De id van het doelabonnement.
api-version	query	True	string	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
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.minimumTlsVersion		TlsVersion	De minimale TLS-versie voor het cluster dat moet worden ondersteund, bijvoorbeeld '1.2'
tags		object	Resourcetags.
zones		string[]	De beschikbaarheidszones waar dit cluster wordt geïmplementeerd.

Antwoorden

Name	Type	Description
200 OK	Cluster	Het cluster is/wordt bijgewerkt. Controleer provisioningState en resourceState om de gedetailleerde status te bekijken.
201 Created	Cluster	Het cluster is/wordt gemaakt. 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

Azure Active Directory OAuth2 Flow.

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

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

RedisEnterpriseCreate

Voorbeeldaanvraag

HTTP

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cache/redisEnterprise/cache1?api-version=2024-10-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"
      }
    }
  },
  "tags": {
    "tag1": "value1"
  }
}

Voorbeeldrespons

Statuscode:: 201

{
  "name": "cache1",
  "type": "Microsoft.Cache/redisEnterprise",
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cache/redisEnterprise/cache1",
  "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": {
        "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",
    "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"
  }
}

Statuscode:: 200

{
  "name": "cache1",
  "type": "Microsoft.Cache/redisEnterprise",
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cache/redisEnterprise/cache1",
  "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": {
        "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"
  },
  "tags": {
    "tag1": "value1"
  }
}

Definities

Name	Description
Cluster	Beschrijft het RedisEnterprise-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
KeyEncryptionKeyIdentity	Alle identiteitsconfiguraties voor door de klant beheerde sleutelinstellingen die definiëren welke identiteit moet worden gebruikt voor verificatie bij Key Vault.
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 inrichtingsstatus
ResourceState	Huidige resourcestatus
Sku	SKU-parameters die zijn opgegeven voor de bewerking RedisEnterprise maken.
SkuName	Het type RedisEnterprise-cluster dat moet worden geïmplementeerd. Mogelijke waarden: (Enterprise_E10, EnterpriseFlash_F300 enzovoort)
TlsVersion	De minimale TLS-versie voor het cluster dat moet worden ondersteund, bijvoorbeeld '1.2'
UserAssignedIdentity	Door de gebruiker toegewezen identiteitseigenschappen

Cluster

Beschrijft het RedisEnterprise-cluster

Name	Type	Description
id	string	Volledig gekwalificeerde resource-id voor de resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	ManagedServiceIdentity	De identiteit van de resource.
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.hostName	string	DNS-naam van het clustereindpunt
properties.minimumTlsVersion	TlsVersion	De minimale TLS-versie voor het cluster dat moet worden ondersteund, bijvoorbeeld '1.2'
properties.privateEndpointConnections	PrivateEndpointConnection[]	Lijst met privé-eindpuntverbindingen die zijn gekoppeld aan het opgegeven RedisEnterprise-cluster
properties.provisioningState	ProvisioningState	Huidige inrichtingsstatus van het cluster
properties.redisVersion	string	Versie van redis die het cluster ondersteunt, bijvoorbeeld '6'
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 resource. 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

Name	Type	Description
systemAssignedIdentity	string
userAssignedIdentity	string

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.

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. Bijvoorbeeld: /subscriptions/_{/resourceGroups//providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId.}

ManagedServiceIdentity

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

Name	Type	Description
principalId	string	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	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).

Name	Type	Description
None	string
SystemAssigned	string
SystemAssigned, UserAssigned	string
UserAssigned	string

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. Ex - /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 resource. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

PrivateEndpointConnectionProvisioningState

De huidige inrichtingsstatus.

Name	Type	Description
Creating	string
Deleting	string
Failed	string
Succeeded	string

PrivateEndpointServiceConnectionStatus

De verbindingsstatus van het privé-eindpunt.

Name	Type	Description
Approved	string
Pending	string
Rejected	string

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 inrichtingsstatus

Name	Type	Description
Canceled	string
Creating	string
Deleting	string
Failed	string
Succeeded	string
Updating	string

ResourceState

Huidige resourcestatus

Name	Type	Description
CreateFailed	string
Creating	string
DeleteFailed	string
Deleting	string
DisableFailed	string
Disabled	string
Disabling	string
EnableFailed	string
Enabling	string
Running	string
Scaling	string
ScalingFailed	string
UpdateFailed	string
Updating	string

Sku

SKU-parameters die zijn opgegeven voor de bewerking RedisEnterprise maken.

Name	Type	Description
capacity	integer	De grootte van het RedisEnterprise-cluster. De standaardwaarde is 2 of 3, afhankelijk van de SKU. Geldige waarden zijn (2, 4, 6, ...) voor Enterprise-SKU's en (3, 9, 15, ...) voor Flash-SKU's.
name	SkuName	Het type RedisEnterprise-cluster dat moet worden geïmplementeerd. Mogelijke waarden: (Enterprise_E10, EnterpriseFlash_F300 enzovoort)

SkuName

Het type RedisEnterprise-cluster dat moet worden geïmplementeerd. Mogelijke waarden: (Enterprise_E10, EnterpriseFlash_F300 enzovoort)

Name	Type	Description
EnterpriseFlash_F1500	string
EnterpriseFlash_F300	string
EnterpriseFlash_F700	string
Enterprise_E1	string
Enterprise_E10	string
Enterprise_E100	string
Enterprise_E20	string
Enterprise_E200	string
Enterprise_E400	string
Enterprise_E5	string
Enterprise_E50	string

TlsVersion

De minimale TLS-versie voor het cluster dat moet worden ondersteund, bijvoorbeeld '1.2'

Name	Type	Description
1.0	string
1.1	string
1.2	string

UserAssignedIdentity

Door de gebruiker toegewezen identiteitseigenschappen

Name	Type	Description
clientId	string	De client-id van de toegewezen identiteit.
principalId	string	De principal-id van de toegewezen identiteit.

Delen via