Partilhar via

Serviço/apis Microsoft.ApiManagement 2017-03-01

  • Artigo

Definição de recursos do bíceps

O tipo de recurso service/apis pode ser implantado com operações que visam:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.ApiManagement/service/apis, adicione o seguinte Bicep ao seu modelo.

resource symbolicname 'Microsoft.ApiManagement/service/apis@2017-03-01' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    apiRevision: 'string'
    apiVersion: 'string'
    apiVersionSet: {
      properties: {
        description: 'string'
        displayName: 'string'
        versionHeaderName: 'string'
        versioningScheme: 'string'
        versionQueryName: 'string'
      }
    }
    apiVersionSetId: 'string'
    authenticationSettings: {
      oAuth2: {
        authorizationServerId: 'string'
        scope: 'string'
      }
    }
    contentFormat: 'string'
    contentValue: 'string'
    description: 'string'
    displayName: 'string'
    path: 'string'
    protocols: [
      'string'
    ]
    serviceUrl: 'string'
    subscriptionKeyParameterNames: {
      header: 'string'
      query: 'string'
    }
    type: 'string'
    wsdlSelector: {
      wsdlEndpointName: 'string'
      wsdlServiceName: 'string'
    }
  }
}

Valores de propriedade

ApiCreateOrUpdatePropertiesOrApiContractProperties

Designação Descrição Valor
apiRevisão Descreve a revisão da api. Se nenhum valor for fornecido, a revisão padrão 1 será criada string

Restrições:
Comprimento mínimo = 1
Comprimento máximo = 100
apiVersion Indica o identificador de versão da API se a API tiver versão string

Restrições:
Comprimento máximo = 100
apiVersionSet Detalhes do contrato do conjunto de versões da api. ApiVersionSetContract
apiVersionSetId Um identificador de recurso para o ApiVersionSet relacionado. string
authenticationSettings Coleção de configurações de autenticação incluídas nesta API. AuthenticationSettingsContract
contentFormat Formato do conteúdo no qual a API está sendo importada. 'Swagger-json'
'swagger-link-json'
'wadl-link-json'
'wadl-xml'
'WSDL'
'WSDL-link'
contentValue Valor de conteúdo ao importar uma API. string
Descrição Descrição da API. Pode incluir tags de formatação HTML. string
displayName Nome da API. string

Restrições:
Comprimento mínimo = 1
Comprimento máximo = 300
caminho URL relativa que identifica exclusivamente essa API e todos os seus caminhos de recursos dentro da instância do serviço de Gerenciamento de API. Ele é anexado à URL base do ponto de extremidade da API especificada durante a criação da instância de serviço para formar uma URL pública para essa API. string

Restrições:
Comprimento máximo = 400 (obrigatório)
protocolos Descreve em quais protocolos as operações nesta API podem ser invocadas. Matriz de cadeia de caracteres contendo qualquer uma das:
«http»
«https»
serviceUrl URL absoluta do serviço de back-end que implementa esta API. string

Restrições:
Comprimento mínimo = 1
Comprimento máximo = 2000
subscriptionKeyParameterNames Protocolos sobre os quais a API é disponibilizada. SubscriptionKeyParameterNamesContract
tipo Tipo de API. «http»
'Sabonete'
wsdlSelector Critérios para limitar a importação de WSDL a um subconjunto do documento. ApiCreateOrUpdatePropertiesWsdlSelector

ApiCreateOrUpdatePropertiesWsdlSelector

Designação Descrição Valor
wsdlEndpointName Nome do ponto de extremidade (porta) a ser importado do WSDL string
wsdlServiceName Nome do serviço a importar do WSDL string

ApiVersionSetContract

Designação Descrição Valor
propriedades Propriedades de um conjunto de versões da API. ApiVersionSetContractProperties

ApiVersionSetContractProperties

Designação Descrição Valor
Descrição Descrição do conjunto de versões da API. string
displayName Nome do conjunto de versões da API string

Restrições:
Comprimento mínimo = 1
Comprimento máximo = 100 (obrigatório)
versionHeaderName Nome do parâmetro de cabeçalho HTTP que indica a versão da API se versioningScheme estiver definido como header. string

