Udostępnij za pośrednictwem

Aliasy subskrypcji Microsoft.Subscription 2021-10-01

  • Artykuł

Definicja zasobu Bicep

Typ zasobu aliasów to zasób rozszerzenia, co oznacza, że można go zastosować do innego zasobu.

scope Użyj właściwości tego zasobu, aby ustawić zakres dla tego zasobu. Zobacz Ustawianie zakresu dla zasobów rozszerzeń w środowisku Bicep.

Typ zasobu aliasów można wdrożyć za pomocą operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennik zmian.

Uwagi

Za pomocą Microsoft.Subscription/aliases zasobu można utworzyć nową subskrypcję, ale nie zaktualizować istniejącej subskrypcji. Jeśli spróbujesz zaktualizować właściwości za pomocą aliases typu zasobu, te zmiany nie zostaną zachowane.

Aby zmienić nazwę subskrypcji, użyj operacji Zmień nazwę.

Format zasobu

Aby utworzyć zasób Microsoft.Subscription/aliases, dodaj następujący kod Bicep do szablonu.

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'
  }
}

Wartości właściwości

Aliasy

Nazwa Opis Wartość
name Nazwa zasobu ciąg (wymagany)
scope Użyj polecenia podczas tworzenia zasobu rozszerzenia w zakresie innym niż zakres wdrożenia. Dla Bicep: tenant().
properties Umieść właściwości żądania aliasu. PutAliasRequestPropertiesOrSubscriptionAliasResponse...

PutAliasRequestPropertiesOrSubscriptionAliasResponse...

Nazwa Opis Wartość
dodatkowewłaściwości Umieść alias żądaj dodatkowych właściwości. PutAliasRequestAdditionalProperties
billingScope Zakres rozliczeniowy subskrypcji.
Dla customerLed i FieldLed — /billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}
W przypadku elementu PartnerLed — /billingAccounts/{billingAccountName}/customers/{customerName}
W przypadku starszej wersji umowy EA — /billingAccounts/{billingAccountName}/enrollmentAccounts/{enrollmentAccountName}		 ciąg
displayName Przyjazna nazwa subskrypcji. ciąg
resellerId Identyfikator odsprzedawcy ciąg
subscriptionId Ten parametr może służyć do tworzenia aliasu dla istniejącego identyfikatora subskrypcji ciąg
workload Typ obciążenia subskrypcji. Może to być środowisko produkcyjne lub deweloperskie. "DevTest"
"Produkcja"

PutAliasRequestAdditionalProperties

Nazwa Opis Wartość
managementGroupId Identyfikator grupy zarządzania dla subskrypcji. ciąg
subscriptionOwnerId Identyfikator właściciela subskrypcji ciąg
subscriptionTenantId Identyfikator dzierżawy subskrypcji ciąg
tags Tagi subskrypcji object

Szablony szybkiego startu

Następujące szablony szybkiego startu wdrażają ten typ zasobu.

Template Opis
Tworzenie subskrypcji na koncie EA

Wdróż na platformie Azure		 Ten szablon jest szablonem grupy zarządzania, który utworzy subskrypcję za pośrednictwem aliasu. Można go używać tylko w trybie rozliczeniowym umowy Enterprise Agreement. Oficjalna dokumentacja zawiera modyfikacje wymagane dla innych typów kont.
Tworzenie subskrypcji, grupy zasobów i magazynuKonto

Wdróż na platformie Azure		 Ten szablon to szablon grupy zarządzania, który utworzy subskrypcję, grupę zasobów i konto magazynu w tym samym szablonie. Można go używać tylko w trybie rozliczeniowym umowy Enterprise Agreement. Oficjalna dokumentacja zawiera modyfikacje wymagane dla innych typów kont.

Definicja zasobu szablonu usługi ARM

Typ zasobu aliasów to zasób rozszerzenia, co oznacza, że można go zastosować do innego zasobu.

scope Użyj właściwości tego zasobu, aby ustawić zakres dla tego zasobu. Zobacz Ustawianie zakresu dla zasobów rozszerzeń w szablonach usługi ARM.

Typ zasobu aliasów można wdrożyć za pomocą operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennik zmian.

Uwagi

Za pomocą Microsoft.Subscription/aliases zasobu można utworzyć nową subskrypcję, ale nie zaktualizować istniejącej subskrypcji. Jeśli spróbujesz zaktualizować właściwości za pomocą aliases typu zasobu, te zmiany nie zostaną zachowane.

Aby zmienić nazwę subskrypcji, użyj operacji Zmień nazwę.

Format zasobu

Aby utworzyć zasób Microsoft.Subscription/aliases, dodaj następujący kod JSON do szablonu.

{
  "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"
  }
}

Wartości właściwości

Aliasy

