Compartilhar via

Microsoft.ApiManagement service/apis/operations 2017-03-01

  • Artigo

Definição de recurso do Bicep

O tipo de recurso de serviço/apis/operações pode ser implantado com operações direcionadas:

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/apis/operations, adicione o Bicep a seguir ao seu modelo.

resource symbolicname 'Microsoft.ApiManagement/service/apis/operations@2017-03-01' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    description: 'string'
    displayName: 'string'
    method: 'string'
    policies: 'string'
    request: {
      description: 'string'
      headers: [
        {
          defaultValue: 'string'
          description: 'string'
          name: 'string'
          required: bool
          type: 'string'
          values: [
            'string'
          ]
        }
      ]
      queryParameters: [
        {
          defaultValue: 'string'
          description: 'string'
          name: 'string'
          required: bool
          type: 'string'
          values: [
            'string'
          ]
        }
      ]
      representations: [
        {
          contentType: 'string'
          formParameters: [
            {
              defaultValue: 'string'
              description: 'string'
              name: 'string'
              required: bool
              type: 'string'
              values: [
                'string'
              ]
            }
          ]
          sample: 'string'
          schemaId: 'string'
          typeName: 'string'
        }
      ]
    }
    responses: [
      {
        description: 'string'
        headers: [
          {
            defaultValue: 'string'
            description: 'string'
            name: 'string'
            required: bool
            type: 'string'
            values: [
              'string'
            ]
          }
        ]
        representations: [
          {
            contentType: 'string'
            formParameters: [
              {
                defaultValue: 'string'
                description: 'string'
                name: 'string'
                required: bool
                type: 'string'
                values: [
                  'string'
                ]
              }
            ]
            sample: 'string'
            schemaId: 'string'
            typeName: 'string'
          }
        ]
        statusCode: int
      }
    ]
    templateParameters: [
      {
        defaultValue: 'string'
        description: 'string'
        name: 'string'
        required: bool
        type: 'string'
        values: [
          'string'
        ]
      }
    ]
    urlTemplate: 'string'
  }
}

Valores de propriedade

Microsoft.ApiManagement/service/apis/operations

Nome Descrição Valor
nome O nome do recurso corda

Restrições:
Comprimento mínimo = 1
Comprimento máximo = 1
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 o recurso do tipo: serviço/apis
Propriedades Propriedades do Contrato de Operação. OperationContractProperties

OperationContractProperties

Nome Descrição Valor
descrição Descrição da operação. Pode incluir marcas de formatação HTML. corda

Restrições:
Comprimento máximo =
displayName Nome da operação. corda

Restrições:
Comprimento mínimo = 1
Comprimento máximo = 1 (obrigatório)
método Um método de operação HTTP válido. Métodos Http típicos como GET, PUT, POST, mas não limitados apenas por eles. cadeia de caracteres (obrigatório)
Políticas Políticas de operação corda
pedir Uma entidade que contém detalhes da solicitação. RequestContract
Respostas Matriz de respostas de operação. ResponseContract[]
templateParameters Coleção de parâmetros de modelo de URL. ParameterContract []
urlTemplate Modelo de URL relativo que identifica o recurso de destino para esta operação. Pode incluir parâmetros. Exemplo: /customers/{cid}/orders/{oid}/?date={date} corda

Restrições:
Comprimento mínimo = 1
Comprimento máximo = 1 (obrigatório)

ParameterContract

Nome Descrição Valor
defaultValue Valor de parâmetro padrão. corda
descrição Descrição do parâmetro. corda
nome Nome do parâmetro. cadeia de caracteres (obrigatório)
Necessário se o parâmetro é necessário ou não. Bool
tipo Tipo de parâmetro. cadeia de caracteres (obrigatório)
Valores Valores de parâmetro. string[]

RepresentationContract

