Condividi tramite

Servizio/api Microsoft.ApiManagement

  • Articolo

Definizione di risorsa Bicep

Il tipo di risorsa service/apis può essere distribuito con operazioni destinate a:

  • gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.ApiManagement/service/apis, aggiungere il bicep seguente al modello.

resource symbolicname 'Microsoft.ApiManagement/service/apis@2024-06-01-preview' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    apiRevision: 'string'
    apiRevisionDescription: 'string'
    apiType: 'string'
    apiVersion: 'string'
    apiVersionDescription: 'string'
    apiVersionSet: {
      description: 'string'
      id: 'string'
      name: 'string'
      versionHeaderName: 'string'
      versioningScheme: 'string'
      versionQueryName: 'string'
    }
    apiVersionSetId: 'string'
    authenticationSettings: {
      oAuth2: {
        authorizationServerId: 'string'
        scope: 'string'
      }
      oAuth2AuthenticationSettings: [
        {
          authorizationServerId: 'string'
          scope: 'string'
        }
      ]
      openid: {
        bearerTokenSendingMethods: [
          'string'
        ]
        openidProviderId: 'string'
      }
      openidAuthenticationSettings: [
        {
          bearerTokenSendingMethods: [
            'string'
          ]
          openidProviderId: 'string'
        }
      ]
    }
    contact: {
      email: 'string'
      name: 'string'
      url: 'string'
    }
    description: 'string'
    displayName: 'string'
    format: 'string'
    isCurrent: bool
    license: {
      name: 'string'
      url: 'string'
    }
    path: 'string'
    protocols: [
      'string'
    ]
    serviceUrl: 'string'
    sourceApiId: 'string'
    subscriptionKeyParameterNames: {
      header: 'string'
      query: 'string'
    }
    subscriptionRequired: bool
    termsOfServiceUrl: 'string'
    translateRequiredQueryParameters: 'string'
    type: 'string'
    value: 'string'
    wsdlSelector: {
      wsdlEndpointName: 'string'
      wsdlServiceName: 'string'
    }
  }
}

Valori delle proprietà

ApiContactInformation

Nome Descrizione Valore
E-mail Indirizzo di posta elettronica della persona o dell'organizzazione di contatto. DEVE essere nel formato di un indirizzo di posta elettronica corda
nome Nome di identificazione della persona o dell'organizzazione di contatto corda
URL URL che punta alle informazioni di contatto. DEVE essere nel formato di un URL corda

ApiCreateOrUpdatePropertiesOrApiContractProperties

Nome Descrizione Valore
apiRevision Descrive la revisione dell'API. Se non viene specificato alcun valore, viene creata la revisione predefinita 1 corda

Vincoli:
Lunghezza minima = 1
Lunghezza massima = 1
apiRevisionDescription Descrizione della revisione DELL'API. corda

Vincoli:
Lunghezza massima =
apiType Tipo di API da creare.
* http crea un'API REST
* soap crea un'API pass-through SOAP
* websocket crea l'API Websocket
* graphql crea l'API GraphQL.
È possibile aggiungere nuovi tipi in futuro.		 'graphql'
'grpc'
'http'
'odata'
'soap'
'websocket'
apiVersion Indica l'identificatore della versione dell'API se l'API è con versione corda

Vincoli:
Lunghezza massima =
apiVersionDescription Descrizione della versione dell'API. corda

Vincoli:
Lunghezza massima =
apiVersionSet Dettagli del set di versioni ApiVersionSetContractDetails
apiVersionSetId Identificatore di risorsa per l'Oggetto ApiVersionSet correlato. corda
authenticationSettings Raccolta di impostazioni di autenticazione incluse in questa API. AuthenticationSettingsContract
contatto Informazioni di contatto per l'API. ApiContactInformation
descrizione Descrizione dell'API. Può includere tag di formattazione HTML. corda
displayName Nome API. Deve contenere da 1 a 300 caratteri. corda

