Freigeben über


Microsoft.ApiManagement service/workspaces/apis 2024-06-01-preview

Bicep-Ressourcendefinition

Der Ressourcentyp "Service/workspaces/apis" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.ApiManagement/service/workspaces/apis-Ressource zu erstellen, fügen Sie ihrer Vorlage die folgende Bicep hinzu.

resource symbolicname 'Microsoft.ApiManagement/service/workspaces/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'
    }
  }
}

Eigenschaftswerte

ApiContactInformation

Name Beschreibung Wert
E-Mail Die E-Mail-Adresse der Kontaktperson/Organisation. MUSS im Format einer E-Mail-Adresse vorliegen Schnur
Name Der Identifizierungsname der Kontaktperson/Organisation Schnur
URL Die URL, die auf die Kontaktinformationen verweist. MUSS im Format einer URL vorliegen Schnur

ApiCreateOrUpdatePropertiesOrApiContractProperties

Name Beschreibung Wert
apiRevision Beschreibt die Revision der API. Wenn kein Wert angegeben wird, wird die Standardrevision 1 erstellt. Schnur

Zwänge:
Min. Länge = 1
Max. Länge = 1
apiRevisionDescription Beschreibung der API-Revision. Schnur

Zwänge:
Max. Länge =
apiType Typ der zu erstellenden API.
* http erstellt eine REST-API
* soap erstellt eine SOAP-Pass-Through-API
* websocket erstellt websocket-API
* graphql erstellt die GraphQL-API.
Neue Typen können in Zukunft hinzugefügt werden.
'graphql'
"grpc"
'http'
'odata'
"Soap"
'websocket'
apiVersion Gibt den Versionsbezeichner der API an, wenn die API versioniert ist. Schnur

Zwänge:
Max. Länge =
apiVersionDescription Beschreibung der API-Version. Schnur

Zwänge:
Max. Länge =
apiVersionSet Versionssatzdetails ApiVersionSetContractDetails
apiVersionSetId Ein Ressourcenbezeichner für das zugehörige ApiVersionSet. Schnur
authenticationSettings Sammlung von Authentifizierungseinstellungen, die in dieser API enthalten sind. AuthenticationSettingsContract-
Kontakt Kontaktinformationen für die API. ApiContactInformation-
Beschreibung Beschreibung der API. Kann HTML-Formatierungstags enthalten. Schnur
displayName API-Name. Muss 1 bis 300 Zeichen lang sein. Schnur

Zwänge:
Min. Länge = 1
Max. Länge = 1
Format Format des Inhalts, in dem die API importiert wird. Neue Formate können in Zukunft hinzugefügt werden '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 Gibt an, ob die API-Revision die aktuelle API-Revision ist. Bool
Lizenz Lizenzinformationen für die API. ApiLicenseInformation-
Pfad Relative URL identifiziert diese API und alle zugehörigen Ressourcenpfade innerhalb der API-Verwaltungsdienstinstanz eindeutig. Sie wird an die API-Endpunktbasis-URL angefügt, die während der Erstellung der Dienstinstanz angegeben wurde, um eine öffentliche URL für diese API zu bilden. Schnur

Zwänge:
Max. Länge = (erforderlich)
Protokolle Beschreibt, welche Protokolle die Vorgänge in dieser API aufrufen können. Zeichenfolgenarray, das eine der folgenden Elemente enthält:
'http'
"https"
'ws'
'wss'
serviceUrl Absolute URL des Back-End-Diensts, der diese API implementiert. Maximal 2000 Zeichen lang. Schnur

