Partager via


Pools Microsoft.DevOpsInfrastructure 2023-10-30-preview

Définition de ressource Bicep

Le type de ressource pools 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.DevOpsInfrastructure/pools, ajoutez le bicep suivant à votre modèle.

resource symbolicname 'Microsoft.DevOpsInfrastructure/pools@2023-10-30-preview' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    agentProfile: {
      resourcePredictions: any(Azure.Bicep.Types.Concrete.AnyType)
      kind: 'string'
      // For remaining properties, see AgentProfile objects
    }
    devCenterProjectResourceId: 'string'
    fabricProfile: {
      kind: 'string'
      // For remaining properties, see FabricProfile objects
    }
    maximumConcurrency: int
    organizationProfile: {
      kind: 'string'
      // For remaining properties, see OrganizationProfile objects
    }
    provisioningState: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Objets AgentProfile

Définissez le type propriété pour spécifier le type d’objet.

Pour avec état, utilisez :

{
  kind: 'Stateful'
  maxAgentLifetime: 'string'
}

Pour sans état, utilisez :

{
  kind: 'Stateless'
}

Objets OrganizationProfile

Définissez le type propriété pour spécifier le type d’objet.

Pour AzureDevOps, utilisez :

{
  kind: 'AzureDevOps'
  organizations: [
    {
      parallelism: int
      projects: [
        'string'
      ]
      url: 'string'
    }
  ]
}

Objets FabricProfile

Définissez le type propriété pour spécifier le type d’objet.

Pour machines virtuelles, utilisez :

{
  images: [
    {
      aliases: [
        'string'
      ]
      buffer: 'string'
      resourceId: 'string'
    }
  ]
  kind: 'Vmss'
  networkProfile: {
    subnetId: 'string'
  }
  osProfile: {
    secretsManagementSettings: {
      certificateStoreLocation: 'string'
      keyExportable: bool
      observedCertificates: [
        'string'
      ]
    }
  }
  sku: {
    name: 'string'
    tier: 'string'
  }
}

Valeurs de propriété

AgentProfile

Nom Description Valeur
gentil Défini sur « Avec état » pour le type avec état . Défini sur « Sans état » pour le type StatelessAgentProfile. 'Avec état'
'Sans état' (obligatoire)
resourcePredictions Définit la mémoire tampon du pool. quelconque

AzureDevOpsOrganizationProfile

Nom Description Valeur
gentil Propriété Discriminator pour OrganizationProfile. 'AzureDevOps' (obligatoire)
Organisations La liste des organisations Azure DevOps dans laquelle le pool doit être présent. Organization[] (obligatoire)

DevOpsAzureSku

Nom Description Valeur
nom Nom de la référence SKU Azure des machines du pool. chaîne (obligatoire)
niveau Niveau de référence SKU Azure des machines du pool. corde

FabricProfile

Nom Description Valeur
gentil Défini sur « Vmss » pour le type VmssFabricProfile. 'Vmss' (obligatoire)

ManagedServiceIdentity

Nom Description Valeur
type Type d’identité de service managé (où les types SystemAssigned et UserAssigned sont autorisés). 'None'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned' (obligatoire)
userAssignedIdentities Ensemble d’identités affectées par l’utilisateur associées à la ressource. Les clés de dictionnaire userAssignedIdentities seront des ID de ressource ARM sous la forme : « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Les valeurs de dictionnaire peuvent être des objets vides ({}) dans les requêtes. UserAssignedIdentities

Microsoft.DevOpsInfrastructure/pools

Nom Description Valeur
identité Identités de service managées affectées à cette ressource. ManagedServiceIdentity
emplacement Emplacement géographique où réside la ressource chaîne (obligatoire)
nom Nom de la ressource corde

Contraintes:
Modèle = ^[a-z][a-z0-9]*$ (obligatoire)
Propriétés Propriétés spécifiques à la ressource pour cette ressource. PoolProperties
étiquettes Balises de ressource Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles

NetworkProfile

Nom Description Valeur
subnetId ID de sous-réseau sur lequel placer toutes les machines créées dans le pool. chaîne (obligatoire)

Organisation

Nom Description Valeur
parallélisme Combien de machines peuvent être créées au maximum dans cette organisation hors de la valeur maximaleConcurrency du pool. Int
Projets Liste facultative des projets dans lesquels le pool doit être créé. string[]
URL URL de l’organisation Azure DevOps dans laquelle le pool doit être créé. chaîne (obligatoire)

