Microsoft.Compute cloudServices 2022-04-04
Definición de recursos de Bicep
El tipo de recurso cloudServices se puede implementar con operaciones destinadas a:
- Grupos de recursos: consulte los comandos de implementación del grupo de recursos.
Para obtener una lista de las propiedades modificadas en cada versión de api, consulte registro de cambios.
Formato de los recursos
Para crear un recurso Microsoft.Compute/cloudServices, agregue el siguiente bicep a la plantilla.
resource symbolicname 'Microsoft.Compute/cloudServices@2022-04-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: {}
}
Valores de propiedad
cloudServices
| Nombre | Descripción | Value |
|---|---|---|
| name | El nombre del recurso | string (obligatorio) Límite de caracteres: 1-15 Caracteres válidos: No se pueden usar espacios, caracteres de control ni estos caracteres: ~ ! @ # $ % ^ & * ( ) = + _ [ ] { } \ | ; : . ' " , < > / ?No puede comenzar con un carácter de subrayado. No puede terminar con un punto ni un guion. |
| ubicación | Ubicación del recurso | string (obligatorio) |
| etiquetas | Etiquetas del recurso. | Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas. |
| properties | Propiedades del servicio en la nube | CloudServiceProperties |
| systemData | Metadatos del sistema relacionados con este recurso. | SystemData |
CloudServiceProperties
| Nombre | Descripción | Value |
|---|---|---|
| allowModelOverride | (Opcional) Indica si las propiedades de SKU de rol (roleProfile.roles.sku) especificadas en el modelo o plantilla deben invalidar el número de instancias de rol y el tamaño de máquina virtual especificados en .cscfg y .csdef respectivamente. El valor predeterminado es false. |
bool |
| configuración | Especifica la configuración del servicio XML (.cscfg) para el servicio en la nube. | string |
| configurationUrl | Especifica una dirección URL que hace referencia a la ubicación de la configuración de servicio en Blob service. La dirección URL del paquete de servicio puede ser URI de firma de acceso compartido (SAS) desde cualquier cuenta de almacenamiento. Se trata de una propiedad de solo escritura y no se devuelve en las llamadas GET. |
string |
| extensionProfile | Describe un perfil de extensión de servicio en la nube. | CloudServiceExtensionProfile |
| networkProfile | Perfil de red para el servicio en la nube. | CloudServiceNetworkProfile |
| osProfile | Describe el perfil del sistema operativo para el servicio en la nube. | CloudServiceOsProfile |
| packageUrl | Especifica una dirección URL que hace referencia a la ubicación del paquete de Blob service. La dirección URL del paquete de servicio puede ser URI de firma de acceso compartido (SAS) desde cualquier cuenta de almacenamiento. Se trata de una propiedad de solo escritura y no se devuelve en las llamadas GET. |
string |
| roleProfile | Describe el perfil de rol para el servicio en la nube. | CloudServiceRoleProfile |
| startCloudService | (Opcional) Indica si se debe iniciar el servicio en la nube inmediatamente después de crearlo. El valor predeterminado es true.Si es false, el modelo de servicio se sigue implementando, pero el código no se ejecuta inmediatamente. En su lugar, el servicio es PoweredOff hasta que se llama a Start, en cuyo momento se iniciará el servicio. Un servicio implementado sigue incurr en cargos, incluso si está apagado. |
bool |
| upgradeMode | Modo de actualización para el servicio en la nube. Las instancias de rol se asigna para actualizar dominios cuando se implementa el servicio. Las actualizaciones se pueden iniciar manualmente en cada dominio de actualización o iniciar automáticamente en todos dominios de actualización. Los valores posibles son Automático Manual Simultánea Si no se especifica, el valor predeterminado es Auto. Si se establece en Manual, se debe llamar a PUT UpdateDomain para aplicar la actualización. Si se establece en Automático, la actualización se aplica automáticamente a cada dominio de actualización en secuencia. |
'Auto' 'Manual' "Simultáneo" |
CloudServiceExtensionProfile
| Nombre | Descripción | Value |
|---|---|---|
| extensions | Lista de extensiones para el servicio en la nube. | Extensión[] |
Comprobación de actualización
| NOMBRE | Descripción | Value |
|---|---|---|
| name | Nombre de la extensión. | string |
| properties | Propiedades de extensión. | CloudServiceExtensionProperties |
CloudServiceExtensionProperties
| Nombre | Descripción | Value |
|---|---|---|
| autoUpgradeMinorVersion | Especifique explícitamente si la plataforma puede actualizar automáticamente typeHandlerVersion a versiones secundarias superiores cuando estén disponibles. | bool |
| forceUpdateTag | Etiqueta para forzar la aplicación de la configuración pública y protegida proporcionada. Cambiar el valor de etiqueta permite volver a ejecutar la extensión sin cambiar ninguna de las configuraciones públicas o protegidas. Si forceUpdateTag no se cambia, el controlador seguirá aplicando las actualizaciones de la configuración pública o protegida. Si ni forceUpdateTag ni ninguna de las configuraciones públicas o protegidas cambian, la extensión fluiría a la instancia de rol con el mismo número de secuencia y es necesario controlar la implementación de si volver a ejecutarla o no. |
string |
| protectedSettings | Configuración protegida para la extensión que se cifra antes de enviar a la instancia de rol. | Para Bicep, puede usar la función any(). |
| protectedSettingsFromKeyVault | Configuración protegida para la extensión, a la que se hace referencia mediante KeyVault, que se cifran antes de enviarse a la instancia de rol. | CloudServiceVaultAndSecretReference |
| publisher | Nombre del publicador de controladores de extensión. | string |
| rolesAppliedTo | Lista opcional de roles para aplicar esta extensión. Si no se especifica la propiedad o se especifica '*', la extensión se aplica a todos los roles del servicio en la nube. | string[] |
| configuración | Configuración pública de la extensión. En el caso de las extensiones JSON, esta es la configuración json de la extensión. Para la extensión XML (como RDP), esta es la configuración XML de la extensión. | Para Bicep, puede usar la función any(). |
| tipo | Especifica el tipo de la extensión. | string |
| typeHandlerVersion | Especifica la versión de la extensión. Especifica la versión de la extensión. Si no se especifica este elemento o se usa un asterisco (*) como valor, se usa la versión más reciente de la extensión. Si el valor se especifica con un número de versión principal y un asterisco como número de versión secundaria (X.), se selecciona la versión secundaria más reciente de la versión principal especificada. Si se especifica un número de versión principal y un número de versión secundaria (X.Y), se selecciona la versión de extensión específica. Si se especifica una versión, se realiza una actualización automática en la instancia de rol. | string |
CloudServiceVaultAndSecretReference
| Nombre | Descripción | Value |
|---|---|---|
| secretUrl | Dirección URL secreta que contiene la configuración protegida de la extensión | string |
| sourceVault | Identificador de recurso de ARM del Key Vault | SubResource |
SubResource
| Nombre | Descripción | Value |
|---|---|---|
| id | Id. de recurso | string |
CloudServiceNetworkProfile
| Nombre | Descripción | Value |
|---|---|---|
| loadBalancerConfigurations | Lista de configuraciones del equilibrador de carga. El servicio en la nube puede tener hasta dos configuraciones de equilibrador de carga, que corresponden a un Load Balancer público y a un Load Balancer interno. | LoadBalancerConfiguration[] |
| slotType | Tipo de ranura para el servicio en la nube. Los valores posibles son Producción Ensayo Si no se especifica, el valor predeterminado es Production. |
'Producción' 'Ensayo' |
| swappableCloudService | Referencia de identificador del servicio en la nube que contiene la dirección IP de destino con la que el servicio en la nube del asunto puede realizar un intercambio. Esta propiedad no se puede actualizar una vez establecida. El servicio en la nube intercambiable al que hace referencia este identificador debe estar presente; de lo contrario, se producirá un error. | SubResource |
LoadBalancerConfiguration
| Nombre | Descripción | Value |
|---|---|---|
| id | Id. de recurso | string |
| name | Nombre del equilibrador de carga | string (obligatorio) |
| properties | Propiedades de la configuración del equilibrador de carga. | LoadBalancerConfigurationProperties (obligatorio) |
LoadBalancerConfigurationProperties
| Nombre | Descripción | Value |
|---|---|---|
| frontendIPConfigurations | Especifica la dirección IP de front-end que se va a usar para el equilibrador de carga. Solo se admite la dirección IP de front-end IPv4. Cada configuración del equilibrador de carga debe tener exactamente una configuración ip de front-end. | LoadBalancerFrontendIPConfiguration[] (obligatorio) |
LoadBalancerFrontendIPConfiguration
| Nombre | Descripción | Value |
|---|---|---|
| name | Nombre del recurso que es único dentro del conjunto de configuraciones ip de front-end usadas por el equilibrador de carga. Este nombre se puede usar para acceder al recurso. | string (obligatorio) |
| properties | Propiedades de la configuración ip de front-end del equilibrador de carga. | LoadBalancerFrontendIPConfigurationProperties (obligatorio) |
LoadBalancerFrontendIPConfigurationProperties
| Nombre | Descripción | Value |
|---|---|---|
| privateIPAddress | Dirección IP privada de la red virtual de la configuración de IP. | string |
| publicIPAddress | Referencia al recurso de dirección IP pública. | SubResource |
| subred | Referencia al recurso de subred de red virtual. | SubResource |
CloudServiceOsProfile
| Nombre | Descripción | Value |
|---|---|---|
| secrets | Especifica el conjunto de certificados que se deben instalar en las instancias de rol. | CloudServiceVaultSecretGroup[] |
CloudServiceVaultSecretGroup
| Nombre | Descripción | Value |
|---|---|---|
| sourceVault | Dirección URL relativa del Key Vault que contiene todos los certificados de VaultCertificates. | SubResource |
| vaultCertificates | Lista de referencias del almacén de claves en SourceVault que contienen certificados. | CloudServiceVaultCertificate[] |
CloudServiceVaultCertificate
| Nombre | Descripción | Value |
|---|---|---|
| certificateUrl | Esta es la dirección URL de un certificado que se ha cargado en Key Vault como secreto. | string |
CloudServiceRoleProfile
| Nombre | Descripción | Value |
|---|---|---|
| roles | Lista de roles para el servicio en la nube. | CloudServiceRoleProfileProperties[] |
CloudServiceRoleProfileProperties
| Nombre | Descripción | Value |
|---|---|---|
| name | Nombre del recurso. | string |
| sku | Describe la SKU del rol de servicio en la nube. | CloudServiceRoleSku |
CloudServiceRoleSku
| Nombre | Descripción | Value |
|---|---|---|
| capacity | Especifica el número de instancias de rol en el servicio en la nube. | int |
| name | Nombre de la SKU. NOTA: Si la nueva SKU no es compatible con el hardware en el que está activado el servicio en la nube, debe eliminar y volver a crear el servicio en la nube o volver a la SKU anterior. | string |
| Nivel: | Especifica el nivel del servicio en la nube. Los valores posibles son Estándar Basic |
string |
SystemData
Este objeto no contiene ninguna propiedad que se establezca durante la implementación. Todas las propiedades son ReadOnly.
Definición de recursos de plantilla de ARM
El tipo de recurso cloudServices se puede implementar con operaciones destinadas a:
- Grupos de recursos: consulte los comandos de implementación del grupo de recursos.
Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.
Formato de los recursos
Para crear un recurso Microsoft.Compute/cloudServices, agregue el siguiente json a la plantilla.
{
"type": "Microsoft.Compute/cloudServices",
"apiVersion": "2022-04-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": {}
}
Valores de propiedad
cloudServices
| Nombre | Descripción | Value |
|---|---|---|
| type | Tipo de recurso | "Microsoft.Compute/cloudServices" |
| apiVersion | La versión de la API de recursos | '2022-04-04' |
| name | El nombre del recurso | string (obligatorio) Límite de caracteres: 1-15 Caracteres válidos: No se pueden usar espacios, caracteres de control ni estos caracteres: ~ ! @ # $ % ^ & * ( ) = + _ [ ] { } \ | ; : . ' " , < > / ?No puede comenzar con un carácter de subrayado. No puede terminar con un punto ni un guion. |
| ubicación | Ubicación del recurso | string (obligatorio) |
| etiquetas | Etiquetas del recurso. | Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas. |
| properties | Propiedades del servicio en la nube | CloudServiceProperties |
| systemData | Metadatos del sistema relacionados con este recurso. | SystemData |
CloudServiceProperties
| Nombre | Descripción | Valor |
|---|---|---|
| allowModelOverride | (Opcional) Indica si las propiedades de SKU de rol (roleProfile.roles.sku) especificadas en el modelo o plantilla deben invalidar el número de instancias de rol y el tamaño de máquina virtual especificados en .cscfg y .csdef respectivamente. El valor predeterminado es false. |
bool |
| configuración | Especifica la configuración del servicio XML (.cscfg) para el servicio en la nube. | string |
| configurationUrl | Especifica una dirección URL que hace referencia a la ubicación de la configuración del servicio en Blob service. La dirección URL del paquete de servicio puede ser URI de firma de acceso compartido (SAS) desde cualquier cuenta de almacenamiento. Se trata de una propiedad de solo escritura y no se devuelve en las llamadas GET. |
string |
| extensionProfile | Describe un perfil de extensión de servicio en la nube. | CloudServiceExtensionProfile |
| networkProfile | Perfil de red para el servicio en la nube. | CloudServiceNetworkProfile |
| osProfile | Describe el perfil del sistema operativo para el servicio en la nube. | CloudServiceOsProfile |
| packageUrl | Especifica una dirección URL que hace referencia a la ubicación del paquete de Blob service. La dirección URL del paquete de servicio puede ser URI de firma de acceso compartido (SAS) desde cualquier cuenta de almacenamiento. Se trata de una propiedad de solo escritura y no se devuelve en las llamadas GET. |
string |
| roleProfile | Describe el perfil de rol para el servicio en la nube. | CloudServiceRoleProfile |
| startCloudService | (Opcional) Indica si se va a iniciar el servicio en la nube inmediatamente después de crearlo. El valor predeterminado es true.Si es false, el modelo de servicio todavía se implementa, pero el código no se ejecuta inmediatamente. En su lugar, el servicio es PoweredOff hasta que se llama a Start, en cuyo momento se iniciará el servicio. Un servicio implementado sigue incurre en cargos, incluso si está apagado. |
bool |
| upgradeMode | Modo de actualización para el servicio en la nube. Las instancias de rol se asigna para actualizar dominios cuando se implementa el servicio. Las actualizaciones se pueden iniciar manualmente en cada dominio de actualización o iniciar automáticamente en todos dominios de actualización. Los valores posibles son Automático Manual Simultánea Si no se especifica, el valor predeterminado es Auto. Si se establece en Manual, se debe llamar a PUT UpdateDomain para aplicar la actualización. Si se establece en Automático, la actualización se aplica automáticamente a cada dominio de actualización en secuencia. |
'Auto' 'Manual' "Simultáneo" |
CloudServiceExtensionProfile
| Nombre | Descripción | Valor |
|---|---|---|
| extensions | Lista de extensiones para el servicio en la nube. | Extensión[] |
Comprobación de actualización
| NOMBRE | Descripción | Value |
|---|---|---|
| name | Nombre de la extensión. | string |
| properties | Propiedades de extensión. | CloudServiceExtensionProperties |
CloudServiceExtensionProperties
| Nombre | Descripción | Value |
|---|---|---|
| autoUpgradeMinorVersion | Especifique explícitamente si la plataforma puede actualizar automáticamente typeHandlerVersion a versiones secundarias posteriores cuando estén disponibles. | bool |
| forceUpdateTag | Etiqueta para forzar la aplicación de la configuración pública y protegida proporcionada. Cambiar el valor de etiqueta permite volver a ejecutar la extensión sin cambiar ninguna de las configuraciones públicas o protegidas. Si forceUpdateTag no cambia, el controlador seguirá aplicando las actualizaciones de la configuración pública o protegida. Si no se cambia forceUpdateTag ni ninguna de las configuraciones públicas o protegidas, la extensión fluiría a la instancia de rol con el mismo número de secuencia y es necesario controlar la implementación de si se debe volver a ejecutar o no. |
string |
| protectedSettings | Configuración protegida para la extensión que se cifra antes de enviar a la instancia de rol. | |
| protectedSettingsFromKeyVault | Configuración protegida para la extensión, a la que se hace referencia mediante KeyVault, que se cifran antes de enviarse a la instancia de rol. | CloudServiceVaultAndSecretReference |
| publisher | Nombre del publicador del controlador de extensiones. | string |
| rolesAppliedTo | Lista opcional de roles para aplicar esta extensión. Si no se especifica la propiedad o se especifica '*', la extensión se aplica a todos los roles del servicio en la nube. | string[] |
| configuración | Configuración pública de la extensión. En el caso de las extensiones JSON, esta es la configuración json de la extensión. Para la extensión XML (como RDP), esta es la configuración XML de la extensión. | |
| tipo | Especifica el tipo de la extensión. | string |
| typeHandlerVersion | Especifica la versión de la extensión. Especifica la versión de la extensión. Si no se especifica este elemento o se usa un asterisco (*) como valor, se usa la versión más reciente de la extensión. Si el valor se especifica con un número de versión principal y un asterisco como número de versión secundaria (X.), se selecciona la versión secundaria más reciente de la versión principal especificada. Si se especifica un número de versión principal y un número de versión secundaria (X.Y), se selecciona la versión de extensión específica. Si se especifica una versión, se realiza una actualización automática en la instancia de rol. | string |
CloudServiceVaultAndSecretReference
| Nombre | Descripción | Value |
|---|---|---|
| secretUrl | Dirección URL secreta que contiene la configuración protegida de la extensión | string |
| sourceVault | Identificador de recurso de ARM del Key Vault | SubResource |
SubResource
| Nombre | Descripción | Value |
|---|---|---|
| id | Id. de recurso | string |
CloudServiceNetworkProfile
| Nombre | Descripción | Value |
|---|---|---|
| loadBalancerConfigurations | Lista de configuraciones del equilibrador de carga. El servicio en la nube puede tener hasta dos configuraciones del equilibrador de carga, correspondientes a un Load Balancer público y a un Load Balancer interno. | LoadBalancerConfiguration[] |
| slotType | Tipo de ranura para el servicio en la nube. Los valores posibles son Producción Ensayo Si no se especifica, el valor predeterminado es Production. |
'Producción' "Ensayo" |
| swappableCloudService | Referencia de identificador del servicio en la nube que contiene la dirección IP de destino con la que el servicio en la nube sujeto puede realizar un intercambio. Esta propiedad no se puede actualizar una vez establecida. El servicio en la nube intercambiable al que hace referencia este identificador debe estar presente; de lo contrario, se producirá un error. | SubResource |
LoadBalancerConfiguration
| Nombre | Descripción | Value |
|---|---|---|
| id | Id. de recurso | string |
| name | Nombre del equilibrador de carga | string (obligatorio) |
| properties | Propiedades de la configuración del equilibrador de carga. | LoadBalancerConfigurationProperties (obligatorio) |
LoadBalancerConfigurationProperties
| Nombre | Descripción | Valor |
|---|---|---|
| frontendIPConfigurations | Especifica la dirección IP de front-end que se usará para el equilibrador de carga. Solo se admite la dirección IP de front-end IPv4. Cada configuración del equilibrador de carga debe tener exactamente una configuración ip de front-end. | LoadBalancerFrontendIPConfiguration[] (obligatorio) |
LoadBalancerFrontendIPConfiguration
| Nombre | Descripción | Value |
|---|---|---|
| name | Nombre del recurso que es único dentro del conjunto de configuraciones ip de front-end usadas por el equilibrador de carga. Este nombre se puede usar para acceder al recurso. | string (obligatorio) |
| properties | Propiedades de la configuración ip de front-end del equilibrador de carga. | LoadBalancerFrontendIPConfigurationProperties (obligatorio) |
LoadBalancerFrontendIPConfigurationProperties
| Nombre | Descripción | Valor |
|---|---|---|
| privateIPAddress | La dirección IP privada de la red virtual de la configuración de IP. | string |
| publicIPAddress | Referencia al recurso de dirección IP pública. | SubResource |
| subred | Referencia al recurso de subred de red virtual. | SubResource |
CloudServiceOsProfile
| Nombre | Descripción | Valor |
|---|---|---|
| secrets | Especifica el conjunto de certificados que se deben instalar en las instancias de rol. | CloudServiceVaultSecretGroup[] |
CloudServiceVaultSecretGroup
| Nombre | Descripción | Valor |
|---|---|---|
| sourceVault | Dirección URL relativa del Key Vault que contiene todos los certificados de VaultCertificates. | SubResource |
| vaultCertificates | Lista de referencias del almacén de claves en SourceVault que contienen certificados. | CloudServiceVaultCertificate[] |
CloudServiceVaultCertificate
| Nombre | Descripción | Valor |
|---|---|---|
| certificateUrl | Esta es la dirección URL de un certificado que se ha cargado en Key Vault como secreto. | string |
CloudServiceRoleProfile
| Nombre | Descripción | Valor |
|---|---|---|
| roles | Lista de roles para el servicio en la nube. | CloudServiceRoleProfileProperties[] |
CloudServiceRoleProfileProperties
| Nombre | Descripción | Value |
|---|---|---|
| name | Nombre del recurso. | string |
| sku | Describe la SKU del rol de servicio en la nube. | CloudServiceRoleSku |
CloudServiceRoleSku
| Nombre | Descripción | Valor |
|---|---|---|
| capacity | Especifica el número de instancias de rol en el servicio en la nube. | int |
| name | Nombre de la SKU. NOTA: Si la nueva SKU no se admite en el hardware en el que se encuentra actualmente el servicio en la nube, debe eliminar y volver a crear el servicio en la nube o volver a la SKU anterior. | string |
| Nivel: | Especifica el nivel del servicio en la nube. Los valores posibles son Estándar Basic |
string |
SystemData
Este objeto no contiene ninguna propiedad que se va a establecer durante la implementación. Todas las propiedades son ReadOnly.
Definición de recursos de Terraform (proveedor AzAPI)
El tipo de recurso cloudServices se puede implementar con operaciones destinadas a:
- Grupos de recursos
Para obtener una lista de las propiedades modificadas en cada versión de api, consulte registro de cambios.
Formato de los recursos
Para crear un recurso Microsoft.Compute/cloudServices, agregue el siguiente terraform a la plantilla.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Compute/cloudServices@2022-04-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 = {}
})
}
Valores de propiedad
cloudServices
| Nombre | Descripción | Value |
|---|---|---|
| type | Tipo de recurso | "Microsoft.Compute/cloudServices@2022-04-04" |
| name | El nombre del recurso | string (obligatorio) Límite de caracteres: 1-15 Caracteres válidos: No se pueden usar espacios, caracteres de control ni estos caracteres: ~ ! @ # $ % ^ & * ( ) = + _ [ ] { } \ | ; : . ' " , < > / ?No puede comenzar con un carácter de subrayado. No puede terminar con un punto ni un guion. |
| ubicación | Ubicación del recurso | string (obligatorio) |
| parent_id | Para realizar la implementación en un grupo de recursos, use el identificador de ese grupo de recursos. | string (obligatorio) |
| etiquetas | Etiquetas del recurso. | Diccionario de nombres y valores de etiqueta. |
| properties | Propiedades del servicio en la nube | CloudServiceProperties |
| systemData | Metadatos del sistema relacionados con este recurso. | SystemData |
CloudServiceProperties
| Nombre | Descripción | Valor |
|---|---|---|
| allowModelOverride | (Opcional) Indica si las propiedades de SKU de rol (roleProfile.roles.sku) especificadas en el modelo o plantilla deben invalidar el número de instancias de rol y el tamaño de máquina virtual especificados en .cscfg y .csdef respectivamente. El valor predeterminado es false. |
bool |
| configuración | Especifica la configuración del servicio XML (.cscfg) para el servicio en la nube. | string |
| configurationUrl | Especifica una dirección URL que hace referencia a la ubicación de la configuración de servicio en Blob service. La dirección URL del paquete de servicio puede ser URI de firma de acceso compartido (SAS) desde cualquier cuenta de almacenamiento. Se trata de una propiedad de solo escritura y no se devuelve en las llamadas GET. |
string |
| extensionProfile | Describe un perfil de extensión de servicio en la nube. | CloudServiceExtensionProfile |
| networkProfile | Perfil de red para el servicio en la nube. | CloudServiceNetworkProfile |
| osProfile | Describe el perfil del sistema operativo para el servicio en la nube. | CloudServiceOsProfile |
| packageUrl | Especifica una dirección URL que hace referencia a la ubicación del paquete de Blob service. La dirección URL del paquete de servicio puede ser URI de firma de acceso compartido (SAS) desde cualquier cuenta de almacenamiento. Se trata de una propiedad de solo escritura y no se devuelve en las llamadas GET. |
string |
| roleProfile | Describe el perfil de rol para el servicio en la nube. | CloudServiceRoleProfile |
| startCloudService | (Opcional) Indica si se debe iniciar el servicio en la nube inmediatamente después de crearlo. El valor predeterminado es true.Si es false, el modelo de servicio se sigue implementando, pero el código no se ejecuta inmediatamente. En su lugar, el servicio es PoweredOff hasta que se llama a Start, en cuyo momento se iniciará el servicio. Un servicio implementado sigue incurr en cargos, incluso si está apagado. |
bool |
| upgradeMode | Modo de actualización para el servicio en la nube. Las instancias de rol se asigna para actualizar dominios cuando se implementa el servicio. Las actualizaciones se pueden iniciar manualmente en cada dominio de actualización o iniciar automáticamente en todos dominios de actualización. Los valores posibles son Automático Manual Simultánea Si no se especifica, el valor predeterminado es Auto. Si se establece en Manual, se debe llamar a PUT UpdateDomain para aplicar la actualización. Si se establece en Automático, la actualización se aplica automáticamente a cada dominio de actualización en secuencia. |
"Automático" "Manual" "Simultánea" |
CloudServiceExtensionProfile
| Nombre | Descripción | Valor |
|---|---|---|
| extensions | Lista de extensiones para el servicio en la nube. | Extensión[] |
Comprobación de actualización
| NOMBRE | Descripción | Value |
|---|---|---|
| name | Nombre de la extensión. | string |
| properties | Propiedades de extensión. | CloudServiceExtensionProperties |
CloudServiceExtensionProperties
| Nombre | Descripción | Valor |
|---|---|---|
| autoUpgradeMinorVersion | Especifique explícitamente si la plataforma puede actualizar automáticamente typeHandlerVersion a versiones secundarias superiores cuando estén disponibles. | bool |
| forceUpdateTag | Etiqueta para forzar la aplicación de la configuración pública y protegida proporcionada. Cambiar el valor de etiqueta permite volver a ejecutar la extensión sin cambiar ninguna de las configuraciones públicas o protegidas. Si forceUpdateTag no se cambia, el controlador seguirá aplicando las actualizaciones de la configuración pública o protegida. Si ni forceUpdateTag ni ninguna de las configuraciones públicas o protegidas cambian, la extensión fluiría a la instancia de rol con el mismo número de secuencia y es necesario controlar la implementación de si volver a ejecutarla o no. |
string |
| protectedSettings | Configuración protegida para la extensión que se cifra antes de enviar a la instancia de rol. | |
| protectedSettingsFromKeyVault | Configuración protegida para la extensión, a la que se hace referencia mediante KeyVault, que se cifran antes de enviarse a la instancia de rol. | CloudServiceVaultAndSecretReference |
| publisher | Nombre del publicador de controladores de extensión. | string |
| rolesAppliedTo | Lista opcional de roles para aplicar esta extensión. Si no se especifica la propiedad o se especifica '*', la extensión se aplica a todos los roles del servicio en la nube. | string[] |
| configuración | Configuración pública de la extensión. En el caso de las extensiones JSON, esta es la configuración json de la extensión. Para la extensión XML (como RDP), esta es la configuración XML de la extensión. | |
| tipo | Especifica el tipo de la extensión. | string |
| typeHandlerVersion | Especifica la versión de la extensión. Especifica la versión de la extensión. Si no se especifica este elemento o se usa un asterisco (*) como valor, se usa la versión más reciente de la extensión. Si el valor se especifica con un número de versión principal y un asterisco como número de versión secundaria (X.), se selecciona la versión secundaria más reciente de la versión principal especificada. Si se especifica un número de versión principal y un número de versión secundaria (X.Y), se selecciona la versión de extensión específica. Si se especifica una versión, se realiza una actualización automática en la instancia de rol. | string |
CloudServiceVaultAndSecretReference
| Nombre | Descripción | Valor |
|---|---|---|
| secretUrl | Dirección URL secreta que contiene la configuración protegida de la extensión | string |
| sourceVault | Identificador de recurso de ARM del Key Vault | SubResource |
SubResource
| Nombre | Descripción | Value |
|---|---|---|
| id | Id. de recurso | string |
CloudServiceNetworkProfile
| Nombre | Descripción | Valor |
|---|---|---|
| loadBalancerConfigurations | Lista de configuraciones del equilibrador de carga. El servicio en la nube puede tener hasta dos configuraciones de equilibrador de carga, que corresponden a un Load Balancer público y a un Load Balancer interno. | LoadBalancerConfiguration[] |
| slotType | Tipo de ranura para el servicio en la nube. Los valores posibles son Producción Ensayo Si no se especifica, el valor predeterminado es Production. |
"Production" "Ensayo" |
| swappableCloudService | Referencia de identificador del servicio en la nube que contiene la dirección IP de destino con la que el servicio en la nube del asunto puede realizar un intercambio. Esta propiedad no se puede actualizar una vez establecida. El servicio en la nube intercambiable al que hace referencia este identificador debe estar presente; de lo contrario, se producirá un error. | SubResource |
LoadBalancerConfiguration
| Nombre | Descripción | Value |
|---|---|---|
| id | Id. de recurso | string |
| name | Nombre del equilibrador de carga | string (obligatorio) |
| properties | Propiedades de la configuración del equilibrador de carga. | LoadBalancerConfigurationProperties (obligatorio) |
LoadBalancerConfigurationProperties
| Nombre | Descripción | Valor |
|---|---|---|
| frontendIPConfigurations | Especifica la dirección IP de front-end que se va a usar para el equilibrador de carga. Solo se admite la dirección IP de front-end IPv4. Cada configuración del equilibrador de carga debe tener exactamente una configuración ip de front-end. | LoadBalancerFrontendIPConfiguration[] (obligatorio) |
LoadBalancerFrontendIPConfiguration
| Nombre | Descripción | Value |
|---|---|---|
| name | Nombre del recurso que es único dentro del conjunto de configuraciones ip de front-end usadas por el equilibrador de carga. Este nombre se puede usar para acceder al recurso. | string (obligatorio) |
| properties | Propiedades de la configuración ip de front-end del equilibrador de carga. | LoadBalancerFrontendIPConfigurationProperties (obligatorio) |
LoadBalancerFrontendIPConfigurationProperties
| Nombre | Descripción | Valor |
|---|---|---|
| privateIPAddress | La dirección IP privada de la red virtual de la configuración de IP. | string |
| publicIPAddress | Referencia al recurso de dirección IP pública. | SubResource |
| subred | Referencia al recurso de subred de red virtual. | SubResource |
CloudServiceOsProfile
| Nombre | Descripción | Valor |
|---|---|---|
| secrets | Especifica el conjunto de certificados que se deben instalar en las instancias de rol. | CloudServiceVaultSecretGroup[] |
CloudServiceVaultSecretGroup
| Nombre | Descripción | Valor |
|---|---|---|
| sourceVault | Dirección URL relativa del Key Vault que contiene todos los certificados de VaultCertificates. | SubResource |
| vaultCertificates | Lista de referencias del almacén de claves en SourceVault que contienen certificados. | CloudServiceVaultCertificate[] |
CloudServiceVaultCertificate
| Nombre | Descripción | Valor |
|---|---|---|
| certificateUrl | Esta es la dirección URL de un certificado que se ha cargado en Key Vault como secreto. | string |
CloudServiceRoleProfile
| Nombre | Descripción | Valor |
|---|---|---|
| roles | Lista de roles para el servicio en la nube. | CloudServiceRoleProfileProperties[] |
CloudServiceRoleProfileProperties
| Nombre | Descripción | Value |
|---|---|---|
| name | Nombre del recurso. | string |
| sku | Describe la SKU del rol de servicio en la nube. | CloudServiceRoleSku |
CloudServiceRoleSku
| Nombre | Descripción | Valor |
|---|---|---|
| capacity | Especifica el número de instancias de rol en el servicio en la nube. | int |
| name | Nombre de la SKU. NOTA: Si la nueva SKU no se admite en el hardware en el que se encuentra actualmente el servicio en la nube, debe eliminar y volver a crear el servicio en la nube o volver a la SKU anterior. | string |
| Nivel: | Especifica el nivel del servicio en la nube. Los valores posibles son Estándar Basic |
string |
SystemData
Este objeto no contiene ninguna propiedad que se va a establecer durante la implementación. Todas las propiedades son ReadOnly.
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de