Nome Descrição Valor
contentType Especifica um tipo de conteúdo registrado ou personalizado para essa representação, por exemplo, application/xml. cadeia de caracteres (obrigatório)
formParameters Coleção de parâmetros de formulário. Necessário se o valor 'contentType' for 'application/x-www-form-urlencoded' ou 'multipart/form-data'. ParameterContract []
amostra Um exemplo da representação. corda
schemaId Identificador de esquema. Aplicável somente se o valor 'contentType' não for 'application/x-www-form-urlencoded' nem 'multipart/form-data'. corda
typeName Nome do tipo definido pelo esquema. Aplicável somente se o valor 'contentType' não for 'application/x-www-form-urlencoded' nem 'multipart/form-data'. corda

RequestContract

Nome Descrição Valor
descrição Descrição da solicitação de operação. corda
Cabeçalhos Coleção de cabeçalhos de solicitação de operação. ParameterContract []
queryParameters Coleção de parâmetros de consulta de solicitação de operação. ParameterContract []
Representações Coleção de representações de solicitação de operação. RepresentationContract []

ResponseContract

Nome Descrição Valor
descrição Descrição da resposta da operação. corda
Cabeçalhos Coleção de cabeçalhos de resposta de operação. ParameterContract []
Representações Coleção de representações de resposta de operação. RepresentationContract []
statusCode Código de status HTTP de resposta da operação. int (obrigatório)

Definição de recurso de modelo do ARM

O tipo de recurso de serviço/apis/operações pode ser implantado com operações direcionadas:

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/apis/operations, adicione o JSON a seguir ao modelo.

{
  "type": "Microsoft.ApiManagement/service/apis/operations",
  "apiVersion": "2017-03-01",
  "name": "string",
  "properties": {
    "description": "string",
    "displayName": "string",
    "method": "string",
    "policies": "string",
    "request": {
      "description": "string",
      "headers": [
        {
          "defaultValue": "string",
          "description": "string",
          "name": "string",
          "required": "bool",
          "type": "string",
          "values": [ "string" ]
        }
      ],
      "queryParameters": [
        {
          "defaultValue": "string",
          "description": "string",
          "name": "string",
          "required": "bool",
          "type": "string",
          "values": [ "string" ]
        }
      ],
      "representations": [
        {
          "contentType": "string",
          "formParameters": [
            {
              "defaultValue": "string",
              "description": "string",
              "name": "string",
              "required": "bool",
              "type": "string",
              "values": [ "string" ]
            }
          ],
          "sample": "string",
          "schemaId": "string",
          "typeName": "string"
        }
      ]
    },
    "responses": [
      {
        "description": "string",
        "headers": [
          {
            "defaultValue": "string",
            "description": "string",
            "name": "string",
            "required": "bool",
            "type": "string",
            "values": [ "string" ]
          }
        ],
        "representations": [
          {
            "contentType": "string",
            "formParameters": [
              {
                "defaultValue": "string",
                "description": "string",
                "name": "string",
                "required": "bool",
                "type": "string",
                "values": [ "string" ]
              }
            ],
            "sample": "string",
            "schemaId": "string",
            "typeName": "string"
          }
        ],
        "statusCode": "int"
      }
    ],
    "templateParameters": [
      {
        "defaultValue": "string",
        "description": "string",
        "name": "string",
        "required": "bool",
        "type": "string",
        "values": [ "string" ]
      }
    ],
    "urlTemplate": "string"
  }
}

Valores de propriedade

Microsoft.ApiManagement/service/apis/operations

Nome Descrição Valor
apiVersion A versão da API '2017-03-01'
nome O nome do recurso corda