OrganizationProfile

Nom Description Valeur
gentil Défini sur « AzureDevOps » pour le type AzureDevOpsOrganizationProfile. 'AzureDevOps' (obligatoire)

OsProfile

Nom Description Valeur
secretsManagementSettings Paramètres de gestion des secrets des machines du pool. SecretsManagementSettings (obligatoire)

PoolImage

Nom Description Valeur
Alias Liste d’alias à référencer l’image par. string[]
tampon Pourcentage de la mémoire tampon à allouer à cette image. corde
resourceId ID de ressource de l’image. chaîne (obligatoire)

PoolProperties

Nom Description Valeur
agentProfile Définit la façon dont la machine sera gérée une fois qu’elle a exécuté un travail. AgentProfile (obligatoire)
devCenterProjectResourceId ID de ressource du projet DevCenter auquel appartient le pool. chaîne (obligatoire)
fabricProfile Définit le type d’infrastructure sur lequel l’agent s’exécute. FabricProfile (obligatoire)
maximumConcurrency Définit le nombre de ressources qui peuvent être créées à tout moment. Int

Contraintes:
Valeur minimale = 1
Valeur maximale = 1 0000 (obligatoire)
organizationProfile Définit l’organisation dans laquelle le pool sera utilisé. OrganizationProfile (obligatoire)
provisioningState État de l’opération actuelle. 'Accepté'
'Annulé'
'Suppression'
'Échec'
'Approvisionnement'
'Réussi'
'Mise à jour'

SecretsManagementSettings

Nom Description Valeur
certificateStoreLocation Où stocker des certificats sur l’ordinateur. corde
keyExportable Définit si la clé des certificats doit être exportable. bool (obligatoire)
observedCertificates Liste des certificats à installer sur tous les ordinateurs du pool. string[] (obligatoire)

Stateful

Nom Description Valeur
gentil Propriété de discrimination pour AgentProfile. 'Avec état' (obligatoire)
maxAgentLifetime Durée pendant laquelle les machines avec état doivent être conservées. Le maximum est d’une semaine. chaîne (obligatoire)

StatelessAgentProfile

Nom Description Valeur
gentil Propriété de discrimination pour AgentProfile. 'Sans état' (obligatoire)

TrackedResourceTags

Nom Description Valeur

UserAssignedIdentities

Nom Description Valeur

UserAssignedIdentity

Nom Description Valeur

VmssFabricProfile

Nom Description Valeur
Images Images de machine virtuelle des machines dans le pool. PoolImage[] (obligatoire)
gentil Propriété discriminator pour FabricProfile. 'Vmss' (obligatoire)
networkProfile Profil réseau des machines du pool. NetworkProfile
osProfile Profil du système d’exploitation des machines du pool. OsProfile
Sku Référence SKU Azure des machines du pool. DevOpsAzureSku (obligatoire)

Définition de ressource de modèle ARM

Le type de ressource pools 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.DevOpsInfrastructure/pools, ajoutez le code JSON suivant à votre modèle.