Restrições:
Comprimento mínimo = 1
Comprimento máximo = 100
versionamentoScheme Um valor que determina onde o identificador de Versão da API estará localizado em uma solicitação HTTP. 'Cabeçalho'
'Consulta'
'Segmento' (obrigatório)
versionQueryName Nome do parâmetro de consulta que indica a versão da API se versioningScheme estiver definido como query. string

Restrições:
Comprimento mínimo = 1
Comprimento máximo = 100

AuthenticationSettingsContract

Designação Descrição Valor
oAuth2 Configurações de autenticação OAuth2 OAuth2AuthenticationSettingsContract

Microsoft.ApiManagement/service/apis

Designação Descrição Valor
Designação O nome do recurso string

Restrições:
Comprimento mínimo = 1
Comprimento máximo = 256
Padrão = ^[^*#&+:<>?]+$ (obrigatório)
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 para recurso do tipo: serviço
propriedades Criação de entidade de api de propriedades de atualização. ApiCreateOrUpdatePropertiesOrApiContractProperties

OAuth2AuthenticationSettingsContract

Designação Descrição Valor
authorizationServerId Identificador do servidor de autorização OAuth. string
Âmbito de aplicação âmbito das operações. string

SubscriptionKeyParameterNamesContract

Designação Descrição Valor
cabeçalho Nome do cabeçalho da chave de assinatura. string
consulta Nome do parâmetro da cadeia de caracteres de consulta da chave de assinatura. string

Definição de recurso de modelo ARM

O tipo de recurso service/apis pode ser implantado com operações que visam:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.ApiManagement/service/apis, adicione o seguinte JSON ao seu modelo.

{
  "type": "Microsoft.ApiManagement/service/apis",
  "apiVersion": "2017-03-01",
  "name": "string",
  "properties": {
    "apiRevision": "string",
    "apiVersion": "string",
    "apiVersionSet": {
      "properties": {
        "description": "string",
        "displayName": "string",
        "versionHeaderName": "string",
        "versioningScheme": "string",
        "versionQueryName": "string"
      }
    },
    "apiVersionSetId": "string",
    "authenticationSettings": {
      "oAuth2": {
        "authorizationServerId": "string",
        "scope": "string"
      }
    },
    "contentFormat": "string",
    "contentValue": "string",
    "description": "string",
    "displayName": "string",
    "path": "string",
    "protocols": [ "string" ],
    "serviceUrl": "string",
    "subscriptionKeyParameterNames": {
      "header": "string",
      "query": "string"
    },
    "type": "string",
    "wsdlSelector": {
      "wsdlEndpointName": "string",
      "wsdlServiceName": "string"
    }
  }
}

Valores de propriedade

ApiCreateOrUpdatePropertiesOrApiContractProperties

Designação Descrição Valor
apiRevisão Descreve a revisão da api. Se nenhum valor for fornecido, a revisão padrão 1 será criada string

Restrições:
Comprimento mínimo = 1
Comprimento máximo = 100
apiVersion Indica o identificador de versão da API se a API tiver versão string

Restrições:
Comprimento máximo = 100
apiVersionSet Detalhes do contrato do conjunto de versões da api. ApiVersionSetContract
apiVersionSetId Um identificador de recurso para o ApiVersionSet relacionado. string
authenticationSettings Coleção de configurações de autenticação incluídas nesta API. AuthenticationSettingsContract
contentFormat Formato do conteúdo no qual a API está sendo importada. 'Swagger-json'
'swagger-link-json'
'wadl-link-json'
'wadl-xml'
'WSDL'
'WSDL-link'
contentValue Valor de conteúdo ao importar uma API. string
Descrição Descrição da API. Pode incluir tags de formatação HTML. string
displayName Nome da API. string

Restrições:
Comprimento mínimo = 1
Comprimento máximo = 300
caminho URL relativa que identifica exclusivamente essa API e todos os seus caminhos de recursos dentro da instância do serviço de Gerenciamento de API. Ele é anexado à URL base do ponto de extremidade da API especificada durante a criação da instância de serviço para formar uma URL pública para essa API. string

Restrições:
Comprimento máximo = 400 (obrigatório)
protocolos Descreve em quais protocolos as operações nesta API podem ser invocadas. Matriz de cadeia de caracteres contendo qualquer uma das:
«http»
«https»
serviceUrl URL absoluta do serviço de back-end que implementa esta API. string

Restrições:
Comprimento mínimo = 1
Comprimento máximo = 2000
subscriptionKeyParameterNames Protocolos sobre os quais a API é disponibilizada. SubscriptionKeyParameterNamesContract
tipo Tipo de API. «http»
'Sabonete'
wsdlSelector Critérios para limitar a importação de WSDL a um subconjunto do documento. ApiCreateOrUpdatePropertiesWsdlSelector

ApiCreateOrUpdatePropertiesWsdlSelector

Designação Descrição Valor
wsdlEndpointName Nome do ponto de extremidade (porta) a ser importado do WSDL string
wsdlServiceName Nome do serviço a importar do WSDL string

ApiVersionSetContract

Designação Descrição Valor
propriedades Propriedades de um conjunto de versões da API. ApiVersionSetContractProperties

ApiVersionSetContractProperties

Designação Descrição Valor
Descrição Descrição do conjunto de versões da API. string
displayName Nome do conjunto de versões da API string

Restrições:
Comprimento mínimo = 1
Comprimento máximo = 100 (obrigatório)
versionHeaderName Nome do parâmetro de cabeçalho HTTP que indica a versão da API se versioningScheme estiver definido como header. string

Restrições:
Comprimento mínimo = 1
Comprimento máximo = 100
versionamentoScheme Um valor que determina onde o identificador de Versão da API estará localizado em uma solicitação HTTP. 'Cabeçalho'
'Consulta'
'Segmento' (obrigatório)
versionQueryName Nome do parâmetro de consulta que indica a versão da API se versioningScheme estiver definido como query. string

Restrições:
Comprimento mínimo = 1
Comprimento máximo = 100

AuthenticationSettingsContract

Designação Descrição Valor
oAuth2 Configurações de autenticação OAuth2 OAuth2AuthenticationSettingsContract

Microsoft.ApiManagement/service/apis

Designação Descrição Valor
apiVersion A versão api '2017-03-01'
Designação O nome do recurso string

Restrições:
Comprimento mínimo = 1
Comprimento máximo = 256
Padrão = ^[^*#&+:<>?]+$ (obrigatório)
propriedades Criação de entidade de api de propriedades de atualização. ApiCreateOrUpdatePropertiesOrApiContractProperties
tipo O tipo de recurso 'Microsoft.ApiManagement/service/apis'

OAuth2AuthenticationSettingsContract

Designação Descrição Valor
authorizationServerId Identificador do servidor de autorização OAuth. string
Âmbito de aplicação âmbito das operações. string

SubscriptionKeyParameterNamesContract

Designação Descrição Valor
cabeçalho Nome do cabeçalho da chave de assinatura. string
consulta Nome do parâmetro da cadeia de caracteres de consulta da chave de assinatura. string

Definição de recursos Terraform (provedor AzAPI)

O tipo de recurso service/apis pode ser implantado com operações que visam:

  • Grupos de recursos

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.ApiManagement/service/apis, adicione o seguinte Terraform ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ApiManagement/service/apis@2017-03-01"
  name = "string"
  body = jsonencode({
    properties = {
      apiRevision = "string"
      apiVersion = "string"
      apiVersionSet = {
        properties = {
          description = "string"
          displayName = "string"
          versionHeaderName = "string"
          versioningScheme = "string"
          versionQueryName = "string"
        }
      }
      apiVersionSetId = "string"
      authenticationSettings = {
        oAuth2 = {
          authorizationServerId = "string"
          scope = "string"
        }
      }
      contentFormat = "string"
      contentValue = "string"
      description = "string"
      displayName = "string"
      path = "string"
      protocols = [
        "string"
      ]
      serviceUrl = "string"
      subscriptionKeyParameterNames = {
        header = "string"
        query = "string"
      }
      type = "string"
      wsdlSelector = {
        wsdlEndpointName = "string"
        wsdlServiceName = "string"
      }
    }
  })
}

Valores de propriedade

ApiCreateOrUpdatePropertiesOrApiContractProperties

Designação Descrição Valor
apiRevisão Descreve a revisão da api. Se nenhum valor for fornecido, a revisão padrão 1 será criada string

Restrições:
Comprimento mínimo = 1
Comprimento máximo = 100
apiVersion Indica o identificador de versão da API se a API tiver versão string

Restrições:
Comprimento máximo = 100
apiVersionSet Detalhes do contrato do conjunto de versões da api. ApiVersionSetContract
apiVersionSetId Um identificador de recurso para o ApiVersionSet relacionado. string
authenticationSettings Coleção de configurações de autenticação incluídas nesta API. AuthenticationSettingsContract
contentFormat Formato do conteúdo no qual a API está sendo importada. 'Swagger-json'
'swagger-link-json'
'wadl-link-json'
'wadl-xml'
'WSDL'
'WSDL-link'
contentValue Valor de conteúdo ao importar uma API. string
Descrição Descrição da API. Pode incluir tags de formatação HTML. string
displayName Nome da API. string

Restrições:
Comprimento mínimo = 1
Comprimento máximo = 300
caminho URL relativa que identifica exclusivamente essa API e todos os seus caminhos de recursos dentro da instância do serviço de Gerenciamento de API. Ele é anexado à URL base do ponto de extremidade da API especificada durante a criação da instância de serviço para formar uma URL pública para essa API. string

Restrições:
Comprimento máximo = 400 (obrigatório)
protocolos Descreve em quais protocolos as operações nesta API podem ser invocadas. Matriz de cadeia de caracteres contendo qualquer uma das:
«http»
«https»
serviceUrl URL absoluta do serviço de back-end que implementa esta API. string

Restrições:
Comprimento mínimo = 1
Comprimento máximo = 2000
subscriptionKeyParameterNames Protocolos sobre os quais a API é disponibilizada. SubscriptionKeyParameterNamesContract
tipo Tipo de API. «http»
'Sabonete'
wsdlSelector Critérios para limitar a importação de WSDL a um subconjunto do documento. ApiCreateOrUpdatePropertiesWsdlSelector

ApiCreateOrUpdatePropertiesWsdlSelector

Designação Descrição Valor
wsdlEndpointName Nome do ponto de extremidade (porta) a ser importado do WSDL string
wsdlServiceName Nome do serviço a importar do WSDL string

ApiVersionSetContract

Designação Descrição Valor
propriedades Propriedades de um conjunto de versões da API. ApiVersionSetContractProperties

ApiVersionSetContractProperties

Designação Descrição Valor
Descrição Descrição do conjunto de versões da API. string
displayName Nome do conjunto de versões da API string

Restrições:
Comprimento mínimo = 1
Comprimento máximo = 100 (obrigatório)
versionHeaderName Nome do parâmetro de cabeçalho HTTP que indica a versão da API se versioningScheme estiver definido como header. string

Restrições:
Comprimento mínimo = 1
Comprimento máximo = 100
versionamentoScheme Um valor que determina onde o identificador de Versão da API estará localizado em uma solicitação HTTP. 'Cabeçalho'
'Consulta'
'Segmento' (obrigatório)
versionQueryName Nome do parâmetro de consulta que indica a versão da API se versioningScheme estiver definido como query. string

Restrições:
Comprimento mínimo = 1
Comprimento máximo = 100

AuthenticationSettingsContract

Designação Descrição Valor
oAuth2 Configurações de autenticação OAuth2 OAuth2AuthenticationSettingsContract

Microsoft.ApiManagement/service/apis

Designação Descrição Valor
Designação O nome do recurso string

Restrições:
Comprimento mínimo = 1
Comprimento máximo = 256
Padrão = ^[^*#&+:<>?]+$ (obrigatório)
parent_id A ID do recurso que é o pai para este recurso. ID do recurso do tipo: serviço
propriedades Criação de entidade de api de propriedades de atualização. ApiCreateOrUpdatePropertiesOrApiContractProperties
tipo O tipo de recurso "Microsoft.ApiManagement/service/apis@2017-03-01"

OAuth2AuthenticationSettingsContract

Designação Descrição Valor
authorizationServerId Identificador do servidor de autorização OAuth. string
Âmbito de aplicação âmbito das operações. string

SubscriptionKeyParameterNamesContract

Designação Descrição Valor
cabeçalho Nome do cabeçalho da chave de assinatura. string
consulta Nome do parâmetro da cadeia de caracteres de consulta da chave de assinatura. string