Zwänge:
Max. Länge =
sourceApiId API-ID der Quell-API. Schnur
subscriptionKeyParameterNames Protokolle, über die API verfügbar gemacht wird. SubscriptionKeyParameterNamesContract
subscriptionRequired Gibt an, ob für den Zugriff auf die API ein API- oder Produktabonnement erforderlich ist. Bool
termsOfServiceUrl Eine URL zu den Nutzungsbedingungen für die API. MUSS im Format einer URL vorliegen. Schnur
translateRequiredQueryParameters Strategie der Übersetzung erforderlicher Abfrageparameter in Vorlagen. Standardmäßig hat der Wert 'template'. Mögliche Werte: 'template', 'query' 'Abfrage'
'Vorlage'
Art API-Typ. 'graphql'
"grpc"
'http'
'odata'
"Soap"
'websocket'
Wert Inhaltswert beim Importieren einer API. Schnur
wsdlSelector Kriterien zum Einschränken des Imports von WSDL in eine Teilmenge des Dokuments. ApiCreateOrUpdatePropertiesWsdlSelector

ApiCreateOrUpdatePropertiesWsdlSelector

Name Beschreibung Wert
wsdlEndpointName Name des zu importierenden Endpunkts(Port) aus WSDL Schnur
wsdlServiceName Name des Diensts, der aus WSDL importiert werden soll Schnur

ApiLicenseInformation

Name Beschreibung Wert
Name Der für die API verwendete Lizenzname Schnur
URL Eine URL zu der lizenz, die für die API verwendet wird. MUSS im Format einer URL vorliegen Schnur

ApiVersionSetContractDetails

Name Beschreibung Wert
Beschreibung Beschreibung des API-Versionssatzes. Schnur
id Bezeichner für vorhandene API-Versionssatz. Lassen Sie diesen Wert aus, um einen neuen Versionssatz zu erstellen. Schnur
Name Der Anzeigename des API-Versionssatzes. Schnur
versionHeaderName Name des HTTP-Headerparameters, der die API-Version angibt, wenn versioningScheme auf headerfestgelegt ist. Schnur
versioningScheme Ein Wert, der bestimmt, wo sich der API-Versionsbezeichner in einer HTTP-Anforderung befindet. 'Kopfzeile'
'Abfrage'
"Segment"
versionQueryName Name des Abfrageparameters, der die API-Version angibt, wenn versioningScheme auf queryfestgelegt ist. Schnur

AuthenticationSettingsContract

Name Beschreibung Wert
oAuth2 OAuth2-Authentifizierungseinstellungen OAuth2AuthenticationSettingsContract
oAuth2AuthenticationSettings Sammlung der OAuth2-Authentifizierungseinstellungen, die in dieser API enthalten sind. OAuth2AuthenticationSettingsContract[]
openid OpenID Connect-Authentifizierungseinstellungen OpenIdAuthenticationSettingsContract-
openidAuthenticationSettings Sammlung der in dieser API enthaltenen Open ID Connect-Authentifizierungseinstellungen. OpenIdAuthenticationSettingsContract[]

Microsoft.ApiManagement/service/workspaces/apis

Name Beschreibung Wert
Name Der Ressourcenname Schnur

Zwänge:
Min. Länge = 1
Max. Länge = 1
Pattern = ^[^*#&+:<>?]+$ (erforderlich)
Elternteil In Bicep können Sie die übergeordnete Ressource für eine untergeordnete Ressource angeben. Sie müssen diese Eigenschaft nur hinzufügen, wenn die untergeordnete Ressource außerhalb der übergeordneten Ressource deklariert wird.

Weitere Informationen finden Sie unter Untergeordnete Ressource außerhalb der übergeordneten Ressource.
Symbolischer Name für Ressource des Typs: Dienst/Arbeitsbereiche
Eigenschaften Api-Entitätserstellung von Updateeigenschaften. ApiCreateOrUpdatePropertiesOrApiContractProperties

OAuth2AuthenticationSettingsContract

Name Beschreibung Wert
authorizationServerId OAuth-Autorisierungsserverbezeichner. Schnur
Umfang operations scope. Schnur

OpenIdAuthenticationSettingsContract

Name Beschreibung Wert
bearerTokenSendingMethods So senden Sie token an den Server. Zeichenfolgenarray, das eine der folgenden Elemente enthält:
"authorizationHeader"
'Abfrage'
openidProviderId OAuth-Autorisierungsserverbezeichner. Schnur

SubscriptionKeyParameterNamesContract

Name Beschreibung Wert
Kopfball Name des Abonnementschlüsselheaders. Schnur
Frage Name des Zeichenfolgenparameters der Abonnementschlüsselabfrage. Schnur

ARM-Vorlagenressourcendefinition

Der Ressourcentyp "Service/workspaces/apis" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.ApiManagement/service/workspaces/apis-Ressource zu erstellen, fügen Sie Ihrer Vorlage den folgenden JSON-Code hinzu.

{
  "type": "Microsoft.ApiManagement/service/workspaces/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"
    }
  }
}