{
  "type": "Microsoft.DevOpsInfrastructure/pools",
  "apiVersion": "2023-10-30-preview",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "agentProfile": {
      "resourcePredictions": {},
      "kind": "string"
      // For remaining properties, see AgentProfile objects
    },
    "devCenterProjectResourceId": "string",
    "fabricProfile": {
      "kind": "string"
      // For remaining properties, see FabricProfile objects
    },
    "maximumConcurrency": "int",
    "organizationProfile": {
      "kind": "string"
      // For remaining properties, see OrganizationProfile objects
    },
    "provisioningState": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Objets AgentProfile

Définissez le type propriété pour spécifier le type d’objet.

Pour avec état, utilisez :

{
  "kind": "Stateful",
  "maxAgentLifetime": "string"
}

Pour sans état, utilisez :

{
  "kind": "Stateless"
}

Objets OrganizationProfile

Définissez le type propriété pour spécifier le type d’objet.

Pour AzureDevOps, utilisez :

{
  "kind": "AzureDevOps",
  "organizations": [
    {
      "parallelism": "int",
      "projects": [ "string" ],
      "url": "string"
    }
  ]
}

Objets FabricProfile

Définissez le type propriété pour spécifier le type d’objet.

Pour machines virtuelles, utilisez :

{
  "images": [
    {
      "aliases": [ "string" ],
      "buffer": "string",
      "resourceId": "string"
    }
  ],
  "kind": "Vmss",
  "networkProfile": {
    "subnetId": "string"
  },
  "osProfile": {
    "secretsManagementSettings": {
      "certificateStoreLocation": "string",
      "keyExportable": "bool",
      "observedCertificates": [ "string" ]
    }
  },
  "sku": {
    "name": "string",
    "tier": "string"
  }
}

Valeurs de propriété

AgentProfile

Nom Description Valeur
gentil Défini sur « Avec état » pour le type avec état . Défini sur « Sans état » pour le type StatelessAgentProfile. 'Avec état'
'Sans état' (obligatoire)
resourcePredictions Définit la mémoire tampon du pool. quelconque

AzureDevOpsOrganizationProfile

Nom Description Valeur
gentil Propriété Discriminator pour OrganizationProfile. 'AzureDevOps' (obligatoire)
Organisations La liste des organisations Azure DevOps dans laquelle le pool doit être présent. Organization[] (obligatoire)

DevOpsAzureSku

Nom Description Valeur
nom Nom de la référence SKU Azure des machines du pool. chaîne (obligatoire)
niveau Niveau de référence SKU Azure des machines du pool. corde

FabricProfile

Nom Description Valeur
gentil Défini sur « Vmss » pour le type VmssFabricProfile. 'Vmss' (obligatoire)

ManagedServiceIdentity

Nom Description Valeur
type Type d’identité de service managé (où les types SystemAssigned et UserAssigned sont autorisés). 'None'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned' (obligatoire)
userAssignedIdentities Ensemble d’identités affectées par l’utilisateur associées à la ressource. Les clés de dictionnaire userAssignedIdentities seront des ID de ressource ARM sous la forme : « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Les valeurs de dictionnaire peuvent être des objets vides ({}) dans les requêtes. UserAssignedIdentities

Microsoft.DevOpsInfrastructure/pools

Nom Description Valeur
apiVersion Version de l’API '2023-10-30-preview'
identité Identités de service managées affectées à cette ressource. ManagedServiceIdentity
emplacement Emplacement géographique où réside la ressource chaîne (obligatoire)
nom Nom de la ressource corde

Contraintes:
Modèle = ^[a-z][a-z0-9]*$ (obligatoire)
Propriétés Propriétés spécifiques à la ressource pour cette ressource. PoolProperties
étiquettes Balises de ressource Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles
type Type de ressource 'Microsoft.DevOpsInfrastructure/pools'

NetworkProfile

Nom Description Valeur
subnetId ID de sous-réseau sur lequel placer toutes les machines créées dans le pool. chaîne (obligatoire)

Organisation

Nom Description Valeur
parallélisme Combien de machines peuvent être créées au maximum dans cette organisation hors de la valeur maximaleConcurrency du pool. Int
Projets Liste facultative des projets dans lesquels le pool doit être créé. string[]
URL URL de l’organisation Azure DevOps dans laquelle le pool doit être créé. chaîne (obligatoire)

OrganizationProfile

Nom Description Valeur
gentil Défini sur « AzureDevOps » pour le type AzureDevOpsOrganizationProfile. 'AzureDevOps' (obligatoire)

OsProfile

Nom Description Valeur
secretsManagementSettings Paramètres de gestion des secrets des machines du pool. SecretsManagementSettings (obligatoire)

PoolImage

Nom Description Valeur
Alias Liste d’alias à référencer l’image par. string[]
tampon Pourcentage de la mémoire tampon à allouer à cette image. corde
resourceId ID de ressource de l’image. chaîne (obligatoire)

PoolProperties

Nom Description Valeur
agentProfile Définit la façon dont la machine sera gérée une fois qu’elle a exécuté un travail. AgentProfile (obligatoire)
devCenterProjectResourceId ID de ressource du projet DevCenter auquel appartient le pool. chaîne (obligatoire)
fabricProfile Définit le type d’infrastructure sur lequel l’agent s’exécute. FabricProfile (obligatoire)
maximumConcurrency Définit le nombre de ressources qui peuvent être créées à tout moment. Int

Contraintes:
Valeur minimale = 1
Valeur maximale = 1 0000 (obligatoire)
organizationProfile Définit l’organisation dans laquelle le pool sera utilisé. OrganizationProfile (obligatoire)
provisioningState État de l’opération actuelle. 'Accepté'
'Annulé'
'Suppression'
'Échec'
'Approvisionnement'
'Réussi'
'Mise à jour'

SecretsManagementSettings

Nom Description Valeur
certificateStoreLocation Où stocker des certificats sur l’ordinateur. corde
keyExportable Définit si la clé des certificats doit être exportable. bool (obligatoire)
observedCertificates Liste des certificats à installer sur tous les ordinateurs du pool. string[] (obligatoire)

Stateful

Nom Description Valeur
gentil Propriété de discrimination pour AgentProfile. 'Avec état' (obligatoire)
maxAgentLifetime Durée pendant laquelle les machines avec état doivent être conservées. Le maximum est d’une semaine. chaîne (obligatoire)

StatelessAgentProfile

Nom Description Valeur
gentil Propriété de discrimination pour AgentProfile. 'Sans état' (obligatoire)

TrackedResourceTags

Nom Description Valeur

UserAssignedIdentities

Nom Description Valeur

UserAssignedIdentity

Nom Description Valeur

VmssFabricProfile

Nom Description Valeur
Images Images de machine virtuelle des machines dans le pool. PoolImage[] (obligatoire)
gentil Propriété discriminator pour FabricProfile. 'Vmss' (obligatoire)
networkProfile Profil réseau des machines du pool. NetworkProfile
osProfile Profil du système d’exploitation des machines du pool. OsProfile
Sku Référence SKU Azure des machines du pool. DevOpsAzureSku (obligatoire)

Définition de ressource Terraform (fournisseur AzAPI)

Le type de ressource pools 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.DevOpsInfrastructure/pools, ajoutez terraform suivant à votre modèle.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DevOpsInfrastructure/pools@2023-10-30-preview"
  name = "string"
  identity = {
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
      }
    }
  }
  location = "string"
  body = jsonencode({
    properties = {
      agentProfile = {
        resourcePredictions = ?
        kind = "string"
        // For remaining properties, see AgentProfile objects
      }
      devCenterProjectResourceId = "string"
      fabricProfile = {
        kind = "string"
        // For remaining properties, see FabricProfile objects
      }
      maximumConcurrency = int
      organizationProfile = {
        kind = "string"
        // For remaining properties, see OrganizationProfile objects
      }
      provisioningState = "string"
    }
  })
  tags = {
    {customized property} = "string"
  }
}

