2017-09-01

Definice prostředku Bicep

Typ prostředku batchAccounts/certificates je možné nasadit s operacemi, které cílí:

Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.

Příklady použití

Ukázky Bicep

Základní příklad nasazení certifikátu v účtu Azure Batch.

@secure()
@description('The base64-encoded certificate data')
param certificateData string
@description('The thumbprint of the certificate')
param certificateThumbprint string
param resourceName string = 'acctest0001'
param location string = 'westeurope'

resource batchAccount 'Microsoft.Batch/batchAccounts@2022-10-01' = {
  name: resourceName
  location: location
  properties: {
    encryption: {
      keySource: 'Microsoft.Batch'
    }
    poolAllocationMode: 'BatchService'
    publicNetworkAccess: 'Enabled'
  }
}

resource certificate 'Microsoft.Batch/batchAccounts/certificates@2022-10-01' = {
  name: 'SHA1-${certificateThumbprint}'
  parent: batchAccount
  properties: {
    data: certificateData
    format: 'Cer'
    thumbprint: certificateThumbprint
    thumbprintAlgorithm: 'sha1'
  }
}

Formát prostředku

Pokud chcete vytvořit prostředek Microsoft.Batch/batchAccounts/certificates, přidejte do šablony následující bicep.

resource symbolicname 'Microsoft.Batch/batchAccounts/certificates@2017-09-01' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    data: 'string'
    format: 'string'
    password: 'string'
    thumbprint: 'string'
    thumbprintAlgorithm: 'string'
  }
}

Hodnoty vlastností

Microsoft.Batch/batchAccounts/certificates

Jméno Popis Hodnota
Jméno Název prostředku řetězec

Omezení:
Minimální délka = 5
Maximální délka = 45
Model = ^[\w]+-[\w]+$ (povinné)
nadřazený objekt V bicep můžete zadat nadřazený prostředek pro podřízený prostředek. Tuto vlastnost je potřeba přidat pouze v případě, že je podřízený prostředek deklarován mimo nadřazený prostředek.

Další informace najdete v tématu Podřízený prostředek mimo nadřazený prostředek.
Symbolický název prostředku typu: batchAccounts
vlastnosti Vlastnosti přidružené k certifikátu. CertificateCreateOrUpdatePropertiesOrCertificateProperties

CertificateCreateOrUpdatePropertiesOrCertificateProperties

Jméno Popis Hodnota
data Maximální velikost je 10 kB. string (povinné)
formát Formát certifikátu – Pfx nebo Cer. Pokud tuto hodnotu vynecháte, výchozí hodnota je Pfx. 'Cer'
Pfx
heslo To se vyžaduje, pokud je formát certifikátu pfx a pokud je formát certifikátu cer, musí být vynechán. řetězec
kryptografický otisk Musí se shodovat s kryptografickým otiskem z názvu. řetězec
kryptografický otiskAlgorithm Musí se shodovat s první částí názvu certifikátu. V současné době se vyžaduje, aby byl SHA1. řetězec

Definice prostředku šablony ARM

Typ prostředku batchAccounts/certificates je možné nasadit s operacemi, které cílí:

Příklady použití

Šablony Azure pro rychlý start

Následující šablony Azure Pro rychlý start nasadit tento typ prostředku.

Šablona Popis
existující službu Azure Batch s pfx z keyvaultu

nasazení do Azure
Tato šablona demostrate pomocí služby Azure Batch s certifikátem hesla pfx z keyvaultu.

Formát prostředku

Pokud chcete vytvořit prostředek Microsoft.Batch/batchAccounts/certificates, přidejte do šablony následující JSON.

{
  "type": "Microsoft.Batch/batchAccounts/certificates",
  "apiVersion": "2017-09-01",
  "name": "string",
  "properties": {
    "data": "string",
    "format": "string",
    "password": "string",
    "thumbprint": "string",
    "thumbprintAlgorithm": "string"
  }
}

Hodnoty vlastností

Microsoft.Batch/batchAccounts/certificates

Jméno Popis Hodnota
Verze rozhraní apiVersion Verze rozhraní API '2017-09-01'
Jméno Název prostředku řetězec