Eigenschaftswerte

ApiContactInformation

Name Beschreibung Wert
E-Mail Die E-Mail-Adresse der Kontaktperson/Organisation. MUSS im Format einer E-Mail-Adresse vorliegen Schnur
Name Der Identifizierungsname der Kontaktperson/Organisation Schnur
URL Die URL, die auf die Kontaktinformationen verweist. MUSS im Format einer URL vorliegen Schnur

ApiCreateOrUpdatePropertiesOrApiContractProperties

Name Beschreibung Wert
apiRevision Beschreibt die Revision der API. Wenn kein Wert angegeben wird, wird die Standardrevision 1 erstellt. Schnur

Zwänge:
Min. Länge = 1
Max. Länge = 1
apiRevisionDescription Beschreibung der API-Revision. Schnur

Zwänge:
Max. Länge =
apiType Typ der zu erstellenden API.
* http erstellt eine REST-API
* soap erstellt eine SOAP-Pass-Through-API
* websocket erstellt websocket-API
* graphql erstellt die GraphQL-API.
Neue Typen können in Zukunft hinzugefügt werden.
'graphql'
"grpc"
'http'
'odata'
"Soap"
'websocket'
apiVersion Gibt den Versionsbezeichner der API an, wenn die API versioniert ist. Schnur

Zwänge:
Max. Länge =
apiVersionDescription Beschreibung der API-Version. Schnur

Zwänge:
Max. Länge =
apiVersionSet Versionssatzdetails ApiVersionSetContractDetails
apiVersionSetId Ein Ressourcenbezeichner für das zugehörige ApiVersionSet. Schnur
authenticationSettings Sammlung von Authentifizierungseinstellungen, die in dieser API enthalten sind. AuthenticationSettingsContract-
Kontakt Kontaktinformationen für die API. ApiContactInformation-
Beschreibung Beschreibung der API. Kann HTML-Formatierungstags enthalten. Schnur
displayName API-Name. Muss 1 bis 300 Zeichen lang sein. Schnur

Zwänge:
Min. Länge = 1
Max. Länge = 1
Format Format des Inhalts, in dem die API importiert wird. Neue Formate können in Zukunft hinzugefügt werden '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 Gibt an, ob die API-Revision die aktuelle API-Revision ist. Bool
Lizenz Lizenzinformationen für die API. ApiLicenseInformation-
Pfad Relative URL identifiziert diese API und alle zugehörigen Ressourcenpfade innerhalb der API-Verwaltungsdienstinstanz eindeutig. Sie wird an die API-Endpunktbasis-URL angefügt, die während der Erstellung der Dienstinstanz angegeben wurde, um eine öffentliche URL für diese API zu bilden. Schnur

Zwänge:
Max. Länge = (erforderlich)
Protokolle Beschreibt, welche Protokolle die Vorgänge in dieser API aufrufen können. Zeichenfolgenarray, das eine der folgenden Elemente enthält:
'http'
"https"
'ws'
'wss'
serviceUrl Absolute URL des Back-End-Diensts, der diese API implementiert. Maximal 2000 Zeichen lang. Schnur

