Partager via


Instances/répartiteurs Microsoft.IoTOperations

Définition de ressource Bicep

Le type de ressource instances/répartiteurs peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.IoTOperations/instances/broker, ajoutez le bicep suivant à votre modèle.

resource symbolicname 'Microsoft.IoTOperations/instances/brokers@2024-11-01' = {
  parent: resourceSymbolicName
  extendedLocation: {
    name: 'string'
    type: 'string'
  }
  name: 'string'
  properties: {
    advanced: {
      clients: {
        maxKeepAliveSeconds: int
        maxMessageExpirySeconds: int
        maxPacketSizeBytes: int
        maxReceiveMaximum: int
        maxSessionExpirySeconds: int
        subscriberQueueLimit: {
          length: int
          strategy: 'string'
        }
      }
      encryptInternalTraffic: 'string'
      internalCerts: {
        duration: 'string'
        privateKey: {
          algorithm: 'string'
          rotationPolicy: 'string'
        }
        renewBefore: 'string'
      }
    }
    cardinality: {
      backendChain: {
        partitions: int
        redundancyFactor: int
        workers: int
      }
      frontend: {
        replicas: int
        workers: int
      }
    }
    diagnostics: {
      logs: {
        level: 'string'
      }
      metrics: {
        prometheusPort: int
      }
      selfCheck: {
        intervalSeconds: int
        mode: 'string'
        timeoutSeconds: int
      }
      traces: {
        cacheSizeMegabytes: int
        mode: 'string'
        selfTracing: {
          intervalSeconds: int
          mode: 'string'
        }
        spanChannelCapacity: int
      }
    }
    diskBackedMessageBuffer: {
      ephemeralVolumeClaimSpec: {
        accessModes: [
          'string'
        ]
        dataSource: {
          apiGroup: 'string'
          kind: 'string'
          name: 'string'
        }
        dataSourceRef: {
          apiGroup: 'string'
          kind: 'string'
          name: 'string'
          namespace: 'string'
        }
        resources: {
          limits: {
            {customized property}: 'string'
          }
          requests: {
            {customized property}: 'string'
          }
        }
        selector: {
          matchExpressions: [
            {
              key: 'string'
              operator: 'string'
              values: [
                'string'
              ]
            }
          ]
          matchLabels: {
            {customized property}: 'string'
          }
        }
        storageClassName: 'string'
        volumeMode: 'string'
        volumeName: 'string'
      }
      maxSize: 'string'
      persistentVolumeClaimSpec: {
        accessModes: [
          'string'
        ]
        dataSource: {
          apiGroup: 'string'
          kind: 'string'
          name: 'string'
        }
        dataSourceRef: {
          apiGroup: 'string'
          kind: 'string'
          name: 'string'
          namespace: 'string'
        }
        resources: {
          limits: {
            {customized property}: 'string'
          }
          requests: {
            {customized property}: 'string'
          }
        }
        selector: {
          matchExpressions: [
            {
              key: 'string'
              operator: 'string'
              values: [
                'string'
              ]
            }
          ]
          matchLabels: {
            {customized property}: 'string'
          }
        }
        storageClassName: 'string'
        volumeMode: 'string'
        volumeName: 'string'
      }
    }
    generateResourceLimits: {
      cpu: 'string'
    }
    memoryProfile: 'string'
  }
}

Valeurs de propriété

AdvancedSettings

Nom Description Valeur
clients Configurations liées à tous les clients. clientConfig
encryptInternalTraffic Paramètre permettant d’activer ou de désactiver le chiffrement du trafic interne. 'Désactivé'
'Activé'
internalCerts Rotation des certificats et configuration de clé privée. CertManagerCertOptions

BackendChain

Nom Description Valeur
Partitions Nombre souhaité de partitions principales physiques. Int

Contraintes:
Valeur minimale = 1
Valeur maximale = 16 (obligatoire)
redondanceFactor Nombre souhaité de réplicas back-end (pods) dans une partition physique. Int

Contraintes:
Valeur minimale = 1
Valeur maximale = 5 (obligatoire)
travailleur Nombre de workers principaux logiques par réplica (pod). Int

Contraintes:
Valeur minimale = 1
Valeur maximale = 16

BrokerDiagnostics

Nom Description Valeur
Journaux Paramètres du journal de diagnostic pour la ressource. DiagnosticsLogs
métrique Paramètres des métriques de la ressource. Métriques
selfCheck Propriétés de vérification automatique. SelfCheck
Traces Propriétés de trace. traces

BrokerProperties

Nom Description Valeur
avancé Paramètres avancés du répartiteur. AdvancedSettings
cardinalité Détails de cardinalité du répartiteur. cardinalité
diagnostic Spec définit les identités souhaitées des paramètres de diagnostic Broker. BrokerDiagnostics
diskBackedMessageBuffer Paramètres de la mémoire tampon de message sauvegardée sur disque. DiskBackedMessageBuffer
generateResourceLimits Ce paramètre contrôle si les limites de ressources du processeur Kubernetes sont demandées. L’augmentation du nombre de réplicas ou de workers augmente proportionnellement la quantité de ressources processeur demandées. Si ce paramètre est activé et qu’il n’y a pas de ressources processeur insuffisantes, une erreur est émise. GenerateResourceLimits
memoryProfile Profil mémoire de Broker. 'High'
'Low'
'Medium'
'Tiny'

Cardinalité

Nom Description Valeur
backendChain Propriétés souhaitées du répartiteur principal BackendChain (obligatoire)
frontend Propriétés souhaitées du serveur frontal front-end (obligatoire)

CertManagerCertOptions

Nom Description Valeur
durée Durée de vie du certificat. Doit être spécifié à l’aide d’une heure de go. Format de durée (h m s). Par exemple, 240h pendant 240 heures et 45m pendant 45 minutes. chaîne (obligatoire)
privateKey Configuration de la clé privée de certificat. CertManagerPrivateKey (obligatoire)
renewBefore Quand commencer le renouvellement du certificat. Doit être spécifié à l’aide d’une heure de go. Format de durée (h m s). Par exemple, 240h pendant 240 heures et 45m pendant 45 minutes. chaîne (obligatoire)

CertManagerPrivateKey

Nom Description Valeur
algorithme algorithme pour la clé privée. 'Ec256'
'Ec384'
'Ec521'
'Ed25519'
'Rsa2048'
'Rsa4096'
'Rsa8192' (obligatoire)
rotationPolicy cert-manager private key rotationPolicy. 'Always'
'Never' (obligatoire)

ClientConfig

Nom Description Valeur
maxKeepAliveSeconds Limite supérieure de Keep Alive d’un client, en secondes. Int

Contraintes:
Valeur minimale = 0
Valeur maximale = 65535
maxMessageExpirySeconds Limite supérieure de l’intervalle d’expiration du message, en secondes. Int

