Partager via


Alias Microsoft.Subscription 2021-10-01

Définition de ressource Bicep

Le type de ressource alias est une ressource d’extension, ce qui signifie que vous pouvez l’appliquer à une autre ressource.

Utilisez la scope propriété sur cette ressource pour définir l’étendue de cette ressource. Consultez Définir l’étendue des ressources d’extension dans Bicep.

Le type de ressource alias 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.

Remarques

Vous pouvez utiliser la Microsoft.Subscription/aliases ressource pour créer un abonnement, mais pas pour mettre à jour un abonnement existant. si vous tentez de mettre à jour les propriétés via le aliases type de ressource, ces modifications ne sont pas conservées.

Pour renommer un abonnement, utilisez l’opération Renommer.

Format des ressources

Pour créer une ressource Microsoft.Subscription/aliases, ajoutez le Bicep suivant à votre modèle.

resource symbolicname 'Microsoft.Subscription/aliases@2021-10-01' = {
  name: 'string'
  scope: tenant()
  properties: {
    additionalProperties: {
      managementGroupId: 'string'
      subscriptionOwnerId: 'string'
      subscriptionTenantId: 'string'
      tags: {}
    }
    billingScope: 'string'
    displayName: 'string'
    resellerId: 'string'
    subscriptionId: 'string'
    workload: 'string'
  }
}

Valeurs de propriétés

aliases

Nom Description Valeur
name Nom de la ressource chaîne (obligatoire)
scope Utilisez lors de la création d’une ressource d’extension dans une étendue différente de l’étendue du déploiement. Pour Bicep : tenant().
properties Put alias request properties. PutAliasRequestPropertiesOrSubscriptionAliasResponse...

PutAliasRequestPropertiesOrSubscriptionAliasResponse...

Nom Description Valeur
additionalProperties Placer des propriétés supplémentaires de demande d’alias. PutAliasRequestAdditionalProperties
billingScope Étendue de facturation de l’abonnement.
Pour CustomerLed et FieldLed - /billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}
Pour PartnerLed - /billingAccounts/{billingAccountName}/customers/{customerName}
Pour EA hérité - /billingAccounts/{billingAccountName}/enrollmentAccounts/{enrollmentAccountName}
string
displayName Nom convivial de l’abonnement. string
resellerId ID de revendeur string
subscriptionId Ce paramètre peut être utilisé pour créer un alias pour l’ID d’abonnement existant string
charge de travail Type de charge de travail de l’abonnement. Il peut s’agir de Production ou DevTest. 'DevTest'
'Production'

PutAliasRequestAdditionalProperties

Nom Description Valeur
managementGroupId ID du groupe d’administration pour l’abonnement. string
subscriptionOwnerId ID de propriétaire de l’abonnement string
subscriptionTenantId ID de locataire de l’abonnement string
tags Balises pour l’abonnement object

Modèles de démarrage rapide

Les modèles de démarrage rapide suivants déploient ce type de ressource.

Modèle Description
Créer un abonnement sous un compte EA

Déployer sur Azure
Ce modèle est un modèle de groupe d’administration qui va créer un abonnement via un alias. Il ne peut être utilisé que pour un mode de facturation Contrat Entreprise. La documentation officielle indique les modifications nécessaires pour d’autres types de comptes.
Créer un abonnement, resourceGroup et storageAccount

Déployer sur Azure
Ce modèle est un modèle de groupe d’administration qui crée un abonnement, un resourceGroup et un storageAccount dans le même modèle. Il ne peut être utilisé que pour un mode de facturation Contrat Entreprise. La documentation officielle indique les modifications nécessaires pour d’autres types de comptes.

Définition de ressources de modèle ARM

Le type de ressource alias est une ressource d’extension, ce qui signifie que vous pouvez l’appliquer à une autre ressource.

Utilisez la scope propriété sur cette ressource pour définir l’étendue de cette ressource. Consultez Définir l’étendue des ressources d’extension dans les modèles ARM.

Le type de ressource alias 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.

Remarques

Vous pouvez utiliser la Microsoft.Subscription/aliases ressource pour créer un abonnement, mais pas pour mettre à jour un abonnement existant. si vous tentez de mettre à jour les propriétés via le type de aliases ressource, ces modifications ne sont pas conservées.

Pour renommer un abonnement, utilisez l’opération Renommer.

Format des ressources

Pour créer une ressource Microsoft.Subscription/aliases, ajoutez le json suivant à votre modèle.

{
  "type": "Microsoft.Subscription/aliases",
  "apiVersion": "2021-10-01",
  "name": "string",
  "scope": "/",
  "properties": {
    "additionalProperties": {
      "managementGroupId": "string",
      "subscriptionOwnerId": "string",
      "subscriptionTenantId": "string",
      "tags": {}
    },
    "billingScope": "string",
    "displayName": "string",
    "resellerId": "string",
    "subscriptionId": "string",
    "workload": "string"
  }
}

