Microsoft.Compute cloudServices 2022-09-04
Definição de recurso do Bicep
O tipo de recurso cloudServices pode ser implantado com operações direcionadas:
- Grupos de recursos – Consulte comandos de implantação do grupo de recursos
Para obter uma lista das propriedades alteradas em cada versão da API, consulte log de alterações.
Formato de recurso
Para criar um recurso Microsoft.Compute/cloudServices, adicione o Bicep a seguir ao modelo.
resource symbolicname 'Microsoft.Compute/cloudServices@2022-09-04' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
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'
}
]
}
]
}
packageUrl: 'string'
roleProfile: {
roles: [
{
name: 'string'
sku: {
capacity: int
name: 'string'
tier: 'string'
}
}
]
}
startCloudService: bool
upgradeMode: 'string'
}
systemData: {}
zones: [
'string'
]
}
Valores de propriedade
cloudServices
| Nome | Descrição | Valor |
|---|---|---|
| name | O nome do recurso | cadeia de caracteres (obrigatório) Limite de caracteres: 1 a 15 Caracteres válidos: Não é possível usar espaços, caracteres de controle ou estes caracteres: ~ ! @ # $ % ^ & * ( ) = + _ [ ] { } \ | ; : . ' " , < > / ?Não pode começar com sublinhado. Não pode terminar com ponto ou hífen. |
| local | Local do recurso. | cadeia de caracteres (obrigatório) |
| marcas | Marcas de recurso. | Dicionário de nomes e valores de marcas. Confira Marcas em modelos |
| properties | Propriedades do serviço de nuvem | CloudServiceProperties |
| systemData | Os metadados do sistema relacionados a esse recurso. | SystemData |
| zonas | Lista de zonas 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. | string[] |
CloudServiceProperties
| 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. | string |
| 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 o URI de SAS (Assinatura de Acesso Compartilhado) de qualquer conta de armazenamento. Essa é uma propriedade somente gravação e não é retornada em chamadas GET. |
string |
| extensionProfile | Descreve um perfil de extensão de serviço de nuvem. | CloudServiceExtensionProfile |
| networkProfile | Perfil de rede para o serviço de nuvem. | CloudServiceNetworkProfile |
| osProfile | Descreve o perfil do sistema operacional para o serviço de nuvem. | CloudServiceOsProfile |
| packageUrl | Especifica uma URL que faz referência ao local do pacote de serviço no serviço Blob. A URL do pacote de serviço pode ser o URI de SAS (Assinatura de Acesso Compartilhado) de qualquer conta de armazenamento. Essa é uma propriedade somente gravação e não é retornada em chamadas GET. |
string |
| 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 sua criação. O valor padrão é true.Se for false, 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é que você chame Start, momento em que o serviço será iniciado. Um serviço implantado ainda incorre em encargos, mesmo que seja desligado. |
bool |
| upgradeMode | 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 ser iniciadas automaticamente em todos os domínios da atualização. Os valores possíveis são Auto 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' |
CloudServiceExtensionProfile
| Nome | Descrição | Valor |
|---|---|---|
| extensions | Lista de extensões para o serviço de nuvem. | Extension[] |
Extensão
| Nome | Descrição | Valor |
|---|---|---|
| name | O nome da extensão. | string |
| properties | Propriedades da extensão. | CloudServiceExtensionProperties |
CloudServiceExtensionProperties
| Nome | Descrição | Valor |
|---|---|---|
| autoUpgradeMinorVersion | Especifique explicitamente se a plataforma pode atualizar automaticamente o 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 fluirá 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 |
string |
| protectedSettings | Configurações protegidas para a extensão que são criptografadas antes de serem enviadas para a instância de função. | Para o Bicep, você pode usar a função any(). |
| 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 |
| publicador | O nome do editor do manipulador de extensão. | string |
| 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. | string[] |
| 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), essa é a configuração XML para a extensão. | Para o Bicep, você pode usar a função any(). |
| tipo | Especifica o tipo da extensão. | string |
| 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 da 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. | string |
CloudServiceVaultAndSecretReference
| Nome | Descrição | Valor |
|---|---|---|
| secretUrl | URL secreta que contém as configurações protegidas da extensão | string |
| sourceVault | A ID do recurso arm do Key Vault | SubResource |
SubResource
| Nome | Descrição | Valor |
|---|---|---|
| id | ID do recurso | string |
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 uma Load Balancer Pública e a uma Load Balancer Interna. | LoadBalancerConfiguration[] |
| slotType | Tipo de slot para o serviço de nuvem. Os valores possíveis são: Produção 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 de assunto 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. | SubResource |
LoadBalancerConfiguration
| Nome | Descrição | Valor |
|---|---|---|
| id | ID do recurso | string |
| name | O nome do balanceador de carga | cadeia de caracteres (obrigatório) |
| properties | 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 |
|---|---|---|
| name | O nome do recurso exclusivo dentro do conjunto de configurações de IP de front-end usadas pelo balanceador de carga. Esse nome pode ser usado para acessar o recurso. | cadeia de caracteres (obrigatório) |
| properties | 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. | string |
| publicIPAddress | A referência ao recurso de endereço ip público. | SubResource |
| sub-rede | A referência ao recurso de sub-rede de rede virtual. | SubResource |
CloudServiceOsProfile
| Nome | Descrição | Valor |
|---|---|---|
| segredos | Especifica o conjunto de certificados que devem ser instalados nas instâncias de função. | CloudServiceVaultSecretGroup[] |
CloudServiceVaultSecretGroup
| Nome | Descrição | Valor |
|---|---|---|
| sourceVault | A URL relativa do Key Vault que contém todos os certificados em VaultCertificates. | SubResource |
| vaultCertificates | A lista de referências do cofre de chaves no SourceVault que contêm certificados. | CloudServiceVaultCertificate[] |
CloudServiceVaultCertificate
| Nome | Descrição | Valor |
|---|---|---|
| certificateUrl | Essa é a URL de um certificado que foi carregado para Key Vault como um segredo. | string |
CloudServiceRoleProfile
| Nome | Descrição | Valor |
|---|---|---|
| funções | Lista de funções para o serviço de nuvem. | CloudServiceRoleProfileProperties[] |
CloudServiceRoleProfileProperties
| Nome | Descrição | Valor |
|---|---|---|
| name | Nome do recurso. | string |
| sku | Descreve o sku da função de serviço de nuvem. | CloudServiceRoleSku |
CloudServiceRoleSku
| Nome | Descrição | Valor |
|---|---|---|
| ALOCADA | Especifica o número de instâncias de função no serviço de nuvem. | INT |
| name | O nome do sku. OBSERVAÇÃO: se a nova 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 a sku antiga. | string |
| Camada | Especifica a camada do serviço de nuvem. Valores possíveis são Standard Basic |
string |
SystemData
Esse objeto não contém nenhuma propriedade a ser definida durante a implantação. Todas as propriedades são ReadOnly.
Definição de recurso de modelo do ARM
O tipo de recurso cloudServices pode ser implantado com operações direcionadas:
- Grupos de recursos – Consulte comandos de implantação do grupo de recursos
Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.
Formato de recurso
Para criar um recurso Microsoft.Compute/cloudServices, adicione o JSON a seguir ao modelo.
{
"type": "Microsoft.Compute/cloudServices",
"apiVersion": "2022-09-04",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"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"
}
]
}
]
},
"packageUrl": "string",
"roleProfile": {
"roles": [
{
"name": "string",
"sku": {
"capacity": "int",
"name": "string",
"tier": "string"
}
}
]
},
"startCloudService": "bool",
"upgradeMode": "string"
},
"systemData": {},
"zones": [ "string" ]
}
Valores de propriedade
cloudServices
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de recurso | 'Microsoft.Compute/cloudServices' |
| apiVersion | A versão da API de recursos | '2022-09-04' |
| name | O nome do recurso | cadeia de caracteres (obrigatório) Limite de caracteres: 1 a 15 Caracteres válidos: Não é possível usar espaços, caracteres de controle ou estes caracteres: ~ ! @ # $ % ^ & * ( ) = + _ [ ] { } \ | ; : . ' " , < > / ?Não pode começar com sublinhado. Não pode terminar com ponto ou hífen. |
| local | Local do recurso. | cadeia de caracteres (obrigatório) |
| marcas | Marcas de recurso. | Dicionário de nomes e valores de marcas. Consulte Marcas em modelos |
| properties | Propriedades do serviço de nuvem | CloudServiceProperties |
| systemData | Os metadados do sistema relacionados a esse recurso. | SystemData |
| 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. | string[] |
CloudServiceProperties
| 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. | string |
| configurationUrl | Especifica uma URL que se refere ao local da configuração 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. Essa é uma propriedade somente gravação e não é retornada em chamadas GET. |
string |
| extensionProfile | Descreve um perfil de extensão de serviço de nuvem. | CloudServiceExtensionProfile |
| networkProfile | Perfil de rede para o serviço de nuvem. | CloudServiceNetworkProfile |
| osProfile | Descreve o perfil do sistema operacional para o serviço de nuvem. | CloudServiceOsProfile |
| packageUrl | Especifica uma URL que faz referência 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. Essa é uma propriedade somente gravação e não é retornada em chamadas GET. |
string |
| 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 sua criação. 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é que você chame Start, momento em que o serviço será iniciado. Um serviço implantado ainda incorre em encargos, mesmo que seja desligado. |
bool |
| upgradeMode | 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 ser iniciadas automaticamente em todos os domínios da atualização. Valores possíveis são Auto 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' |
CloudServiceExtensionProfile
| Nome | Descrição | Valor |
|---|---|---|
| extensions | Lista de extensões para o serviço de nuvem. | Extensão[] |
Extensão
| Nome | Descrição | Valor |
|---|---|---|
| name | O nome da extensão. | string |
| properties | Propriedades da extensão. | CloudServiceExtensionProperties |
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 fluirá 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 |
string |
| protectedSettings | Configurações protegidas para a extensão que são criptografadas antes de serem enviadas para a instância de função. | |
| 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 |
| publicador | O nome do editor do manipulador de extensão. | string |
| 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. | string[] |
| 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), essa é a configuração XML para a extensão. | |
| tipo | Especifica o tipo da extensão. | string |
| 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. | string |
CloudServiceVaultAndSecretReference
| Nome | Descrição | Valor |
|---|---|---|
| secretUrl | URL secreta que contém as configurações protegidas da extensão | string |
| sourceVault | A ID do recurso arm do Key Vault | SubResource |
SubResource
| Nome | Descrição | Valor |
|---|---|---|
| id | ID do recurso | string |
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 uma Load Balancer Pública e a uma Load Balancer Interna. | LoadBalancerConfiguration[] |
| slotType | Tipo de slot para o serviço de nuvem. Os valores possíveis são: Produção 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 de assunto 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. | SubResource |
LoadBalancerConfiguration
| Nome | Descrição | Valor |
|---|---|---|
| id | ID do recurso | string |
| name | O nome do balanceador de carga | cadeia de caracteres (obrigatório) |
| properties | 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 |
|---|---|---|
| name | O nome do recurso exclusivo dentro do conjunto de configurações de IP de front-end usadas pelo balanceador de carga. Esse nome pode ser usado para acessar o recurso. | cadeia de caracteres (obrigatório) |
| properties | 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. | string |
| publicIPAddress | A referência ao recurso de endereço ip público. | SubResource |
| sub-rede | A referência ao recurso de sub-rede de rede virtual. | SubResource |
CloudServiceOsProfile
| Nome | Descrição | Valor |
|---|---|---|
| segredos | Especifica o conjunto de certificados que devem ser instalados nas instâncias de função. | CloudServiceVaultSecretGroup[] |
CloudServiceVaultSecretGroup
| Nome | Descrição | Valor |
|---|---|---|
| sourceVault | A URL relativa do Key Vault que contém todos os certificados em VaultCertificates. | SubResource |
| vaultCertificates | A lista de referências do cofre de chaves no SourceVault que contêm certificados. | CloudServiceVaultCertificate[] |
CloudServiceVaultCertificate
| Nome | Descrição | Valor |
|---|---|---|
| certificateUrl | Essa é a URL de um certificado que foi carregado para Key Vault como um segredo. | string |
CloudServiceRoleProfile
| Nome | Descrição | Valor |
|---|---|---|
| funções | Lista de funções para o serviço de nuvem. | CloudServiceRoleProfileProperties[] |
CloudServiceRoleProfileProperties
| Nome | Descrição | Valor |
|---|---|---|
| name | Nome do recurso. | string |
| sku | Descreve o sku da função de serviço de nuvem. | CloudServiceRoleSku |
CloudServiceRoleSku
| Nome | Descrição | Valor |
|---|---|---|
| ALOCADA | Especifica o número de instâncias de função no serviço de nuvem. | INT |
| name | O nome do sku. OBSERVAÇÃO: se a nova 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 a sku antiga. | string |
| Camada | Especifica a camada do serviço de nuvem. Valores possíveis são Standard Basic |
string |
SystemData
Esse objeto não contém nenhuma propriedade a ser definida durante a implantação. Todas as propriedades são ReadOnly.
Definição de recurso do Terraform (provedor AzAPI)
O tipo de recurso cloudServices pode ser implantado com operações direcionadas:
- Grupos de recursos
Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.
Formato de recurso
Para criar um recurso Microsoft.Compute/cloudServices, adicione o Terraform a seguir ao modelo.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Compute/cloudServices@2022-09-04"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
body = jsonencode({
properties = {
allowModelOverride = bool
configuration = "string"
configurationUrl = "string"
extensionProfile = {
extensions = [
{
name = "string"
properties = {
autoUpgradeMinorVersion = bool
forceUpdateTag = "string"
protectedSettingsFromKeyVault = {
secretUrl = "string"
sourceVault = {
id = "string"
}
}
publisher = "string"
rolesAppliedTo = [
"string"
]
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"
}
]
}
]
}
packageUrl = "string"
roleProfile = {
roles = [
{
name = "string"
sku = {
capacity = int
name = "string"
tier = "string"
}
}
]
}
startCloudService = bool
upgradeMode = "string"
}
systemData = {}
zones = [
"string"
]
})
}
Valores de propriedade
cloudServices
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de recurso | "Microsoft.Compute/cloudServices@2022-09-04" |
| name | O nome do recurso | cadeia de caracteres (obrigatório) Limite de caracteres: 1 a 15 Caracteres válidos: Não é possível usar espaços, caracteres de controle ou estes caracteres: ~ ! @ # $ % ^ & * ( ) = + _ [ ] { } \ | ; : . ' " , < > / ?Não pode começar com sublinhado. Não pode terminar com ponto ou hífen. |
| local | Local do recurso. | cadeia de caracteres (obrigatório) |
| parent_id | Para implantar em um grupo de recursos, use a ID desse grupo de recursos. | cadeia de caracteres (obrigatório) |
| marcas | Marcas de recurso. | Dicionário de nomes e valores de marcas. |
| properties | Propriedades do serviço de nuvem | CloudServiceProperties |
| systemData | Os metadados do sistema relacionados a esse recurso. | SystemData |
| 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. | string[] |
CloudServiceProperties
| 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. | string |
| configurationUrl | Especifica uma URL que se refere ao local da configuração 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. Essa é uma propriedade somente gravação e não é retornada em chamadas GET. |
string |
| extensionProfile | Descreve um perfil de extensão de serviço de nuvem. | CloudServiceExtensionProfile |
| networkProfile | Perfil de rede para o serviço de nuvem. | CloudServiceNetworkProfile |
| osProfile | Descreve o perfil do sistema operacional para o serviço de nuvem. | CloudServiceOsProfile |
| packageUrl | Especifica uma URL que faz referência 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. Essa é uma propriedade somente gravação e não é retornada em chamadas GET. |
string |
| 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 sua criação. 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é que você chame Start, momento em que o serviço será iniciado. Um serviço implantado ainda incorre em encargos, mesmo que seja desligado. |
bool |
| upgradeMode | 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 ser iniciadas automaticamente em todos os domínios da atualização. Valores possíveis são Auto 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" |
CloudServiceExtensionProfile
| Nome | Descrição | Valor |
|---|---|---|
| extensions | Lista de extensões para o serviço de nuvem. | Extensão[] |
Extensão
| Nome | Descrição | Valor |
|---|---|---|
| name | O nome da extensão. | string |
| properties | Propriedades da extensão. | CloudServiceExtensionProperties |
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 fluirá 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 |
string |
| protectedSettings | Configurações protegidas para a extensão que são criptografadas antes de serem enviadas para a instância de função. | |
| 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 |
| publicador | O nome do editor do manipulador de extensão. | string |
| 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. | string[] |
| 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), essa é a configuração XML para a extensão. | |
| tipo | Especifica o tipo da extensão. | string |
| 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. | string |
CloudServiceVaultAndSecretReference
| Nome | Descrição | Valor |
|---|---|---|
| secretUrl | URL secreta que contém as configurações protegidas da extensão | string |
| sourceVault | A ID do recurso arm do Key Vault | SubResource |
SubResource
| Nome | Descrição | Valor |
|---|---|---|
| id | ID do recurso | string |
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 uma Load Balancer Pública e a uma Load Balancer Interna. | LoadBalancerConfiguration[] |
| slotType | Tipo de slot para o serviço de nuvem. Os valores possíveis são: Produção 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 de assunto 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. | SubResource |
LoadBalancerConfiguration
| Nome | Descrição | Valor |
|---|---|---|
| id | ID do recurso | string |
| name | O nome do balanceador de carga | cadeia de caracteres (obrigatório) |
| properties | 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 |
|---|---|---|
| name | O nome do recurso exclusivo dentro do conjunto de configurações de IP de front-end usadas pelo balanceador de carga. Esse nome pode ser usado para acessar o recurso. | cadeia de caracteres (obrigatório) |
| properties | 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. | string |
| publicIPAddress | A referência ao recurso de endereço ip público. | SubResource |
| sub-rede | A referência ao recurso de sub-rede de rede virtual. | SubResource |
CloudServiceOsProfile
| Nome | Descrição | Valor |
|---|---|---|
| segredos | Especifica o conjunto de certificados que devem ser instalados nas instâncias de função. | CloudServiceVaultSecretGroup[] |
CloudServiceVaultSecretGroup
| Nome | Descrição | Valor |
|---|---|---|
| sourceVault | A URL relativa do Key Vault que contém todos os certificados em VaultCertificates. | SubResource |
| vaultCertificates | A lista de referências do cofre de chaves no SourceVault que contêm certificados. | CloudServiceVaultCertificate[] |
CloudServiceVaultCertificate
| Nome | Descrição | Valor |
|---|---|---|
| certificateUrl | Essa é a URL de um certificado que foi carregado para Key Vault como um segredo. | string |
CloudServiceRoleProfile
| Nome | Descrição | Valor |
|---|---|---|
| funções | Lista de funções para o serviço de nuvem. | CloudServiceRoleProfileProperties[] |
CloudServiceRoleProfileProperties
| Nome | Descrição | Valor |
|---|---|---|
| name | Nome do recurso. | string |
| sku | Descreve o sku da função de serviço de nuvem. | CloudServiceRoleSku |
CloudServiceRoleSku
| Nome | Descrição | Valor |
|---|---|---|
| ALOCADA | Especifica o número de instâncias de função no serviço de nuvem. | INT |
| name | O nome do sku. OBSERVAÇÃO: se a nova 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 a sku antiga. | string |
| Camada | Especifica a camada do serviço de nuvem. Valores possíveis são Standard Basic |
string |
SystemData
Esse objeto não contém nenhuma propriedade a ser definida durante a implantação. Todas as propriedades são ReadOnly.
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de