Contraintes:
Valeur minimale = 1
Valeur maximale = 4294967295
maxPacketSizeBytes Taille maximale du message pour un paquet en octets. Int

Contraintes:
Valeur minimale = 1
Valeur maximale = 268435456
maxReceiveMaximum Limite supérieure de réception maximale qu’un client peut demander dans le paquet CONNECT. Int

Contraintes:
Valeur minimale = 1
Valeur maximale = 65535
maxSessionExpirySeconds Limite supérieure de l’intervalle d’expiration de session, en secondes. Int

Contraintes:
Valeur minimale = 1
Valeur maximale = 4294967295
subscriberQueueLimit Limite du nombre de messages mis en file d’attente pour un abonné. SubscriberQueueLimit

DiagnosticsLogs

Nom Description Valeur
niveau Niveau du journal. Exemples : « debug », « info », « warn », « error », « trace ». corde

DiskBackedMessageBuffer

Nom Description Valeur
ephemeralVolumeClaimSpec Utilisez le modèle de revendication de volume persistant spécifié pour monter un « volume éphémère générique » pour la mémoire tampon de message. Pour plus d’informations, consultez <https://kubernetes.io/docs/concepts/storage/ephemeral-volumes/#generic-ephemeral-volumes>. VolumeClaimSpec
maxSize Taille maximale de la mémoire tampon de message sur le disque. Si un modèle PVC est spécifié à l’aide de l’un des modèles éphémèresVolumeClaimSpec ou persistentVolumeClaimSpec, cette taille est utilisée comme demande et limite les tailles de ce modèle. Si ni éphémèreVolumeClaimSpec ni persistentVolumeClaimSpec ne sont spécifiés, un volume emptyDir est monté avec cette taille comme limite. Pour plus d’informations, consultez <https://kubernetes.io/docs/concepts/storage/volumes/#emptydir>. corde

Contraintes:
Modèle = ^[0-9]+[KMGTPE]$ (obligatoire)
persistentVolumeClaimSpec Utilisez le modèle de revendication de volume persistant spécifié pour monter un volume persistant pour la mémoire tampon de message. VolumeClaimSpec

ExtendedLocation

Nom Description Valeur
nom Nom de l’emplacement étendu. chaîne (obligatoire)
type Type de ExtendedLocation. 'CustomLocation' (obligatoire)

Frontend

Nom Description Valeur
Répliques Nombre souhaité d’instances frontales (pods). Int

Contraintes:
Valeur minimale = 1
Valeur maximale = 16 (obligatoire)
travailleur Nombre de workers frontend logiques par instance (pod). Int

Contraintes:
Valeur minimale = 1
Valeur maximale = 16

GenerateResourceLimits

Nom Description Valeur
CPU Bascule pour activer/désactiver les limites des ressources processeur. 'Désactivé'
'Activé'

KubernetesReference

Nom Description Valeur
apiGroup APIGroup est le groupe pour la ressource référencée. Si APIGroup n’est pas spécifié, le type spécifié doit se trouver dans le groupe d’API principal. Pour tous les autres types tiers, APIGroup est requis. corde
gentil Type de ressource référencée chaîne (obligatoire)
nom Le nom est le nom de la ressource référencée chaîne (obligatoire)
Namespace L’espace de noms est l’espace de noms de la ressource référencée. Ce champ est obligatoire lorsque la ressource a un espace de noms. corde

LocalKubernetesReference

Nom Description Valeur
apiGroup APIGroup est le groupe pour la ressource référencée. Si APIGroup n’est pas spécifié, le type spécifié doit se trouver dans le groupe d’API principal. Pour tous les autres types tiers, APIGroup est requis. corde
gentil Type de ressource référencée chaîne (obligatoire)
nom Le nom est le nom de la ressource référencée chaîne (obligatoire)

Métrique

Nom Description Valeur
prometheusPort Port prometheus pour exposer les métriques. Int

Contraintes:
Valeur minimale = 0
Valeur maximale = 65535

Microsoft.IoTOperations/instances/broker

Nom Description Valeur
extendedLocation Emplacement de périphérie de la ressource. ExtendedLocation (obligatoire)
nom Nom de la ressource corde

Contraintes:
Longueur minimale = 3
Longueur maximale = 63
Modèle = ^[a-z0-9][a-z0-9-]*[a-z0-9]$ (obligatoire)
parent Dans Bicep, vous pouvez spécifier la ressource parente d’une ressource enfant. Vous devez uniquement ajouter cette propriété lorsque la ressource enfant est déclarée en dehors de la ressource parente.

Pour plus d’informations, consultez ressource enfant en dehors de la ressource parente.
Nom symbolique de la ressource de type : instances
Propriétés Propriétés spécifiques à la ressource pour cette ressource. BrokerProperties

SelfCheck

Nom Description Valeur
intervalSeconds Intervalle de vérification automatique. Int

Contraintes:
Valeur minimale = 30
Valeur maximale = 300
mode Bascule pour activer/désactiver la vérification automatique. 'Désactivé'
'Activé'
timeoutSeconds Délai d’expiration de l’auto-vérification. Int

Contraintes:
Valeur minimale = 5
Valeur maximale = 120

AutoTracing

Nom Description Valeur
intervalSeconds Intervalle de suivi automatique. Int

Contraintes:
Valeur minimale = 1
Valeur maximale = 300
mode Bascule pour activer/désactiver le suivi automatique. 'Désactivé'
'Activé'

SubscriberQueueLimit

Nom Description Valeur
longueur Longueur maximale de la file d’attente avant que les messages ne commencent à être supprimés. Int

Contraintes:
Valeur minimale = 1
stratégie Stratégie à utiliser pour supprimer des messages de la file d’attente. 'DropOldest'
'None'

Traces

Nom Description Valeur
cacheSizeMegabytes Taille du cache en mégaoctets. Int

Contraintes:
Valeur minimale = 1
Valeur maximale = 128
mode Bascule pour activer/désactiver les traces. 'Désactivé'
'Activé'
autoTracing Propriétés de suivi automatique. SelfTracing
spanChannelCapacity Capacité du canal d’étendue. Int

Contraintes:
Valeur minimale = 1 000
Valeur maximale = 100000

VolumeClaimResourceRequirements

Nom Description Valeur
Limites Les limites décrivent la quantité maximale de ressources de calcul autorisées. Plus d’informations : https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ VolumeClaimResourceRequirementsLimits
Requêtes Les demandes décrivent la quantité minimale de ressources de calcul requises. Si les requêtes sont omises pour un conteneur, elle est définie par défaut sur Limites si elle est spécifiée explicitement, sinon à une valeur définie par l’implémentation. Plus d’informations : https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ VolumeClaimResourceRequirementsRequests