Vincoli:
Lunghezza minima = 1
Lunghezza massima = 1
formato Formato del contenuto in cui viene importata l'API. È possibile aggiungere nuovi formati in futuro 'graphql-link'
'grpc'
'grpc-link'
'odata'
'odata-link'
'openapi'
'openapi+json'
'openapi+json-link'
'openapi-link'
'swagger-json'
'swagger-link-json'
'wadl-link-json'
'wadl-xml'
'wsdl'
'wsdl-link'
isCurrent Indica se la revisione dell'API è la revisione api corrente. Bool
licenza Informazioni sulla licenza per l'API. ApiLicenseInformation
sentiero URL relativo che identifica in modo univoco questa API e tutti i relativi percorsi di risorse all'interno dell'istanza del servizio Gestione API. Viene aggiunto all'URL di base dell'endpoint API specificato durante la creazione dell'istanza del servizio per formare un URL pubblico per questa API. corda

Vincoli:
Lunghezza massima = (obbligatorio)
Protocolli Descrive i protocolli in cui è possibile richiamare le operazioni in questa API. Matrice di stringhe contenente uno dei seguenti elementi:
'http'
'https'
'ws'
'wss'
serviceUrl URL assoluto del servizio back-end che implementa questa API. Non può contenere più di 2000 caratteri. corda

Vincoli:
Lunghezza massima =
sourceApiId Identificatore API dell'API di origine. corda
subscriptionKeyParameterNames Protocolli su cui è disponibile l'API. SubscriptionKeyParameterNamesContract
subscriptionRequired Specifica se è necessaria una sottoscrizione api o prodotto per l'accesso all'API. Bool
termsOfServiceUrl URL delle condizioni di servizio per l'API. DEVE essere nel formato di un URL. corda
translateRequiredQueryParameters Strategia di conversione dei parametri di query necessari in quelli del modello. Per impostazione predefinita, il valore 'template'. Valori possibili: 'template', 'query' 'query'
'template'
digitare Tipo di API. 'graphql'
'grpc'
'http'
'odata'
'soap'
'websocket'
valore Valore del contenuto durante l'importazione di un'API. corda
wsdlSelector Criteri per limitare l'importazione di WSDL in un subset del documento. ApiCreateOrUpdatePropertiesWsdlSelector

ApiCreateOrUpdatePropertiesWsdlSelector

Nome Descrizione Valore
wsdlEndpointName Nome dell'endpoint(porta) da importare da WSDL corda
wsdlServiceName Nome del servizio da importare da WSDL corda

ApiLicenseInformation

Nome Descrizione Valore
nome Nome della licenza usato per l'API corda
URL URL della licenza usata per l'API. DEVE essere nel formato di un URL corda

ApiVersionSetContractDetails

Nome Descrizione Valore
descrizione Descrizione del set di versioni dell'API. corda
Id Identificatore per il set di versioni dell'API esistente. Omettere questo valore per creare un nuovo set di versioni. corda
nome Nome visualizzato del set di versioni dell'API. corda
versionHeaderName Nome del parametro di intestazione HTTP che indica la versione dell'API se versioningScheme è impostato su header. corda
controllo delle versioniScheme Valore che determina dove si trova l'identificatore della versione dell'API in una richiesta HTTP. 'Header'
'Query'
'Segment'
versionQueryName Nome del parametro di query che indica la versione dell'API se versioningScheme è impostato su query. corda

AuthenticationSettingsContract

Nome Descrizione Valore
oAuth2 Impostazioni di autenticazione OAuth2 OAuth2AuthenticationSettingsContract
oAuth2AuthenticationSettings Raccolta di impostazioni di autenticazione OAuth2 incluse in questa API. OAuth2AuthenticationSettingsContract[]
openid Impostazioni di autenticazione OpenID Connect OpenIdAuthenticationSettingsContract
openidAuthenticationSettings Raccolta di impostazioni di autenticazione Open ID Connect incluse in questa API. OpenIdAuthenticationSettingsContract[]