Objets AgentProfile

Définissez le type propriété pour spécifier le type d’objet.

Pour avec état, utilisez :

{
  kind = "Stateful"
  maxAgentLifetime = "string"
}

Pour sans état, utilisez :

{
  kind = "Stateless"
}

Objets OrganizationProfile

Définissez le type propriété pour spécifier le type d’objet.

Pour AzureDevOps, utilisez :

{
  kind = "AzureDevOps"
  organizations = [
    {
      parallelism = int
      projects = [
        "string"
      ]
      url = "string"
    }
  ]
}

Objets FabricProfile

Définissez le type propriété pour spécifier le type d’objet.

Pour machines virtuelles, utilisez :

{
  images = [
    {
      aliases = [
        "string"
      ]
      buffer = "string"
      resourceId = "string"
    }
  ]
  kind = "Vmss"
  networkProfile = {
    subnetId = "string"
  }
  osProfile = {
    secretsManagementSettings = {
      certificateStoreLocation = "string"
      keyExportable = bool
      observedCertificates = [
        "string"
      ]
    }
  }
  sku = {
    name = "string"
    tier = "string"
  }
}

Valeurs de propriété

AgentProfile

Nom Description Valeur
gentil Défini sur « Avec état » pour le type avec état . Défini sur « Sans état » pour le type StatelessAgentProfile. 'Avec état'
'Sans état' (obligatoire)
resourcePredictions Définit la mémoire tampon du pool. quelconque

AzureDevOpsOrganizationProfile

Nom Description Valeur
gentil Propriété Discriminator pour OrganizationProfile. 'AzureDevOps' (obligatoire)
Organisations La liste des organisations Azure DevOps dans laquelle le pool doit être présent. Organization[] (obligatoire)

DevOpsAzureSku

Nom Description Valeur
nom Nom de la référence SKU Azure des machines du pool. chaîne (obligatoire)
niveau Niveau de référence SKU Azure des machines du pool. corde

FabricProfile

Nom Description Valeur
gentil Défini sur « Vmss » pour le type VmssFabricProfile. 'Vmss' (obligatoire)

ManagedServiceIdentity