VolumeClaimResourceRequirementsLimits

Nom Description Valeur

VolumeClaimResourceRequirementsRequests

Nom Description Valeur

VolumeClaimSpec

Nom Description Valeur
accessModes AccessModes contient les modes d’accès souhaités dont le volume doit avoir. Plus d’informations : https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1 string[]
dataSource Ce champ peut être utilisé pour spécifier soit : * Un objet VolumeSnapshot existant (snapshot.storage.k8s.io/VolumeSnapshot) * Un PVC existant (PersistentVolumeClaim) Si le provisionneur ou un contrôleur externe peut prendre en charge la source de données spécifiée, il crée un volume basé sur le contenu de la source de données spécifiée. Si la porte de fonctionnalité AnyVolumeDataSource est activée, ce champ aura toujours le même contenu que le champ DataSourceRef. LocalKubernetesReference
dataSourceRef Spécifie l’objet à partir duquel remplir le volume avec des données, si un volume non vide est souhaité. Il peut s’agir d’un objet local à partir d’un groupe d’API non vide (objet non principal) ou d’un objet PersistentVolumeClaim. Lorsque ce champ est spécifié, la liaison de volume réussit uniquement si le type de l’objet spécifié correspond à un populateur de volume ou un provisionneur dynamique installé. Ce champ remplace les fonctionnalités du champ DataSource et, par conséquent, si les deux champs ne sont pas vides, ils doivent avoir la même valeur. Pour la compatibilité descendante, les deux champs (DataSource et DataSourceRef) sont définis automatiquement sur la même valeur si l’un d’eux est vide et que l’autre n’est pas vide. Il existe deux différences importantes entre DataSource et DataSourceRef : * Alors que DataSource autorise uniquement deux types d’objets spécifiques, DataSourceRef autorise n’importe quel objet non principal, ainsi que les objets PersistentVolumeClaim. * Alors que DataSource ignore les valeurs non autorisées (les supprimant), DataSourceRef conserve toutes les valeurs et génère une erreur si une valeur non autorisée est spécifiée. (bêta) L’utilisation de ce champ nécessite que la porte de fonctionnalité AnyVolumeDataSource soit activée. KubernetesReference
ressources Les ressources représentent les ressources minimales dont le volume doit avoir. Si la fonctionnalité RecoverVolumeExpansionFailure est activée, les utilisateurs sont autorisés à spécifier les exigences de ressources inférieures à la valeur précédente, mais doivent toujours être supérieures à la capacité enregistrée dans le champ d’état de la revendication. Plus d’informations : https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources VolumeClaimResourceRequirements
sélecteur Requête d’étiquette sur les volumes à prendre en compte pour la liaison. volumeClaimSpecSelector
storageClassName Nom de storageClass requis par la revendication. Plus d’informations : https://kubernetes.io/docs/concepts/storage/persistent-volumes#class-1 corde
volumeMode volumeMode définit le type de volume requis par la revendication. La valeur du système de fichiers est implicite lorsqu’elle n’est pas incluse dans les spécifications de revendication. Il s’agit d’une fonctionnalité bêta. corde
volumeName VolumeName est la référence de liaison à persistentVolume qui sauvegarde cette revendication. corde

VolumeClaimSpecSelector

Nom Description Valeur
matchExpressions MatchExpressions est une liste des exigences de sélecteur d’étiquettes. Les exigences sont AND. VolumeClaimSpecSelectorMatchExpressions[]
matchLabels MatchLabels est une carte de paires {key,value}. Une seule {clé,value} dans le mappage matchLabels équivaut à un élément de matchExpressions, dont le champ de clé est « key », l’opérateur est « In », et le tableau de valeurs contient uniquement « value ». Les exigences sont AND. VolumeClaimSpecSelectorMatchLabels

VolumeClaimSpecSelectorMatchExpressions

Nom Description Valeur
clé clé est la clé d’étiquette à laquelle le sélecteur s’applique. chaîne (obligatoire)
opérateur l’opérateur représente la relation d’une clé à un ensemble de valeurs. Les opérateurs valides sont In, NotIn, Exists et DoesNotExist. 'DoesNotExist'
'Exists'
'In'
'NotIn' (obligatoire)
Valeurs les valeurs sont un tableau de valeurs de chaîne. Si l’opérateur est In ou NotIn, le tableau de valeurs doit être non vide. Si l’opérateur existe ou DoesNotExist, le tableau de valeurs doit être vide. Ce tableau est remplacé lors d’un correctif de fusion stratégique. string[]

VolumeClaimSpecSelectorMatchLabels

Nom Description Valeur

Définition de ressource de modèle ARM

Le type de ressource instances/répartiteurs peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.IoTOperations/instances/broker, ajoutez le code JSON suivant à votre modèle.

{
  "type": "Microsoft.IoTOperations/instances/brokers",
  "apiVersion": "2024-11-01",
  "name": "string",
  "extendedLocation": {
    "name": "string",
    "type": "string"
  },
  "properties": {
    "advanced": {
      "clients": {
        "maxKeepAliveSeconds": "int",
        "maxMessageExpirySeconds": "int",
        "maxPacketSizeBytes": "int",
        "maxReceiveMaximum": "int",
        "maxSessionExpirySeconds": "int",
        "subscriberQueueLimit": {
          "length": "int",
          "strategy": "string"
        }
      },
      "encryptInternalTraffic": "string",
      "internalCerts": {
        "duration": "string",
        "privateKey": {
          "algorithm": "string",
          "rotationPolicy": "string"
        },
        "renewBefore": "string"
      }
    },
    "cardinality": {
      "backendChain": {
        "partitions": "int",
        "redundancyFactor": "int",
        "workers": "int"
      },
      "frontend": {
        "replicas": "int",
        "workers": "int"
      }
    },
    "diagnostics": {
      "logs": {
        "level": "string"
      },
      "metrics": {
        "prometheusPort": "int"
      },
      "selfCheck": {
        "intervalSeconds": "int",
        "mode": "string",
        "timeoutSeconds": "int"
      },
      "traces": {
        "cacheSizeMegabytes": "int",
        "mode": "string",
        "selfTracing": {
          "intervalSeconds": "int",
          "mode": "string"
        },
        "spanChannelCapacity": "int"
      }
    },
    "diskBackedMessageBuffer": {
      "ephemeralVolumeClaimSpec": {
        "accessModes": [ "string" ],
        "dataSource": {
          "apiGroup": "string",
          "kind": "string",
          "name": "string"
        },
        "dataSourceRef": {
          "apiGroup": "string",
          "kind": "string",
          "name": "string",
          "namespace": "string"
        },
        "resources": {
          "limits": {
            "{customized property}": "string"
          },
          "requests": {
            "{customized property}": "string"
          }
        },
        "selector": {
          "matchExpressions": [
            {
              "key": "string",
              "operator": "string",
              "values": [ "string" ]
            }
          ],
          "matchLabels": {
            "{customized property}": "string"
          }
        },
        "storageClassName": "string",
        "volumeMode": "string",
        "volumeName": "string"
      },
      "maxSize": "string",
      "persistentVolumeClaimSpec": {
        "accessModes": [ "string" ],
        "dataSource": {
          "apiGroup": "string",
          "kind": "string",
          "name": "string"
        },
        "dataSourceRef": {
          "apiGroup": "string",
          "kind": "string",
          "name": "string",
          "namespace": "string"
        },
        "resources": {
          "limits": {
            "{customized property}": "string"
          },
          "requests": {
            "{customized property}": "string"
          }
        },
        "selector": {
          "matchExpressions": [
            {
              "key": "string",
              "operator": "string",
              "values": [ "string" ]
            }
          ],
          "matchLabels": {
            "{customized property}": "string"
          }
        },
        "storageClassName": "string",
        "volumeMode": "string",
        "volumeName": "string"
      }
    },
    "generateResourceLimits": {
      "cpu": "string"
    },
    "memoryProfile": "string"
  }
}

