Serviço/back-ends Microsoft.ApiManagement 2023-09-01-preview
Definição de recurso do Bicep
O tipo de recurso de serviço/back-ends pode ser implantado com operações de destino:
- 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 de log de alterações.
Formato de recurso
Para criar um recurso Microsoft.ApiManagement/service/back-ends, adicione o Bicep a seguir ao modelo.
resource symbolicname 'Microsoft.ApiManagement/service/backends@2023-09-01-preview' = {
name: 'string'
parent: resourceSymbolicName
properties: {
circuitBreaker: {
rules: [
{
acceptRetryAfter: bool
failureCondition: {
count: int
errorReasons: 'string'
interval: 'string'
percentage: int
statusCodeRanges: [
{
max: int
min: int
}
]
}
name: 'string'
tripDuration: 'string'
}
]
}
credentials: {
authorization: {
parameter: 'string'
scheme: 'string'
}
certificate: [
'string'
]
certificateIds: [
'string'
]
header: {
{customized property}: [
'string'
]
}
query: {
{customized property}: [
'string'
]
}
}
description: 'string'
pool: {
services: [
{
id: 'string'
priority: int
weight: int
}
]
}
properties: {
serviceFabricCluster: {
clientCertificateId: 'string'
clientCertificatethumbprint: 'string'
managementEndpoints: [
'string'
]
maxPartitionResolutionRetries: int
serverCertificateThumbprints: [
'string'
]
serverX509Names: [
{
issuerCertificateThumbprint: 'string'
name: 'string'
}
]
}
}
protocol: 'string'
proxy: {
password: 'string'
url: 'string'
username: 'string'
}
resourceId: 'string'
title: 'string'
tls: {
validateCertificateChain: bool
validateCertificateName: bool
}
type: 'string'
url: 'string'
}
}
Valores de propriedade
service/back-ends
Nome | Descrição | Valor |
---|---|---|
nome | O nome do recurso Veja como definir nomes e tipos para recursos filho no Bicep. |
cadeia de caracteres (obrigatório) Limite de caracteres: 1 a 80 Caracteres válidos: Alfanuméricos e hifens. Comece com letra e termine com alfanumérico. |
pai | No Bicep, você pode especificar o recurso pai para um recurso filho. Você só precisa adicionar essa propriedade quando o recurso filho é declarado fora do recurso pai. Para obter mais informações, consulte recurso filho fora do recurso pai. |
Nome simbólico do recurso do tipo: de serviço |
Propriedades | Propriedades do contrato de entidade de back-end. | BackendContractProperties |
BackendContractProperties
BackendCircuitBreaker
Nome | Descrição | Valor |
---|---|---|
réguas | As regras para tropeçar no back-end. |
CircuitBreakerRule [] Restrições: Comprimento máximo = 15 |
CircuitBreakerRule
Nome | Descrição | Valor |
---|---|---|
acceptRetryAfter | sinalizador para aceitar Retry-After cabeçalho do back-end. | Bool |
failureCondition | As condições para despir o disjuntor. | |
nome | O nome da regra. | corda |
tripDuration | A duração para a qual o circuito será tropeçado. | corda |
CircuitBreakerFailureCondition
Nome | Descrição | Valor |
---|---|---|
contar | O limite para abrir o circuito. | int |
errorReasons | Os motivos de erro que são considerados como falha. | corda Restrições: Comprimento máximo = 10 |
intervalo | O intervalo durante o qual as falhas são contadas. | corda |
porcentagem | O limite para abrir o circuito. | int |
statusCodeRanges | Os intervalos de código de status considerados como falha. |
FailureStatusCodeRange[] Restrições: Comprimento máximo = 10 |
FailureStatusCodeRange
Nome | Descrição | Valor |
---|---|---|
Max | O código de status http máximo. | int Restrições: Valor mínimo = 200 Valor máximo = 599 |
Min | O código de status http mínimo. | int Restrições: Valor mínimo = 200 Valor máximo = 599 |
BackendCredentialsContract
Nome | Descrição | Valor |
---|---|---|
autorização | Autenticação de cabeçalho de autorização | BackendAuthorizationHeaderCredentials |
certificado | Lista de impressões digitais do certificado do cliente. Serão ignorados se certificatesIds forem fornecidos. | string[] Restrições: Comprimento máximo = 32 |
certificateIds | Lista de IDs de certificado do cliente. | string[] Restrições: Comprimento máximo = 32 |
cabeçalho | Descrição do parâmetro de cabeçalho. | BackendCredentialsContractHeader |
consulta | Descrição do parâmetro de consulta. | BackendCredentialsContractQuery |
BackendAuthorizationHeaderCredentials
Nome | Descrição | Valor |
---|---|---|
parâmetro | Valor do parâmetro de autenticação. | cadeia de caracteres (obrigatório) Restrições: Comprimento mínimo = 1 Comprimento máximo = 300 |
esquema | Nome do Esquema de Autenticação. | cadeia de caracteres (obrigatório) Restrições: Comprimento mínimo = 1 Comprimento máximo = 100 |
BackendCredentialsContractHeader
Nome | Descrição | Valor |
---|---|---|
{propriedade personalizada} | string[] |
BackendCredentialsContractQuery
Nome | Descrição | Valor |
---|---|---|
{propriedade personalizada} | string[] |
BackendBaseParametersPool
Nome | Descrição | Valor |
---|---|---|
Serviços | A lista de entidades de back-end que pertencem a um pool. |
BackendPoolItem [] Restrições: Comprimento mínimo = 1 |
BackendPoolItem
Nome | Descrição | Valor |
---|---|---|
id | A ID exclusiva do ARM da entidade de back-end. A ID do ARM deve se referir a uma entidade de back-end já existente. | cadeia de caracteres (obrigatório) |
prioridade | A prioridade da entidade de back-end no pool de back-end. Deve estar entre 0 e 100. Ele também poderá ser nulo se o valor não for especificado. | int Restrições: Valor mínimo = 0 Valor máximo = 100 |
peso | O peso da entidade de back-end no pool de back-end. Deve estar entre 0 e 100. Ele também poderá ser nulo se o valor não for especificado. | int Restrições: Valor mínimo = 0 Valor máximo = 100 |
BackendProperties
Nome | Descrição | Valor |
---|---|---|
serviceFabricCluster | Propriedades do cluster do Service Fabric de back-end | BackendServiceFabricClusterProperties |
BackendServiceFabricClusterProperties
X509CertificateName
Nome | Descrição | Valor |
---|---|---|
issuerCertificateThumbprint | Impressão digital para o emissor do certificado. | corda |
nome | Nome comum do certificado. | corda |
BackendProxyContract
Nome | Descrição | Valor |
---|---|---|
senha | Senha para se conectar ao Servidor WebProxy | corda |
url | Propriedade AbsoluteUri do Servidor WebProxy, que inclui todo o URI armazenado na instância do Uri, incluindo todos os fragmentos e cadeias de caracteres de consulta. | cadeia de caracteres (obrigatório) Restrições: Comprimento mínimo = 1 Comprimento máximo = 2000 |
nome de usuário | Nome de usuário para se conectar ao servidor WebProxy | corda |
BackendTlsProperties
Nome | Descrição | Valor |
---|---|---|
validateCertificateChain | Sinalizador indicando se a validação da cadeia de certificados SSL deve ser feita ao usar certificados autoassinados para esse host de back-end. | Bool |
validateCertificateName | Sinalizador indicando se a validação do nome do certificado SSL deve ser feita ao usar certificados autoassinados para esse host de back-end. | Bool |
Definição de recurso de modelo do ARM
O tipo de recurso de serviço/back-ends pode ser implantado com operações de destino:
- 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 de log de alterações.
Formato de recurso
Para criar um recurso Microsoft.ApiManagement/service/back-ends, adicione o JSON a seguir ao modelo.
{
"type": "Microsoft.ApiManagement/service/backends",
"apiVersion": "2023-09-01-preview",
"name": "string",
"properties": {
"circuitBreaker": {
"rules": [
{
"acceptRetryAfter": "bool",
"failureCondition": {
"count": "int",
"errorReasons": "string",
"interval": "string",
"percentage": "int",
"statusCodeRanges": [
{
"max": "int",
"min": "int"
}
]
},
"name": "string",
"tripDuration": "string"
}
]
},
"credentials": {
"authorization": {
"parameter": "string",
"scheme": "string"
},
"certificate": [ "string" ],
"certificateIds": [ "string" ],
"header": {
"{customized property}": [ "string" ]
},
"query": {
"{customized property}": [ "string" ]
}
},
"description": "string",
"pool": {
"services": [
{
"id": "string",
"priority": "int",
"weight": "int"
}
]
},
"properties": {
"serviceFabricCluster": {
"clientCertificateId": "string",
"clientCertificatethumbprint": "string",
"managementEndpoints": [ "string" ],
"maxPartitionResolutionRetries": "int",
"serverCertificateThumbprints": [ "string" ],
"serverX509Names": [
{
"issuerCertificateThumbprint": "string",
"name": "string"
}
]
}
},
"protocol": "string",
"proxy": {
"password": "string",
"url": "string",
"username": "string"
},
"resourceId": "string",
"title": "string",
"tls": {
"validateCertificateChain": "bool",
"validateCertificateName": "bool"
},
"type": "string",
"url": "string"
}
}
Valores de propriedade
service/back-ends
Nome | Descrição | Valor |
---|---|---|
tipo | O tipo de recurso | 'Microsoft.ApiManagement/service/backends' |
apiVersion | A versão da API do recurso | '2023-09-01-preview' |
nome | O nome do recurso Veja como definir nomes e tipos para recursos filho em modelos do ARM JSON. |
cadeia de caracteres (obrigatório) Limite de caracteres: 1 a 80 Caracteres válidos: Alfanuméricos e hifens. Comece com letra e termine com alfanumérico. |
Propriedades | Propriedades do contrato de entidade de back-end. | BackendContractProperties |
BackendContractProperties
BackendCircuitBreaker
Nome | Descrição | Valor |
---|---|---|
réguas | As regras para tropeçar no back-end. |
CircuitBreakerRule [] Restrições: Comprimento máximo = 15 |
CircuitBreakerRule
Nome | Descrição | Valor |
---|---|---|
acceptRetryAfter | sinalizador para aceitar Retry-After cabeçalho do back-end. | Bool |
failureCondition | As condições para despir o disjuntor. | |
nome | O nome da regra. | corda |
tripDuration | A duração para a qual o circuito será tropeçado. | corda |
CircuitBreakerFailureCondition
Nome | Descrição | Valor |
---|---|---|
contar | O limite para abrir o circuito. | int |
errorReasons | Os motivos de erro que são considerados como falha. | corda Restrições: Comprimento máximo = 10 |
intervalo | O intervalo durante o qual as falhas são contadas. | corda |
porcentagem | O limite para abrir o circuito. | int |
statusCodeRanges | Os intervalos de código de status considerados como falha. |
FailureStatusCodeRange[] Restrições: Comprimento máximo = 10 |
FailureStatusCodeRange
Nome | Descrição | Valor |
---|---|---|
Max | O código de status http máximo. | int Restrições: Valor mínimo = 200 Valor máximo = 599 |
Min | O código de status http mínimo. | int Restrições: Valor mínimo = 200 Valor máximo = 599 |
BackendCredentialsContract
Nome | Descrição | Valor |
---|---|---|
autorização | Autenticação de cabeçalho de autorização | BackendAuthorizationHeaderCredentials |
certificado | Lista de impressões digitais do certificado do cliente. Serão ignorados se certificatesIds forem fornecidos. | string[] Restrições: Comprimento máximo = 32 |
certificateIds | Lista de IDs de certificado do cliente. | string[] Restrições: Comprimento máximo = 32 |
cabeçalho | Descrição do parâmetro de cabeçalho. | BackendCredentialsContractHeader |
consulta | Descrição do parâmetro de consulta. | BackendCredentialsContractQuery |
BackendAuthorizationHeaderCredentials
Nome | Descrição | Valor |
---|---|---|
parâmetro | Valor do parâmetro de autenticação. | cadeia de caracteres (obrigatório) Restrições: Comprimento mínimo = 1 Comprimento máximo = 300 |
esquema | Nome do Esquema de Autenticação. | cadeia de caracteres (obrigatório) Restrições: Comprimento mínimo = 1 Comprimento máximo = 100 |
BackendCredentialsContractHeader
Nome | Descrição | Valor |
---|---|---|
{propriedade personalizada} | string[] |
BackendCredentialsContractQuery
Nome | Descrição | Valor |
---|---|---|
{propriedade personalizada} | string[] |
BackendBaseParametersPool
Nome | Descrição | Valor |
---|---|---|
Serviços | A lista de entidades de back-end que pertencem a um pool. |
BackendPoolItem [] Restrições: Comprimento mínimo = 1 |
BackendPoolItem
Nome | Descrição | Valor |
---|---|---|
id | A ID exclusiva do ARM da entidade de back-end. A ID do ARM deve se referir a uma entidade de back-end já existente. | cadeia de caracteres (obrigatório) |
prioridade | A prioridade da entidade de back-end no pool de back-end. Deve estar entre 0 e 100. Ele também poderá ser nulo se o valor não for especificado. | int Restrições: Valor mínimo = 0 Valor máximo = 100 |
peso | O peso da entidade de back-end no pool de back-end. Deve estar entre 0 e 100. Ele também poderá ser nulo se o valor não for especificado. | int Restrições: Valor mínimo = 0 Valor máximo = 100 |
BackendProperties
Nome | Descrição | Valor |
---|---|---|
serviceFabricCluster | Propriedades do cluster do Service Fabric de back-end | BackendServiceFabricClusterProperties |
BackendServiceFabricClusterProperties
X509CertificateName
Nome | Descrição | Valor |
---|---|---|
issuerCertificateThumbprint | Impressão digital para o emissor do certificado. | corda |
nome | Nome comum do certificado. | corda |
BackendProxyContract
Nome | Descrição | Valor |
---|---|---|
senha | Senha para se conectar ao Servidor WebProxy | corda |
url | Propriedade AbsoluteUri do Servidor WebProxy, que inclui todo o URI armazenado na instância do Uri, incluindo todos os fragmentos e cadeias de caracteres de consulta. | cadeia de caracteres (obrigatório) Restrições: Comprimento mínimo = 1 Comprimento máximo = 2000 |
nome de usuário | Nome de usuário para se conectar ao servidor WebProxy | corda |
BackendTlsProperties
Nome | Descrição | Valor |
---|---|---|
validateCertificateChain | Sinalizador indicando se a validação da cadeia de certificados SSL deve ser feita ao usar certificados autoassinados para esse host de back-end. | Bool |
validateCertificateName | Sinalizador indicando se a validação do nome do certificado SSL deve ser feita ao usar certificados autoassinados para esse host de back-end. | Bool |
Definição de recurso do Terraform (provedor de AzAPI)
O tipo de recurso de serviço/back-ends pode ser implantado com operações de destino:
- grupos de recursos
Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.
Formato de recurso
Para criar um recurso Microsoft.ApiManagement/service/back-ends, adicione o Terraform a seguir ao seu modelo.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.ApiManagement/service/backends@2023-09-01-preview"
name = "string"
parent_id = "string"
body = jsonencode({
properties = {
circuitBreaker = {
rules = [
{
acceptRetryAfter = bool
failureCondition = {
count = int
errorReasons = "string"
interval = "string"
percentage = int
statusCodeRanges = [
{
max = int
min = int
}
]
}
name = "string"
tripDuration = "string"
}
]
}
credentials = {
authorization = {
parameter = "string"
scheme = "string"
}
certificate = [
"string"
]
certificateIds = [
"string"
]
header = {
{customized property} = [
"string"
]
}
query = {
{customized property} = [
"string"
]
}
}
description = "string"
pool = {
services = [
{
id = "string"
priority = int
weight = int
}
]
}
properties = {
serviceFabricCluster = {
clientCertificateId = "string"
clientCertificatethumbprint = "string"
managementEndpoints = [
"string"
]
maxPartitionResolutionRetries = int
serverCertificateThumbprints = [
"string"
]
serverX509Names = [
{
issuerCertificateThumbprint = "string"
name = "string"
}
]
}
}
protocol = "string"
proxy = {
password = "string"
url = "string"
username = "string"
}
resourceId = "string"
title = "string"
tls = {
validateCertificateChain = bool
validateCertificateName = bool
}
type = "string"
url = "string"
}
})
}
Valores de propriedade
service/back-ends
Nome | Descrição | Valor |
---|---|---|
tipo | O tipo de recurso | "Microsoft.ApiManagement/service/backends@2023-09-01-preview" |
nome | O nome do recurso | cadeia de caracteres (obrigatório) Limite de caracteres: 1 a 80 Caracteres válidos: Alfanuméricos e hifens. Comece com letra e termine com alfanumérico. |
parent_id | A ID do recurso que é o pai desse recurso. | ID do recurso do tipo: serviço |
Propriedades | Propriedades do contrato de entidade de back-end. | BackendContractProperties |
BackendContractProperties
BackendCircuitBreaker
Nome | Descrição | Valor |
---|---|---|
réguas | As regras para tropeçar no back-end. |
CircuitBreakerRule [] Restrições: Comprimento máximo = 15 |
CircuitBreakerRule
Nome | Descrição | Valor |
---|---|---|
acceptRetryAfter | sinalizador para aceitar Retry-After cabeçalho do back-end. | Bool |
failureCondition | As condições para despir o disjuntor. | |
nome | O nome da regra. | corda |
tripDuration | A duração para a qual o circuito será tropeçado. | corda |
CircuitBreakerFailureCondition
Nome | Descrição | Valor |
---|---|---|
contar | O limite para abrir o circuito. | int |
errorReasons | Os motivos de erro que são considerados como falha. | corda Restrições: Comprimento máximo = 10 |
intervalo | O intervalo durante o qual as falhas são contadas. | corda |
porcentagem | O limite para abrir o circuito. | int |
statusCodeRanges | Os intervalos de código de status considerados como falha. |
FailureStatusCodeRange[] Restrições: Comprimento máximo = 10 |
FailureStatusCodeRange
Nome | Descrição | Valor |
---|---|---|
Max | O código de status http máximo. | int Restrições: Valor mínimo = 200 Valor máximo = 599 |
Min | O código de status http mínimo. | int Restrições: Valor mínimo = 200 Valor máximo = 599 |
BackendCredentialsContract
Nome | Descrição | Valor |
---|---|---|
autorização | Autenticação de cabeçalho de autorização | BackendAuthorizationHeaderCredentials |
certificado | Lista de impressões digitais do certificado do cliente. Serão ignorados se certificatesIds forem fornecidos. | string[] Restrições: Comprimento máximo = 32 |
certificateIds | Lista de IDs de certificado do cliente. | string[] Restrições: Comprimento máximo = 32 |
cabeçalho | Descrição do parâmetro de cabeçalho. | BackendCredentialsContractHeader |
consulta | Descrição do parâmetro de consulta. | BackendCredentialsContractQuery |
BackendAuthorizationHeaderCredentials
Nome | Descrição | Valor |
---|---|---|
parâmetro | Valor do parâmetro de autenticação. | cadeia de caracteres (obrigatório) Restrições: Comprimento mínimo = 1 Comprimento máximo = 300 |
esquema | Nome do Esquema de Autenticação. | cadeia de caracteres (obrigatório) Restrições: Comprimento mínimo = 1 Comprimento máximo = 100 |
BackendCredentialsContractHeader
Nome | Descrição | Valor |
---|---|---|
{propriedade personalizada} | string[] |
BackendCredentialsContractQuery
Nome | Descrição | Valor |
---|---|---|
{propriedade personalizada} | string[] |
BackendBaseParametersPool
Nome | Descrição | Valor |
---|---|---|
Serviços | A lista de entidades de back-end que pertencem a um pool. |
BackendPoolItem [] Restrições: Comprimento mínimo = 1 |
BackendPoolItem
Nome | Descrição | Valor |
---|---|---|
id | A ID exclusiva do ARM da entidade de back-end. A ID do ARM deve se referir a uma entidade de back-end já existente. | cadeia de caracteres (obrigatório) |
prioridade | A prioridade da entidade de back-end no pool de back-end. Deve estar entre 0 e 100. Ele também poderá ser nulo se o valor não for especificado. | int Restrições: Valor mínimo = 0 Valor máximo = 100 |
peso | O peso da entidade de back-end no pool de back-end. Deve estar entre 0 e 100. Ele também poderá ser nulo se o valor não for especificado. | int Restrições: Valor mínimo = 0 Valor máximo = 100 |
BackendProperties
Nome | Descrição | Valor |
---|---|---|
serviceFabricCluster | Propriedades do cluster do Service Fabric de back-end | BackendServiceFabricClusterProperties |
BackendServiceFabricClusterProperties
X509CertificateName
Nome | Descrição | Valor |
---|---|---|
issuerCertificateThumbprint | Impressão digital para o emissor do certificado. | corda |
nome | Nome comum do certificado. | corda |
BackendProxyContract
Nome | Descrição | Valor |
---|---|---|
senha | Senha para se conectar ao Servidor WebProxy | corda |
url | Propriedade AbsoluteUri do Servidor WebProxy, que inclui todo o URI armazenado na instância do Uri, incluindo todos os fragmentos e cadeias de caracteres de consulta. | cadeia de caracteres (obrigatório) Restrições: Comprimento mínimo = 1 Comprimento máximo = 2000 |
nome de usuário | Nome de usuário para se conectar ao servidor WebProxy | corda |
BackendTlsProperties
Nome | Descrição | Valor |
---|---|---|
validateCertificateChain | Sinalizador indicando se a validação da cadeia de certificados SSL deve ser feita ao usar certificados autoassinados para esse host de back-end. | Bool |
validateCertificateName | Sinalizador indicando se a validação do nome do certificado SSL deve ser feita ao usar certificados autoassinados para esse host de back-end. | Bool |