Restrições:
Comprimento mínimo = 1
Comprimento máximo = 1
Padrão = ^[^*#&+:<>?]+$ (obrigatório)
Propriedades Propriedades do Contrato de Operação. OperationContractProperties
tipo O tipo de recurso 'Microsoft.ApiManagement/service/apis/operations'

OperationContractProperties

Nome Descrição Valor
descrição Descrição da operação. Pode incluir marcas de formatação HTML. corda

Restrições:
Comprimento máximo =
displayName Nome da operação. corda

Restrições:
Comprimento mínimo = 1
Comprimento máximo = 1 (obrigatório)
método Um método de operação HTTP válido. Métodos Http típicos como GET, PUT, POST, mas não limitados apenas por eles. cadeia de caracteres (obrigatório)
Políticas Políticas de operação corda
pedir Uma entidade que contém detalhes da solicitação. RequestContract
Respostas Matriz de respostas de operação. ResponseContract[]
templateParameters Coleção de parâmetros de modelo de URL. ParameterContract []
urlTemplate Modelo de URL relativo que identifica o recurso de destino para esta operação. Pode incluir parâmetros. Exemplo: /customers/{cid}/orders/{oid}/?date={date} corda

Restrições:
Comprimento mínimo = 1
Comprimento máximo = 1 (obrigatório)

ParameterContract

Nome Descrição Valor
defaultValue Valor de parâmetro padrão. corda
descrição Descrição do parâmetro. corda
nome Nome do parâmetro. cadeia de caracteres (obrigatório)
Necessário se o parâmetro é necessário ou não. Bool
tipo Tipo de parâmetro. cadeia de caracteres (obrigatório)
Valores Valores de parâmetro. string[]

RepresentationContract

Nome Descrição Valor
contentType Especifica um tipo de conteúdo registrado ou personalizado para essa representação, por exemplo, application/xml. cadeia de caracteres (obrigatório)
formParameters Coleção de parâmetros de formulário. Necessário se o valor 'contentType' for 'application/x-www-form-urlencoded' ou 'multipart/form-data'. ParameterContract []
amostra Um exemplo da representação. corda
schemaId Identificador de esquema. Aplicável somente se o valor 'contentType' não for 'application/x-www-form-urlencoded' nem 'multipart/form-data'. corda
typeName Nome do tipo definido pelo esquema. Aplicável somente se o valor 'contentType' não for 'application/x-www-form-urlencoded' nem 'multipart/form-data'. corda

RequestContract

Nome Descrição Valor
descrição Descrição da solicitação de operação. corda
Cabeçalhos Coleção de cabeçalhos de solicitação de operação. ParameterContract []
queryParameters Coleção de parâmetros de consulta de solicitação de operação. ParameterContract []
Representações Coleção de representações de solicitação de operação. RepresentationContract []

ResponseContract

Nome Descrição Valor
descrição Descrição da resposta da operação. corda
Cabeçalhos Coleção de cabeçalhos de resposta de operação. ParameterContract []
Representações Coleção de representações de resposta de operação. RepresentationContract []
statusCode Código de status HTTP de resposta da operação. int (obrigatório)

Definição de recurso do Terraform (provedor de AzAPI)

O tipo de recurso de serviço/apis/operações pode ser implantado com operações direcionadas:

  • 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/apis/operations, adicione o Terraform a seguir ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ApiManagement/service/apis/operations@2017-03-01"
  name = "string"
  body = jsonencode({
    properties = {
      description = "string"
      displayName = "string"
      method = "string"
      policies = "string"
      request = {
        description = "string"
        headers = [
          {
            defaultValue = "string"
            description = "string"
            name = "string"
            required = bool
            type = "string"
            values = [
              "string"
            ]
          }
        ]
        queryParameters = [
          {
            defaultValue = "string"
            description = "string"
            name = "string"
            required = bool
            type = "string"
            values = [
              "string"
            ]
          }
        ]
        representations = [
          {
            contentType = "string"
            formParameters = [
              {
                defaultValue = "string"
                description = "string"
                name = "string"
                required = bool
                type = "string"
                values = [
                  "string"
                ]
              }
            ]
            sample = "string"
            schemaId = "string"
            typeName = "string"
          }
        ]
      }
      responses = [
        {
          description = "string"
          headers = [
            {
              defaultValue = "string"
              description = "string"
              name = "string"
              required = bool
              type = "string"
              values = [
                "string"
              ]
            }
          ]
          representations = [
            {
              contentType = "string"
              formParameters = [
                {
                  defaultValue = "string"
                  description = "string"
                  name = "string"
                  required = bool
                  type = "string"
                  values = [
                    "string"
                  ]
                }
              ]
              sample = "string"
              schemaId = "string"
              typeName = "string"
            }
          ]
          statusCode = int
        }
      ]
      templateParameters = [
        {
          defaultValue = "string"
          description = "string"
          name = "string"
          required = bool
          type = "string"
          values = [
            "string"
          ]
        }
      ]
      urlTemplate = "string"
    }
  })
}