Valeurs de propriété

AdvancedSettings

Nom Description Valeur
clients Configurations liées à tous les clients. clientConfig
encryptInternalTraffic Paramètre permettant d’activer ou de désactiver le chiffrement du trafic interne. 'Désactivé'
'Activé'
internalCerts Rotation des certificats et configuration de clé privée. CertManagerCertOptions

BackendChain

Nom Description Valeur
Partitions Nombre souhaité de partitions principales physiques. Int

Contraintes:
Valeur minimale = 1
Valeur maximale = 16 (obligatoire)
redondanceFactor Nombre souhaité de réplicas back-end (pods) dans une partition physique. Int

Contraintes:
Valeur minimale = 1
Valeur maximale = 5 (obligatoire)
travailleur Nombre de workers principaux logiques par réplica (pod). Int

Contraintes:
Valeur minimale = 1
Valeur maximale = 16

BrokerDiagnostics

Nom Description Valeur
Journaux Paramètres du journal de diagnostic pour la ressource. DiagnosticsLogs
métrique Paramètres des métriques de la ressource. Métriques
selfCheck Propriétés de vérification automatique. SelfCheck
Traces Propriétés de trace. traces

BrokerProperties

Nom Description Valeur
avancé Paramètres avancés du répartiteur. AdvancedSettings
cardinalité Détails de cardinalité du répartiteur. cardinalité
diagnostic Spec définit les identités souhaitées des paramètres de diagnostic Broker. BrokerDiagnostics
diskBackedMessageBuffer Paramètres de la mémoire tampon de message sauvegardée sur disque. DiskBackedMessageBuffer
generateResourceLimits Ce paramètre contrôle si les limites de ressources du processeur Kubernetes sont demandées. L’augmentation du nombre de réplicas ou de workers augmente proportionnellement la quantité de ressources processeur demandées. Si ce paramètre est activé et qu’il n’y a pas de ressources processeur insuffisantes, une erreur est émise. GenerateResourceLimits
memoryProfile Profil mémoire de Broker. 'High'
'Low'
'Medium'
'Tiny'

Cardinalité

Nom Description Valeur
backendChain Propriétés souhaitées du répartiteur principal BackendChain (obligatoire)
frontend Propriétés souhaitées du serveur frontal front-end (obligatoire)

CertManagerCertOptions

Nom Description Valeur
durée Durée de vie du certificat. Doit être spécifié à l’aide d’une heure de go. Format de durée (h m s). Par exemple, 240h pendant 240 heures et 45m pendant 45 minutes. chaîne (obligatoire)
privateKey Configuration de la clé privée de certificat. CertManagerPrivateKey (obligatoire)
renewBefore Quand commencer le renouvellement du certificat. Doit être spécifié à l’aide d’une heure de go. Format de durée (h m s). Par exemple, 240h pendant 240 heures et 45m pendant 45 minutes. chaîne (obligatoire)

CertManagerPrivateKey

Nom Description Valeur
algorithme algorithme pour la clé privée. 'Ec256'
'Ec384'
'Ec521'
'Ed25519'
'Rsa2048'
'Rsa4096'
'Rsa8192' (obligatoire)
rotationPolicy cert-manager private key rotationPolicy. 'Always'
'Never' (obligatoire)

ClientConfig

Nom Description Valeur
maxKeepAliveSeconds Limite supérieure de Keep Alive d’un client, en secondes. Int

Contraintes:
Valeur minimale = 0
Valeur maximale = 65535
maxMessageExpirySeconds Limite supérieure de l’intervalle d’expiration du message, en secondes. Int

Contraintes:
Valeur minimale = 1
Valeur maximale = 4294967295
maxPacketSizeBytes Taille maximale du message pour un paquet en octets. Int

Contraintes:
Valeur minimale = 1
Valeur maximale = 268435456
maxReceiveMaximum Limite supérieure de réception maximale qu’un client peut demander dans le paquet CONNECT. Int

Contraintes:
Valeur minimale = 1
Valeur maximale = 65535
maxSessionExpirySeconds Limite supérieure de l’intervalle d’expiration de session, en secondes. Int

Contraintes:
Valeur minimale = 1
Valeur maximale = 4294967295
subscriberQueueLimit Limite du nombre de messages mis en file d’attente pour un abonné. SubscriberQueueLimit

DiagnosticsLogs

Nom Description Valeur
niveau Niveau du journal. Exemples : « debug », « info », « warn », « error », « trace ». corde

DiskBackedMessageBuffer

Nom Description Valeur
ephemeralVolumeClaimSpec Utilisez le modèle de revendication de volume persistant spécifié pour monter un « volume éphémère générique » pour la mémoire tampon de message. Pour plus d’informations, consultez <https://kubernetes.io/docs/concepts/storage/ephemeral-volumes/#generic-ephemeral-volumes>. VolumeClaimSpec
maxSize Taille maximale de la mémoire tampon de message sur le disque. Si un modèle PVC est spécifié à l’aide de l’un des modèles éphémèresVolumeClaimSpec ou persistentVolumeClaimSpec, cette taille est utilisée comme demande et limite les tailles de ce modèle. Si ni éphémèreVolumeClaimSpec ni persistentVolumeClaimSpec ne sont spécifiés, un volume emptyDir est monté avec cette taille comme limite. Pour plus d’informations, consultez <https://kubernetes.io/docs/concepts/storage/volumes/#emptydir>. corde