Zwänge:
Max. Länge =
sourceApiId API-ID der Quell-API. Schnur
subscriptionKeyParameterNames Protokolle, über die API verfügbar gemacht wird. SubscriptionKeyParameterNamesContract
subscriptionRequired Gibt an, ob für den Zugriff auf die API ein API- oder Produktabonnement erforderlich ist. Bool
termsOfServiceUrl Eine URL zu den Nutzungsbedingungen für die API. MUSS im Format einer URL vorliegen. Schnur
translateRequiredQueryParameters Strategie der Übersetzung erforderlicher Abfrageparameter in Vorlagen. Standardmäßig hat der Wert 'template'. Mögliche Werte: 'template', 'query' 'Abfrage'
'Vorlage'
Art API-Typ. 'graphql'
"grpc"
'http'
'odata'
"Soap"
'websocket'
Wert Inhaltswert beim Importieren einer API. Schnur
wsdlSelector Kriterien zum Einschränken des Imports von WSDL in eine Teilmenge des Dokuments. ApiCreateOrUpdatePropertiesWsdlSelector

ApiCreateOrUpdatePropertiesWsdlSelector

Name Beschreibung Wert
wsdlEndpointName Name des zu importierenden Endpunkts(Port) aus WSDL Schnur
wsdlServiceName Name des Diensts, der aus WSDL importiert werden soll Schnur

ApiLicenseInformation

Name Beschreibung Wert
Name Der für die API verwendete Lizenzname Schnur
URL Eine URL zu der lizenz, die für die API verwendet wird. MUSS im Format einer URL vorliegen Schnur

ApiVersionSetContractDetails

Name Beschreibung Wert
Beschreibung Beschreibung des API-Versionssatzes. Schnur
id Bezeichner für vorhandene API-Versionssatz. Lassen Sie diesen Wert aus, um einen neuen Versionssatz zu erstellen. Schnur
Name Der Anzeigename des API-Versionssatzes. Schnur
versionHeaderName Name des HTTP-Headerparameters, der die API-Version angibt, wenn versioningScheme auf headerfestgelegt ist. Schnur
versioningScheme Ein Wert, der bestimmt, wo sich der API-Versionsbezeichner in einer HTTP-Anforderung befindet. 'Kopfzeile'
'Abfrage'
"Segment"
versionQueryName Name des Abfrageparameters, der die API-Version angibt, wenn versioningScheme auf queryfestgelegt ist. Schnur

AuthenticationSettingsContract

Name Beschreibung Wert
oAuth2 OAuth2-Authentifizierungseinstellungen OAuth2AuthenticationSettingsContract
oAuth2AuthenticationSettings Sammlung der OAuth2-Authentifizierungseinstellungen, die in dieser API enthalten sind. OAuth2AuthenticationSettingsContract[]
openid OpenID Connect-Authentifizierungseinstellungen OpenIdAuthenticationSettingsContract-
openidAuthenticationSettings Sammlung der in dieser API enthaltenen Open ID Connect-Authentifizierungseinstellungen. OpenIdAuthenticationSettingsContract[]

Microsoft.ApiManagement/service/workspaces/apis

Name Beschreibung Wert
apiVersion Die API-Version "2024-06-01-preview"
Name Der Ressourcenname Schnur

Zwänge:
Min. Länge = 1
Max. Länge = 1
Pattern = ^[^*#&+:<>?]+$ (erforderlich)
Eigenschaften Api-Entitätserstellung von Updateeigenschaften. ApiCreateOrUpdatePropertiesOrApiContractProperties
Art Der Ressourcentyp "Microsoft.ApiManagement/service/workspaces/apis"

OAuth2AuthenticationSettingsContract

Name Beschreibung Wert
authorizationServerId OAuth-Autorisierungsserverbezeichner. Schnur
Umfang operations scope. Schnur

OpenIdAuthenticationSettingsContract

Name Beschreibung Wert
bearerTokenSendingMethods So senden Sie token an den Server. Zeichenfolgenarray, das eine der folgenden Elemente enthält:
"authorizationHeader"
'Abfrage'
openidProviderId OAuth-Autorisierungsserverbezeichner. Schnur

SubscriptionKeyParameterNamesContract

Name Beschreibung Wert
Kopfball Name des Abonnementschlüsselheaders. Schnur
Frage Name des Zeichenfolgenparameters der Abonnementschlüsselabfrage. Schnur

Terraform -Ressourcendefinition (AzAPI-Anbieter)

Der Ressourcentyp "Service/workspaces/apis" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

  • Ressourcengruppen

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Ressource "Microsoft.ApiManagement/service/workspaces/apis" zu erstellen, fügen Sie Ihrer Vorlage die folgende Terraform hinzu.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ApiManagement/service/workspaces/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"
      }
    }
  })
}

