Microsoft.Compute cloudServices 2022-09-04
Definição de recurso do Bicep
O tipo de recurso cloudServices pode ser implementado com operações que visam:
- Grupos de recursos – veja comandos de implementação de grupos de recursos
Para obter uma lista de propriedades alteradas em cada versão da API, veja registo de alterações.
Formato do recurso
Para criar um recurso Microsoft.Compute/cloudServices, adicione o seguinte Bicep ao seu 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 (obrigatório) Limite de carateres: 1-15 Carateres válidos: Não é possível utilizar espaços, carateres de controlo ou estes carateres: ~ ! @ # $ % ^ & * ( ) = + _ [ ] { } \ | ; : . ' " , < > / ?Não é possível começar com o caráter de sublinhado. Não é possível terminar com o ponto final ou hífen. |
| localização | Localização do recurso. | cadeia (obrigatório) |
| etiquetas | Etiquetas de recursos. | Dicionário de nomes e valores de etiquetas. Ver Etiquetas em modelos |
| propriedades | Propriedades do serviço cloud | CloudServiceProperties |
| systemData | Os metadados do sistema relacionados com este recurso. | SystemData |
| zonas | Lista da zona de disponibilidade lógica do recurso. A lista deve conter apenas uma zona onde o serviço cloud deve ser aprovisionado. Este campo é opcional. | cadeia[] |
CloudServiceProperties
| Nome | Descrição | Valor |
|---|---|---|
| allowModelOverride | (Opcional) Indica se as propriedades do 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, respetivamente. O valor predefinido é false. |
bool |
| configuração | Especifica a configuração do serviço XML (.cscfg) para o serviço cloud. | string |
| configurationUrl | Especifica um URL que se refere à localização da configuração do serviço no serviço Blob. O URL do pacote de serviço pode ser URI de Assinatura de Acesso Partilhado (SAS) a partir de qualquer conta de armazenamento. Esta é uma propriedade só de escrita e não é devolvida em chamadas GET. |
string |
| extensionProfile | Descreve um perfil de extensão do serviço cloud. | CloudServiceExtensionProfile |
| networkProfile | Perfil de Rede para o serviço cloud. | CloudServiceNetworkProfile |
| osProfile | Descreve o perfil do SO para o serviço cloud. | CloudServiceOsProfile |
| packageUrl | Especifica um URL que se refere à localização do pacote de serviço no serviço Blob. O URL do pacote de serviço pode ser URI de Assinatura de Acesso Partilhado (SAS) a partir de qualquer conta de armazenamento. Esta é uma propriedade só de escrita e não é devolvida em chamadas GET. |
string |
| roleProfile | Descreve o perfil de função do serviço cloud. | CloudServiceRoleProfile |
| startCloudService | (Opcional) Indica se deve iniciar o serviço cloud imediatamente após a sua criação. O valor predefinido é true.Se for falso, o modelo de serviço ainda está implementado, mas o código não é executado imediatamente. Em vez disso, o serviço é PoweredOff até chamar Iniciar, altura em que o serviço será iniciado. Um serviço implementado ainda incorre em custos, mesmo que seja desligado. |
bool |
| upgradeMode | Modo de atualização para o serviço cloud. As instâncias de função são alocadas para atualizar domínios quando o serviço é implementado. Atualizações podem ser iniciadas manualmente em cada domínio de atualização ou iniciadas automaticamente em todos os domínios de atualização. Os Valores Possíveis são Automático Manual Simultânea Se não for especificado, o valor predefinido é Automático. Se estiver definido como Manual, o PUT UpdateDomain tem de ser chamado para aplicar a atualização. Se definida como Automática, a atualização é aplicada automaticamente a cada domínio de atualização em sequência. |
"Automático" "Manual" "Simultâneo" |
CloudServiceExtensionProfile
| Nome | Descrição | Valor |
|---|---|---|
| extensões | Lista de extensões para o serviço cloud. | Extensão[] |
Extensão
| Nome | Descrição | Valor |
|---|---|---|
| name | O nome da extensão. | string |
| propriedades | Propriedades da Extensão. | CloudServiceExtensionProperties |
CloudServiceExtensionProperties
| Nome | Descrição | Valor |
|---|---|---|
| autoUpgradeMinorVersion | Especifique explicitamente se a plataforma pode atualizar automaticamente o tipoHandlerVersion para versões secundárias superiores quando ficarem disponíveis. | bool |
| forceUpdateTag | Etiqueta para forçar a aplicação das definições públicas e protegidas fornecidas. Alterar o valor da etiqueta permite executar novamente a extensão sem alterar nenhuma das definições públicas ou protegidas. Se forceUpdateTag não for alterado, as atualizações para definições públicas ou protegidas continuarão a ser aplicadas pelo processador. Se nem forceUpdateTag nem nenhuma das definições públicas ou protegidas mudar, a extensão fluirá para a instância de função com o mesmo número de sequência e cabe à implementação do processador voltar a executá-la ou não |
string |
| protectedSettings | Definições protegidas para a extensão que são encriptadas antes de serem enviadas para a instância de função. | Para Bicep, pode utilizar a função any( ). |
| protectedSettingsFromKeyVault | Definições protegidas para a extensão, referenciadas com KeyVault que são encriptadas antes de serem enviadas para a instância de função. | CloudServiceVaultAndSecretReference |
| publicador | O nome do editor do processador de extensões. | string |
| rolesAppliedTo | Lista opcional de funções para aplicar esta 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 cloud. | string[] |
| definições | Definições públicas para a extensão. Para extensões JSON, estas são as definições JSON para a extensão. Para a Extensão XML (como RDP), esta é a definição XML para a extensão. | Para Bicep, pode utilizar 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 este elemento não for especificado ou se for utilizado um asterisco (*) como o valor, é utilizada a versão mais recente da extensão. Se o valor for especificado com um número de versão principal e um asterisco como o número da versão secundária (X.), é selecionada a versão secundária mais recente da versão principal especificada. Se for especificado um número de versão principal e um número de versão secundária (X.Y), a versão específica da extensão será selecionada. Se for especificada uma versão, é efetuada uma atualização automática na instância de função. | string |
CloudServiceVaultAndSecretReference
| Nome | Descrição | Valor |
|---|---|---|
| secretUrl | URL secreto que contém as definições protegidas da extensão | string |
| sourceVault | O ID de Recurso do ARM do Key Vault | Sub-origem |
Sub-origem
| 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 cloud pode ter até duas configurações de balanceador de carga, correspondentes a uma Balanceador de Carga Pública e a uma Balanceador de Carga Interna. | LoadBalancerConfiguration[] |
| slotType | Tipo de bloco para o serviço cloud. Os valores possíveis são Produção Processo de teste Se não for especificado, o valor predefinido é Produção. |
"Produção" "Teste" |
| swapableCloudService | A referência de ID do serviço cloud que contém o IP de destino com o qual o serviço cloud do requerente pode efetuar uma troca. Esta propriedade não pode ser atualizada depois de estar definida. O serviço cloud trocável referido por este ID tem de estar presente, caso contrário, será gerado um erro. | Sub-origem |
LoadBalancerConfiguration
| Nome | Descrição | Valor |
|---|---|---|
| ID | ID do Recurso | string |
| name | O nome do Balanceador de carga | cadeia (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 utilizado para o balanceador de carga. Só é suportado o endereço IP de front-end IPv4. Cada configuração do balanceador de carga tem de ter exatamente uma configuração de IP de front-end. | LoadBalancerFrontendIpConfiguration[] (obrigatório) |
LoadBalancerFrontendIpConfiguration
| Nome | Descrição | Valor |
|---|---|---|
| name | O nome do recurso que é exclusivo no conjunto de configurações de IP de front-end utilizadas pelo balanceador de carga. Este nome pode ser utilizado para aceder ao recurso. | cadeia (obrigatório) |
| propriedades | Propriedades da configuração 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. | Sub-origem |
| sub-rede | A referência ao recurso de sub-rede de rede virtual. | Sub-origem |
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 | O URL relativo do Key Vault que contém todos os certificados em VaultCertificates. | Sub-origem |
| vaultCertificates | A lista de referências do cofre de chaves no SourceVault que contém certificados. | CloudServiceVaultCertificate[] |
CloudServiceVaultCertificate
| Nome | Descrição | Valor |
|---|---|---|
| certificateUrl | Este é o 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 cloud. | CloudServiceRoleProfileProperties[] |
CloudServiceRoleProfileProperties
| Nome | Descrição | Valor |
|---|---|---|
| name | Nome do recurso. | string |
| sku | Descreve o sku da função de serviço cloud. | CloudServiceRoleSku |
CloudServiceRoleSku
| Nome | Descrição | Valor |
|---|---|---|
| capacidade | Especifica o número de instâncias de função no serviço cloud. | int |
| name | O nome do sku. NOTA: se o novo SKU não for suportado no hardware em que o serviço cloud está atualmente ativado, terá de eliminar e recriar o serviço cloud ou voltar para o sku antigo. | string |
| tier | Especifica o escalão do serviço cloud. Os Valores Possíveis são Standard Básica |
string |
SystemData
Este objeto não contém quaisquer propriedades a definir durante a implementação. Todas as propriedades são ReadOnly.
Definição de recurso de modelo do ARM
O tipo de recurso cloudServices pode ser implementado com operações que visam:
- Grupos de recursos – veja comandos de implementação de grupos de recursos
Para obter uma lista de propriedades alteradas em cada versão da API, veja registo de alterações.
Formato do recurso
Para criar um recurso Microsoft.Compute/cloudServices, adicione o seguinte JSON ao seu 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 (obrigatório) Limite de carateres: 1-15 Carateres válidos: Não é possível utilizar espaços, carateres de controlo ou estes carateres: ~ ! @ # $ % ^ & * ( ) = + _ [ ] { } \ | ; : . ' " , < > / ?Não é possível começar com o caráter de sublinhado. Não é possível terminar com o ponto final ou hífen. |
| localização | Localização do recurso. | cadeia (obrigatório) |
| etiquetas | Etiquetas de recursos. | Dicionário de nomes e valores de etiquetas. Ver Etiquetas em modelos |
| propriedades | Propriedades do serviço cloud | CloudServiceProperties |
| systemData | Os metadados do sistema relacionados com este recurso. | SystemData |
| zonas | Lista da zona de disponibilidade lógica do recurso. A lista deve conter apenas uma zona onde o serviço cloud deve ser aprovisionado. Este campo é opcional. | cadeia[] |
CloudServiceProperties
| Nome | Descrição | Valor |
|---|---|---|
| allowModelOverride | (Opcional) Indica se as propriedades do 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, respetivamente. O valor predefinido é false. |
bool |
| configuração | Especifica a configuração do serviço XML (.cscfg) para o serviço cloud. | string |
| configurationUrl | Especifica um URL que se refere à localização da configuração do serviço no serviço Blob. O URL do pacote de serviço pode ser URI de Assinatura de Acesso Partilhado (SAS) a partir de qualquer conta de armazenamento. Esta é uma propriedade só de escrita e não é devolvida em chamadas GET. |
string |
| extensionProfile | Descreve um perfil de extensão do serviço cloud. | CloudServiceExtensionProfile |
| networkProfile | Perfil de Rede para o serviço cloud. | CloudServiceNetworkProfile |
| osProfile | Descreve o perfil do SO para o serviço cloud. | CloudServiceOsProfile |
| packageUrl | Especifica um URL que se refere à localização do pacote de serviço no serviço Blob. O URL do pacote de serviço pode ser URI de Assinatura de Acesso Partilhado (SAS) a partir de qualquer conta de armazenamento. Esta é uma propriedade só de escrita e não é devolvida em chamadas GET. |
string |
| roleProfile | Descreve o perfil de função do serviço cloud. | CloudServiceRoleProfile |
| startCloudService | (Opcional) Indica se deve iniciar o serviço cloud imediatamente após a sua criação. O valor predefinido é true.Se for falso, o modelo de serviço ainda está implementado, mas o código não é executado imediatamente. Em vez disso, o serviço é PoweredOff até chamar Iniciar, altura em que o serviço será iniciado. Um serviço implementado ainda incorre em custos, mesmo que seja desligado. |
bool |
| upgradeMode | Modo de atualização para o serviço cloud. As instâncias de função são alocadas para atualizar domínios quando o serviço é implementado. Atualizações podem ser iniciadas manualmente em cada domínio de atualização ou iniciadas automaticamente em todos os domínios de atualização. Os Valores Possíveis são Automático Manual Simultânea Se não for especificado, o valor predefinido é Automático. Se estiver definido como Manual, o PUT UpdateDomain tem de ser chamado para aplicar a atualização. Se definida como Automática, a atualização é aplicada automaticamente a cada domínio de atualização em sequência. |
"Automático" "Manual" "Simultâneo" |
CloudServiceExtensionProfile
| Nome | Descrição | Valor |
|---|---|---|
| extensões | Lista de extensões para o serviço cloud. | Extensão[] |
Extensão
| Nome | Descrição | Valor |
|---|---|---|
| name | O nome da extensão. | string |
| propriedades | Propriedades da Extensão. | CloudServiceExtensionProperties |
CloudServiceExtensionProperties
| Nome | Descrição | Valor |
|---|---|---|
| autoUpgradeMinorVersion | Especifique explicitamente se a plataforma pode atualizar automaticamente o tipoHandlerVersion para versões secundárias superiores quando ficarem disponíveis. | bool |
| forceUpdateTag | Etiqueta para forçar a aplicação das definições públicas e protegidas fornecidas. Alterar o valor da etiqueta permite executar novamente a extensão sem alterar nenhuma das definições públicas ou protegidas. Se forceUpdateTag não for alterado, as atualizações para definições públicas ou protegidas continuarão a ser aplicadas pelo processador. Se nem forceUpdateTag nem nenhuma das definições públicas ou protegidas mudar, a extensão fluirá para a instância de função com o mesmo número de sequência e cabe à implementação do processador voltar a executá-la ou não |
string |
| protectedSettings | Definições protegidas para a extensão que são encriptadas antes de serem enviadas para a instância de função. | |
| protectedSettingsFromKeyVault | Definições protegidas para a extensão, referenciadas com KeyVault que são encriptadas antes de serem enviadas para a instância de função. | CloudServiceVaultAndSecretReference |
| publicador | O nome do editor do processador de extensões. | string |
| rolesAppliedTo | Lista opcional de funções para aplicar esta 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 cloud. | string[] |
| definições | Definições públicas para a extensão. Para extensões JSON, estas são as definições JSON para a extensão. Para a Extensão XML (como RDP), esta é a definiçã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 este elemento não for especificado ou se for utilizado um asterisco (*) como o valor, é utilizada a versão mais recente da extensão. Se o valor for especificado com um número de versão principal e um asterisco como o número da versão secundária (X.), é selecionada a versão secundária mais recente da versão principal especificada. Se for especificado um número de versão principal e um número de versão secundária (X.Y), a versão específica da extensão será selecionada. Se for especificada uma versão, é efetuada uma atualização automática na instância de função. | string |
CloudServiceVaultAndSecretReference
| Nome | Descrição | Valor |
|---|---|---|
| secretUrl | URL secreto que contém as definições protegidas da extensão | string |
| sourceVault | O ID de Recurso do ARM do Key Vault | Sub-origem |
Sub-origem
| 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 cloud pode ter até duas configurações de balanceador de carga, correspondentes a uma Balanceador de Carga Pública e a uma Balanceador de Carga Interna. | LoadBalancerConfiguration[] |
| slotType | Tipo de bloco para o serviço cloud. Os valores possíveis são Produção Processo de teste Se não for especificado, o valor predefinido é Produção. |
"Produção" "Teste" |
| swapableCloudService | A referência de ID do serviço cloud que contém o IP de destino com o qual o serviço cloud do requerente pode efetuar uma troca. Esta propriedade não pode ser atualizada depois de estar definida. O serviço cloud trocável referido por este ID tem de estar presente, caso contrário, será gerado um erro. | Sub-origem |
LoadBalancerConfiguration
| Nome | Descrição | Valor |
|---|---|---|
| ID | ID do Recurso | string |
| name | O nome do Balanceador de carga | cadeia (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 utilizado para o balanceador de carga. Só é suportado o endereço IP de front-end IPv4. Cada configuração do balanceador de carga tem de ter exatamente uma configuração de IP de front-end. | LoadBalancerFrontendIpConfiguration[] (obrigatório) |
LoadBalancerFrontendIpConfiguration
| Nome | Descrição | Valor |
|---|---|---|
| name | O nome do recurso que é exclusivo no conjunto de configurações de IP de front-end utilizadas pelo balanceador de carga. Este nome pode ser utilizado para aceder ao recurso. | cadeia (obrigatório) |
| propriedades | Propriedades da configuração 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. | Sub-origem |
| sub-rede | A referência ao recurso de sub-rede de rede virtual. | Sub-origem |
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 | O URL relativo do Key Vault que contém todos os certificados em VaultCertificates. | Sub-origem |
| vaultCertificates | A lista de referências do cofre de chaves no SourceVault que contém certificados. | CloudServiceVaultCertificate[] |
CloudServiceVaultCertificate
| Nome | Descrição | Valor |
|---|---|---|
| certificateUrl | Este é o 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 cloud. | CloudServiceRoleProfileProperties[] |
CloudServiceRoleProfileProperties
| Nome | Descrição | Valor |
|---|---|---|
| name | Nome do recurso. | string |
| sku | Descreve o sku da função de serviço cloud. | CloudServiceRoleSku |
CloudServiceRoleSku
| Nome | Descrição | Valor |
|---|---|---|
| capacidade | Especifica o número de instâncias de função no serviço cloud. | int |
| name | O nome do sku. NOTA: se o novo SKU não for suportado no hardware em que o serviço cloud está atualmente ativado, terá de eliminar e recriar o serviço cloud ou voltar para o sku antigo. | string |
| tier | Especifica o escalão do serviço cloud. Os Valores Possíveis são Standard Básica |
string |
SystemData
Este objeto não contém quaisquer propriedades a definir durante a implementação. Todas as propriedades são ReadOnly.
Definição de recurso do Terraform (fornecedor AzAPI)
O tipo de recurso cloudServices pode ser implementado com operações que visam:
- Grupos de recursos
Para obter uma lista de propriedades alteradas em cada versão da API, veja registo de alterações.
Formato do recurso
Para criar um recurso Microsoft.Compute/cloudServices, adicione o seguinte Terraform ao seu 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 (obrigatório) Limite de carateres: 1-15 Carateres válidos: Não é possível utilizar espaços, carateres de controlo ou estes carateres: ~ ! @ # $ % ^ & * ( ) = + _ [ ] { } \ | ; : . ' " , < > / ?Não é possível começar com o caráter de sublinhado. Não é possível terminar com o ponto final ou hífen. |
| localização | Localização do recurso. | cadeia (obrigatório) |
| parent_id | Para implementar num grupo de recursos, utilize o ID desse grupo de recursos. | cadeia (obrigatório) |
| etiquetas | Etiquetas de recursos. | Dicionário de nomes e valores de etiquetas. |
| propriedades | Propriedades do serviço cloud | CloudServiceProperties |
| systemData | Os metadados do sistema relacionados com este recurso. | SystemData |
| zonas | Lista da zona de disponibilidade lógica do recurso. A lista deve conter apenas uma zona onde o serviço cloud deve ser aprovisionado. Este campo é opcional. | cadeia[] |
CloudServiceProperties
| Nome | Descrição | Valor |
|---|---|---|
| allowModelOverride | (Opcional) Indica se as propriedades do 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, respetivamente. O valor predefinido é false. |
bool |
| configuração | Especifica a configuração do serviço XML (.cscfg) para o serviço cloud. | string |
| configurationUrl | Especifica um URL que se refere à localização da configuração do serviço no serviço Blob. O URL do pacote de serviço pode ser URI de Assinatura de Acesso Partilhado (SAS) a partir de qualquer conta de armazenamento. Esta é uma propriedade só de escrita e não é devolvida em chamadas GET. |
string |
| extensionProfile | Descreve um perfil de extensão do serviço cloud. | CloudServiceExtensionProfile |
| networkProfile | Perfil de Rede para o serviço cloud. | CloudServiceNetworkProfile |
| osProfile | Descreve o perfil do SO para o serviço cloud. | CloudServiceOsProfile |
| packageUrl | Especifica um URL que se refere à localização do pacote de serviço no serviço Blob. O URL do pacote de serviço pode ser URI de Assinatura de Acesso Partilhado (SAS) a partir de qualquer conta de armazenamento. Esta é uma propriedade só de escrita e não é devolvida em chamadas GET. |
string |
| roleProfile | Descreve o perfil de função do serviço cloud. | CloudServiceRoleProfile |
| startCloudService | (Opcional) Indica se deve iniciar o serviço cloud imediatamente após a sua criação. O valor predefinido é true.Se for falso, o modelo de serviço ainda está implementado, mas o código não é executado imediatamente. Em vez disso, o serviço é PoweredOff até chamar Iniciar, altura em que o serviço será iniciado. Um serviço implementado ainda incorre em custos, mesmo que seja desligado. |
bool |
| upgradeMode | Modo de atualização para o serviço cloud. As instâncias de função são alocadas para atualizar domínios quando o serviço é implementado. Atualizações podem ser iniciadas manualmente em cada domínio de atualização ou iniciadas automaticamente em todos os domínios de atualização. Os Valores Possíveis são Automático Manual Simultânea Se não for especificado, o valor predefinido é Automático. Se estiver definido como Manual, o PUT UpdateDomain tem de ser chamado para aplicar a atualização. Se definida como Automática, a atualização é aplicada automaticamente a cada domínio de atualização em sequência. |
"Automático" "Manual" "Simultâneo" |
CloudServiceExtensionProfile
| Nome | Descrição | Valor |
|---|---|---|
| extensões | Lista de extensões para o serviço cloud. | Extensão[] |
Extensão
| Nome | Descrição | Valor |
|---|---|---|
| name | O nome da extensão. | string |
| propriedades | Propriedades da Extensão. | CloudServiceExtensionProperties |
CloudServiceExtensionProperties
| Nome | Descrição | Valor |
|---|---|---|
| autoUpgradeMinorVersion | Especifique explicitamente se a plataforma pode atualizar automaticamente o tipoHandlerVersion para versões secundárias superiores quando ficarem disponíveis. | bool |
| forceUpdateTag | Etiqueta para forçar a aplicação das definições públicas e protegidas fornecidas. Alterar o valor da etiqueta permite executar novamente a extensão sem alterar nenhuma das definições públicas ou protegidas. Se forceUpdateTag não for alterado, as atualizações para definições públicas ou protegidas continuarão a ser aplicadas pelo processador. Se nem forceUpdateTag nem nenhuma das definições públicas ou protegidas mudar, a extensão fluirá para a instância de função com o mesmo número de sequência e cabe à implementação do processador voltar a executá-la ou não |
string |
| protectedSettings | Definições protegidas para a extensão que são encriptadas antes de serem enviadas para a instância de função. | |
| protectedSettingsFromKeyVault | Definições protegidas para a extensão, referenciadas com KeyVault que são encriptadas antes de serem enviadas para a instância de função. | CloudServiceVaultAndSecretReference |
| publicador | O nome do editor do processador de extensões. | string |
| rolesAppliedTo | Lista opcional de funções para aplicar esta 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 cloud. | string[] |
| definições | Definições públicas para a extensão. Para extensões JSON, estas são as definições JSON para a extensão. Para a Extensão XML (como RDP), esta é a definiçã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 este elemento não for especificado ou se for utilizado um asterisco (*) como o valor, é utilizada a versão mais recente da extensão. Se o valor for especificado com um número de versão principal e um asterisco como o número da versão secundária (X.), é selecionada a versão secundária mais recente da versão principal especificada. Se for especificado um número de versão principal e um número de versão secundária (X.Y), a versão específica da extensão será selecionada. Se for especificada uma versão, é efetuada uma atualização automática na instância de função. | string |
CloudServiceVaultAndSecretReference
| Nome | Descrição | Valor |
|---|---|---|
| secretUrl | URL secreto que contém as definições protegidas da extensão | string |
| sourceVault | O ID de Recurso do ARM do Key Vault | Sub-origem |
Sub-origem
| 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 cloud pode ter até duas configurações de balanceador de carga, correspondentes a uma Balanceador de Carga Pública e a uma Balanceador de Carga Interna. | LoadBalancerConfiguration[] |
| slotType | Tipo de bloco para o serviço cloud. Os valores possíveis são Produção Processo de teste Se não for especificado, o valor predefinido é Produção. |
"Produção" "Teste" |
| swapableCloudService | A referência de ID do serviço cloud que contém o IP de destino com o qual o serviço cloud do requerente pode efetuar uma troca. Esta propriedade não pode ser atualizada depois de estar definida. O serviço cloud trocável referido por este ID tem de estar presente, caso contrário, será gerado um erro. | Sub-origem |
LoadBalancerConfiguration
| Nome | Descrição | Valor |
|---|---|---|
| ID | ID do Recurso | string |
| name | O nome do Balanceador de carga | cadeia (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 utilizado para o balanceador de carga. Só é suportado o endereço IP de front-end IPv4. Cada configuração do balanceador de carga tem de ter exatamente uma configuração de IP de front-end. | LoadBalancerFrontendIpConfiguration[] (obrigatório) |
LoadBalancerFrontendIpConfiguration
| Nome | Descrição | Valor |
|---|---|---|
| name | O nome do recurso que é exclusivo no conjunto de configurações de IP de front-end utilizadas pelo balanceador de carga. Este nome pode ser utilizado para aceder ao recurso. | cadeia (obrigatório) |
| propriedades | Propriedades da configuração 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. | Sub-origem |
| sub-rede | A referência ao recurso de sub-rede de rede virtual. | Sub-origem |
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 | O URL relativo do Key Vault que contém todos os certificados em VaultCertificates. | Sub-origem |
| vaultCertificates | A lista de referências do cofre de chaves no SourceVault que contém certificados. | CloudServiceVaultCertificate[] |
CloudServiceVaultCertificate
| Nome | Descrição | Valor |
|---|---|---|
| certificateUrl | Este é o 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 cloud. | CloudServiceRoleProfileProperties[] |
CloudServiceRoleProfileProperties
| Nome | Descrição | Valor |
|---|---|---|
| name | Nome do recurso. | string |
| sku | Descreve o sku da função de serviço cloud. | CloudServiceRoleSku |
CloudServiceRoleSku
| Nome | Descrição | Valor |
|---|---|---|
| capacidade | Especifica o número de instâncias de função no serviço cloud. | int |
| name | O nome do sku. NOTA: se o novo SKU não for suportado no hardware em que o serviço cloud está atualmente ativado, terá de eliminar e recriar o serviço cloud ou voltar para o sku antigo. | string |
| tier | Especifica o escalão do serviço cloud. Os Valores Possíveis são Standard Básica |
string |
SystemData
Este objeto não contém quaisquer propriedades a definir durante a implementação. Todas as propriedades são ReadOnly.
Comentários
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja: https://aka.ms/ContentUserFeedback.
Submeter e ver comentários