Contraintes:
Modèle = ^[0-9]+[KMGTPE]$ (obligatoire)
persistentVolumeClaimSpec Utilisez le modèle de revendication de volume persistant spécifié pour monter un volume persistant pour la mémoire tampon de message. VolumeClaimSpec

ExtendedLocation

Nom Description Valeur
nom Nom de l’emplacement étendu. chaîne (obligatoire)
type Type de ExtendedLocation. 'CustomLocation' (obligatoire)

Frontend

Nom Description Valeur
Répliques Nombre souhaité d’instances frontales (pods). Int

Contraintes:
Valeur minimale = 1
Valeur maximale = 16 (obligatoire)
travailleur Nombre de workers frontend logiques par instance (pod). Int

Contraintes:
Valeur minimale = 1
Valeur maximale = 16

GenerateResourceLimits

Nom Description Valeur
CPU Bascule pour activer/désactiver les limites des ressources processeur. 'Désactivé'
'Activé'

KubernetesReference

Nom Description Valeur
apiGroup APIGroup est le groupe pour la ressource référencée. Si APIGroup n’est pas spécifié, le type spécifié doit se trouver dans le groupe d’API principal. Pour tous les autres types tiers, APIGroup est requis. corde
gentil Type de ressource référencée chaîne (obligatoire)
nom Le nom est le nom de la ressource référencée chaîne (obligatoire)
Namespace L’espace de noms est l’espace de noms de la ressource référencée. Ce champ est obligatoire lorsque la ressource a un espace de noms. corde

LocalKubernetesReference

Nom Description Valeur
apiGroup APIGroup est le groupe pour la ressource référencée. Si APIGroup n’est pas spécifié, le type spécifié doit se trouver dans le groupe d’API principal. Pour tous les autres types tiers, APIGroup est requis. corde
gentil Type de ressource référencée chaîne (obligatoire)
nom Le nom est le nom de la ressource référencée chaîne (obligatoire)

Métrique

Nom Description Valeur
prometheusPort Port prometheus pour exposer les métriques. Int

Contraintes:
Valeur minimale = 0
Valeur maximale = 65535

Microsoft.IoTOperations/instances/broker

Nom Description Valeur
apiVersion Version de l’API '2024-11-01'
extendedLocation Emplacement de périphérie de la ressource. ExtendedLocation (obligatoire)
nom Nom de la ressource corde

Contraintes:
Longueur minimale = 3
Longueur maximale = 63
Modèle = ^[a-z0-9][a-z0-9-]*[a-z0-9]$ (obligatoire)
Propriétés Propriétés spécifiques à la ressource pour cette ressource. BrokerProperties
type Type de ressource 'Microsoft.IoTOperations/instances/broker'

SelfCheck

Nom Description Valeur
intervalSeconds Intervalle de vérification automatique. Int

Contraintes:
Valeur minimale = 30
Valeur maximale = 300
mode Bascule pour activer/désactiver la vérification automatique. 'Désactivé'
'Activé'
timeoutSeconds Délai d’expiration de l’auto-vérification. Int

Contraintes:
Valeur minimale = 5
Valeur maximale = 120

AutoTracing

Nom Description Valeur
intervalSeconds Intervalle de suivi automatique. Int

Contraintes:
Valeur minimale = 1
Valeur maximale = 300
mode Bascule pour activer/désactiver le suivi automatique. 'Désactivé'
'Activé'

SubscriberQueueLimit

Nom Description Valeur
longueur Longueur maximale de la file d’attente avant que les messages ne commencent à être supprimés. Int

Contraintes:
Valeur minimale = 1
stratégie Stratégie à utiliser pour supprimer des messages de la file d’attente. 'DropOldest'
'None'

Traces

Nom Description Valeur
cacheSizeMegabytes Taille du cache en mégaoctets. Int

Contraintes:
Valeur minimale = 1
Valeur maximale = 128
mode Bascule pour activer/désactiver les traces. 'Désactivé'
'Activé'
autoTracing Propriétés de suivi automatique. SelfTracing
spanChannelCapacity Capacité du canal d’étendue. Int

Contraintes:
Valeur minimale = 1 000
Valeur maximale = 100000

VolumeClaimResourceRequirements

Nom Description Valeur
Limites Les limites décrivent la quantité maximale de ressources de calcul autorisées. Plus d’informations : https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ VolumeClaimResourceRequirementsLimits
Requêtes Les demandes décrivent la quantité minimale de ressources de calcul requises. Si les requêtes sont omises pour un conteneur, elle est définie par défaut sur Limites si elle est spécifiée explicitement, sinon à une valeur définie par l’implémentation. Plus d’informations : https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ VolumeClaimResourceRequirementsRequests

VolumeClaimResourceRequirementsLimits

Nom Description Valeur

VolumeClaimResourceRequirementsRequests

Nom Description Valeur

VolumeClaimSpec

Nom Description Valeur
accessModes AccessModes contient les modes d’accès souhaités dont le volume doit avoir. Plus d’informations : https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1 string[]
dataSource Ce champ peut être utilisé pour spécifier soit : * Un objet VolumeSnapshot existant (snapshot.storage.k8s.io/VolumeSnapshot) * Un PVC existant (PersistentVolumeClaim) Si le provisionneur ou un contrôleur externe peut prendre en charge la source de données spécifiée, il crée un volume basé sur le contenu de la source de données spécifiée. Si la porte de fonctionnalité AnyVolumeDataSource est activée, ce champ aura toujours le même contenu que le champ DataSourceRef. LocalKubernetesReference
dataSourceRef Spécifie l’objet à partir duquel remplir le volume avec des données, si un volume non vide est souhaité. Il peut s’agir d’un objet local à partir d’un groupe d’API non vide (objet non principal) ou d’un objet PersistentVolumeClaim. Lorsque ce champ est spécifié, la liaison de volume réussit uniquement si le type de l’objet spécifié correspond à un populateur de volume ou un provisionneur dynamique installé. Ce champ remplace les fonctionnalités du champ DataSource et, par conséquent, si les deux champs ne sont pas vides, ils doivent avoir la même valeur. Pour la compatibilité descendante, les deux champs (DataSource et DataSourceRef) sont définis automatiquement sur la même valeur si l’un d’eux est vide et que l’autre n’est pas vide. Il existe deux différences importantes entre DataSource et DataSourceRef : * Alors que DataSource autorise uniquement deux types d’objets spécifiques, DataSourceRef autorise n’importe quel objet non principal, ainsi que les objets PersistentVolumeClaim. * Alors que DataSource ignore les valeurs non autorisées (les supprimant), DataSourceRef conserve toutes les valeurs et génère une erreur si une valeur non autorisée est spécifiée. (bêta) L’utilisation de ce champ nécessite que la porte de fonctionnalité AnyVolumeDataSource soit activée. KubernetesReference
ressources Les ressources représentent les ressources minimales dont le volume doit avoir. Si la fonctionnalité RecoverVolumeExpansionFailure est activée, les utilisateurs sont autorisés à spécifier les exigences de ressources inférieures à la valeur précédente, mais doivent toujours être supérieures à la capacité enregistrée dans le champ d’état de la revendication. Plus d’informations : https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources VolumeClaimResourceRequirements
sélecteur Requête d’étiquette sur les volumes à prendre en compte pour la liaison. volumeClaimSpecSelector
storageClassName Nom de storageClass requis par la revendication. Plus d’informations : https://kubernetes.io/docs/concepts/storage/persistent-volumes#class-1 corde
volumeMode volumeMode définit le type de volume requis par la revendication. La valeur du système de fichiers est implicite lorsqu’elle n’est pas incluse dans les spécifications de revendication. Il s’agit d’une fonctionnalité bêta. corde
volumeName VolumeName est la référence de liaison à persistentVolume qui sauvegarde cette revendication. corde