Omezení:
Minimální délka = 5
Maximální délka = 45
Model = ^[\w]+-[\w]+$ (povinné)
vlastnosti Vlastnosti přidružené k certifikátu. CertificateCreateOrUpdatePropertiesOrCertificateProperties
typ Typ prostředku Microsoft.Batch/batchAccounts/certificates

CertificateCreateOrUpdatePropertiesOrCertificateProperties

Jméno Popis Hodnota
data Maximální velikost je 10 kB. string (povinné)
formát Formát certifikátu – Pfx nebo Cer. Pokud tuto hodnotu vynecháte, výchozí hodnota je Pfx. 'Cer'
Pfx
heslo To se vyžaduje, pokud je formát certifikátu pfx a pokud je formát certifikátu cer, musí být vynechán. řetězec
kryptografický otisk Musí se shodovat s kryptografickým otiskem z názvu. řetězec
kryptografický otiskAlgorithm Musí se shodovat s první částí názvu certifikátu. V současné době se vyžaduje, aby byl SHA1. řetězec

Definice prostředku Terraformu (poskytovatel AzAPI)

Typ prostředku batchAccounts/certificates je možné nasadit s operacemi, které cílí:

  • Skupiny zdrojů Pro seznam změněných vlastností v každé verzi API viz log změn.

Příklady použití

Ukázky Terraformu

Základní příklad nasazení certifikátu v účtu Azure Batch.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

variable "certificate_data" {
  type        = string
  description = "The base64-encoded certificate data"
  sensitive   = true
}

variable "certificate_thumbprint" {
  type        = string
  description = "The thumbprint of the certificate"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "batchAccount" {
  type      = "Microsoft.Batch/batchAccounts@2022-10-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      encryption = {
        keySource = "Microsoft.Batch"
      }
      poolAllocationMode  = "BatchService"
      publicNetworkAccess = "Enabled"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "certificate" {
  type      = "Microsoft.Batch/batchAccounts/certificates@2022-10-01"
  parent_id = azapi_resource.batchAccount.id
  name      = "SHA1-${var.certificate_thumbprint}"
  body = {
    properties = {
      data                = var.certificate_data
      format              = "Cer"
      thumbprint          = var.certificate_thumbprint
      thumbprintAlgorithm = "sha1"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

Formát prostředku

Pokud chcete vytvořit prostředek Microsoft.Batch/batchAccounts/certificates, přidejte do šablony následující Terraform.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Batch/batchAccounts/certificates@2017-09-01"
  name = "string"
  parent_id = "string"
  body = {
    properties = {
      data = "string"
      format = "string"
      password = "string"
      thumbprint = "string"
      thumbprintAlgorithm = "string"
    }
  }
}

Hodnoty vlastností

Microsoft.Batch/batchAccounts/certificates

Jméno Popis Hodnota
Jméno Název prostředku řetězec

Omezení:
Minimální délka = 5
Maximální délka = 45
Model = ^[\w]+-[\w]+$ (povinné)
ID rodiče ID prostředku, který je nadřazený pro tento prostředek. ID prostředku typu: batchAccounts
vlastnosti Vlastnosti přidružené k certifikátu. CertificateCreateOrUpdatePropertiesOrCertificateProperties
typ Typ prostředku Microsoft.Batch/batchAccounts/certificates@2017-09-01

CertificateCreateOrUpdatePropertiesOrCertificateProperties

Jméno Popis Hodnota
data Maximální velikost je 10 kB. string (povinné)
formát Formát certifikátu – Pfx nebo Cer. Pokud tuto hodnotu vynecháte, výchozí hodnota je Pfx. 'Cer'
Pfx
heslo To se vyžaduje, pokud je formát certifikátu pfx a pokud je formát certifikátu cer, musí být vynechán. řetězec
kryptografický otisk Musí se shodovat s kryptografickým otiskem z názvu. řetězec
kryptografický otiskAlgorithm Musí se shodovat s první částí názvu certifikátu. V současné době se vyžaduje, aby byl SHA1. řetězec