Valeurs de propriétés

aliases

Nom Description Valeur
type Type de ressource 'Microsoft.Subscription/aliases'
apiVersion Version de l’API de ressource '2021-10-01'
name Nom de la ressource string (obligatoire)
scope Utilisez lors de la création d’une ressource d’extension dans une étendue différente de l’étendue de déploiement. Pour JSON : /.
properties Placer les propriétés de la demande d’alias. PutAliasRequestPropertiesOrSubscriptionAliasResponse...

PutAliasRequestPropertiesOrSubscriptionAliasResponse...

Nom Description Valeur
additionalProperties Placer des propriétés supplémentaires de demande d’alias. PutAliasRequestAdditionalProperties
billingScope Étendue de facturation de l’abonnement.
Pour CustomerLed et FieldLed - /billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}
Pour PartnerLed - /billingAccounts/{billingAccountName}/customers/{customerName}
Pour ea hérité - /billingAccounts/{billingAccountName}/enrollmentAccounts/{enrollmentAccountName}
string
displayName Nom convivial de l’abonnement. string
resellerId ID de revendeur string
subscriptionId Ce paramètre peut être utilisé pour créer un alias pour l’ID d’abonnement existant. string
charge de travail Type de charge de travail de l’abonnement. Il peut s’agir de Production ou DevTest. 'DevTest'
'Production'

PutAliasRequestAdditionalProperties

Nom Description Valeur
managementGroupId ID du groupe d’administration pour l’abonnement. string
subscriptionOwnerId ID de propriétaire de l’abonnement string
subscriptionTenantId ID de locataire de l’abonnement string
tags Étiquettes pour l’abonnement object

Modèles de démarrage rapide

Les modèles de démarrage rapide suivants déploient ce type de ressource.

Modèle Description
Créer un abonnement sous un compte EA

Déployer sur Azure
Ce modèle est un modèle de groupe d’administration qui crée un abonnement via un alias. Il peut être utilisé uniquement pour un mode de facturation Contrat Entreprise. La documentation officielle présente les modifications nécessaires pour d’autres types de comptes.
Créer un abonnement, resourceGroup et storageAccount

Déployer sur Azure
Ce modèle est un modèle de groupe d’administration qui crée un abonnement, un resourceGroup et un storageAccount dans le même modèle. Il peut être utilisé uniquement pour un mode de facturation Contrat Entreprise. La documentation officielle présente les modifications nécessaires pour d’autres types de comptes.

Définition de ressource Terraform (fournisseur AzAPI)

Le type de ressource alias est une ressource d’extension, ce qui signifie que vous pouvez l’appliquer à une autre ressource.

Utilisez la parent_id propriété sur cette ressource pour définir l’étendue de cette ressource.

Le type de ressource alias peut être déployé avec des opérations qui ciblent :

  • Locataires

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

Format des ressources

Pour créer une ressource Microsoft.Subscription/aliases, ajoutez le Terraform suivant à votre modèle.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Subscription/aliases@2021-10-01"
  name = "string"
  parent_id = "string"
  body = jsonencode({
    properties = {
      additionalProperties = {
        managementGroupId = "string"
        subscriptionOwnerId = "string"
        subscriptionTenantId = "string"
        tags = {}
      }
      billingScope = "string"
      displayName = "string"
      resellerId = "string"
      subscriptionId = "string"
      workload = "string"
    }
  })
}

Valeurs de propriétés

aliases

Nom Description Valeur
type Type de ressource « Microsoft.Subscription/aliases@2021-10-01 »
name Nom de la ressource chaîne (obligatoire)
parent_id ID de la ressource à laquelle appliquer cette ressource d’extension. chaîne (obligatoire)
properties Put alias request properties. PutAliasRequestPropertiesOrSubscriptionAliasResponse...

PutAliasRequestPropertiesOrSubscriptionAliasResponse...

Nom Description Valeur
additionalProperties Placer des propriétés supplémentaires de demande d’alias. PutAliasRequestAdditionalProperties
billingScope Étendue de facturation de l’abonnement.
Pour CustomerLed et FieldLed - /billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}
Pour PartnerLed - /billingAccounts/{billingAccountName}/customers/{customerName}
Pour EA hérité - /billingAccounts/{billingAccountName}/enrollmentAccounts/{enrollmentAccountName}
string
displayName Nom convivial de l’abonnement. string
resellerId ID de revendeur string
subscriptionId Ce paramètre peut être utilisé pour créer un alias pour l’ID d’abonnement existant string
charge de travail Type de charge de travail de l’abonnement. Il peut s’agir de Production ou DevTest. "DevTest"
"Production"

PutAliasRequestAdditionalProperties

Nom Description Valeur
managementGroupId ID du groupe d’administration pour l’abonnement. string
subscriptionOwnerId ID de propriétaire de l’abonnement string
subscriptionTenantId ID de locataire de l’abonnement string
tags Balises pour l’abonnement object