VolumeClaimSpecSelector

Nom Description Valeur
matchExpressions MatchExpressions est une liste des exigences de sélecteur d’étiquettes. Les exigences sont AND. VolumeClaimSpecSelectorMatchExpressions[]
matchLabels MatchLabels est une carte de paires {key,value}. Une seule {clé,value} dans le mappage matchLabels équivaut à un élément de matchExpressions, dont le champ de clé est « key », l’opérateur est « In », et le tableau de valeurs contient uniquement « value ». Les exigences sont AND. VolumeClaimSpecSelectorMatchLabels

VolumeClaimSpecSelectorMatchExpressions

Nom Description Valeur
clé clé est la clé d’étiquette à laquelle le sélecteur s’applique. chaîne (obligatoire)
opérateur l’opérateur représente la relation d’une clé à un ensemble de valeurs. Les opérateurs valides sont In, NotIn, Exists et DoesNotExist. 'DoesNotExist'
'Exists'
'In'
'NotIn' (obligatoire)
Valeurs les valeurs sont un tableau de valeurs de chaîne. Si l’opérateur est In ou NotIn, le tableau de valeurs doit être non vide. Si l’opérateur existe ou DoesNotExist, le tableau de valeurs doit être vide. Ce tableau est remplacé lors d’un correctif de fusion stratégique. string[]

VolumeClaimSpecSelectorMatchLabels

Nom Description Valeur

Définition de ressource Terraform (fournisseur AzAPI)

Le type de ressource instances/répartiteurs peut être déployé avec des opérations qui ciblent :

  • groupes de ressources

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.IoTOperations/instances/broker, ajoutez la terraform suivante à votre modèle.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.IoTOperations/instances/brokers@2024-11-01"
  name = "string"
  body = jsonencode({
    extendedLocation = {
      name = "string"
      type = "string"
    }
    properties = {
      advanced = {
        clients = {
          maxKeepAliveSeconds = int
          maxMessageExpirySeconds = int
          maxPacketSizeBytes = int
          maxReceiveMaximum = int
          maxSessionExpirySeconds = int
          subscriberQueueLimit = {
            length = int
            strategy = "string"
          }
        }
        encryptInternalTraffic = "string"
        internalCerts = {
          duration = "string"
          privateKey = {
            algorithm = "string"
            rotationPolicy = "string"
          }
          renewBefore = "string"
        }
      }
      cardinality = {
        backendChain = {
          partitions = int
          redundancyFactor = int
          workers = int
        }
        frontend = {
          replicas = int
          workers = int
        }
      }
      diagnostics = {
        logs = {
          level = "string"
        }
        metrics = {
          prometheusPort = int
        }
        selfCheck = {
          intervalSeconds = int
          mode = "string"
          timeoutSeconds = int
        }
        traces = {
          cacheSizeMegabytes = int
          mode = "string"
          selfTracing = {
            intervalSeconds = int
            mode = "string"
          }
          spanChannelCapacity = int
        }
      }
      diskBackedMessageBuffer = {
        ephemeralVolumeClaimSpec = {
          accessModes = [
            "string"
          ]
          dataSource = {
            apiGroup = "string"
            kind = "string"
            name = "string"
          }
          dataSourceRef = {
            apiGroup = "string"
            kind = "string"
            name = "string"
            namespace = "string"
          }
          resources = {
            limits = {
              {customized property} = "string"
            }
            requests = {
              {customized property} = "string"
            }
          }
          selector = {
            matchExpressions = [
              {
                key = "string"
                operator = "string"
                values = [
                  "string"
                ]
              }
            ]
            matchLabels = {
              {customized property} = "string"
            }
          }
          storageClassName = "string"
          volumeMode = "string"
          volumeName = "string"
        }
        maxSize = "string"
        persistentVolumeClaimSpec = {
          accessModes = [
            "string"
          ]
          dataSource = {
            apiGroup = "string"
            kind = "string"
            name = "string"
          }
          dataSourceRef = {
            apiGroup = "string"
            kind = "string"
            name = "string"
            namespace = "string"
          }
          resources = {
            limits = {
              {customized property} = "string"
            }
            requests = {
              {customized property} = "string"
            }
          }
          selector = {
            matchExpressions = [
              {
                key = "string"
                operator = "string"
                values = [
                  "string"
                ]
              }
            ]
            matchLabels = {
              {customized property} = "string"
            }
          }
          storageClassName = "string"
          volumeMode = "string"
          volumeName = "string"
        }
      }
      generateResourceLimits = {
        cpu = "string"
      }
      memoryProfile = "string"
    }
  })
}

Valeurs de propriété

AdvancedSettings

Nom Description Valeur
clients Configurations liées à tous les clients. clientConfig
encryptInternalTraffic Paramètre permettant d’activer ou de désactiver le chiffrement du trafic interne. 'Désactivé'
'Activé'
internalCerts Rotation des certificats et configuration de clé privée. CertManagerCertOptions

BackendChain

Nom Description Valeur
Partitions Nombre souhaité de partitions principales physiques. Int

Contraintes:
Valeur minimale = 1
Valeur maximale = 16 (obligatoire)
redondanceFactor Nombre souhaité de réplicas back-end (pods) dans une partition physique. Int

Contraintes:
Valeur minimale = 1
Valeur maximale = 5 (obligatoire)
travailleur Nombre de workers principaux logiques par réplica (pod). Int

Contraintes:
Valeur minimale = 1
Valeur maximale = 16

BrokerDiagnostics

Nom Description Valeur
Journaux Paramètres du journal de diagnostic pour la ressource. DiagnosticsLogs
métrique Paramètres des métriques de la ressource. Métriques
selfCheck Propriétés de vérification automatique. SelfCheck
Traces Propriétés de trace. traces