Microsoft.ApiManagement/service/apis

Nome Descrizione Valore
nome Nome della risorsa corda

Vincoli:
Lunghezza minima = 1
Lunghezza massima = 1
Pattern = ^[^*#&+:<>?]+$ (obbligatorio)
genitore In Bicep è possibile specificare la risorsa padre per una risorsa figlio. È necessario aggiungere questa proprietà solo quando la risorsa figlio viene dichiarata all'esterno della risorsa padre.

Per altre informazioni, vedere risorsa figlio all'esterno della risorsa padre.		 Nome simbolico per la risorsa di tipo: servizio
proprietà Creazione di entità API di proprietà di aggiornamento. ApiCreateOrUpdatePropertiesOrApiContractProperties

OAuth2AuthenticationSettingsContract

Nome Descrizione Valore
authorizationServerId Identificatore del server di autorizzazione OAuth. corda
portata ambito delle operazioni. corda

OpenIdAuthenticationSettingsContract

Nome Descrizione Valore
bearerTokenSendingMethods Come inviare il token al server. Matrice di stringhe contenente uno dei seguenti elementi:
'authorizationHeader'
'query'
openidProviderId Identificatore del server di autorizzazione OAuth. corda

SubscriptionKeyParameterNamesContract

Nome Descrizione Valore
intestazione Nome dell'intestazione della chiave di sottoscrizione. corda
quesito Nome del parametro della stringa di query della chiave di sottoscrizione. corda

Definizione di risorsa del modello di Resource Manager

Il tipo di risorsa service/apis può essere distribuito con operazioni destinate a:

  • gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.ApiManagement/service/apis, aggiungere il codice JSON seguente al modello.

{
  "type": "Microsoft.ApiManagement/service/apis",
  "apiVersion": "2024-06-01-preview",
  "name": "string",
  "properties": {
    "apiRevision": "string",
    "apiRevisionDescription": "string",
    "apiType": "string",
    "apiVersion": "string",
    "apiVersionDescription": "string",
    "apiVersionSet": {
      "description": "string",
      "id": "string",
      "name": "string",
      "versionHeaderName": "string",
      "versioningScheme": "string",
      "versionQueryName": "string"
    },
    "apiVersionSetId": "string",
    "authenticationSettings": {
      "oAuth2": {
        "authorizationServerId": "string",
        "scope": "string"
      },
      "oAuth2AuthenticationSettings": [
        {
          "authorizationServerId": "string",
          "scope": "string"
        }
      ],
      "openid": {
        "bearerTokenSendingMethods": [ "string" ],
        "openidProviderId": "string"
      },
      "openidAuthenticationSettings": [
        {
          "bearerTokenSendingMethods": [ "string" ],
          "openidProviderId": "string"
        }
      ]
    },
    "contact": {
      "email": "string",
      "name": "string",
      "url": "string"
    },
    "description": "string",
    "displayName": "string",
    "format": "string",
    "isCurrent": "bool",
    "license": {
      "name": "string",
      "url": "string"
    },
    "path": "string",
    "protocols": [ "string" ],
    "serviceUrl": "string",
    "sourceApiId": "string",
    "subscriptionKeyParameterNames": {
      "header": "string",
      "query": "string"
    },
    "subscriptionRequired": "bool",
    "termsOfServiceUrl": "string",
    "translateRequiredQueryParameters": "string",
    "type": "string",
    "value": "string",
    "wsdlSelector": {
      "wsdlEndpointName": "string",
      "wsdlServiceName": "string"
    }
  }
}

Valori delle proprietà

ApiContactInformation

Nome Descrizione Valore
E-mail Indirizzo di posta elettronica della persona o dell'organizzazione di contatto. DEVE essere nel formato di un indirizzo di posta elettronica corda
nome Nome di identificazione della persona o dell'organizzazione di contatto corda
URL URL che punta alle informazioni di contatto. DEVE essere nel formato di un URL corda

ApiCreateOrUpdatePropertiesOrApiContractProperties

Nome Descrizione Valore
apiRevision Descrive la revisione dell'API. Se non viene specificato alcun valore, viene creata la revisione predefinita 1 corda

Vincoli:
Lunghezza minima = 1
Lunghezza massima = 1
apiRevisionDescription Descrizione della revisione DELL'API. corda

Vincoli:
Lunghezza massima =
apiType Tipo di API da creare.
* http crea un'API REST
* soap crea un'API pass-through SOAP
* websocket crea l'API Websocket
* graphql crea l'API GraphQL.
È possibile aggiungere nuovi tipi in futuro.		 'graphql'
'grpc'
'http'
'odata'
'soap'
'websocket'
apiVersion Indica l'identificatore della versione dell'API se l'API è con versione corda

Vincoli:
Lunghezza massima =
apiVersionDescription Descrizione della versione dell'API. corda

Vincoli:
Lunghezza massima =
apiVersionSet Dettagli del set di versioni ApiVersionSetContractDetails
apiVersionSetId Identificatore di risorsa per l'Oggetto ApiVersionSet correlato. corda
authenticationSettings Raccolta di impostazioni di autenticazione incluse in questa API. AuthenticationSettingsContract
contatto Informazioni di contatto per l'API. ApiContactInformation
descrizione Descrizione dell'API. Può includere tag di formattazione HTML. corda
displayName Nome API. Deve contenere da 1 a 300 caratteri. corda

Vincoli:
Lunghezza minima = 1
Lunghezza massima = 1
formato Formato del contenuto in cui viene importata l'API. È possibile aggiungere nuovi formati in futuro 'graphql-link'
'grpc'
'grpc-link'
'odata'
'odata-link'
'openapi'
'openapi+json'
'openapi+json-link'
'openapi-link'
'swagger-json'
'swagger-link-json'
'wadl-link-json'
'wadl-xml'
'wsdl'
'wsdl-link'
isCurrent Indica se la revisione dell'API è la revisione api corrente. Bool
licenza Informazioni sulla licenza per l'API. ApiLicenseInformation
sentiero URL relativo che identifica in modo univoco questa API e tutti i relativi percorsi di risorse all'interno dell'istanza del servizio Gestione API. Viene aggiunto all'URL di base dell'endpoint API specificato durante la creazione dell'istanza del servizio per formare un URL pubblico per questa API. corda

Vincoli:
Lunghezza massima = (obbligatorio)
Protocolli Descrive i protocolli in cui è possibile richiamare le operazioni in questa API. Matrice di stringhe contenente uno dei seguenti elementi:
'http'
'https'
'ws'
'wss'
serviceUrl URL assoluto del servizio back-end che implementa questa API. Non può contenere più di 2000 caratteri. corda

Vincoli:
Lunghezza massima =
sourceApiId Identificatore API dell'API di origine. corda
subscriptionKeyParameterNames Protocolli su cui è disponibile l'API. SubscriptionKeyParameterNamesContract
subscriptionRequired Specifica se è necessaria una sottoscrizione api o prodotto per l'accesso all'API. Bool
termsOfServiceUrl URL delle condizioni di servizio per l'API. DEVE essere nel formato di un URL. corda
translateRequiredQueryParameters Strategia di conversione dei parametri di query necessari in quelli del modello. Per impostazione predefinita, il valore 'template'. Valori possibili: 'template', 'query' 'query'
'template'
digitare Tipo di API. 'graphql'
'grpc'
'http'
'odata'
'soap'
'websocket'
valore Valore del contenuto durante l'importazione di un'API. corda
wsdlSelector Criteri per limitare l'importazione di WSDL in un subset del documento. ApiCreateOrUpdatePropertiesWsdlSelector

ApiCreateOrUpdatePropertiesWsdlSelector

Nome Descrizione Valore
wsdlEndpointName Nome dell'endpoint(porta) da importare da WSDL corda
wsdlServiceName Nome del servizio da importare da WSDL corda

ApiLicenseInformation

Nome Descrizione Valore
nome Nome della licenza usato per l'API corda
URL URL della licenza usata per l'API. DEVE essere nel formato di un URL corda

ApiVersionSetContractDetails

Nome Descrizione Valore
descrizione Descrizione del set di versioni dell'API. corda
Id Identificatore per il set di versioni dell'API esistente. Omettere questo valore per creare un nuovo set di versioni. corda
nome Nome visualizzato del set di versioni dell'API. corda
versionHeaderName Nome del parametro di intestazione HTTP che indica la versione dell'API se versioningScheme è impostato su header. corda
controllo delle versioniScheme Valore che determina dove si trova l'identificatore della versione dell'API in una richiesta HTTP. 'Header'
'Query'
'Segment'
versionQueryName Nome del parametro di query che indica la versione dell'API se versioningScheme è impostato su query. corda

AuthenticationSettingsContract

Nome Descrizione Valore
oAuth2 Impostazioni di autenticazione OAuth2 OAuth2AuthenticationSettingsContract
oAuth2AuthenticationSettings Raccolta di impostazioni di autenticazione OAuth2 incluse in questa API. OAuth2AuthenticationSettingsContract[]
openid Impostazioni di autenticazione OpenID Connect OpenIdAuthenticationSettingsContract
openidAuthenticationSettings Raccolta di impostazioni di autenticazione Open ID Connect incluse in questa API. OpenIdAuthenticationSettingsContract[]

Microsoft.ApiManagement/service/apis

Nome Descrizione Valore
apiVersion Versione dell'API '2024-06-01-preview'
nome Nome della risorsa corda

Vincoli:
Lunghezza minima = 1
Lunghezza massima = 1
Pattern = ^[^*#&+:<>?]+$ (obbligatorio)
proprietà Creazione di entità API di proprietà di aggiornamento. ApiCreateOrUpdatePropertiesOrApiContractProperties
digitare Tipo di risorsa 'Microsoft.ApiManagement/service/apis'

OAuth2AuthenticationSettingsContract

Nome Descrizione Valore
authorizationServerId Identificatore del server di autorizzazione OAuth. corda
portata ambito delle operazioni. corda

OpenIdAuthenticationSettingsContract

Nome Descrizione Valore
bearerTokenSendingMethods Come inviare il token al server. Matrice di stringhe contenente uno dei seguenti elementi:
'authorizationHeader'
'query'
openidProviderId Identificatore del server di autorizzazione OAuth. corda

SubscriptionKeyParameterNamesContract

Nome Descrizione Valore
intestazione Nome dell'intestazione della chiave di sottoscrizione. corda
quesito Nome del parametro della stringa di query della chiave di sottoscrizione. corda

Definizione di risorsa Terraform (provider AzAPI)

Il tipo di risorsa service/apis può essere distribuito con operazioni destinate a:

  • gruppi di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.ApiManagement/service/apis, aggiungere il codice Terraform seguente al modello.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ApiManagement/service/apis@2024-06-01-preview"
  name = "string"
  body = jsonencode({
    properties = {
      apiRevision = "string"
      apiRevisionDescription = "string"
      apiType = "string"
      apiVersion = "string"
      apiVersionDescription = "string"
      apiVersionSet = {
        description = "string"
        id = "string"
        name = "string"
        versionHeaderName = "string"
        versioningScheme = "string"
        versionQueryName = "string"
      }
      apiVersionSetId = "string"
      authenticationSettings = {
        oAuth2 = {
          authorizationServerId = "string"
          scope = "string"
        }
        oAuth2AuthenticationSettings = [
          {
            authorizationServerId = "string"
            scope = "string"
          }
        ]
        openid = {
          bearerTokenSendingMethods = [
            "string"
          ]
          openidProviderId = "string"
        }
        openidAuthenticationSettings = [
          {
            bearerTokenSendingMethods = [
              "string"
            ]
            openidProviderId = "string"
          }
        ]
      }
      contact = {
        email = "string"
        name = "string"
        url = "string"
      }
      description = "string"
      displayName = "string"
      format = "string"
      isCurrent = bool
      license = {
        name = "string"
        url = "string"
      }
      path = "string"
      protocols = [
        "string"
      ]
      serviceUrl = "string"
      sourceApiId = "string"
      subscriptionKeyParameterNames = {
        header = "string"
        query = "string"
      }
      subscriptionRequired = bool
      termsOfServiceUrl = "string"
      translateRequiredQueryParameters = "string"
      type = "string"
      value = "string"
      wsdlSelector = {
        wsdlEndpointName = "string"
        wsdlServiceName = "string"
      }
    }
  })
}

Valori delle proprietà

ApiContactInformation

Nome Descrizione Valore
E-mail Indirizzo di posta elettronica della persona o dell'organizzazione di contatto. DEVE essere nel formato di un indirizzo di posta elettronica corda
nome Nome di identificazione della persona o dell'organizzazione di contatto corda
URL URL che punta alle informazioni di contatto. DEVE essere nel formato di un URL corda

ApiCreateOrUpdatePropertiesOrApiContractProperties

Nome Descrizione Valore
apiRevision Descrive la revisione dell'API. Se non viene specificato alcun valore, viene creata la revisione predefinita 1 corda

Vincoli:
Lunghezza minima = 1
Lunghezza massima = 1
apiRevisionDescription Descrizione della revisione DELL'API. corda

Vincoli:
Lunghezza massima =
apiType Tipo di API da creare.
* http crea un'API REST
* soap crea un'API pass-through SOAP
* websocket crea l'API Websocket
* graphql crea l'API GraphQL.
È possibile aggiungere nuovi tipi in futuro.		 'graphql'
'grpc'
'http'
'odata'
'soap'
'websocket'
apiVersion Indica l'identificatore della versione dell'API se l'API è con versione corda

Vincoli:
Lunghezza massima =
apiVersionDescription Descrizione della versione dell'API. corda

Vincoli:
Lunghezza massima =
apiVersionSet Dettagli del set di versioni ApiVersionSetContractDetails
apiVersionSetId Identificatore di risorsa per l'Oggetto ApiVersionSet correlato. corda
authenticationSettings Raccolta di impostazioni di autenticazione incluse in questa API. AuthenticationSettingsContract
contatto Informazioni di contatto per l'API. ApiContactInformation
descrizione Descrizione dell'API. Può includere tag di formattazione HTML. corda
displayName Nome API. Deve contenere da 1 a 300 caratteri. corda

Vincoli:
Lunghezza minima = 1
Lunghezza massima = 1
formato Formato del contenuto in cui viene importata l'API. È possibile aggiungere nuovi formati in futuro 'graphql-link'
'grpc'
'grpc-link'
'odata'
'odata-link'
'openapi'
'openapi+json'
'openapi+json-link'
'openapi-link'
'swagger-json'
'swagger-link-json'
'wadl-link-json'
'wadl-xml'
'wsdl'
'wsdl-link'
isCurrent Indica se la revisione dell'API è la revisione api corrente. Bool
licenza Informazioni sulla licenza per l'API. ApiLicenseInformation
sentiero URL relativo che identifica in modo univoco questa API e tutti i relativi percorsi di risorse all'interno dell'istanza del servizio Gestione API. Viene aggiunto all'URL di base dell'endpoint API specificato durante la creazione dell'istanza del servizio per formare un URL pubblico per questa API. corda

Vincoli:
Lunghezza massima = (obbligatorio)
Protocolli Descrive i protocolli in cui è possibile richiamare le operazioni in questa API. Matrice di stringhe contenente uno dei seguenti elementi:
'http'
'https'
'ws'
'wss'
serviceUrl URL assoluto del servizio back-end che implementa questa API. Non può contenere più di 2000 caratteri. corda

Vincoli:
Lunghezza massima =
sourceApiId Identificatore API dell'API di origine. corda
subscriptionKeyParameterNames Protocolli su cui è disponibile l'API. SubscriptionKeyParameterNamesContract
subscriptionRequired Specifica se è necessaria una sottoscrizione api o prodotto per l'accesso all'API. Bool
termsOfServiceUrl URL delle condizioni di servizio per l'API. DEVE essere nel formato di un URL. corda
translateRequiredQueryParameters Strategia di conversione dei parametri di query necessari in quelli del modello. Per impostazione predefinita, il valore 'template'. Valori possibili: 'template', 'query' 'query'
'template'
digitare Tipo di API. 'graphql'
'grpc'
'http'
'odata'
'soap'
'websocket'
valore Valore del contenuto durante l'importazione di un'API. corda
wsdlSelector Criteri per limitare l'importazione di WSDL in un subset del documento. ApiCreateOrUpdatePropertiesWsdlSelector

ApiCreateOrUpdatePropertiesWsdlSelector

Nome Descrizione Valore
wsdlEndpointName Nome dell'endpoint(porta) da importare da WSDL corda
wsdlServiceName Nome del servizio da importare da WSDL corda

ApiLicenseInformation

Nome Descrizione Valore
nome Nome della licenza usato per l'API corda
URL URL della licenza usata per l'API. DEVE essere nel formato di un URL corda

ApiVersionSetContractDetails

Nome Descrizione Valore
descrizione Descrizione del set di versioni dell'API. corda
Id Identificatore per il set di versioni dell'API esistente. Omettere questo valore per creare un nuovo set di versioni. corda
nome Nome visualizzato del set di versioni dell'API. corda
versionHeaderName Nome del parametro di intestazione HTTP che indica la versione dell'API se versioningScheme è impostato su header. corda
controllo delle versioniScheme Valore che determina dove si trova l'identificatore della versione dell'API in una richiesta HTTP. 'Header'
'Query'
'Segment'
versionQueryName Nome del parametro di query che indica la versione dell'API se versioningScheme è impostato su query. corda

AuthenticationSettingsContract

Nome Descrizione Valore
oAuth2 Impostazioni di autenticazione OAuth2 OAuth2AuthenticationSettingsContract
oAuth2AuthenticationSettings Raccolta di impostazioni di autenticazione OAuth2 incluse in questa API. OAuth2AuthenticationSettingsContract[]
openid Impostazioni di autenticazione OpenID Connect OpenIdAuthenticationSettingsContract
openidAuthenticationSettings Raccolta di impostazioni di autenticazione Open ID Connect incluse in questa API. OpenIdAuthenticationSettingsContract[]

Microsoft.ApiManagement/service/apis

Nome Descrizione Valore
nome Nome della risorsa corda

Vincoli:
Lunghezza minima = 1
Lunghezza massima = 1
Pattern = ^[^*#&+:<>?]+$ (obbligatorio)
parent_id ID della risorsa padre per questa risorsa. ID per la risorsa di tipo: servizio
proprietà Creazione di entità API di proprietà di aggiornamento. ApiCreateOrUpdatePropertiesOrApiContractProperties
digitare Tipo di risorsa "Microsoft.ApiManagement/service/apis@2024-06-01-preview"

OAuth2AuthenticationSettingsContract

Nome Descrizione Valore
authorizationServerId Identificatore del server di autorizzazione OAuth. corda
portata ambito delle operazioni. corda

OpenIdAuthenticationSettingsContract

Nome Descrizione Valore
bearerTokenSendingMethods Come inviare il token al server. Matrice di stringhe contenente uno dei seguenti elementi:
'authorizationHeader'
'query'
openidProviderId Identificatore del server di autorizzazione OAuth. corda

SubscriptionKeyParameterNamesContract

Nome Descrizione Valore
intestazione Nome dell'intestazione della chiave di sottoscrizione. corda
quesito Nome del parametro della stringa di query della chiave di sottoscrizione. corda