Eigenschaftswerte

ApiContactInformation

Name Beschreibung Wert
E-Mail Die E-Mail-Adresse der Kontaktperson/Organisation. MUSS im Format einer E-Mail-Adresse vorliegen Schnur
Name Der Identifizierungsname der Kontaktperson/Organisation Schnur
URL Die URL, die auf die Kontaktinformationen verweist. MUSS im Format einer URL vorliegen Schnur

ApiCreateOrUpdatePropertiesOrApiContractProperties

Name Beschreibung Wert
apiRevision Beschreibt die Revision der API. Wenn kein Wert angegeben wird, wird die Standardrevision 1 erstellt. Schnur

Zwänge:
Min. Länge = 1
Max. Länge = 1
apiRevisionDescription Beschreibung der API-Revision. Schnur

Zwänge:
Max. Länge =
apiType Typ der zu erstellenden API.
* http erstellt eine REST-API
* soap erstellt eine SOAP-Pass-Through-API
* websocket erstellt websocket-API
* graphql erstellt die GraphQL-API.
Neue Typen können in Zukunft hinzugefügt werden.
'graphql'
"grpc"
'http'
'odata'
"Soap"
'websocket'
apiVersion Gibt den Versionsbezeichner der API an, wenn die API versioniert ist. Schnur

Zwänge:
Max. Länge =
apiVersionDescription Beschreibung der API-Version. Schnur

Zwänge:
Max. Länge =
apiVersionSet Versionssatzdetails ApiVersionSetContractDetails
apiVersionSetId Ein Ressourcenbezeichner für das zugehörige ApiVersionSet. Schnur
authenticationSettings Sammlung von Authentifizierungseinstellungen, die in dieser API enthalten sind. AuthenticationSettingsContract-
Kontakt Kontaktinformationen für die API. ApiContactInformation-
Beschreibung Beschreibung der API. Kann HTML-Formatierungstags enthalten. Schnur
displayName API-Name. Muss 1 bis 300 Zeichen lang sein. Schnur

Zwänge:
Min. Länge = 1
Max. Länge = 1
Format Format des Inhalts, in dem die API importiert wird. Neue Formate können in Zukunft hinzugefügt werden '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 Gibt an, ob die API-Revision die aktuelle API-Revision ist. Bool
Lizenz Lizenzinformationen für die API. ApiLicenseInformation-
Pfad Relative URL identifiziert diese API und alle zugehörigen Ressourcenpfade innerhalb der API-Verwaltungsdienstinstanz eindeutig. Sie wird an die API-Endpunktbasis-URL angefügt, die während der Erstellung der Dienstinstanz angegeben wurde, um eine öffentliche URL für diese API zu bilden. Schnur

Zwänge:
Max. Länge = (erforderlich)
Protokolle Beschreibt, welche Protokolle die Vorgänge in dieser API aufrufen können. Zeichenfolgenarray, das eine der folgenden Elemente enthält:
'http'
"https"
'ws'
'wss'
serviceUrl Absolute URL des Back-End-Diensts, der diese API implementiert. Maximal 2000 Zeichen lang. Schnur