Nom Description Valeur
type Type d’identité de service managé (où les types SystemAssigned et UserAssigned sont autorisés). 'None'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned' (obligatoire)
userAssignedIdentities Ensemble d’identités affectées par l’utilisateur associées à la ressource. Les clés de dictionnaire userAssignedIdentities seront des ID de ressource ARM sous la forme : « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Les valeurs de dictionnaire peuvent être des objets vides ({}) dans les requêtes. UserAssignedIdentities

Microsoft.DevOpsInfrastructure/pools

Nom Description Valeur
identité Identités de service managées affectées à cette ressource. ManagedServiceIdentity
emplacement Emplacement géographique où réside la ressource chaîne (obligatoire)
nom Nom de la ressource corde

Contraintes:
Modèle = ^[a-z][a-z0-9]*$ (obligatoire)
Propriétés Propriétés spécifiques à la ressource pour cette ressource. PoolProperties
étiquettes Balises de ressource Dictionnaire de noms et de valeurs d’étiquettes.
type Type de ressource « Microsoft.DevOpsInfrastructure/pools@2023-10-30-preview »

NetworkProfile

Nom Description Valeur
subnetId ID de sous-réseau sur lequel placer toutes les machines créées dans le pool. chaîne (obligatoire)

Organisation

Nom Description Valeur
parallélisme Combien de machines peuvent être créées au maximum dans cette organisation hors de la valeur maximaleConcurrency du pool. Int
Projets Liste facultative des projets dans lesquels le pool doit être créé. string[]
URL URL de l’organisation Azure DevOps dans laquelle le pool doit être créé. chaîne (obligatoire)

OrganizationProfile

Nom Description Valeur
gentil Défini sur « AzureDevOps » pour le type AzureDevOpsOrganizationProfile. 'AzureDevOps' (obligatoire)

OsProfile

Nom Description Valeur
secretsManagementSettings Paramètres de gestion des secrets des machines du pool. SecretsManagementSettings (obligatoire)

PoolImage

Nom Description Valeur
Alias Liste d’alias à référencer l’image par. string[]
tampon Pourcentage de la mémoire tampon à allouer à cette image. corde
resourceId ID de ressource de l’image. chaîne (obligatoire)

PoolProperties

Nom Description Valeur
agentProfile Définit la façon dont la machine sera gérée une fois qu’elle a exécuté un travail. AgentProfile (obligatoire)
devCenterProjectResourceId ID de ressource du projet DevCenter auquel appartient le pool. chaîne (obligatoire)
fabricProfile Définit le type d’infrastructure sur lequel l’agent s’exécute. FabricProfile (obligatoire)
maximumConcurrency Définit le nombre de ressources qui peuvent être créées à tout moment. Int

Contraintes:
Valeur minimale = 1
Valeur maximale = 1 0000 (obligatoire)
organizationProfile Définit l’organisation dans laquelle le pool sera utilisé. OrganizationProfile (obligatoire)
provisioningState État de l’opération actuelle. 'Accepté'
'Annulé'
'Suppression'
'Échec'
'Approvisionnement'
'Réussi'
'Mise à jour'

SecretsManagementSettings

Nom Description Valeur
certificateStoreLocation Où stocker des certificats sur l’ordinateur. corde
keyExportable Définit si la clé des certificats doit être exportable. bool (obligatoire)
observedCertificates Liste des certificats à installer sur tous les ordinateurs du pool. string[] (obligatoire)

Stateful

Nom Description Valeur
gentil Propriété de discrimination pour AgentProfile. 'Avec état' (obligatoire)
maxAgentLifetime Durée pendant laquelle les machines avec état doivent être conservées. Le maximum est d’une semaine. chaîne (obligatoire)

StatelessAgentProfile

Nom Description Valeur
gentil Propriété de discrimination pour AgentProfile. 'Sans état' (obligatoire)

TrackedResourceTags

Nom Description Valeur

UserAssignedIdentities

Nom Description Valeur

UserAssignedIdentity

Nom Description Valeur

VmssFabricProfile

Nom Description Valeur
Images Images de machine virtuelle des machines dans le pool. PoolImage[] (obligatoire)
gentil Propriété discriminator pour FabricProfile. 'Vmss' (obligatoire)
networkProfile Profil réseau des machines du pool. NetworkProfile
osProfile Profil du système d’exploitation des machines du pool. OsProfile
Sku Référence SKU Azure des machines du pool. DevOpsAzureSku (obligatoire)