Nazwa Opis Wartość
typ Typ zasobu "Microsoft.Subscription/aliases"
apiVersion Wersja interfejsu API zasobów '2021-10-01'
name Nazwa zasobu ciąg (wymagany)
scope Użyj polecenia podczas tworzenia zasobu rozszerzenia w zakresie innym niż zakres wdrożenia. W przypadku formatu JSON: /.
properties Umieść właściwości żądania aliasu. PutAliasRequestPropertiesOrSubscriptionAliasResponse...

PutAliasRequestPropertiesOrSubscriptionAliasResponse...

Nazwa Opis Wartość
additionalProperties Umieść alias żądania dodatkowych właściwości. PutAliasRequestAdditionalProperties
billingScope Zakres rozliczeniowy subskrypcji.
W przypadku customerLed i FieldLed — /billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}
W przypadku partnerled — /billingAccounts/{billingAccountName}/customers/{customerName}
W przypadku starszej wersji umowy EA — /billingAccounts/{billingAccountName}/enrollmentAccounts/{enrollmentAccountName}		 ciąg
displayName Przyjazna nazwa subskrypcji. ciąg
resellerId Identyfikator odsprzedawcy ciąg
subscriptionId Tego parametru można użyć do utworzenia aliasu dla istniejącego identyfikatora subskrypcji ciąg
workload Typ obciążenia subskrypcji. Może to być środowisko produkcyjne lub devtest. "DevTest"
"Produkcja"

PutAliasRequestAdditionalProperties

Nazwa Opis Wartość
managementGroupId Identyfikator grupy zarządzania dla subskrypcji. ciąg
subscriptionOwnerId Identyfikator właściciela subskrypcji ciąg
subscriptionTenantId Identyfikator dzierżawy subskrypcji ciąg
tags Tagi dla subskrypcji object

Szablony szybkiego startu

Następujące szablony szybkiego startu wdrażają ten typ zasobu.

Template Opis
Tworzenie subskrypcji na koncie EA

Wdróż na platformie Azure		 Ten szablon jest szablonem grupy zarządzania, który utworzy subskrypcję za pomocą aliasu. Można go używać tylko w trybie rozliczeniowym umowy Enterprise Agreement. Oficjalna dokumentacja zawiera modyfikacje wymagane dla innych typów kont.
Tworzenie subskrypcji, grupy zasobów i konta magazynu

Wdróż na platformie Azure		 Ten szablon jest szablonem grupy zarządzania, który utworzy subskrypcję, grupę zasobów i konto magazynu w tym samym szablonie. Można go używać tylko w trybie rozliczeniowym umowy Enterprise Agreement. Oficjalna dokumentacja zawiera modyfikacje wymagane dla innych typów kont.

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Typ zasobu aliasów to zasób rozszerzenia, co oznacza, że można zastosować go do innego zasobu.

parent_id Użyj właściwości w tym zasobie, aby ustawić zakres dla tego zasobu.

Typ zasobu aliasów można wdrożyć z operacjami docelowymi:

  • Dzierżawy

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennik zmian.

Format zasobu

Aby utworzyć zasób Microsoft.Subscription/aliases, dodaj następujący program Terraform do szablonu.

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"
    }
  })
}

Wartości właściwości

Aliasy

Nazwa Opis Wartość
typ Typ zasobu "Microsoft.Subscription/aliases@2021-10-01"
name Nazwa zasobu ciąg (wymagany)
parent_id Identyfikator zasobu, do który ma być stosowany ten zasób rozszerzenia. ciąg (wymagany)
properties Umieść właściwości żądania aliasu. PutAliasRequestPropertiesOrSubscriptionAliasResponse...

PutAliasRequestPropertiesOrSubscriptionAliasResponse...

Nazwa Opis Wartość
dodatkowewłaściwości Umieść alias żądaj dodatkowych właściwości. PutAliasRequestAdditionalProperties
billingScope Zakres rozliczeniowy subskrypcji.
Dla customerLed i FieldLed — /billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}
W przypadku elementu PartnerLed — /billingAccounts/{billingAccountName}/customers/{customerName}
W przypadku starszej wersji umowy EA — /billingAccounts/{billingAccountName}/enrollmentAccounts/{enrollmentAccountName}		 ciąg
displayName Przyjazna nazwa subskrypcji. ciąg
resellerId Identyfikator odsprzedawcy ciąg
subscriptionId Ten parametr może służyć do tworzenia aliasu dla istniejącego identyfikatora subskrypcji ciąg
workload Typ obciążenia subskrypcji. Może to być środowisko produkcyjne lub deweloperskie. "DevTest"
"Produkcja"

PutAliasRequestAdditionalProperties

Nazwa Opis Wartość
managementGroupId Identyfikator grupy zarządzania dla subskrypcji. ciąg
subscriptionOwnerId Identyfikator właściciela subskrypcji ciąg
subscriptionTenantId Identyfikator dzierżawy subskrypcji ciąg
tags Tagi subskrypcji object