BrokerProperties

Nom Description Valeur
avancé Paramètres avancés du répartiteur. AdvancedSettings
cardinalité Détails de cardinalité du répartiteur. cardinalité
diagnostic Spec définit les identités souhaitées des paramètres de diagnostic Broker. BrokerDiagnostics
diskBackedMessageBuffer Paramètres de la mémoire tampon de message sauvegardée sur disque. DiskBackedMessageBuffer
generateResourceLimits Ce paramètre contrôle si les limites de ressources du processeur Kubernetes sont demandées. L’augmentation du nombre de réplicas ou de workers augmente proportionnellement la quantité de ressources processeur demandées. Si ce paramètre est activé et qu’il n’y a pas de ressources processeur insuffisantes, une erreur est émise. GenerateResourceLimits
memoryProfile Profil mémoire de Broker. 'High'
'Low'
'Medium'
'Tiny'

Cardinalité

Nom Description Valeur
backendChain Propriétés souhaitées du répartiteur principal BackendChain (obligatoire)
frontend Propriétés souhaitées du serveur frontal front-end (obligatoire)

CertManagerCertOptions

Nom Description Valeur
durée Durée de vie du certificat. Doit être spécifié à l’aide d’une heure de go. Format de durée (h m s). Par exemple, 240h pendant 240 heures et 45m pendant 45 minutes. chaîne (obligatoire)
privateKey Configuration de la clé privée de certificat. CertManagerPrivateKey (obligatoire)
renewBefore Quand commencer le renouvellement du certificat. Doit être spécifié à l’aide d’une heure de go. Format de durée (h m s). Par exemple, 240h pendant 240 heures et 45m pendant 45 minutes. chaîne (obligatoire)

CertManagerPrivateKey

Nom Description Valeur
algorithme algorithme pour la clé privée. 'Ec256'
'Ec384'
'Ec521'
'Ed25519'
'Rsa2048'
'Rsa4096'
'Rsa8192' (obligatoire)
rotationPolicy cert-manager private key rotationPolicy. 'Always'
'Never' (obligatoire)

ClientConfig

Nom Description Valeur
maxKeepAliveSeconds Limite supérieure de Keep Alive d’un client, en secondes. Int

Contraintes:
Valeur minimale = 0
Valeur maximale = 65535
maxMessageExpirySeconds Limite supérieure de l’intervalle d’expiration du message, en secondes. Int

Contraintes:
Valeur minimale = 1
Valeur maximale = 4294967295
maxPacketSizeBytes Taille maximale du message pour un paquet en octets. Int

Contraintes:
Valeur minimale = 1
Valeur maximale = 268435456
maxReceiveMaximum Limite supérieure de réception maximale qu’un client peut demander dans le paquet CONNECT. Int

Contraintes:
Valeur minimale = 1
Valeur maximale = 65535
maxSessionExpirySeconds Limite supérieure de l’intervalle d’expiration de session, en secondes. Int

Contraintes:
Valeur minimale = 1
Valeur maximale = 4294967295
subscriberQueueLimit Limite du nombre de messages mis en file d’attente pour un abonné. SubscriberQueueLimit

DiagnosticsLogs

Nom Description Valeur
niveau Niveau du journal. Exemples : « debug », « info », « warn », « error », « trace ». corde

DiskBackedMessageBuffer

Nom Description Valeur
ephemeralVolumeClaimSpec Utilisez le modèle de revendication de volume persistant spécifié pour monter un « volume éphémère générique » pour la mémoire tampon de message. Pour plus d’informations, consultez <https://kubernetes.io/docs/concepts/storage/ephemeral-volumes/#generic-ephemeral-volumes>. VolumeClaimSpec
maxSize Taille maximale de la mémoire tampon de message sur le disque. Si un modèle PVC est spécifié à l’aide de l’un des modèles éphémèresVolumeClaimSpec ou persistentVolumeClaimSpec, cette taille est utilisée comme demande et limite les tailles de ce modèle. Si ni éphémèreVolumeClaimSpec ni persistentVolumeClaimSpec ne sont spécifiés, un volume emptyDir est monté avec cette taille comme limite. Pour plus d’informations, consultez <https://kubernetes.io/docs/concepts/storage/volumes/#emptydir>. corde

Contraintes:
Modèle = ^[0-9]+[KMGTPE]$ (obligatoire)
persistentVolumeClaimSpec Utilisez le modèle de revendication de volume persistant spécifié pour monter un volume persistant pour la mémoire tampon de message. VolumeClaimSpec

ExtendedLocation

Nom Description Valeur
nom Nom de l’emplacement étendu. chaîne (obligatoire)
type Type de ExtendedLocation. 'CustomLocation' (obligatoire)

Frontend

Nom Description Valeur
Répliques Nombre souhaité d’instances frontales (pods). Int

Contraintes:
Valeur minimale = 1
Valeur maximale = 16 (obligatoire)
travailleur Nombre de workers frontend logiques par instance (pod). Int

Contraintes:
Valeur minimale = 1
Valeur maximale = 16

GenerateResourceLimits

Nom Description Valeur
CPU Bascule pour activer/désactiver les limites des ressources processeur. 'Désactivé'
'Activé'

KubernetesReference

Nom Description Valeur
apiGroup APIGroup est le groupe pour la ressource référencée. Si APIGroup n’est pas spécifié, le type spécifié doit se trouver dans le groupe d’API principal. Pour tous les autres types tiers, APIGroup est requis. corde
gentil Type de ressource référencée chaîne (obligatoire)
nom Le nom est le nom de la ressource référencée chaîne (obligatoire)
Namespace L’espace de noms est l’espace de noms de la ressource référencée. Ce champ est obligatoire lorsque la ressource a un espace de noms. corde

LocalKubernetesReference

Nom Description Valeur
apiGroup APIGroup est le groupe pour la ressource référencée. Si APIGroup n’est pas spécifié, le type spécifié doit se trouver dans le groupe d’API principal. Pour tous les autres types tiers, APIGroup est requis. corde
gentil Type de ressource référencée chaîne (obligatoire)
nom Le nom est le nom de la ressource référencée chaîne (obligatoire)

Métrique

Nom Description Valeur
prometheusPort Port prometheus pour exposer les métriques. Int

Contraintes:
Valeur minimale = 0
Valeur maximale = 65535

Microsoft.IoTOperations/instances/broker

Nom Description Valeur
extendedLocation Emplacement de périphérie de la ressource. ExtendedLocation (obligatoire)
nom Nom de la ressource corde

Contraintes:
Longueur minimale = 3
Longueur maximale = 63
Modèle = ^[a-z0-9][a-z0-9-]*[a-z0-9]$ (obligatoire)
parent_id ID de la ressource qui est le parent de cette ressource. ID de ressource de type : instances
Propriétés Propriétés spécifiques à la ressource pour cette ressource. BrokerProperties
type Type de ressource « Microsoft.IoTOperations/instances/brokers@2024-11-01 »

