Definição de recurso do Bicep
O tipo de recurso cloudServices pode ser implantado com operações direcionadas:
Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.
Para criar um recurso Microsoft.Compute/cloudServices, adicione o Bicep a seguir ao seu modelo.
resource symbolicname 'Microsoft.Compute/cloudServices@2024-11-04' = {
location: 'string'
name: 'string'
properties: {
allowModelOverride: bool
configuration: 'string'
configurationUrl: 'string'
extensionProfile: {
extensions: [
{
name: 'string'
properties: {
autoUpgradeMinorVersion: bool
forceUpdateTag: 'string'
protectedSettings: any(...)
protectedSettingsFromKeyVault: {
secretUrl: 'string'
sourceVault: {
id: 'string'
}
}
publisher: 'string'
rolesAppliedTo: [
'string'
]
settings: any(...)
type: 'string'
typeHandlerVersion: 'string'
}
}
]
}
networkProfile: {
loadBalancerConfigurations: [
{
id: 'string'
name: 'string'
properties: {
frontendIpConfigurations: [
{
name: 'string'
properties: {
privateIPAddress: 'string'
publicIPAddress: {
id: 'string'
}
subnet: {
id: 'string'
}
}
}
]
}
}
]
slotType: 'string'
swappableCloudService: {
id: 'string'
}
}
osProfile: {
secrets: [
{
sourceVault: {
id: 'string'
}
vaultCertificates: [
{
certificateUrl: 'string'
isBootstrapCertificate: bool
}
]
}
]
}
packageUrl: 'string'
roleProfile: {
roles: [
{
name: 'string'
sku: {
capacity: int
name: 'string'
tier: 'string'
}
}
]
}
startCloudService: bool
upgradeMode: 'string'
}
tags: {
{customized property}: 'string'
}
zones: [
'string'
]
}
Valores de propriedade
Microsoft.Compute/cloudServices
| Nome |
Descrição |
Valor |
| local |
Local do recurso. |
cadeia de caracteres (obrigatório) |
| nome |
O nome do recurso |
cadeia de caracteres (obrigatório) |
| Propriedades |
Propriedades do serviço de nuvem |
CloudServiceProperties |
| Tags |
Marcas de recurso |
Dicionário de nomes e valores de marca. Consulte Marcas em modelos |
| Zonas |
Lista de zona de disponibilidade lógica do recurso. A lista deve conter apenas uma zona em que o serviço de nuvem deve ser provisionado. Esse campo é opcional. |
cadeia de caracteres[] |
CloudServiceExtensionProfile
| Nome |
Descrição |
Valor |
| Extensões |
Lista de extensões para o serviço de nuvem. |
de Extensão [] |
CloudServiceExtensionProperties
| Nome |
Descrição |
Valor |
| autoUpgradeMinorVersion |
Especifique explicitamente se a plataforma pode atualizar automaticamente typeHandlerVersion para versões secundárias mais altas quando elas estiverem disponíveis. |
Bool |
| forceUpdateTag |
Marque para forçar a aplicação das configurações públicas e protegidas fornecidas.
Alterar o valor da marca permite executar novamente a extensão sem alterar nenhuma das configurações públicas ou protegidas.
Se forceUpdateTag não for alterado, as atualizações para configurações públicas ou protegidas ainda serão aplicadas pelo manipulador.
Se nem forceUpdateTag nem nenhuma das configurações públicas ou protegidas forem alteradas, a extensão fluiria para a instância de função com o mesmo número de sequência e
cabe à implementação do manipulador executar novamente ou não |
cadeia |
| Configurações protegidas |
Configurações protegidas para a extensão que são criptografadas antes de serem enviadas para a instância de função. |
qualquer |
| protectedSettingsFromKeyVault |
Configurações protegidas para a extensão, referenciadas usando KeyVault que são criptografadas antes de serem enviadas para a instância de função. |
CloudServiceVaultAndSecretReference |
| desenvolvedor |
O nome do editor do manipulador de extensão. |
cadeia |
| rolesAppliedTo |
Lista opcional de funções para aplicar essa extensão. Se a propriedade não for especificada ou '*' for especificada, a extensão será aplicada a todas as funções no serviço de nuvem. |
cadeia de caracteres[] |
| configurações |
Configurações públicas para a extensão. Para extensões JSON, estas são as configurações JSON para a extensão. Para a Extensão XML (como RDP), esta é a configuração XML para a extensão. |
qualquer |
| tipo |
Especifica o tipo da extensão. |
cadeia |
| typeHandlerVersion |
Especifica a versão da extensão. Especifica a versão da extensão. Se esse elemento não for especificado ou um asterisco (*) for usado como o valor, a versão mais recente da extensão será usada. Se o valor for especificado com um número de versão principal e um asterisco como o número de versão secundária (X.), a versão secundária mais recente da versão principal especificada será selecionada. Se um número de versão principal e um número de versão secundária forem especificados (X.Y), a versão de extensão específica será selecionada. Se uma versão for especificada, uma atualização automática será executada na instância de função. |
cadeia |
CloudServiceNetworkProfile
| Nome |
Descrição |
Valor |
| loadBalancerConfigurations |
Lista de configurações do balanceador de carga. O serviço de nuvem pode ter até duas configurações de balanceador de carga, correspondentes a um Balanceador de Carga Público e um Balanceador de Carga Interno. |
Configuração do Balanceador de Carga |
| tipo de slot |
Tipo de slot para o serviço de nuvem.
Os valores possíveis são
Produção
Processo de preparo
Se não for especificado, o valor padrão será Produção. |
'Produção'
'Preparo' |
| swappableCloudService |
A referência de ID do serviço de nuvem que contém o IP de destino com o qual o serviço de nuvem da entidade pode executar uma troca. Essa propriedade não pode ser atualizada depois de definida. O serviço de nuvem permutável referenciado por essa ID deve estar presente, caso contrário, um erro será gerado. |
sub-recurso |
CloudServiceOsProfile
| Nome |
Descrição |
Valor |
| Segredos |
Especifica o conjunto de certificados que devem ser instalados nas instâncias de função. |
CloudServiceVaultSecretGroup [] |
Propriedades do Serviço de Nuvem
| Nome |
Descrição |
Valor |
| allowModelOverride |
(Opcional) Indica se as propriedades de sku de função (roleProfile.roles.sku) especificadas no modelo/modelo devem substituir a contagem de instâncias de função e o tamanho da VM especificados no .cscfg e .csdef, respectivamente.
O valor padrão é false. |
Bool |
| configuração |
Especifica a configuração do serviço XML (.cscfg) para o serviço de nuvem. |
cadeia |
| configurationUrl |
Especifica uma URL que se refere ao local da configuração do serviço no serviço Blob. A URL do pacote de serviço pode ser URI de SAS (Assinatura de Acesso Compartilhado) de qualquer conta de armazenamento.
Esta é uma propriedade somente gravação e não é retornada em chamadas GET. |
cadeia |
| extensionProfile |
Descreve um perfil de extensão do serviço de nuvem. |
CloudServiceExtensionProfile |
| perfil de rede |
Perfil de rede para o serviço de nuvem. |
CloudServiceNetworkProfile |
| osProfile |
Descreve o perfil do sistema operacional para o serviço de nuvem. |
CloudServiceOsProfile |
| URL do pacote |
Especifica uma URL que se refere ao local do pacote de serviço no serviço Blob. A URL do pacote de serviço pode ser URI de SAS (Assinatura de Acesso Compartilhado) de qualquer conta de armazenamento.
Esta é uma propriedade somente gravação e não é retornada em chamadas GET. |
cadeia |
| roleProfile |
Descreve o perfil de função para o serviço de nuvem. |
CloudServiceRoleProfile |
| startCloudService |
(Opcional) Indica se o serviço de nuvem deve ser iniciado imediatamente após ele ser criado. O valor padrão é true.
Se for falso, o modelo de serviço ainda será implantado, mas o código não será executado imediatamente. Em vez disso, o serviço é PoweredOff até você chamar Iniciar, momento em que o serviço será iniciado. Um serviço implantado ainda incorre em encargos, mesmo que seja desacionado. |
Bool |
| Modo de atualização |
Modo de atualização para o serviço de nuvem. As instâncias de função são alocadas para atualizar domínios quando o serviço é implantado. As atualizações podem ser iniciadas manualmente em cada domínio de atualização ou iniciadas automaticamente em todos os domínios de atualização.
Valores possíveis são
Automático
Manual
Simultânea
Se não for especificado, o valor padrão será Auto. Se definido como Manual, PUT UpdateDomain deverá ser chamado para aplicar a atualização. Se definido como Automático, a atualização será aplicada automaticamente a cada domínio de atualização em sequência. |
'Auto'
'Manual'
'Simultâneo' |
CloudServiceRoleProfile
CloudServiceRoleProfileProperties
| Nome |
Descrição |
Valor |
| nome |
Nome do recurso. |
cadeia |
| Sku |
Descreve o sku da função de serviço de nuvem. |
CloudServiceRoleSku |
CloudServiceRoleSku
| Nome |
Descrição |
Valor |
| capacidade |
Especifica o número de instâncias de função no serviço de nuvem. |
int |
| nome |
O nome do sku. OBSERVAÇÃO: se o novo SKU não tiver suporte no hardware em que o serviço de nuvem está atualmente, você precisará excluir e recriar o serviço de nuvem ou voltar para o sku antigo. |
cadeia |
| nível |
Especifica a camada do serviço de nuvem. Valores possíveis são
Padrão
Básico |
cadeia |
CloudServiceVaultAndSecretReference
| Nome |
Descrição |
Valor |
| secretUrl |
URL secreta que contém as configurações protegidas da extensão |
cadeia |
| sourceVault |
A ID de recurso do ARM do Key Vault |
sub-recurso |
CloudServiceVaultCertificate
| Nome |
Descrição |
Valor |
| certificateUrl |
Essa é a URL de um certificado que foi carregado no Key Vault como um segredo. |
cadeia |
| isBootstrapCertificate |
Sinalizador que indica se o certificado fornecido é um certificado de inicialização a ser usado pela Extensão do Key Vault para buscar os certificados restantes. |
Bool |
CloudServiceVaultSecretGroup
| Nome |
Descrição |
Valor |
| sourceVault |
A URL relativa do Key Vault que contém todos os certificados em VaultCertificates. |
sub-recurso |
| vaultCertificates |
A lista de referências do cofre de chaves no SourceVault que contêm certificados. |
CloudServiceVaultCertificate [] |
Extensão
| Nome |
Descrição |
Valor |
| nome |
O nome da extensão. |
cadeia |
| Propriedades |
Propriedades de extensão. |
CloudServiceExtensionProperties |
Configuração do LoadBalancer
| Nome |
Descrição |
Valor |
| id |
ID do recurso |
cadeia |
| nome |
O nome do balanceador de carga |
cadeia de caracteres (obrigatório) |
| Propriedades |
Propriedades da configuração do balanceador de carga. |
LoadBalancerConfigurationProperties (obrigatório) |
LoadBalancerConfigurationProperties
| Nome |
Descrição |
Valor |
| frontendIpConfigurations |
Especifica o IP de front-end a ser usado para o balanceador de carga. Há suporte apenas para o endereço IP de front-end IPv4. Cada configuração do balanceador de carga deve ter exatamente uma configuração de IP de front-end. |
LoadBalancerFrontendIpConfiguration[] (obrigatório) |
LoadBalancerFrontendIpConfiguration
| Nome |
Descrição |
Valor |
| nome |
O nome do recurso exclusivo dentro do conjunto de configurações de IP de front-end usado pelo balanceador de carga. Esse nome pode ser usado para acessar o recurso. |
cadeia de caracteres (obrigatório) |
| Propriedades |
Propriedades da configuração de ip de front-end do balanceador de carga. |
LoadBalancerFrontendIpConfigurationProperties (obrigatório) |
LoadBalancerFrontendIpConfigurationProperties
| Nome |
Descrição |
Valor |
| privateIPAddress |
O endereço IP privado da rede virtual da configuração de IP. |
cadeia |
| publicIPAddress |
A referência ao recurso de endereço ip público. |
sub-recurso |
| sub-rede |
A referência ao recurso de sub-rede de rede virtual. |
sub-recurso |
Sub-Recurso
| Nome |
Descrição |
Valor |
| id |
ID do recurso |
cadeia |
Definição de recurso de modelo do ARM
O tipo de recurso cloudServices pode ser implantado com operações direcionadas:
Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.
Para criar um recurso Microsoft.Compute/cloudServices, adicione o JSON a seguir ao seu modelo.
{
"type": "Microsoft.Compute/cloudServices",
"apiVersion": "2024-11-04",
"name": "string",
"location": "string",
"properties": {
"allowModelOverride": "bool",
"configuration": "string",
"configurationUrl": "string",
"extensionProfile": {
"extensions": [
{
"name": "string",
"properties": {
"autoUpgradeMinorVersion": "bool",
"forceUpdateTag": "string",
"protectedSettings": {},
"protectedSettingsFromKeyVault": {
"secretUrl": "string",
"sourceVault": {
"id": "string"
}
},
"publisher": "string",
"rolesAppliedTo": [ "string" ],
"settings": {},
"type": "string",
"typeHandlerVersion": "string"
}
}
]
},
"networkProfile": {
"loadBalancerConfigurations": [
{
"id": "string",
"name": "string",
"properties": {
"frontendIpConfigurations": [
{
"name": "string",
"properties": {
"privateIPAddress": "string",
"publicIPAddress": {
"id": "string"
},
"subnet": {
"id": "string"
}
}
}
]
}
}
],
"slotType": "string",
"swappableCloudService": {
"id": "string"
}
},
"osProfile": {
"secrets": [
{
"sourceVault": {
"id": "string"
},
"vaultCertificates": [
{
"certificateUrl": "string",
"isBootstrapCertificate": "bool"
}
]
}
]
},
"packageUrl": "string",
"roleProfile": {
"roles": [
{
"name": "string",
"sku": {
"capacity": "int",
"name": "string",
"tier": "string"
}
}
]
},
"startCloudService": "bool",
"upgradeMode": "string"
},
"tags": {
"{customized property}": "string"
},
"zones": [ "string" ]
}
Valores de propriedade
Microsoft.Compute/cloudServices
| Nome |
Descrição |
Valor |
| apiVersion |
A versão da API |
'2024-11-04' |
| local |
Local do recurso. |
cadeia de caracteres (obrigatório) |
| nome |
O nome do recurso |
cadeia de caracteres (obrigatório) |
| Propriedades |
Propriedades do serviço de nuvem |
CloudServiceProperties |
| Tags |
Marcas de recurso |
Dicionário de nomes e valores de marca. Consulte Marcas em modelos |
| tipo |
O tipo de recurso |
'Microsoft.Compute/cloudServices' |
| Zonas |
Lista de zona de disponibilidade lógica do recurso. A lista deve conter apenas uma zona em que o serviço de nuvem deve ser provisionado. Esse campo é opcional. |
cadeia de caracteres[] |
CloudServiceExtensionProfile
| Nome |
Descrição |
Valor |
| Extensões |
Lista de extensões para o serviço de nuvem. |
de Extensão [] |
CloudServiceExtensionProperties
| Nome |
Descrição |
Valor |
| autoUpgradeMinorVersion |
Especifique explicitamente se a plataforma pode atualizar automaticamente typeHandlerVersion para versões secundárias mais altas quando elas estiverem disponíveis. |
Bool |
| forceUpdateTag |
Marque para forçar a aplicação das configurações públicas e protegidas fornecidas.
Alterar o valor da marca permite executar novamente a extensão sem alterar nenhuma das configurações públicas ou protegidas.
Se forceUpdateTag não for alterado, as atualizações para configurações públicas ou protegidas ainda serão aplicadas pelo manipulador.
Se nem forceUpdateTag nem nenhuma das configurações públicas ou protegidas forem alteradas, a extensão fluiria para a instância de função com o mesmo número de sequência e
cabe à implementação do manipulador executar novamente ou não |
cadeia |
| Configurações protegidas |
Configurações protegidas para a extensão que são criptografadas antes de serem enviadas para a instância de função. |
qualquer |
| protectedSettingsFromKeyVault |
Configurações protegidas para a extensão, referenciadas usando KeyVault que são criptografadas antes de serem enviadas para a instância de função. |
CloudServiceVaultAndSecretReference |
| desenvolvedor |
O nome do editor do manipulador de extensão. |
cadeia |
| rolesAppliedTo |
Lista opcional de funções para aplicar essa extensão. Se a propriedade não for especificada ou '*' for especificada, a extensão será aplicada a todas as funções no serviço de nuvem. |
cadeia de caracteres[] |
| configurações |
Configurações públicas para a extensão. Para extensões JSON, estas são as configurações JSON para a extensão. Para a Extensão XML (como RDP), esta é a configuração XML para a extensão. |
qualquer |
| tipo |
Especifica o tipo da extensão. |
cadeia |
| typeHandlerVersion |
Especifica a versão da extensão. Especifica a versão da extensão. Se esse elemento não for especificado ou um asterisco (*) for usado como o valor, a versão mais recente da extensão será usada. Se o valor for especificado com um número de versão principal e um asterisco como o número de versão secundária (X.), a versão secundária mais recente da versão principal especificada será selecionada. Se um número de versão principal e um número de versão secundária forem especificados (X.Y), a versão de extensão específica será selecionada. Se uma versão for especificada, uma atualização automática será executada na instância de função. |
cadeia |
CloudServiceNetworkProfile
| Nome |
Descrição |
Valor |
| loadBalancerConfigurations |
Lista de configurações do balanceador de carga. O serviço de nuvem pode ter até duas configurações de balanceador de carga, correspondentes a um Balanceador de Carga Público e um Balanceador de Carga Interno. |
Configuração do Balanceador de Carga |
| tipo de slot |
Tipo de slot para o serviço de nuvem.
Os valores possíveis são
Produção
Processo de preparo
Se não for especificado, o valor padrão será Produção. |
'Produção'
'Preparo' |
| swappableCloudService |
A referência de ID do serviço de nuvem que contém o IP de destino com o qual o serviço de nuvem da entidade pode executar uma troca. Essa propriedade não pode ser atualizada depois de definida. O serviço de nuvem permutável referenciado por essa ID deve estar presente, caso contrário, um erro será gerado. |
sub-recurso |
CloudServiceOsProfile
| Nome |
Descrição |
Valor |
| Segredos |
Especifica o conjunto de certificados que devem ser instalados nas instâncias de função. |
CloudServiceVaultSecretGroup [] |
Propriedades do Serviço de Nuvem
| Nome |
Descrição |
Valor |
| allowModelOverride |
(Opcional) Indica se as propriedades de sku de função (roleProfile.roles.sku) especificadas no modelo/modelo devem substituir a contagem de instâncias de função e o tamanho da VM especificados no .cscfg e .csdef, respectivamente.
O valor padrão é false. |
Bool |
| configuração |
Especifica a configuração do serviço XML (.cscfg) para o serviço de nuvem. |
cadeia |
| configurationUrl |
Especifica uma URL que se refere ao local da configuração do serviço no serviço Blob. A URL do pacote de serviço pode ser URI de SAS (Assinatura de Acesso Compartilhado) de qualquer conta de armazenamento.
Esta é uma propriedade somente gravação e não é retornada em chamadas GET. |
cadeia |
| extensionProfile |
Descreve um perfil de extensão do serviço de nuvem. |
CloudServiceExtensionProfile |
| perfil de rede |
Perfil de rede para o serviço de nuvem. |
CloudServiceNetworkProfile |
| osProfile |
Descreve o perfil do sistema operacional para o serviço de nuvem. |
CloudServiceOsProfile |
| URL do pacote |
Especifica uma URL que se refere ao local do pacote de serviço no serviço Blob. A URL do pacote de serviço pode ser URI de SAS (Assinatura de Acesso Compartilhado) de qualquer conta de armazenamento.
Esta é uma propriedade somente gravação e não é retornada em chamadas GET. |
cadeia |
| roleProfile |
Descreve o perfil de função para o serviço de nuvem. |
CloudServiceRoleProfile |
| startCloudService |
(Opcional) Indica se o serviço de nuvem deve ser iniciado imediatamente após ele ser criado. O valor padrão é true.
Se for falso, o modelo de serviço ainda será implantado, mas o código não será executado imediatamente. Em vez disso, o serviço é PoweredOff até você chamar Iniciar, momento em que o serviço será iniciado. Um serviço implantado ainda incorre em encargos, mesmo que seja desacionado. |
Bool |
| Modo de atualização |
Modo de atualização para o serviço de nuvem. As instâncias de função são alocadas para atualizar domínios quando o serviço é implantado. As atualizações podem ser iniciadas manualmente em cada domínio de atualização ou iniciadas automaticamente em todos os domínios de atualização.
Valores possíveis são
Automático
Manual
Simultânea
Se não for especificado, o valor padrão será Auto. Se definido como Manual, PUT UpdateDomain deverá ser chamado para aplicar a atualização. Se definido como Automático, a atualização será aplicada automaticamente a cada domínio de atualização em sequência. |
'Auto'
'Manual'
'Simultâneo' |
CloudServiceRoleProfile
CloudServiceRoleProfileProperties
| Nome |
Descrição |
Valor |
| nome |
Nome do recurso. |
cadeia |
| Sku |
Descreve o sku da função de serviço de nuvem. |
CloudServiceRoleSku |
CloudServiceRoleSku
| Nome |
Descrição |
Valor |
| capacidade |
Especifica o número de instâncias de função no serviço de nuvem. |
int |
| nome |
O nome do sku. OBSERVAÇÃO: se o novo SKU não tiver suporte no hardware em que o serviço de nuvem está atualmente, você precisará excluir e recriar o serviço de nuvem ou voltar para o sku antigo. |
cadeia |
| nível |
Especifica a camada do serviço de nuvem. Valores possíveis são
Padrão
Básico |
cadeia |
CloudServiceVaultAndSecretReference
| Nome |
Descrição |
Valor |
| secretUrl |
URL secreta que contém as configurações protegidas da extensão |
cadeia |
| sourceVault |
A ID de recurso do ARM do Key Vault |
sub-recurso |
CloudServiceVaultCertificate
| Nome |
Descrição |
Valor |
| certificateUrl |
Essa é a URL de um certificado que foi carregado no Key Vault como um segredo. |
cadeia |
| isBootstrapCertificate |
Sinalizador que indica se o certificado fornecido é um certificado de inicialização a ser usado pela Extensão do Key Vault para buscar os certificados restantes. |
Bool |
CloudServiceVaultSecretGroup
| Nome |
Descrição |
Valor |
| sourceVault |
A URL relativa do Key Vault que contém todos os certificados em VaultCertificates. |
sub-recurso |
| vaultCertificates |
A lista de referências do cofre de chaves no SourceVault que contêm certificados. |
CloudServiceVaultCertificate [] |
Extensão
| Nome |
Descrição |
Valor |
| nome |
O nome da extensão. |
cadeia |
| Propriedades |
Propriedades de extensão. |
CloudServiceExtensionProperties |
Configuração do LoadBalancer
| Nome |
Descrição |
Valor |
| id |
ID do recurso |
cadeia |
| nome |
O nome do balanceador de carga |
cadeia de caracteres (obrigatório) |
| Propriedades |
Propriedades da configuração do balanceador de carga. |
LoadBalancerConfigurationProperties (obrigatório) |
LoadBalancerConfigurationProperties
| Nome |
Descrição |
Valor |
| frontendIpConfigurations |
Especifica o IP de front-end a ser usado para o balanceador de carga. Há suporte apenas para o endereço IP de front-end IPv4. Cada configuração do balanceador de carga deve ter exatamente uma configuração de IP de front-end. |
LoadBalancerFrontendIpConfiguration[] (obrigatório) |
LoadBalancerFrontendIpConfiguration
| Nome |
Descrição |
Valor |
| nome |
O nome do recurso exclusivo dentro do conjunto de configurações de IP de front-end usado pelo balanceador de carga. Esse nome pode ser usado para acessar o recurso. |
cadeia de caracteres (obrigatório) |
| Propriedades |
Propriedades da configuração de ip de front-end do balanceador de carga. |
LoadBalancerFrontendIpConfigurationProperties (obrigatório) |
LoadBalancerFrontendIpConfigurationProperties
| Nome |
Descrição |
Valor |
| privateIPAddress |
O endereço IP privado da rede virtual da configuração de IP. |
cadeia |
| publicIPAddress |
A referência ao recurso de endereço ip público. |
sub-recurso |
| sub-rede |
A referência ao recurso de sub-rede de rede virtual. |
sub-recurso |
Sub-Recurso
| Nome |
Descrição |
Valor |
| id |
ID do recurso |
cadeia |
Exemplos de uso
O tipo de recurso cloudServices pode ser implantado com operações direcionadas:
Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.
Para criar um recurso Microsoft.Compute/cloudServices, adicione o Terraform a seguir ao seu modelo.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Compute/cloudServices@2024-11-04"
name = "string"
parent_id = "string"
location = "string"
tags = {
{customized property} = "string"
}
body = {
properties = {
allowModelOverride = bool
configuration = "string"
configurationUrl = "string"
extensionProfile = {
extensions = [
{
name = "string"
properties = {
autoUpgradeMinorVersion = bool
forceUpdateTag = "string"
protectedSettings = ?
protectedSettingsFromKeyVault = {
secretUrl = "string"
sourceVault = {
id = "string"
}
}
publisher = "string"
rolesAppliedTo = [
"string"
]
settings = ?
type = "string"
typeHandlerVersion = "string"
}
}
]
}
networkProfile = {
loadBalancerConfigurations = [
{
id = "string"
name = "string"
properties = {
frontendIpConfigurations = [
{
name = "string"
properties = {
privateIPAddress = "string"
publicIPAddress = {
id = "string"
}
subnet = {
id = "string"
}
}
}
]
}
}
]
slotType = "string"
swappableCloudService = {
id = "string"
}
}
osProfile = {
secrets = [
{
sourceVault = {
id = "string"
}
vaultCertificates = [
{
certificateUrl = "string"
isBootstrapCertificate = bool
}
]
}
]
}
packageUrl = "string"
roleProfile = {
roles = [
{
name = "string"
sku = {
capacity = int
name = "string"
tier = "string"
}
}
]
}
startCloudService = bool
upgradeMode = "string"
}
zones = [
"string"
]
}
}
Valores de propriedade
Microsoft.Compute/cloudServices
| Nome |
Descrição |
Valor |
| local |
Local do recurso. |
cadeia de caracteres (obrigatório) |
| nome |
O nome do recurso |
cadeia de caracteres (obrigatório) |
| Propriedades |
Propriedades do serviço de nuvem |
CloudServiceProperties |
| Tags |
Marcas de recurso |
Dicionário de nomes e valores de marca. |
| tipo |
O tipo de recurso |
"Microsoft.Compute/cloudServices@2024-11-04" |
| Zonas |
Lista de zona de disponibilidade lógica do recurso. A lista deve conter apenas uma zona em que o serviço de nuvem deve ser provisionado. Esse campo é opcional. |
cadeia de caracteres[] |
CloudServiceExtensionProfile
| Nome |
Descrição |
Valor |
| Extensões |
Lista de extensões para o serviço de nuvem. |
de Extensão [] |
CloudServiceExtensionProperties
| Nome |
Descrição |
Valor |
| autoUpgradeMinorVersion |
Especifique explicitamente se a plataforma pode atualizar automaticamente typeHandlerVersion para versões secundárias mais altas quando elas estiverem disponíveis. |
Bool |
| forceUpdateTag |
Marque para forçar a aplicação das configurações públicas e protegidas fornecidas.
Alterar o valor da marca permite executar novamente a extensão sem alterar nenhuma das configurações públicas ou protegidas.
Se forceUpdateTag não for alterado, as atualizações para configurações públicas ou protegidas ainda serão aplicadas pelo manipulador.
Se nem forceUpdateTag nem nenhuma das configurações públicas ou protegidas forem alteradas, a extensão fluiria para a instância de função com o mesmo número de sequência e
cabe à implementação do manipulador executar novamente ou não |
cadeia |
| Configurações protegidas |
Configurações protegidas para a extensão que são criptografadas antes de serem enviadas para a instância de função. |
qualquer |
| protectedSettingsFromKeyVault |
Configurações protegidas para a extensão, referenciadas usando KeyVault que são criptografadas antes de serem enviadas para a instância de função. |
CloudServiceVaultAndSecretReference |
| desenvolvedor |
O nome do editor do manipulador de extensão. |
cadeia |
| rolesAppliedTo |
Lista opcional de funções para aplicar essa extensão. Se a propriedade não for especificada ou '*' for especificada, a extensão será aplicada a todas as funções no serviço de nuvem. |
cadeia de caracteres[] |
| configurações |
Configurações públicas para a extensão. Para extensões JSON, estas são as configurações JSON para a extensão. Para a Extensão XML (como RDP), esta é a configuração XML para a extensão. |
qualquer |
| tipo |
Especifica o tipo da extensão. |
cadeia |
| typeHandlerVersion |
Especifica a versão da extensão. Especifica a versão da extensão. Se esse elemento não for especificado ou um asterisco (*) for usado como o valor, a versão mais recente da extensão será usada. Se o valor for especificado com um número de versão principal e um asterisco como o número de versão secundária (X.), a versão secundária mais recente da versão principal especificada será selecionada. Se um número de versão principal e um número de versão secundária forem especificados (X.Y), a versão de extensão específica será selecionada. Se uma versão for especificada, uma atualização automática será executada na instância de função. |
cadeia |
CloudServiceNetworkProfile
| Nome |
Descrição |
Valor |
| loadBalancerConfigurations |
Lista de configurações do balanceador de carga. O serviço de nuvem pode ter até duas configurações de balanceador de carga, correspondentes a um Balanceador de Carga Público e um Balanceador de Carga Interno. |
Configuração do Balanceador de Carga |
| tipo de slot |
Tipo de slot para o serviço de nuvem.
Os valores possíveis são
Produção
Processo de preparo
Se não for especificado, o valor padrão será Produção. |
'Produção'
'Preparo' |
| swappableCloudService |
A referência de ID do serviço de nuvem que contém o IP de destino com o qual o serviço de nuvem da entidade pode executar uma troca. Essa propriedade não pode ser atualizada depois de definida. O serviço de nuvem permutável referenciado por essa ID deve estar presente, caso contrário, um erro será gerado. |
sub-recurso |
CloudServiceOsProfile
| Nome |
Descrição |
Valor |
| Segredos |
Especifica o conjunto de certificados que devem ser instalados nas instâncias de função. |
CloudServiceVaultSecretGroup [] |
Propriedades do Serviço de Nuvem
| Nome |
Descrição |
Valor |
| allowModelOverride |
(Opcional) Indica se as propriedades de sku de função (roleProfile.roles.sku) especificadas no modelo/modelo devem substituir a contagem de instâncias de função e o tamanho da VM especificados no .cscfg e .csdef, respectivamente.
O valor padrão é false. |
Bool |
| configuração |
Especifica a configuração do serviço XML (.cscfg) para o serviço de nuvem. |
cadeia |
| configurationUrl |
Especifica uma URL que se refere ao local da configuração do serviço no serviço Blob. A URL do pacote de serviço pode ser URI de SAS (Assinatura de Acesso Compartilhado) de qualquer conta de armazenamento.
Esta é uma propriedade somente gravação e não é retornada em chamadas GET. |
cadeia |
| extensionProfile |
Descreve um perfil de extensão do serviço de nuvem. |
CloudServiceExtensionProfile |
| perfil de rede |
Perfil de rede para o serviço de nuvem. |
CloudServiceNetworkProfile |
| osProfile |
Descreve o perfil do sistema operacional para o serviço de nuvem. |
CloudServiceOsProfile |
| URL do pacote |
Especifica uma URL que se refere ao local do pacote de serviço no serviço Blob. A URL do pacote de serviço pode ser URI de SAS (Assinatura de Acesso Compartilhado) de qualquer conta de armazenamento.
Esta é uma propriedade somente gravação e não é retornada em chamadas GET. |
cadeia |
| roleProfile |
Descreve o perfil de função para o serviço de nuvem. |
CloudServiceRoleProfile |
| startCloudService |
(Opcional) Indica se o serviço de nuvem deve ser iniciado imediatamente após ele ser criado. O valor padrão é true.
Se for falso, o modelo de serviço ainda será implantado, mas o código não será executado imediatamente. Em vez disso, o serviço é PoweredOff até você chamar Iniciar, momento em que o serviço será iniciado. Um serviço implantado ainda incorre em encargos, mesmo que seja desacionado. |
Bool |
| Modo de atualização |
Modo de atualização para o serviço de nuvem. As instâncias de função são alocadas para atualizar domínios quando o serviço é implantado. As atualizações podem ser iniciadas manualmente em cada domínio de atualização ou iniciadas automaticamente em todos os domínios de atualização.
Valores possíveis são
Automático
Manual
Simultânea
Se não for especificado, o valor padrão será Auto. Se definido como Manual, PUT UpdateDomain deverá ser chamado para aplicar a atualização. Se definido como Automático, a atualização será aplicada automaticamente a cada domínio de atualização em sequência. |
'Auto'
'Manual'
'Simultâneo' |
CloudServiceRoleProfile
CloudServiceRoleProfileProperties
| Nome |
Descrição |
Valor |
| nome |
Nome do recurso. |
cadeia |
| Sku |
Descreve o sku da função de serviço de nuvem. |
CloudServiceRoleSku |
CloudServiceRoleSku
| Nome |
Descrição |
Valor |
| capacidade |
Especifica o número de instâncias de função no serviço de nuvem. |
int |
| nome |
O nome do sku. OBSERVAÇÃO: se o novo SKU não tiver suporte no hardware em que o serviço de nuvem está atualmente, você precisará excluir e recriar o serviço de nuvem ou voltar para o sku antigo. |
cadeia |
| nível |
Especifica a camada do serviço de nuvem. Valores possíveis são
Padrão
Básico |
cadeia |
CloudServiceVaultAndSecretReference
| Nome |
Descrição |
Valor |
| secretUrl |
URL secreta que contém as configurações protegidas da extensão |
cadeia |
| sourceVault |
A ID de recurso do ARM do Key Vault |
sub-recurso |
CloudServiceVaultCertificate
| Nome |
Descrição |
Valor |
| certificateUrl |
Essa é a URL de um certificado que foi carregado no Key Vault como um segredo. |
cadeia |
| isBootstrapCertificate |
Sinalizador que indica se o certificado fornecido é um certificado de inicialização a ser usado pela Extensão do Key Vault para buscar os certificados restantes. |
Bool |
CloudServiceVaultSecretGroup
| Nome |
Descrição |
Valor |
| sourceVault |
A URL relativa do Key Vault que contém todos os certificados em VaultCertificates. |
sub-recurso |
| vaultCertificates |
A lista de referências do cofre de chaves no SourceVault que contêm certificados. |
CloudServiceVaultCertificate [] |
Extensão
| Nome |
Descrição |
Valor |
| nome |
O nome da extensão. |
cadeia |
| Propriedades |
Propriedades de extensão. |
CloudServiceExtensionProperties |
Configuração do LoadBalancer
| Nome |
Descrição |
Valor |
| id |
ID do recurso |
cadeia |
| nome |
O nome do balanceador de carga |
cadeia de caracteres (obrigatório) |
| Propriedades |
Propriedades da configuração do balanceador de carga. |
LoadBalancerConfigurationProperties (obrigatório) |
LoadBalancerConfigurationProperties
| Nome |
Descrição |
Valor |
| frontendIpConfigurations |
Especifica o IP de front-end a ser usado para o balanceador de carga. Há suporte apenas para o endereço IP de front-end IPv4. Cada configuração do balanceador de carga deve ter exatamente uma configuração de IP de front-end. |
LoadBalancerFrontendIpConfiguration[] (obrigatório) |
LoadBalancerFrontendIpConfiguration
| Nome |
Descrição |
Valor |
| nome |
O nome do recurso exclusivo dentro do conjunto de configurações de IP de front-end usado pelo balanceador de carga. Esse nome pode ser usado para acessar o recurso. |
cadeia de caracteres (obrigatório) |
| Propriedades |
Propriedades da configuração de ip de front-end do balanceador de carga. |
LoadBalancerFrontendIpConfigurationProperties (obrigatório) |
LoadBalancerFrontendIpConfigurationProperties
| Nome |
Descrição |
Valor |
| privateIPAddress |
O endereço IP privado da rede virtual da configuração de IP. |
cadeia |
| publicIPAddress |
A referência ao recurso de endereço ip público. |
sub-recurso |
| sub-rede |
A referência ao recurso de sub-rede de rede virtual. |
sub-recurso |
Sub-Recurso
| Nome |
Descrição |
Valor |
| id |
ID do recurso |
cadeia |