Zwänge:
Max. Länge =
sourceApiId API-ID der Quell-API. Schnur
subscriptionKeyParameterNames Protokolle, über die API verfügbar gemacht wird. SubscriptionKeyParameterNamesContract
subscriptionRequired Gibt an, ob für den Zugriff auf die API ein API- oder Produktabonnement erforderlich ist. Bool
termsOfServiceUrl Eine URL zu den Nutzungsbedingungen für die API. MUSS im Format einer URL vorliegen. Schnur
translateRequiredQueryParameters Strategie der Übersetzung erforderlicher Abfrageparameter in Vorlagen. Standardmäßig hat der Wert 'template'. Mögliche Werte: 'template', 'query' 'Abfrage'
'Vorlage'
Art API-Typ. 'graphql'
"grpc"
'http'
'odata'
"Soap"
'websocket'
Wert Inhaltswert beim Importieren einer API. Schnur
wsdlSelector Kriterien zum Einschränken des Imports von WSDL in eine Teilmenge des Dokuments. ApiCreateOrUpdatePropertiesWsdlSelector

ApiCreateOrUpdatePropertiesWsdlSelector

Name Beschreibung Wert
wsdlEndpointName Name des zu importierenden Endpunkts(Port) aus WSDL Schnur
wsdlServiceName Name des Diensts, der aus WSDL importiert werden soll Schnur

ApiLicenseInformation

Name Beschreibung Wert
Name Der für die API verwendete Lizenzname Schnur
URL Eine URL zu der lizenz, die für die API verwendet wird. MUSS im Format einer URL vorliegen Schnur

ApiVersionSetContractDetails

Name Beschreibung Wert
Beschreibung Beschreibung des API-Versionssatzes. Schnur
id Bezeichner für vorhandene API-Versionssatz. Lassen Sie diesen Wert aus, um einen neuen Versionssatz zu erstellen. Schnur
Name Der Anzeigename des API-Versionssatzes. Schnur
versionHeaderName Name des HTTP-Headerparameters, der die API-Version angibt, wenn versioningScheme auf headerfestgelegt ist. Schnur
versioningScheme Ein Wert, der bestimmt, wo sich der API-Versionsbezeichner in einer HTTP-Anforderung befindet. 'Kopfzeile'
'Abfrage'
"Segment"
versionQueryName Name des Abfrageparameters, der die API-Version angibt, wenn versioningScheme auf queryfestgelegt ist. Schnur

AuthenticationSettingsContract

Name Beschreibung Wert
oAuth2 OAuth2-Authentifizierungseinstellungen OAuth2AuthenticationSettingsContract
oAuth2AuthenticationSettings Sammlung der OAuth2-Authentifizierungseinstellungen, die in dieser API enthalten sind. OAuth2AuthenticationSettingsContract[]
openid OpenID Connect-Authentifizierungseinstellungen OpenIdAuthenticationSettingsContract-
openidAuthenticationSettings Sammlung der in dieser API enthaltenen Open ID Connect-Authentifizierungseinstellungen. OpenIdAuthenticationSettingsContract[]

Microsoft.ApiManagement/service/workspaces/apis

Name Beschreibung Wert
Name Der Ressourcenname Schnur

Zwänge:
Min. Länge = 1
Max. Länge = 1
Pattern = ^[^*#&+:<>?]+$ (erforderlich)
parent_id Die ID der Ressource, die das übergeordnete Element für diese Ressource ist. ID für Ressource des Typs: Dienst/Arbeitsbereiche
Eigenschaften Api-Entitätserstellung von Updateeigenschaften. ApiCreateOrUpdatePropertiesOrApiContractProperties
Art Der Ressourcentyp "Microsoft.ApiManagement/service/workspaces/apis@2024-06-01-preview"

OAuth2AuthenticationSettingsContract

Name Beschreibung Wert
authorizationServerId OAuth-Autorisierungsserverbezeichner. Schnur
Umfang operations scope. Schnur

OpenIdAuthenticationSettingsContract

Name Beschreibung Wert
bearerTokenSendingMethods So senden Sie token an den Server. Zeichenfolgenarray, das eine der folgenden Elemente enthält:
"authorizationHeader"
'Abfrage'
openidProviderId OAuth-Autorisierungsserverbezeichner. Schnur

SubscriptionKeyParameterNamesContract

Name Beschreibung Wert
Kopfball Name des Abonnementschlüsselheaders. Schnur
Frage Name des Zeichenfolgenparameters der Abonnementschlüsselabfrage. Schnur