Valores de propriedade

Microsoft.ApiManagement/service/apis/operations

Nome Descrição Valor
nome O nome do recurso corda

Restrições:
Comprimento mínimo = 1
Comprimento máximo = 1
Padrão = ^[^*#&+:<>?]+$ (obrigatório)
parent_id A ID do recurso que é o pai desse recurso. ID do recurso do tipo: serviço/apis
Propriedades Propriedades do Contrato de Operação. OperationContractProperties
tipo O tipo de recurso "Microsoft.ApiManagement/service/apis/operations@2017-03-01"

OperationContractProperties

Nome Descrição Valor
descrição Descrição da operação. Pode incluir marcas de formatação HTML. corda

Restrições:
Comprimento máximo =
displayName Nome da operação. corda

Restrições:
Comprimento mínimo = 1
Comprimento máximo = 1 (obrigatório)
método Um método de operação HTTP válido. Métodos Http típicos como GET, PUT, POST, mas não limitados apenas por eles. cadeia de caracteres (obrigatório)
Políticas Políticas de operação corda
pedir Uma entidade que contém detalhes da solicitação. RequestContract
Respostas Matriz de respostas de operação. ResponseContract[]
templateParameters Coleção de parâmetros de modelo de URL. ParameterContract []
urlTemplate Modelo de URL relativo que identifica o recurso de destino para esta operação. Pode incluir parâmetros. Exemplo: /customers/{cid}/orders/{oid}/?date={date} corda

Restrições:
Comprimento mínimo = 1
Comprimento máximo = 1 (obrigatório)

ParameterContract

Nome Descrição Valor
defaultValue Valor de parâmetro padrão. corda
descrição Descrição do parâmetro. corda
nome Nome do parâmetro. cadeia de caracteres (obrigatório)
Necessário se o parâmetro é necessário ou não. Bool
tipo Tipo de parâmetro. cadeia de caracteres (obrigatório)
Valores Valores de parâmetro. string[]

RepresentationContract

Nome Descrição Valor
contentType Especifica um tipo de conteúdo registrado ou personalizado para essa representação, por exemplo, application/xml. cadeia de caracteres (obrigatório)
formParameters Coleção de parâmetros de formulário. Necessário se o valor 'contentType' for 'application/x-www-form-urlencoded' ou 'multipart/form-data'. ParameterContract []
amostra Um exemplo da representação. corda
schemaId Identificador de esquema. Aplicável somente se o valor 'contentType' não for 'application/x-www-form-urlencoded' nem 'multipart/form-data'. corda
typeName Nome do tipo definido pelo esquema. Aplicável somente se o valor 'contentType' não for 'application/x-www-form-urlencoded' nem 'multipart/form-data'. corda

RequestContract

Nome Descrição Valor
descrição Descrição da solicitação de operação. corda
Cabeçalhos Coleção de cabeçalhos de solicitação de operação. ParameterContract []
queryParameters Coleção de parâmetros de consulta de solicitação de operação. ParameterContract []
Representações Coleção de representações de solicitação de operação. RepresentationContract []

ResponseContract

Nome Descrição Valor
descrição Descrição da resposta da operação. corda
Cabeçalhos Coleção de cabeçalhos de resposta de operação. ParameterContract []
Representações Coleção de representações de resposta de operação. RepresentationContract []
statusCode Código de status HTTP de resposta da operação. int (obrigatório)