SelfCheck

Nom Description Valeur
intervalSeconds Intervalle de vérification automatique. Int

Contraintes:
Valeur minimale = 30
Valeur maximale = 300
mode Bascule pour activer/désactiver la vérification automatique. 'Désactivé'
'Activé'
timeoutSeconds Délai d’expiration de l’auto-vérification. Int

Contraintes:
Valeur minimale = 5
Valeur maximale = 120

AutoTracing

Nom Description Valeur
intervalSeconds Intervalle de suivi automatique. Int

Contraintes:
Valeur minimale = 1
Valeur maximale = 300
mode Bascule pour activer/désactiver le suivi automatique. 'Désactivé'
'Activé'

SubscriberQueueLimit

Nom Description Valeur
longueur Longueur maximale de la file d’attente avant que les messages ne commencent à être supprimés. Int

Contraintes:
Valeur minimale = 1
stratégie Stratégie à utiliser pour supprimer des messages de la file d’attente. 'DropOldest'
'None'

Traces

Nom Description Valeur
cacheSizeMegabytes Taille du cache en mégaoctets. Int

Contraintes:
Valeur minimale = 1
Valeur maximale = 128
mode Bascule pour activer/désactiver les traces. 'Désactivé'
'Activé'
autoTracing Propriétés de suivi automatique. SelfTracing
spanChannelCapacity Capacité du canal d’étendue. Int

Contraintes:
Valeur minimale = 1 000
Valeur maximale = 100000

VolumeClaimResourceRequirements

Nom Description Valeur
Limites Les limites décrivent la quantité maximale de ressources de calcul autorisées. Plus d’informations : https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ VolumeClaimResourceRequirementsLimits
Requêtes Les demandes décrivent la quantité minimale de ressources de calcul requises. Si les requêtes sont omises pour un conteneur, elle est définie par défaut sur Limites si elle est spécifiée explicitement, sinon à une valeur définie par l’implémentation. Plus d’informations : https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ VolumeClaimResourceRequirementsRequests

VolumeClaimResourceRequirementsLimits

Nom Description Valeur

VolumeClaimResourceRequirementsRequests

Nom Description Valeur

VolumeClaimSpec

Nom Description Valeur
accessModes AccessModes contient les modes d’accès souhaités dont le volume doit avoir. Plus d’informations : https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1 string[]
dataSource Ce champ peut être utilisé pour spécifier soit : * Un objet VolumeSnapshot existant (snapshot.storage.k8s.io/VolumeSnapshot) * Un PVC existant (PersistentVolumeClaim) Si le provisionneur ou un contrôleur externe peut prendre en charge la source de données spécifiée, il crée un volume basé sur le contenu de la source de données spécifiée. Si la porte de fonctionnalité AnyVolumeDataSource est activée, ce champ aura toujours le même contenu que le champ DataSourceRef. LocalKubernetesReference
dataSourceRef Spécifie l’objet à partir duquel remplir le volume avec des données, si un volume non vide est souhaité. Il peut s’agir d’un objet local à partir d’un groupe d’API non vide (objet non principal) ou d’un objet PersistentVolumeClaim. Lorsque ce champ est spécifié, la liaison de volume réussit uniquement si le type de l’objet spécifié correspond à un populateur de volume ou un provisionneur dynamique installé. Ce champ remplace les fonctionnalités du champ DataSource et, par conséquent, si les deux champs ne sont pas vides, ils doivent avoir la même valeur. Pour la compatibilité descendante, les deux champs (DataSource et DataSourceRef) sont définis automatiquement sur la même valeur si l’un d’eux est vide et que l’autre n’est pas vide. Il existe deux différences importantes entre DataSource et DataSourceRef : * Alors que DataSource autorise uniquement deux types d’objets spécifiques, DataSourceRef autorise n’importe quel objet non principal, ainsi que les objets PersistentVolumeClaim. * Alors que DataSource ignore les valeurs non autorisées (les supprimant), DataSourceRef conserve toutes les valeurs et génère une erreur si une valeur non autorisée est spécifiée. (bêta) L’utilisation de ce champ nécessite que la porte de fonctionnalité AnyVolumeDataSource soit activée. KubernetesReference
ressources Les ressources représentent les ressources minimales dont le volume doit avoir. Si la fonctionnalité RecoverVolumeExpansionFailure est activée, les utilisateurs sont autorisés à spécifier les exigences de ressources inférieures à la valeur précédente, mais doivent toujours être supérieures à la capacité enregistrée dans le champ d’état de la revendication. Plus d’informations : https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources VolumeClaimResourceRequirements
sélecteur Requête d’étiquette sur les volumes à prendre en compte pour la liaison. volumeClaimSpecSelector
storageClassName Nom de storageClass requis par la revendication. Plus d’informations : https://kubernetes.io/docs/concepts/storage/persistent-volumes#class-1 corde
volumeMode volumeMode définit le type de volume requis par la revendication. La valeur du système de fichiers est implicite lorsqu’elle n’est pas incluse dans les spécifications de revendication. Il s’agit d’une fonctionnalité bêta. corde
volumeName VolumeName est la référence de liaison à persistentVolume qui sauvegarde cette revendication. corde

VolumeClaimSpecSelector

Nom Description Valeur
matchExpressions MatchExpressions est une liste des exigences de sélecteur d’étiquettes. Les exigences sont AND. VolumeClaimSpecSelectorMatchExpressions[]
matchLabels MatchLabels est une carte de paires {key,value}. Une seule {clé,value} dans le mappage matchLabels équivaut à un élément de matchExpressions, dont le champ de clé est « key », l’opérateur est « In », et le tableau de valeurs contient uniquement « value ». Les exigences sont AND. VolumeClaimSpecSelectorMatchLabels

VolumeClaimSpecSelectorMatchExpressions

Nom Description Valeur
clé clé est la clé d’étiquette à laquelle le sélecteur s’applique. chaîne (obligatoire)
opérateur l’opérateur représente la relation d’une clé à un ensemble de valeurs. Les opérateurs valides sont In, NotIn, Exists et DoesNotExist. 'DoesNotExist'
'Exists'
'In'
'NotIn' (obligatoire)
Valeurs les valeurs sont un tableau de valeurs de chaîne. Si l’opérateur est In ou NotIn, le tableau de valeurs doit être non vide. Si l’opérateur existe ou DoesNotExist, le tableau de valeurs doit être vide. Ce tableau est remplacé lors d’un correctif de fusion stratégique. string[]

VolumeClaimSpecSelectorMatchLabels

Nom Description Valeur